CircuitPython is a derivative of MicroPython designed to simplify experimentation and education on low-cost microcontrollers. It makes it easier than ever to get prototyping by requiring no upfront desktop software downloads. Simply copy and edit files on the CIRCUITPY drive to iterate.

CircuitPython Quickstart

Follow this step-by-step to quickly get CircuitPython running on your a Kaluga 1.3 board (a Kaluga 1.2 will NOT WORK).

Kaluga USB Connection

Neither of the two Micro USB connectors on the Kaluga provide access to the native USB connection used by CircuitPython. Instead, a USB breakout cable must be connected as follows:

  • USB +5V (red) to Kaluga +5V
  • USB GND (black) to Kaluga GND
  • USB D+ (green) to Kaluga GPIO20
  • USB D- (white) to Kaluga GPIO19

Advanced USB connection

Non-populated resistor positions R151 & R152 connect the "J10" micro-USB connector to native USB. By soldering in a 0-ohm link at these positions, you can use the J10 connector for native USB. Some photos in this guide show a board which has been modified in this way.

Click the reset button once, and then the boot button once when you see the RGB status LED turn purple (approximately half a second later). The second tap needs to happen while the LED is still purple.

Once successful, you will see the RGB status LED(s) turn green (highlighted in green above). If you see red, try another port, or if you're using an adapter or hub, try without the hub, or different adapter or hub.

If double-clicking doesn't work the first time, try again. Sometimes it can take a few tries to get the rhythm right!

A lot of people end up using charge-only USB cables and it is very frustrating! Make sure you have a USB cable you know is good for data sync.

Remember that unless you've modified your Kaluga, you have to use a USB breakout cable, not the built-in USB Micro-B ports!

Because there are multiple variants of the LCD bundled with the Espressif Kaluga development kit, TinyUF2 may show a distorted image on the LCD. This is harmless.

You will see a new disk drive appear called KALUGA1BOOT.

Drag the adafruit-circuitpython-espressif_kaluga_1.3.uf2 file to KALUGA1BOOT

The BOOT drive will disappear and a new disk drive called CIRCUITPY will appear.

That's it!

This guide was first published on Feb 21, 2023. It was last updated on Feb 21, 2023.

This page (Install CircuitPython on Espressif Kaluga with TinyUF2) was last updated on Feb 21, 2023.

Text editor powered by tinymce.