Link Search Menu Expand Document

Encrypted Advertisements


Table of contents

Support for additional sensors can be requested by opening an issue.
Check the Senor Request page on how to provide useful information for adding new sensors.

NOTE: Properties with a * have additional information in the device notes.

Advertisements for these devices are encrypted, therefore you need to set the key in your configuration, see for instructions the encryption_key option

Encrypted Advertisements


BTHome DIY-sensors
BTHome sensors
binary
door
light
lock
motion
opening
smoke
switch
battery
CO2
conductivity
count
dew point
energy
humidity
illuminance
weight
moisture
PM2.5
PM10
power
pressure
rssi
temperature
TVOC
voltage
weight
binary
opening
switch
DIY-sensors
Encrypted Advertisements
Optional (16 byte bindkey)
Notes:
  • BTHome is a BLE format for DIY sensors. BLE monitor supports both V1 and V2 and we support most measurement types, but not all yet. If you miss one of the measurement types, please let us know, such that we can add it. More information about the format can be found on BTHome website
  • BTHome is supported on some Xiaomi and Qingping sensors with custom ATC pvvx firmware (select BTHome as advertising format) and on b-parasite sensors.
  • Multiple measurements of the same type is not supported yet in BLE monitor. Please use the official BTHome integration in HA instead.
HolyIOT HolyIOT BLE sensors
BLE sensors
battery
rssi
temperature
humidity
pressure
button *
vibration
HolyIOT BLE sensors
Encrypted Advertisements
true
Notes:
  • button press types are ‘toggle’ or ‘no press’
  • Supported measurement types depend on the model.
  • After each button press, the sensor state shows ‘Toggle’. It will return to no press after the time set with the reset_timer option.
Linptech HS1BB(MI)
Linptech Motion Sensor
illuminance *
motion *
battery
rssi
HS1BB(MI)
Encrypted Advertisements
See Notes
Broadcast Rate
See Notes
Notes:
  • illuminance is measured in lux.
  • motion Motion state is ‘motion detected’ or ‘clear’.
    • Illuminance is broadcasted upon every 10 minutes and when motion is detected. Motion state is broadcasted when motion is detected. Additionally, motion clear messages are broadcasted at 1, 2, 5, 10, 20 and 30 minutes after the last motion. - You can use the reset_timer option if you want to use a different time to set the sensor to motion clear.
Linptech K9B
Switch (one button version)
one btn switch *
button switch
rssi
K9B
Encrypted Advertisements
Probably (not confirmed yet)
Notes:
  • one btn switch returns ‘short press’, ‘double press’ or ‘long press’
  • There are three different versions of this switch, with one, two or three buttons.
  • The switch sensor state will return to no press after the time set with the reset_timer option. It is advised to change the reset time to 1 second (default = 35 seconds).
Linptech K9B
Switch (two button version)
two btn switch left *
two btn switch right *
button switch
rssi
K9B
Encrypted Advertisements
Probably (not confirmed yet)
Notes:
  • two btn switch left returns ‘short press’, ‘double press’ or ‘long press’
  • two btn switch right returns ‘short press’, ‘double press’ or ‘long press’
  • There are three different versions of this switch, with one, two or three buttons.
  • The switch sensor state will return to no press after the time set with the reset_timer option. It is advised to change the reset time to 1 second (default = 35 seconds).
Linptech K9B
Switch (three button version)
three btn switch left *
three btn switch middle *
three btn switch right *
button switch
rssi
K9B
Encrypted Advertisements
Probably (not confirmed yet)
Notes:
  • three btn switch left returns ‘short press’, ‘double press’ or ‘long press’
  • three btn switch middle returns ‘short press’, ‘double press’ or ‘long press’
  • three btn switch right returns ‘short press’, ‘double press’ or ‘long press’
  • There are three different versions of this switch, with one, two or three buttons.
  • The switch sensor state will return to no press after the time set with the reset_timer option. It is advised to change the reset time to 1 second (default = 35 seconds).
