Compare commits

...
1 Commits
Author SHA1 Message Date
mindfulminun b000b06305 build on push, add flashing instructions
Build firmware / build (push) Waiting to run
:)
2026-11-20 00:11:53 +00:00
2 changed files with 31 additions and 1 deletions

No files matched your search

+2 -1
View File
@@ -51,7 +51,8 @@ jobs:
ID=$(curl -sSf -X POST -H "$AUTH" -H "Content-Type: application/json" "$API/releases" \
-d "$(jq -n --arg sha "${{ gitea.sha }}" \
'{tag_name:"latest", target_commitish:$sha, name:"Latest firmware", body:("Built from " + $sha)}')" \
--arg url "${{ gitea.server_url }}/${{ gitea.repository }}/src/branch/main/INSTALL.md" \
'{tag_name:"latest", target_commitish:$sha, name:"Latest firmware", body:("Built from " + $sha + "\n\nHow to flash it: " + $url)}')" \
| jq -r .id)
curl -sSf -H "$AUTH" -F "attachment=@$RUNNER_TEMP/firmware.bin" \
+29
View File
@@ -0,0 +1,29 @@
# 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.