刚入手的朋友,对 Z-Stack 非常迷糊的时期,如果能够跑通几个例子、看几个演示,那么可以大大提高学习兴趣;另外如果知道某个例子的大致功能及实现,那么在去看具体实现过程目的性就非常明确。 首先来看看 TI 究竟有哪些例子: 可以看出其例子是非常丰富的。 GenericApp(设备互相绑定传送信息-hellow world),Location(定位),SampleApp(设备发送和接收LED灯信息),SimpleApp(温度和灯开关,和智能家居结合使用的,have Pro 1、GenericApp 实验说明:首先启动一个网络协调器,协调器如果建立网络成功后,会在 LCD 上显示该节点为协调者同时显示网络 ID号。然后打开一个终端节点或路由器的电源,此时节点会自动加入网络。加入网络成功后,节点会显示自己的节点类型、网络地址和父节点的网络地址。 节点加入网络成功后,首先把主机模块的摇杆往右拔一下,然后把要绑定模块的 RIGHT按一下,如果两边的 LED4 都熄灭或是点亮后马上熄灭,表示绑定成功。绑定成功后,两个节点就开始相互定时发送数据,并在对方的LCD屏上显示出来,发送的数据为”Hello World”。此时如果把相互绑定模块中的 left 按一下,可以发送 Match Description Request命令,对方则显示 Match Description Request信息。(以上无线龙手册提供) 2 关键函数分析: 我开始没搞清楚,功能是个啥 大约浏览了下,这个例子似乎还与设备的 所以还决定看看程序来判断这个例子的功能。 绑定有关系,在key control 描述中发现 //***************** Key control**************************// SW2: initiates end device binding //–初始化中断设备绑定 2.1 按建处理程序中发现: // Initiate an End Device Bind Request for the mandatory endpoi // Initiate a Match Deion Request (Service Discovery) if ( AF_DataRequest( &GenericApp_DstAddr, &GenericApp_epDesc, typedef struct 2、端点描述符:&GenericApp_epDesc |
4、发送数据
数据长度:(byte)osal_strlen( theMessageData ) + 1,
数据载荷: (byte *)&theMessageData,
5、发送 ID:&GenericApp_TransID
6、选项:AF_DISCV_ROUTE
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
// HalLcdWriteScreen( (char*)pkt->cmd.Da
Print8(HAL_LCD_LINE_2,10,” “, 1);
Print8(HAL_LCD_LINE_3,10,” “, 1);
Print8(HAL_LCD_LINE_2,10,(INT8U*)pkt->cmd.Da
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) );
HalLcdWriteScreen( (char*)pkt->cmd.Da
#elif defined( WIN32 )
WPRINTSTR( pkt->cmd.Da
#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 );
}
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;
// Da
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_DA
// This message is received as a confirmation of a da
// 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;
// Act
if ( sentStatus != ZSuccess )
{
// The da
}
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
我们来看看没有修改的函数演示现象