通信概要
キューブとの通信について
キューブとの通信は Bluetooth® 標準規格 Ver. 4.2（Bluetooth® Low Energy、以下 BLE）で行います。
キューブの発見
キューブは電源をいれると BLE ペリフェラル（Peripheral）として起動し、下記の情報をアドバタイズします。
| 定義 | 値 |
|---|---|
| Flags | General Discoverable Mode, BR/EDR Not Supported |
| Complete list of 128bit Service UUIDs | 10B20100-5B3B-4571-9508-CF3EFCD7BBAE |
| Shortened Local Name | toio-XXX |
Complete Local Name と Shortened Local Name についてUPDATED
キューブのシステムソフトウェア v02.0006（BLE プロトコルバージョン v2.4.0）から、Complete Local Name の代わりに Shortened Local Name がアドバタイズに含まれます。
Shortened Local Name は toio-XXX です。
Complete Local Name はキューブのシステムソフトウェア v02.0006（BLE プロトコルバージョン v2.4.0）からアドバタイズ情報に含まれなくなりました。
Complete Local Name は Generic Access サービスの Device Name 特性から読み出せます。
Complete Local Name は toio-XXX (toio Core Cube) です。
XXX にはキューブごとに固有の ID 文字列が入ります。 これは電源を入れなおしても不変な値のため、数十台同時にキューブを運用する際に個体識別の補助に役立ちます。 ID 文字列は、すべてのキューブで固有の値になることを保証するものではありません。 また、キューブに記載されたシリアル番号と同じ番号ではありません。
ID に使われる文字列は 3 桁の文字列で、アルファベット＋数字＋アルファベットの順番で構成されます。
アルファベットは大文字、小文字の両方が使用されます。
アルファベットのうち下記の文字は使用されません。
| ID に使用されないアルファベット |
|---|
| l,I,o,O,g,q,s,S,v,V,u,U,w,W,x,X,y,Y,z,Z |
| Shortened Local Name の例 |
|---|
| toio-M0p |
| toio-a9R |
| toio-C3P |
旧バージョン（システムソフトウェア v02.0005, BLE プロトコルバージョン v2.3.0）での Local Name
キューブのシステム ソフトウェア v02.0005（BLE プロトコルバージョン v2.3.0）では、アドバタイズに Complete Local Name が含まれます。
旧バージョンの Complete Local Name は toio Core Cube-XXX です。
キューブの機能の利用
キューブの各種機能は以下のサービス（service）とそこに含まれている特性（characteristic）を使うことで情報の取得や制御ができます。
| プロパティ | 値 |
|---|---|
| Type | Primary Service |
| Service UUID | 10B20100-5B3B-4571-9508-CF3EFCD7BBAE |
| Characteristics | ID Information / 読み取りセンサー |
| Sensor Information / モーションセンサー | |
| Button Information / ボタン | |
| Battery Information / バッテリー | |
| Motor Control / モーター | |
| Light Control / ランプ | |
| Sound Control / サウンド | |
| Configuration / 設定 |