61
FJXL7105_BACI_Manual-02 Bluetooth Application Controller Interface BACIコマンドマニュアル 発行日:2015 年 3 月 11 日

Bluetooth Application Controller Interface BACI...Bluetooth Application Controller Interface(BACI)コマンドマニュアル i ご注意 本仕様書に関わる注意事項 1

  • Upload
    others

  • View
    5

  • Download
    0

Embed Size (px)

Citation preview

FJXL7105_BACI_Manual-02

Bluetooth Application Controller Interface(BACI)

コマンドマニュアル

発行日:2015 年 3 月 11 日

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

i

ご注意

本仕様書に関わる注意事項 1 本仕様書に記載されている内容は本仕様書発行時点のものであり、予告なく変更することがあります。

2 本仕様書に記載されている情報は、正確を期するために慎重に作成したものですが、誤りがないことを保証するも

のではありません。万一、本仕様書に記載されている情報の誤りに起因する損害がお客様に生じた場合におきま

しても、ラピスセミコンダクタは、一切その責任を負いません。

3 本仕様書に記載された技術情報は、本製品の代表的動作および応用回路例などを示したものであり、当該技術

情報に関するラピスセミコンダクタまたは第三者の知的財産権その他の権利を許諾するものではありません。上記

技術情報の使用に起因して第三者の権利にかかわる紛争が発生した場合、ラピスセミコンダクタは、一切その責任

を負いません。

4 本仕様書にはラピスセミコンダクタの著作権、ノウハウに関わる内容も含まれておりますので、本製品の使用目的以外

にはこれを用いないようにお願い致します。また、本仕様書の全部または一部をラピスセミコンダクタの事前承諾を

得ずに転載若しくは複製し、又は第三者に開示することはご遠慮ください。

本製品に関わる注意事項 ●安全上の注意事項

1)本製品は一般的な電子機器(AV 機器、OA 機器、通信機器、家電製品、アミューズメント機器等)への使用を意

図して設計・製造されております。

2)本製品を下記のような特に高い信頼性が要求される機器等に使用される際には、ラピスセミコンダクタへ必ず

ご連絡の上、承諾を得てください。

・輸送機器(車載、船舶、鉄道など)、幹線用通信機器、交通信号機器、防災・防犯装置、安全確保のた

めの装置、医療機器、サーバー、太陽電池、送電システム

3)本製品を極めて高い信頼性を要求される下記のような機器等には、使用しないでください。

・航空宇宙機器、原子力制御機器、海底中継機器

4)本製品は一般的な電子機器に標準的な用途で使用されることを意図して設計・製造されており、下記のよう

な特殊環境での使用を配慮した設計はなされておりません。従いまして、下記特殊環境でのご使用は本製品

の性能に影響を与える恐れがありますので、お客様におかれましては十分に性能、信頼性等をご確認の上ご

使用下さい。

①水・油・薬液・有機溶剤等の液体中でのご使用

②直射日光・屋外暴露、塵埃中でのご使用

③潮風、Cl2、H2S、NH3、SO2、NO2 等の腐食性ガスの多い場所でのご使用

④静電気や電磁波の強い環境でのご使用

⑤強い振動や衝撃が加わる環境でのご使用

⑥発熱部品に近接した取付け及び本製品に近接してビニール配線等、可燃物を配置する場合

⑦本製品を樹脂等で封止、コーティングしてのご使用

⑧本製品が結露するような場所でのご使用

5)本製品は他の電波を発射する機器(無線 LAN、Bluetooth®機器、デジタルコードレス電話、電子レンジ等)から電

波干渉を受けることがあります。

6)本製品は耐放射線設計はなされておりません。

7)本製品のご使用にあたってはお客様製品に実装された状態で評価及び確認を実施下さい。

8)使用温度は納入仕様書に記載の温度範囲内であることをご確認下さい。

9)ラピスセミコンダクタは常に品質・信頼性の向上に取り組んでおりますが、半導体製品は種々の要因で故障・

誤動作する可能性があります。従いまして、いかなる場合であっても、本製品の故障・誤動作等の不具合によ

り、人の生命、身体への損害及びその他の重大な損害の発生が予見される場合は、下記の方法により、フェー

ルセーフ設計への配慮を十分行い、安全性を確保されますようお願い致します。

①保護回路及び保護装置を設けてシステムとしての安全性を確保する。

②冗長回路等を設けて単一故障では危険が生じないようにシステムとしての安全を確保する。

10)本仕様書の記載内容を逸脱して本製品をご使用されたことによって生じた不具合につきましてはラピスセミ

コンダクタでは保証致し兼ねますのでご了承下さい。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

ii

11)本製品は製品の仕様上、電波を発します。電波を発する機器を使用するには、使用する地域毎に電波法

認証の取得が必要となります。本製品が取得する電波法認証規格につきましては、別途お問い合わせ下

さい。

12)本製品の安全性について疑義が生じた場合は速やかにラピスセミコンダクタへご連絡戴くと共にお客様に

て技術検討戴けます様お願い致します。

●参考回路に関する注意事項 1)本製品の外付け回路定数を変更してご使用になる際は静特性のみならず、過渡特性も含め外付け部品及

び本製品のバラツキ等を考慮して十分なマージンをみて決定して下さい。

2)記載されております参考回路例やその定数などの情報につきましては、本製品の標準的な動作や使い方を

説明するものです。従いまして、量産設計をされる場合には、外部諸条件を考慮して戴きます様お願い致し

ます。

●静電気に対する注意事項 本製品は静電気に対して敏感な製品であり、静電放電等により、製品が破壊されることがあります。

取り扱い時や工程での実装時、保管時において静電気対策を実施の上、絶対 大定格以上の過電圧等が印

加されないようにご使用下さい。特に乾燥環境下では静電気が発生しやすくなるため、十分な静電対策を実施

下さい。(人体及び設備のアース、帯電物からの隔離、イオナイザの設置、摩擦防止、温湿度管理、はんだごてのこ

て先のアース等)

●保管・運搬上の注意事項 1)本製品を下記の環境又は条件で保管されますと性能劣化やコネクタ嵌合性等の性能に影響を与える恐れがあ

りますので、このような環境及び条件での保管は避けて下さい。

①潮風、Cl2、H2S、NH3、SO2、NO2 等の腐食性ガスの多い場所での保管

②推奨温度、湿度以外での保管(推奨保管温度:5℃~40℃、湿度:40%~60%)

③直射日光や結露する場所での保管

④強い静電気が発生している場所での保管

2)コネクタ嵌合性、実装性、耐熱性等の性能はラピスセミコンダクタ出荷日より1年とし、上記保管条件を遵守され

た場合に限らせていただきます。

3)製品の運搬、保管の際は梱包箱を正しい向き(梱包箱に表示されている天面方向)で取り扱い下さい。天面

方向が遵守されずに梱包箱を落下させた場合、製品端子に過度なストレスが印加され、端子曲がり等の不具合

が発生する危険があります。

●製品ラベルに関する注意事項 ラピスセミコンダクタ製品に貼付されている製品ラベルに QR コードが印字されていますが、QR コードはラピスセミコ

ンダクタ社内管理用としており、お客様と契約しております製品情報が格納されていない場合があります。従いま

して、QR コードをお客様にてご使用にならないよう、お願いします。

●製品廃棄上の注意事項 本製品を廃棄する際は、専門の産業廃棄物処理業者にて、適切な処置をして下さい。

●知的財産権に関する注意事項 本製品のご購入は、本製品自体の使用、販売及びその他の処分を除き、本製品についてラピスセミコンダクタ

が所有または管理している知的財産権及びその他のあらゆる権利について明示的にも黙示的にも、その実施ま

た利用をお客様に許諾するものではありません。

●その他の注意事項 1)本製品のご使用に際しては、RoHS 指令など適用される環境関連法令を遵守の上ご使用ください。お客様

がかかる法令を遵守しないことにより生じた損害に関して、ラピスセミコンダクタは一切の責任を負いません。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

iii

本製品の RoHS 適合性などの詳細につきましては、セールス・オフィスまでお問合せください。

2)本製品および本資料に記載の技術を輸出又は国外へ提供する際には、「外国為替及び外国貿易法」、「米

国輸出管理規則」など適用される輸出関連法令を遵守し、それらの定めにしたがって必要な手続を行って

ください。

Copyright 2013 – 2015 LAPIS Semiconductor Co., Ltd.

〒222-8575 神奈川県横浜市港北区新横浜 2-4-8 http://www.lapis-semi.com

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

iv

はじめに

本書は BACI インタフェースを用いた ML7105 向けアプリケーションの開発者を対象としたガイドです。 下記の関連資料をご用意していますので、必要に応じて参照してください。

■ ML7105 データシート ■ ML7105 ユーザーズマニュアル ■ ML7105 向けアプリケーション開発ガイド

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

v

表記法

分 類 表記法 説 明

● 数値 0xnn 16 進数を表します。 0bnnnn 2 進数を表します。 ● アドレス 0xnnnn_nnnn 16 進数を表します。(0xnnnnnnnn を示します) ● 単位 ワード, WORD 1 ワード = 32 ビット バイト, BYTE 1 バイト = 8 ビット メガ,M 106 キロ,K 210=1024 キロ,k 103=1000 ミリ,m 10-3 マイクロ,μ 10-6 ナノ,n 10-9 セカンド,s(小文字) 秒 ● 用語 “H”レベル 電圧の高い側の信号レベルで、電気的特性で規定された

VIH、VOH の電圧レベルを示します。 “L”レベル 電圧の低い側の信号レベルで、電気的特性で規定された

VIL、VOLの電圧レベルを示します。 ● レジスタ説明図

読み書き属性:R は読み出し可能、W は書き込み可能なことを表します。 MSB:8 ビットのレジスタ(メモリ)の最上位ビット LSB:8 ビットのレジスタ(メモリ)の最下位ビット

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

vi

目次

ご注意...............................................................................................................................................................................i はじめに ..........................................................................................................................................................................iv 表記法 ............................................................................................................................................................................. v 目次................................................................................................................................................................................vi 概要.................................................................................................................................................................................1

BLUETOOTH LOW ENERGYのシングルモードの仕様 .....................................................................................................1 データストレージとメモリ保持..........................................................................................................................................2 BACIインタフェースの概要 ...........................................................................................................................................3 BACIパケットの種類 .....................................................................................................................................................3 BACIパケットの構成 .....................................................................................................................................................5 バイトの並び..................................................................................................................................................................5 状態遷移 ......................................................................................................................................................................6 BACIメッセージ ............................................................................................................................................................7

