当前位置：文档之家 › Sampleapp函数解析

Sampleapp函数解析

  • 格式：doc
  • 大小：56.00 KB
  • 文档页数：7

Z-Stack1.4.3-1.2.1中SampleApp中重要函数解析 (2010-11-30 10:26)分类：ZigBee 技术学习在上几篇文章中我们分析了，整个OSAL的流程，还有添加自己的任务，以及如何运行到自己定义的任务。

这一篇文章主要是分析一下，自己定义的任务中要完成的功能，需要的事件函数是怎样的。

这个例子就是一个简单的点对点的数据发送，其中涉及到较少的网络配置，其中最主要的两个函数是SampleApp_ProcessEvent(uint8 task_id,uint16 events),和SampleApp_Init（taskID），一个是任务的处理函数，一个是初始化函数。

SampleApp_Init(taskID)这个函数在前面的文章中也已经分析过了，现在主要关注一下SampleApp_ProcessEvent(uint8 task_id,uint16 events)函数的实现。

每个应用任务都通过SampleApp_ProcessEvent()函数来处理任务中的事件。

一旦SampleApp_TaskID任务的某个OSAL 事件发生，那么就可以通过调用SampleApp_ProcessEvent()函数来处理。

在SampleApp_ProcessEvent()中有一个事件处理循环，循环检测是哪个事件发生。

