candoanything/zha-map

Build ZHA network topology map.

zha-map

Build ZHA network topology map.

zha-map integration commponent for Home Assistant allow you to make a ZHA (Zigbee Home Automation) network topology map.

Requires that you are already using the ZHA integration commponent in Home Assistant.

Zigbee network mapping with zha-map can help you identify weak points like bad links between your devices.

Installation Instructions

1. Install the zha_map custom component

• https://github.com/zha-ng/zha-map

2. Add zha_map: to your configuration.yaml and restart Home Assistant
3. Wait for a scan to complete (logs to DEBUG, or use the new zha_map service to scan on demand)
4. Install one of the visualization cards:

• https://github.com/dmulcahey/zha-network-visualization-card
• https://github.com/Samantha-uk/zigzag

5. Add to your lovelace global config as type: module
6. Add custom card (works best in panel mode): - type: 'custom:zha-network-visualization-card'

Usage

The Zigbee coordinator will be represented by a rectangle at the top. Any device that serves as Zigbee router (usually all devices running on Mains electricity / grid power) will represented as ovals, and Zigbee end-device (usually battery powered sensors) will be represented by as circles.

The lines between those representions show all the possible paths through Zigbee mesh. Any path with a LQI over 192 is shown as green, LQI 129-192 is shown as yellow, and anything 128 and lower is shown as red.