Linptech K9BB
Switch (one button version, battery powered)
one btn switch *
button switch
battery
rssi
K9BB
Encrypted Advertisements
Probably (not confirmed yet)
Notes:
  • one btn switch returns ‘short press’, ‘double press’ or ‘long press’
  • This is the battery powered version of the Linptech K9B.
  • The switch sensor state will return to no press after the time set with the reset_timer option. It is advised to change the reset time to 1 second (default = 35 seconds).
Linptech MS1BB(MI)
Linptech Door and Window Sensor
opening
battery
status *
button
rssi
MS1BB(MI)
Encrypted Advertisements
true
Broadcast Rate
20-25 advertisements per second
Notes:
  • status The opening entity has an extra attribute “status”, which can have the following values:
    • window/door broken open
    • door not closed
Linptech RS1BB
Water Immersion and Rainwater sensor
moisture detected
rssi
RS1BB
Encrypted Advertisements
true
Petoneer SU001-T
Petoneer Smart Odor Eliminator Pro SU001-T
switch
motion
battery
rssi
SU001-T
Encrypted Advertisements
true
Qingping CGC1
Bluetooth alarm clock
temperature
humidity
battery *
rssi
CGC1
Encrypted Advertisements
Yes (Xiaomi MiBeacon advertisement)
Notes:
  • battery For battery level, we do not have accurate periodicity information yet.
  • The sensor sends BLE advertisements in Xiaomi MiBeacon format and Qingping format, but only MiBeacon format is supported currently.
  • Xiaomi MiBeacon advertisements are most likely encrypted.
  • If you have information about update frequency, encryption key requirement, and/or a log with report_unknown: 'qingping', we can improve the documentation and implement qingping format support without encryption. Please open an issue with this information.
Qingping CGD1
Cleargrass CGD1 alarm clock
temperature
humidity
battery *
rssi
CGD1
Segment LCD
Encrypted Advertisements
Yes (Xiaomi MiBeacon advertisement)
Broadcast Rate
~1/10min.
Notes:
  • battery For battery level, we do not have accurate periodicity information yet.
  • The sensor sends BLE advertisements in Xiaomi MiBeacon format and Qingping format.
  • Xiaomi MiBeacon advertisements are most likely encrypted.
  • Qingping advertisements are not encrypted.
Qingping CGDK2
Temp & RH Monitor Lite
temperature
humidity
battery
voltage
rssi
CGDK2
Round body, E-Ink
Encrypted Advertisements
true
Broadcast Rate
~1/10min.
custom firmware
Notes:
  • Custom firmware broadcast temperature, humidity, battery voltage and battery level in percent. Broadcast interval can be set by the user and encryption can be used as an option.
Qingping CGG1-M
Hygro thermometer
temperature
humidity
battery
voltage *
rssi
CGG1-M
Round body, E-Ink
Encrypted Advertisements
true
Broadcast Rate
~20/min.
custom firmware
Notes:
  • voltage Battery voltage is only available with custom firmware.
  • There are three versions of the CGG1. The CGG1-M has a qingping logo at the back (left picture) CGG1
  • broadcasts about 20 readings per minute, although exceptions have been reported with 1 reading per 10 minutes.
  • Custom firmware broadcast temperature, humidity, battery voltage and battery level in percent. Broadcast interval can be set by the user and encryption can be used as an option.
Qingping CGH1
Window Door/Sensor
opening
battery *
status *
rssi
CGH1
Encrypted Advertisements
true
Notes:
  • battery For battery level, we do not have accurate periodicity information yet.
  • status The opening entity has an extra attribute “status”, which can have the following values:
    • opened
    • closed
    • closing timeout
    • device reset
