Zigbee Group & Scene

逃离我推掉我的手 2022-07-13 06:59 265阅读 0赞

## group ##

首先是建组；

第一步：通过配置终端（带可视化界面，通过主控它知道当前网络中所有设备的地址）下发命令到主控，主控转发到Z接口模块，最后到coordinator，这条命令中包含了所有要建组的设备ID和地址，还有组ID等，到coordinator后，解析这条命令，这个时候下面的终端设备还没有这个组的信息，所以coordinator不会组播，会解析这条命令后，根据endpoint地址单独发送建组请求命令到需要家组的endpoint，在endpoint建组并保持组ID的信息到本地组表；

第二步：建组成功了后，主控再次发送具体操作组的命令到coordinator时才会组播到各个该组的endpoint。

与之前理解有点出入，开始理解的是没有开始的单播过程了，直接从主控发建组的命令到协调器就开始组表建组，但开始的时候，各endpoint是没有组的信息的，需要单播建立组后，具体的操作该组命令（例如关闭一组灯泡）才是在协调器发送组播信息。

另外：

1）同一个组中既可以有server，也可以有client。

（例如：三个灯和两个开关建组，在灯的组应答回调函数中实现开关簇的incluster操作；在开关的组应答回调函数中实现outcluster。但是这样做不好，开关不应该加入该组，在该组中没有什么意义，灯的具体开关操作不是通过这些开关设备来控制，而是上层主控下发下来的）（这是为虾米？？）。

2）一个组中可以包含多个簇。

（例如：一个dimmer灯和几个普通灯组成一组，dimmer灯有两种簇：开关簇和dimmer簇，普通灯只有开关簇。假如在这个组上建一个看电视的情景——关闭所有普通灯和调光灯到30%，则在普通灯的recall回调函数中实现关操作，在dimmer灯的recall的回到函数中实现开关操作，并执行dimmer操作）

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

add的时候把被控设备放置到你想要的状态，然后add，然后store，可以了。  
恢复情景的时候调用recall啊。  
store和recall的时候会有一个回调函数，回调函数中实现你真正地设备控制状态恢复。

## Scene ##

ENG:

In most cases scenes are associated with a particular group ID. Scenes may alsoexist without a group, in which case the value 0x0000 replaces the group ID. Note that extra care is required in these cases to avoid a scene ID collision, and that commands related to scenes without a group may only be unicast, i.e.: they may not be multicast or broadcast.

CHI:

在绝大多数情况下，**情景和一个特定的GroupID关联在一起**，情景也可能没有组而存在，在这种情况下，用GroupID 为0x0000来代替。值得特别注意的是：要避免情景ID冲突，并且没与组关联的情景相关的命令只支持单播，也就是说：它们不支持多播或组播。

资料搜索：

ZigBee Home Automation Public Application Profile.pdf

5.9.3 Commissioning Documentation

Enable Identify Mode

Sets the device in Identify mode for 60 seconds. This is used for adding devices to a group or create a scene.

Group Nodes

Used to add devices to a group. This action sends the “Add group if Identifying” command. This adds all devices that are in “identify mode” to the group. The group ID is picked by the implementer.

Create Scene

This action creates a scene using devices present in a group. For example, by a button press a “store scene” command is sent. The store scene command should sent to a Group already existing in the network. The Group ID is up to the implementer to pick.

5.9.5 Group Messaging vs. Unicast Messaging

It is important to consider that groups make use of broadcast transmissions. Group messaging should only be used when a device needs to communicate with a group of greater than

5. For groups of **less than 5**, standard binding and unicast messages should be employed. Also, there is no acknowledgement service for group messages, because they are broadcast. Unicast messaging shall be used if a device requires APS acknowledgments. The procedures for group commissioning described above can also be used to create one-to-one bindings for unicast messaging with little or no modification. When these procedures are utilized, the decision to create a group or not can be made by the application based on a local device policy. If a device is being bound to only 2 or 3 other devices, a unicast binding entry can be created for each target, and three unicasts will be sent instead of a group broadcast. When the destination is a large number of devices, a group binding entry should be created. This makes group vs. unicast messaging transparent to the user.

Home\_Automation\_Profile\_for\_public\_Download.pdf

Table 7.4

Group Nodes (Add Group If Identify)

If this feature is supported the device must provide a way for the user to send an “Add Group if Identifying Request”.

Create Scene (Store Scene)

The device must provide a way for the user to send a Store Scene request.

Compile Options

