how
Tuesday 1 April 2025 3 versions

How do you start?

Select a micro-controller Board

  • without WiFi and Bluetooth
    • RPi-Pico, RPi-Pico2
    • VCC-GND YD-RP2040
    • several boards by WaveShare
  • with WiFi and BLE
    • RPi-Pico-W, RPi-Pico2-W
    • several boards by Pimoroni

Download the matching Firmware

… from Adafruit’s CircuitPython “store” at https://circuitpython.org/down…
… or from the assets directory.

  1. select your board
  2. download the “latest” Firmware: “adafruit-circuitpython-manufacturer-boardname-version.UF2”
  3. and save it to your PC

Install this Firmware to your Board

Read the installation notes in the Adafruit learn guide.

  • Flash procedure:
  1. insert USB cable into Board (but leave PC side unconnected!)
  2. press BOOT button on Board
  3. next, insert USB cable into your PC (and still keep the BOOT button pressed)
  4. now, release the BOOT button
  5. a new USB drive, called “RPI-RP2”, appears
  6. copy the appropriate “.UF2” file to the USB drive “RPI-RP2”
  7. the Board reboots and USB drive “RPI-RP2” disappears
  8. a new USB drive, called “CIRCUITPY”, appears
  9. Finished!

Install additional Tools on your PC

  1. install an Editor or IDE:
  2. install Adafruit’s CIRCUP tool to manage the Adafruit and Community libraries on your Board
  3. use your PC’s Filemanager to explore and manage the files on the CIRCUITPY drive