Advanced Setup

Bluetooth API Specification

The Atmocube transmits information wirelessly using BLE (Bluetooth Low Energy) messages. Any device with BLE capability, like a smartphone with the Atmocube app and e-ink screen, can receive these messages if they are within 10-15 meters of the Atmocube. This feature makes it easy to automate tasks without complicated authentication procedures. It's a convenient way to incorporate Atmocube into your automation setup.

Please note that device administrators can choose to turn off the BLE advertising using the Atmocube Configuration Tool.

v.1.3, 21-May-2023

Advertisement Packet Format

Len Type Description Value
2 0x01 Flags 0x06
10 0x09 Complete local name

0x435542455F0000

CUBE_0000

Where 0x0000 - device id - last 2 bytes of mac address in hex format

16 0xFF

Manufacturer Specific Data

Bytes are in LE format (little-endian)

Empty values are filled with FF

Size, bytes Example Description
2 0xFFFF COMPANY_IDENTIFIER
1 0x00

BLE packet version

0x01 - v1

0x02 - v2

2 0x0000

packet v1

tVOC, ppb

1 0x00

packet v2

VOC index = value * 2 + 1

0xFF - not available

0xFE - heating

1 0x00

packet v2

NOx index = value * 2 + 1

0xFF - not available

0xFE - heating

2 0x0000 PM2.5, µg/m3 x 10
2 0x0000 PM10, µg/m3 x 10
2 0x0000 Temperature, celsius x 100
2 0x0000 Relative Humidity, % x 100
2 0x0000 CO2, ppm

 

Scan Response Packet Format

Len Type Description Value
24 0xFF Manufacturer Specific Data

Bytes are in LE format (little-endian)

Empty values are filled with FF

Size, bytes Example Description
2 0xFFFF COMPANY_IDENTIFIER
4 0x00000000 Barometric pressure, mbar x 100
1 0x00 Noise, dB
2 0x0000 Luminocity, lux
2 0x0000 PM1, µg/m3 x 10
2 0x0000 CH2O, ppb
1 0x00 People count
2 0x0000 CO, ppb
2 0x0000 O3, ppb
4 0x00000000 FW version
1 0x00

Status byte

0 bit - connectable = 1

1 bit - reserved

2 bit - reserved

3 bit - reserved

4 bit - reserved

5 bit - reserved

6 bit - BLE busy status

7 bit - MQTT status

E.g.

0x80 = 10000000 - Connectable

0x01 - 00000001 - MQTT Connected

0xFFFF - Sensor is not available

0xFFFE - Sensor heating