Global Commands

---

Zigbee global commands.

Required Header

#include <zigbee.h>

Overview

Global command frames are used for manipulating attributes and other general tasks that are not specific to an individual cluster.

The command frames defined in this section.

Each command frame shall be constructed with the frame type sub-field of the frame control field set to 0b00.

All clusters (server and client) shall support generation, reception and execution of the Default response command.

Each cluster (server or client) that implements attributes shall support reception of, execution of, and response to all commands to discover, read, and write these attributes. However, if no attributes with structured types are supported, it is not required to support the structured read and write commands.

Implementation of commands to report, configure reporting of, and read reporting configuration of attributes is only mandatory if the cluster has attributes whose reportability is mandatory.

Generation of these commands is application dependent

Functions
int	zb_zcl_global_attr_read (zb_zigbee_h handle, zb_nwk_addr addr16, zb_end_point src_ep, zb_end_point dst_ep, zb_zcl_frame_ctl zcl_fc, zb_cluster_id clusterid, zb_attribute_id *attribute_ids, int count, zb_zcl_global_attr_read_cb cb, void *user_data)
	Sends 'read attributes' command.
int	zb_zcl_global_attr_write (zb_zigbee_h handle, zb_nwk_addr addr16, zb_end_point src_ep, zb_end_point dst_ep, zb_zcl_frame_ctl zcl_fc, zb_cluster_id clusterid, zb_zcl_write_attr_record_h *records, int count, zb_zcl_global_attr_write_cb cb, void *user_data)
	Sends 'write Attributes' command.
int	zb_zcl_global_attr_write_undivided (zb_zigbee_h handle, zb_nwk_addr addr16, zb_end_point src_ep, zb_end_point dst_ep, zb_zcl_frame_ctl zcl_fc, zb_cluster_id clusterid, zb_zcl_write_attr_record_h *records, int count, zb_zcl_global_attr_write_cb cb, void *user_data)
	Sends 'write attributes undivided' command.
int	zb_zcl_global_attr_write_no_rsp (zb_zigbee_h handle, zb_nwk_addr addr16, zb_end_point src_ep, zb_end_point dst_ep, zb_zcl_frame_ctl zcl_fc, zb_cluster_id clusterid, zb_zcl_write_attr_record_h *records, int count)
	Sends 'write Attributes without response' command.
int	zb_zcl_global_config_report_write (zb_zigbee_h handle, zb_nwk_addr addr16, zb_end_point src_ep, zb_end_point dst_ep, zb_zcl_frame_ctl zcl_fc, zb_cluster_id clusterid, zb_zcl_reporting_config_record_h *records, int count, zb_zcl_global_config_report_write_cb cb, void *user_data)
	Sends 'setting configure reporting' command.
int	zb_zcl_global_config_report_read (zb_zigbee_h handle, zb_nwk_addr addr16, zb_end_point src_ep, zb_end_point dst_ep, zb_zcl_frame_ctl zcl_fc, zb_cluster_id clusterid, zb_zcl_read_report_config_record_h *records, int count, zb_zcl_global_config_report_read_cb cb, void *user_data)
	Sends 'reading configure reporting' command.
Typedefs
typedef unsigned char	zb_zcl_frame_ctl
	The data type abbreviation : Zigbee ZCL frame control.
typedef void *	zb_zcl_read_attr_status_record_h
	Format of the Attribute Status Record in Zigbee Cluster Library.
typedef void *	zb_zcl_write_attr_record_h
	Format of the Write Attributes Data Structure in Zigbee Cluster Library.
typedef void *	zb_zcl_write_attr_status_record_h
	Format of the write attribute status record in Zigbee Cluster Library.
typedef void *	zb_zcl_reporting_config_record_h
	Format of Reporting Configuration Record Structure in Zigbee Cluster Library.
typedef void *	zb_zcl_read_report_config_record_h
	Format of Read Reporting Configuration Record in Zigbee Cluster Library.
typedef void *	zb_zcl_report_config_response_record_h
	Format of the Attribute Status Record Field in Zigbee Cluster Library.
