刚入手的朋友,对 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 我们来看看没有修改的函数演示现象 |