Add more samples, add examples, add ability to loop samples

Author: theacodes

examples/cycle.py

@@ -0,0 +1,28 @@
+# This example shows how to load multiple samples and
+# cycle through them. Each time the button is pressed,
+# it plays a sample and then advances to the next
+# sample in the list.
+
+import winterbloom_bhb
+
+bhb = winterbloom_bhb.BigHonkingButton()
+
+
+samples = [
+    bhb.load_sample("samples/kick.wav"),
+    bhb.load_sample("samples/snare.wav"),
+    bhb.load_sample("samples/clap.wav"),
+]
+
+current_sample_no = 0
+
+while True:
+    if bhb.triggered:
+        bhb.gate_out = True
+        bhb.play(samples[current_sample_no], pitch_cv=bhb.pitch_in)
+        current_sample_no += 1
+        if current_sample_no >= len(samples):
+            current_sample_no = 0
+
+    if bhb.released:
+        bhb.gate_out = False

examples/default.py

@@ -0,0 +1,20 @@
+# This is the default program that comes on the Big Honking Button.
+# It makes a honk sound when the button is pressed (or the gate
+# is triggered) and you can change the honk sound's pitch using
+# the CV input.
+
+import winterbloom_bhb
+
+bhb = winterbloom_bhb.BigHonkingButton()
+sample = bhb.load_sample("samples/honk.wav")
+
+while True:
+    if bhb.triggered:
+        bhb.gate_out = True
+        bhb.play(sample, pitch_cv=bhb.pitch_in)
+
+    if bhb.released:
+        bhb.gate_out = False
+        # Uncomment the call to stop to make the sample
+        # stop playing as soon as you release the button.
+        # bhb.stop()

examples/noise.py

@@ -0,0 +1,43 @@
+# This advanced sample is similar to the sine example, except
+# it generates white noise.
+
+import array
+import random
+import audiocore
+import winterbloom_bhb
+
+bhb = winterbloom_bhb.BigHonkingButton()
+
+
+# This generates a raw set of samples that represents one full
+# cycle of a sine wave. If you wanted different waveforms, you
+# could change the formula here to generate that instead.
+def generate_noise(volume=1.0):
+    volume = volume * (2 ** 15 - 1)  # Increase this to increase the volume of the tone.
+    length = 800
+    samples = array.array("H", [0] * length)
+
+    for i in range(length):
+        samples[i] = int(random.random() * volume)
+    
+    return samples
+
+noise = generate_noise(0.8)
+sample = audiocore.RawSample(noise)
+
+# Change this to set the noise sample's frequency.
+# This generate works well as pretty low numbers,
+# but you can get some interesting effects at higher
+# values.
+frequency = 2
+sample.sample_rate = frequency * len(noise)
+
+
+while True:
+    if bhb.triggered:
+        bhb.gate_out = True
+        bhb.play(sample, loop=True)
+
+    if bhb.released:
+        bhb.gate_out = False
+        bhb.stop()

examples/random.py

@@ -0,0 +1,21 @@
+# This example shows how to load multiple samples and
+# select one at random to play when the button is pressed.
+
+import random
+import winterbloom_bhb
+
+bhb = winterbloom_bhb.BigHonkingButton()
+
+samples = [
+    bhb.load_sample("samples/kick.wav"),
+    bhb.load_sample("samples/snare.wav"),
+    bhb.load_sample("samples/clap.wav"),
+]
+
+while True:
+    if bhb.triggered:
+        bhb.gate_out = True
+        bhb.play(random.choice(samples), pitch_cv=bhb.pitch_in)
+
+    if bhb.released:
+        bhb.gate_out = False

examples/sine.py

@@ -0,0 +1,45 @@
+# This advanced sample shows how to create a custom waveform
+# for the button to output. In this case, it generates a
+# sine wave. You can use this example as a basis for very
+# basic oscillators.
+# See also noise.py
+
+import array
+import math
+import audiocore
+import winterbloom_bhb
+
+bhb = winterbloom_bhb.BigHonkingButton()
+
+
+# This generates a raw set of samples that represents one full
+# cycle of a sine wave. If you wanted different waveforms, you
+# could change the formula here to generate that instead.
+def generate_sine_wave(volume=1.0):
+    volume = volume * (2 ** 15 - 1)  # Increase this to increase the volume of the tone.
+    length = 100
+    samples = array.array("H", [0] * length)
+
+    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)
+sample = audiocore.RawSample(sine_wave)
+
+# Change this to play different notes. You can also
+# check the CV input using `bhb.pitch_in` and re-adjust
+# the sample rate.
+frequency = 440
+sample.sample_rate = frequency * len(sine_wave)
+
+
+while True:
+    if bhb.triggered:
+        bhb.gate_out = True
+        bhb.play(sample, loop=True)
+
+    if bhb.released:
+        bhb.gate_out = False
+        bhb.stop()

examples/tap_tempo.py

