zstack sampleApp程序分析——Zigbee的通讯方式 组播 广播 点播

Zigbee的通讯方式（即数据发送的形式）主要有三种：广播、点播、组播。

一、概念

1.1 广播

广播就是网络中任意一节点设备发出广播数据，网络中其它的任意节点都能收到。

1.2 点播

点播（也叫点对点）就是网络中任意一节点对另一个已知网络地址（即短地址）的节点进行数据发送的过程。

1.3 组播

组播（也叫组网）就是网络中所有节点设备被分组后，网络中任意组的任意一节点都可以对某一已知组号（包扩自身所属的组号）的组进行数据发送的过程。

二、相关函数的配置

如图1是为了方便了解需要修改的函数处在主函数的哪个环节而画，因此省略了某些必备的基本函数；需注意的是执行完自定义事件函数SampleApp_ProcessEvent()后并不代表主函数结束，程序将会一直待在osal_start_system()进行任务轮询。

2.1 自定义任务初始化

在任务初始化函数osalInitTasks()中添加自己写的任务（事件）的初始化函数。在SampleApp_Init ()里可以修改Zigbee通讯方式的模式、端点号、目标地址等等，相关的初始化代码如下。

// Setup for the periodic message's destination address 

SampleApp_Periodic_DstAddr.addrMode = (afAddrMode_t)afAddr16Bit;

//模式 

SampleApp_Periodic_DstAddr.endPoint = SAMPLEAPP_ENDPOINT;

//端点号 

SampleApp_Periodic_DstAddr.addr.shortAddr = 0x0001;

//目标地址 

// Fill out the endpoint description.填写端点描述 

SampleApp_epDesc.endPoint = SAMPLEAPP_ENDPOINT;  

SampleApp_epDesc.task_id = &SampleApp_TaskID; 

SampleApp_epDesc.simpleDesc = (SimpleDescriptionFormat_t *)&SampleApp_SimpleDesc; 

SampleApp_epDesc.latencyReq = noLatencyReqs; 

// By default, all devices start out in Group 1 SampleApp_Group.ID = 0x0001;

 //本设备组号 

osal_memcpy( SampleApp_Group.name, "Group 1", 7 );//组名 

aps_AddGroup(SAMPLEAPP_ENDPOINT, &SampleApp_Group);//添加新组 

2.1.1 设置模式、端点号及目标地址

SampleApp_Periodic_DstAddr.addrMode = (afAddrMode_t)afAddr16Bit;

 //通信模式 

SampleApp_Periodic_DstAddr.endPoint = SAMPLEAPP_ENDPOINT; 

//端点号 

SampleApp_Periodic_DstAddr.addr.shortAddr = 0x0001; 

//目标地址 

①SampleApp_Periodic_DstAddr对应的结构体afAddrType_t。

typedef struct 
{             
	union  { 

uint16  shortAddr;                     //目标地址    

ZLongAddr_t  extAddr;   

}addr; 

      afAddrMode_t  addrMode;       //传送模式 

      byte  endPoint;               //端点号(0~255) 

      uint16  panId;               // used for the INTER_PAN feature 

}afAddrType_t; 

②设置传送模式afAddrMode_t，只需将addrMode设置成需要的模式。

typedef enum { 

      afAddrNotPresent = AddrNotPresent,//绑定后的点播   

      afAddr16Bit      = Addr16Bit,           //点播   

      afAddr64Bit      = Addr64Bit,           // 

      afAddrGroup      = AddrGroup,              //组播   

      afAddrBroadcast  = AddrBroadcast      //广播 

} afAddrMode_t; 

③设置目标地址shortAddr（见表1）。

2.1.2 建立新组

SampleApp_Group.ID = 0x0001; //本设备组号 

osal_memcpy( SampleApp_Group.name, "Group 1", 7 );//组名 

aps_AddGroup(SAMPLEAPP_ENDPOINT, &SampleApp_Group);//往组表添加新组 

① SampleApp_Group对应的结构体aps_Group_t

typedef struct { 

      uint16 ID;                       //组号 

      uint8  name[APS_GROUP_NAME_LEN]; //组名 

} aps_Group_t; 

