add initial files

Author: braingram

README.md

@@ -0,0 +1,20 @@
+Welcome!
+
+This 2 hour workshop will introduce you to using CircuitPython to bridge the
+digital and physical worlds. You'll learn how to program a small, specialized
+computer (a microcontroller) to control devices in the physical world. This
+workshop is hands on and you will:
+- wire up a circuit
+- program a microcontroller
+- build an electronic instrument to measure reaction time
+- use the instrument to generate data on your reaction time
+
+The course material is divided into:
+- a list of parts to order for each participant
+- a project template (used for all examples)
+- lecture slides
+- example code
+
+To aid initial learning the microcontrollers are preloaded with CircuitPython
+(and a few libraries). For instructors (or those following independent study,
+see 'template' for setup instructions).

examples/led_button/code.py

@@ -0,0 +1,55 @@
+import board
+import digitalio
+import neopixel
+
+
+# the following globals and functions could be included as a module
+
+# make an object to control the NEOPIXEL, multi-color LED
+pixel = neopixel.NeoPixel(board.NEOPIXEL, 1)
+
+# configure the button pin (digital pin 5, D5)
+button = digitalio.DigitalInOut(board.D5)
+
+# define button pin as an input
+button.direction = digitalio.Direction.INPUT
+
+# add a 'pull up' to set the default value of this pin to True
+button.pull = digitalio.Pull.UP
+
+
+def set_brightness(value):
+    # set the LED brightness to a value from 0 to 1
+    pixel.brightness = value
+
+
+def set_color(red, green, blue):
+    # set the LED color by defining the red, green and blue
+    # components using values from 0 to 255
+    # (255, 0, 0) will be red
+    # (0, 255, 0) will be green
+    # (255, 255, 0) will be yellow
+    # (255, 255, 255) will be white
+    pixel.fill((red, green, blue))
+
+
+def is_button_pressed():
+    # the pin was configured with a 'pull up' so it's default value is True
+    # pressing the button connects the button pin to ground and changes
+    # the value to False
+    # this function should return True when the button is pressed so we need
+    # to invert the value
+    return not button.value
+
+# set the pixel color to red
+set_color(255, 0, 0)
+
+# run this code forever (until powered down)
+while True:
+    # if the button is pressed..
+    if is_button_pressed():
+        # turn on the light, LED, to full brightness
+        set_brightness(1.0)
+    else:
+        # else, turn off the LED
+        set_brightness(0.0)

examples/reaction_time/code.py

@@ -0,0 +1,82 @@
+import board
+import digitalio
+import neopixel
+
+import time
+
+
+# the following globals and functions could be included as a module
+
+# make an object to control the NEOPIXEL, multi-color LED
+pixel = neopixel.NeoPixel(board.NEOPIXEL, 1)
+
+# configure the button pin (digital pin 5, D5)
+button = digitalio.DigitalInOut(board.D5)
+
+# define button pin as an input
+button.direction = digitalio.Direction.INPUT
+
+# add a 'pull up' to set the default value of this pin to True
+button.pull = digitalio.Pull.UP
+
+
+def set_brightness(value):
+    # set the LED brightness to a value from 0 to 1
+    pixel.brightness = value
+
+
+def set_color(red, green, blue):
+    # set the LED color by defining the red, green and blue
+    # components using values from 0 to 255
+    # (255, 0, 0) will be red
+    # (0, 255, 0) will be green
+    # (255, 255, 0) will be yellow
+    # (255, 255, 255) will be white
+    pixel.fill((red, green, blue))
+
+
+def is_button_pressed():
+    # the pin was configured with a 'pull up' so it's default value is True
+    # pressing the button connects the button pin to ground and changes
+    # the value to False
+    # this function should return True when the button is pressed so we need
+    # to invert the value
+    return not button.value
+
+
+# start trial count at 0
+trial_count = 0
+
+# set led color to pure red
+set_color(255, 0, 0)
+
+# run trials
+while True:
+    # turn on light
+    set_brightness(1.0)
+
+    # record starting time
+    start_time = time.monotonic()
+
+    # wait for the button to be pressed
+    while not is_button_pressed():
+        # do nothing if the button is not pressed
+        pass
+
+    # record time end time (when button was pressed)
+    end_time = time.monotonic()
+
+    # turn off light
+    set_brightness(0.0)
+
+    # compute time between light onset and button press
+    reaction_time = end_time - start_time
+
+    # report reaction time as comma separated text
+    print("%s,%s" % (trial_count, reaction_time))
+
+    # increment trial count
+    trial_count += 1
+
+    # wait a short time between trials
+    time.sleep(5)

template/README.md

@@ -0,0 +1,11 @@
+Plug in the RP2040 feather to your computer. Next, hold down 'boot sel'
+button and press the 'reset' button (while holding 'boot sel'). Release
+'boot sel' and the RP2040 feather should appear as a USB flash/thumb
+drive. Copy the .uf2 file in this directory to the drive. The RP2040
+feather should reset and reappear as a drive with a 'code.py' file and
+a 'libs' directory. Copy the files in the 'libs' directory in this
+directory (the 'neopixel.mpy' and 'adafruit_pixelbuf.mpy' files)
+to the 'libs' directory on the RP2040 feather.
+
+You should now be ready to load any of the examples for this workshop
+onto the RP2040 feather!