firmware: Add the ability to track pressed (triggered) and released for gate in and the button independently.

Note: This is a *breaking* change. `bhb.update()` must be called for every loop in `code.py`.
To upgrade, just replace:

```
while True:
```

with

```
while bhb.update():
```

in code.py. The examples have all been updated.

Added two additional samples for separate press & release and separate button & gate.

Closes #5

Author: theacodes

examples/button_gate.py

@@ -0,0 +1,15 @@
+# This example shows how to play a different sample depending on if the
+# button is pressed or the gate in is triggered.
+
+import winterbloom_bhb
+
+bhb = winterbloom_bhb.BigHonkingButton()
+
+snare = bhb.load_sample("samples/snare.wav")
+clap = bhb.load_sample("samples/clap.wav")
+
+while bhb.update():
+    if bhb.button.pressed:
+        bhb.play(snare)
+    elif bhb.gate_in.triggered:
+        bhb.play(clap)

examples/cv_select.py

@@ -15,7 +15,7 @@
     bhb.load_sample("samples/snare.wav"),
 ]
 
-while True:
+while bhb.update():
     if bhb.triggered:
         # This selects a sample from the list based on the pitch CV input.
         # The samples are evenly distributed across the CV range,

examples/cycle.py

@@ -16,7 +16,7 @@
 
 current_sample_no = 0
 
-while True:
+while bhb.update():
     if bhb.triggered:
         bhb.gate_out = True
         bhb.play(samples[current_sample_no], pitch_cv=bhb.pitch_in)
@@ -25,4 +25,4 @@
             current_sample_no = 0
 
     if bhb.released:
-        bhb.gate_out = False
+        bhb.gate_out = False

examples/default.py

@@ -8,7 +8,7 @@
 bhb = winterbloom_bhb.BigHonkingButton()
 sample = bhb.load_sample("samples/honk.wav")
 
-while True:
+while bhb.update():
     if bhb.triggered:
         bhb.gate_out = True
         bhb.play(sample, pitch_cv=bhb.pitch_in)

examples/honk_burst.py

@@ -1,6 +1,6 @@
-"""This example turns a Winterbloom Big Honking Button into a simple
-burst generator (that also happens to honk)
-"""
+# This example turns the Big Honking Button into a simple
+# burst generator (that also happens to honk)
+
 import time
 
 import winterbloom_bhb
@@ -9,7 +9,7 @@
 sample = bhb.load_sample("samples/honk.wav")
 burst_intervals = [0.05, 0.05, 0.05, 0.05, 0.1]
 
-while True:
+while bhb.update():
     if bhb.triggered:
         for interval in burst_intervals:
             bhb.gate_out = True

examples/noise.py

@@ -19,7 +19,7 @@ def generate_noise(volume=1.0):
 
     for i in range(length):
         samples[i] = int(random.random() * volume)
-    
+
     return samples
 
 noise = generate_noise(0.8)
@@ -33,11 +33,11 @@ def generate_noise(volume=1.0):
 sample.sample_rate = frequency * len(noise)
 
 
-while True:
+while bhb.update():
     if bhb.triggered:
         bhb.gate_out = True
         bhb.play(sample, loop=True)
 
     if bhb.released:
         bhb.gate_out = False
-        bhb.stop()
+        bhb.stop()

examples/press_release.py

@@ -0,0 +1,18 @@
+# This example shows how to play a different sample when the button is
+# pressed and when the button is released.
+
+import winterbloom_bhb
+
+bhb = winterbloom_bhb.BigHonkingButton()
+
+snare = bhb.load_sample("samples/snare.wav")
+reverse = bhb.load_sample("samples/reverse.wav")
+
+while bhb.update():
+    if bhb.triggered:
+        bhb.gate_out = True
+        bhb.play(snare)
+
+    if bhb.released:
+        bhb.gate_out = False
+        bhb.play(reverse)

examples/random.py

@@ -12,10 +12,10 @@
     bhb.load_sample("samples/clap.wav"),
 ]
 
-while True:
+while bhb.update():
     if bhb.triggered:
         bhb.gate_out = True
         bhb.play(random.choice(samples), pitch_cv=bhb.pitch_in)
 
     if bhb.released:
-        bhb.gate_out = False
+        bhb.gate_out = False

examples/sine.py

@@ -22,7 +22,7 @@ def generate_sine_wave(volume=1.0):
 
     for i in range(length):
         samples[i] = int((1 + math.sin(math.pi * 2 * i / length)) * volume)
-    
+
     return samples
 
 sine_wave = generate_sine_wave(0.8)
@@ -35,11 +35,11 @@ def generate_sine_wave(volume=1.0):
 sample.sample_rate = frequency * len(sine_wave)
 
 
-while True:
+while bhb.update():
     if bhb.triggered:
         bhb.gate_out = True
         bhb.play(sample, loop=True)
 
     if bhb.released:
         bhb.gate_out = False
-        bhb.stop()
+        bhb.stop()

examples/tap_tempo.py

@@ -25,7 +25,7 @@
 last_button_press = time.monotonic()
 
 
-while True:
+while bhb.update():
     # Get the current time and see if enough
     # time has passed to play the sample.
     now = time.monotonic()