11.8 Image Creation – Troubleshooting
If you got to this section, it means something in the process went wrong. Before debugging Gang Programming, please make sure you turn on verbose mode for maximum debugging information. Pick Window → Preferences from the top toolbar. Under Uniflash Preferences, the Print out additional debug information for the supported modules should be checked for full debug messages.
The following checklist includes the main nodes in the process and expected results:
- Image creation: upon a successful creation, a Finished successfully!!!! message should appear on the Console window with some additional debug messages
- Image Programming
- Using any off-the-shelf SPI programmer (mainly before assembly on the target boards): a successful programming is tool specific.
- Using Uniflash (via UART lines): upon a successful programming, Uniflash should not print any error messages on the Console window.
- Image extraction: upon resetting the board, an indication from the Host MCU for successful power-up should be generated.
- Post extraction: after image extraction is completed, user application should be executed with no issues (as if files were programmed separately).
Possible issues at each node and respective solutions:
- Image creation
- same filename is used
- You should see an exclamation mark indicating this error. Please avoid using the same filename more than once.
- Total files exceed the size of the serial flash:
- Try to use 0 as Max file size so the minimum size is allocated (original file size)
- Make sure you do not add the Write Gang Image File command. It reduces the size of the image
- Try to remove some unnecessary files is possible
- Any other error:
- Capture the error code on the Console window. The error code is the number following the ‘Exit code >’ prefix.
- Image Programming:
- Using any off-the-shelf SPI programmer:
- Make sure all SPI lines are connected properly
- Make sure either raw binary (*.bin) or IntelHex binary (*.hex) are used properly with the tool
- Read back image and verify
- Using Uniflash:
- Make sure you use the raw binary (*.bin) and not the IntelHex binary (*.hex)
- Uniflash should not print any error messages on the Console window. For any error, please open an E2E ticket.
- Image extraction:
- Serial flash is not formatted:
- Make sure Format Storage command is added to the image
- Any other error:
- If Start Logger command is added, try to raw read the entire content using external tools and search for the first text line of the log: "Start Log" or 617274204C6F67 in hexadecimal. Open an E2E and attach the capture
- For help, open an E2E ticket in all other cases.
- Post extraction
- Experiencing issues when invoking APIs that implicitly creates files on the serial flash. These APIs creates configuration files.
- It is possible that the free space left on the serial flash after extraction is not enough. Please try to free some space on the original image and retry
- For help, open an E2E ticket in all other cases.