mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-12-30 07:59:54 -08:00
97 lines
2.6 KiB
Plaintext
97 lines
2.6 KiB
Plaintext
---
|
|
id: neighbor-info
|
|
title: Neighbor Info Module Usage
|
|
sidebar_label: Neighbor Info
|
|
description: This module allows you to send information about your immediate(0 hop) neighbors.
|
|
---
|
|
|
|
import Tabs from "@theme/Tabs";
|
|
import TabItem from "@theme/TabItem";
|
|
|
|
The Neighbor Info Module is for sending information on each node's 0-hop neighbors to the mesh. Config options are: Enabled and Update Interval.
|
|
|
|
:::info
|
|
Neighbor Info is informative only and does not affect the routing behavior of the mesh network. It is therefore optional and disabled by default.
|
|
:::
|
|
|
|
In order to save bandwidth, Meshtastic does not keep track of the route a packet is taking to get to the destination, except when using Traceroute. When enabling this module, your node will periodically send out a packet with a list of its direct neighbors and the quality (SNR) of the corresponding link. If you enable this on all nodes, you can build up a graph of the full network to see how it is connected. At the time of writing, there are no clients visualizing it for you, but you can use e.g. MQTT to gather all the data.
|
|
|
|
In order to use it, make sure your devices use firmware version 2.2.0 or higher. From 2.3.2 on, the module can detect neighbors even if other nodes do not have the module enabled.
|
|
|
|
## Neighbor Info Module Config Values
|
|
|
|
### Enabled
|
|
|
|
Enables the Neighbor Info Module.
|
|
|
|
### Update Interval
|
|
|
|
How often the neighbor info is sent to the mesh.
|
|
|
|
|
|
## Neighbor Info Module Client Availability
|
|
|
|
<Tabs
|
|
groupId="settings"
|
|
defaultValue="cli"
|
|
values={[
|
|
{label: 'Android', value: 'android'},
|
|
{label: 'Apple', value: 'apple'},
|
|
{label: 'CLI', value: 'cli'},
|
|
{label: 'Web', value: 'web'},
|
|
]}>
|
|
<TabItem value="android">
|
|
|
|
#### Android
|
|
|
|
:::info
|
|
All Neighbor Info Module config options are available for Android in app version 2.2.0 and higher.
|
|
|
|
1. Open the Meshtastic App
|
|
2. Navigate to: **Vertical Ellipsis (3 dots top right) > Radio Configuration > Neighbor Info**
|
|
:::
|
|
|
|
</TabItem>
|
|
<TabItem value="apple">
|
|
|
|
#### Apple
|
|
|
|
Not yet implemented.
|
|
|
|
</TabItem>
|
|
<TabItem value="cli">
|
|
|
|
:::info
|
|
|
|
All Neighbor Info Module config options are available in the python CLI version 2.2.0 and higher.
|
|
|
|
:::
|
|
|
|
Example commands are below:
|
|
|
|
```shell title="Enable/Disable the Neighbor Info Module"
|
|
meshtastic --set neighbor_info.enabled true
|
|
meshtastic --set neighbor_info.enabled false
|
|
```
|
|
|
|
```shell title="Set the update interval to 10 minutes"
|
|
meshtastic --set neighbor_info.update_interval 600
|
|
```
|
|
|
|
```shell title="Get the Neighbor Info Module Configuration"
|
|
meshtastic --get neighbor_info
|
|
```
|
|
|
|
|
|
</TabItem>
|
|
<TabItem value="web">
|
|
|
|
:::info
|
|
|
|
All Neighbor Info module config options are available in the Web UI.
|
|
|
|
:::
|
|
|
|
</TabItem>
|
|
</Tabs>
|