Skip to main content
Version: 2.3.0

Identification sensor

The "Play mat" and "Various Cards/Sheets" included in the toio COLLECTION and the "Simple play mat" and "Simple card" included with the toio Core Cube (single package) are printed with special patterns. These patterns are called "toio ID". The "Identification sensor" on the bottom of the cube scans the unique information from the pattern and identifies its position on the object with the pattern printed (absolute position detection).

The information that the identification sensor scans from the toio ID can be obtained by using the following characteristics.

PropertyValue
Characteristic UUID10B20101-5B3B-4571-9508-CF3EFCD7BBAE
PropertiesRead, Notify
DescriptorID Information

toio ID types#

There are two types of toio ID, Position ID and Standard ID, and the information that can be obtained from each differs as shown below. For details, please refer to the respective pages.

toio ID typeExample of object with printed patternInformation that can be obtained
Position IDPlay mat included with the toio COLLECTION toio COLLECTION Play mat Simple play mat included with toio Core Cube (single package)

toio Core Cube (single package) Simple play mat
Position and angle of the cube
Standard IDVarious Cards and Sheets included in the toio COLLECTION toio COLLECTION Cards and Sheets Simple card included with the toio Core Cube (single package)

toio Core Cube (single package) Simple card
Unique values and angle of cube

Read operations#

Position ID#

The information that the cube receives from the Position ID can be obtained with the following configuration data. The interval and conditions for the notifications can be changed under Configuration - Identification sensor ID notification settings.

Data locationTypeContentExample
0UInt8Information type0x01 (Position ID)
1UInt16X coordinate value of the center of the cube0x02c5 (709)
3UInt16Y coordinate value of the center of the cube0x017f (383)
5UInt16Y coordinate value of the center of the cube0x0132 (306 degrees)
7UInt16X coordinate value of the identification sensor0x02bc (700)
9UInt16Y coordinate value of the identification sensor0x0182 (386)
11UInt16Y coordinate value of the identification sensor0x0132 (306 degrees)
note

Byte order is little-endian. For other ways the data structures are expressed see Function usage - Data structures.

Coordinates (X coordinate, Y coordinate)#

The X and Y coordinates indicate the cube's position at the Position ID. They are uniquely defined by toio ID, and are not expressed in millimeters. Refer to Hardware Specifications - Position ID for the actual coordinates that can be obtained.

Angle#

The angle is the orientation of the cube atop the Position ID. In the following figure, the X-axis direction is 0 degrees and clockwise is the positive direction. The range of values is 0 to 360 degrees.

ID detection angle

Standard ID#

The information that the cube receives from the Standard ID can be obtained with the following configuration data. The interval and conditions for the notifications can be changed under Configuration - Identification sensor ID notification settings.

Data locationTypeContentExample
0UInt8Information type0x02 (Standard ID)
1UInt32Standard ID value0x00380000
(3670016: Typhoon)
5UInt16cube angle0x0015 (21 degrees)
note

Byte order is little-endian. For other ways the data structures are expressed see Function usage - Data structures.

Standard ID values#

A unique value that does not depend on the position of the cube can be obtained from the Standard ID. This value can be used to determine the item on which the cube is placed. See Hardware Specifications - Standard ID for the actual values that can be obtained.

Angle of cube#

The angle of the cube is the orientation of the cube atop the Standard ID. Values range from 0 to 360 degrees.

Position ID missed#

Information indicating that the cube has been removed from atop the Position ID can be obtained with the following configuration data. The notification sensitivity can be changed under Configuration - Identification sensor ID missed notification settings.

Data locationTypeContentExample
0UInt8Information type0x03 (Position ID missed)

Standard ID missed#

Information indicating that the cube has been removed from atop the Standard ID can be obtained with the following configuration data. The notification sensitivity can be changed under Configuration - Identification sensor ID missed notification settings.

Data locationTypeContentExample
0UInt8Information type0x04 (Standard ID missed)

Notifications#

When the information scanning by the identification sensor changes, this property notifies the BLE central of this information. The notified information and data structure are the same as those obtained using the Read operations.