The ZCL compile options are defined in the ZCL configuration file f8wZCL.cfg, which is located in theToolsfolder of the Z-Stack installation, along with other configuration files. Thef8wZCL.cfg file is used by all projects that include the ZCL (i.e., all Home Automation projects). Therefore, any change made to this file will affect all HA projects. Compile options for other profiles, such as Smart Energy\[5\], can be found in their API documents. If needed, you can create a private version of thef8wZCL.cfgfile and modify your project to use the new version. The ZCL supported compile options and their definitions are listed in the following table:

<table> 
 <tbody> 
 <tr> 
 <td> ZCL_GROUPS </td> 
 <td> Enable the following commands: 1) Add Group 2) View Group 3) Get Group Membership 4) Remove Group 5) Remove All Groups 6) Add Group If Identifying 7) Add Group Response 8) View Group Response 9) Get Group Membership Response 10) Remove Group Response </td> 
 </tr> 
 <tr> 
 <td> ZCL_SCENES </td> 
 <td> Enable the following commands: 1) Add Scene 2) View Scene 3) Remove Group 4) Remove All Groups 5) Store Scene 6) Recall Scene 7) Get Scene Membership 8) Add Scene Response 9) View Scene Response 10) Remove Scene Response 11) Remove All Scenes Response 12) Store Scene Response 13) Get Scene Membership Response </td> 
 </tr> 
 </tbody> 
</table>

Z-Stack API.pdf

3.3.3 Group Table Management

The APS group table is a link list defined with allocated RAM \[osal\_mem\_alloc()\], so as groups are added to the table the amount of OSAL heap used increases. The maximum table size can be changed by adjusting APS\_MAX\_GROUPS in f8wConfig.cfg. The table is defined in nwk\_globals.c. To use the group table functions include “aps\_groups.h” in your application.

3.3.3.1 Group Table Structures

3.3.3.1.1 Group Item - aps\_Group\_t

This structure is the group item and contains the group ID and a text group name.

typedef struct

uint16 ID; // Unique to this table

uint8 name\[APS\_GROUP\_NAME\_LEN\]; // Human readable name of group

\} aps\_Group\_t;

ID – 16 bit group ID. This is the group ID that is set over the air.

name – text group name (Human readable). APS\_GROUP\_NAME\_LEN is defined as 16 and is not changeable.

3.3.3.1.2 Group Table Entry - apsGroupItem\_t

This structure is a Group Table record (entry). The group table is a linked list and it is highly recommended that you use the Group Table search and maintenance functions(next sections) to transverse the group table.

typedef struct apsGroupItem

struct apsGroupItem \*next;

uint8 endpoint;

aps\_Group\_t group;

\} apsGroupItem\_t;

next – points to the next group table entry. The group table is a linked list. A NULL indicates that this is the last entry in the list. It is highly recommended that you use the Group Table search and maintenance functions (next sections) to transverse the group table.

endpoint – the endpoint that will receive messages sent to the group in the group

field.

group – group ID and group name.

3.3.3.2 Group Table Maintenance

3.3.3.2.1 aps\_AddGroup()

Call this function to add a group into the group table. Define an aps\_Group\_t item,

fill it in, then call this function. If NV\_RESTORE is enabled, this function will save

the update in non-volatile memory.

Prototype

ZStatus\_t aps\_AddGroup( uint8 endpoint, aps\_Group\_t \*group );

Parameter Details

endpoint – the endpoint that will receive messages sent to the group in the group

field.

group - group ID and group name to add into the group table.

Return

ZSuccess if add was successful. Errors are ZApsDuplicateEntry, ZApsTableFull, or ZMemError (all defined in ZComDef.h).

3.3.3.2.2 aps\_ RemoveGroup()

Call this function to remove a group from the group table. If NV\_RESTORE is enabled,

this function will save the update in non-volatile memory.

Prototype

uint8 aps\_RemoveGroup( uint8 endpoint, uint16 groupID );

Parameter Details

endpoint – the endpoint to removed from a group.

groupID - group ID of the group to remove from the table.

Return

true if remove is successful, false if not the group/endpoint is not found.

3.3.3.2.3 aps\_ RemoveAllGroup ()

Call this function to remove all groups for a given endpoint from the group table. If NV\_RESTORE is enabled, this function will save the update in non-volatile memory.

Prototype

void aps\_RemoveAllGroup( uint8 endpoint );

Parameter Details

endpoint – the endpoint to removed from the group table.

Return

none.

3.3.3.3 Group Table Searching

3.3.3.3.1 aps\_ FindGroup ()

Call this function to find a group in the group table for an endpoint and group ID.

Prototype