/******************************************************************** ** @fnSampleApp_ProcessEvent** @brief Generic Application Task event processor. This function* is called to process all events for the task. Events* include timers, messages and any other user defined events.* 这个函数被用来调用处理所有的事件，事件有定时器消息用户自己定义的* @paramtask_id - The OSAL assigned task ID.任务ID号* @param events - events to process. This is a bit map and can* contain more than one event. 处理的事件，这是一个位图** @return none*/uint16 SampleApp_ProcessEvent( uint8 task_id, uint16 events ){afIncomingMSGPacket_t *MSGpkt;//系统事件号SYS_EVENT_MSG = 0x8000if ( events & SYS_EVENT_MSG ){//检索收到的命令，没有收到返回NULLMSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( SampleApp_TaskID ); while ( MSGpkt ) //如果不为空时，判断消息的类型{switch ( MSGpkt->hdr.event ) //这里是判断SYS_EVENT_MSG事件类型，不同的SYS_EVENT_MSG类型需要不同的处理。

{/* Received when a key is pressed这里判断是否是键盘事件，如果键盘事件就调用键盘处理函数。

如果一个OSAL任务已经被登记组侧，那么任何键盘事件都将接受一个KEY_CHANGE事件信息。

可能有如下几种方式得到键盘事件信息1）、HAL检测到键盘按下（中断或者查询检测）2）、HAL的OSAL任务检测到一个键盘状态改变调用回叫函数产生3）、OSAL键盘改变回叫函数发送一个OSAL系统事件信息（KEY_CHANGE）。

*/case KEY_CHANGE:SampleApp_HandleKeys( ((keyChange_t *)MSGpkt)->state, ((keyChange_t*)MSGpkt)->keys );break;// Received when a messages is received (OTA) for this endpoint 收到信息事件case AF_INCOMING_MSG_CMD:SampleApp_MessageMSGCB( MSGpkt ); //执行信息回调函数break;// Received whenever the device changes state in the network 网络中的设备状态发生改变时，产生的事件消息case ZDO_STATE_CHANGE:SampleApp_NwkState = (devStates_t)(MSGpkt->hdr.status); //获得当前的状态if ( (SampleApp_NwkState == DEV_ZB_COORD) //判断其类型|| (SampleApp_NwkState == DEV_ROUTER)|| (SampleApp_NwkState == DEV_END_DEVICE) ){// Start sending the periodic message in a regular interval. 发送周期信息osal_start_timerEx(SampleApp_TaskID,SAMPLEAPP_SEND_PERIODIC_MSG_EVT,SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT );}else{// Device is no longer in the network}break;default:break;}// Release the memory 释放内存osal_msg_deallocate( (uint8 *)MSGpkt );// Next - if one is available 得到任务中下一个等待处理的事件MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( SampleApp_TaskID );}// return unprocessed events 返回没有处理的事件return (events ^ SYS_EVENT_MSG);}// Send a message out - This event is generated by a timer// (setup in SampleApp_Init()). 向外发送信息，该事件是由定时器产生if ( events & SAMPLEAPP_SEND_PERIODIC_MSG_EVT ){// Send the periodic message 发送周期信息SampleApp_SendPeriodicMessage();// Setup to send message again in normal period (+ a little jitter) 第三个参数是定时的时间osal_start_timerEx(SampleApp_TaskID,SAMPLEAPP_SEND_PERIODIC_MSG_EVT,(SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT + (osal_rand() & 0x00FF)) );// return unprocessed events 返回没有处理的事件return (events ^ SAMPLEAPP_SEND_PERIODIC_MSG_EVT);}// Discard unknown eventsreturn 0;}说明：(1)afIncomingMSGPacket_t *MSGpkt; 其中afIncomingMSGPacket_t是一个结构体，这个结构体中包括传输的帧的格式。

typedefstruct{osal_event_hdr_thdr;uint16groupId;uint16clusterId;afAddrType_tsrcAddr;byteendPoint;bytewasBroadcast;byteLinkQuality;byteSecurityUse;uint32 timestamp;afMSGCommandFormat_tcmd;} afIncomingMSGPacket_t;(2) 这里的SYS_EVENT_MSG是系统事件，也是协议栈已经定义好的系统事件，在文件ZcomDef.h中，事件号是一个16bit的常量，使用叫作独热码（one-hot code）编码，也是一个位表示一个事件，方便进行event的提取，这样一个task最多可以有16个event，SYS_EVENT_MSG已经占用了0x8000，故自定义的个事件只能有15个，事件的提取和清除可以用简单的位操作指令实现，事件的提取可以用位与操作events & SYS_EVENT_MSG,事件的清除可以用异或操作实现，evets ^ SYS_EVENT_MSG ，系统事件包括了各种系统消息（message）,系统事件中的消息号是一个8bit常量，也就是一事件可以包括255个消息，定义在ZcomDef.h 中。

#define SYS_EVENT_MSG 0x8000 // A message is waiting event/******************************************************************** ** Global System Messages*/#define SPI_INCOMING_ZTOOL_PORT 0x21 // Raw data from ZTool Port (not implemented)#define SPI_INCOMING_ZAPP_DATA 0x22 // Raw data from the ZAPP port (see serialApp.c)#define MT_SYS_APP_MSG 0x23 // Raw data from an MT Sys message#define MT_SYS_APP_RSP_MSG 0x24 // Raw data output for an MT Sys message #define AF_DATA_CONFIRM_CMD 0xFD // Data confirmation#define AF_INCOMING_MSG_CMD 0x1A // Incoming MSG type message#define AF_INCOMING_KVP_CMD 0x1B // Incoming KVP type message#define AF_INCOMING_GRP_KVP_CMD 0x1C // Incoming Group KVP type message#define KEY_CHANGE 0xC0 // Key Events#define ZDO_NEW_DSTADDR 0xD0 // ZDO has received a new DstAddr for this app#define ZDO_STATE_CHANGE 0xD1 // ZDO has changed the device's network state#define ZDO_MATCH_DESC_RSP_SENT 0xD2 // ZDO match descriptor response was sent#define ZDO_CB_MSG 0xD3 // ZDO incoming message callback用户自己定义的系统事件的消息范围为0xE0—0xFF,下面是几个比较常用的系统事件的消息。

合集下载

zigbee数据的发送和接收

zigbee数据的发送和接收

数据的发送和接收一、数据的发送在ZStack2006的协议栈中，我们只需调用函数AF_DataRequest()即可完成数据的发送。

afStatus_t AF_DataRequest( afAddrType_t *dstAddr, endPointDesc_t *srcEP,uint16 cID, uint16 len, uint8 *buf, uint8 *transID, uint8 options,uint8 radius )而我们在使用AF_DataRequest() 函数时只需要了解其参数便可以非常灵活的以各种方式来发送数据。

AF_DataRequest()函数参数说明如下：*dstAddr---------------------发送目的地址、端点地址以及传送模式*srcEP -----------------------源端点cID ---------------------------簇IDlen ---------------------------数据长度*buf -------------------------数据*transID --------------------序列号options ----------------------发送选项radius -----------------------跳数*dstAddr决定了消息发送到那个设备及那个endpoint，而簇ID(cID)决定了设备接收到信息如何处理。

簇可以理解为是一种约定，约定了信息怎么处理。

重要参数说明：1、地址afAddrType_ttypedef struct{union{uint16 shortAddr; //短地址}addr;afAddrMode_taddrMode; //传送模式byteendPoint; //端点号}afAddrType_t;2、端点描述符endPointDesc_ttypedef struct{byteendPoint; //端点号byte*task_id; //那一个任务的端点号SimpleDescriptionFormat_t*simpleDesc;//简单的端点描述afNetworkLatencyReq_tlatencyReq;}endPointDesc_t;3、简单描述符SimpleDescriptionFormat_ttypedef struct{byte EndPoint; //EPuint16 AppProfId; //应用规范IDuint16 AppDeviceId; //特定规范ID 的设备类型byte AppDevVer:4; //特定规范ID 的设备的版本byte Reserved:4; //AF_V1_SUPPORTusesforAppFlags:4.byte AppNumInClusters; //输入簇ID 的个数cId_t *pAppInClusterList; //输入簇ID 的列表byte AppNumOutClusters; //输出簇ID 的个数cId_t *pAppOutClusterList; //输出簇ID 的列表}SimpleDescriptionFormat_t;4、簇ID cIDClusterID--具体应用串ID5、发送选项options发送选项有如下选项#defineAF_FRAGMENTED 0x01#defineAF_ACK_REQUEST 0x10#defineAF_DISCV_ROUTE 0x20#defineAF_EN_SECURITY 0x40#defineAF_SKIP_ROUTING 0x80其中AF_ACK_REQUEST为发送后需要接收方的确认6、半径、条数radius传输跳数或传输半径，默认值为10数据发送模式说明：在协议栈数据发送模式有以下几种：单播、组播、广播和直接发送四种模式。

zigbee学习自我总结!!!!!

zigbee学习自我总结!!!!!

1. Zigbee网络节点类型Zigbee网络有三类节点类型：即协调器Coordinator、路由器Router和终端设备EndDevice，其中协调器和路由器均为全功能设备，而终端设备选用精简功能设备。

2. Zigbee协议栈各层主要功能模块3. Zigbee网络节点地址Zigbee网络协议的每一个节点皆有两个地址：６４位的ＩＥＥＥＭＡＣ地址及１６位网络地址．EUI-64（64-bit extended unique identifier）1）64-bit地址，又称为MAC地址或IEEE地址。

每个ZigBee节点都应该有全球唯一的64位IEEE地址。

这个地址需要向IEEE 组织申请才能使用。

通信时，将待发送的数据包的目的地址设为此64位IEEE 地址，从而实现数据包的正确投递。

2）16-bit地址，即网络地址，或称为短地址。

当一个ZigBee网络形成后，ZigBee 网络内的每个节点，都会分配到一个16位的网络地址。

通信时，将待发送的数据包的目的地址设为此16位网络地址。

4.Zigbee协议术语配置文件(profile)：Zigbee协议的配置文件是对逻辑组件及其相关接口的描述，是面向某个应用类别的公约、准则．通常没有程序代码与配置文件相关联．属性（attribute）：设备之间通信的每一种数据像开关的状态或温度计值等皆可称为属性．每个属性可得到唯一的ID值．簇（cluster）：多个属性的汇集形成了簇，每个簇也拥有一个唯一的ID。

虽然个体之间传输的通常是属性信息，但所谓的逻辑组件的接口指的却是簇一级的操作，而非属性一级．终端（endpoint）：每个支持一个或多个簇的代码功能块称为终端。

不同的设备通过它们的终端及所支持的簇来进行通信。

PAN IDs：PAN IDs是用来在逻辑上分离在同一领域内的多个节点组。

这样不同组之间节点通信就不会干扰，且可以在同一通道channel上（zigbee2007不行，因为它通信时可以改变频率的）Pan id是16位，范围是0x0000~03fff。

OSAL系统框架

OSAL系统框架


taskID 这个 task，设置一个 event_id，让这个事件在后面的主循环中运行到。
下面我们通过一个图表来解释下这种机制：
8
这个表就是 osalTimerUpdate 函数的“任务表”，上面讲过这个函数给应用程序提供 了“软计时”，就是体现在这里：osal_start_timerEx 通过 osalAddTimer 向链表里添加了 “定时任务”，由 osalTimerUpdate 来以 ms 为单位对这些“软定时器”减计数，溢出时， 即调用 osal_set_event，实现主循环里对任务事件的调用。
二、通过消息机制调用事件
这是另外一种设置事件（Set Event）的重要方式，下面我们以 ZStack 协议栈的基础 例程－GenericApp 来看一下按键是如何产生的，及如何调用相应的接口程序。
前文讲过，按键的相关处理都安排在了 HAL 的 task 当中，在 HAL 的核心处理函数 Hal_ProcessEvent 中，有个 HalKeyPoll 的处理函数，在 HalKeyPoll 函数中，无论按键是 ADC 方式，或者是扫描 IO 口的方式，最后都会生成一个键值 key，然后通过下面的语句来 调用按键服务程序：
1.2 任务(task)的概念 在 OSAL 中，所有的“事件”会被安排到不同的“任务”里进行执行，比如按键、串口、 LCD 等外设均被安排在 Hal 任务中，而无线数据的底层收发则放在 mac 任务中等等。 以一个简单的 OSAL 项目为例：
macTaskInit( taskID++ ); nwk_init( taskID++ ); Hal_Init( taskID++ ); MT_TaskInit( taskID++ ); APS_Init( taskID++ ); APSF_Init( taskID++ ); ZDApp_Init( taskID++ ); ZDNwkMgr_Init( taskID++ ); SampleApp_Init( taskID );
python中sample的用法

python中sample的用法

python中sample的用法在Python编程语言中，sample是一个非常实用的函数，它用于从序列（如列表、元组、字符串等）中随机抽取样本。

这对于数据分析和机器学习任务尤其有用，可以帮助我们了解数据的分布和特性。

**一、sample函数的定义**Python中的`sample()`函数可以从一个序列中抽取指定数量的随机样本。

它的基本语法如下：```pythonsample(object)```参数`object`表示需要从中抽取样本的序列。

`sample()`函数会返回一个包含随机抽取的样本的列表。

**二、sample函数的用法**1.**从列表中抽取样本**：如果我们有一个列表，我们可以使用`sample()`函数从中抽取一个或多个样本。

例如：```pythonmy_list=[1,2,3,4,5]sample_list=my_list.sample(n=3)#抽取3个样本print(sample_list)#输出：[2,4,5]（或任意三个随机的样本）```2.**从字符串中抽取随机字符**：`sample()`函数也可以用于从字符串中抽取随机字符。

例如：```pythonmy_string="Hello,World!"random_chars=my_string.sample()#抽取随机字符的字符串print(random_chars)#输出："cGhpbmlw"（任意随机的字符）```3.**混合抽取样本**：有时，我们可能希望同时抽取多个样本和字符。

在这种情况下，我们可以传递一个元组或列表给`sample()`函数，其中包含我们希望抽取的样本数量。

例如：```pythonmy_list=[1,2,3,4,5]my_string="Hello,World!"samples=(my_list.sample(n=3),my_string.sample())#同时抽取3个样本和字符的列表和字符串print(samples)#输出：([2,4,5],"cGhpbmlw")（任意三个随机的样本和任意一个随机的字符）```**三、注意事项***`sample()`函数返回的是一个新的列表或字符串，原始的序列不会被修改。