Howto

Armadillo-640 + BT/THオプションモジュール + pc-ble-driver スキャンサンプル

Armadillo-640 + BT/THオプションモジュール上でpc-ble-driverを使用し、スキャンを行うサンプルを作成しました。
本サンプルは開発中にペリフェラルがアドバタイジングパケットを出しているか等確認するために、使用することができます。 本howtoではその概要と使い方についてまとめます。

使用したもの

準備

本手順ではArmadillo-640をセントラルとしてスキャンができることを確認します。

Armadillo-640とBT/THオプションモジュールのセットアップ

使用するArmadillo-640のソフトウェア構成は以下のとおりです。

ソフトウェア ダウンロード
Linuxカーネル v4.14-at35
DTB v4.14-at35
ブートローダー v2018.03-at9(UART3)
ユーザーランド v20210224(buster)

Armadillo-640とBT/THオプションモジュールのセットアップは「Armadillo-640 + BT/THオプションモジュールでLE Coded PHY(Long-range モード)」と同様の手順で行います。 セットアップを行うことで、Armadillo-640上でサンプルを実行することができます。

サンプルプログラムの取得

サンプルプログラム(scan_sample)を取得する方法は以下のように2通りあります。
- プログラムをビルドする
- ビルド済みバイナリをダウンロードする

プログラムをビルドする

本howtoで使用するサンプルプログラムのソースコードはこちらからダウンロードできます。

サンプルプログラム(scan_sample)は「Armadillo-640 + BT/THオプションモジュールでLE Coded PHY(Long-range モード)」でpc-ble-driverのビルド環境を整えた上で、以下のコマンドを実行することで生成されます。

[ATDE]$ cd path/to/pc-ble-driver/at_build/
[ATDE]$ make dist-clean && make CROSS_COMPILE=arm-linux-gnueabihf-
[ATDE]$ ls scan_sample
scan_sample

ビルド済みバイナリをダウンロードする

ビルド済みバイナリを使用するには以下のコマンドをArmadillo上で実行します。

[amradillo ~]# wget https://github.com/atmark-techno/pc-ble-driver/releases/download/howto-v1.3.0/bin_scan_sample.tar.gz
[amradillo ~]# ls bin_scan_sample.tar.gz
bin_scan_sample.tar.gz
[amradillo ~]# tar xf bin_scan_sample.tar.gz
[amradillo ~]# ls bin_scan_sample/scan_sample
scan_sample

使用方法

  • -h
    ヘルプを表示します。
  • -a
    アクティブスキャンを行います。
    デフォルトはパッシブスキャンです。
  • -e
    extended advertising packetを受信します。
    スキャンに使用するPHYをCoded PHYにした場合自動で有効になります。
  • -p
    スキャンに使用するPHYを1M PHYかCoded PHYどちらか選択します。
    デフォルトはCoded PHYです。
    以下に1M・Coded PHYを指定する方法を示します。
    1M PHYを使用する場合:1m
    Coded PHYを使用する場合:coded
  • -s
    シリアルポートを指定します。
    デフォルトは/dev/ttyACM0です。

実行例

以下に実行例を示します。 ここではCoded PHYを使用してパッシブスキャンでextended advertising packetを受信します。
スキャンしたデバイスのデバイスアドレス、RSSI値、デバイス名を表示します。

[armadillo]$ ./scan_sample -p coded -s /dev/ttyACM0
phy: CODED_PHY
Accept Extended Advertising packet
Serial port used: /dev/ttyACM0
Baud rate used: 1000000
Info: Successfully opened /dev/ttyACM0. Baud rate: 1000000. Flow control: none. Parity: none.
device address: 0x0123456789AB, RSSI: -39 device name: armadillo
device address: 0x0123456789AB, RSSI: -38 device name: armadillo
device address: 0x0123456789AB, RSSI: -38 device name: armadillo
: (以下略)