In this guide, we will step-by-step guide you to use OPTTool (a software application) to burn OTP bits on SP7350 platforms.
Table of Contents
Table of Contents | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
1. Prerequisites:
Before proceeding, ensure that you have compiled your SP7350 code is compiled to support the OTPTool. Please confirm Confirm that both the OTP driver “OTP driver” and “OTP driver handshake” options in X-Boot is enabled. For guidance, refer to the screenshot below:
...
are enabled. To do this:
Run the command ‘make xconfig' in the project’s top directory. This will open the X-Boot Configuration menu.
In the X-Boot Configuration menu, ensure that the “OTP driver” and “OTP driver handshake” options are enabled. Refer to the screenshot below for guidance:
...
If the options are not enabled, enable them and save the changes. Run the command ‘make' in the project’s top directory to rebuild the code.
Additionally, ensure that the OTP_1V8 power pin of the SP7350 is supplied with 1.8V to allow OTP programming. For example, in the schematic below:
...
Mount R441 with a 0Ω resistor to supply the necessary 1.8V power for writing OTP bits.
2. UART Connection Setup
2.1 Close
...
Terminal Applications
Close terminal applications such as Putty to free up the COM port connected to the SP7350 platform.
2.2 Run OTPTool
Launch "OTPTool V1.0.0.0.exe" on your PC. Once started, the application interface will be displayed as shown below:
...
2.3 Configure COM
...
Port
Set the COM port connected to the SP7350 platform. Refer to screenshot below:
...
Press OK.
2.4 Connect with SP7350 platformPlatform
Click "Connect" button in the OTPTool and power on the SP7350 platform.
...
The status window of OTPTool indicates "CONNECT Success!" as shown above.
3 OTPTool
...
Operations:
3.1 Open Excel
...
File (OTP table)
Open the OTP table Excel file. Refer to screenshot below:
...
When Open diaglog box is displayed, select the Excel file "OTP_TABLE_QAK654.xls". Then, press OK button. Refer to screenshot below, OTP table are loaded successfully.
...
3.2 Read and
...
Modify OTP
...
Bits
Press "Read" button to read the content of OTP from the SP7350 platform. Refer to screenshot below, Read command completed successfully.
...
The status window of OTPTool indicates "READ Start..…” and then “READ Success!" as shown above.
3.3 Write to OTP
...
Bits
For modifications, right-click on the relevant bit or bit range, select "Modify item":
...
After making all necessary modifications, click "Write" to write the changes to the OTP of the SP7350 platform. Refer to screenshot below, bit [543:512] is updated:
...
4. Burning secure-boot and device keys
The SP7350 supports secure-boot functionality. To activate secure-boot, it is necessary to build the code with security enabled and write secure keys into the OTP (One-Time Programmable) memory of the SP7350. There are two keys defined in the OTP - the secure-boot key for digital signatures and the device key for image decryption. Each key is 32 bytes long.
4.1 Burn secure-boot public key (for digital signature) into OPT bit 512 ~ 765
The secure-boot key is stored in the file build/tools/secure_hsm/secure/otp_Sb_keys/ed_pub_0.hex
:
7BBBCF06A44BA7655540A7F8AD5176F4BCA83F00E63442A7BA0C4F5D8BBCF650
Convert the key to little-endian 4-byte words:
OTP[543:512] = 06CFBB7B
OTP[575:544] = 65A74BA4
OTP[607:576] = F8A74055
OTP[639:608] = F47651AD
OTP[671:640] = 003FA8BC
OTP[703:672] = A74234E6
OTP[735:704] = 5D4F0CBA
OTP[767:736] = 50F6BC8B
Input it to OTP words one by one. Afterward, check and then press "Write."
...
The status window of the OTPTool indicates "WRITE Start..…” and then “WRITE Success!" as shown above.
Press 'Read' to read back content of OTP.
...
The status window of the OTPTool indicates "READ Start..…” and then “READ Success!" as shown above.
4.2 Write device private key (for decryption) into OTP bit 768 ~ 1023
The device private key is stored in hex file build/tools/secure_hsm/secure/otp_Device_keys/x_priv_0.hex:
583D9479760D5229611A4601CB1EE80E2C0C7BE1E8F4C637A9EA72D5A5A3B25C
Convert the key to little-endian 4-byte word:
OTP[799:768] = 79943D58
OTP[831:800] = 29520D76
OTP[863:832] = 01461A61
OTP[895:864] = 0EE81ECB
OTP[927:896] = E17B0C2C
OTP[959:928] = 37C6F4E8
OTP[991:960] = D572EAA9
OTP[1023:992] = 5CB2A3A5
Input it to OTP words one by one. Afterward, check and press "Write."
...
The status window of the OTPTool indicates "WRITE Start..…” and then “WRITE Success!" as shown above.
Press 'Read' to confirm the content of OTP.
...
The status window of the OTPTool indicates "READ Start..…” and then “READ Success!" as shown above.
4.3 Enable secure mode of SP7350 (Write 1 into OTP bit 0)
Modify bit 0 to 1 and then press "Write."
...
The status window of the OTPTool indicates "READ Start..…” and then “READ Success!" as shown above.
4.4 Enable MP bit of SP7350 (Write 1 into OTP bit 2)
To safeguard keys from being accessed by end-users, enabling the MP bit prevents the CPU from reading keys.
Modify bit 2 to 1 and then press "Write."
4.5 Important Notes:
...
Do not enable the MP bit for version A chips.
...
Burning OTP bits is irreversible, and incorrect burns may render the chips unusable.
...