通信例程之GenericApp

zigbee学习笔记3-通信例程之GenericApp

刚入手的朋友，对 Z-Stack 非常迷糊的时期，如果能够跑通几个例子、看几个演示，那么可以大大提高学习兴趣；另外如果知道某个例子的大致功能及实现，那么在去看具体实现过程目的性就非常明确。 
首先来看看 TI 究竟有哪些例子： 可以看出其例子是非常丰富的。 
       GenericApp（设备互相绑定传送信息-hellow world），Location（定位），SampleApp（设备发送和接收LED灯信息），SimpleApp(温度和灯开关，和智能家居结合使用的，have Profile)，HomeAutomation（智能家居的应用，have Profile），SerialApp（串行传输的应用），Transmit（发送应用）， ZLOAD（协议文件夹中只有Source）。这样看来还是不少的。其中 SampleApp 例子已经在前面的学习中有所涉及，可以说前面的所有学习都是基于这个例子的，所以这里就不测试它了。 Location 是定位的测试例子，这里我的硬件是不够的，所以也不做测试。其他我都做点测试，能成功的就成功，不能成功的就失败，这个我也没办法。

       1、GenericApp 
      这个实验是两个模块相互绑定后可以对传数据，模块绑定之后，两个模块之间相互传输字符串”Hello World”。

       实验说明：首先启动一个网络协调器，协调器如果建立网络成功后，会在 LCD 上显示该节点为协调者同时显示网络 ID号。然后打开一个终端节点或路由器的电源，此时节点会自动加入网络。加入网络成功后，节点会显示自己的节点类型、网络地址和父节点的网络地址。

节点加入网络成功后，首先把主机模块的摇杆往右拔一下，然后把要绑定模块的 RIGHT按一下，如果两边的 LED4 都熄灭或是点亮后马上熄灭，表示绑定成功。绑定成功后，两个节点就开始相互定时发送数据，并在对方的LCD屏上显示出来，发送的数据为”Hello World”。此时如果把相互绑定模块中的 left 按一下，可以发送 Match Description Request命令，对方则显示 Match Description Request信息。（以上无线龙手册提供）

2 关键函数分析：

我开始没搞清楚，功能是个啥 大约浏览了下，这个例子似乎还与设备的 所以还决定看看程序来判断这个例子的功能。 绑定有关系，在key control   描述中发现

//***************** Key control**************************//

SW2: initiates end device binding           //–初始化中断设备绑定
       SW4: initiates a match description request //–初始化一个匹配描述请求

2.1 按建处理程序中发现： 
if ( keys & HAL_KEY_SW_2 ) 
    { 
      HalLedSet ( HAL_LED_4, HAL_LED_MODE_OFF );

      // Initiate an End Device Bind Request for the mandatory endpoi
nt 
      dstAddr.addrMode = Addr16Bit; 
      dstAddr.addr.shortAddr = 0x0000; // Coordinator 
      ZDP_EndDeviceBindReq( &dstAddr, NLME_GetShortAddr(), 
                            GenericApp_epDesc.endPoint, 
                            GENERICAPP_PROFID, 
                            GENERICAPP_MAX_CLUSTERS, (cId_t *)Generic
App_ClusterList, 
                            GENERICAPP_MAX_CLUSTERS, (cId_t *)Generic
App_ClusterList, 
                            FALSE ); 
} 
很明显这里按键 2（右键）是发送绑定请求的命令。 
if ( keys & HAL_KEY_SW_4 ) 
    { 
      HalLedSet ( HAL_LED_4, HAL_LED_MODE_OFF );

      // Initiate a Match Deion Request (Service Discovery) 
      dstAddr.addrMode = AddrBroadcast; 
      dstAddr.addr.shortAddr = NWK_BROADCAST_SHORTADDR; 
      ZDP_MatchDescReq( &dstAddr, NWK_BROADCAST_SHORTADDR, 
                        GENERICAPP_PROFID, 
                        GENERICAPP_MAX_CLUSTERS, (cId_t *)GenericApp_
ClusterList, 
                        GENERICAPP_MAX_CLUSTERS, (cId_t *)GenericApp_
ClusterList, 
                        FALSE ); 
    } 
