ESPUPDATE Error Messages and Codes - Threetwosevensixseven/espupdate GitHub Wiki

Error Messages

.espupdate can return a variety of BASIC error reports. Some of them are fairly self-explanatory, but please raise an issue ticket if you encounter one you can't resolve yourself.

Error Report	Meaning	Suggestions/Notes
4 Out of memory
Arguments too long
D BREAK - no repeat
Error changing baud
Error exiting write
Error finalizing write
Error reading dot cmd
Error reading firmware
Error uploading stub
Error writing flash
Failed to start stub
Firmware is bad format
Firmware missing
Flash param error 1
Flash param error 2
Invalid Arguments
MD5 hash failure
NextBASIC required
NextZXOS required
Not a firmware file
Spectrum Next required
Sync error or no ESP
Unknown OUI error

Error Codes

Both the ESP ROM and updater stub use error codes to signal problems to .espupdate. Almost all of these indicate abnormal operation of .espupdate, so please raise an issue ticket if you encounter one.

Error Code	Source	Meaning	Suggestions/Notes
0x05	ESP ROM	Received message is invalid
0x06	ESP ROM	Failed to act on received message
0x07	ESP ROM	Invalid CRC in message
0x08	ESP ROM	Flash write error
0x09	ESP ROM	Flash read error
0x0A	ESP ROM	Flash read length error
0x0B	ESP ROM	Deflate error
0xC0	Updater stub	Bad data length
0xC1	Updater stub	Bad data checksum
0xC2	Updater stub	Bad block size
0xC3	Updater stub	Invalid command
0xC4	Updater stub	Failed SPI operation
0xC5	Updater stub	Failed SPI unlock
0xC6	Updater stub	Not in FLASH mode
0xC7	Updater stub	Inflate error
0xC8	Updater stub	Not enough data
0xC9	Updater stub	Too much data
0xFF	Updater stub	Command not implemented