So you bought a steno keyboard from StenoKeyboards?
This is a place for the default firmware that comes with your steno keyboard, or firmware for your diy kit.
If you want to build from the source code, go to the official qmk_firmware repository.
Don't move forward if your keyboard already works and you don't know what you're doing!
| Keyboard | Folder | Firmware Available | MCU |
|---|---|---|---|
| Uni v1 and v2 | the_uni_v2 | Default, Qwerty | atmega32u4 |
| Uni v3 | the_uni_v3 | Default, Qwerty, Utility | atmega32u4 |
| Uni v4 | the_uni_v4 | Default, Qwerty, Utility | rp2040 |
| Polyglot v1 | polyglot_v1 | Default, Everything, Switched | rp2040 |
| Asterisk v1 | asterisk_v1 | Default | rp2040 |
-
Download your firmware
- Navigate your way to the firmware you want, click on it, then click "Download."
-
Unplug the keyboard
-
On the back of the keyboard, press and hold the 'B' (boot) button and while you plug the keyboard in.
-
This will make the computer recognize the keyboard as a storage device and in your file explorer, you will be able to see it.
-
Copy paste the .uf2 file into the keyboard. Paste it into the root folder.*
-
That's it, very easy.
*If you are on a Ventura Macbook, you might get an error when pasting it in. In that case see the instructions here.
-
Download your firmware
- Clone the repo by clicking "Code" -> "Download ZIP".
- Or
git clone https://github.com/petercpark/stenokeyboards-firmware.git
-
Download QMK Toolbox and open it up. It should prompt you to download dependencies when you first open it up. It won't work unless you download the dependencies.
-
Select the .hex file you want to use by clicking "open". Make sure that the MCU matches what is shown on the chart above (i.e. atmega32u4)
- If you are flashing your keyboard because it didn't work with Plover, try flashing it with the Qwerty .hex file as a test to make sure that the board itself is in working condition.
- The purpose of doing this is to make sure that the keyboard is working properly without having to worry about configuring around with Plover.
-
Click "auto flash" and hit the reset button wherever that may be (probably on the back somewhere), or you can short GND and RST on the pro micro.
-
Open Plover and connect machine to see it work. See the docs for information on setting up your steno keyboard with Plover.
- If you flashed the Qwerty firmware: make sure that the keyboard outputs letters like a normal keyboard would. If it works, you can change Plover's machine settings to "keyboard" instead of GeminiPR and you can just steno like that. However, this is not recommended.
- It is recommended that you flash it again with the default GeminiPR firmware and go through configuration again. With GeminiPR, you can use steno and use a normal keyboard at the same time.