TI例程翻译.doc

2、GenericApp 2.1、引言 GenericApp介绍了应用、程序和消息流的结构。 2.2、程序流 2.2.1、初始化 系统上电时，会调用初始化函数GenericApp_Init()。 GenericApp_TaskID = task_id; OSAL通过函数参数的调用给GenericApp分配一个Id。GenericApp使用这个任务Id设置自己的时钟、事件、发送OSAL消息。上述的操作将一个比较大的处理注册（processing up）分割成小的部分，它们在OSAL上连续的时隙上执行，避免了单个时隙消耗太多的时间。当一个任务被分为小的部分以便能够在每个时隙上执行时，这个任务各个部分的协调就必须有OSAL来完成。 GenericApp_NwkState = DEV_INIT; 维持一个设备网络状态的副本是有用的。上电时的网络状态是“not connected”或者“DEV_INIT”。在上电时或上电后，OSAL任务不会收到此默认状态的ZDO_STATE_CHANGE消息，因此，必须首先初始化系统并维持网络状态。当得到一个新的网络状态时，任务会得到一个ZDO_STATE_CHANGE消息。应该注意的是，使用ZDO_STATE_CHANGE一个设备并在一个电源周期（power cycle）之前与一个网络连接时，上电后不久任务将得到一个ZDO_STATE_CHANGE消息，因为“network connected”这个状态信息将会依照非易失性存储器的内容而被修复。 GenericApp_DstAddr.addrMode = (afAddrMode_t)AddrNotPresent; GenericApp_DstAddr.endPoint = 0; GenericApp_DstAddr.addr.shortAddr = 0; 初始化默认的目的地址以便向协调器（网络地址为0x0000）发送消息，协调器的ZDO（EndPoint 0x00）接收消息。这种传递方式是间接的，它依靠网络反射设备（network reflector device）（通常为协调器）将源地址与目的地址绑定表中的目的端点连接起来。如果没有匹配的绑定存在，消息将在协调器中被终止，而即使一个带有AF_ACK_REQUEST标志位的消息被发送，GenericApp仍然会收到一个AF_DATA_CONFIRM_CMD消息（Zsuccess状态）。 GenericApp_epDesc.endPoint = GENERICAPP_ENDPOINT; GenericApp_epDesc.task_id = GenericApp_TaskID; GenericApp_epDesc.simpleDesc = SimpleDescriptionFormat_t *)GenericApp_SimpleDesc; GenericApp_epDesc.latencyReq = noLatencyReqs; // Register the endpoint description with the AF afRegister( GenericApp_epDesc ); 上述代码描述了GenericApp应用对象。它告知应用框架层（AF layer）如何路由发送给GENERICAPP_PROFID / GENERICAPP_ENDPOINT的数据包。这个过程是通过向GenericApp_TaskID发送一个OSALSYS_EVENT_MSG-message (AF_INCOMING_MSG_CMD)来完成的。 RegisterForKeys( GenericApp_TaskID ); GenricApp注册按键服务。 2.2.2、事件处理 一个GenericApp_TaskID事件发生后，调用GenericApp事件处理函数（GenericApp_ProcessEvent()），这些事件处理函数在OSAL的任务处理循环中依次被触发。GenericApp_ProcessEvent()的参数是一个16位的位掩码（bit mask）；调用该函数会设置一位或更多的位。如果有多个事件发生，建议一个任务只处理其中的一个事件（可能为对时间要求高的事件，或者是优先级最高的SYS_EVENT_MSG）。 if ( events SYS_EVENT_MSG ) { MSGpkt = (afIncomingMSGPacket_t*)osal_msg_receive( GenericApp_TaskID ); while ( MSGpkt ) { … 在上面虽然建议一个任务调用事件处理函数只处理一个待定的事件，但是在应用例程中也可以在同一个时间片（time slice）内处理所有待定的SYS_EVENT_M