# Z-Wave Network map: how to interpret

**URL:** <https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775>\
**Category:** Bindings\
**Created:** [June 20, 2021, 6:00pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775 "2021-06-20T18:00:46Z")\
**Posts on this page:** 15\
**Page:** 1

<div class="post-metadata">

**Author:** ![JoveToo](https://community.openhab.org/letter_avatar_proxy/v4/letter/j/ecb155/32.png) [@JoveToo](https://community.openhab.org/u/JoveToo)\
**Post date:** [June 20, 2021, 6:00pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/1 "2021-06-20T18:00:46Z")

</div>

Hi,

My Z-Wave network looks like this:

 ![Z-wave network](https://community-openhab-org.s3.dualstack.eu-central-1.amazonaws.com/original/3X/8/5/8520bdae42a239c63356da34630c5d2188cdfe89.png)

I am unsure how to interpret this.

Node 2, 4, 5 and 6 seem to have good connectivity.  
Node 3 is not included in the network but it seems responsive enough not to mark it dead. Is that a correct interpretation? (It shows as online in the things list).  
Node 1, the controller, here has no connection to the main network, does that mean the connection isn’t good or is this normal?

---

<div class="post-metadata">

**Author:** ![Andrew\_Rowe](https://community.openhab.org/user_avatar/community.openhab.org/andrew_rowe/32/37075_2.png) [@Andrew\_Rowe](https://community.openhab.org/u/Andrew_Rowe)\
**Post date:** [June 20, 2021, 6:09pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/2 "2021-06-20T18:09:47Z")

</div>

> [@JoveToo](#):
>
> I am unsure how to interpret this.

Johan, the lines between the nodes indicate mesh network routes. Not all nodes can act as repeaters. Battery powered device can not act as repeaters. In your screen shot all nodes are included in the network and the ones with lines between them represent the mesh routes

---

<div class="post-metadata">

**Author:** ![JoveToo](https://community.openhab.org/letter_avatar_proxy/v4/letter/j/ecb155/32.png) [@JoveToo](https://community.openhab.org/u/JoveToo)\
**Post date:** [June 20, 2021, 6:18pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/3 "2021-06-20T18:18:12Z")

</div>

Thank you, Andrew.

---

<div class="post-metadata">

**Author:** ![JustinG](https://community.openhab.org/user_avatar/community.openhab.org/justing/32/55948_2.png) [@JustinG](https://community.openhab.org/u/JustinG)\
**Post date:** [June 20, 2021, 7:38pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/4 "2021-06-20T19:38:49Z")

</div>

You’ll find some useful extra details in this discussion:

> [@Strange Z-Wave Network](https://community.openhab.org/t/strange-z-wave-network/120121):
>
> As far as I know, a Z-Wave network is only built up by things that are not battery-operated. That means only devices that are connected to the power supply route messages between the controller and more distant devices. If so, I do not understand the network structure in my network. As you can see in the attached network plan, the controller (node 1) only has two neighboring nodes (node 3 and node 9). This also agrees with the zwave\_neighbors entries of the nodes. Node 3 is a smoke detector and…

---

<div class="post-metadata">

**Author:** ![Bruce\_Osborne](https://community.openhab.org/user_avatar/community.openhab.org/bruce_osborne/32/38531_2.png) [@Bruce\_Osborne](https://community.openhab.org/u/Bruce_Osborne)\
**Post date:** [June 20, 2021, 9:33pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/5 "2021-06-20T21:33:41Z")

</div>

Actually the lines depict **neighbors** which may or may not correlate to routes.

---

<div class="post-metadata">

**Author:** ![JoveToo](https://community.openhab.org/letter_avatar_proxy/v4/letter/j/ecb155/32.png) [@JoveToo](https://community.openhab.org/u/JoveToo)\
**Post date:** [June 20, 2021, 9:40pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/6 "2021-06-20T21:40:37Z")

</div>

The difference between a neighbor and a route is not clear to me. For example, in my map above, my controller (node 1) does not have any neighbours.

---

<div class="post-metadata">

**Author:** ![Bruce\_Osborne](https://community.openhab.org/user_avatar/community.openhab.org/bruce_osborne/32/38531_2.png) [@Bruce\_Osborne](https://community.openhab.org/u/Bruce_Osborne)\
**Post date:** [June 20, 2021, 10:02pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/7 "2021-06-20T22:02:43Z")

</div>

And that makes no sense. PErhaps there has not been a network heal done recently to compute neighbors and report them to the binding.

I know the old map showed nothing much until after a network heal.

---

<div class="post-metadata">

**Author:** ![JoveToo](https://community.openhab.org/letter_avatar_proxy/v4/letter/j/ecb155/32.png) [@JoveToo](https://community.openhab.org/u/JoveToo)\
**Post date:** [June 20, 2021, 10:57pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/8 "2021-06-20T22:57:37Z")

</div>

There has been a network heal. I added a new device (node 6) yesterday, it is in the diagram and the connections are different today.

I am also not getting any information in my items from the 3 unpowered devices (CO Sensors).

There is about 5 meters and a wooden floor between the controller and the closest powered node (node 6). It is also in the back of a pc, so perhaps it really does have an unreliable connection.

---

<div class="post-metadata">

**Author:** ![Bruce\_Osborne](https://community.openhab.org/user_avatar/community.openhab.org/bruce_osborne/32/38531_2.png) [@Bruce\_Osborne](https://community.openhab.org/u/Bruce_Osborne)\
**Post date:** [June 21, 2021, 7:30am UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/9 "2021-06-21T07:30:40Z")

</div>

Personally, I have not found a good use for the network map. Sorry.

---

<div class="post-metadata">

**Author:** ![rlkoshak](https://community.openhab.org/user_avatar/community.openhab.org/rlkoshak/32/75251_2.png) [@rlkoshak](https://community.openhab.org/u/rlkoshak)\
**Post date:** [June 21, 2021, 8:00pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/10 "2021-06-21T20:00:08Z")

</div>

> [@JoveToo](#):
>
> The difference between a neighbor and a route is not clear to me.

Any given message sent by any node in the network may not take the same route from device to device through the mesh. So really it makes no sense to worry about routes at all except on a message by message basis.

So instead of showing routes, the map shows neighbors. And to be specific, it’s showing which nodes have heard from other nodes at some point recently.

The orange node is the controller.  
The yellow nodes are routers. These nodes can forward messages from other nodes on their way toward their ultimate destination.

The solid green nodes are not routers. Battery powered devices typically won’t be routers.

A line from one node to the next indicates that at least one of those two nodes lists the other as a neighbor, at least one of those nodes has seen the other.

A solid line means both nodes list the other as a neighbor. A dashed line with arrow indicates that only one of the nodes sees the other as a neighbor. In the map above node 4 sees node 6 as a neighbor but node 6 does not see node 4 as a neighbor. Does that mean there isn’t a strong signal between node 6 and node 4? Probably not. All we can say is so far is that node 6 hasn’t seen node 4.

So the map can tell you a little about how strong your mesh is. But it doesn’t really tell you much about the routes that any given message will take to get from point a to point b. And it only really shows a little about the mesh’s health. Take the original network above. Nothing is showing node 1 as a neighbor and node 1 lists nothing as a neighbor. If that meant that there was no route between node 1 and the rest of the nodes it would mean nothing in your zwave network would work. Nodes 2-6 would be marked as dead and no messages would get through to openHAB. But clearly messages _are_ getting through between node 1 and the rest of the nodes or else all the nodes would be marked as dead and there wouldn’t be any arrows at all.

If you are otherwise experiencing Zwave problems the map can help diagnose some things. For example when I started out I noticed certain switches took a long time to switch after being commanded, 10 seconds or more. I pulled up the network map (as it existed back then) and I noticed that only one of my ten devices (at the time) listed the controller as a neighbor and everything else listed that one device as a neighbor. That hinted to me that perhaps I had a bottleneck. That theory made some sense as all mains powered devices were on a different floor from the controller and the one device that saw the controller was directly under the controller.

So I did pretty much the only thing you can do when there is a problem with the mesh network; I bought another mains powered device. I put this one on the same floor but in a different room from the controller. Suddenly all the devices on the main floor started listing that new device as a neighbor and all switching would happen instantly.

So coupling the network map with your knowledge about how the devices are physically located can be used together to help you decide where to put another mains powered Zwave device to improve the mesh. But it doesn’t really tell you much more than that and it doesn’t tell you much on it’s own.

---

<div class="post-metadata">

**Author:** ![apella12](https://community.openhab.org/user_avatar/community.openhab.org/apella12/32/117154_2.png) [@apella12](https://community.openhab.org/u/apella12)\
**Post date:** [June 21, 2021, 9:01pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/11 "2021-06-21T21:01:52Z")

</div>

Just to pile on: One way to examine actual routing and the radio strength (not just neighbors) is with a zniffer. Before I had one, I did waste money on devices that I thought would help routing, but found out they did not.  
I don’t know your rules, but for me it’s important that as many nodes as possible have a direct connection with the controller. Mesh is a nice idea for flexibility, but speed increases with fewer hops. The network map in OH3 is almost a magical piece of programming (and provides the info noted in the above posts), but I use a spreadsheet for the routes. I have disabled the heal, so the routes do not change much over time.  
[zniffer.pdf](https://community.openhab.org/uploads/short-url/2FgnX2T0jFyIQDSFdTuF5Ob7rkp.pdf) (231.1 KB)

Bob

---

<div class="post-metadata">

**Author:** ![chris](https://community.openhab.org/letter_avatar_proxy/v4/letter/c/958977/32.png) [@chris](https://community.openhab.org/u/chris)\
**Post date:** [June 22, 2021, 12:49am UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/12 "2021-06-22T00:49:56Z")

</div>

> [@rlkoshak](#):
>
> And to be specific, it’s showing which nodes have heard from other nodes at some point recently.

That’s not correct. The neighbours list is built up during the heal. There is a specific command that is issued for devices to query their neighbour. Neighbours are only listed if they are a certain signal strength, and if this command fails, then no neighbours will be listed.

The command in question is often difficult for battery devices, and can fail if there’s a lot going on on the network. It’s not just a case of “who heard who recently”.

If there are no neighbours listed for a node, then it is probably because there has been no heal, or, because this part of the heal failed. Of course it could also be because devices have no neighbours with the required signal strength.

---

<div class="post-metadata">

**Author:** ![rlkoshak](https://community.openhab.org/user_avatar/community.openhab.org/rlkoshak/32/75251_2.png) [@rlkoshak](https://community.openhab.org/u/rlkoshak)\
**Post date:** [June 22, 2021, 1:38pm UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/13 "2021-06-22T13:38:27Z")

</div>

> [@chris](#):
>
> That’s not correct. The neighbours list is built up during the heal.

OK, I was basing that off of a discussion in another thread so had incorrect information.

---

<div class="post-metadata">

**Author:** ![drhm](https://community.openhab.org/letter_avatar_proxy/v4/letter/d/eb9ed0/32.png) [@drhm](https://community.openhab.org/u/drhm)\
**Post date:** [June 27, 2021, 10:20am UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/14 "2021-06-27T10:20:44Z")

</div>

Can you please send a link to your sniffer?

It seems to me the only useful way to find out what is going wrong in a Z-Wave network. The network map is useless.

---

<div class="post-metadata">

**Author:** ![Andrew\_Rowe](https://community.openhab.org/user_avatar/community.openhab.org/andrew_rowe/32/37075_2.png) [@Andrew\_Rowe](https://community.openhab.org/u/Andrew_Rowe)\
**Post date:** [June 27, 2021, 10:34am UTC](https://community.openhab.org/t/z-wave-network-map-how-to-interpret/123775/15 "2021-06-27T10:34:36Z")

</div>

> [@\[SOLVED\] Unresponsive Z-Wave Network: Tools and Approaches to track down the issues](https://community.openhab.org/t/solved-unresponsive-z-wave-network-tools-and-approaches-to-track-down-the-issues/122446/5):
>
> I have not used the Suphammer, but based on the screen shots, the zniffer setup (that I use) seems more readable. For me it just required a UZB ($35 USD) and the free Silabs software. I found the instructions [here](https://3.5inchfloppy.com/using-the-acc-uzb-u-sta-z-wave-controller-with-zniffer/). Output looks like this: Also great post. Glad your issues were resolved. Lastly I also had great luck with Chris from Aeotec in the past. Hopefully that is a real person and just not just a screen name for all their tech support. Bob