Qingping CGPR1
Motion and ambient light sensor
illuminance *
light *
motion *
battery
rssi
CGPR1
Encrypted Advertisements
See Notes
Broadcast Rate
See Notes
Notes:
  • illuminance is measured in lux.
  • light Qingping advertisements send a message with light status (dark/light). For Xiaomi MiBeacon advertisements, 100 lux is assumed to be the limit for dark/light.
  • motion Motion state is ‘motion detected’ or ‘clear’.
    • This sensor sends advertisements in Xiaomi MiBeacon format when connected to MiHome. In this case, communication is encrypted, so it requires an encryption key to be set in the configuration options. If it is not connected to MiHome, it will broadcast advertisements in Qingping format. This advertisement format is not encrypted, so it won’t require an encryption key. - Switching to Qingping mode is done by pressing the button for a very long time until the LED stops flashing. - In Xiaomi MiBeacon mode, illuminance is broadcasted upon every 10 minutes and when motion is detected. Motion state is broadcasted when motion is detected. Additionally, motion clear messages are broadcasted at 1, 2, 5, 10, 20 and 30 minutes after the last motion. - In Qingping mode, broadcast rate of illumination and battery is every second. - You can use the reset_timer option if you want to use a different time to set the sensor to motion clear.
Xiaomi LYWSD02MMC
Temperature and Humidity Monitor Clock
temperature
humidity
battery
rssi
LYWSD02MMC
Rectangular body, E-Ink
Encrypted Advertisements
true
Xiaomi LYWSD03MMC
Hygro thermometer
temperature
humidity
battery
voltage *
switch *
opening *
rssi
LYWSD03MMC
Small square body, segment LCD
Encrypted Advertisements
Yes (original firmware), optional with pvvx firmware
Broadcast Rate
1/10min. (battery level ~1/hr.)*
custom firmware
Notes:
  • voltage battery voltage is only available with custom firmware
  • switch The switch sensor is only available with custom firmware (pvvx) and is disabled by default. It represents the state of the Reed Switch. You can enable the switch sensor by going to configuration, integrations, select devices on the BLE monitor integration tile and select your device. Click on the +1 disabled entity to show the disabled sensor and select the disabled entity. Finally, click on Enable entity to enable it. This switch sensor can be used for a temperature or humidity trigger, for use as hygrostat or thermostat (depending on settings). More information can be found here on the pvvx website
  • opening The opening sensor is only available with custom firmware and is disabled by default. You can enable the opening sensor by going to configuration, integrations, select devices on the BLE monitor integration tile and select your device. Click on the +1 disabled entity to show the disabled sensor and select the disabled entity. Finally, click on Enable entity to enable it. More information about the use of this opening sensor can be found on here on the pvvx website
  • Both custom firmwares broadcast temperature, humidity, battery voltage and battery level in percent. Broadcast interval can be set by the user and encryption can be used as an option. BLE monitor supports all possible broadcast types that can be selected in the TelinkMiFlasher tool.
Xiaomi MCCGQ02HL
Mijia Window/Door Sensor 2
battery
opening
light
status *
rssi
MCCGQ02HL
Encrypted Advertisements
true
Broadcast Rate
battery level ~1/day
Notes:
  • status The opening entity has an extra attribute “status”, which can have the following values:
    • opened
    • closed
    • closing timeout
    • device reset
Xiaomi MJWSD05MMC
Mijia Smart Temperature and Humidity Monitor 3
temperature
humidity
battery
rssi
MJWSD05MMC
Rectangular body, E-Ink
Encrypted Advertisements
true
Xiaomi MJYD02YL
Motion Activated Night Light
battery
motion
light
rssi
MJYD02YL
Encrypted Advertisements
true
Broadcast Rate
See Notes
Notes:
  • Light state is broadcasted once every 5 minutes when no motion is detected, when motion is detected the sensor also broadcasts the light state. Motion state is broadcasted when motion is detected, but is also broadcasted once per 5 minutes. If this message is within 30 seconds after motion, it’s broadcasting motion detected, if it’s after 30 seconds, it’s broadcasting motion clear. Additionally, motion clear messages are broadcasted at 2, 5, 10, 20 and 30 minutes after the last motion.
  • You can use the reset_timer option if you want to use a different time to set the sensor to motion clear.
  • Battery is broadcasted once every 5 minutes.