BACIコマンド ...................................................................................................................................................................9 RESET (0X01)...............................................................................................................................................................9 SHUTDOWN (0X02).......................................................................................................................................................9 SLEEP (0X03) ...............................................................................................................................................................9 WAKEUP (0X04)..........................................................................................................................................................10 ECHO (0X05) ..............................................................................................................................................................10 TEST (0X06) ...............................................................................................................................................................10 DTM (0X07)............................................................................................................................................................... 11 CONNECT (0X08)........................................................................................................................................................12 DISCONNECT (0X09) ..................................................................................................................................................13 CONNECTION UPDATE (0X0A) ...................................................................................................................................13 READ LOCAL DEVICE ADDRESS (0X0B) .....................................................................................................................13 READ LOCAL VERSION INFORMATION (0X0C)............................................................................................................14 READ RSSI (0X0D) ....................................................................................................................................................14 CONFIG TX POWER (0X0E) ........................................................................................................................................15 CONFIGURE (0X0F)....................................................................................................................................................16 READ EEPROM (0X10) .............................................................................................................................................17 WRITE EEPROM (0X11) ...........................................................................................................................................18 READ BB REG (0X12).................................................................................................................................................18 WRITE BB REG (0X13)...............................................................................................................................................19 READ RF REG (0X14).................................................................................................................................................20 WRITE RF REG (0X15) ...............................................................................................................................................20 RF SET TX HOP (0X16) .............................................................................................................................................21 READ PLATFORM REG (0X17).....................................................................................................................................22 WRITE PLATFORM REG (0X18)...................................................................................................................................22 WRITE CONFIG COMPLETE (0X19).............................................................................................................................23 READ CONFIG (0X1A) ................................................................................................................................................23 WRITE CONFIG (0X1B)...............................................................................................................................................24 ENABLE_I2C (0X1C)..................................................................................................................................................25 GET EEPROM STATUS (0X1D).................................................................................................................................25 WHITE_LIST (0X20)....................................................................................................................................................26 SET_RANDOM_ADDRESS (0X21) .................................................................................................................................27 SET_ADV_SCAN (0X22)...............................................................................................................................................27 SET_ADV_DATA (0X23) ...............................................................................................................................................28

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

vii

CONNECT_CANCEL (0X24) .........................................................................................................................................28 ENCRYPT (0X25) ........................................................................................................................................................28 RAND (0X26) ..............................................................................................................................................................29

BACIデータ ...................................................................................................................................................................31 BLE_ATT_DATA_EVENT (0X01)............................................................................................................................31

BACI ATTイベントリスト ...........................................................................................................................................32 BLE_ATT_DATA_COMMAND (0X02) ....................................................................................................................34

BACI ATTコマンドリスト ...........................................................................................................................................35 BLE_SMP_DATA_EVENT (0X03) ...........................................................................................................................38

BACI SMPイベントリスト ..........................................................................................................................................39 BLE_SMP_DATA_COMMAND (0X04) ...................................................................................................................40

BACI SMPコマンドリスト ..........................................................................................................................................41 BLE_L2CAP_DATA_EVENT (0X05).......................................................................................................................43

BACI L2CAPイベントリスト ......................................................................................................................................43 BLE_L2CAP_DATA_COMMAND (0X06) ...............................................................................................................44

BACI L2CAPコマンドリスト ......................................................................................................................................44 BACIイベント .................................................................................................................................................................45

START UP (0X01)........................................................................................................................................................45 COMMAND STATUS (0X02) .........................................................................................................................................45 COMMAND COMPLETE (0X03) ....................................................................................................................................45 ECHO (0X04) ..............................................................................................................................................................46 HARDWARE ERROR (0X05) .........................................................................................................................................46 CONNECTION COMPLETE (0X06) ...............................................................................................................................46 DISCONNECTION COMPLETE (0X07) ..........................................................................................................................48 CONNECTION UPDATE COMPLETE (0X09)..................................................................................................................48 DATA CREDIT (0X0A) .................................................................................................................................................49 ADVERTISING REPORT EVENT (0X0D) .......................................................................................................................49

フロー制御 .....................................................................................................................................................................50 コマンド .......................................................................................................................................................................50 データ.........................................................................................................................................................................50

用語集 ...........................................................................................................................................................................50 改版履歴........................................................................................................................................................................51

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

1

概要 BACI は Bluetooth Application Controller Interface の略称です。BlueLitE Bluetooth Single Mode Low Energy (BLE)のプロトコルスタックは BACI インタフェースを提供します。これにより、BLE のプロファイルとアプリケーションを別々のアプリ

ケーションプロセッサへの実装と、BLE コネクティビティプロセッサに実装された BLE スタック機能へのアクセスを実現しま

す。これはメッセージベースのプロトコルであり、UART、SPI など様々なインタフェースを通じてやり取りされます。 BACI は、BLE のプロファイルやアプリケーションのシナリオを実装するための GAP、GATT、SM 機能へのアクセスに必

要なインタフェースを提供します。また、デバイスを、BLE の仕様で定義された Direct Test Mode(DTM)に設定するイン

タフェースも提供します。 BACI インタフェースの詳細は本ドキュメントで説明しています。

Bluetooth Low Energyのシングルモードの仕様

Low Energy 機能は Bluetooth 4.0 仕様の以下の箇所で定義されています。 • Volume 2:Core System Package [BR/EDR Controller Volume]

o Part D :Error Codes

• Volume 3:Core System Package [Host Volume]

o Part A:Logical Link Control and Protocol

o Part C:Generic Access Profile (GAP)

o Part F:Attribute Protocol (ATT)

o Part G:Generic Attribute Profile (GATT)

o Part H:Security Manager (SM)

• Volume 6:Core System Package [Low Energy Controller Volume]

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

2

図1: コネクティビティプロセッサに実装される Bluetooth Low Energy の部品

データストレージとメモリ保持

コネクティビティプロセッサ内で、データは揮発性メモリと不揮発性メモリに格納されます。 プログラム実行時に作成されアプリケーションの動作に必要となる動的データは揮発性メモリに格納されます。ボンディン

グ情報、クライアント特性コンフィグレーション CCC)などの情報は不揮発性メモリにも格納することができます。 構成時、静的設定データは長期間のデータ保存のために不揮発性メモリに書き込むことができます。これらの値は電源

投入時の初期設定に使用されます。

Generic Attr ibute Profile (GATT)

Attribute Protocol (ATT) Security Manager (SM)

Logical Link Control and Adaption Protocol (L2CAP)

Host Controller Interface (HCI)

Link Layer (LL)

Physical Layer (PHY)

Generic Access Profile (GAP)

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

3

BACIインタフェースの概要

BACI インタフェースを以下の図に示します。

図2: BACI インタフェース

BACI が上位レイヤのプロファイルに提供するインタフェースは「BACI ホストインタフェース」と呼ばれます。そのインタフ

ェースの対向側で Bluetooth Low Energy ホストへのアクセスを提供するものは「BACI コントローラ」と呼ばれます。

BACIパケットの種類

BACI は Bluetooth ホストコントローラインタフェース(HCI)の UART 転送と同様のメッセージフォーマットを使用します。

UART 転送では、以下の HCI パケット表示が定義されています。

HCI パケットの種類 HCI パケットの識別子 HCI コマンドパケット 0x01

HCI ACL データパケット 0x02

HCI 同期データパケット 0x03

HCI イベントパケット 0x04 BACI では、以下のパケット種類が新たに定義されています。

BACI パケットの種類 BACI パケットの識別子 BACI コマンドパケット 0x01

BACI データパケット 0x02

BACI イベントパケット 0x04

Applicat ion

Bluetooth Low Energy Profiles

Bluetooth Application Controller Interface (BACI) Host

Bluetooth Application Controller Interface (BACI) Controller

Bluetooth Low Energy Host (GAP, GATT, SM etc.)

Bluetooth Low Energy Controller (LL etc.)

BACIInterface

Application

Processor

Bluetooth

Connectivity

Processor

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

4

-BACI コマンド アプリケーションプロセッサからコネクティビティプロセッサに送信される制御パケット -BACI イベント コネクティビティプロセッサからアプリケーションプロセッサに送信される制御パケット

BACI イベントは、ローカルで開始された動作やピアデバイスからの要求/応答に基づいて生

成されます。 -BACI データ データには二種類あります。

アプリケーションプロセッサからコネクティビティプロセッサに送信されるデータパケット。GATTや SMP プロトコルでピアデバイスとのトランザクションを開始するのに使用されます。 コネクティビティプロセッサからアプリケーションプロセッサに送信されるデータパケット。ピアデ

バイスから GATT/SMP プロトコルのメッセージを受信したことをアプリケーションに知らせるの

に使用されます。

図3: BACI パケットのやりとり

Bluetooth Peer Device supporting Low Energy

Application Processor

Bluetooth Connectivity Processor

BACI Command

BACI Event

BACI Event

BACI Data

BACI Data

BACI Data

Legend

Message (Command/Event/Data) Exchange

Optional Message (Command/Event/Data)

Exchange

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

5

BACIパケットの構成

パラメータ値はすべてリトルエンディアン形式で送受信されます。(たとえばマルチオクテットのパラメータの場合、 下位

オクテットから送信されます。)

図4: BACI パケットの構成

バイトの並び

マルチバイトのパラメータは、特に指定がなければすべてリトルエンディアン形式です( 下位バイトから送受信されま

す)。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

6

状態遷移

以下の状態が定義されています。 • Init

o コネクティビティプロセッサ構成(GAP、GATTなど) o 動的データはすべてクリアされます。

• Sleep o 省電力モード。すべての接続が切断されている状態です。 o 各種設定はメモリで保持されます。

• Test o Direct Test Modeと関連コマンド

• Idle o 設定されているがアプリケーションからLL/無線動作が起動されていない

• Connected o ピアデバイスとの接続が確立している状態。

図5: 状態遷移

Connected

Idle

Init

Sleep Test

configure

Configuration Complete

configure

disconnectedconnected

Enter Test

Exit Test

Sleep

Wakeup

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

7

BACIメッセージ

メッセージ コード 実行可能な ロール 遷移可能な状態