显然按键 4（左）是初始化一个匹配描述符请求，也就是发现服务，或者叫自动寻求匹配设备。 
2.2 在发送数据发现：
void GenericApp_SendTheMessage( void ) 
{ 
char theMessageData[] = “Hello World”;

if ( AF_DataRequest( &GenericApp_DstAddr, &GenericApp_epDesc, 
                       GENERICAPP_CLUSTERID, 
                       (byte)osal_strlen( theMessageData ) + 1, 
                       (byte *)&theMessageData, 
                       &GenericApp_TransID, 
                       AF_DISCV_ROUTE, AF_DEFAULT_RADIUS ) == afStatu
s_SUCCESS ) 
{ 
    // Successfully requested to be sent. 
} 
else 
{ 
    // Error occurred in request to send. 
} 
}
      这里发送了”Hello World”字符串。如果更改这里，是可以在接收端看到变化的。 这里调用了 AF_DataRequest 函数，该函数为 AF层请求发送数据函数。 
afStatus_t AF_DataRequest( afAddrType_t *dstAddr, endPointDesc_t *srcEP, 
                                              uint16 cID, uint16 len, uint8 *buf, uint8 *transID, 
                                              uint8 options, uint8 radius ) 
我想最关心的就是几个参数： 

1、目标地址：&GenericApp_DstAddr

typedef struct
{
union
{
    uint16 shortAddr;
} addr;
afAddrMode_t addrMode;
byte endPoint;
} afAddrType_t;//–里面定义了目标地址模式、地址、EP三个参数

2、端点描述符：&GenericApp_epDesc 
typedef struct 
{ 
byte endPoint; 
byte *task_id; // Pointer to location of the Application task ID. 
SimpleDescriptionFormat_t *simpleDesc; 
afNetworkLatencyReq_t latencyReq; 
} endPointDesc_t; 
3、串 ID 

#define GENERICAPP_CLUSTERID          1 
4、发送数据 
数据长度：(byte)osal_strlen( theMessageData ) + 1, 
数据载荷： (byte *)&theMessageData, 
5、发送 ID：&GenericApp_TransID

6、选项：AF_DISCV_ROUTE 

#define AF_DISCV_ROUTE                     0x20 
7、发送半径：AF_DEFAULT_RADIUS 
#define AF_DEFAULT_RADIUS                  DEF_NWK_RADIUS 
网络路由深度，初始化为： #define DEF_NWK_RADIUS    10

2.3 接收处理函数发现 ：

void GenericApp_MessageMSGCB( afIncomingMSGPacket_t *pkt ) ///接收处理函数
{
switch ( pkt->clusterId )
{
    case GENERICAPP_CLUSTERID:
      // “the” message

#if defined( LCD_SUPPORTED )
     // HalLcdWriteScreen( (char*)pkt->cmd.Data, “rcvd” );
      Print8(HAL_LCD_LINE_2,10,”                “, 1);
      Print8(HAL_LCD_LINE_3,10,”                “, 1);
      Print8(HAL_LCD_LINE_2,10,(INT8U*)pkt->cmd.Data, 1);
      Print8(HAL_LCD_LINE_3,16, “WXL Welcome”, 1);
      break;
#endif

}
}
       接收数据处理函数里居然要通过液晶显示，本人这里的液晶暂时没有移植过来，因为暂时还不具备那个实力，怪不得看不到发送数据的状况！这里本人就自作聪明的把以前 SampleApp 例子里面的一句话加过来了： 
void GenericApp_MessageMSGCB( afIncomingMSGPacket_t *pkt ) //–修改的哦
{ 
switch ( pkt->clusterId ) 
{ 
    case GENERICAPP_CLUSTERID: 
      // “the” message 
HalLedBlink( HAL_LED_4, 4, 50, (500) );

#if defined( LCD_SUPPORTED ) 
      HalLcdWriteScreen( (char*)pkt->cmd.Data, “rcvd” ); 
#elif defined( WIN32 ) 
      WPRINTSTR( pkt->cmd.Data ); 
#endif 
      break; 
} 
} 
      麽想到啊，这么一加居然就有反应了！其实这里很简单的了，就是接收到数据后闪烁 4 下灯，间隔 0.5S。因为从：GenericApp_ProcessEvent中有周期性发送函数

