Miprom.exe

Descriptions

Miprom.exe is a content management tool for the EEPROM systems that are available in Aptina sensors and SOCs.
Miprom.exe executes the EEPROM commands in the order that they appear on the command line. Therefore the order of the parameters on the command line is important. The EEPROM commands are described below.
Usage: miprom [commands]
Simple example:
miprom -format -pga lens1.ini -burn
(Format the EEPROM, append a PGA record with data taken from the lens1.ini file, write the EEPROM.)

Command line parameters

-burn
Write all pending changes to the EEPROM. Note that no changes will be written to the EEPROM until a -burn command is encountered. If there is no -burn command then the contents of the EEPROM will not be changed.
-format
Write the signature bytes and reset the EEPROM to have no data records.
Note: Changes aren't committed to the EEPROM until the -burn command.
-sensorid <string>
Append a SENSOR_ID_RECORD to the EEPROM. Overwrites any previous value.
Note: Changes aren't committed to the EEPROM until the -burn command.
-headid <string>
Append a HEADBOARD_ID_RECORD to the EEPROM. Overwrites any previous value.
Note: Changes aren't committed to the EEPROM until the -burn command.
-lens <string>
Append a LENS_TYPE_RECORD to the EEPROM. Overwrites any previous value.
Note: Changes aren't committed to the EEPROM until the -burn command.
-time
Append a TIME_STAMP_RECORD to the EEPROM with the current time in UTC. Overwrites any previous value.
Note: Changes aren't committed to the EEPROM until the -burn command.
-label <label, up to 8 characters>
An optional label to assign to the next PGA, CCM, SWPGA or SWCCM data record. If you want to have more than one PGA record in the EEPROM, the label will let you select which one to load.
The -label command must be before the -pga, -ccm, -swpga or -swccm command that it will apply to.
-pga <.ini filename>
Append a PGA_REGS_RECORD to the EEPROM with data taken from the first section of the .ini file. This type of data record is used only for lens calibration data consisting of register values and/or firmware variable values. Use this type of record for sensors with built-in lens correction. See -label. Formats the EEPROM if it's not already formatted.
Note1: Changes aren't committed to the EEPROM until the -burn command.
Note2: To load the PGA in DevWare put this command in the sensor .ini file:
LOAD_PROM= 0xA8, PGA [, <label>]
-swpga <.ini filename>
Append a PGA_SW_RECORD to the EEPROM with data taken from the first section of the .ini file. This type of data record is used only for lens calibration data consisting of DevWare software colorpipe STATE= commands. Use this type of record for sensors with no built-in lens correction. See -label. Format the EEPROM if it's not already formatted.
Note1: Changes aren't committed to the EEPROM until the -burn command.
Note2: To load the PGA in DevWare put this command in the sensor .ini file:
LOAD_PROM= 0xA8, SWPGA [, <label>]
-ccm <.ini filename>
Append a CCM_REGS_RECORD to the EEPROM with data taken from the first section of the .ini file. This type of data record is used only for color correction data consisting of register values and/or firmware variable values. Use this type of record for SOC sensors with built-in color correction. See -label. Format the EEPROM if it's not already formatted.
Note1: Changes aren't committed to the EEPROM until the -burn command.
Note2: To load the CCM in DevWare put this command in the sensor .ini file:
LOAD_PROM= 0xA8, CCM [, <label>]
-swccm <.ini filename>
Append a CCM_SW_RECORD to the EEPROM with data taken from the first section of the .ini file. This type of data record is used only for color correction data consisting of DevWare software colorpipe STATE= commands. Use this type of record for sensors with no built-in color correction. See -label. Format the EEPROM if it's not already formatted.
Note1: Changes aren't committed to the EEPROM until the -burn command.
Note2: To load the CCM in DevWare put this command in the sensor .ini file:
LOAD_PROM= 0xA8, SWCCM [, <label>]
-binload <binary filename>
Write the EEPROM with binary data from a file. The file should be an exact image of what you want in the EEPROM. The entire contents of the EEPROM will be replaced (up to the length of the file).
Note: Changes aren't committed to the EEPROM until the -burn command.
-poke <addr> <n>
Set a specific byte of the EEPROM to a specific value.
Note: Changes aren't committed to the EEPROM until the -burn command.
-verify
Re-read the EEPROM and compare to the currently buffered data. Print an error message if there are any differences. This command in only useful immediately following a -burn command.
-dump
Create a hex dump of the contents of the EEPROM. The dump will include any changes made with previous commands that aren't committed to the EEPROM yet. You can use this to get a preview of the EEPROM contents prior to writing it. If the EEPROM is not formatted, dumps the whole EEPROM, otherwise only dumps the existing data records.
-bindump <binary filename>
Dump the contents of the EEPROM to a binary file. The dump will include any changes made with previous commands that aren't committed to the EEPROM yet. You can use this to create an EEPROM image file with no hardware currently connected to the PC.
-dir
List the data records in the EEPROM. Kind of like a dir command on a disk. The list will include any changes made with previous commands that aren't committed to the EEPROM yet.
-list
List the data records in the EEPROM. Kind of like a dir command on a disk. The list will include any changes made with previous commands that aren't committed to the EEPROM yet. PGA and SWPGA data will be expanded showing all the PGA data. The output of -list is a valid DevWare .ini file. (Example: miprom -list >eeprom.ini)
-del <record type>[:<label>]
Delete the record of the specified type. A label string is optional if there is more than one record of that type. You can get a list of the record types and labels with miprom -dir.
Note: Changes aren't committed to the EEPROM until the -burn command.
-base <n>
Set the I2C base address of the EEPROM. Default is 0xA8.
Note: Discards any uncommitted changes, so put before other commands.
-cam <n>
Set which camera to use if there is more than one camera attached to the PC. Fist camera is 0, next is 1, etc. Default is 0.
Note: Discards any uncommitted changes, so put before other commands.
-far
Access the EEPROM indirectly via the sensor firmware.
Note: Discards any uncommitted changes, so put before other commands.