1. Skip to content

1. Reduced webinterface (error indication and tracing)

Whenever an error occurs during boot process which avoids loading of regular processing and regular webinterface, a reduced webinterface gets loaded to have at least some visual feedback and the possibilitiy to figure out the root cause by browsing the logfiles or trigger another OTA update.

The error code(s) get printed with specific error codes. This page lists the possible error codes, their meaning and possible solutions.

Note: Here the error codes are defined in source code: error codes.

1.1 Critical Errors

Those Errors make the normal operation of the device impossible. Most likely they are caused by a hardware issue!

1.1.1 0x00000001 PSRAM bad

Your device most likely has no PSRAM at all or it is too small (needs to have at least 4 MBytes)! See Hardware Compatibility.

Usually the log shows something like this: 

psram: PSRAM ID read error: 0xffffffff
cpu_start: Failed to init external RAM!

1.1.2 0x00000002 Heap too small

The firmware failed to allocate enough memory. This most likely is a consequential error of a bad PSRAM!

1.1.3 0x00000004 Cam bad

The attached camera can not be initialized. This usually is because on of the following reasons:

  • The camera is not supported, see Hardware Compatibility
  • The camera is not attached properly -> Try to remove and attach it again. Make sure you move the black part enough into the socket!
  • The camera or the camera cable is damaged

1.1.4 0x00000008 SD card basic check failed

One or more basic SD card checks failed.

The following checks are performed during boot sequence:

  • Write a file (sdcard/sdcheck.txt) to SD card with some generic text
  • Read the written file back
  • CRC verification
  • Delete the file

Detailed error indication (write, rerad or delete error) can be derived from blinking code of red board status LED. Please refer to StatusLED-BlinkCodes

Recommendation: Reformat SD card and check again or try another SD card

1.1.5 0x00000010 SD folder or file presence check failed

One or more mandatory folders and/or files are missing on SD card. To have early indication that SD card is potentially ready for operation, some folder and files, which are mandatory are presence checked. This is not a 100% check and a successful test does not mean everthing is OK.

The following folders / files get checked during boot sequence:

  • /sdcard/config
  • /sdcard/html
  • /sdcard/demo --> created automatically in firmware
  • /sdcard/firmware --> created automatically in firmware
  • /sdcard/img_tmp --> created automatically in firmware
  • /sdcard/log --> created automatically in firmware
  • /sdcard/wlan.ini
  • /sdcard/config/config.ini
  • /sdcard/html/index.html
  • /sdcard/html/ota_page.html
  • /sdcard/html/log.html
  • /sdcard/html/common.js
  • /sdcard/html/version.txt

Note: This list might be outdated, see the source code for the latest implementation: SDCardCheckRW()

Recommendation: Check logs and / or redo a Over-The-Air Update (OTA Update) to ensure proper SD card structure

1.2 Non-Critical Errors

Those Errors can be caused by an error during initialization. It is possible that the error has no impact at all or that a reboot solves it.

1.2.1 0x00000100 Cam Framebuffer bad

The firmware was unable to initialize the Camera Framebuffer. The firmware will continue to work, but other consequential error might arise. A reboot of the device might help.

This might also be caused by a corrupred SD-Card, see CAM is not working anymore" on init #2390

1.2.2 0x00000200 NTP failed

The firmware failed to get the world time from an NTP server. The firmware will continue to work, but has a wrong time.