原创 Z-Stack ZigBee API命令解释----ZigBee应用程序编程接口2

1.1.4.1 ZDP_NwkAddrReq()

 

调用此函数将生成一个根据其已知IEEE地址询问远程设备16位地址的信息。这个信息作为一个广播信息发送给网络中所有设备。

 

函数原型

 

afStatus_t ZDP_NwkAddrReq( byte *IEEEAddress, byte ReqType,byte StartIndex, byte SecuritySuite );

 

 

 

参数描述

 

IEEEAddress—请求设备的IEEE地址。

 

ReqType—响应信息类型要求。其允许值列在下表中：

 

名称                              描述

 

ZDP_NWKADDR_REQTYPE_ SINGLE    只返回设备的短地址和扩展地址。

 

ZDP_NWKADDR_REQTYPE_ EXTEND ED 返回设备短地址和扩展地址以及所有相关设备短地址。

 

StartIndex—响应设备的响应信息可以有更多的响应选项，请求程序可以在可能的响应设备中指定一个起始索引。索引从0开始。

 

SecuritySuite—该信息的安全类型要求。

 

 

 

返回值

 

afStatus_t—这个函数使用AF层来发送信息，所以状态值是定义在ZComDef.h中的ZStatus_t的AF层状态值。

 

 

 

1.1.4.2 ZDP_NWKAddrRsp()

 

这实际上是一个调用ZDP_AddrRsp()的宏。这个调用将建立和发送一个网络地址响应。

 

函数原型

 

afStatus_t ZDP_NWKAddrRsp( byte TranSeq, zAddrType_t *dstAddr, byte Status, byte *IEEEAddrRemoteDev,byte ReqType, uint16 nwkAddr,byte NumAssocDev, byte StartIndex, uint16 *NWKAddrAssocDevList, byte SecuritySuite );

 

 

 

参数描述

 

TranSeq—本次事务的序列号。

 

DstAddr—目的地址。

 

Status—值如下：

 

含义                      值

 

ZDP_SUCCESS                   0

 

ZDP_INVA LID_REQTYPE         1

 

ZDP_DEVICE_ NOT_FOUND         2

 

Reserved                      0x03-0xff

 

IEEEAddrRemoteDev—远程设备的64位地址。

 

ReqType—该请求信息的请求类型。

 

nwkAddr—远程设备的16位地址。

 

NumAssocDev—计算与远程设备关联的设备个数，以及各自的16位短地址个数。如果远程设备无关联设备，NumAssocDev值应设为0，且StartIndex 和NWKAddrAssocDevList的值应设为空。

 

StartIndex—响应设备的响应信息中可以有更多的响应选项。请求程序可以给可能的响应设备指定一个起始索引。这是该响应信息的起始索引字段。

 

NWKAddrAssocDevList—16 位地址列表，与远程设备的关联设备一一对应。

 

NWKAddrAssocDevList 中的16 位地址个数由NumAssocDev 提供。

 

SecuritySuite—该信息的安全类型要求。

 

 

 

返回值

 

afStatus_t—这个函数使用AF层来发送信息，所以状态值是定义在ZComDef.h中的ZStatus_t 的AF层状态值。

 

 

 

1.1.4.3 ZDP_IEEEAddrReq()

 

调用此函数将生成一个根据其已知16位网络地址询问远程设备64位地址的信息。

 

函数原型

 

afStatus_t ZDP_IEEEAddrReq( uint16 shortAddr, byte ReqType, byte StartIndex, byte SecuritySuite );

 

 

 

参数描述

 

shortAddr—已知的16位网络地址。

 

ReqType—响应信息类型要求。

 

名称                              描述

 

ZDP_IEEEADDR_REQTYPE_ SINGLE 只返回该设备短地址和扩展地址。

 

ZDP_IEEEADDR_REQTYPE_ EXTEND ED 返回该设备短地址和扩展地址及所有相关设备短地址。

 

 

 

StartIndex—响应设备的响应信息可以有更多的响应选项，请求程序可以给可能的响应设备指定一个起始索引。

 

SecuritySuite—该信息的安全类型要求。

 

 

 

返回值

 

afStatus_t—这个函数使用AF层来发送信息，所以状态值是定义在ZComDef.h中的ZStatus_t 的AF层状态值。

 

 

 

1.1.4.4 ZDP_IEEEAddrRsp()

 

这实际上是一个调用ZDP_AddrRsp()的宏。这个调用将建立和发送一个IEEE地址响应。

 

函数原型

 

afStatus_t ZDP_IEEEAddrRsp( byte TranSeq, zAddrType_t *dstAddr, byte Status, byte *IEEEAddrRemoteDev, byte ReqType, uint16 nwkAddr, byte NumAssocDev, byte StartIndex, uint16 *NWKAddrAssocDevList, byte SecuritySuite );

 

 

 

参数描述

 

TranSeq—本次事务的序列号。

 

DstAddr—目的地址。

 

Status—值如下：

 

含义                      值

 

ZDP_SUCCESS                  0

 

ZDP_INVA LID_REQTYPE        1

 

ZDP_DEVICE_ NOT_FOUND        2

 

Reserved                     0x03-0xff

 

IEEEAddrRemoteDev—远程设备的64位地址。

 

ReqType—该请求信息的请求类型。

 

nwkAddr—远程设备的16位地址。

 

NumAssocDev—计算与远程设备关联的设备个数，以及各自的16位短地址个数。如果远程设备无关联设备，NumAssocDev值应设为0，且StartIndex 和NWKAddrAssocDevList的值应设为空。

 

StartIndex—本次报告中关联设备列表的起始索引。

 

WKAddrAssocDevList—16位地址列表，与远程设备的关联设备一一对应。NWKAddrAssoc -DevList 中的16位地址个数由NumAssocDev提供。

 

SecuritySuite—该信息的安全类型要求。

 

 

 

返回值

 

afStatus_t—这个函数使用AF层来发送信息，所以状态值是定义在ZComDef.h中的ZStatus_t 的AF层状态值。

 

 

 

1.1.4.5 ZDP_NodeDescReq()

 

这实际上是一个调用ZDP_NWKAddrOfInterestReq()的宏。这个调用将为目的地址字段指定的远程设备建立和发送一个节点描述请求。

 

函数原型

 

afStatus_t ZDP_NodeDescReq( zAddrType_t *dstAddr, uint16 NWKAddrOfInterest, byte SecuritySuite );

 

参数描述

 

DstAddr—目的地址。

 

NWKAddrOfInterest—目标设备的16位短地址。

 

SecuritySuite—该信息的安全类型要求。

 

返回值

 

afStatus_t—这个函数使用AF层来发送信息，所以状态值是定义在ZComDef.h中的ZStatus_t的AF层状态值。

更多资料与技术讨论请联系：

上海无线龙通讯科技有限公司

联系人：司文铠

QQ：876692208

MSN:siwenkai@hotmail.com

TEL：13816689475

email:wxlsiwenkai@yahoo.com.cn

skype:sparksi01

公司网址：www.wxlsoc.com