flowchart TB APP["アプリケーション<br/>(このハンズオンで書くコード)"] ARD["Arduino API / Bluefruit ライブラリ<br/>(digitalWrite, attachInterrupt, Bluefruit.begin ...)"] RTOS["FreeRTOS<br/>(タスク・キュー・ソフトウェアタイマー)"] SD["SoftDevice S140<br/>(Nordic の BLE プロトコルスタック)"] HW["nRF52840 ハードウェア"] APP --> ARD --> RTOS --> HW ARD --> SD --> HW
1 開発環境と nRF52840
1.1 nRF52840 と XIAO nRF52840
nRF52840 は Nordic Semiconductor の BLE (Bluetooth Low Energy) 対応マイコンです。
| 項目 | 内容 |
|---|---|
| CPU | Arm Cortex-M4F(浮動小数点演算ユニット付き)64 MHz |
| メモリ | Flash 1 MB、RAM 256 KB |
| 無線 | Bluetooth 5(BLE)、IEEE 802.15.4 (Thread / Zigbee) |
| その他 | USB 2.0、QSPI、I²C / SPI / UART、12 bit ADC |
Seeed Studio XIAO nRF52840 は、このチップを親指ほどの基板に載せたボードです。Sense 版には 6 軸 IMU(加速度 + ジャイロ, LSM6DS3TR-C)と PDM マイクが載っています。基板上には RGB LED と 2 MB の QSPI フラッシュがあり、リポバッテリの充電回路も備えています。
1.2 ソフトウェアの層
このハンズオンでは、Arduino 互換の Adafruit nRF52 コア(Seeed による XIAO 対応版)を使います。Arduino の書きやすさのまま、その下で次のソフトウェアが動いています。
- FreeRTOS: リアルタイム OS。
setup()/loop()も、実は FreeRTOS の タスク(loop タスク)の中で動いている。BLE やタイマーも別のタスクで動く - SoftDevice: Nordic が提供する BLE スタックのバイナリ。最も高い割り込み優先度を持ち、無線のタイミングを守るためにアプリの処理に割り込む
loop() は「唯一の処理の流れ」ではありません。BLE のコールバックやタイマーのコールバックは 別のタスク で、ボタンの割り込みは 割り込みハンドラ の中で呼ばれます。これらから共有データを直接いじると、競合が起きます。そこで イベントキュー を使います(第 3 章)。
1.3 PlatformIO のセットアップ
- VS Code をインストールする
- 拡張機能 PlatformIO IDE をインストールする
- サンプルファームウェア firmware.zip を展開し、VS Code で
firmwareフォルダを開く - 初回は PlatformIO がプラットフォーム・ツールチェーン・ライブラリを自動でダウンロードする(数分かかる)
1.3.1 platformio.ini
; nRF52840 イベント駆動ハンズオン サンプルファームウェア
; ボード: Seeed Studio XIAO nRF52840 Sense(Adafruit nRF52 コア + FreeRTOS + SoftDevice S140)
[env]
; Seeed プラットフォームの既定の GCC 7.2 は x86_64 版しかなく、Apple Silicon の Mac では
; Rosetta がないと動かない。ARM ネイティブ版がある新しい GCC を指定する
platform_packages =
platformio/toolchain-gccarmnoneeabi@~1.120301.0
[env:xiao_sense]
platform = https://github.com/Seeed-Studio/platform-seeedboards.git
board = seeed-xiao-afruitnrf52-nrf52840-sense
framework = arduino
monitor_speed = 115200
lib_deps =
seeed-studio/Seeed Arduino LSM6DS3@^2.0.4
build_flags =
-Isrc/app
-Isrc/drivers
-D USE_IMU=1
; IMU を載せていない XIAO nRF52840(Sense なし)用。加速度は疑似データになる
[env:xiao]
platform = https://github.com/Seeed-Studio/platform-seeedboards.git
board = seeed-xiao-afruitnrf52-nrf52840
framework = arduino
monitor_speed = 115200
build_flags =
-Isrc/app
-Isrc/drivers
-D USE_IMU=0platform: Seeed が公開している PlatformIO プラットフォーム(GitHub から取得)board: Sense 版はseeed-xiao-afruitnrf52-nrf52840-sense、Sense なしはseeed-xiao-afruitnrf52-nrf52840build_flagsの-Iで、src/appとsrc/driversをヘッダの検索パスに加えている-D USE_IMU=1で IMU を使うかどうかを切り替える(#if USE_IMU)
Seeed のプラットフォームの既定のコンパイラ(GCC 7.2)は x86_64 版しかなく、Rosetta 2 がない Apple Silicon の Mac では Bad CPU type in executable というエラーになります。サンプルでは platform_packages で ARM ネイティブ版がある新しい GCC (12.3) を指定して回避しています。
1.4 ビルドと書き込み
| 操作 | VS Code(PlatformIO ツールバー) | コマンド |
|---|---|---|
| ビルド | ✓ (Build) | pio run -e xiao_sense |
| 書き込み | → (Upload) | pio run -e xiao_sense -t upload |
| シリアルモニタ | 🔌 (Serial Monitor) | pio device monitor |
書き込みに失敗する場合は、リセットボタンを素早く 2 回押す とブートローダモードに入ります(LED がゆっくり明滅し、PC に USB ドライブとして見える)。その状態で再度書き込みます。
書き込みが終わり、シリアルモニタに
boot: state=WAIT
と表示され、緑の LED が 2 秒に 1 回短く光れば 成功です。
1.5 配線
ボタンは D8 と GND の間 にタクトスイッチをつなぐだけです。D8 は内部プルアップ(INPUT_PULLUP)にしているので、
- 押していないとき: HIGH
- 押しているとき: LOW
になります。
1.6 ファイル構成
firmware/
├── platformio.ini
└── src/
├── main.cpp setup() と loop()(イベントループ)
├── app/ アプリケーション(ハードに依存しない部分)
│ ├── app_event.h/.cpp イベントとイベントキュー
│ ├── app_state.h 状態
│ ├── app_handler.h/.cpp 状態遷移テーブルと dispatch()
│ ├── app_handler_wait.cpp 待機状態のハンドラ
│ ├── app_handler_meas.cpp 測定状態のハンドラ
│ └── app_meas.h/.cpp 測定データの集計と BLE 応答
└── drivers/ ハードウェアを触る部分(イベントの発生源)
├── drv_button.h/.cpp ボタン割り込み
├── drv_timer.h/.cpp ソフトウェアタイマー
├── drv_ble.h/.cpp BLE
├── drv_imu.h/.cpp 加速度センサ
└── drv_led.h/.cpp LED
app/ はイベントと状態の論理、drivers/ はハードウェアとの境界 という分け方をしています。
最初は ble.h という名前にしていましたが、ビルドすると Bluefruit ライブラリの中で大量のエラーが出ました。Nordic の SoftDevice にも ble.h という同名のヘッダ があり、-Isrc/drivers の指定がライブラリ側の #include "ble.h" にも効いて、自作のヘッダが読み込まれてしまったためです。event.h、timer.h なども他のライブラリと衝突しやすい名前です。app_ / drv_(あるいは My)のような接頭辞 を付けておくと安全です。