コマンド Reset 0x01 Master / Slave AllShutdown 0x02 Master / Slave AllSleep 0x03 Master / Slave IdleWakeup 0x04 Master / Slave SleepEcho 0x05 Master / Slave Idle / ConnectedTest 0x06 Master / Slave Idle / TestDTM 0x07 Master / Slave TestConnect 0x08 Master IdleDisconnect 0x09 Master / Slave ConnectedConnection Update 0x0A Slave ConnectedRead Local Device Address 0x0B Master / Slave Idle / ConnectedRead Local Version Information 0x0C Master / Slave Idle / ConnectedRead RSSI 0x0D Master Connected Config Tx Power 0x0E Master / Slave Idle / ConnectedConfigure 0x0F Master / Slave Idle / ConnectedRead EEPROM 0x10 Master / Slave Idle / ConnectedWrite EEPROM 0x11 Master / Slave Idle / ConnectedRead_BB_Reg 0x12 Master / Slave Idle / ConnectedWrite_BB_Reg 0x13 Master / Slave Idle / ConnectedRead_RF_Reg 0x14 Master / Slave Idle / ConnectedWrite_RF_Reg 0x15 Master / Slave Idle / ConnectedRF_Set_Tx_Hop 0x16 Master / Slave Test Read_Platform_Reg 0x17 Master / Slave Idle / ConnectedWrite_Platform_Reg 0x18 Master / Slave Idle / ConnectedWrite_config_complete 0x19 Master / Slave Idle / ConnectedRead_config 0x1A Master / Slave Idle / ConnectedWrite_config 0x1B Master / Slave Idle / ConnectedEnable_i2c 0x1C Master / Slave Idle / ConnectedGet_eeprom_status 0x1D Master / Slave Idle / ConnectedWhite_list 0x20 Master / Slave Idle / ConnectedSet_random_address 0x21 Master / Slave Idle / ConnectedSet_adv_scan 0x22 Master / Slave Idle / ConnectedSet_adv_data 0x23 Slave Idle / ConnectedConnect_cancel 0x24 Master Idle Encrypt 0x25 Master / Slave All Rand 0x26 Master / Slave All

データ ATT Data Event 0x01 Master / Slave Idle / ConnectedATT Data Command 0x02 Master / Slave Idle / ConnectedSMP Data Event 0x03 Master / Slave Idle / ConnectedSMP Data Command 0x04 Master / Slave Idle / ConnectedBLE L2CAP Data Event 0x05 Master / Slave Idle / ConnectedBLE L2CAP Data Command 0x06 Master / Slave Idle / Connected

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

8

メッセージ コード 実行可能な ロール 遷移可能な状態

イベント Start Up 0x01 Master / Slave Idle Command Status 0x02 Master / Slave Idle / ConnectedCommand Complete 0x03 Master / Slave Idle / ConnectedEcho 0x04 Master / Slave Idle / ConnectedHardware Error 0x05 Master / Slave Idle / ConnectedConnection Complete 0x06 Master / Slave Idle / ConnectedDisconnection Complete 0x07 Master / Slave Connected Connection Update Complete 0x09 Master / Slave Connected Data Credit 0x0A N/A Idle / ConnectedAdvertising Report 0x0D Master Idle / Connected

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

9

BACIコマンド

Reset (0x01)

説明 BACI コントローラをリセットします。実行中のリンクレイヤの活動の停止、アクティブな接続の切断、テストモードの有効・

無効の指定も行います。

パラメータ なし

イベント/戻り値

BACI コントローラのリセット時、Start Up イベントを生成します。

Shutdown (0x02)

説明 コネクティビティプロセッサの動作を完全に停止します。Shutdown 状態からの復帰にはハードウェアリセットが必要です。

パラメータ

なし イベント/戻り値

なし

Sleep (0x03)

説明 Sleep モードに設定し電力をセーブします。Sleep モード時は、接続はすべて切断されます。コネクティビティプロセッサは

アプリケーションプロセッサから Wakeup コマンドを受信するまで Sleep モード状態を維持します。

パラメータ なし

イベント/戻り値

Sleep モード遷移前に Command Complete イベントが生成されます。 Command Complete イベントのパラメータ:

Command Code:1 オクテット

値 パラメータの説明 Sleep (0x03) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコード

Command Parameter Length:

値 パラメータの説明 0x00 戻り値の長さ

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

10

Command Parameter: 値 パラメータの説明 なし

Wakeup (0x04)

説明 Sleep モードを終了し Idle 状態に遷移させます。

パラメータ なし

イベント/戻り値

Command Complete イベントと Start Up イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Wakeup (0x04) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコード

Command Parameter Length:

値 パラメータの説明 0x00 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし

Echo (0x05)

説明 BACI トランスポートレイヤのループバックテストを行います。アプリケーションプロセッサは本コマンドを使用してデータを

送信します。コネクティビティプロセッサは対応する Echo イベント内の同じデータを送り返すことにより、トランスポートレイ

ヤが正しく機能していることを確認します。

パラメータ Data:1~20 オクテット

値 パラメータの説明 任意 任意のデータを送信できます。

イベント/戻り値

Echo イベントが生成されます。Echo イベントは 20 バイト固定長のペイロードを使用します。

Test (0x06)

説明 テストモードの有効・無効を指定します。テストモード設定時および終了時にコネクティビティプロセッサがリセットされます。

コネクティビティプロセッサがテストモードに入ると、アプリケーションプロセッサは DTM コマンドを使用して無線テストを行

うことができます。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

11

パラメータ

Test_Enable:1 オクテット 値 パラメータの説明 0x00 テストモード無効 0x01 テストモード有効 0x02-0xFF 予約

イベント/戻り値

Command Complete イベントが生成され、成功または失敗を通知します。リセット時、Start Up が生成されます。 Command Complete イベントのパラメータ:

Command Code:1 オクテット

値 パラメータの説明 Test (0x06) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコード

Command Parameter Length:

値 パラメータの説明 0x00 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし

DTM (0x07)

説明 Bluetooth 仕様で定義されている以下の HCI コマンドをカプセル化します。 • LE Receiver Test コマンド • LE Transmitter Test コマンド • LE Test End コマンド

パラメータ

HCI DTM コマンド:サイズは可変(Bluetooth HCI 仕様の定義による) 値 パラメータの説明 - Bluetooth HCI 仕様の定義による

イベント/戻り値

Command Complete イベントが生成され、成功または失敗を通知します。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 DTM (0x07) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

12

上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコード

Command Parameter Length:

値 パラメータの説明 0x00 または 0x02 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし 以下のコマンドの場合

• LE Receiver Test コマンド • LE Transmitter Test コマンド

0xXXXX LE Test End コマンドの場合、受信したパケットの数(2 オクテット) BACI DTM コマンド・フォーマット

0x01 0x07 0x05 0x00-0x02 0x00-0x27 0x00-0x25 0x00-0x07 0x00-0x01

Packet Type Command Type Length DTM Test

Type frequency Payload Length

Payload Data Type

start_stop flag

- LE Receiver Test 0x01 0x07 0x05 0x01 0x00 0x00 0x00 0x01

Packet Type Command Type Length DTM Test

Type frequency NA NA start_stop flag=start

- LE Transmitter Test 0x01 0x07 0x05 0x02 0x00 0x00 0x00 0x01

Packet Type Command Type Length DTM Test

Type frequency Payload Length

Payload Data Type

start_stop flag=start

- LE Test End Command

0x01 0x07 0x05 0x00 0x00 0x00 0x00 0x00

Packet Type Command Type Length NA NA NA NA start_stop

flag=stop NA Not applicable

Connect (0x08)

説明 ピア Bluetooth デバイスとの接続を確立します。

パラメータ HCI コマンドの LE_Create_Connection で定義されています。

イベント/戻り値

まず、Command Status イベントが生成され、動作の開始を通知します。接続すると、Connection Complete イベントが生成

されます。ローカルデバイスおよびリモートデバイスのロール(マスタ、スレーブ)と設定に基づき、該当するイベントが生

成されます。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

13

Disconnect (0x09)

説明 ピア Bluetooth デバイスとの接続を終了します。

パラメータ Connection Context:2 オクテット

値 パラメータの説明 0x00-0xFF Connection Context(コネクション・ハンドル)で接続の終了をアプリケーションに

通知します。 イベント/戻り値

まず、Command Status イベントが生成され、動作の開始を通知します。切断すると、Disconnection Complete イベントが

生成されます。

Connection Update (0x0A)

説明 接続した Bluetooth デバイスとの LE Connection Update プロシージャを開始します。 このコマンドは BLE マスタデバイスによって実行されます。ローカルデバイスが BLE スレーブの場合は、BLE L2CAP Data コマンドを使用してください。

パラメータ HCI コマンドの LE Connection Update で定義されています。

イベント/戻り値 まず、Command Status イベントが生成され、動作の開始を通知します。動作が正常に開始されると、Connection Update Complete イベントが生成されます。

Read Local Device Address (0x0B)

説明 ローカルデバイスアドレス(パブリックアドレスとスタティックランダムアドレス)を取得します。

パラメータ Flag:1 オクテット

値 パラメータの説明 0x00 パブリックアドレスとスタティックランダムアドレスを読み出します。 0x01 スタティックランダムアドレスを生成します。

Host がセットした既存のランダムアドレスは変更しません。 パブリックアドレスと生成されたスタティックランダムアドレスを読み出します。

0x02 スタティックランダムアドレスを生成します。 ランダムアドレスを新たに生成した値でセットします。 パブリックアドレスとスタティックランダムアドレスを読み出します。

イベント/戻り値

ローカルデバイスのアドレス(パブリックアドレス、ランダムアドレスの順で)を示す Command Complete イベントが生成され

ます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Read Local Device Address (0x0B)

コマンドコード

Status:1 オクテット

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

14

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコー

Command Parameter Length: 値 パラメータの説明 0x0C 戻り値の長さ

Command Parameter:

値 パラメータの説明 0xXXXXXXXXXXXX パブリックアドレス 0xXXXXXXXXXXXX ランダムアドレス

Read Local Version Information (0x0C)

説明 BACI コントローラのローカルバージョン情報を読み出します。

パラメータ なし

イベント/戻り値

ローカルバージョン情報を示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ:

Command Code:1 オクテット

値 パラメータの説明 Read_Local_Version_Information (0x0C)

コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x08 戻り値の長さ

Command Parameter:

値 パラメータの説明 HCI_Version Bluetooth Assigned Number で定義された値(1 オクテット) HCI_Revision コントローラが使用する現在の HCI のリビジョン(2 オクテット) LMP/PAL_Version コントローラが使用する現在の LMP/PAL のバージョン(1 オクテット) Manufacturer_Name BR/EDR コントローラのメーカー名(2 オクテット) LMP/PAL_Subversion コントローラ内の現在の LMP/PAL のサブバージョン(2 オクテット)

Read RSSI (0x0D)

説明 Received Signal Strength Indication(RSSI)の値を BACI コントローラから読み出します。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

15

パラメータ

Connection Context:2 オクテット 値 パラメータの説明 0x00-0xFF Connection Context(コネクションハンドル)で接続の終了をアプリケーションに

通知します。 イベント/戻り値

RSSI 値を示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ:

Command Code:1 オクテット

値 パラメータの説明 Read_RSSI (0x0D) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x03 戻り値の長さ

Command Parameter:

値 パラメータの説明 Handle コネクションハンドル(2 オクテット) RSSI RSSI 値(1 オクテット)

値の範囲:-127~+20、+127(符号付き整数) 単位:dBm

Config Tx Power (0x0E)

説明 LE アドバタイズ/コネクションチャネルのパケットの送信に使用する送信電力レベルを設定します。

パラメータ TxPowerType:

値 パラメータの説明 1 オクテット アドバタイズチャネルの送信電力(0x00)

コネクションチャネルの送信電力(0x01)

