企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
>[success] 导师视频讲解:[**去听课**](https://www.bilibili.com/video/BV1k34y1D7Vz?p=38) >[success] **技术支持说明:** >**1**.一般以自主学习为主 > **2**.可到官方问答社区中提问:[**去提问**](https://bbs.csdn.net/forums/zigbee) > **3**.工程师**会尽快**解答社区问题,但他们是一线开发,【**难以保证**】解答时效,解答辛苦,感谢理解! <br/> 在学习完通信原理之后,本节课讲解AF层的数据发送API。 <br/> ## **数据发送API** 打开配套的工程,可以在Profile中找到一个AF.h文件,如图所示。 ![](https://img.kancloud.cn/36/97/3697f7bdfb4d83cf89843ee8a8fb1cdd_1247x2560.png =250x) ### 在这个文件中可以找到一个名为AF\_DataRequest()的数据发送API,如图所示。 ![](https://img.kancloud.cn/8e/ef/8eef2a96e381d48e25e6feb115275a58_1680x1010.png =500x) 这就是AF层的数据发送API,它的参数说明如下: ``` /* * @param dstAddr 目标设备地址,包含网络地址和端点号 * @param srcEP 发送设备的简单描述符 * @param cID Cluster ID,后续章节将会详细讲解 * @param len 待发送数据的长度 * @param buf 待发送的数据 * @param transID 传输ID,可以用来给每一次发送的数据包编一个号 * @param options 附加选项,可以用来给这次数据发送添加一些说明 * @param radius 最大的路由跳转级数 */ afStatus_t AF_DataRequest( afAddrType_t *dstAddr, endPointDesc_t *srcEP, uint16 cID, uint16 len, uint8 *buf, uint8 *transID, uint8 options, uint8 radius ); ``` 协议栈里面的SampleSwitch这个例程基于这个API封装出了点对点通信API、广播通信API和组播通信API。 <br/> ## **点对点通信API** 在zcl\_samplesw.c文件中可以找到一个点对点通信API,代码如下: ``` /* * @param destNwkAddr 目标设备的网络地址 * @param cid Cluster ID,后续课程将会详细讲解 * @param len 数据长度 * @param data 数据内容 */ static void zclSampleSw_AF_P2P( uint16 destNwkAddr,  uint16 cid, uint8 len,  uint8 *data) {     afAddrType_t dstAddr; //寻址信息配置  static uint8 transferId = 0;//传输ID,是数据包的标识符 /* Destination */     dstAddr.addrMode = afAddr16Bit;// 设置目标地址模式为16位网络地址,表示使用P2P的通信方式 dstAddr.addr.shortAddr = destNwkAddr;//目标设备的网络地址   dstAddr.endPoint = SAMPLESW_ENDPOINT;//目标设备的端点号  transferId++;     AF_DataRequest(&dstAddr,  &sampleSw_TestEp,//已经创建好的简单描述符 cid,     len,  data,     &transferId, AF_DISCV_ROUTE,//进行路由扫描操作,用于建立发送数据报文的通信路径。关于这个参数,暂时保持例程默认的代码就可以了 AF_DEFAULT_RADIUS);//指定最大的路由跳转级数 } ``` ### 这个API中使用了一个afAddrType\_t类型变量,用于配置寻址信息。这个变量定义如下: ![](https://img.kancloud.cn/98/0a/980aa5900ebe4a9e54d84472c93b39d3_1680x1010.png) ### 这个API中也使用了一个afAddrMode\_t变量,表示地址模式(类型),用于说明使用的是点对点、广播还是组播的通信方式。同样地,可以查看其定义,代码如下: ![](https://img.kancloud.cn/bd/e2/bde2cee833df5074f317123ee1a79be9_1680x1009.png =500x) 可以看到,afAddrMode\_t是一个枚举类型变量。 ### 在zclSampleSw\_AF\_P2P()函数的的最后,可以看到最终就是调用AF\_DataRequest()来发送数据的。开发者也可以基于AF\_DataRequest()来编写自己的点对点通信API,而不使用这个工程中的默认的这个zclSampleSw\_AF\_P2P()。 <br/> ## **广播通信API** 在zcl\_samplesw.c文件中可以找到广播通信API,代码如下: ``` /* * @param cid Cluster ID * @param len 待发送数据的长度 * @param *data 待发送数据的内容 */ static void zclSampleSw_AF_Broadcast( uint16 cid, uint8 len, uint8 *data) { afAddrType_t dstAddr;   static uint8 transferId = 0;   /* Destination */   dstAddr.addrMode = afAddrBroadcast;   // 使用广播模式 dstAddr.addr.shortAddr = 0xFFFF; // 广播地址 dstAddr.endPoint = SAMPLESW_ENDPOINT; // 目标设备的端点号  /* Transfer id */   transferId++;   /* Send */   AF_DataRequest( &dstAddr,  &sampleSw_TestEp,//已经创建好的简单描述符 cid,   len,  data,   &transferId, AF_TX_OPTIONS_NONE, AF_DEFAULT_RADIUS );//指定了最大的路由跳转级数 } ``` ### 从广播通信API的定义可以发现,它和点对点通信API是相似的。广播通信API中使用了网络地址0xFFFF,这表示把数据发送到该网络上的所有设备中。但其实ZigBee的广播地址一共有3个,如下所示: ``` 0xFFFF:广播给该网络中的所有设备 0xFFFD:只广播给该网络中打开收听功能的设备 0xFFFC:只广播给该网络中的协调器和路由设备 ``` ### 同样地,开发者也可以基于AF\_DataRequest()来编写自己的广播通信API,而不使用这个工程中的默认的这个zclSampleSw\_AF\_Broadcast()。 <br/> ## **组播通信API** 使用组播通信API,可以只给指定的一组设备发送数据。在zcl\_samplesw.c文件中可以找到组播通信API,代码如下: ``` /* * @param groupId 组ID * @param cid ClusterID,后续章节将会详细讲解 * @param len 待发送数据的长度 * @param data 待发送数据的内容 */ static void zclSampleSw_AF_Groupcast( uint16 groupId, uint16 cid, uint8 len, uint8 *data) {     afAddrType_t dstAddr;     static uint8 transferId = 0;     /* Destination */     dstAddr.addrMode = afAddrGroup;//使用组播通信模式 dstAddr.addr.shortAddr = groupId; dstAddr.endPoint = SAMPLESW_ENDPOINT;//组中的设备的端点号 /* Transfer id */     transferId++;      /* Send */     AF_DataRequest(&dstAddr,  &sampleSw_TestEp,//已经创建好的简单描述符 cid,  len,  data,     &transferId,  AF_TX_OPTIONS_NONE, AF_DEFAULT_RADIUS );//指定最大的路由跳转级数,暂时可忽略 } ``` 上述代码还是比较简单的,就是给指定的组ID发送数据。后续章节将会以实验的方式讲解如何让设备加入到指定的组中。 <br/> <br/> ## **项目定制** * 如需项目定制开发,可扫码添加项目经理好友(注明“**项目定制**”) * 定制范围:**NB-IoT**、**CATn(4G)**、**WiFi**、**ZigBee**、**BLE Mesh**以及**STM32**、**嵌入式Linux**等IoT技术方案 * 善学坊官网:[www.sxf-iot.com](https://www.sxf-iot.com/) ![](https://img.kancloud.cn/ca/73/ca739f92cab220a3059378642e3bd502_430x430.png =200x) * 非项目定制**勿扰**,此处**非**技术支持