②添加新组aps_AddGroup()

函数原型ZStayus_t aps_AddGroup (unit8 endpiont , aps_Group_t *group);

endpoint为此终端接收或发送给字段中的组信息，

group包含将要加入组表的组号和组名。

注意：

1、 单播模式下，需要知道目标地址即接收节点的网络地址，而网络地址是由协调器随机分配的，可通过以下函数获知。
一般情况下，协调器的网络地址为0x0000,
第一个与协调器建立联系的节点为0x796F，
第二个与协调器建立联系的节点为0x7970，依此类推。

NLME_GetShortAddr()——返回本设备的16位网络地址
NLME_GetCoordShortAddr()——返回本设备的父亲设备的16位网络地址

2、组播模式下，协调器无法接收到自己发送的数据；

3、组播模式下，终端无法接收到数据，协调器或路由器却可以收到，有可能是下图所示的 FALSE没有改成TRUE；

2.2 Zigbee发送数据

Zigbee发送数据时调用函数AF_DataRequest()，只需要了解函数的参数，就可非常灵活的以各种方式来发送数据。

afStatus_t  AF_DataRequest( 
afAddrType_t *dstAddr,//发送目的地址＋端点地址和传送模式 
endPointDesc_t *srcEP,//源终端的描述(如:操作系统任务ID) uint16 cID, //用于接收器识别的标号（簇ID） 
uint16 len, //发送数据长度 
uint8 *buf, //发送数据缓冲区(即发送的数据) 
uint8 *transID, //任务ID号 
uint8 options, //有效位掩码的发送选项 
uint8 radius ); //最大传送跳数 

AF_DataRequest()函数最终调用APSDE_DataReq原语，而AF_DataRequest()函数的调用会触发afDataConfirm()函数,数据的发送结果也由afDataConfirm()函数返回，而AF_DataRequest()函数返回的值并不是真正的发送结果，返回值afStatus_t为状态，若返回值等于SUCCESS(即0x00)，则数据发送成功。

2.3 Zigbee接收数据

若Zigbee接收到数据，则进入自定义事件SampleApp_ProcessEvent()后，会触发能接收及处理数据包的函数SampleApp_MessageMSGCB()，在此函数里将处理后的数据通过串口查看。

函数SampleApp_MessageMSGCB(afIncomingMSGPacket_t *pkt)接收到的所有数据信息存储在afIncomingMSGPacket_t *pkt中。

typedef struct { 

                osal_event_hdr_t hdr;     /* OSAL Message header */   

                uint16 groupId;           /*组号（若未设置则为0）*/ 

                uint16 clusterId; /*用于识别的标号(簇ID)，应该与数据发送函数中的簇ID一致*/   
                afAddrType_t srcAddr;  
                uint16 macDestAddr;    /* MAC header destination short address */    
                uint8 endPoint;           /*端点号*/ 
                uint8 wasBroadcast;       /*判断是否为广播地址，若是返回TRUE*/   
                uint8 LinkQuality;        /* The link quality of the received data frame */ 
                uint8 correlation;        /* The raw correlation value of the received data frame */  
                int8  rssi;               /* 接收到的射频功率单位dBm */   
              	uint8 SecurityUse;        /* deprecated */ 
             	uint32 timestamp;         /* receipt timestamp from MAC */   
            	afMSGCommandFormat_t cmd; /* 接收到的数据 */ 

} afIncomingMSGPacket_t;   

typedef struct {  

               byte   TransSeqNumber;  

               uint16 DataLength;//接收到的数据长度  

     byte  *Data;//接收到的数据内容 

} afMSGCommandFormat_t; 

在SampleApp_MessageMSGCB()函数体内通过识别簇ID（与发送设备的数据发送函数中的簇ID一致），取出数据并串口显示，代码如下。

SampleApp_MessageMSGCB (afIncomingMSGPacket_t  *pkt) 
{
	switch ( pkt->clusterId ) 
	{ 

	case SAMPLEAPP_PERIODIC_CLUSTERID: //簇ID len = (char)pkt->cmd.DataLength; 
	//在这里处理数据


	 } 

}