Skip to main content
All CollectionsAtmocubeAdvanced Setup
Bluetooth API Specification
Bluetooth API Specification
Updated over 2 months ago

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


Company Identifier

Size: 2 bytes
Example: 0xFFFF


BLE Packet Version

Size: 1 byte

Example: 0x00

Description:

  • 0x01: v1

  • 0x02: v2


Packet v1

tVOC, ppb

Size: 2 bytes
Example: 0x0000


Packet v2

VOC Index

Size: 1 byte
Example: 0x00


Description:

  • VOC index = value * 2 + 1

  • 0xFF: Not available

  • 0xFE: Heating


Packet v2

NOx Index

Size: 1 byte
Example: 0x00


Description:

  • NOx index = value * 2 + 1

  • 0xFF: Not available

  • 0xFE: Heating


PM2.5, µg/m³ × 10

Size: 2 bytes
Example: 0x0000


PM10, µg/m³ × 10

Size: 2 bytes
Example: 0x0000


Temperature, °C × 100

Size: 2 bytes
Example: 0x0000


Relative Humidity, % × 100

Size: 2 bytes
Example: 0x0000


CO₂, ppm

Size: 2 bytes
Example: 0x0000

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

Company Identifier

Size: 2 bytes
Example: 0xFFFF


Barometric Pressure, mbar × 100

Size: 4 bytes
Example: 0x00000000


Noise, dB

Size: 1 byte
Example: 0x00


Luminosity, lux

Size: 2 bytes
Example: 0x0000


PM1, µg/m³ × 10

Size: 2 bytes
Example: 0x0000


CH₂O, ppb

Size: 2 bytes
Example: 0x0000


People Count

Size: 1 byte
Example: 0x00


CO, ppb

Size: 2 bytes
Example: 0x0000


O₃, ppb

Size: 2 bytes
Example: 0x0000


Firmware Version

Size: 4 bytes
Example: 0x00000000


Status Byte

Size: 1 byte
Example: 0x00

Description:

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

Examples:

  • 0x80 = 10000000 → Connectable

  • 0x01 = 00000001 → MQTT Connected

0xFFFF - Sensor is not available

0xFFFE - Sensor heating

Did this answer your question?