zstack之Sample Application分析

只是一个TI公司提供的一个完整的测试工程，同时也是TI协议入门的一个例子。

这个例子是非常简单的演示，每个设备都可以发送和接收两个信息；

周期信息-----加入该网络的所有设备每隔10S（可能会加上一个随机数的mS）都发送一个周期信息，该信息的数据载荷为发送信息次数的计数。

闪烁控制信息---------通过按下SW1可以发送一个控制灯闪烁的广播信息，该广播信息只针对组1的所有设备。

所有设备初始化为加入组1，所以网络一旦成功建立/加入就可以进行闪烁控制。可以通过按下设备的SW2退出组1，所以可以通过退出组1可以不接受闪灯信息。通过按下SW2也可以让不在组1的设备加入近组1，从而又可以接受闪灯信息了。这就是协调器组网，组完之后节点申请入网，接着协调器同意加入网络，以上就是完成这麽一个功能。（这是本人的理解）

接着就是各个部件：

按键————SW1：发送闪烁信息到组1所有设备；SW2：转换推出/加入组1状态

用户应用开发————这里涉及的是各个功能的使用，其中有一些ZIGBEE的关键术语，不是很明白，因此就不在写出来了，但还是能大概看懂。
进入初始化程序

因为Z-Stack是在OS下运行的，所以在之前必须调用osalAddTasks()初始化任务。
关于OS的API函数介绍请看文档：Z-Stack OSAL API (F8W-2003-0002)，应该说协议栈的每层或者说每部分都有相关的API说明文档。osalAddTasks()初始化任务， osalTaskAdd()函数添加任务，都可以到API文档或程序中详细分析函数功能。

OSAL和APL系统服务是唯一的，因为比如按键和串口类似事件处罚就只能用唯一的一个任务标识。这两个硬件都留给了用户自己定义使用。

应用设计是重点，下面就进行初步了解

用户可能为每一个应用对象都创建一个任务，或者为所有的应用对象只创建一个任务。当选择上述的设计的时候，下面是一些设计思路：

1.为许多应用对象创建一个OSAL任务
下面是正面和反面（pros & cons）的一些叙述：
- Pro：接受一个互斥任务事件（开关按下或串口）时，动作是单一的。
- Pro：需要堆栈空间保存一些OSAL任务结构。
- Con：接收一个AF信息或一个AF数据确认时，动作是复杂的-----在一个用户任务上，分支多路处理应用对象的信息事件。
- Con：通过匹配描述符（如：自动匹配）去发现服务的处理过程更复杂-----为了适当的对ZDO_NEW_DSTADDR信息起作用，一个静态标志必须被维持。

2、为一个应用对象创建一个OSAL任务
:一对一设计的反面和正面（pros & cons）是与上面一对多设计相反的：
- Pro：在应用对象试图自动匹配时，仅仅一个ZDO_NEW_DSTADDR被接收。
- Pro：已经被协议栈下层多元处理后的一个AF输入信息或一个AF数据确认。
- Con：需要堆栈空间保存一些OSAL任务结构。
- Con：如果两个或更多应用对象用同一个唯一的资源，接收一个互斥任务事件的动作就更复杂。

任何一个OSAL任务必须用两种方法执行：一个是初始化，另一个是处理任务事件。
1、任务初始化
在例子中调用如下函数执行任务初始化：
“Application Name”_Init（如SAPI_Init）。该任务初始化函数应该完成如下功能：
变量或相应应用对象特征初始化，为了使OSAL内存管理更有效，在这里应该分配永久堆栈存储区。
在AF层登记相应应用对象（如：afRegister()）。
登记可用的OSAL或HAL系统服务（如：RegisterForKeys()）

2、任务事件处理
调用如下函数处理任务事件：
“Application Name”_ProcessEvent (e.g. SAPI_ProcessEvent()).除了强制的事件之外，任一OSAL任务能被定义多达15个任务事件。
一个任务事件SYS_EVENT_MSG (0x8000), 被保留必须通过OSAL任务设计

1、SYS_EVENT_MSG (0x8000)
任务事件管理者应该处理如下的系统信息子集，下面只列出了部分信息，但是是最常用的几个信息处理，推荐根据例子复制到自己项目中使用。

a.AF_DATA_CONFIRM_CMD
调用AF_DataRequest()函数数据请求成功的指示。Zsuccess确认数据请求传输成功，如果数据请求设置AF_ACK_REQUEST标志位，那么，只有最终目的地址成功接收后，Zsuccess确认才返回。如果如果数据请求没有设置AF_ACK_REQUEST标志位，那么，数据请求只要成功传输到下跳节点就返回Zsuccess确认信息。

b.AF_INCOMING_MSG_CMD
AF信息输入指示

c.KEY_CHANGE
键盘动作指示

d.ZDO_NEW_DSTADDR
匹配描述符请求（Match Descriptor Request）响应指示。（例如：自动匹配）

e.ZDO_STATE_CHANGE
网络状态改变指示

网络格式化

示例应用程序编译为协调器的在default_chanlist指定的通道上形成一个网络，协调器将建立一个随机编号源于自身的IEEE地址或由zdapp_config_pan_id指定的网络PAN ID（如果zdapp_config_pan_id不为0xFFFF）。
示例应用程序编译为路由器或结束设备的将尝试加入网络在default_chanlist指定的通道上，如果zdapp_config_pan_id没有定义为0 xFFFF ，路由器将受到限制，只有加入参数zdapp_config_pan_id规定的网络PAN ID。

设备自动开始尝试组建或加入网络。如果设备设置为等待计时器或其他外部事件发生后才启动，那么HOLD_AUTO_START必须被定义。为了稍后以手动启动方式启动设备，那么需要调用ZDApp_StartUpFromApp(函数）

为了在形成网络过程中节省所需的设备类型，那么所有的路由器设备可以被通过soft_star定义作为一个协调器。如果自动启动是需要的话，那么auto_soft_start必须被定义。

通过设置NV_RESTORE和/或NV_INIT，可以让设备断电或者意外掉电重新启动后重新回复网络。

当设备形成或加入网络后会发通报到ZDO_STATE_CHANGE信息事件。

终于写完了，虽然有些简单但是我已把主要的一些流程详细的介绍了希望对大家有好处。