Seeed Studio XIAO MG24 Sense を使った、パッドを叩いてコピー&ペーストする Bluetooth LE キーボードです。
本体を 1 回叩くと Ctrl+C、2 回叩くと Ctrl+V を PC に送ります。

ソースコードと開発記録は GitHub で公開しています: https://github.com/whiskerpad/xiao_mg24_sense_Copypasta

作った動機
そこそこ大きな施設を管理しているビルメンさんは(私の大嫌いな)エクセルで延々コピペします。キータッチの苦手な私は小指の度重なる使用と視線の移動で心身ともにつらい思いをします。とりあえずたたいてコピペしようという事で作成。
機能
| 操作 | 送るキー | 本体 LED |
|---|---|---|
| シングルタップ | Ctrl+C | 1 回点滅 |
| ダブルタップ | Ctrl+V | 2 回点滅 |
| 左ひねり(机の上で反時計回り) | Ctrl+Z(無効。下記参照) | 3 回点滅 |
- 内蔵 IMU(LSM6DS3TR-C)の加速度でタップを検出します。
- 本体を持ち上げたり回したりしたときの衝撃は、ジャイロで判定してタップとして送りません。
- 電源は USB 給電です。電池駆動は消費電流の見積もりから見送りました。
ひねり(アンドゥ)を無効にした理由
当初は、机の上で本体を左にひねると Ctrl+Z、右にひねると Ctrl+Y を送る予定でした。
しかし底面に使える φ5 程度のゴム足が入手できず、代わりに 40 mm 角の耐震粘着ジェルを底面に埋め込んで滑り止めにしました。
ジェルで本体が机に固定されるため、ひねる操作ができなくなり、アンドゥ/リドゥは見送りました。
使用者と相談してアンドゥ/カットをリミットスイッチかタクトスイッチで載せても良いかなと考えています。
ひねり検出のコードは残してあり、#define ENABLE_TWIST_UNDO 1 にすると左ひねりで Ctrl+Z を送ります(右ひねりは送りません)。
必要なもの
- Seeed Studio XIAO MG24 Sense(IMU 付き。無印の XIAO MG24 には IMU がありません)
- USB-C ケーブル(書き込み・ログ取得にはデータ通信対応のもの)
- Bluetooth LE 対応の Windows PC(動作確認は Windows 11 のメモ帳)
XIAO ESP32-C3 との違い
同じ XIAO シリーズの ESP32-C3 でも BLE キーボードは作れますが、このプロジェクトでは MG24 Sense を選びました。
| 項目 | XIAO ESP32-C3 | XIAO MG24 Sense |
|---|---|---|
| MCU | ESP32-C3(RISC-V, 最大 160 MHz) | EFR32MG24(Arm Cortex-M33, 最大 78 MHz) |
| SRAM | 400 KB | 256 KB |
| Flash | 4 MB | 1536 KB + 外付け 4 MB |
| 無線 | Wi-Fi + Bluetooth LE | Bluetooth LE 5.3、Thread / Zigbee / Matter(Wi-Fi なし) |
| 搭載センサー | なし | 6 軸 IMU(LSM6DS3TR-C)、マイク |
| スリープ時電流(公称) | 44 μA | 1.95 μA |
| Arduino の BLE | ESP32 コア(NimBLE など) | Silicon Labs コア(BLE (Silabs) スタック) |
選んだ理由:
- IMU が基板に載っているため、配線なしで加速度とジャイロが使える(ESP32-C3 では外付けセンサーが必要)
- Wi-Fi が不要で、BLE だけで足りる
- 低消費電力(電池駆動を検討していたため)
XIAO ESP32-C3 を使った工作は、温度監視システムの連載で扱っています:【第2回】XIAO ESP32-C3 + DS18B20 で「温度がシリアルに出るまで」/連載目次
PC に外部キーボードとして認識される仕組み
PC はこのデバイスを専用ドライバなしで「Bluetooth キーボード」として扱います。BLE の HID over GATT Profile(HOGP) という標準の仕組みに沿っているためです。
- 広告: デバイスは名前「XIAO Sense Keyboard」と、HID サービスを持っていること(UUID 0x1812)を電波で知らせます。接続後、PC は外観(Appearance)の値 0x03C1(=キーボード)も読み取ります。Windows の一覧にキーボードとして表示されるのはこれらの情報によります。
- HID サービス(0x1812): 接続すると、PC はデバイスの GATT サービスを読みます。HID サービスには Report Map(どんなデータを送るかを記述した HID レポート記述子)があり、ここで「標準のキーボード」であることを宣言しています。
- ペアリングと暗号化: Windows は HID 機器との通信に暗号化を要求します。最初の接続でペアリング(鍵の交換と保存=ボンディング)を行い、以後は保存した鍵で自動再接続します。
- キー入力レポート: キーを押すたびに 8 バイトのレポートを通知(Notify)します。
- 1 バイト目: 修飾キー(左 Ctrl = 0x01)
- 3 バイト目: キーコード(C = 0x06、V = 0x19、Z = 0x1D)
- 押下レポートの 50 ms 後に全 0 のレポートを送り、キーを離したことを伝えます(送らないと押しっぱなしになります)
- OS 側: Windows の標準 HID ドライバがレポートを受け取り、通常のキーボード入力として扱います。そのため、フォーカスのあるウィンドウに Ctrl+C / Ctrl+V が入ります。
なお、USB はキーボードとしては使っていません。XIAO MG24 の USB-C は書き込み用・シリアル用の変換チップにつながっていて、USB キーボードにはなりません(ESP32-C3 の内蔵 USB も Serial/JTAG 専用で、USB キーボードにはできません)。どちらの基板でも、キーボードとして使うなら Bluetooth を使います。
ビルドと書き込み
- Arduino IDE に Silicon Labs の Arduino コアを入れる
- ボード: Seeed Studio XIAO MG24 (Sense)
- ツール → Protocol stack → BLE (Silabs) を選ぶ(他を選ぶとコンパイルエラーで止まるようにしてあります)
xiao_mg24_sense_gesture_keyboard.inoを書き込む
追加ライブラリは不要です。
Arduino IDE はフォルダ名とスケッチ名(.ino)が同じである必要があります。リポジトリをそのまま clone するとフォルダ名が xiao_mg24_sense_Copypasta になるので、git clone https://github.com/whiskerpad/xiao_mg24_sense_Copypasta xiao_mg24_sense_gesture_keyboard のようにフォルダ名を指定してください。
ペアリング
- Windows の「設定 → Bluetooth とデバイス → デバイスの追加 → Bluetooth」
- XIAO Sense Keyboard を選ぶ
- メモ帳などを前面にして叩く
LED の意味
| LED | 状態 |
|---|---|
| 約 1 秒ごとに短く 1 回 | 接続待ち(広告中) |
| 消灯 | 接続済み・待機中 |
| 速い点滅 | IMU が見つからない |
| 1〜3 回点滅して止まる | ジェスチャーを送った |
検出のしくみ
- サンプリング: IMU を 833 Hz で動かし、加速度とジャイロを FIFO からまとめて読みます。時間は
millis()ではなく FIFO のサンプル数から計算します。 - タップ: 静止状態から 0.4 g 以上ずれ、80 ms 以内に収まる揺れを 1 打とします。最後の打撃から 300 ms 次が来なければ確定し、1 打なら Ctrl+C、2 打以上なら Ctrl+V です。
- 跳ね返り: 叩くと約 100 ms 後に本体が跳ね返ります。前の打撃から 150 ms 以内の打撃は数えません。
- 持ち上げ・回転: ジャイロで回転角を求め、大きく回った動きの間のタップは送りません。
- 自己診断: IMU のデータが 300 ms 来なければ FIFO を空にし、それでも復帰しなければ IMU の電源を入れ直します。
しきい値は実機のログから決めました。根拠は DEVLOG.md にあります。
つまずいた点
- ダブルタップに余計なシングルタップが付く: 2 打目で即確定していたため、その後の跳ね返りが新しい 1 打になっていました。静かになってから確定する方式に変更。
- シングルタップが Ctrl+V になる: 跳ね返りが毎回 94〜117 ms 後に来ていました。ダブルタップの 2 打目は 180〜230 ms 後。最小間隔を 150 ms にして分離。
- 机の上を滑らせる操作は検出できなかった: 手で滑らせると加速と減速の 2 つの山になり、「一定の加速度が 180 ms 続く」条件を満たしません。ジャイロのひねりに変更(その後、滑り止めの関係で無効化)。
- 20 分放置すると反応しなくなる: IMU からのデータが止まっていました。原因は特定中。自動復旧で実用上は解決。
- Bluetooth が数秒ごとに切れる/つながらない:
- PC と本体のどちらか一方だけにペアリング情報が残ると、接続→暗号化失敗→切断をくり返します。PC 側でデバイスを削除し、本体側は
kEraseBondsOnBoot = trueで一度書き込んで消去してから、false に戻して 書き込み直します。 - 動作確認に使ったスマホがキーボードとしてペアリングし、本体の起動と同時に自動接続していました。本体は同時に 1 台としか接続できないため、PC からは見えなくなります。シリアルログの接続パラメータ(Windows は 7.5 ms / 2000 ms、iPhone は 30 ms / 720 ms)で見分けました。
- BLE のイベント処理内で
app_assert_statusを使うと、ペアリング失敗時に基板全体が停止します。実行時の BLE 呼び出しはログ出力に変えました。
- PC と本体のどちらか一方だけにペアリング情報が残ると、接続→暗号化失敗→切断をくり返します。PC 側でデバイスを削除し、本体側は
- ケースと電波: 金属の重りや金属入りフィラメントは、アンテナ(USB と反対側の端)から離します。
開発用ログツール
tools\log_capture.bat (既定は COM17)
tools\log_capture.bat --port COM5
- シリアル出力を PC の
logs/に保存し、切断理由・ジェスチャー数・IMU 停止回数などをlogs/latest_summary.txtにまとめます。 - 終了は q キー です(本体が Ctrl+C を打つため、Ctrl+C では止まらないようにしています)。
- 書き込み前はロガーを止めてください(COM ポートを同時に使えません)。
- Python 3 と pyserial が必要です(初回に自動インストール)。
- ログには Ctrl+V で貼り付けられたクリップボードの内容が残ることがあるため、
logs/は公開しないでください(.gitignoreで除外済み)。
主な設定値(スケッチ冒頭)
| 定数 | 既定値 | 用途 |
|---|---|---|
ENABLE_TWIST_UNDO | 0 | 1 で左ひねり=Ctrl+Z |
kEraseBondsOnBoot | false | true で起動時にペアリング情報を全消去(使ったら必ず false に戻す) |
kMinTapGapMs | 150 | これより近い打撃は跳ね返りとみなす |
kTapWindowMs | 300 | 最後の打撃からこの時間でタップを確定 |
kTwistMinDeg | 8 | ひねりと判定する最小角度 |
kHeartbeatMs | 30000 | シリアルの定常ログ間隔 |
ファイル構成
| ファイル | 内容 |
|---|---|
xiao_mg24_sense_gesture_keyboard.ino | スケッチ本体 |
DEVLOG.md | 開発記録 |
tools/serial_logger.py, tools/log_capture.bat | ログ保存ツール |
LICENSE | MIT License |
DEVLOG.md について
DEVLOG.md は、開発を手伝った AI(Claude)が作業の経緯を次の作業に引き継ぐために書いた記録です。人が読む文書として整えたものではありませんが、問題→原因→対処の流れと実測値をそのまま残しています。
未解決
- 接続中だけ
loop()が 180 ms 程度止まることがある - IMU の FIFO がまれに止まる根本原因
- XIAO MG24 の RF スイッチ(PB04 / PB05)の設定が電波の強さに影響するか
- 新しい機器とのペアリングを起動直後だけ受け付ける仕組み(スマホに接続を取られないように)
筐体作成

上下二段の構造にしてMG24をサンドイッチにしました。


注意
- 本体はフォーカスのあるウィンドウにショートカットを送ります。
- 個人の工作です。動作は保証しません。
License
MIT License. See LICENSE.


コメント