二.了解ZigBee协议栈中几个常用语句

二.了解ZigBee协议栈中几个常用语句

我在上一篇文章中说到过，zigbee作为一门通信技术，关键我们是要让它组起网来，虽然我们很多的实现还是用单片机的底板实现的；但要明白我们学习的核心在哪？在协议栈，在组网！所以我们这一次讲基础的语句，帮大家先大致了解协议栈的功能

1.初始化函数

void SampleApp_Init( uint8 task_id )

应用层任务初始化函数，在该函数下，可以初始化你要用的IO口（在这里是应用到全局的）；也可以初始化串口、ADC等外设；也可将你所使用的传感器的驱动在这里初始化；

​

MT_UartInit();                  //串口初始化
  	MT_UartRegisterTaskID(task_id); //注册串口任务
    Init_GY30();				//GY30光照传感器初始化
   HalAdcInit();                   //初始化ADC

将IO口等初始化配置在这里，也是书写上的规范，方便你后续查找、编写等等。（当然也可以初始化在你需要用到那部分）

2.任务处理函数（事件处理函数）

uint16 SampleApp_ProcessEvent( uint8 task_id, uint16 events )//任务处理函数
{
  afIncomingMSGPacket_t *MSGpkt;
  (void)task_id;  // Intentionally unreferenced parameter

  if ( events & SYS_EVENT_MSG )//系统事件
  {
    MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( SampleApp_TaskID );
    while ( MSGpkt )
    {
      switch ( MSGpkt->hdr.event )//判断消息
      {
          case CMD_SERIAL_MSG:  //串口收到数据后由MT_UART层传递过来的数据，编译时不定义MT_TASK，则由MT_UART层直接传递到此应用层
         // 如果是由MT_UART层传过来的数据，则上述例子中29 00 14 31都是普通数据，串口控制时候用的。   
          SampleApp_SerialCMD((mtOSALSerialData_t *)MSGpkt);
          break;

​    // Received when a key is pressed
​    case KEY_CHANGE:
​      SampleApp_HandleKeys( ((keyChange_t *)MSGpkt)->state, ((keyChange_t *)MSGpkt)->keys );
​      break;

​    // Received when a messages is received (OTA) for this endpoint
​    case AF_INCOMING_MSG_CMD://外部信号输入（在协调器用的多）
​      SampleApp_MessageMSGCB( MSGpkt );//消息处理函数
​      break;

​    // Received whenever the device changes state in the network
​    case ZDO_STATE_CHANGE:
​      SampleApp_NwkState = (devStates_t)(MSGpkt->hdr.status);
​      if ( //(SampleApp_NwkState == DEV_ZB_COORD) ||（协调器）
​           //  (SampleApp_NwkState == DEV_ROUTER)  ||（路由器）
​        (SampleApp_NwkState == DEV_END_DEVICE) )//状态是终端
​      {    
​          
​            Init_GY30();//判断板子的状态为终端，则初始化传感器

​       	osal_start_timerEx( SampleApp_TaskID,
​                          SAMPLEAPP_SEND_PERIODIC_MSG_EVT,
​                          SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT );
​      }//在SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT后，启动发送消息的事件SAMPLEAPP_SEND_PERIODIC_MSG_EVT
​      else
​      {
​      }
​      break;

​    default:
​      break;
  }


  osal_msg_deallocate( (uint8 *)MSGpkt );


  MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( SampleApp_TaskID );
}


return (events ^ SYS_EVENT_MSG);//返回的是系统事件，即轮询查看不停歇

  }



  if ( events & SAMPLEAPP_SEND_PERIODIC_MSG_EVT )//这是上边提到的发送消息事件
  {
    

	SampleApp_Send_P2P_Message();//在事件中再调用发送消息函数



osal_start_timerEx( SampleApp_TaskID, SAMPLEAPP_SEND_PERIODIC_MSG_EVT,
    (SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT + (osal_rand() & 0x00FF)) );

// return unprocessed events
return (events ^ SAMPLEAPP_SEND_PERIODIC_MSG_EVT);

  }


 
  return 0;
}

这一部分是重点关注的，要配置好对应终端的功能，并将事件触发，发送消息

这一部分，没有太好的方法，只能自己上手多试，多理解。

3.消息处理函数

因为我们入门先以做点对点通信来说，协调器是主要接收消息的那一方，所以我们默认它为协调器服务

void SampleApp_MessageMSGCB( afIncomingMSGPacket_t *pkt )//消息处理函数（协调器接收到数据）
{
    uint16 flashTime;

  switch ( pkt->clusterId )//这里判断的是我们发送过来的簇号（要搞明白，端口号和簇号的意思）
  {
    case SAMPLEAPP_P2P_CLUSTERID://终端0温湿度。。。。。
 // #if defined(ZDO_COORDINATOR)       
      HalUARTWrite(0, pkt->cmd.Data, pkt->cmd.DataLength); //输出接收到的数据
      HalUARTWrite(0, "\n", 1);  // 回车换行
 // #endif
      break;
   
	case SAMPLEAPP_FLASH_CLUSTERID:
  flashTime = BUILD_UINT16(pkt->cmd.Data[1], pkt->cmd.Data[2] );
  HalLedBlink( HAL_LED_4, 4, 50, (flashTime / 4) );
  break;

  }
}

函数里面就是一个switch语句，关键是case及其后面的服务函数。可以根据不同的功能，定义不同的簇ID(在SampleApp.h里进行)，然后在这个switch语句里添加一个以簇ID来命名的case，并在case里面编写自己要去实现的功能。

这个函数没有太多要深究的，只要配置好簇号，用串口将数据打印出来就好

4.消息发送函数

void SampleApp_Send_P2P_Message( void )

if ( AF_DataRequest( &SampleApp_P2P_DstAddr, &SampleApp_epDesc,
                       SAMPLEAPP_P2P_CLUSTERID,//设定好的簇号，与上边的接收方要对应
                       24,//发送的长度
                       (uint8 *)strTemp,//发送的格式
                       &SampleApp_TransID,
                       AF_DISCV_ROUTE,
                       AF_DEFAULT_RADIUS ) == afStatus_SUCCESS )
  {
  }
 {
     
  }

这里其实很简单，只要把发送函数拿来用就好了，不需要改动太多