aps\_Group\_t \*aps\_FindGroup( uint8 endpoint, uint16 groupID );

Parameter Details

endpoint – the endpoint that will receive messages sent to the group in the group

field.

groupID - group ID.

Return

Pointer to group item found or NULL if not found.

3.3.3.3.2 aps\_ FindGroupForEndpoint ()

Call this function to find an endpoint from a group ID. This function can be used to

skip past an endpoint, then return the next endpoint. Use this function to find all

the endpoints for a group ID.

Prototype

uint8 aps\_FindGroupForEndpoint( uint16 groupID, uint8 lastEP );

Parameter Details

groupID - group ID searching for.

lastEP – endpoint to skip past first before returning an endpoint. Use

APS\_GROUPS\_FIND\_FIRST to indicate that you want the first endpoint found.

Return

Returns the endpoint that matches the groupID and lastEP criteria, or

APS\_GROUPS\_EP\_NOT\_FOUND if no (more) endpoints found.

3.3.3.3.3 aps\_ FindAllGroupsForEndpoint()

Call this function to get a list of all endpoints belong to a group. The caller must

provide the space to copy the groups into.

Prototype

uint8 aps\_FindAllGroupsForEndpoint( uint8 endpoint, uint16 \*groupList );

Parameter Details

endpoint – endpoint for search.

groupList – pointer to a place to build the list of groups that the endpoint belongs.

The caller must provide the memory. To be safe, the caller should create (local or

allocated) an array of APS\_MAX\_GROUPS 16-bit items.

Return

Returns the number of endpoints copied.

3.3.3.3.4 aps\_ CountGroups()

Call this function to get a count of the number of groups that a given endpoint

belongs.

Prototype

uint8 aps\_CountGroups( uint8 endpoint );

Parameter Details

endpoint – endpoint for search.

Return

Returns the number of groups.

3.3.3.3.5 aps\_ CountAllGroups ()

Call this function to get the number of entries in the group table.

Prototype

uint8 aps\_CountAllGroups( void );

Parameter Details

none.

Return

Returns the number of groups.

3.3.3.4 Group Table Non-Volitile Storage

If NV\_RESTORE is defined in either the compiler preprocessor section or in

f8wConfig.cfg, the group table will automatically save when when a group add or remove

is performed. Group table NV init and restore functions are automatically called on

device startup.

If a group table entry is modified by the user application, it must call

Aps\_GroupsWriteNV() directly.

3.3.3.4.1 aps\_GroupsWriteNV()

This function will write the group table to non-volatile memory, and is to be called

if the user application changes anything in a group table entry (other than add,

remove or remove all). If the group table is updated normally through group add,

remove or remove all functions, there is no need to call this function.

Prototype

void aps\_GroupsWriteNV( void );

Parameter Details

none.

Return

none.

中文翻译：

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

zcl\_general.h

// The maximum number of characters to allow in a scene's name

// remember that the first byte is the length

\#define ZCL\_GEN\_SCENE\_NAME\_LEN 16

// The maximum length of the scene extension field:

// 2 + 1 + 1 for On/Off cluster (onOff attibute)

// 2 + 1 + 1 for Level Control cluster (currentLevel attribute)

// 2 + 1 + 4 for Color Control cluster (currentX/currentY attributes)

// 2 + 1 + 1 for Door Lock cluster (Lock State attribute)

// 2 + 1 + 2 for Window Covering cluster (LiftPercentage/TiltPercentage attributes)

\#define ZCL\_GEN\_SCENE\_EXT\_LEN 24

// The maximum number of entries in the Scene table

\#define ZCL\_GEN\_MAX\_SCENES 16

。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。

所有组和情景需要用到的结构体的类型定义

// The format of a Scene Table Entry

typedef struct

uint16 groupID; // The group ID for which this scene applies

uint8 ID; // Scene ID

uint16 transTime; // Time to take to transition to this scene

uint8 name\[ZCL\_GEN\_SCENE\_NAME\_LEN\]; // Scene name

uint8 extLen; // Length of extension fields

uint8 extField\[ZCL\_GEN\_SCENE\_EXT\_LEN\]; // Extension fields

\} zclGeneral\_Scene\_t;

。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。

typedef struct

afAddrType\_t \*srcAddr; // requestor's address

uint8 cmdID; // which group message - COMMAND\_GROUP\_ADD\_RSP,COMMAND\_GROUP\_VIEW\_RSP, COMMAND\_GROUP\_REMOVE\_RSP or COMMAND\_GROUP\_GET\_MEMBERSHIP\_RSP

