30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# how to install (qmk not needed!)
|
|
|
|
1. Download `preonic_rev3_mindfulminun.bin` from the
|
|
[latest release](https://gitea.benjic.xyz/mindfulminun/qmk/releases/tag/latest).
|
|
2. Put the keyboard in bootloader mode.
|
|
3. Flash it with one of the options below.
|
|
|
|
## Option A (ez): QMK Toolbox (graphical)
|
|
|
|
Get it from the [QMK Toolbox releases](https://github.com/qmk/qmk_toolbox/releases)
|
|
(Windows and macOS; check the latest release for Linux support). Open the `.bin`
|
|
file, tick "Auto-Flash" or click Flash, and the Toolbox installs any drivers it needs.
|
|
|
|
## Option B (leet): dfu-util (cli, all systems)
|
|
|
|
Install it:
|
|
|
|
- **macOS:** `brew install dfu-util`
|
|
- **Linux:** install the `dfu-util` package from your distro
|
|
(e.g. `sudo apt install dfu-util` or `sudo pacman -S dfu-util`)
|
|
- **Windows:** download it from <https://dfu-util.sourceforge.net/releases/>
|
|
and unzip it. If the keyboard isn't detected, install the WinUSB driver for the
|
|
"STM32 BOOTLOADER" device with [Zadig](https://zadig.akeo.ie/).
|
|
|
|
```
|
|
dfu-util -a 0 -d 0483:df11 -s 0x08000000:leave -D preonic_rev3_mindfulminun.bin
|
|
```
|
|
|
|
The keyboard restarts on its own when the flash finishes.
|