理解Zigbee 组、组表、场景
在节点分到一个群组之后，就可以在节点上建立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 )
若是通过正常的组添加、移除函数的调用来更改组表，则不必调用此函数。
- 顶
- 0
- 踩