uint8 status; // GROUP\_STATUS\_SUCCESS, GROUP\_STATUS\_TABLE\_FULL,

// GROUP\_STATUS\_ALREADY\_IN\_TABLE, or GROUP\_STATUS\_NOT\_IN\_TABLE. Not

// valid for COMMAND\_GROUP\_GET\_MEMBERSHIP\_RSP

uint8 grpCnt; // number of groups contained in group list

uint16 \*grpList; // what group IDs the action was performed on

uint8 capacity; // remaining capacity of group table

uint8 \*grpName; // only valid for COMMAND\_GROUP\_VIEW\_RSP

\} zclGroupRsp\_t;

typedef struct

afAddrType\_t \*srcAddr; // requestor's address

zclGeneral\_Scene\_t \*scene; // pointer to the scene structure

\} zclSceneReq\_t;

typedef struct

afAddrType\_t \*srcAddr; // requestor's address

uint8 cmdID; // which response - COMMAND\_SCENE\_ADD\_RSP, COMMAND\_SCENE\_VIEW\_RSP,

COMMAND\_SCENE\_REMOVE\_RSP, COMMAND\_SCENE\_REMOVE\_ALL\_RSP,

COMMAND\_SCENE\_STORE\_RSP or COMMAND\_SCENE\_GET\_MEMBERSHIPSHIP\_RSP

uint8 status; // response status

uint8 sceneCnt; // number of scenes in the scene list (only valid for

// COMMAND\_SCENE\_GET\_MEMBERSHIPSHIP\_RSP)

uint8 \*sceneList; // list of scene IDs (only valid for COMMAND\_SCENE\_GET\_MEMBERSHIPSHIP\_RSP)

uint8 capacity; // remaining capacity of the scene table (only valid for

// COMMAND\_SCENE\_GET\_MEMBERSHIPSHIP\_RSP)

zclGeneral\_Scene\_t \*scene; // pointer to the scene structure

\} zclSceneRsp\_t;

。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。

//几个需要用到的回调函数

// This callback is called to process an received Group Response message.

// This means that this app sent the request message.

// srcAddr - requestor's address

// cmdID - which group message - COMMAND\_GROUP\_ADD\_RSP, COMMAND\_GROUP\_VIEW\_RSP,

// COMMAND\_GROUP\_REMOVE\_RSP or COMMAND\_GROUP\_GET\_MEMBERSHIP\_RSP

// status - GROUP\_STATUS\_SUCCESS, GROUP\_STATUS\_TABLE\_FULL,

// GROUP\_STATUS\_ALREADY\_IN\_TABLE, or GROUP\_STATUS\_NOT\_IN\_TABLE. Not

// valid for COMMAND\_GROUP\_GET\_MEMBERSHIP\_RSP

// grpCnt - number of groups contained in group list

// grpList - what group IDs the action was performed on

// capacity - remaining capacity of group table

// grpName - only valid for COMMAND\_GROUP\_VIEW\_RSP

typedef void (\*zclGCB\_GroupRsp\_t)( zclGroupRsp\_t \*pRsp );

// This callback is called to process an incoming Scene Store request.

// The app will fill in the "extField" with what is needed to restore its

// current settings.

// srcAddr - requestor's address

// scene - pointer to the scene structure

// returns TRUE if extField is filled in, FALSE if not used.

typedef uint8 (\*zclGCB\_SceneStoreReq\_t)( zclSceneReq\_t \*pReq );

// This callback is called to process an incoming Scene Recall request

// The app will use what's in the "extField" to restore to these settings.

// srcAddr - requestor's address

// scene - pointer to the scene structure

typedef void (\*zclGCB\_SceneRecallReq\_t)( zclSceneReq\_t \*pReq );

// This callback is called to process an incoming Scene responses. This means

// that this app sent the request for this response.

// srcAddr - requestor's address

// cmdID - which response - COMMAND\_SCENE\_ADD\_RSP, COMMAND\_SCENE\_VIEW\_RSP,

// COMMAND\_SCENE\_REMOVE\_RSP, COMMAND\_SCENE\_REMOVE\_ALL\_RSP,

// COMMAND\_SCENE\_STORE\_RSP or COMMAND\_SCENE\_GET\_MEMBERSHIPSHIP\_RSP

// status - response status

// sceneCnt - number of scenes in the scene list (only valid for

// COMMAND\_SCENE\_GET\_MEMBERSHIPSHIP\_RSP)

// sceneList - list of scene IDs (only valid for COMMAND\_SCENE\_GET\_MEMBERSHIPSHIP\_RSP)

