原创 【原创】ZigBee学习之17——ZStack API解读5

网络层（NWK）<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

网络层为高层提供下面函数功能：

·                     网络管理

·                     地址管理

·                     网络变量和效能函数

除了管理功能外，NWK还提供数据服务，只是应用不能访问数据服务。应用需要通过AF数据接口AF_DataRequest()来发送数据。

网络管理

ZStatus_t NLME_NetworkDiscoveryRequest( uint32 ScanChannels,byte ScanDuration );

用来请求网络层发现邻居路由器。在加入操作执行网络扫描前应该调用此函数。扫描确认（结果）将以回调函数ZDO_NetworkDiscoveryConfirmCB()返回。推荐用户使用ZDO_StartDevice()来代替此函数。（除非你清楚的知道网络加入过程）

ScanChannels    -执行发现的通道，2.4GHz条件下只能使用通道11-26（0x07FFF800）

ScanDuration    -新网络启动前，每个通道被其他网络扫描的时间

    BEACON_ORDER_15_MSEC 0 15.36 milliseconds

    BEACON_ORDER_30_MSEC 1 30.72 milliseconds

    BEACON_ORDER_60_MSEC 2 61.44 milliseconds

    BEACON_ORDER_120_MSEC 3 122.88 milliseconds

    BEACON_ORDER_240_MSEC 4 245.76 milliseconds

    BEACON_ORDER_480_MSEC 5 491.52 milliseconds

    BEACON_ORDER_1_SECOND 6 983.04 milliseconds

    BEACON_ORDER_2_SECONDS 7 1966.08 milliseconds

    BEACON_ORDER_4_SECONDS 8 3932.16 milliseconds

    BEACON_ORDER_7_5_SECONDS 9 7864.32 milliseconds

    BEACON_ORDER_15_SECONDS 10 15728.64 milliseconds

    BEACON_ORDER_31_SECONDS 11 31457.28 milliseconds

    BEACON_ORDER_1_MINUTE 12 62914.58 milliseconds

    BEACON_ORDER_2_MINUTES 13 125829.12 milliseconds

    BEACON_ORDER_4_MINUTES 14 251658.24 milliseconds

    BEACON_ORDER_NO_BEACONS 15 No Beacons transmitted

返回值：ZStatus_t    -ZComDef.h中定义的状态值

ZStatus_t NLME_NwkDiscReq2( NLME_ScanFields_t* fields );

用来请求网络层发现邻居路由器。用此函数来执行一个网络扫描，但是不加入网络。扫描确认（结果）将以回调函数ZDO_NetworkDiscoveryConfirmCB()返回。回调函数执行以后通过调用NLME_NwkDiscTerm()清除此活动。

fields – 扫描结构体

typedef struct

{

  uint32 channels;

  uint8  duration;

} NLME_ScanFields_t;

void NLME_NwkDiscTerm( void );

ZStatus_t NLME_NetworkFormationRequest( uint16 PanId, uint32 ScanChannels,

                     byte ScanDuration, byte BeaconOrder,

                     byte SuperframeOrder, byte BatteryLifeExtension  );

函数允许上层请求设备构成网络并成为网络中的协调器。执行结果返回回调函数ZDO_NetworkFormationConfirmCB()。推荐用户使用ZDO_StartDevice()来代替此函数。

PanId   -此设备建立网络所使用的ID，值范围：0~0x3FFF。如果0xFFFF被使用，则网络层将为网络选择此PanID。如果发现网络的PAN ID相同，则增加PAN ID直到其唯一。

BeaconOrder – Zigbee 2006中此参数为：BEACON_ORDER_NO_BEACONS.

SuperframeOrder –Zigbee 2006中此参数为：BEACON_ORDER_NO_BEACONS.

BatteryLifeExtension    -为TRUE则请求协调器支持电池寿命扩展模式

ZStatus_t NLME_StartRouterRequest( byte BeaconOrder, byte SuperframeOrder,

                                   byte BatteryLifeExtension );

函数允许上层请求设备以路由器功能启动。执行结果返回回调函数 ZDO_StartRouterConfirmCB()。推荐用户使用ZDO_StartDevice()来代替此函数。

BeaconOrder – Zigbee 2006中此参数为：BEACON_ORDER_NO_BEACONS.

SuperframeOrder –Zigbee 2006中此参数为：BEACON_ORDER_NO_BEACONS.

BatteryLifeExtension    -为TRUE则请求协调器支持电池寿命扩展模式

ZStatus_t NLME_JoinRequest( uint8 *ExtendedPANID, uint16 PanId,

                             byte Channel, byte CapabilityInfo );

函数允许上层发送设备加入网络的请求。执行结果返回回调函数 ZDO_JoinConfirmCB()。推荐用户使用ZDO_StartDevice()来代替此函数。

ExtendedPANID   -想要加入的网络的扩展PAN ID

CapabilityInfo  -加入设备的操作性能

    CAPINFO_ALTPANCOORD  0x01

    CAPINFO_DEVICETYPE_FFD  0x02

    CAPINFO_POWER_AC  0x04

    CAPINFO_RCVR_ON_IDLE  0x08

    CAPINFO_SECURITY_CAPABLE  0x40

    CAPINFO_ALLOC_ADDR  0x80

ZStatus_t NLME_ReJoinRequest( void );

已加入设备的重新加入。执行结果返回到回调函数ZDO_JoinConfirmCB()

ZStatus_t NLME_OrphanJoinRequest( uint32 ScanChannels, byte ScanDuration );

