zigbee scene and group

一般来说流程是这样的：先将一些节点分到一个组里，然后可以在节点上建立场景。但也可以在没有组的情况下建立场景，该种情况下是只支持单播的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 ) 

若是通过正常的组添加、移除函数的调用来更改组表，则不必调用此函数。

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 ) 
若是通过正常的组添加、移除函数的调用来更改组表，则不必调用此函数。