How to Flash Firmware
(日本語版は後ろにあります)
In a previous article, I explained how to use the Peaky 8-bit GitHub repository and how to generate the firmware. This article picks up where that one left off. https://journal.peaky8bit.fyi/posts/2026-0920-p8-howtouse-repository/
- That article also covers how to customize the firmware.
Get the Firmware (.uf2 Files)
Follow the article above to get the firmware zip file.
Alternatively, the stable version from the latest repository is available on the GitHub Releases page: https://github.com/toya-mimura/zmk-config-peaky8bit/releases
Whichever method you choose, you will need the following three files:
- settings_reset-seeeduino_xiao_ble-zmk.uf2: for resetting
- peaky8bit_left-seeeduino_xiao_ble-zmk.uf2: for the left hand (central)
- peaky8bit_right-seeeduino_xiao_ble-zmk.uf2: for the right hand (peripheral)
If they come in a zip file, extract them first.
NOTECurrently, the left half is the central and the right half is the peripheral, but this is just for convenience. If you want to swap them, there are several ways to do it, such as rewriting the entire keymap (CSV).
What You’ll Need Besides the P8
A toothpick: used to press the reset button on the MCU (XIAO BLE).
- Instead of a toothpick, you can also use the tip of a mechanical pencil, an unfolded paper clip, etc.
A USB Type-C cable: make sure it supports data transfer.
- Charge-only cables will not work.
Overview of the Process
- Reset the existing firmware on both the left and right devices
- Flash the reset .uf2 to the left device
- Flash the reset .uf2 to the right device
- Flash the appropriate firmware to each device
- Flash the central .uf2 to the left device
- Flash the peripheral .uf2 to the right device
- Connect via Bluetooth
Step-by-Step Instructions
The P8 case currently has no opening for the USB port, to keep water and other things out. Remove the screws and take the PCB out of the case before you begin.
TIPIf your Peaky 8-bit is already paired and you are re-flashing the firmware, we recommend removing the pairing first.
IMPORTANTMake sure the battery power switch is OFF before you begin.
Connect the left device (the central) to your PC via USB.
Quickly press the RESET button on the XIAO BLE twice with the tip of a toothpick or similar.
- Aim for a quick “click-click” rhythm.
- The red LED on the XIAO BLE will light up.
- The XIAO BLE will also appear on your PC as a drive named “XIAO-BOOT”.
- The name may differ slightly (apparently depending on the XIAO BLE version, etc.).
- Drag and drop (or copy) the following reset file onto the “XIAO-BOOT” drive:
File to copy:
settings_reset-seeeduino_xiao_ble-zmk.uf2After that:
- An error message window will appear: close it with Cancel.
- Your PC’s Bluetooth will detect a device named “
SETTINGS RESET”.- It may take about a minute for “SETTINGS RESET” to appear.
- Occasionally “SETTINGS RESET” doesn’t show up at all. If it hasn’t appeared after a long wait, try moving on to the next step (I’ve confirmed cases where this causes no problems).
Disconnect this left/central device from USB.


