最初の BLE アプリケーション¶

Reef 構成をビルドします。 SDK のルートから次を実行します。

make -C apps/bluetooth/ble/ipro_ble_remote DEFCONFIG=defconfig_reef

DEFCONFIG= を使うと .config は変更されず、build_reef/ にビルドされます。ビルドに成功すると、最後にリンカーのメモリ表が表示されます（flash の行に 2 MB と表示されます）。出力は apps/bluetooth/ble/ipro_ble_remote/build_reef/build_out/ipro_ble_remote_IPRO7.bin です。DEFCONFIG= を付けずに make だけを実行すると IPRO7 EVB 版がビルドされ、これは Reef では動作しません。

Reef をダウンロードモードにします。 SW1（BOOT）を押したまま SW2（RESET）を短く押し、SW1 を離します。シェル付きのファームウェアがすでにボードで動作している場合は、コンソールで reboot_dl と入力しても同じです。ダウンロードモードではコンソールに何も表示されません。

boot2、A/B テーブル、ファームウェアを書き込みます。 IntelProCube のディレクトリから次を実行します。

./ipro_iot_tool_macos --chipname ipro7 --chip-variant IPRO7AI \
    --port /dev/cu.usbserial-XXXX --baudrate 921600 \
    --boot2 chips/ipro7/builtin_imgs/boot2_v0.6.0/ipro_boot2_IPRO7_v0.6.0.bin \
    --pt <SDK>/apps/bluetooth/ble/ipro_ble_remote/partition_cfg_2M_remote_ab.toml \
    --firmware <SDK>/apps/bluetooth/ble/ipro_ble_remote/build_reef/build_out/ipro_ble_remote_IPRO7.bin

./ipro_iot_tool_linux --chipname ipro7 --chip-variant IPRO7AI \
    --port /dev/ttyUSB0 --baudrate 921600 \
    --boot2 chips/ipro7/builtin_imgs/boot2_v0.6.0/ipro_boot2_IPRO7_v0.6.0.bin \
    --pt <SDK>/apps/bluetooth/ble/ipro_ble_remote/partition_cfg_2M_remote_ab.toml \
    --firmware <SDK>/apps/bluetooth/ble/ipro_ble_remote/build_reef/build_out/ipro_ble_remote_IPRO7.bin

.\ipro_iot_tool.exe --chipname ipro7 --chip-variant IPRO7AI `
    --port COM5 --baudrate 921600 `
    --boot2 chips/ipro7/builtin_imgs/boot2_v0.6.0/ipro_boot2_IPRO7_v0.6.0.bin `
    --pt <SDK>\apps\bluetooth\ble\ipro_ble_remote\partition_cfg_2M_remote_ab.toml `
    --firmware <SDK>\apps\bluetooth\ble\ipro_ble_remote\build_reef\build_out\ipro_ble_remote_IPRO7.bin

--chip-variant IPRO7AI は Reef（QFN56）の Flash ピンを選択します。このツールは失敗しても終了コード 0 で終了するため、出力に [All Success] があることを確認してください。IPRO Debug Probe を使う場合、ポートは名前が 02 で終わるものです。A/B レイアウトの整合性を保つため、このアプリケーションを再書き込みするときは毎回この完全なコマンドを使います。

コンソールを開いてリセットします。 U6 のポートを 115200 ボーで開き（書き込みとシリアルコンソールを参照）、SW2（RESET）を短く押します。最初に boot2 が、続いてアプリケーションが出力します（各行の先頭にあるレベルと時刻のフィールドは省略しています）。

[BOOT2] IPRO7 Boot2 v0.6.0
...
REMOTE_APP: [BLE] Initialized
REMOTE_APP: [BLE] All services initialized
REMOTE_APP: [BLE] Advertising: IPRO-Remote

スマートフォンから接続します。

• 付属の Android アプリを使う場合：ipro_remote_demo.apk をスマートフォンにコピーし、開いてインストールします（提供元不明のアプリのインストールを許可します）。または、コンピューターで adb install apps/bluetooth/ble/ipro_ble_remote/ipro_remote_demo.apk を実行します。
• BLE ツールアプリを使う場合：IPRO-Remote をスキャンして接続します。

コンソールに次のように表示されます。

REMOTE_APP: Connected! Peer: <スマートフォンのアドレス>

GATT サービスを使います。 BLE ツールアプリで次のキャラクタリスティックを探します。

SW1（BOOT）を短く押すとアプリケーションが写真を撮影するため（カメラが必要。microSD カードがあれば sd:/REMOTE/ にも保存されます）、キーのテストには SW3、SW4、SW5 を使います。コンソールコマンド reef status で、ボード、LED、カメラ、温度の状態を確認できます。

コードを変更します。 apps/bluetooth/ble/ipro_ble_remote/src/app/remote_app.c の 3 か所を編集します。

