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 の書きやすさのまま、その下で次のソフトウェアが動いています。

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

  • FreeRTOS: リアルタイム OS。setup() / loop() も、実は FreeRTOS の タスク(loop タスク)の中で動いている。BLE やタイマーも別のタスクで動く
  • SoftDevice: Nordic が提供する BLE スタックのバイナリ。最も高い割り込み優先度を持ち、無線のタイミングを守るためにアプリの処理に割り込む
重要キーポイント

loop() は「唯一の処理の流れ」ではありません。BLE のコールバックやタイマーのコールバックは 別のタスク で、ボタンの割り込みは 割り込みハンドラ の中で呼ばれます。これらから共有データを直接いじると、競合が起きます。そこで イベントキュー を使います(第 3 章)。

1.3 PlatformIO のセットアップ

  1. VS Code をインストールする
  2. 拡張機能 PlatformIO IDE をインストールする
  3. サンプルファームウェア firmware.zip を展開し、VS Code で firmware フォルダを開く
  4. 初回は 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=0
  • platform: Seeed が公開している PlatformIO プラットフォーム(GitHub から取得)
  • board: Sense 版は seeed-xiao-afruitnrf52-nrf52840-sense、Sense なしは seeed-xiao-afruitnrf52-nrf52840
  • build_flags の -I で、src/app と src/drivers をヘッダの検索パスに加えている
  • -D USE_IMU=1 で IMU を使うかどうかを切り替える(#if USE_IMU)
警告Apple Silicon の Mac でビルドできない場合

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)のような接頭辞 を付けておくと安全です。