Xiaomi MJZNMSQ01YD
Xiaomi Door Lock Youth Edition
fingerprint *
lock *
battery
result *
key id *
action *
method *
error *
timestamp *
rssi
MJZNMSQ01YD
Encrypted Advertisements
Yes, see notes
Notes:
  • fingerprint The fingerprint sensor is On if the fingerprint scan was successful, otherwise it is Off The fingerprint entity has two extra attributes, result and key id.
  • result result shows the result of the last fingerprint reading and can have the following values:
    • match successful
    • match failed
    • timeout
    • low quality (too light, fuzzy)
    • insufficient area
    • skin is too dry
    • skin is too wet
  • key id key id is an id number. For the fingerprint sensor, it can also be administrator or unknown operator
  • lock The state of the lock depends on the last action. The lock entity has five extra attributes, action, method, error and key id and timestamp
  • action action shows the last change in of the lock and can have the following values:
    • unlock outside the door
    • lock
    • turn on anti-lock
    • turn off anti-lock
    • unlock inside the door
    • lock inside the door
    • turn on child lock
    • turn off child lock
    • lock outside the door
    • abnormal
  • method method shows the last used locking mechanism and can have the following values:
    • unlock outside the door
    • lock
    • bluetooth
    • password
    • biometrics
    • key
    • turntable
    • nfc
    • one-time password
    • two-step verification
    • Homekit
    • coercion
    • manual
    • automatic
    • abnormal
  • error The error state of the lock
  • timestamp The timestamp of the latest lock change
  • At the moment you can only get the encryption key with method 4 (intercepting the MiHome application traffic) as described in the FAQ. Search for /device/blelockbind or /v2/device/ble_secure_bind endpoint. Method 3 (MiHome mod) is currently being worked on and will support extracting the encryption key for this device in the next release of MiHome mod. For further information, see this issue
Xiaomi PTX
BLE wireless switch
one btn switch *
battery
rssi
PTX
Encrypted Advertisements
true
Notes:
  • one btn switch returns ‘single press’, ‘double press’ or ‘long press’
  • The switch sensor state will return to no press after the time set with the reset_timer option. It is advised to change the reset time to 1 second (default = 35 seconds).
Xiaomi RTCGQ02LM
Mi Motion Sensor 2
light
motion *
button *
battery
rssi
RTCGQ02LM
Encrypted Advertisements
true
Broadcast Rate
See notes
Notes:
  • motion Light state is broadcasted upon a change in light in the room and is also broadcasted at the same time as motion is detected. The sensor does not broadcast motion clear advertisements. It is therefore required to use the reset_timer option with a value that is not 0.
  • button The sensor also broadcasts single press if you press the button. After each button press, the sensor state shortly shows single press and will return to no press after 1 second. The sensor has an attribute which shows the last button press. You can use the state change event to trigger an automation in Home Assistant. Battery is broadcasted once every few hours.
Xiaomi SJWS01LM
Smart Water Leak Sensor
moisture detected
button
battery
rssi
SJWS01LM
Encrypted Advertisements
true
Xiaomi T700
Mi Electric Toothbrush T700
toothbrush *
battery
score *
rssi
T700
Encrypted Advertisements
true
Notes:
  • toothbrush The toothbrush sensor has one attribute score
  • counter After starting the toothbrush, the counter will count the time you used your toothbrush
  • score After finishing toothbrushing, the toothbrush will report a score
Xiaomi XMMF01JQD
Smart Mijia Magic Cube
button *
rssi
XMMF01JQD
Encrypted Advertisements
true
Notes:
  • button Possible states are ‘left’ and ‘right’, corresponding to the direction you rotate the cube. No edge information is available, only the direction, as this edge info is only available after connecting to the cube. This is not supported in BLE monitor.
  • After each rotation, the sensor state shows the direction. It will return to no press after the time set with the reset_timer option (default = 35 seconds).
  • The sensor has an attribute which shows the last button press. You can use the state change event to trigger an automation in Home Assistant.
Xiaomi XMPIRO2SXS
Xiaomi Human Body Sensor 2S
illuminance *
motion *
battery
rssi
XMPIRO2SXS
Encrypted Advertisements
true
Notes:
  • illuminance is measured in lux.
  • motion Motion state is ‘motion detected’ or ‘clear’.
    • You can use the reset_timer option if you want to use a different time to set the sensor to motion clear.
