/zha-map

Build ZHA network topology map.

Primary LanguagePythonMIT LicenseMIT

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
  1. Add zha_map: to your configuration.yaml and restart Home Assistant
  2. Wait for a scan to complete (logs to DEBUG, or use the new zha_map service to scan on demand)
  3. Install one of the visualization cards:
  1. Add to your lovelace global config as type: module
  2. 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.