// capacity - remaining capacity of the scene table (only valid for

// COMMAND\_SCENE\_GET\_MEMBERSHIPSHIP\_RSP)

// scene - pointer to the scene structure

typedef void (\*zclGCB\_SceneRsp\_t)( zclSceneRsp\_t \*pRsp );

……………………………………………………

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* FUNCTION MACROS

\*/

\#ifdef ZCL\_GROUPS

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* @fn zclGeneral\_SendAddGroupRequest

\* @brief Send the Add Group Request to a device

\* @param srcEP - Sending Apps endpoint

\* @param dstAddr - where to send the request

\* @param cmd - one of the following:

\* COMMAND\_GROUP\_ADD

\* COMMAND\_GROUP\_ADD\_IF\_IDENTIFYING

\* @param groupID - pointer to the group structure

\* @param groupName - pointer to Group Name. This is a Zigbee

\* string data type, so the first byte is the length of the

\* name (in bytes), then the name.

\* @return ZStatus\_t

ZStatus\_t zclGeneral\_SendAddGroupRequest( uint8 srcEP, afAddrType\_t \*dstAddr,

uint8 cmd, uint16 groupID, uint8 \*groupName,

uint8 disableDefaultRsp, uint8 seqNum );

\*/

\#define zclGeneral\_SendGroupAdd(a,b,c,d,e,f) zclGeneral\_SendAddGroupRequest( (a), (b), COMMAND\_GROUP\_ADD, (c), (d), (e), (f) )

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* @fn zclGeneral\_SendGroupRequest

\* @brief Send a Group Request to a device. You can also use the

\* appropriate macro.

\* @param srcEP - Sending Apps endpoint

\* @param dstAddr - where to send the request

\* @param cmd - one of the following:

\* COMMAND\_GROUP\_VIEW

\* COMMAND\_GROUP\_REMOVE

\* @param groupID -

\* @return ZStatus\_t

ZStatus\_t zclGeneral\_SendGroupRequest( uint8 srcEP, afAddrType\_t \*dstAddr,

uint8 cmd, uint16 groupID, uint8 disableDefaultRsp, uint8 seqNum );

\*/

\#define zclGeneral\_SendGroupView(a,b,c,d,e) zclGeneral\_SendGroupRequest( (a), (b), COMMAND\_GROUP\_VIEW, (c), (d), (e) )

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* @fn zclGeneral\_SendGroupGetMembershipRequest

\* @brief Send a Get Group Membership (Resposne) Command to a device

\* @param srcEP - Sending Apps endpoint

\* @param dstAddr - where to send the request

\* @param cmd - one of the following:

\* COMMAND\_GROUP\_GET\_MEMBERSHIP

\* COMMAND\_GROUP\_GET\_MEMBERSHIP\_RSP

\* @param groupID - pointer to the group structure

\* @param groupName - pointer to Group Name. This is a Zigbee

\* string data type, so the first byte is the length of the

\* name (in bytes), then the name.

\* @return ZStatus\_t

\*/

ZStatus\_t zclGeneral\_SendGroupGetMembershipRequest( uint8 srcEP, afAddrType\_t \*dstAddr,

uint8 cmd, uint8 rspCmd, uint8 direction, uint8 capacity,

uint8 grpCnt, uint16 \*grpList, uint8 disableDefaultRsp, uint8 seqNum )

\#define zclGeneral\_SendGroupGetMembership(a,b,c,d,e,f) zclGeneral\_SendGroupGetMembershipRequest( (a), (b), COMMAND\_GROUP\_GET\_MEMBERSHIP, FALSE, ZCL\_FRAME\_CLIENT\_SERVER\_DIR, 0, (c), (d), (e), (f) )

/\* Send a Group Remove Command

\* Use like:

\* ZStatus\_t zclGeneral\_SendGroupRemove( uint8 srcEP, afAddrType\_t \*dstAddr, uint16 groupID, uint8 disableDefaultRsp, uint8 seqNum );

\#define zclGeneral\_SendGroupRemove(a,b,c,d,e) zclGeneral\_SendGroupRequest( (a), (b), COMMAND\_GROUP\_REMOVE, (c), (d), (e) )

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* @fn zcl\_SendCommand

\* @brief Used to send Profile and Cluster Specific Command messages.

\* NOTE: The calling application is responsible for incrementing

\* the Sequence Number.

\* @param srcEp - source endpoint

\* @param destAddr - destination address

\* @param clusterID - cluster ID

\* @param cmd - command ID