Xiaomi XMWSDJ04MMC
Electronic Thermometer and Hygrometer
temperature
humidity
battery
rssi
XMWSDJ04MMC
Small square body, EInk version
Encrypted Advertisements
true
Broadcast Rate
Once in 5 minutes.
Xiaomi XMWXKG01LM
Mijia wireless switch
one btn switch *
battery
rssi
XMWXKG01LM
round switch
Encrypted Advertisements
true
Notes:
  • one btn switch returns ‘single press’, ‘double press’ or ‘long press’
  • The switch sensor state will return to no press after the time set with the reset_timer option. It is advised to change the reset time to 1 second (default = 35 seconds).
Xiaomi XMWXKG01YL
Smart Switch (two button version)
two btn switch left *
two btn switch right *
rssi
XMWXKG01YL
Encrypted Advertisements
Probably (not confirmed yet)
Notes:
  • two btn switch left returns ‘short press’, ‘double press’ or ‘long press’
  • two btn switch right returns ‘short press’, ‘double press’ or ‘long press’
  • The switch sensor state will return to no press after the time set with the reset_timer option. It is advised to change the reset time to 1 second (default = 35 seconds).
Xiaomi XMZNMS08LM
Smart Door Lock 1S
battery
door *
lock *
key id *
action *
door action *
method *
error *
timestamp *
rssi
XMZNMS08LM
Encrypted Advertisements
true
Broadcast Rate
Battery state can take up to several hours before it is updated.
Notes:
  • lock The state of the lock depends on the last action. The lock entity has five extra attributes, action, method, error and key id and timestamp
  • action action shows the last change of the lock (displayed as an attribute of the lock sensor) and can have the following values:
    • unlock outside the door
    • lock
    • turn on anti-lock
    • turn off anti-lock
    • unlock inside the door
    • lock inside the door
    • turn on child lock
    • turn off child lock
    • lock outside the door
  • method method shows the last used locking mechanism (displayed as an attribute of the lock sensor) and can have the following values:
    • unlock outside the door
    • lock
    • bluetooth
    • password
    • biometrics
    • key
    • turntable
    • nfc
    • one-time password
    • two-step verification
    • Homekit
    • coercion
    • manual
    • automatic
    • abnormal
  • error The error state of the lock (displayed as an attribute of the lock sensor)
  • key id key id is an id number, displayed as an attribute of the lock sensor).
  • timestamp The timestamp of the latest lock change (displayed as an attribute of the lock sensor)
  • door The door entity has one extra attributes door action.
  • door action door action shows the last change in of the door state (displayed as an attribute of the door sensor) and can have the following values:
    • open the door
    • close the door
    • timeout, not closed
    • knock on the door
    • pry the door
    • door stuck
Xiaomi Lockin DSL-C08
Lockin Q2
lock *
key id *
action *
method *
error *
armed away *
timestamp *
battery
rssi
DSL-C08
Encrypted Advertisements
Yes, see notes
Notes:
  • lock The state of the lock depends on the last action. The lock entity has five extra attributes, action, method, error and key id and timestamp
  • key id key id is an id number. For the fingerprint sensor, it can also be administrator or unknown operator
  • action action shows the last change in of the lock and can have the following values:
    • unlock outside the door
    • lock
    • turn on anti-lock
    • turn off anti-lock
    • unlock inside the door
    • lock inside the door
    • turn on child lock
    • turn off child lock
    • lock outside the door
    • abnormal
  • method method shows the last used locking mechanism and can have the following values:
    • unlock outside the door
    • lock
    • bluetooth
    • password
    • biometrics
    • key
    • turntable
    • nfc
    • one-time password
    • two-step verification
    • Homekit
    • coercion
    • manual
    • automatic
    • abnormal
  • error The error state of the lock
  • timestamp The timestamp of the latest lock change
  • armed away armed away Inside the locked device, this event is output from the door ‘up’ handle.
  • Only supports the Bluetooth version (MiHome version)
Xiaomi/MiaoMiaoCe MHO-C401
Alarm clock
temperature
humidity
battery
voltage
rssi
MHO-C401
Small square body, E-Ink display
Encrypted Advertisements
true
Broadcast Rate
1/10min. (battery level 1/hr.)
custom firmware
Notes:
  • Custom firmware’s broadcast temperature, humidity, battery voltage and battery level in percent. Broadcast interval can be set by the user and encryption can be used as an option. BLE monitor will automatically use the advertisement type with the highest accuracy, when setting the firmware to broadcast all advertisement types.
