Big Honking Button User Guide#

Big Honking Button is, well, a big button that honks. Okay, that's not all- it’s actually a simple sampler in a very silly package. It has pitch CV, gate in, gate out, and you can store up to 4mb of samples on it.

Getting support and help#

We want you to have a wonderful experience with your module. If you need help or run into problems, please reach out to us. Email is the best way for product issues, whereas Discord and GitHub are great for getting advice and help on how to customize your module.

Installing the module#

To install this into your Eurorack setup:

  1. Connect a Eurorack power cable to your power supply and the back of the module. Note that even though the power connector on the module is keyed, double check that the red stripe is on the side labeled red stripe!
  2. Screw the module to your rack's rails.

Inputs and outputs#

images/honk-program-labels.png

Big Honking Button has two inputs:

And two outputs:

With the default code, it will trigger the sample and play it through the audio out whenever the button is pressed or whenever the gate input is triggered. It will also set the gate out to high whenever the button is pressed or whenever the gate in is high. You can customize some of this behavior by modifying the code.

Revision differences

Big Honking Buttons manufactured prior to 2021 (v4 and lower) only have an input range of -2v to +2v. More than that won't damage the module, but it won't be able to measure anything outside of that range.

Changing the sample#

You can change the sample on Big Honking Button by connecting it to your computer via a micro USB cable. The USB port is located on the module's main circuit board, located under the panel. Please note that you do have to power the module in order for the USB connection to work (the module itself can not be powered over USB alone).

Samples must be in mono, 16-bit, 44.1kHz, signed wav files. Adafruit has an excellent guide on how to convert sound files, though your sample can be 44.1kHz and not 22kHz.

To modify the sample that plays:

  1. Connect the Big Honking Button to your computer using a micro USB cable. It should show up as a small external drive named CIRCUITPY
  2. Navigate to the samples folder in the drive
  3. Rename or delete the existing honk.wav file
  4. Copy your sample over and rename it to honk.wav

Your Big Honking Button will reboot and then it should play the new sample! If you run into trouble, please reach out.

You can store and play multiple samples on the Big Honking Button, but to do that, you'll need to learn how to modify some of the code - don't worry! It's not too hard.

Modifying the code#

When connected to your computer, Big Honking Button shows up as a small drive named CIRCUITPY. In that drive, you should find a file named code.py. Big Honking Button runs CircuitPython which means that its firmware is written in the approachable Python programming language and you don't need any special knowledge or compilers to make changes to it. So, open up that file in your favorite text editor, we're going to make some changes!

If you don't have a text editor - that's okay! While you could use Notepad (Windows) or TextEdit (Mac), these can sometimes have issues with CircuitPython devices like Big Honking Button. I'd recommend installing Mu if you're new to this whole world. You can read more about editing code for CircuitPython in Adafruit's guide.

As a way to get your feet let's change how the Big Honking Button behaves. By default, when you press the button it plays the entire sample, even if you release the button while the sample is still playing (this is trigger mode). This will make it where the sample will stop as soon as you let go of the button (or gate mode).

In the code.py you should see some code that looks like this (it's at the bottom):

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()

Modify this code so that it looks like this:

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()

Be careful

Python is whitespace-sensitive. That means tabs and spaces are important! Make sure that you don't accidentally change the indentation level of this line.

Okay, save the file! Your Big Honking Button should restart and now it should stop the sample as soon as you let go of the button, try pressing it rapidly to see the effect.

Tip

If things aren't working, see the section below on finding problems or reach out!

Congrats, you've made your first change to how the module works! 🎉

Big Honking Button can store multiple samples and you can use various means to change how they're triggered. We'll be adding a sample showing just that soon, but don't be afraid to experiment and reach out if you need any help!

If you want to you can learn more about CircuitPython to the most of your module. Also, please come chat on the Discord where you can ask questions and see what others are doing with their Big Honking Button!

Examples#

Big Honking Button can do all sorts of things! We've made a few examples to get you started. If you want to use these, copy their contents to code.py on the CIRCUITPY drive. Be sure to save it as the correct name, if you don't name it code.py it won't change anything. If you want to restore the original code.py it is here.

  1. Cycle example: Shows how to load multiple samples and cycle between them.
  2. Random example: Shows how to load multiple samples and choose one at random.
  3. Tap tempo example: Shows how to use the button to set the tempo and have the module play back a sample at each beat.
  4. Sine example: An advanced example that shows how to generate a custom waveform.
  5. Noise example: An advanced example that shows how to generate noise.

Help! I changed some code and this thing isn't working!#

There's probably some sort of error in the program. Don't worry, you can get it figured out.

If you connect using the serial console you should be able to see the error. If you don't see it right away, you might need to reset the board (either by pressing the little button on the bottom of the module or power cycling your synth). Sometimes you can press Ctrl+C followed by Ctrl+D in the serial console to get the board to reset and tell you the error.

In any case, reach out on Discord and we can walk you through figuring out what went wrong.

Updating the firmware#

Updating the firmware requires two steps: Updating CircuitPython and updating Big Honking Button's libraries.

Updating CircuitPython

  1. Download the latest version of CircuitPython for Winterbloom Big Honking Button.
  2. Connect Big Honking Button to your computer via USB. The USB port is located underneath the panel. Note that you still have to power the module from a Eurorack power supply.
  3. Place Big Honking Button in bootloader mode by pressing the reset button twice quickly. The reset button is located on the bottom of the module just below the power connector. Once in bootloader mode, you should see a drive on your computer named HONKBOOT.
  4. Copy the uf2 file from step 1 to the HONKBOOT drive. The module should restart by itself.

Updating Big Honking Button's libraries

  1. Download the latest release bundle for Big Honking Button.
  2. Unzip the release bundle, and then copy the contents to Big Honking Button's CIRCUITPY drive, replacing any existing files.
  3. Reboot Big Honking Button by power cycling your synthesizer or pressing the reset button again.

Open source hardware & software#

Big Honking Button is completely open source and hacking is encouraged.

Open Source Hardware Association mark Big Honking Button is certified open source hardware.

Warranty, disclaimers, and limits#

Modules purchased from Winterbloom have a warranty of six months from the date of purchase. This warranty covers any manufacturing defects in the module. It does not cover damage from due to incorrect handling, storage, or power, overvoltage events, or modifications.

Please contact us if you are experiencing issues with your module. Modules returned under warranty will either be refunded, replaced, or repaired at our discretion. You will be responsible for the cost of returning the module to Winterbloom.

Because Eurorack has a vast number of possible combinations of power supplies, modules, cases, and accessories, it is impossible for us to guarantee compatibility with every possible configuration. We make a reasonable effort to test modules with several power supplies, cases, and other modules.

We encourage tinkering, however, we will not refund, repair, or replace any products that have been modified.

Acknowledgments and thanks#

Big Honking Button would not be possible without the help of the CircuitPython community and Adafruit Industries.