TxPower: 値 パラメータの説明 2 オクテット 送信電力(レジスタ値)

RF レジスタの値に従って、この値が決定されます。 【例】

Read RF Reg コマンド(Address:0x003F): 01 14 02 3F 00 を実行した際の Command Complete Event が以下の場合: Read Value:0x00003DA6): 04 03 07 14 00 04 A6 3D 00 00 以下のように Tx Power が求められます。 N ← (0x00003DA6 & 0x0000FF00) >> 8 TX Power Value

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

16

0 dBm: 0x003D (← N ) -6 dBm: 0x001E (← N / 2) -12 dBm: 0x000F (← N / 4) -18 dBm: 0x0007 (← N / 8)

(注)RF レジスタの値は、LSI サンプル毎に異なります。

イベント/戻り値

Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Config Tx Power (0x0E) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x00 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし

Configure (0x0F)

説明 GAP、GATT サービスコンフィグレーションおよびその他のコンフィグレーションに必要な設定を指定して BACI コントロー

ラを構成します。

パラメータ Role:1 オクテット

値 パラメータの説明 0x00 セントラル。スキャン用パラメータを使用します。 0x01 ペリフェラル。アドバタイズ用パラメータを使用してアドバタイズを開始します。

アドバタイズ用パラメータ(ペリフェラル用):15 オクテット

値 パラメータの説明 2 オクテット Advertising_Interval_Min 2 オクテット Advertising_Interval_Max 1 オクテット Advertising_Type 1 オクテット Own_Address_Type 1 オクテット Direct_Address_Type 6 オクテット Direct_Address 1 オクテット Advertising_Channel_Map 1 オクテット Advertising_Filter_Policy

スキャン用パラメータ(セントラル用):7 オクテット

値 パラメータの説明

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

17

1 オクテット Scan_Type 2 オクテット Scan_Interval 2 オクテット Scan_window 1 オクテット Scan_own_address_type 1 オクテット Scan_filter_policy

Connection パラメータ(将来の使用のため予約):25 オクテット

値 パラメータの説明 2 オクテット Connection_scan_interval 2 オクテット Connection_scan_window 1 オクテット Initiator_filter_policy 1 オクテット Peer_address_type 6 オクテット Peer_BD_address 1 オクテット Own_address_type 2 オクテット Connection_interval_min 2 オクテット Connection_interval_max 2 オクテット Connection_latency 2 オクテット Supervision_timeout 2 オクテット Maximum_ce_length 2 オクテット Minimum_ce_length

イベント/戻り値

なし

Read EEPROM (0x10)

説明 コントローラから EEPROM データを読み出します。本コマンドを使用する前に、Enable_I2C コマンドで EEPROM へのア

クセスを有効にしておく必要があります。

パラメータ StartAddress:

値 パラメータの説明 4 オクテット 先頭アドレス

Length:

値 パラメータの説明 1 オクテット 読み出すデータの長さ 大 24 オクテット

イベント/戻り値

ステータス、読み出しデータ長、データを示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Read EEPROM (0x10) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

18

Command Parameter Length: 値 パラメータの説明 0xXX <Length>は対応する Read EEPROM コマンドで定義されます。

Command Parameter:

値 パラメータの説明 0xXX * <Length> 指定した EEPROM アドレスから読み出すデータの長さ

Write EEPROM (0x11)

説明 EEPROM データをコントローラに書き込みます。本コマンドを使用する前に、Enable_I2C コマンドで EEPROM へのアク

セスを有効にしておく必要があります。

パラメータ StartAddress:

値 パラメータの説明 4 オクテット 先頭アドレス

Length:

値 パラメータの説明 1 オクテット 書き込むデータの長さ

データ:

値 パラメータの説明 可変( 大 24 バイト) 書き込むデータ

イベント/戻り値

ステータス、正常に書き込めたデータの長さを示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ:

Command Code:1 オクテット

値 パラメータの説明 Write EEPROM (0x11) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00 Write EEPROM コマンドが成功 0x01 EEPROM が未接続 0x02 接続された EEPROM が無効

Command Parameter Length:

値 パラメータの説明 0x00 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし

Read BB Reg (0x12)

説明 ベースバンド(BB)レジスタの値を読み出します。

パラメータ

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

19

BBRegAddress: 値 パラメータの説明 2 オクテット BB レジスタのアドレス

イベント/戻り値

ステータス、BB レジスタの値を示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Read_BB_Reg (0x12) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x02 戻り値の長さ

Command Parameter:

値 パラメータの説明 0xXXXX BB レジスタから読み出した値

Write BB Reg (0x13)

説明 ベースバンド(BB)レジスタに値を書き込みます。

パラメータ BBRegAddress:

値 パラメータの説明 2 オクテット BB レジスタのアドレス

値:

値 パラメータの説明 2 オクテット BB レジスタの値

イベント/戻り値

ステータスを示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ:

Command Code:1 オクテット

値 パラメータの説明 Write_BB_Reg (0x13) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

20

Command Parameter Length:

値 パラメータの説明 0x00 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし

Read RF Reg (0x14)

説明 RF レジスタの値を読み出します。

パラメータ RFRegAddress:

値 パラメータの説明 2 オクテット RF レジスタのアドレス

イベント/戻り値

ステータス、RF レジスタの値を示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Read_RF_Reg (0x14) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x04 戻り値の長さ

Command Parameter:

値 パラメータの説明 0xXXXXXXXX RF レジスタから読み出した値

Write RF Reg (0x15)

説明 RF レジスタに値を書き込みます。

パラメータ RFRegAddress:

値 パラメータの説明 1 オクテット RF レジスタのアドレス

値:

値 パラメータの説明 4 オクテット RF レジスタの値

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

21

イベント/戻り値

ステータスを示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Write_RF_Reg (0x15) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x00 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし

RF Set Tx HOP (0x16)

説明 DTM テスト中の全チャネルに対するホッピングの有効・無効を指定します。本コマンドは DTM テストの開始前に送信して

ください。 パラメータ

Hop: 値 パラメータの説明 1 オクテット 全チャネルに対するホッピング無効(0x00)(デフォルト)

全チャネルに対するホッピング有効(0x01) イベント/戻り値

ステータスを示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 RF_Set_Tx_Hop (0x16) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x00 戻り値の長さ

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

22

Command Parameter: 値 パラメータの説明 なし

Read Platform Reg (0x17)

説明 プラットフォームレジスタの値を読み出します。

パラメータ PFRegAddress:

値 パラメータの説明 4 オクテット プラットフォームレジスタのアドレス

イベント/戻り値

ステータス、プラットフォームレジスタの値を示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Read_Platform_Reg (0x17) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x04 戻り値の長さ

Command Parameter:

値 パラメータの説明 0xXXXXXXXX プラットフォームレジスタから読み出した値

Write Platform Reg (0x18)

説明 プラットフォームレジスタに値を書き込みます。

パラメータ PFRegAddress:

値 パラメータの説明 4 オクテット プラットフォームレジスタのアドレス

値:

値 パラメータの説明 4 オクテット プラットフォームレジスタの値

イベント/戻り値

ステータスを示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ:

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

23

Command Code:1 オクテット 値 パラメータの説明 Write_Platform_Reg (0x18) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x00 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし

Write Config Complete (0x19)

説明 コントローラに Config 書き込みが完了したことを指示します。

パラメータ type:

値 パラメータの説明 1 オクテット 0x00:CONFIG データを使用

イベント/戻り値

ステータスを示す Start Up イベントが生成されます。 Read Config (0x1A)

説明 コントローラから Config データを読み出します。

パラメータ StartAddress:

値 パラメータの説明 4 オクテット オフセットアドレス

Length:

値 パラメータの説明 1 オクテット 読み出すデータの長さ( 大 24 オクテット)

イベント/戻り値

ステータス、読み出しデータ長、データを示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Read_config (0x1A) コマンドコード

Status:1 オクテット

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

24

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0xXX <Length>は対応する Read Config コマンドで定義されます。

Command Parameter:

値 パラメータの説明 0xXX * <Length> 指定した Config オフセットアドレスから読み出すデータの長さ

Write Config (0x1B)

説明 Config データをコントローラに書き込みます。

パラメータ StartAddress:

値 パラメータの説明 4 オクテット オフセットアドレス

Length:

値 パラメータの説明 1 オクテット 書き込む Config データの長さ

データ:

値 パラメータの説明 可変( 大 24 バイト) 書き込む Config データ

イベント/戻り値

ステータス、正常に書き込めたデータの長さを示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Write_config (0x1B) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x00 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

25

Enable_I2C (0x1C)

説明 I2C デバイスのサポートの有効・無効を指定します。 (注)EEPROM が接続されていない場合は、本コマンドは実行しないで下さい。

パラメータ enable:

値 パラメータの説明 1 オクテット I2C デバイスのサポート無効(0x00)(デフォルト)

I2C デバイスのサポート有効(0x01) イベント/戻り値

ステータスを示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Enable_I2C (0x1C) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x00 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし

GET EEPROM Status (0x1D)

説明 EEPROM の状態を取得します。戻り値のステータスが 0x3 (EEPROM_PIN_NOT_ENABLED)の場合は、Enable_I2C コ

マンドを実行後、再度、本コマンドでステータスを確認してください。

パラメータ なし

イベント/戻り値 ステータスを示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Get_eeprom_status (0x1D) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

26

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x01 戻り値の長さ

Command Parameter:

値 パラメータの説明 0x00 EEPROM_ENABLED_VALID 0x01 EEPROM_NOT_CONNECTED 0x02 EEPROM_NOT_ENABLED 0x03 EEPROM_ PIN_NOT_ENABLED/EEPROM_NOT_CONNECTED

White_list (0x20)

説明 Bluetooth 仕様で定義されている以下のホワイトリスト関連 HCI コマンドをカプセル化します。 • LE Clear White List コマンド • LE Add Device to White List コマンド • LE Remove Device from White List コマンド (注) BACI モードでは、ホワイトリストに追加できるデバイス数は1です。

パラメータ

Command Mode:1 オクテット 値 パラメータの説明 0 LE Clear White List コマンド 1 LE Add Device to White List コマンド 2 LE Remove Device from White List コマンド

address_type:1 オクテット

値 パラメータの説明 0 パブリックアドレス 1 ランダムアドレス

Address:6 オクテット

値 パラメータの説明 0xXXXXXXXXXXXX address_type で指定したパブリックアドレスまたはランダムアドレス

注:address と address_type フィールドは Add Device to White List コマンドおよび Remove Device from White List コマン

ドでのみ使用されます。 イベント/戻り値

Command Complete イベントが生成され、成功または失敗を通知します。ステータスを示すホワイトリスト固有のイベントが

イベントパラメータとして返されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 White_list(0x20) コマンドコード

Status:1 オクテット

値 パラメータの説明

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

27

0x00-0xFF 結果を示します。 0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x00 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし

Set_random_address (0x21)