ファイルの先頭では、すでに CONFIG_IPRO7AI_REEF ブロック内で remote_reef.h をインクルードしています。その下に、reef_hw_tone() を宣言している reef_hw.h を追加します。

#if defined(CONFIG_IPRO7AI_REEF)
#include "remote_reef.h"
#include "reef_hw.h"
#endif

アドバタイズ名を変更します。

#define DEVICE_NAME "IPRO-Hello"

connected_cb() 内の Connected! Peer のログ行の後に、ビープ音を追加します。

    IPRO_LOGI(LOG_TAG, "Connected! Peer: %s", addr_str);

#if defined(CONFIG_IPRO7AI_REEF)
    /* スマートフォン接続時に、スピーカーとヘッドホンジャックで 1 kHz、150 ms のビープ音を鳴らす */
    (void)reef_hw_tone(1000, 150, 30);
#endif

reef_hw_tone() は Reef のハードウェアを管理するタスクに要求をキューイングしてすぐに戻るため、BLE の接続コールバックから安全に呼び出せます。このアプリケーションは -Werror でコンパイルされるため、警告が 1 つでもあるとビルドが失敗します。

再ビルドして書き込みます。 手順 1 のビルドコマンドを再度実行し（変更したファイルだけが再コンパイルされます）、コンソールで reboot_dl と入力して、手順 3 のコマンドで書き込みます。

再度接続します。 SW2 を短く押すと、コンソールに REMOTE_APP: [BLE] Advertising: IPRO-Hello と表示されます。スマートフォンで再度スキャンして IPRO-Hello に接続すると、接続の確立時に Reef がビープ音を鳴らします。

OTA ツールを準備します。 ここからは更新を BLE で行うため、U6 は不要です。SDK のルートで、bleak を入れた Python 仮想環境を作成します。

python3 -m venv .venv
.venv/bin/pip install bleak

先にスマートフォンの接続を切断してください。Reef ビルドは 1 つの接続しか許可しません（CONFIG_BT_CONN=1）。

OTA パッケージをビルドします。 小さな変更を加え（例：ビープ音を reef_hw_tone(2000, 150, 30) に変更）、再ビルド（手順 1）してから、ビルド結果を boot2 OTA パッケージにまとめます。スクリプトは IntelProCube に結合イメージを作成させ、SDK の tools/create_ota.py で圧縮します。スクリプトは IntelProCube フォルダー内の最新の boot2（0.7.0.1 では v0.6.0）を使います。

IPRO_FLASH_TOOL=<IntelProCube>/ipro_iot_tool_macos \
    sh apps/bluetooth/ble/ipro_ble_remote/tools/make_reef_ota.sh

IPRO_FLASH_TOOL=<IntelProCube>/ipro_iot_tool_linux \
    sh apps/bluetooth/ble/ipro_ble_remote/tools/make_reef_ota.sh

出力は apps/bluetooth/ble/ipro_ble_remote/build_reef/build_out/ipro_ble_remote_reef.xz.ota（約 345 KB）です。OTA が受け付けるのはこの .xz.ota パッケージだけで、.bin は受け付けません。

BLE で送信して確認します。 reef_ota.py はデフォルトで IPRO-Remote という名前のデバイスを探します。ボードの名前は変更済みなので、REMOTE_NAME を設定します。

REMOTE_NAME=IPRO-Hello .venv/bin/python apps/bluetooth/ble/ipro_ble_remote/tools/reef_ota.py \
    apps/bluetooth/ble/ipro_ble_remote/build_reef/build_out/ipro_ble_remote_reef.xz.ota

ツールは、ボードの現在のバージョン、パッケージのサイズと CRC32、転送時間、verified, slot switched; rebooting を表示します。ボードの再起動後に再接続し、新しいバージョンを表示します。

running: <カメラ、SD カード、ビルド日時>
ipro_ble_remote_reef.xz.ota: <バイト数> bytes, CRC32 <値>, <ペイロード> bytes/packet
sent in <秒数> s (<速度> KB/s)
verified, slot switched; rebooting
running: <カメラ、SD カード、ビルド日時>

その間、ボードのコンソールには [OTA] START: …、[OTA] CRC32 OK! Switching partition...、[OTA] Ready to reboot が表示され、再起動時に boot2 が [BOOT2] IPRO7 Boot2 v0.6.0 と [BOOT2] OTA pending を表示し、パッケージの SHA256 を確認して FW A に展開し、[BOOT2] OTA ok を表示してからアプリケーションを起動します。チップの eFuse に署名鍵が書き込まれていない場合は [OTA] no eFuse key, package unverified という行も表示されます。これは署名を検証しないという意味です。running: のビルド日時は src/board/reef_hw.c から取られるため、remote_app.c だけを変更した場合は変わりません。INTELPRO の測定では、macOS、MTU 247 で 345 KB のパッケージの送信に 13～17 秒かかりました。付属の Android デモアプリでも同じ .xz.ota パッケージを送信できます。