Yeelight YLAI003
Smart Wireless Switch
button *
battery
rssi
YLAI003
Encrypted Advertisements
true
Notes:
  • button press types are ‘single press’, ‘double press’ or ‘long press’
  • After each button press, the sensor state shows the type of press. It will return to no press after the time set with the reset_timer option.
  • It is advised to change the reset time to 1 second (default = 35 seconds).
  • The sensor has an attribute which shows the last button press. You can use the state change event to trigger an automation in Home Assistant.
Yeelight YLKG07YL_YLKG08YL
Rotating Dimmer
dimmer *
rssi
YLKG07YL_YLKG08YL
Encrypted Advertisements
true
Notes:
  • dimmer types are ‘rotate’, ‘rotate (presses)’, ‘short press*’, ‘long press’. For rotation, it reports the rotation direction (left, right) and how far you rotate (number of steps). For short press it reports how many times you pressed the dimmer. For long press it reports the time (in seconds) you pressed the dimmer.
  • The dimmer sensor state will return to no press after the time set with the reset_timer option
  • It is advised to change the reset time to 1 second (default = 35 seconds).
Yeelight YLYB01YL-BHFRC
Bathroom Heater Remote Control
bathroom heater remote *
button *
rssi
YLYB01YL-BHFRC
Encrypted Advertisements
Partly
Notes:
  • bathroom heater remote button pressed options are ‘heat’, ‘air exchange’, ‘dry’, ‘fan’, ‘swing’, ‘speed -‘, ‘speed +’, ‘stop’ or ‘light toggle’
  • button press types are ‘short press’ or ‘long press’
  • The state of the remote sensor shows the remote button being pressed, the attributes shows the type of press.
  • It will return to ‘no press’ after the time set with the reset_timer option.
  • It is advised to change the reset time to 1 second (default = 35 seconds).
Yeelight YLYK01YL
Remote Control
remote *
remote single press
remote long press
rssi
YLYK01YL
Encrypted Advertisements
Partly
Notes:
  • remote button pressed options are ‘on’, ‘off’, ‘color temperature’, ‘+’, ‘M’, ‘-‘
  • The state of the remote sensor shows the combination of both, the attributes shows the button being used and the type of press individually.
  • It will return to ‘no press’ after the time set with the reset_timer option.
  • It is advised to change the reset time to 1 second (default = 35 seconds).
  • Additionally, two binary sensors are generated (one for ‘short press’, one for ‘long press’), which is ‘True’ when pressing ‘on’, ‘+’ or ‘-‘ and ‘False’ when pressing ‘off’.
Yeelight YLYK01YL-FANCL
Fan Remote Control
fan remote *
button *
rssi
YLYK01YL-FANCL
Encrypted Advertisements
Partly
Notes:
  • fan remote button pressed options are ‘fan toggle’, ‘light toggle’, ‘wind speed’, ‘wind mode’, ‘brightness’, ‘color temperature’
  • button press types are ‘short press’ or ‘long press’
  • The state of the remote sensor shows the combination of both, the attributes shows the button being used and the type of press individually.
  • It will return to ‘no press’ after the time set with the reset_timer option.
  • It is advised to change the reset time to 1 second (default = 35 seconds)
Yeelight YLYK01YL-VENFAN
Ventilator Fan Remote Control
ventilator fan remote *
button *
rssi
YLYK01YL-VENFAN
Encrypted Advertisements
Partly
Notes:
  • ventilator fan remote button pressed options are ‘swing’, ‘power toggle’, ‘timer 30 minutes’, ‘timer 60 seconds’, ‘strong wind speed’, ‘low wind speed’
  • button press types are ‘short press’ or ‘long press’
  • The state of the remote sensor shows the combination of both, the attributes shows the button being used and the type of press individually.
  • It will return to ‘no press’ after the time set with the reset_timer option.
  • It is advised to change the reset time to 1 second (default = 35 seconds).