説明 ローカルデバイスのランダムアドレスをセットします。

パラメータ Address:6 オクテット

値 パラメータの説明 0xXXXXXXXXXXXX ローカルデバイスのランダムアドレス

イベント/戻り値

Command Complete イベントが生成され、成功または失敗を通知します。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Set_random_address (0x21) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功 上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x00 戻り値の長さ

Command Parameter:

値 パラメータの説明 なし

Set_adv_scan (0x22)

説明 アドバタイズ、スキャンの有効・無効を指定します。

パラメータ CommandMode:1 オクテット

値 パラメータの説明 0 アドバタイズ

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

28

1 スキャン

Enable:1 オクテット 値 パラメータの説明 0 アドバタイズ、スキャン無効 1 アドバタイズ、スキャン有効

Filter_duplicates:1 オクテット

値 パラメータの説明 0 重複フィルタリング無効 1 重複フィルタリング有効

注:Filter duplicates パラメータはスキャニング時のみ有効です。

イベント/戻り値 なし

Set_adv_data (0x23)

説明 アドバタイズするデータをセットします。

パラメータ Adv_data_type:1 オクテット

値 パラメータの説明 0 または 1 0:アドバタイズするデータ

1:スキャンレスポンスデータ

Adv_data_len:1 オクテット 値 パラメータの説明 0-31 アドバタイズするデータ中の有効オクテット数

Adv_data:0~31 オクテット

値 パラメータの説明 アドバタイズするデータ

イベント/戻り値

なし

Connect_cancel (0x24)

説明 開始されている Create コマンドを中止します。

パラメータ なし

イベント/戻り値 Connection Complete イベントが生成されます。

Encrypt (0x25)

説明 コマンドによって与えられたキーを使用してコマンド中のデータの暗号化をコントローラに要求し、暗号化されたデータを

ホストに返します。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

29

パラメータ

Key:16 オクテット 値 パラメータの説明 0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

コマンド中のデータの暗号化に使用する 128 ビットのキー

Data:16 オクテット

値 パラメータの説明 0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

暗号化を要求された 128 ビットのデータブロック

イベント/戻り値

ステータス、暗号化されたデータを示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Encrypt (0x25) コマンドコード

Status:1 オクテット

値 パラメータの説明 0xXX 0x00Encrypt コマンド成功

0x01-0xFFRand コマンド失敗 Bluetooth Specification Volume-2 Part D で指定されたエラーコード

Command Parameter Length:

値 パラメータの説明 0x10 戻り値の長さ

Encrypted_Data:

値 パラメータの説明 0xXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXX

128 ビットの暗号化されたデータブロック

Rand (0x26)

説明 ホストに送信する 8 オクテットのランダムデータの生成をコントローラに要求します。

パラメータ なし

イベント/戻り値

ステータス、乱数を示す Command Complete イベントが生成されます。 Command Complete イベントのパラメータ: Command Code:1 オクテット

値 パラメータの説明 Rand (0x26) コマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 0x00Rand コマンド成功

0x01-0xFFRand コマンド失敗 Bluetooth Specification (Volume 2, Part D)で定義されたエラーコード

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

30

Command Parameter Length:

値 パラメータの説明 0x08 戻り値の長さ

Random_Number:

値 パラメータの説明 0xXXXXXXXXXXXXXXXX 乱数

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

31

BACIデータ

BLE_ATT_DATA_EVENT (0x01)

説明 ローカルまたはピアデバイスによる ATT プロトコル実行により ATT プロトコルイベントが発生したことを通知する ATT イベ

ントです。

パラメータ att_id:1 オクテット

値 パラメータの説明 0x00-0xFF ATT ハンドルのインデックス

注:ATT プロトコルで 1 つの接続のみサポートする構成になっている場合、

「att_id」は 0x00 にセットされます。 アプリケーション処理 BLE_ATT_DATA_EVENT は、

BLE_ATT_DATA_COMMAND を使用して送信された関連 ATT メッセージ中の

ATT ハンドルと同じインデックス’att_id’を使用します。

device_id:1 オクテット 値 パラメータの説明 0x00-0xFF ローカルデバイスに接続されたピア Bluetooth デバイスのデバイスハンドル。す

べてのBluetoothデバイス接続に対し、デバイスハンドルは HCIのConnection Complete イベントのデータの一部として通知されます。

att_event:1 オクテット

値 パラメータの説明 イベント ID/コード ATT プロトコルのイベントコード。BACI の ATT イベントリストを参照してくださ

い。

event_result:2 オクテット 値 パラメータの説明 結果コード ヘッダファイル BT_att_api.h と BT_error.h で定義した API SUCCESS、ATT プ

ロトコルのエラーコード、内部エラーコード

datalen:1 オクテット 値 パラメータの説明 0x00-BLE_MAX_ATT_PDU_EVT_LEN (50)

event_data パラメータ中のバイト数

event_data:BLE_MAX_ATT_PDU_EVENT_LEN

値 パラメータの説明 datalen バイト( 大 BLE_MAX_ATT_PDU_ EVT_LEN = 50)

ATT イベントコードに対応したデータバイト。BACI の ATT コマンド/イベントリ

ストを参照してください。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

32

BACI ATTイベントリスト

ATT イベント (イベントコード)

説明 イベントデータ

ATT_CONNECTION_IND (0x81)

Connection Complete 時 BD_ADDR(6 オクテット) Address type(1 オクテット)

ATT_DISCONNECTION_IND (0x82)

Disconnection Complete 時 BD_ADDR(6 オクテット) Address type(1 オクテット)

ATT_ERROR_RSP (0x01)

ATT Error Response PDU Req_OpCode(1 オクテット) Attribute Handle(2 オクテット) Error Code(1 オクテット)

ATT_XCNHG_MTU_REQ (0x02)

ATT Exchange MTU Request PDU Client Rx MTU(2 オクテット)

ATT_XCHNG_MTU_RSP (0x03)

ATT Exchange MTU Response PDU Server Tx MTU(2 オクテット)

ATT_FIND_INFO_REQ (0x04)

ATT Find Information Request PDU Start Handle(2 オクテット) End Handle(2 オクテット)

ATT_FIND_INFO_RSP (0x05)

ATT Find Information Response PDU UUID Format(1 オクテット)

(0x01:16 ビット UUID、0x02:128 ビット UUID) ハンドルと UUID のペア(4~(ATT_MTU-2)オクテット)

Handle(2 オクテット) UUID(UUID Format の設定による)(2 または 16 オクテット)

ATT_FIND_BY_TYPE_VAL_REQ (0x06)

ATT Find By Type Value Request PDU Start Handle(2 オクテット) End Handle(2 オクテット) Attribute Type (UUID)(2 オクテット) Attribute Value(0~(ATT_MTU-7)オクテット)

ATT_FIND_BY_TYPE_VAL_RSP (0x07)

ATT Find By Type Value Response PDU Handle Information List(4~(ATT_MTU-2)オクテット)

Start Handle(2 オクテット) End Handle(2 オクテット)

ATT_READ_BY_TYPE_REQ (0x08)

ATT Read By Type Request PDU Start Handle(2 オクテット) End Handle(2 オクテット) UUID(UUID Format の設定による)(2 または 16 オクテット)

ATT_READ_BY_TYPE_RSP (0x09)

ATT Read By Type Response PDU Length(1 オクテット) Attribute Data List(2~(ATT_MTU-2)オクテット)

Attribute Handle(2 オクテット) Attribute Value((Length-2)オクテット)

ATT_READ_REQ (0x0A)

ATT Read Request PDU Attribute Handle(2 オクテット)

ATT_READ_RSP (0x0B)

ATT Read Response PDU Attribute Value(0~(ATT_MTU-1)オクテット)

ATT_READ_BLOB_REQ (0x0C)

ATT Read Blob Request PDU Attribute Handle(2 オクテット) Value Offset(2 オクテット)

ATT_READ_BLOB_RSP (0x0D)

ATT Read Blob Response PDU Part Attribute Value(0~(ATT_MTU-1)オクテット)

ATT_READ_MULTIPLE_REQ (0x0E)

ATT Read Multiple Request PDU Set Of Handles(4~(ATT_MTU-1)オクテット)

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

33

ATT イベント (イベントコード)

説明 イベントデータ

各ハンドル(2 オクテット) ATT_READ_MULTIPLE_RSP (0x0F)

ATT Read Multiple Response PDU Set Of Values(0~(ATT_MTU-1)オクテット)

ATT_READ_BY_GROUP_TYPE_REQ (0x10)

ATT Read Group Type Request PDU Start Handle(2 オクテット) End Handle(2 オクテット) UUID(2 または 16 オクテット)

ATT_READ_BY_GROUP_TYPE_RSP (0x11)

ATT Read Group Type Response PDU Length(1 オクテット) Attribute Data List(2~(ATT_MTU-2)オクテット)

Start Handle(2 オクテット) End Handle(2 オクテット) Attribute Value((Length-4)オクテット)

ATT_WRITE_REQ (0x12)

ATT Write Request PDU Attribute Handle(2 オクテット) Attribute Value(0~(ATT_MTU-3)オクテット)

ATT_WRITE_RSP (0x13)

ATT Write Response PDU なし

ATT_WRITE_CMD (0x52)

ATT Write Command PDU Attribute Handle(2 オクテット) Attribute Value(0~(ATT_MTU-3)オクテット)

ATT_SIGNED_WRITE_CMD (0xD2)

ATT Signed Write Command PDU Attribute Handle(2 オクテット) Attribute Value(0~(ATT_MTU-15)オクテット) Authentication Signature(12 オクテット)

(注)本イベントは未サポートです。

ATT_PREPARE_WRITE_REQ (0x16)

ATT Prepare Write Request PDU Attribute Handle(2 オクテット) Value Offset(2 オクテット) Part Attribute Value(0~(ATT_MTU-5)オクテット)

ATT_PREPARE_WRITE_RSP (0x17)

ATT Prepare Write Response PDU Attribute Handle(2 オクテット) Value Offset(2 オクテット) Part Attribute Value(0~(ATT_MTU-5)オクテット)

ATT_EXECUTE_WRITE_REQ (0x18)

ATT Execute Write Request PDU Flags(1 オクテット)

ATT_EXECUTE_WRITE_RSP (0x19)

ATT Execute Write Response PDU なし

ATT_HANDLE_VALUE_NTF (0x1B)

ATT Handle Value Notification PDU Attribute Handle(2 オクテット) 現在の Attribute 値(0~(ATT_MTU-3)オクテット)

ATT_HANDLE_VALUE_IND (0x1D)

ATT Handle Value Indication PDU Attribute Handle(2 オクテット) 現在の Attribute 値(0~(ATT_MTU-3)オクテット)

ATT_HANDLE_VALUE_CNF (0x1E)

ATT Handle Value Confirmation PDU なし

ATT_UNKNOWN_PDU_IND (0xFF)