\* @param specific - whether the command is Cluster Specific

\* @param direction - client/server direction of the command

\* @param disableDefaultRsp - disable Default Response command

\* @param manuCode - manufacturer code for proprietary extensions to a profile

\* @param seqNumber - identification number for the transaction

\* @param cmdFormatLen - length of the command to be sent

\* @param cmdFormat - command to be sent

\* @return ZSuccess if OK

\*/

ZStatus\_t zcl\_SendCommand( uint8 srcEP, afAddrType\_t \*destAddr,

uint16 clusterID, uint8 cmd, uint8 specific, uint8 direction,

uint8 disableDefaultRsp, uint16 manuCode, uint8 seqNum,

uint16 cmdFormatLen, uint8 \*cmdFormat );

\#define zclGeneral\_SendGroupRemoveAll(a,b,c,d) zcl\_SendCommand( (a), (b), ZCL\_CLUSTER\_ID\_GEN\_GROUPS, COMMAND\_GROUP\_REMOVE\_ALL, TRUE, ZCL\_FRAME\_CLIENT\_SERVER\_DIR, (c), 0, (d), 0, NULL )

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* @fn zclGeneral\_SendAddGroupRequest

\* @brief Send the Add Group Request to a device

\* @param srcEP - Sending Apps endpoint

\* @param dstAddr - where to send the request

\* @param cmd - one of the following:

\* COMMAND\_GROUP\_ADD

\* COMMAND\_GROUP\_ADD\_IF\_IDENTIFYING

\* @param groupID - pointer to the group structure

\* @param groupName - pointer to Group Name. This is a Zigbee

\* string data type, so the first byte is the length of the

\* name (in bytes), then the name.

\* @return ZStatus\_t

\*/

ZStatus\_t zclGeneral\_SendAddGroupRequest( uint8 srcEP, afAddrType\_t \*dstAddr,

uint8 cmd, uint16 groupID, uint8 \*groupName,

uint8 disableDefaultRsp, uint8 seqNum )

\#define zclGeneral\_SendGroupAddIfIdentifying(a,b,c,d,e,f) zclGeneral\_SendAddGroupRequest( (a), (b), COMMAND\_GROUP\_ADD\_IF\_IDENTIFYING, (c), (d), (e), (f) )

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* @fn zclGeneral\_SendGroupResponse

\* @brief Send Group Response (not Group View Response)

\* @param srcEP - Sending application's endpoint

\* @param dstAddr - where you want the message to [Go][]

\* @param cmd - either COMMAND\_GROUP\_ADD\_RSP or COMMAND\_GROUP\_REMOVE\_RSP

\* @param status - group command status

\* @param groupID - what group

\* @return ZStatus\_t

\*/

ZStatus\_t zclGeneral\_SendGroupResponse( uint8 srcEP, afAddrType\_t \*dstAddr,

uint8 cmd, uint8 status, uint16 groupID,

uint8 disableDefaultRsp, uint8 seqNum ) \*/

\#define zclGeneral\_SendGroupAddResponse(a,b,c,d,e,f) zclGeneral\_SendGroupResponse( (a), (b), COMMAND\_GROUP\_ADD\_RSP, (c), (d), (e), (f) )

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* @fn zclGeneral\_SendGroupGetMembershipRequest

\* @brief Send a Get Group Membership (Resposne) Command to a device

\* @param srcEP - Sending Apps endpoint

\* @param dstAddr - where to send the request

\* @param cmd - one of the following:

\* COMMAND\_GROUP\_GET\_MEMBERSHIP

\* COMMAND\_GROUP\_GET\_MEMBERSHIP\_RSP

\* @param groupID - pointer to the group structure

\* @param groupName - pointer to Group Name. This is a Zigbee

\* string data type, so the first byte is the length of the

\* name (in bytes), then the name.

\* @return ZStatus\_t

\*/

ZStatus\_t zclGeneral\_SendGroupGetMembershipRequest( uint8 srcEP, afAddrType\_t \*dstAddr,

uint8 cmd, uint8 rspCmd, uint8 direction, uint8 capacity,

uint8 grpCnt, uint16 \*grpList, uint8 disableDefaultRsp, uint8 seqNum ) \*/

\#define zclGeneral\_SendGroupGetMembershipResponse(a,b,c,d,e,f,g) zclGeneral\_SendGroupGetMembershipRequest( (a), (b), COMMAND\_GROUP\_GET\_MEMBERSHIP\_RSP, TRUE, ZCL\_FRAME\_SERVER\_CLIENT\_DIR, (c), (d), (e), (f), (g) )

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* @fn zclGeneral\_SendGroupResponse

