How to Flash Firmware

9 min

(日本語版は後ろにあります)

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.

NOTE

Currently, 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

  1. 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
  1. Flash the appropriate firmware to each device
  • Flash the central .uf2 to the left device
  • Flash the peripheral .uf2 to the right device
  1. 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.

TIP

If your Peaky 8-bit is already paired and you are re-flashing the firmware, we recommend removing the pairing first.

IMPORTANT

Make sure the battery power switch is OFF before you begin.

  1. Connect the left device (the central) to your PC via USB.

  2. 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.).
  1. Drag and drop (or copy) the following reset file onto the “XIAO-BOOT” drive:
  • File to copy: settings_reset-seeeduino_xiao_ble-zmk.uf2

  • After 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.

The error message window that appears (close it with the Cancel button)
The error message window that appears (close it with the Cancel button)
"SETTINGS RESET" is displayed
"SETTINGS RESET" is displayed
  1. Repeat steps 1, 2 and 3 above for the right/peripheral device.

  2. Connect the left/central device via USB again, and quickly press the XIAO BLE’s RESET button twice.

  3. Drag and drop (or copy) the following left/central file onto the drive that appears:

  • File to copy: peaky8bit_left-seeeduino_xiao_ble-zmk.uf2

  • After 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.
  1. Next, connect the right/peripheral device via USB, and quickly press the XIAO BLE’s RESET button twice.

  2. Drag and drop (or copy) the following right/peripheral file onto the drive that appears:

  • File to copy: peaky8bit_right-seeeduino_xiao_ble-zmk.uf2

  • After 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!

  1. Turn ON the power of the central (left) device.

  2. Turn ON the power of the peripheral (right) device.

NOTE

The central must be recognized over Bluetooth first, so turn it on before the peripheral.

  1. Connect via Bluetooth.

If everything went well, your P8 should now be recognized!

  1. 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のものではダメです。

ざっくりとした手順(流れ)の提示

  1. 左右デバイス内の既存のファームウェアをリセットする
  • 左デバイスにリセット用のuf2を導入
  • 右デバイスにリセット用のuf2を導入
  1. 左右デバイスに該当するファームウェアを格納・導入する
  • 左デバイスに親機用のuf2を導入
  • 右デバイスに子機用のuf2を導入
  1. Bluetooth接続

具体的な手順

P8のケースは現在、水などが入らないようにUSB差込口は空いていない形状になっています。 ネジを外し、基板をケースから取り出して作業します。

TIP

すでにPeaky 8-bitをペアリング済みの状態で、再度ファームウェア書き込みをする際には、一度ペアリングを解除することを推奨します。

IMPORTANT

電池の電源がOFFになっているのを確認してから作業を開始してください。

  1. 「左」デバイス(親機となる方)をUSBで有線します。

  2. Xiao BLEのRESETボタンを、つまようじ等の先端で「2回」、素早く押します

  • 「カチカチっ」ぐらいの速度感で押します。
  • すると、Xiao BLEの赤いLEDが点灯します。
  • また、Xiao BLEがPCに「XIAO-BOOT」として、ドライブとして認識されます
    • 微妙に名称が異なることがあります(Xiao BLEのバージョンなどのせいの様子)
  1. 認識された「XIAO-BOOT」に、下記のReset用ファイルをDrag&Dropなどで格納します
  • 格納するuf2ファイル:settings_reset-seeeduino_xiao_ble-zmk.uf2

  • すると、

    • エラーメッセージのウィンドウが起動します:Cancelで閉じる
    • PC側のBluetoothで「SETTINGS RESET」として認識されます
      • 「SETTINGS RESET」の表示に1分ほど時間がかかることがあります
      • まれにこの「SETTINGS RESET」が表示されないことがありますが、あまりに長く表示されなかったら、次の工程に進んでみてください(表示されなくても問題ないケースを確認しています)
  • 一度、この左/親機用デバイスをUSBから外します

表示されるエラーメッセージのウィンドウ(Cancelボタンを押して閉じる)
表示されるエラーメッセージのウィンドウ(Cancelボタンを押して閉じる)
「SETTINGS RESET」と表示されます
「SETTINGS RESET」と表示されます
  1. 上述「1」「2」と「3」の作業を、「右/子機」デバイスでも行います。

  2. 再度「左/親機」をUSB接続し、Xiao BLEのResetボタンを2回素早く押します

  3. 認識されたドライブに、下記の「左/親機用ファイル」をDrag&Dropなどで格納します

  • 格納するuf2ファイル:peaky8bit_left-seeeduino_xiao_ble-zmk.uf2

  • すると、

    • エラーメッセージのウィンドウが起動します:Cancelで閉じる
    • PC側のBluetoothで「peaky8bit」として認識されます
    • この左/親機用デバイスをUSBから外します
  1. 続いて「右/子機」をUSB接続し、Xiao BLEのResetボタンを2回素早く押します

  2. 認識されたドライブに、下記の「右/子機用ファイル」をDrag&Dropなどで格納します

  • 格納するuf2ファイル:peaky8bit_right-seeeduino_xiao_ble-zmk.uf2

  • すると、

    • エラーメッセージのウィンドウが起動します:Cancelで閉じる
    • PC側のBluetoothで「HID keyboard device」として認識されます
    • この右/子機用デバイスをUSBから外します

あと少しです!

  1. 親機(左)の電源をONにします

  2. 子機(右)の電源をONにします

NOTE

親機を先にBluetooth認識させる必要があるので、親機を先にONします。

  1. Bluetooth接続します

問題がなければこれで認識されるはずです!

  1. ケースを閉じます
  • ケースのネジ穴には「向き」があります。
    • ケース側面にあるストラップホールが、「電池側」になるよう基板を格納してください。

参考:古い記事 https://toyamimura.substack.com/i/206968142/step-2-install-the-uf2-firmware


👍/ Like