2.4 周期性发送函数

if ( events & GENERICAPP_SEND_MSG_EVT ) 
{ 
    // Send “the” message 
    GenericApp_SendTheMessage(); //–发送信息
    // Setup to send message again 
    osal_start_timerEx( GenericApp_TaskID, 
                        GENERICAPP_SEND_MSG_EVT, 
                        GENERICAPP_SEND_MSG_TIMEOUT ); 
    // return unprocessed events 
    return (events ^ GENERICAPP_SEND_MSG_EVT); 
} 
        这里可以看出，这个例子很明显仅仅是个发送周期信息的例子。所以 LED4 就周期性的闪烁 4 下，当然是协调器发送，路由器闪烁，路由器发送，协调器闪烁。 该事件是一个用户事件，不在系统事件内。可以看到调用了发送函数 GenericApp_SendTheMessage();，之后又调用了osal_start_timerEx函数触发定时发送数据，所以是一个周期发送。 发送了，不一定对方一定能收到，这里只有匹配描述符的才能接收这个信息。

2.5 再来看看ZDO 响应函数：

void GenericApp_ProcessZDOMsgs( zdoIncomingMsg_t *inMsg )
{
switch ( inMsg->clusterID )
{
    case End_Device_Bind_rsp: //–绑定
      if ( ZDO_ParseBindRsp( inMsg ) == ZSuccess )
      {
        // Light LED
        HalLedSet( HAL_LED_4, HAL_LED_MODE_ON );
      }

#if defined(BLINK_LEDS)
      else
      {
        // Flash LED to show failure
        HalLedSet ( HAL_LED_4, HAL_LED_MODE_FLASH );
      }
#endif
      break;

    case Match_Desc_rsp: //–描述符匹配
      {
        ZDO_ActiveEndpointRsp_t *pRsp = ZDO_ParseEPListRsp( inMsg );
        if ( pRsp )
        {
          if ( pRsp->status == ZSuccess && pRsp->cnt )
          {
            GenericApp_DstAddr.addrMode = (afAddrMode_t)Addr16Bit;
            GenericApp_DstAddr.addr.shortAddr = pRsp->nwkAddr;
            // Take the first endpoint, Can be changed to search through endpoints
            GenericApp_DstAddr.endPoint = pRsp->epList[0];

            // Light LED
            HalLedSet( HAL_LED_4, HAL_LED_MODE_ON );
          }
          osal_mem_free( pRsp );
        }
      }
      break;
}
}

        这里两类事件，主要是针对两种按键操作的响应处理：绑定响应和描述符匹配响应。 可以看到，当绑定成功 G灯点亮，失败 G灯闪烁。 描述符匹配成功 G灯点亮。此时液晶上也会有显示。

3. 事件处理函数：