\* @brief Send Group Response (not Group View Response)

\* @param srcEP - Sending application's endpoint

\* @param dstAddr - where you want the message to go

\* @param cmd - either COMMAND\_GROUP\_ADD\_RSP or COMMAND\_GROUP\_REMOVE\_RSP

\* @param status - group command status

\* @param groupID - what group

\* @return ZStatus\_t

\*/

ZStatus\_t zclGeneral\_SendGroupResponse( uint8 srcEP, afAddrType\_t \*dstAddr,

uint8 cmd, uint8 status, uint16 groupID,

uint8 disableDefaultRsp, uint8 seqNum ) \*/

\#define zclGeneral\_SendGroupRemoveResponse(a,b,c,d,e,f) zclGeneral\_SendGroupResponse( (a), (b), COMMAND\_GROUP\_REMOVE\_RSP, (c), (d), (e), (f) )

\#endif // ZCL\_GROUPS

\#ifdef ZCL\_SCENES

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* @fn zclGeneral\_SendAddScene

\* @brief Send the Add Scene Request to a device

\* @param srcEP - Sending Apps endpoint

\* @param dstAddr - where to send the request

\* @param scene - pointer to the scene structure

\* @return ZStatus\_t

\*/

ZStatus\_t zclGeneral\_SendAddScene( uint8 srcEP, afAddrType\_t \*dstAddr,

zclGeneral\_Scene\_t \*scene, uint8 disableDefaultRsp, uint8 seqNum )

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* @fn zclGeneral\_SendSceneRequest

\* @brief Send a Scene Request to a device. You can also use the

\* appropriate macro.

\* @param srcEP - Sending Apps endpoint

\* @param dstAddr - where to send the request

\* @param cmd - one of the following:

\* COMMAND\_SCENE\_VIEW

\* COMMAND\_SCENE\_REMOVE

\* COMMAND\_SCENE\_REMOVE\_ALL

\* COMMAND\_SCENE\_STORE

\* COMMAND\_SCENE\_RECALL

\* COMMAND\_SCENE\_GET\_MEMBERSHIP

\* @param groupID - group ID

\* @param sceneID - scene ID (not applicable to COMMAND\_SCENE\_REMOVE\_ALL and

\* COMMAND\_SCENE\_GET\_MEMBERSHIP)

\* @return ZStatus\_t

\*/

ZStatus\_t zclGeneral\_SendSceneRequest( uint8 srcEP, afAddrType\_t \*dstAddr,

uint8 cmd, uint16 groupID, uint8 sceneID,

uint8 disableDefaultRsp, uint8 seqNum )\*/

\#define zclGeneral\_SendSceneView(a,b,c,d,e,f) zclGeneral\_SendSceneRequest( (a), (b), COMMAND\_SCENE\_VIEW, (c), (d), (e), (f) )

/\*

\* Send a Scene Remove Command

\* Use like:

\* ZStatus\_t zclGeneral\_SendSceneRemove( uint8 srcEP, afAddrType\_t \*dstAddr, uint16 groupID, uint8 sceneID, uint8 disableDefaultRsp, uint8 seqNum );

\*/

\#define zclGeneral\_SendSceneRemove(a,b,c,d,e,f) zclGeneral\_SendSceneRequest( (a), (b), COMMAND\_SCENE\_REMOVE, (c), (d), (e), (f) )

/\*

\* Send a Scene Store Command

\* Use like:

\* ZStatus\_t zclGeneral\_SendSceneStore( uint8 srcEP, afAddrType\_t \*dstAddr, uint16 groupID, uint8 sceneID, uint8 disableDefaultRsp, uint8 seqNum );

\*/

\#define zclGeneral\_SendSceneStore(a,b,c,d,e,f) zclGeneral\_SendSceneRequest( (a), (b), COMMAND\_SCENE\_STORE, (c), (d), (e), (f) )

/\*

\* Send a Scene Recall Command

\* Use like:

\* ZStatus\_t zclGeneral\_SendSceneRecall( uint8 srcEP, afAddrType\_t \*dstAddr, uint16 groupID, uint8 sceneID, uint8 disableDefaultRsp, uint8 seqNum );

\*/

\#define zclGeneral\_SendSceneRecall(a,b,c,d,e,f) zclGeneral\_SendSceneRequest( (a), (b), COMMAND\_SCENE\_RECALL, (c), (d), (e), (f) )

/\*

\* Send a Scene Remove ALL Command - COMMAND\_SCENE\_REMOVE\_ALL

