AN241 Datasheet, PDF (14/30 Pages) Silicon Laboratories – 2.4 GHZ ZIGBEE™NETWORK APPLICATION INTERFACE PROGRAMMERS GUIDE

AN241
5.2. NLME-NETWORK-FORMATION
5.2.1. Description
This primitive instructs a device to initialize itself as the coordinator of a new ZigBee network.
Applicability:
Applies to Coordinator only.
Prerequisite:
Device is Coordinator-capable (FFD) and not already established in a network.
NLME-RESET should be issued beforehand.
5.2.2. Request
Description:
This primitive allows the next higher layer to request that the device start a new ZigBee
network with itself as the coordinator.
Function Prototype:
Parameters:
NWK_ENUM nlmeNetworkFormationRequest(UINT32 scanChannels, BYTE
scanDuration, BYTE beaconOrder, BYTE superframeOrder, WORD panID,
BOOL batteryLifeExtension) large
UINT32 scanChannels
The five most significant bits (b27, ... ,b31) are reserved.
The 27 least significant bits (b0, b1, ... b26) indicate which channels are to be scanned
(1 = scan, 0 = do not scan) for each of the 27 valid channels.
UINT8 scanDuration
A value used to calculate the length of time to spend scanning each channel.
BYTE beaconOrder
In star mode or tree mode this specifies the beacon order of the network that the higher
layers wish to form. In MESH_MODE there are no beacons and this parameter should be
set equal to 0x0F.
BYTE superframeOrder
In star mode or tree mode this specifies the superframe order of the network that the
higher layers wish to form.
In MESH_MODE there are no beacons and this parameter may be omitted. If the
parameter is supplied, it will be ignored.
WORD panID
An optional PAN identifier that may be supplied if higher layers wish to establish this
network with a predetermined identifier. (0x0000 - 0x3FFF)
If PANId is not specified (i.e. panID = NULL ) the NWK layer will choose a PAN ID.
BOOL batteryLifeExtension
If this value is TRUE, the NLME will request that the ZigBee coordinator is started
supporting battery life extension mode.
If this value is FALSE, the NLME will request that the ZigBee coordinator is started without
supporting battery life extension mode.
14
Rev. 0.1