typedef void(*	zb_zcl_global_attr_read_cb )(zb_nwk_addr addr16, zb_end_point ep, zb_cluster_id clusterid, zb_zcl_read_attr_status_record_h *records, int count, void *user_data)
	Called with device attributes.
typedef void(*	zb_zcl_global_attr_write_cb )(zb_nwk_addr addr16, zb_end_point ep, zb_cluster_id clusterid, zb_zcl_write_attr_status_record_h *records, int count, void *user_data)
	Called when write attributes command are requested.
typedef void(*	zb_zcl_global_config_report_write_cb )(zb_nwk_addr addr16, zb_end_point ep, zb_cluster_id clusterid, zb_zcl_report_config_response_record_h *records, int count, void *user_data)
	Called with configure reporting response.
typedef void(*	zb_zcl_global_config_report_read_cb )(zb_nwk_addr addr16, zb_end_point ep, zb_cluster_id clusterid, zb_zcl_reporting_config_record_h *records, int count, void *user_data)
	Called with a configuration report.
Defines
#define	ZB_ZCL_FC_DEFAULT   0x00
	Default ZCL frame control at APS Header.

---

Define Documentation

#define ZB_ZCL_FC_DEFAULT   0x00

Default ZCL frame control at APS Header.

Since :

5.0

This value is a combination of the following bits.
ZB_ZCL_FC_GLOBALLY_USED
ZB_ZCL_FC_NOT_MANUFACTURER
ZB_ZCL_CLIENT_TO_SERVER
ZB_ZCL_DEFAULT_RESPONSE_ENABLED

---

Typedef Documentation

typedef unsigned char zb_zcl_frame_ctl

The data type abbreviation : Zigbee ZCL frame control.

Since :

5.0

typedef void(* zb_zcl_global_attr_read_cb)(zb_nwk_addr addr16, zb_end_point ep, zb_cluster_id clusterid, zb_zcl_read_attr_status_record_h *records, int count, void *user_data)

Called with device attributes.

This callback is called when device attributes are requested with zb_zcl_global_attr_read().

Since :

5.0

Remarks:

The records can be used only in the callback. If you want to use them outside, copy each of them with zb_read_attr_status_record_clone().

The records should not be released.

Parameters:

[out]	addr16	The source network address
[out]	ep	The source end-point of the received information (ex. endpoint 1)
[out]	clusterid	ZCL cluster id
[out]	records	Attribute status record
[out]	count	The number of items in records
[out]	user_data	User data

See also:

zb_zcl_global_attr_read()

typedef void(* zb_zcl_global_attr_write_cb)(zb_nwk_addr addr16, zb_end_point ep, zb_cluster_id clusterid, zb_zcl_write_attr_status_record_h *records, int count, void *user_data)

Called when write attributes command are requested.

This callback is called when attributes are written with zb_zcl_global_attr_write() or zb_zcl_global_attr_write_undivided(). In other words, the write attributes response is generated in response to the write attributes command.

Since :

5.0

Remarks:

The records can be used only in the callback.

If you want to use them outside, copy them with zb_write_attr_status_clone().

The records should not be released.

Parameters:

[out]	addr16	The source network address
[out]	ep	The source end-point of the received information (ex. endpoint 1)
[out]	clusterid	ZCL cluster id
[out]	records	Attribute status record
[out]	count	The number of items in records
[out]	user_data	User data

See also:

zb_zcl_global_attr_write()

typedef void(* zb_zcl_global_config_report_read_cb)(zb_nwk_addr addr16, zb_end_point ep, zb_cluster_id clusterid, zb_zcl_reporting_config_record_h *records, int count, void *user_data)

Called with a configuration report.

This callback is called after zb_zcl_global_config_report_read() is called.

Since :

5.0

Remarks:

The records can be used only in the callback.

The records should not be released.

Parameters:

[out]	addr16	Source network address
[out]	ep	The source end-point (ex. 1)
[out]	clusterid	ZCL cluster id
[out]	records	Read reporting configuration response record
[out]	count	The number of items in records
[out]	user_data	User data

See also:

zb_zcl_global_config_report_read()

