Troubleshooting
Start with the symptom you can observe. Test the unchanged first example from Quick Start before changing your own code.
| Symptom | Check | Fix |
|---|---|---|
| The computer shows no port for the board | USB to serial driver | The board talks over USB-C through a CH340K. If you aren't using macOS, install the CH340 drivers: instructions here. |
| Soldered Inkplate 7SPECTRA is not in the board menu | Board package | Add the board package URL from Quick Start and install Soldered Inkplate Boards in the Boards Manager. |
| Compiling stops with "Wrong board selection for this example" | Selected board | Select Soldered Inkplate 7SPECTRA under Tools → Board → Inkplate Boards. The examples refuse to build for any other board. |
| The Serial Monitor shows nothing or garbled text | Baud rate | The examples that print use 115200 baud. Set the Serial Monitor to match. Many examples print nothing and show their result on the screen only. |
SD Card error! or Image open error in the Serial Monitor | The card and the file | Format the card as FAT, and check that the file name in the sketch matches the file on the card. |
Sd card could not be read in the MicroPython shell | The card | Check that the card is seated and formatted as FAT, then run the script again. |
Failed to connect within timeout in the MicroPython shell | Wi-Fi name and password | The image-from-web example gives up after 30 seconds. Check the SSID and PASSWORD values in the script. |
| The shell prints a warning about running the Inkplate module itself | What you ran | Run an example or your own script, which imports inkplate7spectra, not the module file. |
| The screen shows colors you did not choose | Color values | Use the six constants (index 0 to 5). INKPLATE_GREEN-1 is blue and INKPLATE_BLUE-1 is red; the drawing functions ignore values above 5, and MicroPython draws text with a color above 5 in green. |
| The board does not run from the CR2032 cell | Power source | The CR2032 only keeps the RTC running. Power the board over USB-C or from a 3.7 V Li-ion battery on the JST connector. |
Check the polarity on the battery JST connector before you plug a battery in. Some batteries sold online have reversed polarity, which can damage the board.
Still blocked?
Ask a question on our community! Include the exact product, platform, library revision, example, and observed behavior so someone can reproduce it.