AN241 查看數據表（PDF） - Silicon Laboratories

零件编号

产品描述 (功能)

生产厂家

AN241

2.4 GHZ ZIGBEE™ NETWORK APPLICATION INTERFACE PROGRAMMER'S GUIDE

Silicon Laboratories 

AN241

5.5. NLME-JOIN

5.5.1. Description

Applicability:

Prerequisites:

5.5.2. Request

Description:

Function Prototype:

Parameters:

Allows Child to join network.

NLME-RESET must occur before NLME-JOIN

This primitive allows the next higher layer to request to join a network either through

association or directly or to re-join a network if orphaned.

void nlmeJoinRequest(WORD panId, BOOL joinAsRouter,

rejoinNetwork, UINT32 scanChannels, BYTE scanDuration,

powerSource, BYTE rxOnWhenIdle, BYTE macSecurity) large

BOOL

BYTE

WORD panId

The PAN identifier of the network to attempt to join or re-join. (0x0000–0x3FFF). Select

from available networks shown in nwkDescriptor list from NLME-NETWORK-

DISCOVERY request/confirmation.

BOOL joinAsRouter

The parameter is TRUE if the device is attempting to join the network in the capacity of a

ZigBee router. It is FALSE otherwise.

The parameter is valid in requests to join through association and ignored in requests to

join directly or to re-join through orphaning.

BOOL rejoinNetwork

TRUE: the device is joining directly or rejoining the network using the orphaning

procedure.

FALSE: the device is requesting to join a network through association.

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.

BYTE scanDuration

A value used to calculate the length of time to spend scanning each channel.

BYTE powerSource

This parameter becomes a part of the CapabilityInformation parameter passed to

the mlmeAssociateRequest function that is generated as the result of a successful

executing of a NWK join.

0x01: Mains-powered device,

0x00: other power source.

BYTE rxOnWhenIdle

This parameter indicates whether the device can be expected to receive packets over the

air during idle portions of the active portion of its superframe.

0x01: The receiver is enabled when the device is idle.

0x00: The receiver may be disabled when the device is idle.

This parameter shall have a value of 0x01 for ZigBee coordinators and ZigBee routers

operating in a nonbeacon-oriented network.

18

Rev. 0.1

Share Link: