Skip to main content

Troubleshooting

Start with the symptom you can observe. Test the unchanged first example before changing application code.

SymptomCheckVerified fix
The computer does not list a serial port for the board.Is the CH340 driver installed? The library README asks every non-macOS user to install it.Install the CH340 driver, reconnect the board and select the new port in Tools → Port.
The sketch fails to compile with "Wrong board selection for this example".Which board is selected in Tools → Board?Select Soldered Inkplate10 from Tools → Board → Inkplate Boards.
The upload works but the screen does not change.Does your sketch call display.display() after drawing?clearDisplay() and the drawing functions only change the frame buffer in memory. Call display() to refresh the panel.
Streaks or faint traces of old content stay on the screen.Have you used many partial updates in a row?Run a full update with display(), or run the library's Inkplate10_Burn_In_Clean example, which repeats full refreshes and shows "Clearing done." at the end. Keep the board powered for the whole run and expect several minutes. Severe cases may need more than one run.
You are about to connect a Li-ion battery.Does the battery polarity match the markings on the board?Check before you plug it in. The library README warns that some batteries sold online have reversed polarity, which can damage the board, and says the pouch batteries from soldered.com are safe to use.
The RTC loses the time after power is removed.Is a CR2032 coin cell in the RTC battery holder?The README says the CR2032 battery is only an RTC backup and cannot power Inkplate.

If an upload fails or the screen will not refresh, try these in order:

  1. Use another USB port or cable. Some ports supply too little current for the board.
  2. Re-seat the panel flat cable in its connector.
  3. Upload an unmodified library example to rule out a problem in your own code.

Still blocked?​

Ask a question on our community! Include the exact product, platform, library revision, example, and observed behavior so someone can reproduce it.