I have an Aqara temperature sensor device with button battery that shows up fine in the Zigbee2MQTT list but doesn’t show up anywhere in Home Assistant under devices or entities. I have three of these devices and the other two are working fine. This one used to work fine, then it stopped reporting new data. I replaced the battery (although it was fine) and did a long press on the little button and the blue light blinked three times and I can see good data coming from it in Zigbee2MQTT but can’t access it in Home Assistant. Any help appreciated!
Have a read through this. I helped another user with an identical issue a month ago, so the troubleshooting steps will apply to you.
OK, so I edited the core.device_registry file and found a reference to my misbehaving temperature sensor in the deleted_devices section of the file, so I deleted that line and rebooted Home Assistant. Unfortunately it still doesn’t show up in the “devices” listing of Home Assistant. However, now the core.entity_registry file shows these entries for my errant device identifier:
core.entity_registry: {"aliases":[],"area_id":null,"categories":{},"config_entry_id":"01JHESDNKQ1T8Q2E0D8B8PW47M","config_subentry_id":null,"created_at":"2025-06-04T17:15:07.705745+00:00","device_class":null,"disabled_by":"integration","disabled_by_undefined":false,"entity_id":"sensor.basement_temperature_aqara_linkquality","hidden_by":null,"hidden_by_undefined":false,"icon":null,"id":"2d2ad7c23add81c481c12856602795c7","labels":[],"modified_at":"2026-02-20T23:45:53.944299+00:00","name":null,"options":{"cloud.google_assistant":{"should_expose":false},"cloud.alexa":{"should_expose":false}},"options_undefined":false,"orphaned_timestamp":null,"platform":"mqtt","unique_id":"0x00158d000af115a7_linkquality_zigbee2mqtt"},
core.entity_registry: {"aliases":[],"area_id":null,"categories":{},"config_entry_id":"01JHESDNKQ1T8Q2E0D8B8PW47M","config_subentry_id":null,"created_at":"2025-06-04T17:15:07.425306+00:00","device_class":null,"disabled_by":null,"disabled_by_undefined":false,"entity_id":"sensor.basement_temperature_aqara_battery","hidden_by":null,"hidden_by_undefined":false,"icon":null,"id":"bcb45d45b5e2472135cb2ce2865c92c2","labels":[],"modified_at":"2026-02-20T23:45:53.947283+00:00","name":null,"options":{"cloud.google_assistant":{"should_expose":false},"cloud.alexa":{"should_expose":false},"conversation":{"should_expose":false}},"options_undefined":false,"orphaned_timestamp":null,"platform":"mqtt","unique_id":"0x00158d000af115a7_battery_zigbee2mqtt"},
core.entity_registry: {"aliases":[],"area_id":null,"categories":{},"config_entry_id":"01JHESDNKQ1T8Q2E0D8B8PW47M","config_subentry_id":null,"created_at":"2025-06-04T17:15:07.521023+00:00","device_class":null,"disabled_by":null,"disabled_by_undefined":false,"entity_id":"sensor.basement_temperature_aqara_temperature","hidden_by":null,"hidden_by_undefined":false,"icon":null,"id":"a3f070c1cc2a7933c0c6fdcbefdca8e7","labels":[],"modified_at":"2026-02-20T23:45:53.949272+00:00","name":null,"options":{"cloud.google_assistant":{"should_expose":false},"cloud.alexa":{"should_expose":false},"conversation":{"should_expose":true},"sensor":{"suggested_display_precision":1}},"options_undefined":false,"orphaned_timestamp":null,"platform":"mqtt","unique_id":"0x00158d000af115a7_temperature_zigbee2mqtt"},
core.entity_registry: {"aliases":[],"area_id":null,"categories":{},"config_entry_id":"01JHESDNKQ1T8Q2E0D8B8PW47M","config_subentry_id":null,"created_at":"2025-06-04T17:15:07.567014+00:00","device_class":null,"disabled_by":null,"disabled_by_undefined":false,"entity_id":"sensor.basement_temperature_aqara_humidity","hidden_by":null,"hidden_by_undefined":false,"icon":null,"id":"200caf566a85b67f6db9f0447e4524de","labels":[],"modified_at":"2026-02-20T23:45:53.951154+00:00","name":null,"options":{"cloud.google_assistant":{"should_expose":false},"cloud.alexa":{"should_expose":false},"conversation":{"should_expose":true}},"options_undefined":false,"orphaned_timestamp":null,"platform":"mqtt","unique_id":"0x00158d000af115a7_humidity_zigbee2mqtt"},
core.entity_registry: {"aliases":[],"area_id":null,"categories":{},"config_entry_id":"01JHESDNKQ1T8Q2E0D8B8PW47M","config_subentry_id":null,"created_at":"2025-06-04T17:15:07.613884+00:00","device_class":null,"disabled_by":null,"disabled_by_undefined":false,"entity_id":"sensor.basement_temperature_aqara_pressure","hidden_by":null,"hidden_by_undefined":false,"icon":null,"id":"fa8896938c41e04a537e5ebf75b484e3","labels":[],"modified_at":"2026-02-20T23:45:53.958935+00:00","name":null,"options":{"sensor.private":{"suggested_unit_of_measurement":"inHg"},"cloud.google_assistant":{"should_expose":false},"cloud.alexa":{"should_expose":false},"conversation":{"should_expose":false},"sensor":{"suggested_display_precision":2}},"options_undefined":false,"orphaned_timestamp":null,"platform":"mqtt","unique_id":"0x00158d000af115a7_pressure_zigbee2mqtt"},
core.entity_registry: {"aliases":[],"area_id":null,"categories":{},"config_entry_id":"01JHESDNKQ1T8Q2E0D8B8PW47M","config_subentry_id":null,"created_at":"2025-06-04T17:15:07.655856+00:00","device_class":null,"disabled_by":null,"disabled_by_undefined":false,"entity_id":"sensor.basement_temperature_aqara_voltage","hidden_by":null,"hidden_by_undefined":false,"icon":null,"id":"efb66568414d0c8047ce3e4763e93e16","labels":[],"modified_at":"2026-02-20T23:45:53.960902+00:00","name":null,"options":{"cloud.google_assistant":{"should_expose":false},"cloud.alexa":{"should_expose":false},"conversation":{"should_expose":false},"sensor":{"suggested_display_precision":0}},"options_undefined":false,"orphaned_timestamp":null,"platform":"mqtt","unique_id":"0x00158d000af115a7_voltage_zigbee2mqtt"}
homeassistant.exposed_entities: "sensor.0x00158d000af115a7_battery": {
homeassistant.exposed_entities: "sensor.0x00158d000af115a7_temperature": {
homeassistant.exposed_entities: "sensor.0x00158d000af115a7_humidity": {
homeassistant.exposed_entities: "sensor.0x00158d000af115a7_pressure": {
homeassistant.exposed_entities: "sensor.0x00158d000af115a7_voltage": {
homeassistant.exposed_entities: "sensor.0x00158d000af115a7_linkquality": {
-
In Z2M’s Devices list, find the “IEEE Address” of the Aqara temperature sensor. From the information you posted above, it appears to be
0x00158d000af115a7. -
Using an MQTT client like MQTT Explorer, confirm your MQTT broker contains the following topic:
homeassistant/sensor/0x00158d000af115a7
If the topic does not exist (or its payload is invalid) then it explains why Home Assistant is unaware of the Aqara temperature sensor.
Thanks for your help on this, however I think I’ll step back from the problem and just use a different sensor. I installed mqtt explorer but it looked a bit too complicated for me.
It’s less complicated than this:
All MQTT Explorer needs is a username and password to login to your MQTT broker. It will display all MQTT topics it is handling. One of those topics should be for your device.
It’s worthwhile to learn how to use MQTT Explorer because it’s a good debugging tool for MQTT problems.
OK, I got MQQT Explorer working. When I search for 00158d000af115a7 it displays:
homeassistant.local
▼zigbee2mqtt
▼bridge
info = {"commit":"unknown","config":{"advanced":{"cache_state":true,"cache_state_persistent":true,"cache_state_send_on_startup":true,"channel":11,"elapsed":false,"ext_pan_id":[54,150,245,57,141,91,117,216],"last_seen":"disable","log_console_json":false,"log_debug_namespace_ignore":"","log_debug_to_mqtt_frontend":false,"log_directories_to_keep":10,"log_directory":"/config/zigbee2mqtt/log/%TIMESTAMP%","log…
health = {"response_time":1771780308476,"os":{"load_average":[0.29,0.33,0.32],"memory_used_mb":1292.55,"memory_percent":68.1094},"process":{"uptime_sec":823229,"memory_used_mb":81,"memory_percent":4.2682},"mqtt":{"connected":true,"queued":0,"published":265393,"received":253},"devices":{"0xa4c138c8c2f0416d":{"messages":6131,"messages_per_sec":0.0074,"leave_count":0,"network_address_changes":0},"0xa4c138c267…
logging = {"level":"info","message":"z2m:mqtt: MQTT publish: topic 'zigbee2mqtt/bridge/health', payload '{\"response_time\":1771780308476,\"os\":{\"load_average\":[0.29,0.33,0.32],\"memory_used_mb\":1292.55,\"memory_percent\":68.1094},\"process\":{\"uptime_sec\":823229,\"memory_used_mb\":81,\"memory_percent\":4.2682},\"mqtt\":{\"connected\":true,\"queued\":0,\"published\":265393,\"received\":253},\"devices\…
You’re looking at the zigbee2mqtt topic.
Look in the homeassistant topic.
Specifically here: homeassistant/sensor/0x00158d000af115a7
OK, I see a large list of sensors under the homeassistant topic, but none match 00158d000af115a7. I see 00158d000af44c2b which is probably my other working Aqara sensor.
One interesting thing in the zigbee2mqtt topic was this entry in the devices section:
"0x00158d000af115a7":{"friendly_name":"Basement Temperature Aqara","homeassistant":{"name":null}},
None of the other devices in the list had the “homeassistant”:{“name”:null} part. I wonder if this is a problem?
Did you try renaming it in Z2M? It was the second post in the thread I linked to earlier and is the easiest step to do when such issues occur.
I renamed many devices in Zigbee2MQTT. For the ones I do not rename, the payload contains "name": null. That’s normal; it means you did not rename it in Z2M and so it’s known by its IEEE Address.
If it’s not there then it implies one of two things:
-
You renamed the device in Z2M so now its discovery topic will be
homeassistant/sensor/whatever_name_you_gave_it. -
You did not rename the device yet for some inexplicable reason its discovery topic, employing its IEEE Address, doesn’t exist.
I’m going to call this one solved I guess. I re-paired the three problematic Aqara sensors to Home Assistant and left them sitting next to the Zigbee antenna for quite a while and also named them to include last three digits of the device identifier so they wouldn’t be mixed up and voila, they seem to be accessible and working. Not sure exactly what the fix was but I’m calling it day. Thanks for all the help!!