Skip to content

Commit 97f7345

Browse files
committed
docs: Update URLs to the project repository, since it moved
1 parent 7972421 commit 97f7345

2 files changed

Lines changed: 43 additions & 54 deletions

File tree

user_guide/docs/index.md

Lines changed: 23 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,9 @@ Big Honking Button is, well, a big button that honks. Okay, that's not all- it
66

77
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.
88

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]
1312

1413
## Installing the module
1514

@@ -18,27 +17,24 @@ To install this into your Eurorack setup:
1817
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`!**
1918
1. Screw the module to your rack's rails.
2019

21-
2220
## Inputs and outputs
2321

2422
![images/honk-program-labels.png](images/honk-program-labels.png)
2523

2624
Big Honking Button has two inputs:
2725

28-
- A gate / trigger in
29-
- 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>
3028

3129
And two outputs:
3230

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
3633

3734
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).
3835

3936
!!! 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.
4238

4339
## Changing the sample
4440

@@ -57,14 +53,13 @@ Your Big Honking Button will reboot and then it should play the new sample! If y
5753

5854
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.
5955

60-
6156
## Modifying the code
6257

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!
6459

6560
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).
6661

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).
6863

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

@@ -87,30 +82,28 @@ if bhb.released:
8782
```
8883

8984
!!! 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.
9186

9287
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.
9388

9489
!!! note "Tip"
9590
If things aren't working, see the section below on finding problems or [reach out](#getting-support-and-help)!
9691

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! 🎉
9893

9994
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!
10095

10196
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!
10297

103-
10498
## Examples
10599

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).
113101

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.
114107

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

@@ -133,11 +126,10 @@ Updating the firmware requires two steps: Updating CircuitPython and updating Bi
133126

134127
### Updating Big Honking Button's libraries
135128

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).
137130
2. Unzip the release bundle, and then copy the contents to Big Honking Button's `CIRCUITPY` drive, replacing any existing files.
138131
3. Reboot Big Honking Button by power cycling your synthesizer or pressing the reset button again.
139132

140-
141133
<!-- ## Frequently asked questions
142134
143135
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
146138

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

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).
152144

153145
![Open Source Hardware Association mark](images/oshw.svg){class=oshw} Big Honking Button is [certified open source hardware](https://certification.oshwa.org/us000678.html).
154146

155-
156147
## Warranty, disclaimers, and limits
157148

158149
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
163154

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

166-
167157
## Acknowledgments and thanks
168158

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

171-
172-
[CircuitPython]: https://circuitpython.org
161+
[circuitpython]: https://circuitpython.org
173162
[discord]: https://discord.gg/UpfqghQ

user_guide/mkdocs.yml

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
11
site_name: Winterbloom Big Honking Button User Guide
2+
site_url: https://honk.wntr.dev
23
copyright: "© 2020 Winterbloom, licensed under Creative Commons CC BY-SA 4.0"
3-
repo_url: "https://github.com/theacodes/Winterbloom-Big-Honking-Button"
4+
repo_url: "https://github.com/wntrblm/Big_Honking_Button"
45
edit_uri: edit/main/user_guide/docs
56
theme:
6-
name: winterbloom
7+
name: winterbloom
78
markdown_extensions:
8-
- admonition
9-
- def_list
10-
- attr_list
11-
- toc:
12-
permalink: "#"
13-
toc_depth: 2
14-
- pymdownx.highlight:
15-
use_pygments: True
16-
- pymdownx.superfences
17-
- pymdownx.magiclink
18-
- md_in_html
19-
- markdown_link_attr_modifier:
20-
external_only: True
21-
custom_attrs:
22-
rel: "noopener"
23-
referrerpolicy: "origin"
9+
- admonition
10+
- def_list
11+
- attr_list
12+
- toc:
13+
permalink: "#"
14+
toc_depth: 2-3
15+
- pymdownx.highlight:
16+
use_pygments: True
17+
- pymdownx.superfences
18+
- pymdownx.magiclink
19+
- md_in_html
20+
- markdown_link_attr_modifier:
21+
new_tab: "external_only"
22+
custom_attrs:
23+
referrerpolicy: "origin"
2424
nav:
25-
- "User Guide": index.md
26-
- "Kit Build Instructions": build.md
25+
- "User Guide": index.md
26+
- "Kit Build Instructions": build.md

0 commit comments

Comments
 (0)