typedef void(* zb_zcl_global_config_report_write_cb)(zb_nwk_addr addr16, zb_end_point ep, zb_cluster_id clusterid, zb_zcl_report_config_response_record_h *records, int count, void *user_data)

Called with configure reporting response.

This callback is called after zb_zcl_global_config_report_write() is called.

Since :

5.0

Remarks:

The records can be used only in the callback.

The records should not be released.

Parameters:

[out]	addr16	The source network address
[out]	ep	The source from which the response was sent (ex. 1)
[out]	clusterid	ZCL cluster id
[out]	records	Reporting configuration response record
[out]	count	The number of reporting configuration response record
[out]	user_data	User data

See also:

zb_zcl_global_config_report_write()

typedef void* zb_zcl_read_attr_status_record_h

Format of the Attribute Status Record in Zigbee Cluster Library.

Since :

5.0

typedef void* zb_zcl_read_report_config_record_h

Format of Read Reporting Configuration Record in Zigbee Cluster Library.

Since :

5.0

typedef void* zb_zcl_report_config_response_record_h

Format of the Attribute Status Record Field in Zigbee Cluster Library.

Since :

5.0

typedef void* zb_zcl_reporting_config_record_h

Format of Reporting Configuration Record Structure in Zigbee Cluster Library.

Since :

5.0

typedef void* zb_zcl_write_attr_record_h

Format of the Write Attributes Data Structure in Zigbee Cluster Library.

Since :

5.0

typedef void* zb_zcl_write_attr_status_record_h

Format of the write attribute status record in Zigbee Cluster Library.

Since :

5.0

---

Enumeration Type Documentation

enum zb_aps_ack_request_e

APS ACK Request.

Since :

5.0

Enumerator:

ZB_APS_NO_ACK_REQUEST	Not request ACK
ZB_APS_ACK_REQUEST	Request ACK

enum zb_aps_delivery_mode_e

APS Delivery Mode.

Since :

5.0

Enumerator:

ZB_APS_DELIVERY_UNICAST	Unicast delivery
ZB_APS_DELIVERY_INDIRECT	Indirect delivery
ZB_APS_DELIVERY_BROADCAST	Broadcast delivery
ZB_APS_DELIVERY_MULTICAST	Multicast delivery

enum zb_zcl_acl_type_e

ACL type.

Since :

5.0

Enumerator:

ZB_ZCL_ACL_TYPE_WRITABLE	Writable
ZB_ZCL_ACL_TYPE_REPORTABLE	Reportable

enum zb_zcl_data_category_e

Data measuring type.

Since :

5.0

Enumerator:

ZB_ZCL_DATA_TYPE_NONE	Data type none
ZB_ZCL_DATA_TYPE_DISCRETE	Discrete data type
ZB_ZCL_DATA_TYPE_ANALOG	Analog data type

enum zb_zcl_data_type_e

ZCL attribute types (See zb_zcl_data_type_e).

Zigbee devices, such as thermostats, lamps, etc., are defined in terms of the attributes they contain, which can be written, read or reported using the commands defined in zb_zcl_data_type_e details the data types and formats that can be used for these attributes. Note that individual clusters, which may use different or new types, show valid values, ranges, and units for the attributes they represent.

Each data type is allocated an 8-bit data type ID. The most significant 5 bits of this ID is used to divide the types into 32 type classes, and the least significant 3 bits specify a specific data type within this class.

zb_zcl_data_type_e also indicates for each data type whether it is considered to be 'analog' or 'discrete'. Values of analog types may be added to or subtracted from other values of the same type, and are typically used to measure the value of properties in the real world that vary continuously over a range. Values of discrete data types only have meaning as individual values, and may not be added or subtracted.

Since :

5.0

Enumerator:

