Help
Troubleshooting
What to check when a board does not show up, does not move with the game or will not flash.
The board does not show up
- Try another USB cable: a charge-only one shows no port (Before you start).
- Close whatever else holds the port (The serial port is busy).
- The Guition ESP32-4848S040 on Windows may need a driver (The Guition ESP32-4848S040).
- On a board with two USB sockets, use the one wired to the serial chip.
The dashboard does not move
- Start a game or a replay, then work through When nothing moves.
- One widget stays still while the others move: the current game does not send its value (When there is no value).
After an update the board shows its built-in dashboard
A firmware that brings a new configuration format draws its built-in dashboard until its configuration is saved again; nothing is erased. Update board on the Firmware page does this for you (What the update does). After an update made another way, connect the configurator and save to the board.
The board is in safe mode
Connect the configurator and save a configuration to it: see Safe mode.
Flashing stops or never starts
- Hold the BOOT button while plugging the board in (From the browser).
- Use a Chromium browser on a desktop.
- A board that already runs Pitrig does not need the web flasher (Updating the board’s firmware).
The configurator will not open
- Windows warns about an unsigned app: see Windows.
- macOS refuses to open it: run the command under macOS.
Still stuck? Open an issue on GitHub with your board, the versions of the configurator and SimHub, and what you tried, or send the same through the contact form.