Troubleshooting

CircuitPython device restarts intermittently

Your CircuitPython device may periodically restart while being powered by iPhone or iPad – for continuous operation, connect your board to a dedicated power source using the battery port.

Unable to replace/overwrite files on CIRCUITPY drive

Please check to ensure your running the latest 4.x stable release of CircuitPython by following these steps.

If your project requires CircuitPython 5.0.0 or later and you wish to edit your code on iOS/iPadOS follow these steps:

  1. Connect your CircuitPython device to your computer
  2. Open the CIRCUITPY drive (press CMD+Shift+period to view hidden files on macOS)
  3. Delete the file named .Trashes

You should now be able to delete and replace files on your CircuitPython device from iOS/iPadOS.

CircuitPython 5.0.0 uses a file named .Trashes which is hidden by default on macOS. This file prevents macOS from storing deleted files on the CIRCUITPY drive before the system trash is emptied – helping to conserve the limited storage space of CircuitPython devices. Currently, the iOS Files app is incompatible with this technique, and presence of the file prevents deletion of any other file on the CIRCUITPY drive.

CIRCUITPY drive does not mount on iPhone/iPad

Check to ensure your Apple device is running iOS or iPadOS 13 or later. If not, please update your device.

Can I use a USB hub?

Manufacturer designs vary, so we can't guarantee every hub will work for connecting to iPhone/iPad to your CircuitPython device. That being said, we didn't have any issues with the USB hubs we tested - so your hub will likely work as well.

This guide was first published on Sep 27, 2019. It was last updated on Sep 27, 2019.
This page (Troubleshooting) was last updated on Aug 02, 2020.