Skip to main content

E20 — LCD_INIT_FAILED

Hardware version

This error only occurs on v4 hardware.

The OLED display failed to initialise, clear, or flush during startup.

What happens​

The error is logged and the firmware continues anyway. lcd_task does not exit — it attempts to keep running. However, display output may be corrupted or absent since the driver did not start cleanly.

Possible causes​

  • The display cable is disconnected or not properly seated. The display is connected via cable on v4 hardware.
  • The OLED module is defective.
  • A transient I²C/SPI communication error during the brief init sequence.

How to fix​

  1. Check the display cable — Power off the device and reseat the cable between the display and the PCB.
  2. Reboot the device — A transient init error may not repeat on a fresh boot.
  3. Contact support — If the display is consistently blank or garbled after reboot, open an issue on GitHub.