Xiaomi JY-GZ-01AQ

ModelJY-GZ-01AQ
VendorXiaomi
DescriptionAqara smart smoke detector
Exposessmoke, smoke_density, smoke_density_dbm, selftest, test, mute_buzzer, mute, heartbeat_indicator, linkage_alarm, temperature, battery, linkquality
PictureXiaomi JY-GZ-01AQ

Notes

Adapter firmware

In order for this device to work, at least the following firmware is required on your adapter:

Note that if you have already paired the device you will need to repair it after upgrading your adapter firmware.

Pairing

Quickly press the button three times in a row. After this the device will automatically join.

JY-GZ-01AQ pairing

Note: When you fail to pair a device, try replacing the battery, this could solve the problem.

OTA updates

This device supports OTA updates, for more information see OTA updates.

Options

How to use device type specific configuration

  • temperature_precision: Number of digits after decimal point for temperature, takes into effect on next report of device. The value must be a number with a minimum value of 0 and with a with a maximum value of 3

  • temperature_calibration: Calibrates the temperature value (absolute offset), takes into effect on next report of device. The value must be a number.

Exposes

Smoke (binary)

Indicates whether the device detected smoke. Value can be found in the published state on the smoke property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"smoke": ""}. It's not possible to write (/set) this value. If value equals true smoke is ON, if false OFF.

Smoke_density (numeric)

Value of smoke concentration. Value can be found in the published state on the smoke_density property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"smoke_density": ""}. It's not possible to write (/set) this value.

Smoke_density_dbm (numeric)

Value of smoke concentration in dB/m. Value can be found in the published state on the smoke_density_dbm property. It's not possible to read (/get) or write (/set) this value. The unit of this value is dB/m.

Selftest (enum)

Starts the self-test process (checking the indicator light and buzzer work properly). Value will not be published in the state. It's not possible to read (/get) this value. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"selftest": NEW_VALUE}. The possible values are: Test.

Test (binary)

Self-test in progress. Value can be found in the published state on the test property. It's not possible to read (/get) or write (/set) this value. If value equals true test is ON, if false OFF.

Mute_buzzer (enum)

Mute the buzzer for 80 seconds (buzzer cannot be pre-muted, because this function only works when the alarm is triggered). Value will not be published in the state. It's not possible to read (/get) this value. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"mute_buzzer": NEW_VALUE}. The possible values are: Mute.

Mute (binary)

Buzzer muted. Value can be found in the published state on the mute property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"mute": ""}. It's not possible to write (/set) this value. If value equals true mute is ON, if false OFF.

Heartbeat_indicator (binary)

When this option is enabled then in the normal monitoring state, the green indicator light flashes every 60 seconds. Value can be found in the published state on the heartbeat_indicator property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"heartbeat_indicator": ""}. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"heartbeat_indicator": NEW_VALUE}. If value equals true heartbeat_indicator is ON, if false OFF.

Linkage_alarm (binary)

When this option is enabled and a smoke is detected, other detectors with this option enabled will also sound the alarm buzzer. Value can be found in the published state on the linkage_alarm property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"linkage_alarm": ""}. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"linkage_alarm": NEW_VALUE}. If value equals true linkage_alarm is ON, if false OFF.

Temperature (numeric)

Measured temperature value. Value can be found in the published state on the temperature property. It's not possible to read (/get) or write (/set) this value. The unit of this value is °C.

Battery (numeric)

Remaining battery in %. Value can be found in the published state on the battery property. It's not possible to read (/get) or write (/set) this value. The minimal value is 0 and the maximum value is 100. The unit of this value is %.

Linkquality (numeric)

Link quality (signal strength). Value can be found in the published state on the linkquality property. It's not possible to read (/get) or write (/set) this value. The minimal value is 0 and the maximum value is 255. The unit of this value is lqi.