Skip to content
This repository has been archived by the owner on Mar 11, 2021. It is now read-only.

zha-ng/zha-map

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

zha-map is DEPRECATED

With HA 2020.12.0 zha-map and zha-network-visualization-card are deprecated, as all the functionality is now included with ZHA integration: Configuration Panel -> Integrations -> ZHA -> configure -> Visualization. New version of Zigzag are working without requiring the zha-map custom component.

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.

Related projects

zha-network-visualization-card

zha-network-visualization-card is a custom lovelace element for Home Assistant that visualizing your ZHA Zigbee network. Zigbee network mapping with zha-map can help you identify weak points like bad links between your devices. It relies on the data provided by the zha-map integration commponent.

Zigzag

Zigzag is an custom card/panel for Home Assistant that displays a graphical layout of Zigbee devices and the connections between them. Zigzag can be installed as a panel or a custom card and relies on the data provided by the zha-map integration commponent.

Zigpy

zigpy is Zigbee protocol stack integration project to implement the Zigbee Home Automation standard as a Python library. Zigbee Home Automation integration with zigpy allows you to connect one of many off-the-shelf Zigbee adapters using one of the available Zigbee radio library modules compatible with zigpy to control Zigbee devices. There is currently support for controlling Zigbee device types such as binary sensors (e.g. motion and door sensors), analog sensors (e.g. temperature sensors), lightbulbs, switches, and fans. Zigpy is tightly integrated with Home Assistant's ZHA component and provides a user-friendly interface for working with a Zigbee network.