组与场景

 
组,组表与场景

 

group是将一些节点分到一个群组中;
在节点分到一个群组之后,就可以在节点上建立scene;在建立scene的时候group ID是一个参数,所以必须先有group才能有scene。
ZCL中,scene有add,recall,remove等管理函数,比如你给一个节点发送一个命令让他add到一个scene中,你在scene的回调函数中就需要填一下存的是哪些个atrribute,然后在recall的回调函数中根据add时候的attribute来设置你被控节点的状态。
 

APS组表是由分配的RAM【osal_mem_alloc()】定义得链表,因此当组表增加时,OSAL堆也将增加。表定义在nwk_globals.c,通过调整APS_MAX_GROUPS【f8wConfig.cfg】来改变组表的最大大小。用这些API需要包含aps_groups.h头文件。 

:组是用来将一系列节点集合到一个单地址实体的方式。一个数据请求能够到达组中的每个节点。在Zigbee协议中组是可选配置,但是在某些剖面中是必选的,比如家庭自动化剖面。组关注的是一系列设备同时执行一个行为。 

组表结构体 
typedef struct 

uint16 ID; // Unique to this table 
uint8 name【APS_GROUP_NAME_LEN】; // Human readable name of group 
} aps_Group_t; 
ID -16位的组ID 
name -文本组名(人类语言)APS_GROUP_NAME_LEN为16且不可更改。 
组表入口-apsGroupItem_t 

组表记录(入口) 
typedef struct apsGroupItem 

struct apsGroupItem *next; 
uint8 endpoint; 
aps_Group_t group; 
} apsGroupItem_t; 
next -指向组表的下一个入口(组表为链表结构),推荐使用组表查找和维护函数来遍历组表。 
endpoint -接受消息的终端 
group -组ID和组名 


组表维护函数 
ZStatus_t aps_AddGroup( uint8 endpoint, aps_Group_t *group ); 
往组表中添加一个组。先定义aps_Group_t,然后填充这个结构,最后调用此函数来添加。若NV_RESTORE使能,则函数将更新保存到非易失性储存。 
返回值:成功则返回ZSuccess,否则返回错误,错误可以是:ZApsDuplicateEntry,ZApsTableFull,ZMemError【ZComDef.h】 


uint8 aps_RemoveGroup( uint8 endpoint, uint16 groupID ); 
移除一个组,若NV_RESTORE使能,则函数将更新保存到非易失性储存。 


void aps_RemoveAllGroup( uint8 endpoint ); 
按给定的参数,移除终端的所有组。 


组表查询函数 
aps_Group_t *aps_FindGroup( uint8 endpoint, uint16 groupID ); 
endpoint -将接收消息的终端 
返回值:指向组元件的指针 


uint8 aps_FindGroupForEndpoint( uint16 groupID, uint8 lastEP ); 
从组ID中查找终端,这个函数用来跳过终端,然后返回下一个终端。 
lastEP -返回的终端前要跳过的终端。用APS_GROUPS_FIND_FIRST来指定要查找的第一个终端。 
返回终端,或者APS_GROUPS_EP_NOT_FOUND(没有找到或者找到多个) 


uint8 aps_FindAllGroupsForEndpoint( uint8 endpoint, uint16 *groupList ); 
得到一个属于一个组的所有终端。 
endpoint -要查找的终端 
groupList -指向存放终端所有表的空间 


uint8 aps_CountGroups( uint8 endpoint ); 
uint8 aps_CountAllGroups( void ); 


组表的非易失性储存 
若定义了编译选项NV_RESTORE,则当组发生改变时会自动储存。组表的NV初始化和恢复在器件启动时自动执行。若用户应用改变了组表的入口,则必须直接调用Aps_GroupsWriteNV() 
void aps_GroupsWriteNV( void ) 
若是通过正常的组添加、移除函数的调用来更改组表,则不必调用此函数。 

你可能感兴趣的:(api,struct,语言,终端)