Noisebridge - User contributions [en]

Circuit Python at Noisebridge

2023-08-29T01:15:05Z

158.51.83.162: /* Getting Started with Programming */

==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/
* We are using the '''[https://www.wemos.cc/en/latest/s2/s2_mini.html 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 get libraries, go here: https://circuitpython.org/libraries. remember to put the libraries you need in the '''/lib''' directory.

* Run the "hello world" code found in '''[https://codeberg.org/headrotor/circuitpython-examples/src/branch/main/lolinS2mini/code.py 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 (<tt>board.LED</tt>) blink from the button (<tt>board.BUTTON</tt>)? https://learn.adafruit.com/circuitpython-essentials/circuitpython-digital-in-out
* 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 '''[https://docs.ntfy.sh/ 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
<pre>
switch = DigitalInOut(board.button)
switch.direction = Direction.INPUT
switch.pull = Pull.UP
</pre>

To see the names of the pins available, enter the REPL (using Mu or a terminal program
<pre>
import board
dir(board)
</pre>

* For the LED library, pin 1 = <tt>IO1</tt> and so forth... If you have installed only the outside headers, use pin <tt>IO3</tt> (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).

{| class="wikitable" style="margin:auto"
|+ Lolin D2 Mini Pinout
|-
! Python Name !! Alternate Name !! Pin Number
|-
| board.IO0 || board.BUTTON || (button)
|-
| board.IO1 || || 1
|-
| board.IO2 || || 2
|-
| board.IO3 || || 3
|-
| board.IO4 || || 4
|-
| board.IO5 || || 5
|-
| board.IO6 || || 6
|-
| board.IO7 || board.SCK || 7
|-
| board.IO8 || || 8
|-
| board.IO9 || board.MISO || 9
|-
| board.IO10 || || 10
|-
| board.IO11 || board.MOSI || 11
|-
| board.IO12 || || 12
|-
| board.IO13 || || 13
|-
| board.IO14 || || 14
|-
| board.IO15 || board.LED || (LED)
|-
| board.IO16 || || 16
|-
| board.IO17 || || 17
|-
| board.IO18 || || 18
|-
| board.IO21 || || 21
|-
| board.IO33 || board.SDA || 33
|-
| board.IO34 || || 34
|-
| board.IO35 || board.SCL || 35
|-
| board.IO36 || || 36
|-
| board.IO37 || || 37
|-
| board.IO38 || || 38
|-
| board.IO39 || || 39
|-
| board.IO40 || || 40
|-
|}

Some alternate pin names are available, these don't correspond to anything on the board so no need to use them.

<pre>
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
</pre>

==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 "<tt>0</tt>" button, press and release the "<tt>RESET</tt>" button. Make sure there's a tty (com port) available.
# Install <tt>esptool.py</tt> frop PIP: <tt> python -m pip install esptool </tt>
# At the command line, enter <pre> 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</pre> (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 <tt>esptool.py --port PORT_NAME erase_flash</tt>, and/or repeat until it enumerates as <tt>/dev/ttyACM1</tt>)
# 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 <tt>CIRCUITPY</tt>
# You are now able to edit <tt>code.py</tt>, add libraries to <tt>/lib</tt>, and connect to the serial port (usually <tt>/dev/ttyACM0</tt> on Mac/Linux or <tt>COM3</tt> on Windows

Circuit Python at Noisebridge

2023-08-28T19:15:48Z

158.51.83.162: Added link to code examples

==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/
* We are using the '''[https://www.wemos.cc/en/latest/s2/s2_mini.html 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.

* Run the "hello world" code found in '''[https://codeberg.org/headrotor/circuitpython-examples/src/branch/main/lolinS2mini/code.py 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 (<tt>board.LED</tt>) blink from the button (<tt>board.BUTTON</tt>)? https://learn.adafruit.com/circuitpython-essentials/circuitpython-digital-in-out
* 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, or connecting to your phone!

Having problems? Working examples of code for the first three 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
<pre>
switch = DigitalInOut(board.button)
switch.direction = Direction.INPUT
switch.pull = Pull.UP
</pre>

To see the names of the pins available, enter the REPL (using Mu or a terminal program
<pre>
import board
dir(board)
</pre>

* For the LED library, pin 1 = <tt>IO1</tt> and so forth... If you have installed only the outside headers, use pin <tt>IO3</tt> (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).

{| class="wikitable" style="margin:auto"
|+ Lolin D2 Mini Pinout
|-
! Python Name !! Alternate Name !! Pin Number
|-
| board.IO0 || board.BUTTON || (button)
|-
| board.IO1 || || 1
|-
| board.IO2 || || 2
|-
| board.IO3 || || 3
|-
| board.IO4 || || 4
|-
| board.IO5 || || 5
|-
| board.IO6 || || 6
|-
| board.IO7 || board.SCK || 7
|-
| board.IO8 || || 8
|-
| board.IO9 || board.MISO || 9
|-
| board.IO10 || || 10
|-
| board.IO11 || board.MOSI || 11
|-
| board.IO12 || || 12
|-
| board.IO13 || || 13
|-
| board.IO14 || || 14
|-
| board.IO15 || board.LED || (LED)
|-
| board.IO16 || || 16
|-
| board.IO17 || || 17
|-
| board.IO18 || || 18
|-
| board.IO21 || || 21
|-
| board.IO33 || board.SDA || 33
|-
| board.IO34 || || 34
|-
| board.IO35 || board.SCL || 35
|-
| board.IO36 || || 36
|-
| board.IO37 || || 37
|-
| board.IO38 || || 38
|-
| board.IO39 || || 39
|-
| board.IO40 || || 40
|-
|}

Some alternate pin names are available, these don't correspond to anything on the board so no need to use them.

<pre>
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
</pre>

==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 "<tt>0</tt>" button, press and release the "<tt>RESET</tt>" button. Make sure there's a tty (com port) available.
# Install <tt>esptool.py</tt> frop PIP: <tt> python -m pip install esptool </tt>
# At the command line, enter <pre> 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</pre> (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 <tt>esptool.py --port PORT_NAME erase_flash</tt>, and/or repeat until it enumerates as <tt>/dev/ttyACM1</tt>)
# 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 <tt>CIRCUITPY</tt>
# You are now able to edit <tt>code.py</tt>, add libraries to <tt>/lib</tt>, and connect to the serial port (usually <tt>/dev/ttyACM0</tt> on Mac/Linux or <tt>COM3</tt> on Windows

Circuit Python at Noisebridge

2023-08-28T17:12:10Z

158.51.83.162: /* Hooking up Hardware */

==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/
* We are using the '''[https://www.wemos.cc/en/latest/s2/s2_mini.html Lolin S2 Mini]''' board. Here's some information: https://circuitpython.org/board/lolin_s2_mini/

==Getting Started with Programming==

* Try something simple. Can you make the onboard LED (<tt>board.LED</tt>) blink from the button (<tt>board.BUTTON</tt>)? https://learn.adafruit.com/circuitpython-essentials/circuitpython-digital-in-out
* 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, or connecting to your phone!

==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
<pre>
switch = DigitalInOut(board.button)
switch.direction = Direction.INPUT
switch.pull = Pull.UP
</pre>

To see the names of the pins available, enter the REPL (using Mu or a terminal program
<pre>
import board
dir(board)
</pre>

* For the LED library, pin 1 = <tt>IO1</tt> and so forth... If you have installed only the outside headers, use pin <tt>IO3</tt> (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).

{| class="wikitable" style="margin:auto"
|+ Lolin D2 Mini Pinout
|-
! Python Name !! Alternate Name !! Pin Number
|-
| board.IO0 || board.BUTTON || (button)
|-
| board.IO1 || || 1
|-
| board.IO2 || || 2
|-
| board.IO3 || || 3
|-
| board.IO4 || || 4
|-
| board.IO5 || || 5
|-
| board.IO6 || || 6
|-
| board.IO7 || board.SCK || 7
|-
| board.IO8 || || 8
|-
| board.IO9 || board.MISO || 9
|-
| board.IO10 || || 10
|-
| board.IO11 || board.MOSI || 11
|-
| board.IO12 || || 12
|-
| board.IO13 || || 13
|-
| board.IO14 || || 14
|-
| board.IO15 || board.LED || (LED)
|-
| board.IO16 || || 16
|-
| board.IO17 || || 17
|-
| board.IO18 || || 18
|-
| board.IO21 || || 21
|-
| board.IO33 || board.SDA || 33
|-
| board.IO34 || || 34
|-
| board.IO35 || board.SCL || 35
|-
| board.IO36 || || 36
|-
| board.IO37 || || 37
|-
| board.IO38 || || 38
|-
| board.IO39 || || 39
|-
| board.IO40 || || 40
|-
|}

Some alternate pin names are available, these don't correspond to anything on the board so no need to use them.

<pre>
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
</pre>

==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 "<tt>0</tt>" button, press and release the "<tt>RESET</tt>" button. Make sure there's a tty (com port) available.
# Install <tt>esptool.py</tt> frop PIP: <tt> python -m pip install esptool </tt>
# At the command line, enter <pre> 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</pre> (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 <tt>esptool.py --port PORT_NAME erase_flash</tt>, and/or repeat until it enumerates as <tt>/dev/ttyACM1</tt>)
# 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 <tt>CIRCUITPY</tt>
# You are now able to edit <tt>code.py</tt>, add libraries to <tt>/lib</tt>, and connect to the serial port (usually <tt>/dev/ttyACM0</tt> on Mac/Linux or <tt>COM3</tt> on Windows