MMB's Site Survey tool provides the following data for each network that is within range of the tool:
There are some use cases where users may want to receive additional information as a part of a scan. In these cases, it's possible to use the Manufacturing Library frames in RapidConnect in such a way that more information can be pulled from the Zigbee beacon messages. The beacon messages contain additional information such as:
The following procedure allows the device to request and observe beacons from a specific channel:
Send a Manufacturing Library Tx Packet frame with repeat count: 1, packet payload:
03 08 <sequence> ff ff ff ff 07 |
Receive each Manufacturing Library Rx Packet frame for a user-selected period of time. The existing network scan frames allow this value to range from 31ms to 998ms. Upon receipt, these responses should be processed as per the following section.
Send a Manufacturing Library Set Rx Packet Enable frame to disable the receipt of packets.
To interpret the frame, we need to look at 3 layers of protocol. These layers are the 802.15.4 layer, the 802.15.4 Beacon layer, the Zigbee Beacon layer. The data is processed in network order.
The 802.15.4 layer is comprised of the fields described below. The Frame Control field is described below and indicates what the content of each of the fields means.
Frame Control | Sequence Number | Destination PAN Identifier | Destination Address | Source PAN Identifier | Source Address | Auxiliary Security Header | |
---|---|---|---|---|---|---|---|
Octets | 2 | 1 | 0/2 | 0/2/8 | 0/2 | 0/2/8 | 0/5/6/10/14 |
The frame control field is defined as follows:
Frame Type | Not Applicable | Reserved | Destination Addressing Mode | Frame Version | Source Addressing Mode | |
---|---|---|---|---|---|---|
bits | 0-2 | 3-6 | 7-9 | 10-11 | 12-13 | 14-15 |
fixed value | 0 | 0 | 0 | 0 | 0 | 2 |
For a beacon, the Frame Type must be 2 to indicate that short addressing is in use.
The Destination PAN identifier is not included for a Zigbee beacon.
The Destination Address is not included for a Zigbee beacon.
The Source PAN Identifier is included in a Zigbee beacon.
The Source Address is included and the size is based on the source addressing mode specified in the Frame Control field.
The Auxiliary Security Header is not included in Zigbee beacons.
The 802.15.4 Beacon layer is comprised of the fields descibed below. The Superframe Specification field is described below and indicates what the content of each of the fields means.
Superframe Specification | GTS Specification | GTS fields | Pending Address Specification | Pending | |
---|---|---|---|---|---|
Octets | 2 | 1 | variable | 1 | variable |
The Superframe Specification is defined as follows:
Beacon Order | Superframe Order | Final CAP Slot | Battery Life Extension (BLE) | Reserved | PAN Coordinator | Association Permit | |
---|---|---|---|---|---|---|---|
Bits | 0-3 | 4-7 | 8-11 | 12 | 13 | 14 | 15 |
Fixed Value | 0xF | 0xF | 0xF | 0 | 0 | <variable> | <variable> |
For a beacon, this set to 1 for beacons sent but the coordinator of the network. Otherwise this is set to 0.
For a beacon, this is set to 1 if the network is currently permitting join. Otherwise this is set to 0.
The GTS Specification should be 0 which indicates there are no GTS Fields for a zigbee beacon.
A beacon should not contain GTS fields.
The pending address specification should be 0, and specifies the number of pending address fields that are included. The format is as follows:
Number of Short Addresses Pending | Reserved | Numbed of Extended Addresses Pending | Reserved | |
---|---|---|---|---|
Bits | 0-2 | 3 | 4-6 | 7 |
Fixed Value | 0 | 0 |
The Pending Addresses fields are a list of short and long addresses as specified in the Pending Address Specification. Short Addresses are 2 octets in length while Extended Addresses are 8 octets in length. The Short Addresses are included first.
The Zigbee Beacon layer is composed of the fields descibed below:
Protocol Id | Stack Profile | nwkProtocolVersion | Reserved | Router Capacity | Device Depth | End Device Capacity | nwkExtendedPanId | TX Offset | NwkUpdateId | |
---|---|---|---|---|---|---|---|---|---|---|
bits | 0-7 | 8-11 | 12-15 | 16-17 | 18 | 19-22 | 23 | 24-87 | 88-111 | 112-119 |
octet offset | 0 | 1 | 1 | 2 | 2 | 2 | 2 | 3-10 | 11-13 | 14 |
fixed value | 0 | 0 |
The Protocol ID is required to be set to 0 for a Zigbee network.
The Stack Profile identifier. Typically this is set to 2 which indicates Zigbee PRO.
This indicates the version of the Zigbee network protocol.
This indicates if the device has room in its tables, etc. to support another router connected through it (or as a neighbour).
This indicates the distance from the coordinator, but is only required to be updated during the join.
This indicates if the device has any room for children in its various tables, etc.
The Extended PAN ID of the network. This is intended to be globally unique per network.
The TX offset indicates the number of symbols between beacons on a beaconed network. For beaconless networks (like Zigbee PRO), this gets set to 0xFFFFFF
The NwkUpdateId indicates which version of the network information the device is using.