不明または未処理 PDU なし

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

34

BLE_ATT_DATA_COMMAND (0x02)

説明 データに含まれる ATT PDU タイプに基づき ATT プロトコル実行を開始する ATT コマンドです。

パラメータ att_id:1 オクテット

値 パラメータの説明 0x00-0xFF ATT ハンドルのインデックス

注:ATT プロトコルで 1 つの接続のみサポートする構成になっている場合、

「att_id」は 0x00 にセットされます。 新規接続に対しては、アプリケーションはATT_CONNECTION_INDイベントに

より BLE_ATT_DATA_EVENT メッセージの一部として「att_id」を受け取りま

す。

device_id:1 オクテット 値 パラメータの説明 0x00-0xFF ローカルデバイスに接続されたピア Bluetooth デバイスのデバイスハンドル。す

べてのBluetoothデバイス接続に対し、デバイスハンドルは HCIのConnection Complete イベントのデータの一部として通知されます。

pdu_id:1 オクテット

値 パラメータの説明 コマンド ID/コード ATT Command PDU。BACI の ATT コマンドリストを参照してください。

datalen:1 オクテット

値 パラメータの説明 0x00- BLE_MAX_ATT_PDU_CMD_LEN (50)

event_data パラメータ中のバイト数

event_data:BLE_MAX_ATT_PDU_COMMAND_LEN

値 パラメータの説明 datalen バイト ( 大 BLE_MAX_ATT_PDU_ CMD_LEN = 50)

ATT コマンドコードに対応したデータバイト BACI の ATT コマンド/イベントリス

トを参照してください。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

35

BACI ATTコマンドリスト

ATT コマンド (コマンドコード)

説明 イベントデータ

ATT_ERROR_RSP (0x01)

ATT Error Response PDU Attribute Handle(2 オクテット) Req_OpCode(1 オクテット) Error Code(1 オクテット)

ATT_XCNHG_MTU_REQ (0x02)

ATT Exchange MTU Request PDU Client Rx MTU(2 オクテット)

ATT_XCHNG_MTU_RSP (0x03)

ATT Exchange MTU Response PDU Server Rx MTU(2 オクテット)

ATT_FIND_INFO_REQ (0x04)

ATT Find Information Request PDU Start Handle(2 オクテット) End Handle(2 オクテット)

ATT_FIND_INFO_RSP (0x05)

ATT Find Information Response PDU UUID Format(1 オクテット)

(0x01:16 ビット UUID、0x02:128 ビット UUID) Don’t care(1 オクテット) Count (ハンドルと UUID ペアの数)(2 オクテット) ハンドルと UUID のペア(4~(ATT_MTU-2)オクテット)

Handle(2 オクテット) UUID(UUID Format の設定による)(2 または 16 オクテット)

ATT_FIND_BY_TYPE_VAL_REQ (0x06)

ATT Find By Type Value Request PDU UUID(2 オクテット) Start Handle(2 オクテット) End Handle(2 オクテット) Length of Attribute Value(2 オクテット) Attribute Value(0~(ATT_MTU-7)オクテット)

ATT_FIND_BY_TYPE_VAL_RSP (0x07)

ATT Find By Type Value Response PDU Count (ハンドルと UUID ペアの数)(2 オクテット) Handle Information List(4~(ATT_MTU-2)オクテット)

Start Handle(2 オクテット) End Handle(2 オクテット)

ATT_READ_BY_TYPE_REQ (0x08)

ATT Read By Type Request PDU Start Handle(2 オクテット)

End Handle(2 オクテット) UUID Format(1 オクテット) UUID(UUID Format の設定による)(2 または 16 オクテット)

ATT_READ_BY_TYPE_RSP (0x09)

ATT Read By Type Response PDU Actual count(Don’t Care)(2 オクテット)

Count(リスト中のペアの数)(2 オクテット) Attribute Data List(2~(ATT_MTU-2)オクテット)

Attribute Handle(2 オクテット) Attribute Value Length(2 オクテット) Attribute Value(variable オクテット)

ATT_READ_REQ (0x0A)

ATT Read Request PDU Attribute Handle(2 オクテット)

ATT_READ_RSP (0x0B)

ATT Read Response PDU Attribute Value Length(2 オクテット) Attribute Value(0~(ATT_MTU-1)オクテット)

ATT_READ_BLOB_REQ (0x0C)

ATT Read Blob Request PDU Attribute Handle(2 オクテット) Value Offset(2 オクテット)

ATT_READ_BLOB_RSP (0x0D)

ATT Read Blob Response PDU Attribute Value Length(2 オクテット)

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

36

ATT コマンド (コマンドコード)

説明 イベントデータ

Part Attribute Value(0~(ATT_MTU-1)オクテット) ATT_READ_MULTIPLE_REQ (0x0E)

ATT Read Multiple Request PDU Count (ハンドルの数)(2 オクテット)

Handles Information List(4~(ATT_MTU-2)オクテット) 各ハンドル(2 オクテット)

ATT_READ_MULTIPLE_RSP (0x0F)

ATT Read Multiple Response PDU Count (Values の数)(2 オクテット) Set Of Values(0~(ATT_MTU-1)オクテット)

Value Length(2 オクテット) Value(variable オクテット)

ATT_READ_BY_GROUP_TYPE_REQ (0x10)

ATT Read Group Type Request PDU Start Handle(2 オクテット) Handle(2 オクテット) UUID Format(1 オクテット) UUID(2 または 16 オクテット)

ATT_READ_BY_GROUP_TYPE_RSP (0x11)

ATT Read Group Type Response PDU Actual count(2 オクテット)(Don’t care)

Count(2 オクテット) Length(2 オクテット) Attribute Data List(2~(ATT_MTU-2)オクテット)

Start Handle(2 オクテット) End Handle(2 オクテット) Attribute Value((Length-4)オクテット)

ATT_WRITE_REQ (0x12)

ATT Write Request PDU Attribute Handle(2 オクテット) Value Length(2 オクテット) Attribute Value(0~(ATT_MTU-3)オクテット)

ATT_WRITE_RSP (0x13)

ATT Write Response PDU なし

ATT_WRITE_CMD (0x52)

ATT Write Command PDU Attribute Handle(2 オクテット) Value Length(2 オクテット) Attribute Value(0~(ATT_MTU-3)オクテット)

ATT_SIGNED_WRITE_CMD (0xD2)

ATT Signed Write Command PDU Attribute Handle(2 オクテット) Value Length(2 オクテット) Attribute Value(0~(ATT_MTU-15)オクテット) Authentication Signature(12 オクテット)

(注)本コマンドは未サポートです。 ATT_PREPARE_WRITE_REQ (0x16)

ATT Prepare Write Request PDU Value Offset(2 オクテット) Attribute Handle(2 オクテット) Value Length(2 オクテット) Part Attribute Value(0~(ATT_MTU-5)オクテット)

ATT_PREPARE_WRITE_RSP (0x17)

ATT Prepare Write Response PDU Value Offset(2 オクテット) Attribute Handle(2 オクテット) Value Length(2 オクテット) Part Attribute Value(0~(ATT_MTU-5)オクテット)

ATT_EXECUTE_WRITE_REQ (0x18)

ATT Execute Write Request PDU Flags(1 オクテット)

ATT_EXECUTE_WRITE_RSP (0x19)

ATT Execute Write Response PDU なし

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

37

ATT コマンド (コマンドコード)

説明 イベントデータ

ATT_HANDLE_VALUE_NTF (0x1B)

ATT Handle Value Notification PDU Attribute Handle(2 オクテット) Value Length(2 オクテット) 現在の Attribute 値(0~(ATT_MTU-3)オクテット)

ATT_HANDLE_VALUE_IND (0x1D)

ATT Handle Value Indication PDU Attribute Handle(2 オクテット) Value Length(2 オクテット) 現在の Attribute 値(0~(ATT_MTU-3)オクテット)

ATT_HANDLE_VALUE_CNF (0x1E)

ATT Handle Value Confirmation PDU なし

ATT_UNKNOWN_PDU_IND (0xFF)

不明または未処理 PDU なし

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

38

BLE_SMP_DATA_EVENT (0x03)

説明 ローカルまたはピアデバイスによる SMP プロトコル実行により SMP プロトコルイベントが発生したことを通知する SMP イ

ベントです。

パラメータ device_id:1 オクテット

値 パラメータの説明 0x00-0xFF ローカルデバイスに接続されたピア Bluetooth デバイスのデバイスハンドル。す

べての Bluetooth デバイス接続に対し、デバイスハンドルは Connection Complete イベントのデータの一部として通知されます。

smp_event:1 オクテット

値 パラメータの説明 イベント ID/コード SMP プロトコルのイベントコード。BACI の SMP イベントリストを参照してくださ

い。

event_result:2 オクテット 値 パラメータの説明 結果コード ヘッダファイル BT_smp_api.h と BT_error.h で定義した API SUCCESS、SMP

プロトコルのエラーコード、内部エラーコード

datalen:1 オクテット 値 パラメータの説明 0x00- BLE_MAX_SMP_PDU_ EVT_LEN (66)

event_data パラメータ中のバイト数

event_data:BLE_MAX_SMP_PDU_EVENT_LEN

値 パラメータの説明 datalen バ イ ト ( 大BLE_MAX_SMP_PDU_EVT_LEN = 66)

SMP イベントコードに対応したデータバイト。BACI の SMP イベントリストを参照

してください。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

39

BACI SMPイベントリスト

SMP イベント (SMP のイベントコード)

説明 イベントデータ

SMP_AUTHENTICATION_COMPLETE (0x01)

SMP コマンド

SMP_BACI_AUTHENTICATION_REQUEST への応答と

して、 確立されたセキュリティレベル(1 オクテット)

(1:MITM から保護されない、2:MITM から保護される)

ボンディング情報(1 オクテット) (0:ボンディングしない、1:ボンディングする)

ネゴシエートされた Encryption Key Size(1 オクテット) SMP コマンド SMP_BACI_ENCRYPTION_REQUEST へ

の応答として本イベントを受信した場合は、event_data は適

用されず datalen は 0 となります。 SMP_AUTHENTICATION_REQUEST (0x02)

確立されたセキュリティレベル(1 オクテット) (1:MITM から保護されない、2:MITM から保護される)

ボンディング情報(1 オクテット) (0:ボンディングしない、1:ボンディングする)

ネゴシエートされた Encryption Key Size(1 オクテット) SMP_PASSKEY_ENTRY_REQUEST (0x03)

なし

SMP_PASSKEY_DISPLAY_REQUEST (0x04)

アンパックされた UINT32 型のパスキー(4 オクテット)

SMP_LONG_TERM_KEY_REQUEST (0x05)

RAND(8 オクテット) アンパックされた UINT16 型の Encrypted Diversifier(2 オ

クテット) SMP_KEY_EXCHANGE_INFO_REQUEST (0x06)