@@ -0,0 +1,45 @@
+# This example shows how to use the button as a means of
+# setting a tempo and continuously triggering a sample
+# a sample based on the tapped out tempo on the button
+# (or via the gate input).
+
+import time
+import winterbloom_bhb
+
+bhb = winterbloom_bhb.BigHonkingButton()
+sample = bhb.load_sample("samples/kick.wav")
+
+# The interval determines how many seconds
+# between samples. At startup, it'll play
+# the sample once every half second.
+interval = 0.5  # seconds
+
+# This keeps track of the last time the
+# sample was played.
+last_sample_played = time.monotonic()
+
+# This keeps track of the last time the
+# button was pressed. On startup, it's
+# just set to the current time, but
+# it doesn't really matter.
+last_button_press = time.monotonic()
+
+
+while True:
+    # Get the current time and see if enough
+    # time has passed to play the sample.
+    now = time.monotonic()
+    if now > last_sample_played + interval:
+        last_sample_played = now
+        bhb.play(sample)
+        bhb.gate_out = True
+    else:
+        bhb.gate_out = False
+
+    # If the button is pressed (or gate in
+    # is triggered), the figure out the time
+    # between this press and the last press
+    # and use that as the tempo.
+    if bhb.triggered:
+        interval = now - last_button_press
+        last_button_press = now

factory/.gitignore

@@ -0,0 +1,3 @@
+calibrations/
+bootloader.bin
+firmware.uf2

factory/factory_setup.py

@@ -0,0 +1,117 @@
+import io
+import time
+import os
+import subprocess
+import utils
+import shutil
+import zipfile
+
+import requests
+
+
+JLINK_PATH = "C:\Program Files (x86)\SEGGER\JLink\JLink.exe"
+assert os.path.exists("bootloader.bin")
+assert os.path.exists("firmware.uf2")
+
+ROOT_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
+FIRMWARE_DIR = os.path.join(ROOT_DIR, "firmware")
+LIB_DIR = os.path.join(FIRMWARE_DIR, "lib")
+EXAMPLES_DIR = os.path.join(ROOT_DIR, "examples")
+
+FILES_TO_DEPLOY = {
+    "https://raw.githubusercontent.com/theacodes/Winterbloom_VoltageIO/master/winterbloom_voltageio.py": "lib",
+    os.path.join(FIRMWARE_DIR, "winterbloom_bhb"): "lib",
+    os.path.join(ROOT_DIR, "samples"): ".",
+    os.path.join(ROOT_DIR, "examples"): ".",
+    os.path.join(FIRMWARE_DIR, "LICENSE"): ".",
+    os.path.join(FIRMWARE_DIR, "README.HTM"): ".",
+    os.path.join(ROOT_DIR, "examples/default.py"): "code.py",
+}
+
+
+def program_bootloader():
+    print("========== PROGRAMMING BOOTLOADER ==========")
+    subprocess.check_call(
+        [JLINK_PATH, "-device", "ATSAMD21G18", "-autoconnect", "1", "-if", "SWD", "-speed", "4000", "-CommanderScript", "flash-bootloader.jlink"]
+    )
+
+
+def program_circuitpython():
+    print("========== PROGRAMMING CIRCUITPYTHON ==========")
+    input("Connect usb cable, press enter.")
+    bootloader_drive = utils.find_drive_by_name("HONKBOOT")
+    utils.copyfile("firmware.uf2", os.path.join(bootloader_drive, "NEW.uf2"))
+
+
+def deploy_circuitpython_code():
+    print("========== DEPLOYING CODE ==========")
+    # Wait for the circuitpython drive to show up.
+    time.sleep(5)
+    cpy_drive = utils.find_drive_by_name("CIRCUITPY")
+
+    utils.clean_pycache(FIRMWARE_DIR)
+    utils.clean_pycache(EXAMPLES_DIR)
+
+    os.makedirs(os.path.join(cpy_drive, "lib"), exist_ok=True)
+
+    for src, dst in FILES_TO_DEPLOY.items():
+        if src.startswith("https://"):
+            if '.zip' in src:
+                http_src, zip_path = src.rsplit(':', 1)
+
+                zip_data = io.BytesIO(requests.get(http_src).content)
+
+                with zipfile.ZipFile(zip_data, "r") as zipfh:
+                    file_data = zipfh.read(zip_path)
+                
+                dst = os.path.join(dst, os.path.basename(zip_path))
+                with open(os.path.join(cpy_drive, dst), "wb") as fh:
+                    fh.write(file_data)
+            
+            else:
+                file_data = requests.get(src).content
+                _, file_name = src.rsplit('/', 1)
+                dst = os.path.join(dst, file_name)
+                with open(os.path.join(cpy_drive, dst), "wb") as fh:
+                    fh.write(file_data)
+                
+        else:
+            if os.path.isdir(src):
+                dst = os.path.join(cpy_drive, dst, os.path.basename(src))
+                if os.path.exists(dst):
+                    shutil.rmtree(dst)
+                shutil.copytree(src, dst)
+            else:
+                shutil.copy(src, os.path.join(cpy_drive, dst))
+
+        print(f"Copied {src} to {dst}")
+    
+    utils.flush(cpy_drive)
+    
+
+def main():
+    try:
+        bootloader_drive = utils.find_drive_by_name("HONKBOOT")
+    except:
+        bootloader_drive = None
+    
+    try:
+        circuitpython_drive = utils.find_drive_by_name("CIRCUITPY")
+    except:
+        circuitpython_drive = None
+
+    if not circuitpython_drive and not bootloader_drive:
+        program_bootloader()
+    
+    if not circuitpython_drive:
+        program_circuitpython()
+
+    if circuitpython_drive and os.path.exists(os.path.join(circuitpython_drive, "code.py")):
+        if input("redeploy code? y/n: ").strip() == "y":
+            deploy_circuitpython_code()
+    else:
+        deploy_circuitpython_code()
+
+
+if __name__ == "__main__":
+    main()

factory/flash-bootloader.jlink

@@ -0,0 +1,5 @@
+r
+loadfile bootloader.bin
+r
+go
+exit