User Manual

spark - InfiniScale® III Firmware Burning ToolRev 1.50
Mellanox Technologies
40
Appendix A: PSID Assignment
In some cases, OEMs or board manufacturers may wish to use a specific FW configuration not
supplied by Mellanox. After setting the new FW parameters in an INI file, the user should assign a
unique PSID (Parameter Set ID) to this new configuration. The PSID is kept as part of the FW
image on the device NVMEM. The firmware burning tools use this field to retain FW settings
while updating FW versions.
This appendix explains how to assign a new PSID for a user customized FW, and how to indicate
to the burning tools that a new PSID exists.
A.1 PSID Field Structure
The PSID field is a 16-ascii (byte) character string. If the assigned PSID length is less then 16
characters, the remaining characters are filled with binary 0s by the burning tool.
Table 6 provides the format of a PSID.
Example:
A PSID for Mellanox’s MHXL-CF128-T HCA board is MT_0030000001, where:
MT_ Mellanox vendor symbol
003 MHXL-CF128-T board symbol
000 Board version symbol
0001 Parameter Set Number
A.2 PSID Assignment and Integration Flow
To assign and integrate the new PSID to produce the new FW
1. Write the new FW configuration file (in .INI format).
2. Assign it with a PSID in the format described above. Use your own vendor symbol to assure
PSID uniqueness.
If you do not know your vendor symbol, please contact your local Mellanox FAE.
3. Set the PSID parameter in the new FW configuration file.
Please change FW parameters with caution. A faulty setting of FW parameters may
result in undefined behavior of the burnt device.
Table 6 - PSID format
Vendor symbol Board Type Symbol
Board Version
Symbol
Parameter Set
Number
Reserved
3 characters 3 characters 3 characters 4 characters
3 characters (filled
with ‘\0’)