ネゴシエートされたローカルキー配布情報(1 オクテット) ビット 0:Local Encryption 情報 ビット 1:Local Identity 情報 ビット 2:Local Signature Key ビット 3-7:-

ネゴシエートされた Encryption Key Size が(1 オクテット) SMP_KEY_EXCHANGE_INFO (0x07)

Long Term Key(16 オクテット) パックされた UINT16 型 Encrypted Diversifier(2 オクテッ

ト) RAND(8 オクテット) Identity Resolving Key(16 オクテット) Identity Address 情報(7 オクテット) Address Type(第 1 オクテット)(1 オクテット) Bluetooth Device Address (Least Significant Octet First Order)(6 オクテット) Signature Resolving Key(16 オクテット) ネゴシエートされたリモートキー配布情報(1 オクテット)

ビット 0:Remote Encryption 情報 ビット 1:Remote Identity 情報 ビット 2:Remote Signature Key ビット 3-7:-

ネゴシエートされた Encryption Key Size(1 オクテット) SMP_RESOLVABLE_PVT_ADDR_CREATE_CNF(0x08)

作成された resolvable private address(6 オクテット)

SMP_RESOLVABLE_PVT_ADDR_VERIFY_CNF (0x09)

検証された resolvable private address(6 オクテット)

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

40

BLE_SMP_DATA_COMMAND (0x04)

説明 データに含まれる、SMP で定義された PDU タイプに基づいて SMP プロトコル実行を開始する SMP コマンドです。

パラメータ device_id:1 オクテット

値 パラメータの説明 0x00-0xFF ローカルデバイスに接続されたピア Bluetooth デバイスのデバイスハンドル。す

べての Bluetooth デバイス接続に対し、デバイスハンドルは Connection Complete イベントのデータの一部として通知されます。

pdu_id:1 オクテット

値 パラメータの説明 コマンド ID/コード SMP Command PDUBACI の SMP コマンドリストを参照してください。

datalen:1 オクテット

値 パラメータの説明 0x00- BLE_MAX_SMP_PDU_ CMD_LEN (66)

event_data パラメータ中のバイト数

event_data:BLE_MAX_SMP_PDU_COMMAND_LEN

値 パラメータの説明 datalen バ イ ト ( 大 Max BLE_MAX_SMP_PDU_CMD_LEN = 66)

SMP コマンドコードに対応したデータバイト

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

41

BACI SMPコマンドリスト

SMP コマンド (SMP のコマンドコード)

説明 イベントデータ

BACI_SMP_AUTHENTICATION_ REQUEST (0x00)

セキュリティレベル(1 オクテット) (1:MITM から保護されない、2:MITM から保護される)

ボンディング(1 オクテット) (0:ボンディングしない、1:ボンディングする)

要求された Encryption Key Size(1 オクテット) ローカル IO Capability(1 オクテット) ローカル/リモートキー配布仕様(1 オクテット)

ビット 0:Local Encryption 情報 ビット 1:Local Identity 情報 ビット 2:Local Signature Key ビット 3:予約 ビット 4:Remote Encryption 情報 ビット 5:Remote Identity 情報 ビット 6:Remote Signature Key ビット 7:予約

対応する 大暗号化キーサイズ(1 オクテット) OOB データの有無(1 オクテット)

(0:OOB データなし、1:OOB データあり) OOB データ(16 オクテット)(上記オクテットが 1 の場合)

BACI_SMP_AUTHENTICATION_ REQUEST_REPLY (0x01)

セキュリティレベル(1 オクテット) (1:MITM から保護されない、2:MITM から保護される)

ボンディング(1 オクテット) (0:ボンディングしない、1:ボンディングする)

要求された Encryption Key Size(1 オクテット) 拒否コード(1 オクテット)

(0:Accept Auth Req、Error Code-Reject) ローカル IO Capability(1 オクテット) ローカル/リモートキー配布仕様(1 オクテット)

ビット 0:Local Encryption 情報 ビット 1:Local Identity 情報 ビット 2:Local Signature Key ビット 3:予約 ビット 4:Remote Encryption 情報 ビット 5:Remote Identity 情報 ビット 6:Remote Signature Key ビット 7:予約

対応した 大暗号化キーサイズ(1 オクテット) OOB データの有無(1 オクテット)

(0:OOB データなし、1:OOB データあり) OOB データ(16 オクテット)(上記オクテットが 1 の場合)

BACI_SMP_PASSKEY_ENTRY_ REQUEST_REPLY (0x02)

ステータス(1 オクテット) (1:肯定応答、0:否定応答)(上記オクテットが 1 の場合)

パックされた UINT32 型 10 進パスキー(4 オクテット) BACI_SMP_LONG_TERM_KEY_ REQUEST_REPLY (0x03)

ステータス(1 オクテット) (1:肯定応答、0:否定応答)

Long Term Key(16 オクテット)(上記オクテットが 1 の場合) BACI_SMP_KEY_EXCHANGE_ INFO_REQUEST_REPLY (0x04)

Long Term Key(16 オクテット) パックされた UINT16 型 Encryption Diversifier(2 オクテット) RAND(8 オクテット) Identity Resolving Key(16 オクテット) Identity Address 情報(7 オクテット)

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

42

SMP コマンド (SMP のコマンドコード)

説明 イベントデータ Address Type(第 1 オクテット)(1 オクテット) Bluetooth Device Address (Least Significant Octet First Order)(6 オ

クテット) Signature Resolving Key(16 オクテット)

BACI_SMP_RESOLVABLE_ PVT_ADDR_CREATE (0x05)

Identity Resolving Key(16 オクテット)

BACI_SMP_RESOLVABLE_ PVT_ADDR_VERIFY (0x06)

検証された BD アドレス(6 オクテット) Identity Resolving Key(16 オクテット)

BACI_SMP_ENCRYPTION_ REQUEST (0x07)

RAND(8 オクテット) パックされた UINT16 型 Encryption Diversifier(2 オクテット) Long Term Key(16 オクテット)

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

43

BLE_L2CAP_DATA_EVENT (0x05)

説明 ローカルまたはピアデバイスによる L2CAP プロトコル実行により L2CAP プロトコルイベントが発生したことを通知する

L2CAP イベントです。

パラメータ device_id: 1 オクテット

値 パラメータの説明 0x00-0xFF ローカルデバイスに接続されたピア Bluetooth デバイスのデバイスハンドル。す

べての Bluetooth デバイス接続に対し、デバイスハンドルは Connection Complete イベントのデータの一部として通知されます。

l2cap_event: 1 オクテット

値 パラメータの説明 イベント ID/コード L2CAP プロトコルのイベントコード。BACI の L2CAP イベントリストを参照してく

ださい。

datalen: 1 オクテット 値 パラメータの説明 0x00- BLE_MAX_SMP_PDU_ EVT_LEN (10)

event_data パラメータ中のバイト数

event_data: BLE_MAX_L2CAP_PDU_EVENT_LEN

値 パラメータの説明 datalen バ イ ト ( 大BLE_MAX_L2CAP_PDU_EVT_LEN = 10)

L2CAP イベントコードに対応したデータバイト。BACI の L2CAP イベントリスト

を参照してください。

BACI L2CAPイベントリスト

L2CAP イベント (L2CAP イベントコード)

説明 イベントデータ

L2CAP_CONNECTION_UPDATE_REQUEST_EVENT (0x01)

length(2 オクテット) Minimum Connection Interval(2 オクテット) Maximum Connection Interval(2 オクテット) Slave Latency(2 オクテット) Timeout Multiplier(2 オクテット) (注)本イベントは、ピアデバイス(BLE スレーブ)がコネ

クション・アップデートを要求した時に、BLE マスタ側で

受信されます。 L2CAP_CONNECTION_UPDATE_RESPONSE_EVENT (0x02)

length(2 オクテット) Result(2 オクテット) (注)本イベントは、ピアデバイス(BLE スレーブ)がコネ

クション・アップデートを要求した時に、BLE マスタ側で

受信されます。 L2CAP_COMMAND_REJECTED_EVENT (0x03) length(2 オクテット)

Reason(2 オクテット) Optional data, if any (注)本イベントは、ピアデバイス(BLE スレーブ)がコネ

クション・アップデートを要求した時に、BLE マスタ側で

受信されます。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

44

BLE_L2CAP_DATA_COMMAND (0x06)

説明 ピアデバイスにより開始された L2CAP プロトコル実行もしくは、プロトコルへの応答のために使われる L2CAP コマンドで

す。

パラメータ device_id: 1 オクテット

値 パラメータの説明 0x00-0xFF ローカルデバイスに接続されたピア Bluetooth デバイスのデバイスハンドル。す

べての Bluetooth デバイス接続に対し、デバイスハンドルは Connection Complete イベントのデータの一部として通知されます。

l2cap_command: 1 オクテット

値 パラメータの説明 コマンド ID/コード L2CAP プロトコルのコマンドコード。BACI の L2CAP コマンドリストを参照してく

ださい。

datalen: 1 オクテット 値 パラメータの説明 0x00- BLE_MAX_L2CAP_PDU_CMD_LEN (10)

event_data パラメータ中のバイト数

event_data: BLE_MAX_L2CAP_PDU_CMD_LEN

値 パラメータの説明 datalen バ イ ト ( 大BLE_MAX_L2CAP_PDU_CMD_LEN = 10)

L2CAP コマンドコードに対応したデータバイト。BACI の L2CAP コマンドリスト

を参照してください。

BACI L2CAPコマンドリスト

SMP Command (SMP Command Code)

Description Event Data

BACI_L2CAP_LE_CONN_PARAM_UPDATE_REQ (0x00)

Minimum Connection Interval(2 オクテット) Maximum Connection Interval(2 オクテット) Slave Latency(2 オクテット) Supervision Timeout Multiplier(2 オクテット) (注)本コマンドは、コネクション・アップデート開始時に BLEスレーブが使用します。

BACI_L2CAP_LE_CONN_PARAM_UPDATE_RSP (0x01)

Response(2 オクテット) (注)本コマンドは、コネクション・アップデート開始時に BLEスレーブが使用します。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

45

BACIイベント

Start Up (0x01)

説明 本イベントは、BACI コントローラが起動したことと現在の BACI コントローラの状態をアプリケーションプロセスに知らせま

す。起動状態が正常でない場合(0x00 以外)、コントローラは自動的に構成可能なモード(Init 状態)に遷移し、起動状態

に応じてホストがデバイスを設定するのを待ちます。構成が正常に完了すると、BT コントローラは起動状態を「正常」にセ

ットした Start Up イベントを生成します。

パラメータ Startup State:1 オクテット

値 パラメータの説明 0x00-0x04 Bit6-0 : BACI コントローラの状態を示します。