ZB_ZCL_NO_DATA_ATTRIBUTE_TYPE	No data
ZB_ZCL_8_BIT_DATA	8-bit data, 1-byte (Digital)
ZB_ZCL_16_BIT_DATA	16-bit data, 2-byte (Digital)
ZB_ZCL_24_BIT_DATA	24-bit data, 3-byte (Digital)
ZB_ZCL_32_BIT_DATA	32-bit data, 4-byte (Digital)
ZB_ZCL_40_BIT_DATA	40-bit data, 5-byte (Digital)
ZB_ZCL_48_BIT_DATA	48-bit data, 6-byte (Digital)
ZB_ZCL_56_BIT_DATA	56-bit data, 7-byte (Digital)
ZB_ZCL_64_BIT_DATA	64-bit data, 8-byte (Digital)
ZB_ZCL_BOOLEAN	Boolean, 1-byte
ZB_ZCL_8_BIT_BITMAP	8-bit bitmap, 1-byte (Digital)
ZB_ZCL_16_BIT_BITMAP	16-bit bitmap, 2-byte (Digital)
ZB_ZCL_24_BIT_BITMAP	24-bit bitmap, 3-byte (Digital)
ZB_ZCL_32_BIT_BITMAP	32-bit bitmap, 4-byte (Digital)
ZB_ZCL_40_BIT_BITMAP	40-bit bitmap, 5-byte (Digital)
ZB_ZCL_48_BIT_BITMAP	48-bit bitmap, 6-byte (Digital)
ZB_ZCL_56_BIT_BITMAP	56-bit bitmap, 7-byte (Digital)
ZB_ZCL_64_BIT_BITMAP	64-bit bitmap, 8-byte (Digital)
ZB_ZCL_UNSIGNED_8_BIT_INTEGER	unsigned 8-bit integer, 1-byte (Analog)
ZB_ZCL_UNSIGNED_16_BIT_INTEGER	unsigned 16-bit integer, 2-byte (Analog)
ZB_ZCL_UNSIGNED_24_BIT_INTEGER	unsigned 24-bit integer, 3-byte (Analog)
ZB_ZCL_UNSIGNED_32_BIT_INTEGER	unsigned 32-bit integer, 4-byte (Analog)
ZB_ZCL_UNSIGNED_40_BIT_INTEGER	unsigned 40-bit integer, 5-byte (Analog)
ZB_ZCL_UNSIGNED_48_BIT_INTEGER	unsigned 48-bit integer, 6-byte (Analog)
ZB_ZCL_UNSIGNED_56_BIT_INTEGER	unsigned 56-bit integer, 7-byte (Analog)
ZB_ZCL_UNSIGNED_64_BIT_INTEGER	unsigned 64-bit integer, 8-byte (Analog)
ZB_ZCL_SIGNED_8_BIT_INTEGER	signed 8-bit integer, 1-byte (Analog)
ZB_ZCL_SIGNED_16_BIT_INTEGER	signed 16-bit integer, 2-byte (Analog)
ZB_ZCL_SIGNED_24_BIT_INTEGER	signed 24-bit integer, 3-byte (Analog)
ZB_ZCL_SIGNED_32_BIT_INTEGER	signed 32-bit integer, 4-byte (Analog)
ZB_ZCL_SIGNED_40_BIT_INTEGER	signed 40-bit integer, 5-byte (Analog)
ZB_ZCL_SIGNED_48_BIT_INTEGER	signed 48-bit integer, 6-byte (Analog)
ZB_ZCL_SIGNED_56_BIT_INTEGER	signed 56-bit integer, 7-byte (Analog)
ZB_ZCL_SIGNED_64_BIT_INTEGER	signed 64-bit integer, 8-byte (Analog)
ZB_ZCL_8_BIT_ENUMERATION	8-bit enumeration, 1-byte (Digital)
ZB_ZCL_16_BIT_ENUMERATION	16-bit enumeration, 2-byte (Digital)
ZB_ZCL_SEMI_PRECISION	floating point, 2-byte (Analog)
ZB_ZCL_SINGLE_PRECISION	floating point, 4-byte (Analog)
ZB_ZCL_DOUBLE_PRECISION	floating point, 8-byte (Analog)
ZB_ZCL_OCTET_STRING	Octet string, Defined in first two octets (Digital)
ZB_ZCL_CHARACTER_STRING	Character string, defined in first two octets (Digital)
ZB_ZCL_LONG_OCTET_STRING	Long octet string, defined in first two octets (Digital)
ZB_ZCL_LONG_CHARACTER_STRING	Long character string, defined in first 2 bytes (Digital)
ZB_ZCL_ARRAY	Array 2(0xffff)+Sum of lengths of contents, but we ignore 2-byte prefix (Digital) (NOT SUPPORTED)
ZB_ZCL_STRUCTURE	Structure 2(0xffff)+Sum of lengths of contents, but we ignore 2-byte prefix (Digital) (NOT SUPPORTED)
ZB_ZCL_SET	Set, Sum of lengths of contents (Digital) (NOT SUPPORTED)
ZB_ZCL_BAG	Bag, Sum of lengths of contents (Digital) (NOT SUPPORTED)
ZB_ZCL_TIME_OF_DAY	Time of day, 4-byte (Analog)
ZB_ZCL_DATE	Date, 4 byte (Digital)
ZB_ZCL_UTC_TIME	UTC Time, 4-byte(Digital)
ZB_ZCL_CLUSTER_ID	Cluster ID, 2-byte (Digital)
ZB_ZCL_ATTRIBUTE_ID	Attribute ID, 2-byte (Digital)
ZB_ZCL_BACNET_OID	BACnet OID 4 byte (Digital)
ZB_ZCL_IEEE_ADDRESS	IEEE address, 8-byte (Digital)
ZB_ZCL_128_BIT_SECURITY_KEY	128-bit security key, 16-byte (Digital)

