Software Troubleshooting

Fix errors, crashes, and code-related problems

Common Python Errors

ImportError: no module named 'pca9685'

Fix: The PCA9685 driver library is missing from the /lib folder on the Pico. Re-upload the pca9685.py file.

MemoryError: memory allocation failed

Fix: You are trying to load too many sequences or large files at once. Try deleting unused sequences or simplify your code.

SyntaxError: invalid syntax

Fix: There is a typo in your config.py or other files. Check the line number mentioned in the error message.

Pico Stuck in Bootloop

If the Pico constantly restarts:

  1. Safe Mode: Disconnect the Pico, hold the BOOTSEL button, and reconnect. This stops it from running main.py.
  2. Wipe Flash: If software is severely corrupted, download theflash_nuke.uf2 file from the Raspberry Pi website to completely reset the Pico.
  3. Re-install MicroPython: After a nuke, re-install the latest UF2 firmware.
←
Troubleshooting: Mechanical
Troubleshooting: Performance
→