You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: user_guide/docs/index.md
+23-34Lines changed: 23 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,10 +6,9 @@ Big Honking Button is, well, a big button that honks. Okay, that's not all- it
6
6
7
7
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.
8
8
9
-
* Send us [an email](mailto:support@winterbloom.com).
10
-
* File a bug [on GitHub](https://github.com/theacodes/Winterbloom-Big-Honking-Button)
11
-
* Reach out on the [Discord][discord]
12
-
9
+
- Send us [an email](mailto:support@winterbloom.com).
10
+
- File a bug [on GitHub](https://github.com/wntrblm/Big_Honking_Button/issues)
11
+
- Reach out on the [Discord][discord]
13
12
14
13
## Installing the module
15
14
@@ -18,27 +17,24 @@ To install this into your Eurorack setup:
18
17
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`!**
- A pitch CV in that is 1v/Oct with a -5v to +5v range<sup>see note</sup>
26
+
-A gate / trigger in
27
+
-A pitch CV in that is 1v/Oct with a -5v to +5v range<sup>see note</sup>
30
28
31
29
And two outputs:
32
30
33
-
- A gate / trigger out (0v or 5v)
34
-
- An audio out
35
-
31
+
- A gate / trigger out (0v or 5v)
32
+
- An audio out
36
33
37
34
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](#modifying-the-code).
38
35
39
36
!!! note "Revision differences"
40
-
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.
41
-
37
+
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.
42
38
43
39
## Changing the sample
44
40
@@ -57,14 +53,13 @@ Your Big Honking Button will reboot and then it should play the new sample! If y
57
53
58
54
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.
59
55
60
-
61
56
## Modifying the code
62
57
63
-
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][CircuitPython] which means that its firmware is written in the approachable [Python](https://python.org) 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!
58
+
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][circuitpython] which means that its firmware is written in the approachable [Python](https://python.org) 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!
64
59
65
60
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](https://learn.adafruit.com/welcome-to-circuitpython/installing-mu-editor) if you're new to this whole world. You can read more about editing code for CircuitPython in [Adafruit's guide](https://learn.adafruit.com/welcome-to-circuitpython/creating-and-editing-code).
66
61
67
-
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).
62
+
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).
68
63
69
64
In the `code.py` you should see some code that looks like this (it's at the bottom):
70
65
@@ -87,30 +82,28 @@ if bhb.released:
87
82
```
88
83
89
84
!!! warning "Be careful"
90
-
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.
85
+
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.
91
86
92
87
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.
93
88
94
89
!!! note "Tip"
95
90
If things aren't working, see the section below on finding problems or [reach out](#getting-support-and-help)!
96
91
97
-
**Congrats**, you've made your first change to how the module works! 🎉
92
+
**Congrats**, you've made your first change to how the module works! 🎉
98
93
99
94
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!
100
95
101
96
If you want to you can learn more about [CircuitPython](https://learn.adafruit.com/welcome-to-circuitpython/overview) to the most of your module. Also, please come chat on the [Discord][discord] where you can ask questions and see what others are doing with their Big Honking Button!
102
97
103
-
104
98
## Examples
105
99
106
-
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](https://github.com/theacodes/Winterbloom-Big-Honking-Button/blob/master/examples/default.py).
107
-
108
-
1.[Cycle example](https://github.com/theacodes/Winterbloom-Big-Honking-Button/blob/master/examples/cycle.py): Shows how to load multiple samples and cycle between them.
109
-
1.[Random example](https://github.com/theacodes/Winterbloom-Big-Honking-Button/blob/master/examples/random.py): Shows how to load multiple samples and choose one at random.
110
-
1.[Tap tempo example](https://github.com/theacodes/Winterbloom-Big-Honking-Button/blob/master/examples/tap_tempo.py): Shows how to use the button to set the tempo and have the module play back a sample at each beat.
111
-
1.[Sine example](https://github.com/theacodes/Winterbloom-Big-Honking-Button/blob/master/examples/sine.py): An advanced example that shows how to generate a custom waveform.
112
-
1.[Noise example](https://github.com/theacodes/Winterbloom-Big-Honking-Button/blob/master/examples/noise.py): An advanced example that shows how to generate noise.
100
+
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](https://github.com/wntrblm/Big_Honking_Button/blob/main/examples/default.py).
113
101
102
+
1.[Cycle example](https://github.com/wntrblm/Big_Honking_Button/blob/main/examples/cycle.py): Shows how to load multiple samples and cycle between them.
103
+
1.[Random example](https://github.com/wntrblm/Big_Honking_Button/blob/main/examples/random.py): Shows how to load multiple samples and choose one at random.
104
+
1.[Tap tempo example](https://github.com/wntrblm/Big_Honking_Button/blob/main/examples/tap_tempo.py): Shows how to use the button to set the tempo and have the module play back a sample at each beat.
105
+
1.[Sine example](https://github.com/wntrblm/Big_Honking_Button/blob/main/examples/sine.py): An advanced example that shows how to generate a custom waveform.
106
+
1.[Noise example](https://github.com/wntrblm/Big_Honking_Button/blob/main/examples/noise.py): An advanced example that shows how to generate noise.
114
107
115
108
## Help! I changed some code and this thing isn't working!
116
109
@@ -133,11 +126,10 @@ Updating the firmware requires two steps: Updating CircuitPython and updating Bi
133
126
134
127
### Updating Big Honking Button's libraries
135
128
136
-
1.[Download the latest release bundle for Big Honking Button](https://github.com/theacodes/Winterbloom-Big-Honking-Button/releases).
129
+
1.[Download the latest release bundle for Big Honking Button](https://github.com/wntrblm/Big_Honking_Button/releases).
137
130
2. Unzip the release bundle, and then copy the contents to Big Honking Button's `CIRCUITPY` drive, replacing any existing files.
138
131
3. Reboot Big Honking Button by power cycling your synthesizer or pressing the reset button again.
139
132
140
-
141
133
<!-- ## Frequently asked questions
142
134
143
135
Got a question not answered here? [Reach out](#getting-support-and-help), we'll be happy to help! -->
@@ -146,13 +138,12 @@ Got a question not answered here? [Reach out](#getting-support-and-help), we'll
146
138
147
139
Big Honking Button is completely open source and hacking is encouraged.
148
140
149
-
*The [firmware](https://github.com/theacodes/Winterbloom-Big-Honking-Button/tree/master/firmware) is available under the [MIT License](https://github.com/theacodes/Winterbloom-Big-Honking-Button/blob/master/firmware/LICENSE).
150
-
*The [hardware design](https://github.com/theacodes/Winterbloom-Big-Honking-Button/tree/master/hardware) is available under the [CC BY-SA 4.0 License](https://github.com/theacodes/Winterbloom-Big-Honking-Button/blob/master/hardware/LICENSE) and is designed using [KiCAD](https://kicad.org/) which is free and open-source. You can open the hardware files using KiCAD or you can check out a [PDF of the schematic](https://github.com/theacodes/Winterbloom-Big-Honking-Button/raw/master/hardware/board/board.pdf).
151
-
*[CircuitPython][CircuitPython] is available under the [MIT License](https://github.com/adafruit/circuitpython/blob/main/LICENSE).
141
+
-The [firmware](https://github.com/wntrblm/Big_Honking_Button/tree/main/firmware) is available under the [MIT License](https://github.com/wntrblm/Big_Honking_Button/blob/main/firmware/LICENSE).
142
+
-The [hardware design](https://github.com/wntrblm/Big_Honking_Button/tree/main/hardware) is available under the [CC BY-SA 4.0 License](https://github.com/wntrblm/Big_Honking_Button/blob/main/hardware/LICENSE) and is designed using [KiCAD](https://kicad.org/) which is free and open-source. You can open the hardware files using KiCAD or you can check out a [PDF of the schematic](https://github.com/wntrblm/Big_Honking_Button/raw/main/hardware/board/board.pdf).
143
+
-[CircuitPython][circuitpython] is available under the [MIT License](https://github.com/adafruit/circuitpython/blob/main/LICENSE).
152
144
153
145
{class=oshw} Big Honking Button is [certified open source hardware](https://certification.oshwa.org/us000678.html).
154
146
155
-
156
147
## Warranty, disclaimers, and limits
157
148
158
149
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.
@@ -163,11 +154,9 @@ Because Eurorack has a vast number of possible combinations of power supplies, m
163
154
164
155
We encourage tinkering, however, we will not refund, repair, or replace any products that have been modified.
165
156
166
-
167
157
## Acknowledgments and thanks
168
158
169
159
Big Honking Button would not be possible without the help of the CircuitPython community and Adafruit Industries.
0 commit comments