Skip to main content
Version: 2.4.0

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.

DefinitionValue
FlagsGeneral Discoverable Mode,
BR/EDR Not Supported
Complete list of 128bit Service UUID10B20100-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.

PropertyValue
TypePrimary Service
Service UUID10B20100-5B3B-4571-9508-CF3EFCD7BBAE
CharacteristicsID Information / Identification sensor
Sensor Information / Motion Sensor
Button Information / Button
Battery Information / Battery
Motor Control / Motor
Light Control / Indicator
Sound Control / Sound
Configuration