Repeat steps 1, 2 and 3 above for the right/peripheral device.
Connect the left/central device via USB again, and quickly press the XIAO BLE’s RESET button twice.
Drag and drop (or copy) the following left/central file onto the drive that appears:
File to copy:
peaky8bit_left-seeeduino_xiao_ble-zmk.uf2After that:
- An error message window will appear: close it with Cancel.
- Your PC’s Bluetooth will detect a device named “
peaky8bit”. - Disconnect this left/central device from USB.
Next, connect the right/peripheral device via USB, and quickly press the XIAO BLE’s RESET button twice.
Drag and drop (or copy) the following right/peripheral file onto the drive that appears:
File to copy:
peaky8bit_right-seeeduino_xiao_ble-zmk.uf2After that:
- An error message window will appear: close it with Cancel.
- Your PC’s Bluetooth will detect a device named “
HID keyboard device”. - Disconnect this right/peripheral device from USB.
Almost there!
Turn ON the power of the central (left) device.
Turn ON the power of the peripheral (right) device.
NOTEThe central must be recognized over Bluetooth first, so turn it on before the peripheral.
- Connect via Bluetooth.
If everything went well, your P8 should now be recognized!
- Close the case.
- The screw holes on the case have a specific orientation.
- Place the PCB so that the strap hole on the side of the case is on the battery side.
Reference: older article https://toyamimura.substack.com/i/206968142/step-2-install-the-uf2-firmware
日本語版
こちらの記事ではPeaky 8-bitのGitHubリポジトリの使い方について解説し、Firmwareの生成方法を説明しました。 今回はその続きです。 https://journal.peaky8bit.fyi/posts/2026-0920-p8-howtouse-repository/
- この記事でファームウェアのカスタマイズの方法などを解説しています。
ファームウェア(.uf2ファイル)を入手
上述の記事に沿って、ファームウェアのzipを入手します。
あるいは、最新版のリポジトリの、安定版はGitHubリポジトリのReleaseより入手可能です。 https://github.com/toya-mimura/zmk-config-peaky8bit/releases
いずれの入手方法でも、必要となるのは以下の3ファイルです。
- settings_reset-seeeduino_xiao_ble-zmk.uf2:リセット用
- peaky8bit_left-seeeduino_xiao_ble-zmk.uf2:左手(親機)用
- peaky8bit_right-seeeduino_xiao_ble-zmk.uf2:右手(子機)用
Zipになっている場合はこれらを解凍します。
NOTE現状「左手=親機」「右手=子機」となっていますが、これは便宜上のものです。 左右変更したい場合は「キーマップ(csv)ごと書き換える」などやり方はいろいろあると思います。
P8以外で用意するもの
つまようじ:MCU(Xiao BLE)のリセットボタンを押すのに利用します。
- 爪楊枝ではなくても、シャーペンの先端や、クリップの先端などでも代用可能です。
USB Type-C:「データ通信」対応用のものを用意してください。
- 充電Onlyのものではダメです。
ざっくりとした手順(流れ)の提示
- 左右デバイス内の既存のファームウェアをリセットする
- 左デバイスにリセット用のuf2を導入
- 右デバイスにリセット用のuf2を導入
- 左右デバイスに該当するファームウェアを格納・導入する
- 左デバイスに親機用のuf2を導入
- 右デバイスに子機用のuf2を導入
- Bluetooth接続
具体的な手順
P8のケースは現在、水などが入らないようにUSB差込口は空いていない形状になっています。 ネジを外し、基板をケースから取り出して作業します。
TIPすでにPeaky 8-bitをペアリング済みの状態で、再度ファームウェア書き込みをする際には、一度ペアリングを解除することを推奨します。
IMPORTANT電池の電源がOFFになっているのを確認してから作業を開始してください。
「左」デバイス(親機となる方)をUSBで有線します。
Xiao BLEのRESETボタンを、つまようじ等の先端で「2回」、素早く押します
- 「カチカチっ」ぐらいの速度感で押します。
- すると、Xiao BLEの赤いLEDが点灯します。
- また、Xiao BLEがPCに「XIAO-BOOT」として、ドライブとして認識されます
- 微妙に名称が異なることがあります(Xiao BLEのバージョンなどのせいの様子)
- 認識された「XIAO-BOOT」に、下記のReset用ファイルをDrag&Dropなどで格納します
格納するuf2ファイル:
settings_reset-seeeduino_xiao_ble-zmk.uf2すると、
- エラーメッセージのウィンドウが起動します:Cancelで閉じる
- PC側のBluetoothで「
SETTINGS RESET」として認識されます- 「SETTINGS RESET」の表示に1分ほど時間がかかることがあります
- まれにこの「SETTINGS RESET」が表示されないことがありますが、あまりに長く表示されなかったら、次の工程に進んでみてください(表示されなくても問題ないケースを確認しています)
一度、この左/親機用デバイスをUSBから外します


上述「1」「2」と「3」の作業を、「右/子機」デバイスでも行います。
再度「左/親機」をUSB接続し、Xiao BLEのResetボタンを2回素早く押します
認識されたドライブに、下記の「左/親機用ファイル」をDrag&Dropなどで格納します
格納するuf2ファイル:
peaky8bit_left-seeeduino_xiao_ble-zmk.uf2すると、
- エラーメッセージのウィンドウが起動します:Cancelで閉じる
- PC側のBluetoothで「
peaky8bit」として認識されます - この左/親機用デバイスをUSBから外します
続いて「右/子機」をUSB接続し、Xiao BLEのResetボタンを2回素早く押します
認識されたドライブに、下記の「右/子機用ファイル」をDrag&Dropなどで格納します
格納するuf2ファイル:
peaky8bit_right-seeeduino_xiao_ble-zmk.uf2すると、
- エラーメッセージのウィンドウが起動します:Cancelで閉じる
- PC側のBluetoothで「
HID keyboard device」として認識されます - この右/子機用デバイスをUSBから外します
あと少しです!
親機(左)の電源をONにします
子機(右)の電源をONにします
NOTE親機を先にBluetooth認識させる必要があるので、親機を先にONします。
- Bluetooth接続します
問題がなければこれで認識されるはずです!
- ケースを閉じます
- ケースのネジ穴には「向き」があります。
- ケース側面にあるストラップホールが、「電池側」になるよう基板を格納してください。
参考:古い記事 https://toyamimura.substack.com/i/206968142/step-2-install-the-uf2-firmware