请求网络层孤儿节点的加入。此函数是一个暗含加入的扫描。执行结果返回到回调函数ZDO_JoinConfirmCB()。推荐用户使用ZDO_StartDevice()来代替此函数。

以上的几个函数基本上是被ZDO_StartDevice()的执行所取代了，呵呵！

ZStatus_t NLME_PermitJoiningRequest( byte PermitDuration );

定义了协调器或路由器在一个固定的周期内如何允许设备加入。

PermitDuration  -在这个指定的时间（单位为秒）内允许设备关联。0x00和0xff表示分别禁止或允许设备关联。

ZStatus_t NLME_DirectJoinRequest( byte *DevExtAddress, byte capInfo );

请求协调器或路由器设备的网络层加入一个设备作为其子设备。

DevExtAddress   -指向设备的IEEE地址

ZStatus_t NLME_LeaveReq( NLME_LeaveReq_t* req );

请求自己或者其他设备脱离网络，执行此函数不会导致其父节点重新分配设备地址。

req – 脱离请求数据结构:

typedef struct

{

  uint8* extAddr;

  uint8  removeChildren;

  uint8  rejoin;

  uint8  silent;

} NLME_LeaveReq_t;

extAddr -要脱离的设备的扩展地址

removeChildren -true 子设备也脱离，false只脱离当前设备。目前只能用false

rejoin -true 允许设备重新加入网络，false 不允许设备重新加入网络

silent – true will. false if the。

void NLME_RemoveChild( uint8* extAddr, uint8 dealloc );

dealloc – true will. false if the.

ZMacStatus_t NwkPollReq( byte securityEnable );

手动发送一个MAC数据请求（此函数只适用于终设备（end devices））。正常情况下终设备的数据检测（poll）由网络层自动处理，应用可以通过调用NLME_SetPollRate()来改变速率，如果速率设为0则可以调用此函数来手动推送数据。

securityEnable – 设为false.

返回值：ZMacStatus_t is the same as ZStatus_t –status values defined in ZComDef.h

void NLME_SetPollRate( uint16 newRate );

（此函数只适用于终设备（end devices））

newRate -单位为ms，数据推送到父设备的时间。

void NLME_SetQueuedPollRate( uint16 newRate );

设置/改变队列推送（poll）速率。（此函数只适用于终设备（end devices）），如果一个数据推送产生了数据消息，则数据推送率马上设置到 Queued Poll Rate以排空父设备的队列数据。

newRate -有效值为：0x01-0xff，0为禁止队列推送。

void NLME_SetResponseRate( uint16 newRate );

设置/改变应答推送（poll）速率。（此函数只适用于终设备（end devices）），我们可以让应答快一些。

newRate -有效值为：0x01-0xff，0为禁止队列推送。

地址管理

地址管理模块提供底层的地址管理，用户不能直接访问这个模块。APSME_LookupExtAddr和APSME_LookupNwkAddr提供本地地址查找，ZDP_IEEEAddrReq和ZDP_NwkAddrReq提供远程地址查找。

byte *NLME_GetExtAddr( void );

返回指向设备64位IEEE地址的指针。

uint16 NLME_GetShortAddr( void );

返回设备的16位网络地址（短地址）。

uint16 NLME_GetCoordShortAddr( void );

返回设备父亲的网络地址（16位短地址），注意这个地址不是Zigbee协调器的短地址（总为0x0000）

void NLME_GetCoordExtAddr( byte *buf );

返回设备父亲的IEEE地址（64位），注意这个地址不是Zigbee协调器的扩展地址

ZStatus_t NLME_SetRequest( ZNwkAttributes_t NIBAttribute,

                           uint16 Index,

                           void *Value );

设置NIB属性的值。

NIBAttribute    -只支持nwkProtocolVersion属性

ZStatus_t NLME_GetRequest( ZNwkAttributes_t NIBAttribute,

                           uint16 Index, void *Value );

NIBAttribute    -只支持如下属性：

    nwkCapabilityInfo

    nwkNumNeighborTableEntries

    nwkNeighborTable

    nwkNumRoutingTableEntries

    nwkRoutingTable

addr_filter_t NLME_IsAddressBroadcast(uint16 shortAddress);

基于设备性能，这个函数评估参数中提供的地址，决定是否是广播地址

shortAddress    -要测试的地址

addr_filter_t   -   ADDR_NOT_BCAST 不是一个广播地址

            ADDR_BCAST_FOR_ME 是一个广播地址，且这个设备是正确的设备类型

            ADDR_BCAST_NOT_ME 是一个广播地址，这个设备是不是正确的目标

byte NLME_GetProtocolVersion();

获得NIB中的协议版本

返回值： ZB_PROT_V1_0  1

        ZB_PROT_V1_1  2

void NLME_SetBroadcastFilter(byte capabilities);

基于设备的性能设置位掩码，用来处理有效的广播地址

capabilities    -用来决定设备能处理哪些广播消息

网络的非易失性储存

若设置了NV_RESTORE，当设备加入时网络信息（NIB）会自动储存。当设备启动时会自动执行NIB NV初始化和恢复。如果用户应用改变NIB（_NIB）则必须调用NLME_UpdateNV()

void NLME_UpdateNV( byte enables );

enables -位掩码

    NWK_NV_NIB_ENABLE 0x01 粗存网络层NIB

    NWK_NV_DEVICELIST_ENABLE 0x02 储存设备列表

    NWK_NV_BINDING_ENABLE 0x04 储存绑定表

    NWK_NV_ADDRMGR_ENABLE 0x08 储存地址管理表