enum zb_zcl_fc_default_response_e

Disable default response or not at ZCL Header.

Since :

5.0

Enumerator:

ZB_ZCL_DEFAULT_RESPONSE_ENABLED	Enable default response
ZB_ZCL_DEFAULT_RESPONSE_DISABLED	Disable default response

enum zb_zcl_fc_direction_e

Request or Response at ZCL Header.

Since :

5.0

Enumerator:

ZB_ZCL_CLIENT_TO_SERVER	Request
ZB_ZCL_SERVER_TO_CLIENT	Response

enum zb_zcl_fc_manufacturer_present_e

Manufacturer specific or not at ZCL Header.

Since :

5.0

Enumerator:

ZB_ZCL_FC_NOT_MANUFACTURER	Manufacturer code not present
ZB_ZCL_FC_MANUFACTURER	Manufacturer code present

enum zb_zcl_fc_type_e

Frame type at ZCL Header.

Since :

5.0

Enumerator:

ZB_ZCL_FC_GLOBALLY_USED	Profile widely used
ZB_APS_FC_CLUSTER_SPECIFIC	Cluster specific

---

Function Documentation

int zb_zcl_global_attr_read	(	zb_zigbee_h	handle,
		zb_nwk_addr	addr16,
		zb_end_point	src_ep,
		zb_end_point	dst_ep,
		zb_zcl_frame_ctl	zcl_fc,
		zb_cluster_id	clusterid,
		zb_attribute_id *	attribute_ids,
		int	count,
		zb_zcl_global_attr_read_cb	cb,
		void *	user_data
	)

Sends 'read attributes' command.

Call this function to read attributes of devices.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/zigbee

Parameters:

[in]	handle	The handle of zigbee
[in]	addr16	target network address
[in]	src_ep	source end-point (ex. 1)
[in]	dst_ep	destination end-point (ex. 1)
[in]	zcl_fc	frame control bits (default ZB_ZCL_FC_DEFAULT). Only OR operation is allowed in ZCL header Frame Type : ZB_ZCL_FC_GLOBALLY_USED (default) ZB_APS_FC_CLUSTER_SPECIFIC Manufacturer Specific : ZB_ZCL_FC_NOT_MANUFACTURER ZB_ZCL_FC_MANUFACTURER Direction : ZB_ZCL_CLIENT_TO_SERVER (default) ZB_ZCL_SERVER_TO_CLIENT Disable Default Response : ZB_ZCL_DEFAULT_RESPONSE_ENABLED (default) ZB_ZCL_DEFAULT_RESPONSE_DISABLED
[in]	clusterid	ZCL cluster id
[in]	attribute_ids	Attributes_ids-list
[in]	count	The number of items in the attribute_ids list
[in]	cb	Response callback function
[in]	user_data	User data