\* Use like:

\* ZStatus\_t zclGeneral\_SendSceneRemoveAll( uint16 srcEP, afAddrType\_t \*dstAddr, uint16 groupID, uint8 disableDefaultRsp, uint8 seqNum );

\*/

\#define zclGeneral\_SendSceneRemoveAll(a,b,c,d,e) zclGeneral\_SendSceneRequest( (a), (b), COMMAND\_SCENE\_REMOVE\_ALL, (c), 0, (d), (e) )

/\*

\* Send a Scene Get Membership Command - COMMAND\_SCENE\_GET\_MEMBERSHIPSHIP

\* Use like:

\* ZStatus\_t zclGeneral\_SendSceneGetMembership( uint16 srcEP, afAddrType\_t \*dstAddr, uint16 groupID, uint8 disableDefaultRsp, uint8 seqNum );

\*/

\#define zclGeneral\_SendSceneGetMembership(a,b,c,d,e) zclGeneral\_SendSceneRequest( (a), (b), COMMAND\_SCENE\_GET\_MEMBERSHIP, (c), 0, (d), (e) )

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\* @fn zclGeneral\_SendSceneResponse

\* @brief Send Group Response (not Group View Response)

\* @param srcEP - Sending application's endpoint

\* @param dstAddr - where you want the message to go

\* @param cmd - either COMMAND\_SCENE\_ADD\_RSP, COMMAND\_SCENE\_REMOVE\_RSP

\* COMMAND\_SCENE\_STORE\_RSP, or COMMAND\_SCENE\_REMOVE\_ALL\_RSP

\* @param status - scene command status

\* @param groupID - what group

\* @param sceneID - what scene (not applicable to COMMAND\_SCENE\_REMOVE\_ALL\_RSP)

\* @return ZStatus\_t

\*/

ZStatus\_t zclGeneral\_SendSceneResponse( uint8 srcEP, afAddrType\_t \*dstAddr,

uint8 cmd, uint8 status, uint16 groupID,

uint8 sceneID, uint8 disableDefaultRsp, uint8 seqNum ) \*/

\#define zclGeneral\_SendSceneAddResponse(a,b,c,d,e,f,g) zclGeneral\_SendSceneResponse( (a), (b), COMMAND\_SCENE\_ADD\_RSP, (c), (d), (e), (f), (g) )

/\*

\* Send a Scene Remove Response Command - COMMAND\_SCENE\_REMOVE\_RSP

\* Use like:

\* ZStatus\_t zclGeneral\_SendSceneRemoveResponse( uint16 srcEP, afAddrType\_t \*dstAddr, uint8 status, uint16 groupID, uint8 sceneID, uint8 disableDefaultRsp, uint8 seqNum );

\*/

\#define zclGeneral\_SendSceneRemoveResponse(a,b,c,d,e,f,g) zclGeneral\_SendSceneResponse( (a), (b), COMMAND\_SCENE\_REMOVE\_RSP, (c), (d), (e), (f), (g) )

/\*

\* Send a Scene Remove All Response Command - COMMAND\_SCENE\_REMOVE\_ALL\_RSP

\* Use like:

\* ZStatus\_t zclGeneral\_SendSceneRemoveAllResponse( uint16 srcEP, afAddrType\_t \*dstAddr, uint8 status, uint16 groupID, uint8 disableDefaultRsp, uint8 seqNum );

\*/

\#define zclGeneral\_SendSceneRemoveAllResponse(a,b,c,d,e,f) zclGeneral\_SendSceneResponse( (a), (b), COMMAND\_SCENE\_REMOVE\_ALL\_RSP, (c), (d), 0, (e), (f) )

/\*

\* Send a Scene Remove ALL Response Command - COMMAND\_SCENE\_STORE\_RSP

\* Use like:

\* ZStatus\_t zclGeneral\_SendSceneStoreResponse( uint16 srcEP, afAddrType\_t \*dstAddr, uint8 status, uint16 groupID, uint8 sceneID, uint8 disableDefaultRsp, uint8 seqNum );

\*/

\#define zclGeneral\_SendSceneStoreResponse(a,b,c,d,e,f,g) zclGeneral\_SendSceneResponse( (a), (b), COMMAND\_SCENE\_STORE\_RSP, (c), (d), (e), (f), (g) )

\#endif // ZCL\_SCENE

ZigBee Specification.pdf

. Group management: this provides the ability to declare a single address

shared by multiple devices, to add devices to the group, and to remove devices

from the group.

[Go]: http://lib.csdn.net/base/go