0x00:正常に起動した 0x01:Get Config パラメータを要求、EEPROM 未接続 0x02:Get Config パラメータを要求、EEPROM 接続状態 0x03:RAM_IMAGE_SIZE_BIG 0x04:RAM_IMAGE_CHECKSUM_FAILED

Bit7 : SPI クロック極性の設定状態を示します。 0:立下がりエッジ 1:立ち上がりエッジ ( 注 ) Read Local Version Information コ マ ン ド で 取 得 で き る LMP/PAL_subversion (LSI Version) が 0x1402 よりも古い場合は、Bit7 は

0 となります。 Command Status (0x02)

説明 本イベントは、コマンド処理の起動の結果をアプリケーションに知らせます。

パラメータ Command Code:1 オクテット

値 パラメータの説明 0xXX 有効なコマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。0x00:成功

Command Complete (0x03)

説明 本イベントは、コマンド処理の終了の結果をアプリケーションに知らせます。

パラメータ Command Code:1 オクテット

値 パラメータの説明 0xXX 有効なコマンドコード

Status:1 オクテット

値 パラメータの説明 0x00-0xFF 結果を示します。

0x00:成功

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

46

上記以外:Bluetooth Specification (Volume 2, Part D)で定義されたエラーコ

ード

Command Parameter Length: 値 パラメータの説明 0x00-0x20 戻り値の長さは実行したコマンドによります。

Command Parameter:

値 パラメータの説明 Any of max length 0x20 戻り値は実行したコマンドによります。

Echo (0x04)

説明 本イベントは BACI トランスポートレイヤのループバックテスト中に使用します。アプリケーションプロセッサは本コマンドを

使用してデータを送信します。コネクティビティプロセッサは対応する Echo イベント内の同じデータを送り返すことにより、

トランスポートレイヤが正しく機能していることを確認します。

パラメータ データ:1~20 オクテット

値 パラメータの説明 任意 任意のデータを送信できます。

Hardware Error (0x05)

説明 本イベントは BACI コントローラのハードウェア障害をアプリケーションに知らせます。 (注)本イベントは未サポートです。

パラメータ Reason:1 オクテット

値 パラメータの説明 0x01 – 0x0B PF_HCI_TRANSPORT_HW_ERROR_SYNC_LOST (0x01)

PF_HCI_TRANSPORT_HW_ERROR_UNKNOWN_PKT (0x02) PF_HCI_TRANSPORT_HW_ERROR_LENGTH_EXCEEDED (0x03) PF_HCI_TRANSPORT_HW_ERROR_CMD_NO_BUFFER (0X04) PF_HCI_TRANSPORT_HW_ERROR_ACL_NO_BUFFER (0X05) PF_HCI_TRANSPORT_HW_ERROR_SYNC_NO_BUFFER (0X06) PF_HCI_TRANSPORT_HW_ERROR_CMD_LENGTH_EXCEEDED (0X07) PF_HCI_TRANSPORT_HW_ERROR_ACL_LENGTH_EXCEEDED (0X08) PF_HCI_TRANSPORT_HW_ERROR_SYNC_LENGTH_EXCEEDED (0X09) PF_HCI_TRANSPORT_HW_ERROR_WRONG_PARAM_FOR_ACL_DATA (0x0A) PF_HCI_TRANSPORT_HW_ERROR_WRONG_PARAM_FOR_SYNC_DATA (0X0B)

Connection Complete (0x06)

説明 本イベントはピアデバイスとの接続が確立されたときにアプリケーションに送信されます。

パラメータ Status:1 オクテット

値 パラメータの説明 0x00-0xFF 0x00:接続は正常に終了

0x01-0xFF:接続の完了に失敗。エラーコードの一覧と解説については、

Bluetooth Specification p. 339、Part D 「Error Codes」を参照してください。

Connection_Handle:2 オクテット

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

47

値 パラメータの説明 0xXXXX 二台のBluetoothデバイス間の接続の識別に使用されるコネクションハンドル。

Connection_Handleはデータの送受信時の識別子として使用されます。 値の範囲:0x0000-0x0EFF(0x0F00-0x0FFFは将来の使用のため予約)

Device_id:1 オクテット

値 パラメータの説明 0xXX デバイス識別子

Peer_Address:6 オクテット

値 パラメータの説明 0xXXXXXXXXXXXX ピアデバイスのパブリックアドレスまたはランダムアドレス

Peer_Address_type:1 オクテット

値 パラメータの説明 0xXX 0x00:ピアデバイスはパブリックアドレスを使用している

0x01:ピアデバイスはランダムアドレスを使用している 0x02-0xFF:将来の使用のため予約。

Role:1 オクテット

値 パラメータの説明 0xXX 0x00:接続したデバイスはマスタ

0x01:接続したデバイスはスレーブ 0x02-0xFF:将来の使用のため予約。

Conn_Interval:2 オクテット

値 パラメータの説明 0xXXXX 本接続におけるコネクションインターバル

値の範囲:0x0006-0x0C80 Time = N * 1.25 msec 時間の範囲:7.5msec~4000msec

Conn_Latency:2 オクテット

値 パラメータの説明 0xXXXX 接続時のスレーブレイテンシー(コネクションイベントの数)

値の範囲:0x0000-0x01F3

Supervision_Timeout:2 オクテット 値 パラメータの説明 0xXXXX スーパービジョンタイムアウト

値の範囲:0x000A-0x0C80 Time = N * 10 msec 時間の範囲:100msec~32sec

Master Clock Accuracy:1 オクテット

値 パラメータの説明 0xXX 本パラメータはスレーブ時のみ有効です。マスタ時、本パラメータは0x00にセッ

トされます。 0x00:500 ppm 0x01:250 ppm 0x02:150 ppm 0x03:100 ppm 0x04:75 ppm 0x05:50 ppm

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

48

0x06:30 ppm 0x07:20 ppm 0x08-0xFF:将来の使用のため予約。

Disconnection Complete (0x07)

説明 本イベントはピアデバイスとの接続が喪失されたときにアプリケーションに送信されます。

パラメータ Reason:1 オクテット

値 パラメータの説明 0x00-0xFF 切断理由。エラーコードの一覧と解説については、Bluetooth Specification p.

339、Part D 「Error Codes」を参照してください。

Connection_Handle:2 オクテット 値 パラメータの説明 0xXXXX 二台のBluetoothデバイス間の接続の識別に使用されるコネクションハンドル。

Connection Update Complete (0x09)

説明 本イベントはピアデバイスとの接続の更新が完了したときにアプリケーションに送信されます。

パラメータ Status:1 オクテット

値 パラメータの説明 0x00-0xFF 0x0:Connection_Update コマンドは正常に終了。

0x1-0xFF:Connection_Updateコマンドの完了に失敗。エラーコードの一覧と

解説については、Bluetooth Specification p. 339、Part D 「Error Codes」を参

照してください。

Connection_Handle:2 オクテット 値 パラメータの説明 0xXXXX 二台のBluetoothデバイス間の接続の識別に使用されるコネクションハンドル。

Connection_Handleはデータの送受信時の識別子として使用されます。 値の範囲:0x0000-0x0EFF(0x0F00-0x0FFFは将来の使用のため予約)

Conn_Interval:2 オクテット

値 パラメータの説明 0xXXXX 本接続におけるコネクションインターバル

値の範囲:0x0006~0x0C80 Time = N * 1.25 msec 時間の範囲:7.5msec~4000msec

Conn_Latency:2 オクテット

値 パラメータの説明 0xXXXX 接続時のスレーブレイテンシー(コネクションイベントの数)

値の範囲:0x0000~0x01F3

Supervision_Timeout:2 オクテット 値 パラメータの説明 0xXXXX 本接続におけるスーパービジョンタイムアウト

値の範囲:0x000A~0x0C80 Time = N * 10 msec

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

49

時間の範囲:100msec~32sec Data Credit (0x0A)

説明 本イベントは、アプリケーションが送信したデータパケットの処理が正常に終了し、現在どれくらいのデータバッファ容量

が使用可能であるかをアプリケーションに知らせます。

パラメータ Credit:1 オクテット

値 パラメータの説明 0x00-0xFF アプリケーションに返される空きスペースの数

注:現在の実装ではデータフロー制御はサポートされていません。したがって、本イベントもサポートされておりません。

Advertising Report Event (0x0D)

説明 本イベントは、ローカルデバイスのスキャン開始後、Advertising Report を受信したときにアプリケーションに送信されま

す。

パラメータ BD_Address:6 オクテット

値 パラメータの説明 0xXXXXXXXXXXXX ピアデバイスのパブリックアドレスまたはランダムアドレス

BD_Address_type:1 オクテット

値 パラメータの説明 0xXX 0x00:ピアデバイスはパブリックアドレスを使用している

0x01:ピアデバイスはランダムアドレスを使用している 0x02-0xFF:将来の使用のため予約。

Adv_data_len:1 オクテット

値 パラメータの説明 0-31 アドバタイズするデータ中の有効オクテット数

Event_Type:1 オクテット

値 パラメータの説明 0x00-0x04 0x00:Connectable undirected advertising (ADV_IND).

0x01:Connectable directed advertising (ADV_DIRECT_IND) 0x02:Scannable undirected advertising (ADV_SCAN_IND) 0x03:Non connectable undirected advertising (ADV_NONCONN_IND) 0x04:Scan Response (SCAN_RSP)

RSSI:1 オクテット

値 パラメータの説明 0x00-0xFF 値の範囲:-127~+20

-127 の場合、RSSI は使用できません。 単位:dBm

Adv_data:0~31 オクテット

値 パラメータの説明 アドバタイズするデータ。Bluetooth Specification p. 375-378、Volume 3 Part

C「11 ADVERTISING AND SCAN RESPONSE DATA FORMAT」を参照して

ください。

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

50

フロー制御

コマンド

アプリケーションは未処理のコマンドを一つしか保持することができません。アプリケーションが次のコマンドを送信できる

ようになるのは、現在のコマンドの Command Complete または Command Status イベントの受信後です。 データ

データパケットのフロー制御には、Data Credit イベントを使用します。 アプリケーションプロセッサが送信できるデータパケット数は、現在使用可能なデータバッファ容量分のみです。 それ以上のパケットを送信しようとすると、BACI コントローラがエラーを返します。 注:現在の実装ではデータフロー制御はサポートされていません。

用語集

用語 説明 BACI Bluetooth Application Controller Interface HCI Host Controller Interface BLE Bluetooth Low Energy DTM Direct Test Mode GAP Generic Access Profile ATT Attribute Protocol GATT Generic Attribute Profile SM Security Manager CCC Client Characteristic Configuration

Bluetooth Application Controller Interface(BACI)コマンドマニュアル

51

改版履歴

ページ

ドキュメント No. 発行日 改版前 改版後

備考

FJXL7105_BACI_Manual-01

2013.05.31 - - 正式初版

FJXL7105_BACI_Manual-02

2015.03.11 59 61 第 2 版発行(注意書き入れ替え)