Circuit Python at Noisebridge
Circuit Python at Noisebridge
Welcome to this page, which will get you started with Circuit Python. You can do this any time, or with a group at Circuit Hacking Monday
Some links to get started:
- If you are new to Circuit Python, start here! https://learn.adafruit.com/welcome-to-circuitpython/
- Also see CircuitPython Essentials Learn Guide
- We are using the Lolin S2 Mini board. Here's some information: https://circuitpython.org/board/lolin_s2_mini/
Getting Started with Programming
Your board will automatically run the code found in the file code.py. Change the contents of that file to run different code.
To use most hardware like NeoPixel LEDs, sensors, or motor drivers, you will need to install the appropriate library. Here's how to do that:
https://learn.adafruit.com/welcome-to-circuitpython/circuitpython-libraries. If you are OK using the CLI you can use circup. Remember to put the libraries you need in the
Documentation Links (thanks to todbot's Circuit Python Tricks!)
- The Python Tutorial on Python.org, since "CircuitPython is Python" mostly. (approx. Python 3.4)
- CircuitPython API reference, particularly the "Core Modules > Modules" section in the left sidebar for compiled-in libraries like
- Pure-Python libraries in Adafruit Library Bundle for drivers & [helpers](https://github.com/adafruit/Adafruit_CircuitPython_Bundle/tree/main/libraries/helpers) libraries like
Things to Try!
- Run the "hello world" code found in code.py. This will blink the LED and write text to the serial output for debugging.
- Try something simple. Can you make the onboard LED (
board.LED) blink from the button (
- Can you change the brightness of the LED using PWM? https://learn.adafruit.com/circuitpython-essentials/circuitpython-pwm
- Try something more complicated, like controlling Neopixel addressable LEDs: https://learn.adafruit.com/circuitpython-essentials/circuitpython-neopixel
- Your board can look like a USB HID device, so you can make it into a keyboard! https://learn.adafruit.com/make-it-a-keyboard/circuitpython
- Your board is Wi-Fi and Bluetooth capable! Try running a webserver: https://docs.circuitpython.org/projects/httpserver/en/latest/index.html
- Your board can send alerts to your phone using ntfy.sh. Here's how: https://www.tomshardware.com/how-to/send-alerts-raspberry-pi-pico-w-to-mobile-device
Having problems? Working examples of code for several suggestions can be found here: https://codeberg.org/headrotor/circuitpython-examples
Hooking up Hardware
We have soldering equipment so you can install the headers that came with your board. A good tip is to put the headers into a solderless breadboard before soldering so they are straight and even. Only install the outside headers (odd pins) if you want to use this in a solderless breadboard otherwise they will short! We have lots of hardware to play with including sensors and Neopixel LEDs; you will need the Adafruit library: https://learn.adafruit.com/circuitpython-essentials/circuitpython-neopixel
Tips and Tricks
Note the button needs a pullup so be sure to set
switch = DigitalInOut(board.button) switch.direction = Direction.INPUT switch.pull = Pull.UP
To see the names of the pins available, enter the REPL (using Mu or a terminal program
import board dir(board)
- For the LED library, pin 1 = IO1 and so forth... If you have installed only the outside headers, use pin IO3 (or odd numbered pins) so that there's something to connect to.
- It is possible that the silkscreen labels for pins 12 and 13 have been swapped. Test to make sure!
- Todbot has some fun code to play with, like synthesizers! https://gist.github.com/todbot/
Lolin S2 Mini pinout
Here is a mapping of Python pin names to the board pins (labeled in white on the bottom of the board). a "YES" in the "Touch" column means that
touchio capacitive sensing can be used for that pin.
|Python Name||Alternate Name||Pin Number||Touch|
Some alternate pin names are available, these don't correspond to anything on the board so no need to use them.
board.A0 board.IO3 board.D0 board.IO5 board.D1 board.IO35 board.D2 board.IO33 board.D3 board.IO18 board.D4 board.IO16 board.D5 board.IO7 board.D6 board.IO9 board.D7 board.IO11 board.D8 board.IO13
Installing Circuit Python on Lolin S2 Mini boards
We have already done this for you! But you might need to do it again, or if you get your own boards, this is how we do it.
- Download the latest Circuit Python binary from here: https://circuitpython.org/board/lolin_s2_mini/
- Put the Lolin S2 board into tty mode: while holding down the "0" button, press and release the "RESET" button. Make sure there's a tty (com port) available.
- Install esptool.py frop PIP: python -m pip install esptool
- At the command line, enter
esptool.py -p /dev/ttyACM0 --chip esp32s2 --baud 1000000 write_flash -z 0x0 adafruit-circuitpython-lolin_s2_mini-en_US-8.0.0-beta.6.bin(use the right serial port if not ttyACM0, also use filename of the binary you just downloaded: it will be more recent than 8.0.0)
- (if this doesn't work at first, try erasing flash with esptool.py --port PORT_NAME erase_flash, and/or repeat until it enumerates as /dev/ttyACM1)
- You can also do the previous 2 steps using https://adafruit.github.io/Adafruit_WebSerial_ESPTool/ or https://espressif.github.io/esptool-js/ but only on Chrome browsers. This can fix problems if esptool is not working.
- Reconnect your S2 Mini board, you should see a removable drive appear labeled CIRCUITPY
- You are now able to edit code.py, add libraries to /lib, and connect to the serial port (usually /dev/ttyACM0 on Mac/Linux or COM3 on Windows