vos/ambiq-hal-sys/ambiq-sparkfun-sdk/tools/emp2include
2022-10-23 23:45:43 -07:00
..
0000000_META_hci_patches_v8.emp initial commit 2022-10-23 23:45:43 -07:00
data_length_extension.emp initial commit 2022-10-23 23:45:43 -07:00
disable_pull-up_em_gpio10.emp initial commit 2022-10-23 23:45:43 -07:00
disable_pull-up_em_gpio11.emp initial commit 2022-10-23 23:45:43 -07:00
eight_connections.emp initial commit 2022-10-23 23:45:43 -07:00
emp2include.py initial commit 2022-10-23 23:45:43 -07:00
PATCHES.txt initial commit 2022-10-23 23:45:43 -07:00
README.txt initial commit 2022-10-23 23:45:43 -07:00
sleep_clk_src_apollo.emp initial commit 2022-10-23 23:45:43 -07:00
updateCRC.py initial commit 2022-10-23 23:45:43 -07:00

This directory holds the *.emp files generated by the EM Micro tools (e.g. EM9304 Configuration Editor) or EM Micro developers (code patches).

All *.emp files contained in this directory will result in the generation of a patch or patches to be
applied to the EM9304.

The script emp2include.py has the following usage:

$ ./emp2include.py --help
usage: emp2include.py [-h] [-o MEMORY]

Convert multiple EM9304 *.emp files to the em9304_patches.* files.

optional arguments:
  -h, --help  show this help message and exit
  -o MEMORY   Destination memory (IRAM or OTP)

Patches can be applied temporarily to IRAM and then permanently applied to OTP (one-time programable) memory 
as needed.  The default is IRAM.

The files em9304_patches.h and em9304_patches.c will be generated in the following directory:

/third_party/exactle/sw/hci/ambiq/em9304

Patches are uniquely identified by the following meta-data embedded in *.emp files:
	* Format Version - Container format version (increments as container is updated)
	* Patch ID - Unique identifier for the container/patch (assigned by patch creator)
	* Build number - EM9304 ROM minor revision supported by patch
	* User Build - User defined number (assigned by patch creator)
		=> 0, 1: Reserved by EM
		=> 2, 3: Reserved by Ambiq Micro
		=> 4+  : Available for customer


Note: 0001642_PROD_boot_overhead.emp is built into 0000000_META_hci_patches_v7.emp, there's only a single emp from EM in the future.