Z-Stack中SimpleApp开关结点加入网络流程
(1)开关结点初始化
这时选择的节点类型是终端节点,所以使用f8wEndev.cfg文件,所以在Zglobals.h文件中,我们可以得到下面的定义
#define ZG_DEVICETYPE_ENDDEVICE 0x02
#define DEVICE_LOGICAL_TYPE ZG_DEVICETYPE_ENDDEVICE
uint8 zgDeviceLogicalType = DEVICE_LOGICAL_TYPE;
开关节点的 IAR 工程配置选项中定义了阻止自定义启动,即 HOLD_AUTO_START,因此在ZDApp.c 文件中定义了设备初始状态和启动模式:
devState = DEV_HOLD //不会自动启动
devStartMode = MODE_JOIN //加入
#if defined( HOLD_AUTO_START )
devStates_t devState = DEV_HOLD;
#else
devStates_t devState = DEV_INIT;
#endif
#if defined( ZDO_COORDINATOR ) && !defined( SOFT_START )
// Set the default to coodinator
devStartModes_t devStartMode = MODE_HARD;
#else
devStartModes_t devStartMode = MODE_JOIN; // Assume joining
//devStartModes_t devStartMode = MODE_RESUME; // if already "directly joined"
// to parent. Set to make the device do an Orphan scan.
#endif
在开关节点的NV 中,默认状态下没有设置启动模式,即
ZCD_NV_STARTUP_OPTION=0
因此,初次使用开关节点时不会自定启动该节点。
另外,对应开关节点的 SimpleSwitch.c定义了应用层的状态:
myAppState = APP_INIT
(2)加入网络
当开关节点上电后,首先经历一系列的初始化工作,最终在 sapi 层设置进入事件,然后通过任务事件处理函数对该事件进行处理,当读取 NV 的启动模式选项时,在SAPI_ProcessEvent()函数中 if ( events & ZB_ENTRY_EVENT ) { }判断中;
zb_ReadConfiguration( ZCD_NV_STARTUP_OPTION, sizeof(uint8), &startOptions );
判断为非自动启动,因此看到开关节点的LED_2 闪烁,
HalLedBlink(HAL_LED_2, 0, 50, 500);
操作系统等待其他事件发生。
当按下按键S1 后,由于在 sapi 层注册了按键事件,因此会发送 KEY_CHANGE 消息至sapi层,当收到 KEY_CHANGE 消息后,sapi 层的任务事件处理函数调用: 在SAPI_ProcessEvent()函数中的if ( events & SYS_EVENT_MSG ){ }判断中。
zb_HandleKeys( ((keyChange_t *)pMsg)->state, ((keyChange_t *)pMsg)->keys );
然后将设备逻辑类型(终端设备)写入到NV,并将自动启动模式写入到 NV: 在SimpleSwitch.c文件中。
zb_WriteConfiguration(ZCD_NV_LOGICAL_TYPE, sizeof(uint8), &logicalType);
zb_WriteConfiguration( ZCD_NV_STARTUP_OPTION, sizeof(uint8), &startOptions );
最后重新启动: 在zb_HandleKeys()函数中
zb_SystemReset();
重新启动后,依然进入通过任务事件处理函数对进入事件进行处理,当读取 NV 的启动模
式选项时,判断为自动启动,然后调用: 在SAPI_ProcessEvent()函数
zb_StartRequest();
紧接着在zb_StartRequest(); 函数中调用 ZDO层的初始化设备函数: 在ZDApp.c文件中
ZDOInitDevice(zgStartDelay);
在该函数中设置了 NV 网络状态,并修改了当前设备状态:
networkStateNV = ZDO_INITDEV_NEW_NETWORK_STATE;
devState = DEV_INIT;
最终触发网络初始化函数:
ZDApp_NetworkInit( extendedDelay );
设置网络初始化事件:
osal_set_event( ZDAppTaskID, ZDO_NETWORK_INIT );
ZDO 层的任务事件处理函数对网络初始化事件进行处理,即启动该设备:在ZDObject.c文件中
ZDO_StartDevice((uint8)ZDO_Config_Node_Descriptor.LogicalType,devStartMode, EFAULT_BEACON_ORDER,DEFAULT_SUPERFRAME_ORDER );
此时将改变设备状态为设备发现网络: 到这里前面建立网络的步骤相同,这里设备的状态不发生了改变。
devState = DEV_NWK_DISC;
并调用请求发现网络函数: 这个函数是不开源的
NLME_NetworkDiscoveryRequest(zgDefaultChannelList,zgDefaultStarting ScanDuration );
其中,通道号为协调器所在通道。
当 NWK 层通过调用 MAC 和 PHY 层相关功能函数执行一些列发现网络动作后,NWK 层将接收到发现网络反馈,即: 始终没有发现调用该函数的地方在那里,可能在不开源的网络层中调用了。
ZDO_NetworkDiscoveryConfirmCB( uint8 ResultCount, networkDesc_t *NetworkList )
其中,网络参数列表为该网络详细的网络参数。并将其中的个域网 ID、逻辑通道、版本号和扩展个域网 ID号组成网络发现确认消息发送至ZDO层:
ZDApp_SendMsg(ZDAppTaskID,ZDO_NWK_DISC_CNF,
sizeof(ZDO_NetworkDiscoveryCfm_t), (byte*)&msg )
在ZDApp_SendMsg()函数中,调用osal_set_event() 函数,设置SYS_EVENT_MSG事件,然后在事件处理函数ZDApp_event_loop()中调用下面的函数,
ZDApp_ProcessOSALMsg( (osal_event_hdr_t *)msg_ptr );
并在此时将改变设备状态为正在加入网络:
devState = DEV_NWK_JOINING;
ZDO 层接收到该消息后,任务事件处理函数将执行请求加入网络事件: 在ZDApp.c
NLME_JoinRequest( ((ZDO_NetworkDiscoveryCfm_t *)msgPtr)->extendedPANID,
BUILD_UINT16(((ZDO_NetworkDiscoveryCfm_t*)msgPtr)->panIdLSB, ((ZDO_NetworkDiscoveryCfm_t*)msgPtr)->panIdMSB ),((ZDO_NetworkDiscoveryCfm_t*)msgPtr)->logicalChannel,ZDO_Config_Node_Descriptor.CapabilityFlags );
当NWK层通过调用MAC和PHY层相关功能函数执行一些列请求加入网络动作后, NWK层将接收到请求加入网络反馈,即: 这里也没有发现在那里调用的。
ZDO_JoinConfirmCB( uint16 PanId, ZStatus_t Status )
发送加入网络指示消息至 ZDO 层。
ZDApp_SendMsg(ZDAppTaskID,ZDO_NWK_JOIN_IND,sizeof(osal_event_hdr_t),(byte*)NULL );
ZDO 层接收到该消息后,任务事件处理函数将执行处理加入网络函数: 在ZDApp_ProcessOSALMsg函数中
case ZDO_NWK_JOIN_IND:
ZDApp_ProcessNetworkJoin();
break;
设置 ZDO状态改变事件:
osal_set_event( ZDAppTaskID, ZDO_STATE_CHANGE_EVT );
如果 IAR 设置了节点选项,所以采用电池供电:
#if defined ( POWER_SAVING )
osal_pwrmgr_device( PWRMGR_BATTERY );
#endif
ZDO 层任务事件处理函数将执行 ZDO更新网络状态事件处理:
ZDO_UpdateNwkStatus( devState );
此时搜索端点列表,寻找曾经在 sapi 层注册过的端点号,并且将 ZDO 状态改变消息发送给这些端点:
而且确定开关节点(此时为终端设备)的 16 位网络地址和 64 位IEEE 地址: 在ZDO_UpdateNwkStatus函数中。
ZDAppNwkAddr.addr.shortAddr = NLME_GetShortAddr();
(void)NLME_GetExtAddr(); // Load the saveExtAddr pointer.
当 sapi 层接收到ZDO状态改变消息后,sapi层的任务事件处理函数将进行处理:
SAPI_StartConfirm( ZB_SUCCESS );
最终将改变设备的应用状态为启动状态:zb_StartConfirm()函数中改变其状态
myAppState = APP_START;
至此,终端设备就加入了网络,状态也已改变成了启动状态。下面的过程就是绑定的过程了。
结束!
不错,谢谢分享。