WTH there is no legend in the ZHA network map?

In the ZHA network visualization the nodes are connected with lines that are solid, dotted, gray, yellow, red, green… but there is no indication of the meaning.
Please add info about it, thank you!

I was just about entering this post myself!
what the lines, colors and shapes represent, as well as the value and when its two values.

I haven’t found any (official) documentation, and even unofficial I haven’t found any complete.
Many refer to Z2M visualization but they are not quite similar, some have refered to an old HACS card but even there the documentation was incomplete.

2 Likes

I have the same question every time I go to that page but did this Gemini prompt\question today. You will find that AI services like Gemini, GPT, and Claude are much better for these types of questions than Google.

But the thing is that description is not completely correct.
First thing to note is that it stated a dashed line is usually something, which I interpret is not the actual reason, but might apply to the coordinator a lot of the times, but that also means it has not stated any actual definition of dashed lines.

What it has picked up as I’ve understood it is the definition of the map provided by Zigbee2Mqtt, and granted, you didn’t specify ZHA.

And my example kind of proves it is incorrect as I’m trying to troubleshoot one node (upper left) which has five dashed lines, one to the coordinator (square blue node)

(It’s a wall outlet inside a concrete walled basement, behind a washing machine, I know the connection is crap and are looking to improve it)

1 Like

I agree with you. I found nothing on line, so ChatGTP is mixing up some generic information just to give an answer, it does it often.

From a post in the Home Assistant Cookbook:

Not many people know that... A random collection of Zigbee trivia

The ZHA “network visualisation” was originally a dashboard card. It was absorbed into ZHA and the card is now deprecated, but the repository is still on Github.

The lines on the map show every route between nodes that Zigbee has discovered - not just the ones it is using. They are colour coded according to their LQI:

  • Green >192
  • Yellow 129-192
  • Red 80-128
  • Grey < 80

The map is a snapshot. It will be different each time you generate it.

There are two numbers on each link because messages pass in both directions. A value is supplied by the router at each end of the hop.

It is normal to see nodes on the map that don’t have a link to anything else. These are usually end devices and they’re probably sleeping to conserve battery. They will wake immediately if one of their sensors is triggered, and in any event they should wake periodically to check in with their parent router. A router with no connections is unavailable, which may indicate a problem.

2 Likes