Returns:

0 on success, otherwise a negative error value.

Return values:

ZIGBEE_ERROR_NONE	Successful
ZIGBEE_ERROR_INVALID_PARAMETER	Invalid parameter
ZIGBEE_ERROR_INVALID_ADDRESS	Invalid address
ZIGBEE_ERROR_OUT_OF_MEMORY	Out-of-memory
ZIGBEE_ERROR_IO_ERROR	Unexpected d-bus error
ZIGBEE_ERROR_PERMISSION_DENIED	Permission denied
ZIGBEE_ERROR_NOT_SUPPORTED	Not supported

See also:

zb_zcl_global_attr_read_cb()

int zb_zcl_global_attr_write	(	zb_zigbee_h	handle,
		zb_nwk_addr	addr16,
		zb_end_point	src_ep,
		zb_end_point	dst_ep,
		zb_zcl_frame_ctl	zcl_fc,
		zb_cluster_id	clusterid,
		zb_zcl_write_attr_record_h *	records,
		int	count,
		zb_zcl_global_attr_write_cb	cb,
		void *	user_data
	)

Sends 'write Attributes' command.

Call this function to write attributes of other devices.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/zigbee

Parameters:

[in]	handle	The handle of zigbee
[in]	addr16	target network address
[in]	src_ep	source end-point (ex. 1)
[in]	dst_ep	destination end-point (ex. 1)
[in]	zcl_fc	frame control bits (default ZB_ZCL_FC_DEFAULT). Only OR operation is allowed in ZCL header Frame Type : ZB_ZCL_FC_GLOBALLY_USED (default) ZB_APS_FC_CLUSTER_SPECIFIC Manufacturer Specific : ZB_ZCL_FC_NOT_MANUFACTURER ZB_ZCL_FC_MANUFACTURER Direction : ZB_ZCL_CLIENT_TO_SERVER (default) ZB_ZCL_SERVER_TO_CLIENT Disable Default Response : ZB_ZCL_DEFAULT_RESPONSE_ENABLED (default) ZB_ZCL_DEFAULT_RESPONSE_DISABLED
[in]	clusterid	ZCL cluster id
[in]	records	Array of zb_zcl_write_attr_record_h
[in]	count	The number of items in records array
[in]	cb	Response callback function
[in]	user_data	User data

Returns:

0 on success, otherwise a negative error value.

Return values:

ZIGBEE_ERROR_NONE	Successful
ZIGBEE_ERROR_INVALID_PARAMETER	Invalid parameter
ZIGBEE_ERROR_INVALID_ADDRESS	Invalid address
ZIGBEE_ERROR_OUT_OF_MEMORY	Out-of-memory
ZIGBEE_ERROR_IO_ERROR	Unexpected d-bus error
ZIGBEE_ERROR_PERMISSION_DENIED	Permission denied
ZIGBEE_ERROR_NOT_SUPPORTED	Not supported

See also:

zb_zcl_global_attr_write_cb()

int zb_zcl_global_attr_write_no_rsp	(	zb_zigbee_h	handle,
		zb_nwk_addr	addr16,
		zb_end_point	src_ep,
		zb_end_point	dst_ep,
		zb_zcl_frame_ctl	zcl_fc,
		zb_cluster_id	clusterid,
		zb_zcl_write_attr_record_h *	records,
		int	count
	)

Sends 'write Attributes without response' command.

Call this function to write attributes of other devices without receiving any response.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/zigbee

Parameters:

[in]	handle	The handle of zigbee
[in]	addr16	target network address
[in]	src_ep	source end-point (ex. 1)
[in]	dst_ep	destination end-point (ex. 1)
[in]	zcl_fc	frame control bits (default ZB_ZCL_FC_DEFAULT). Only OR operation is allowed in ZCL header Frame Type : ZB_ZCL_FC_GLOBALLY_USED (default) ZB_APS_FC_CLUSTER_SPECIFIC Manufacturer Specific : ZB_ZCL_FC_NOT_MANUFACTURER ZB_ZCL_FC_MANUFACTURER Direction : ZB_ZCL_CLIENT_TO_SERVER (default) ZB_ZCL_SERVER_TO_CLIENT Disable Default Response : ZB_ZCL_DEFAULT_RESPONSE_ENABLED (default) ZB_ZCL_DEFAULT_RESPONSE_DISABLED
[in]	clusterid	ZCL cluster id
[in]	records	Array of zb_zcl_write_attr_record_h
[in]	count	The number of items in records array

Returns:

0 on success, otherwise a negative error value.

Return values:

ZIGBEE_ERROR_NONE	Successful
ZIGBEE_ERROR_INVALID_PARAMETER	Invalid parameter
ZIGBEE_ERROR_INVALID_ADDRESS	Invalid address
ZIGBEE_ERROR_OUT_OF_MEMORY	Out-of-memory
ZIGBEE_ERROR_IO_ERROR	Unexpected d-bus error
ZIGBEE_ERROR_PERMISSION_DENIED	Permission denied
ZIGBEE_ERROR_NOT_SUPPORTED	Not supported

int zb_zcl_global_attr_write_undivided	(	zb_zigbee_h	handle,
		zb_nwk_addr	addr16,
		zb_end_point	src_ep,
		zb_end_point	dst_ep,
		zb_zcl_frame_ctl	zcl_fc,
		zb_cluster_id	clusterid,
		zb_zcl_write_attr_record_h *	records,
		int	count,
		zb_zcl_global_attr_write_cb	cb,
		void *	user_data
	)

Sends 'write attributes undivided' command.

Call this function to write attributes without fragmentation to other devices.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/zigbee

Parameters:

[in]	handle	The handle of zigbee
[in]	addr16	target network address
[in]	src_ep	source end-point (ex. 1)
[in]	dst_ep	destination end-point (ex. 1)
[in]	zcl_fc	frame control bits (default ZB_ZCL_FC_DEFAULT). Only OR operation is allowed in ZCL header Frame Type : ZB_ZCL_FC_GLOBALLY_USED (default) ZB_APS_FC_CLUSTER_SPECIFIC Manufacturer Specific : ZB_ZCL_FC_NOT_MANUFACTURER ZB_ZCL_FC_MANUFACTURER Direction : ZB_ZCL_CLIENT_TO_SERVER (default) ZB_ZCL_SERVER_TO_CLIENT Disable Default Response : ZB_ZCL_DEFAULT_RESPONSE_ENABLED (default) ZB_ZCL_DEFAULT_RESPONSE_DISABLED
[in]	clusterid	ZCL cluster id
[in]	records	Array of zb_zcl_write_attr_record_h
[in]	count	The number of items in records array
[in]	cb	Response callback function
[in]	user_data	User data

Returns:

0 on success, otherwise a negative error value.

Return values:

ZIGBEE_ERROR_NONE	Successful
ZIGBEE_ERROR_INVALID_PARAMETER	Invalid parameter
ZIGBEE_ERROR_INVALID_ADDRESS	Invalid address
ZIGBEE_ERROR_OUT_OF_MEMORY	Out-of-memory
ZIGBEE_ERROR_IO_ERROR	Unexpected d-bus error
ZIGBEE_ERROR_PERMISSION_DENIED	Permission denied
ZIGBEE_ERROR_NOT_SUPPORTED	Not supported

See also:

zb_zcl_global_attr_write_cb()

int zb_zcl_global_config_report_read	(	zb_zigbee_h	handle,
		zb_nwk_addr	addr16,
		zb_end_point	src_ep,
		zb_end_point	dst_ep,
		zb_zcl_frame_ctl	zcl_fc,
		zb_cluster_id	clusterid,
		zb_zcl_read_report_config_record_h *	records,
		int	count,
		zb_zcl_global_config_report_read_cb	cb,
		void *	user_data
	)

Sends 'reading configure reporting' command.

Call this function to read the configuration of attribute status changing reporting.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/zigbee

Parameters:

[in]	handle	The handle of zigbee
[in]	addr16	target network address
[in]	src_ep	source end-point (ex. 1)
[in]	dst_ep	destination end-point (ex. 1)
[in]	zcl_fc	frame control bits (default ZB_ZCL_FC_DEFAULT). Only OR operation is allowed in ZCL header Frame Type : ZB_ZCL_FC_GLOBALLY_USED (default) ZB_APS_FC_CLUSTER_SPECIFIC Manufacturer Specific : ZB_ZCL_FC_NOT_MANUFACTURER ZB_ZCL_FC_MANUFACTURER Direction : ZB_ZCL_CLIENT_TO_SERVER (default) ZB_ZCL_SERVER_TO_CLIENT Disable Default Response : ZB_ZCL_DEFAULT_RESPONSE_ENABLED (default) ZB_ZCL_DEFAULT_RESPONSE_DISABLED
[in]	clusterid	ZCL cluster id
[in]	records	Array of zb_zcl_read_report_config_record_h
[in]	count	The number of items in records array
[in]	cb	Response callback function
[in]	user_data	User data

Returns:

0 on success, otherwise a negative error value.

Return values:

ZIGBEE_ERROR_NONE	Successful
ZIGBEE_ERROR_INVALID_PARAMETER	Invalid parameter
ZIGBEE_ERROR_INVALID_ADDRESS	Invalid address
ZIGBEE_ERROR_OUT_OF_MEMORY	Out-of-memory
ZIGBEE_ERROR_IO_ERROR	Unexpected d-bus error
ZIGBEE_ERROR_PERMISSION_DENIED	Permission denied
ZIGBEE_ERROR_NOT_SUPPORTED	Not supported

See also:

zb_zcl_global_config_report_read_cb()

int zb_zcl_global_config_report_write	(	zb_zigbee_h	handle,
		zb_nwk_addr	addr16,
		zb_end_point	src_ep,
		zb_end_point	dst_ep,
		zb_zcl_frame_ctl	zcl_fc,
		zb_cluster_id	clusterid,
		zb_zcl_reporting_config_record_h *	records,
		int	count,
		zb_zcl_global_config_report_write_cb	cb,
		void *	user_data
	)

Sends 'setting configure reporting' command.

Call this function to set the configuration of attribute status changing reporting.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/zigbee

Parameters:

[in]	handle	The handle of zigbee
[in]	addr16	target network address
[in]	src_ep	source end-point (ex. 1)
[in]	dst_ep	destination end-point (ex. 1)
[in]	zcl_fc	frame control bits (default ZB_ZCL_FC_DEFAULT). Only OR operation is allowed in ZCL header Frame Type : ZB_ZCL_FC_GLOBALLY_USED (default) ZB_APS_FC_CLUSTER_SPECIFIC Manufacturer Specific : ZB_ZCL_FC_NOT_MANUFACTURER ZB_ZCL_FC_MANUFACTURER Direction : ZB_ZCL_CLIENT_TO_SERVER (default) ZB_ZCL_SERVER_TO_CLIENT Disable Default Response : ZB_ZCL_DEFAULT_RESPONSE_ENABLED (default) ZB_ZCL_DEFAULT_RESPONSE_DISABLED
[in]	clusterid	ZCL cluster id
[in]	records	Array of zb_zcl_reporting_config_record_h
[in]	count	The number of items in records array
[in]	cb	Response callback function
[in]	user_data	User data

Returns:

0 on success, otherwise a negative error value.

Return values:

ZIGBEE_ERROR_NONE	Successful
ZIGBEE_ERROR_INVALID_PARAMETER	Invalid parameter
ZIGBEE_ERROR_INVALID_ADDRESS	Invalid address
ZIGBEE_ERROR_OUT_OF_MEMORY	Out-of-memory
ZIGBEE_ERROR_IO_ERROR	Unexpected d-bus error
ZIGBEE_ERROR_PERMISSION_DENIED	Permission denied
ZIGBEE_ERROR_NOT_SUPPORTED	Not supported

See also:

zb_zcl_global_config_report_write_cb()