How to See the WPAN Neighbor Table

Document created by mathaker on Sep 5, 2014Last modified by linyan on Oct 20, 2015
Version 5Show Document
  • View in full screen mode

On the FAR, use these CLI commands to view the CG Mesh WPAN neighbors:

CG-OS:

show wpan in-hardware linknbrs
show wpan linknbrs table

IOX:

show wpan x/1 hardware link-neighbors

show wpan x/1 link-neighbors table

Former is the link neighbor table inside the wpan module and is populated by 802.15.4 beacons.  It tells you that there are nodes within 1-hop range that the wpan has received 802.15.4 packets from. The list produced is ordered by most recently heard time and limited in size to the most recently heard nodes.

Latter is the link neighbor table inside the CGR and is populated only by IPv6 and 802.1x packets that comes into the CGR.  It tells you that there are nodes within 1-hop range that the CGR has received IPv6 or 802.1x packets from. These packets include forwarded packets, and not all are necessarily originated packets.  The list produced is ordered by the EUID of the nodes and is not limited in size.

Here are some examples of these commands in action:

PLC:

plc-3# show wpan linknbrs table
------------------------------------------------ WPAN LINK NEIGHBOR TABLE ------------------------------------------------------------
EUI64            RSSIF RSSIR LQIF LQIR MODF  MODR  TXGAINF TXGAINR TXRESF TXRESR TONEMAPF TONEMAPR TXCOEFFF TXCOEFFR PHASE LAST_HEARD
00173b050025003a 98    98    14   14   DQPSK D8PSK 1       1       6      6     00003f   00003f   01ff01ff 01ff01ff 0     11:50:19
00173b05002b003a 98    98    14   14   DQPSK DQPSK 1       1       6      6     00003f   00003f   01ff01ff 01ff01ff 0     11:50:10
00173b060026003d 98    98    17   17   D8PSK DQPSK 1       1       6      6     00003f   00003f   01ff01ff 01ff01ff 0     11:49:27
00173b060029003d 98    98    17   17   D8PSK D8PSK 1       1       6      6     00001f   00001f   01ff01ff 01ff01ff 0     11:49:34
00173b060031003c 98    98    14   14   DQPSK DQPSK 1       1       6      6     00003f   00003f   01ff01ff 01ff01ff 0     11:49:42
00173b0600380041 98    98    14   14   DBPSK D8PSK 1       1       6      6     00003f   00003f   01ff01ff 01ff01ff 0     11:50:39

 

RF-Mesh:

CDN-CGR1240-1# show wpan in-hardware linknbrs
linknbrs:
eui64 heard etx sent / ack rssif / rssir lqif / lqir
00173bab00c183fe 155 1024 0 / 0 -51 / -52 5 / 18
00173bab00c183f2 751 1024 0 / 0 -60 / -63 36 / 50 

 

CDN-CGR1240-1# show wpan linknbrs table

 

-------------------------- WPAN LINK NEIGHBOR TABLE ----------------------------
EUI64                  RSSIF  RSSIR  LQIF    LQIR    FIRST_HEARD  LAST_HEARD
00173bab00c183f2        -60    -63    36      50      16:13:59      00:03:54
00173bab00c183fe        -51    -52    5      18      16:13:22      00:13:50
Number of Entries in WPAN LINK NEIGHBOR TABLE: 2

 

Terms in use:

TermMeaningNotes
LQI

Link Quality Index**

RF RSSI threshold is 90 (unitless, the less, the better)

PLC LQI is 6dB (the larger, the better)

LQIFLink Quality Index Forwardas RSSIF
LQIRLink Quality Index Reverseas RSSIR
MODFModulation ForwardModulation used by this node for transmission to a remote node.  PLC only.
MODRModulation ReverseModulation used by a remote node for transmission to this node.  PLC only.
RSSIRReceived Signal Strength Indication**

if Value is weaker than -95, node might not be able to join the mesh network.

[-60,-40] = excellent, [-80, -60) = good,  (-80,-85] = somewhat good

update on each packet received

PLC threshold is 49 dBuV

LQI 6 DB (the larger, the better)

RSSIFRSSI Forward -- Transmit RSSI of this node as recorded by a remote receiving node (and conveyed back to the transmitter in a subsequent MAC layer packet transmission)

If N/A, this may mean that there have not been any reverse (received) transmissions from a node in question.

if Value is strong than -40, it might saturate the receiver.

update on each acknowledgement received for a data packet

TXGAIN

Gain steps of amplification on the signal. The higher the TXGAIN, the more power is drawn from the power supply.

TXRESNumber of dBs each gain step represents
TXCOEFFA bitmap of actual frequencies where amplications are applied
DPHASEDifferential Phase
APHASEAbsolute Phase in 360 degrees
TMF/RTonemaps for forward and reverse direction representing discrete frequency ranges
LOCKF/R

1: Node is using a specified tonemap and modulation.

0: Node is using adaptive tone maps.

ETX

hop count = ETX / 256 , "Sent" increments on each transmitted data packet. "Acked" increments on each acknowledgment received. "ETX" changes whenever Sent is greater than 4 and more than 1 minute has passed since the last update.

** Also see: Calculation and usage of LQI and RSSI - Design Notes - Wireless Connectivity - TI E2E Community

 

Note For RSSI: As our CGE reference design uses a better Radio than the wpan module, the saturation factor mentioned in above table does not apply

When the link neighbor table is not ideal, say RSSI is too strong, you could add an attenuator to the antenna.

                   

Attachments

    Outcomes