Communication Overview
Communication with the cube
Communication with the cube is done via Bluetooth® standard Ver. 4.2 (Bluetooth® Low Energy, hereafter BLE).
Discovering the cube
When the cube is turned on, it runs as a BLE peripheral and advertises the following information.
| Definition | Value |
|---|---|
| Flags | General Discoverable Mode, BR/EDR Not Supported |
| Complete list of 128bit Service UUID | 10B20100-5B3B-4571-9508-CF3EFCD7BBAE |
| Shortened Local Name | toio-XXX |
Complete Local Name and Shortened Local Name
Since v02.0006 (BLE protocol version v2.4.0), the shortened local name is used in the advertisement packet instead of the complete local name.
The shortened local name is toio-XXX.
The complete local name has changed from v02.0006 (BLE protocol version v2.4.0), to toio-XXX (toio Core Cube).
Complete local name is read by the device name characteristic of the generic access.
XXX is a unique cube ID string. Because this remains the same even after the cube is reset, it is useful for identifying individual cubes when dozens of cubes are being operated simultaneously.
The ID string is not guaranteed to be a unique to every cube. It is also not the same number as the serial number printed on the cube.
The string used for the ID is a string of 3 alphanumeric characters consisting of a letter + number + letter in that order.
The letter can be uppercase or lowercase. The following letters are not used.
| Letters not used in ID |
|---|
| l,I,o,O,g,q,s,S,v,V,u,U,w,W,x,X,y,Y,z,Z |
| Examples of shortened local names |
|---|
| toio-M0p |
| toio-a9R |
| toio-C3P |
Complete Local name of the previous version (system software v02.0005, BLE protocol version v2.3.0)
The complete local name of v02.0005 (BLE protocol version v2.3.0) is toio Core Cube-XXX.
Using the cube's functions
Each type of function can be viewed or controlled through the following services and the characteristics under these services.
| Property | Value |
|---|---|
| Type | Primary Service |
| Service UUID | 10B20100-5B3B-4571-9508-CF3EFCD7BBAE |
| Characteristics | ID Information / Identification sensor |
| Sensor Information / Motion Sensor | |
| Button Information / Button | |
| Battery Information / Battery | |
| Motor Control / Motor | |
| Light Control / Indicator | |
| Sound Control / Sound | |
| Configuration |