UINT16 GenericApp_ProcessEvent( byte task_id, UINT16 events )
{
afIncomingMSGPacket_t *MSGpkt;
afDataConfirm_t *afDataConfirm;

// Data Confirmation message fields
byte sentEP;
ZStatus_t sentStatus;
byte sentTransID;       // This should match the value sent

if ( events & SYS_EVENT_MSG )
{
    MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( GenericApp_TaskID );
    while ( MSGpkt )
    {
      switch ( MSGpkt->hdr.event )
      {
        case ZDO_CB_MSG:
          GenericApp_ProcessZDOMsgs( (zdoIncomingMsg_t *)MSGpkt );
          break;

        case KEY_CHANGE:
          GenericApp_HandleKeys( ((keyChange_t *)MSGpkt)->state, ((keyChange_t *)MSGpkt)->keys );
          break;

        case AF_DATA_CONFIRM_CMD:
          // This message is received as a confirmation of a data packet sent.
          // The status is of ZStatus_t type [defined in ZComDef.h]
          // The message fields are defined in AF.h
          afDataConfirm = (afDataConfirm_t *)MSGpkt;
          sentEP = afDataConfirm->endpoint;
          sentStatus = afDataConfirm->hdr.status;
          sentTransID = afDataConfirm->transID;
          (void)sentEP;
          (void)sentTransID;

          // Action taken when confirmation is received.
          if ( sentStatus != ZSuccess )
          {
            // The data wasn’t delivered – Do something
          }
          break;

        case AF_INCOMING_MSG_CMD:
          GenericApp_MessageMSGCB( MSGpkt );
          break;

        case ZDO_STATE_CHANGE:
          GenericApp_NwkState = (devStates_t)(MSGpkt->hdr.status);
          if ( (GenericApp_NwkState == DEV_ZB_COORD)
              || (GenericApp_NwkState == DEV_ROUTER)
              || (GenericApp_NwkState == DEV_END_DEVICE) )
          {
            // Start sending “the” message in a regular interval.
            osal_start_timerEx( GenericApp_TaskID,
                                GENERICAPP_SEND_MSG_EVT,
                                GENERICAPP_SEND_MSG_TIMEOUT );
          }
          break;

        default:
          break;
      }

      // Release the memory
      osal_msg_deallocate( (uint8 *)MSGpkt );

      // Next
      MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( GenericApp_TaskID );
    }

    // return unprocessed events
    return (events ^ SYS_EVENT_MSG);
}

// Send a message out - This event is generated by a timer
// (setup in GenericApp_Init()).
if ( events & GENERICAPP_SEND_MSG_EVT )
{
    // Send “the” message
    GenericApp_SendTheMessage();

    // Setup to send message again
    osal_start_timerEx( GenericApp_TaskID,
                        GENERICAPP_SEND_MSG_EVT,
                        GENERICAPP_SEND_MSG_TIMEOUT );

    // return unprocessed events
    return (events ^ GENERICAPP_SEND_MSG_EVT);
}

// Discard unknown events
return 0;
}

3.1 网络状态改变

        case ZDO_STATE_CHANGE:
          GenericApp_NwkState = (devStates_t)(MSGpkt->hdr.status);
          if ( (GenericApp_NwkState == DEV_ZB_COORD)
              || (GenericApp_NwkState == DEV_ROUTER)
              || (GenericApp_NwkState == DEV_END_DEVICE) )
          {
            // Start sending “the” message in a regular interval.
            osal_start_timerEx( GenericApp_TaskID,
                                GENERICAPP_SEND_MSG_EVT,
                                GENERICAPP_SEND_MSG_TIMEOUT );
          }
          break;

           一旦网络设备类型确定，就表示加入网络成功。那么就调用了 osal_start_timerEx 函数定期（GENERICAPP_SEND_MSG_TIMEOUT）触发发送事件，这里也是周期发送（GENERICAPP_SEND_MSG_EVT）

3.2 ZDO 响应事件 
case ZDO_CB_MSG: 
          GenericApp_ProcessZDOMsgs( (zdoIncomingMsg_t *)MSGpkt ); 
          break; 
         这里主要是对键盘事件操作后的一个 ZDO层的响应。
3.3 接收信息处理

case AF_INCOMING_MSG_CMD: 
          GenericApp_MessageMSGCB( MSGpkt );
          break; 
         调用了 GenericApp_MessageMSGCB函数。

       总的来说：例子很明显仅仅是个发送周期信息的例子。所以 LED4 就周期性的闪烁 4 下，当然是协调器发送，路由器闪烁，路由器发送，协调器闪烁（这个是在我改过后的情况）。 这例子里体现了绑定的概念，应该说是从基本功能上很齐全的一个例子，而且在 ZSTACK 上实现无线网络数传，没有任何多余的功能。所以该例子是一个典型的 ZSTACK 模板，也就是为用户提供了一个通用模板可以通过这个建立自己的应用。关于如何在这个例子上建立、修改成自己的工程和应用项目详细见文档： Create New Application For The CC2430DB_F8W-2005-0033_.pdf

    我们来看看没有修改的函数演示现象