Modules
	ZGP Sink API

Data Structures
struct	zb_zdo_signal_leave_params_s
	Leave parameters. More...

struct	zb_zdo_signal_nlme_status_indication_params_s
	NLME status indication parameters. More...

struct	zb_zdo_signal_leave_indication_params_s
	Leave Indication parameters. More...

struct	zb_nwk_signal_device_associated_params_s
	Association parameters. More...

struct	zb_zdo_signal_device_annce_params_s
	Association parameters. More...

struct	zb_zdo_signal_can_sleep_params_s
	Sleep signal parameters. More...

struct	zb_zdo_signal_macsplit_dev_boot_params_s
	Macsplit device boot parameters. More...

struct	zb_zdo_signal_fb_initiator_finished_params_s
	F&B Initiator Finished signal parameters. More...

struct	zb_zdo_signal_device_update_params_s
	Device Updated signal parameters. More...

struct	zb_zdo_signal_device_authorized_params_s
	Device Authorized signal parameters. More...

struct	zb_zdo_app_signal_hdr_s

Macros
#define	ZB_ZDO_SIGNAL_GET_PARAMS(sg_p, type) ((type )(void )((((zb_uint8_t *)sg_p) + sizeof(zb_zdo_app_signal_hdr_t))))

#define	ZB_ZDO_SIGNAL_CUT_HEADER(buf) zb_buf_cut_left(buf, sizeof(zb_zdo_app_signal_hdr_t))
	Cuts ZBOSS signal headers while keeping the signal parameter (if it was in the buffer). More...

#define	ZB_GET_APP_SIGNAL_STATUS(param) zb_buf_get_status(param)
	Get status from the application signal. More...

Typedefs
typedef zb_uint8_t	zb_zdp_status_t
	Type for ZDP status values. More...

typedef zb_uint8_t	zb_zdo_app_signal_type_t
	Type for signals passed to zboss_signal_handler(). More...

typedef zb_zdo_app_signal_type_t	zb_zdo_app_signal_t

typedef struct zb_zdo_signal_leave_params_s	zb_zdo_signal_leave_params_t
	Leave parameters. More...

typedef struct zb_zdo_signal_nlme_status_indication_params_s	zb_zdo_signal_nlme_status_indication_params_t
	NLME status indication parameters. More...

typedef struct zb_zdo_signal_leave_indication_params_s	zb_zdo_signal_leave_indication_params_t
	Leave Indication parameters. More...

typedef struct zb_nwk_signal_device_associated_params_s	zb_nwk_signal_device_associated_params_t
	Association parameters. More...

typedef struct zb_zdo_signal_device_annce_params_s	zb_zdo_signal_device_annce_params_t
	Association parameters. More...

typedef struct zb_zdo_signal_can_sleep_params_s	zb_zdo_signal_can_sleep_params_t
	Sleep signal parameters. More...

typedef struct zb_zdo_signal_macsplit_dev_boot_params_s	zb_zdo_signal_macsplit_dev_boot_params_t
	Macsplit device boot parameters. More...

typedef zb_uint8_t	zb_zdo_fb_initiator_finished_status_t
	Type for Status codes for F&B Initiator Finished signal. More...

typedef struct zb_zdo_signal_fb_initiator_finished_params_s	zb_zdo_signal_fb_initiator_finished_params_t
	F&B Initiator Finished signal parameters.

typedef struct zb_zdo_signal_device_update_params_s	zb_zdo_signal_device_update_params_t
	Device Updated signal parameters.

typedef zb_uint8_t	zb_zdo_authorization_type_t
	Type for Authorization types for ZB_ZDO_SIGNAL_DEVICE_AUTHORIZED. More...

typedef zb_uint8_t	zb_zdo_legacy_device_authorization_status_t
	Type for Authorization statuses for ZB_ZDO_AUTHORIZATION_TYPE_LEGACY value of zdo_authorization_type type. More...

typedef zb_uint8_t	zb_zdo_tclk_authorization_status_t
	Type for Authorization types for ZB_ZDO_SIGNAL_DEVICE_AUTHORIZED. More...

typedef struct zb_zdo_signal_device_authorized_params_s	zb_zdo_signal_device_authorized_params_t
	Device Authorized signal parameters.

typedef struct zb_zdo_app_signal_hdr_s	zb_zdo_app_signal_hdr_t

typedef zb_zdo_app_signal_hdr_t	zb_zdo_app_event_t

Functions
void	zboss_signal_handler (zb_uint8_t param)

zb_zdo_app_signal_type_t	zb_get_app_signal (zb_uint8_t param, zb_zdo_app_signal_hdr_t **sg_p)
	Unpack application signal buffer in zboss_signal_handler() More...

ZDP status values
See also 2.4.5 - ZDP Enumeration Description
#define	ZB_ZDP_STATUS_SUCCESS 0x00U

#define	ZB_ZDP_STATUS_INV_REQUESTTYPE 0x80U

#define	ZB_ZDP_STATUS_DEVICE_NOT_FOUND 0x81U

#define	ZB_ZDP_STATUS_INVALID_EP 0x82U

#define	ZB_ZDP_STATUS_NOT_ACTIVE 0x83U

#define	ZB_ZDP_STATUS_NOT_SUPPORTED 0x84U

#define	ZB_ZDP_STATUS_TIMEOUT 0x85U

#define	ZB_ZDP_STATUS_NO_MATCH 0x86U

#define	ZB_ZDP_STATUS_NO_ENTRY 0x88U

#define	ZB_ZDP_STATUS_NO_DESCRIPTOR 0x89U

#define	ZB_ZDP_STATUS_INSUFFICIENT_SPACE 0x8aU

#define	ZB_ZDP_STATUS_NOT_PERMITTED 0x8bU

#define	ZB_ZDP_STATUS_TABLE_FULL 0x8cU

#define	ZB_ZDP_STATUS_NOT_AUTHORIZED 0x8dU

#define	ZB_ZDP_STATUS_INVALID_INDEX 0x8fU

#define	ZB_ZDP_STATUS_TIMEOUT_BY_STACK 0xffU

Signals passed to zboss_signal_handler()
Note If an application requires the parameters to be passed to the zboss_signal_handler, it is recommended to introduce the structure according to the pattern below: typedef struct zb_zdo_app_my_custom_signal_s { zb_zdo_app_signal_type_t super; zb_my_custom_data_type_t my_custom_data; }
#define	ZB_ZDO_SIGNAL_DEFAULT_START 0U

#define	ZB_ZDO_SIGNAL_SKIP_STARTUP 1U

#define	ZB_ZDO_SIGNAL_DEVICE_ANNCE 2U

#define	ZB_ZDO_SIGNAL_LEAVE 3U

#define	ZB_ZDO_SIGNAL_ERROR 4U

#define	ZB_BDB_SIGNAL_DEVICE_FIRST_START 5U

#define	ZB_BDB_SIGNAL_DEVICE_REBOOT 6U

#define	ZB_SIGNAL_DEVICE_FIRST_START ZB_BDB_SIGNAL_DEVICE_FIRST_START

#define	ZB_SIGNAL_DEVICE_REBOOT ZB_BDB_SIGNAL_DEVICE_REBOOT

#define	ZB_BDB_SIGNAL_STEERING 10U

#define	ZB_BDB_SIGNAL_FORMATION 11U

#define	ZB_BDB_SIGNAL_FINDING_AND_BINDING_TARGET_FINISHED 12U

#define	ZB_BDB_SIGNAL_FINDING_AND_BINDING_INITIATOR_FINISHED 13U

#define	ZB_NWK_SIGNAL_DEVICE_ASSOCIATED 18U

#define	ZB_ZDO_SIGNAL_LEAVE_INDICATION 19U

#define	ZB_BDB_SIGNAL_WWAH_REJOIN_STARTED 20U

#define	ZB_ZGP_SIGNAL_COMMISSIONING 21U

Status codes for F&B Initiator Finished signal

#define	ZB_ZDO_FB_INITIATOR_STATUS_SUCCESS 0U

#define	ZB_ZDO_FB_INITIATOR_STATUS_CANCEL 1U

#define	ZB_ZDO_FB_INITIATOR_STATUS_ALARM 2U

#define	ZB_ZDO_FB_INITIATOR_STATUS_ERROR 3U

Authorization types for @ref ZB_ZDO_SIGNAL_DEVICE_AUTHORIZED

#define	ZB_ZDO_AUTHORIZATION_TYPE_LEGACY 0U

#define	ZB_ZDO_AUTHORIZATION_TYPE_R21_TCLK 1U

Authorization statuses for ZB_ZDO_AUTHORIZATION_TYPE_LEGACY value of @ref
zdo_authorization_type type.
#define	ZB_ZDO_LEGACY_DEVICE_AUTHORIZATION_SUCCESS 0U

#define	ZB_ZDO_LEGACY_DEVICE_AUTHORIZATION_FAILED 1U

Authorization statuses for ZB_ZDO_AUTHORIZATION_TYPE_R21_TCLK value of @ref
zdo_authorization_type type
#define	ZB_ZDO_TCLK_AUTHORIZATION_SUCCESS 0U

#define	ZB_ZDO_TCLK_AUTHORIZATION_TIMEOUT 1U

#define	ZB_ZDO_TCLK_AUTHORIZATION_FAILED 2U

Detailed Description

There are tools that allow an application to handle Zigbee events like network formation, association status, leave indication, and others. Due to its nature, different Zigbee events appear asynchronously and ZBOSS informs the application about it through application signals. The application may handle or ignore a received signal. All application signals are processed in the application with a predefined callback function zboss_signal_handler(). It is mandatory for each application to implement this function, even if there is no need to process a signal.

There are policies that should be taken into account while implementing zboss_signal_handler() function:

Signal processing should not do long operations synchronously. As soon as cooperative multitasking is implemented by the ZBOSS scheduler, each blocking operation blocks the entire Zigbee stack.
If a valid reference to a memory buffer is passed to an application callback function, the application is responsible for managing this memory buffer. This means that the memory buffer must be either reused or released by the application otherwise this buffer will be lost - memory leak occurs.

Macro Definition Documentation

◆ ZB_BDB_SIGNAL_DEVICE_FIRST_START

#define ZB_BDB_SIGNAL_DEVICE_FIRST_START 5U

Device started for the first time after the NVRAM erase.

When generated:

Upon completing the typical device startup (network formation for ZC or rejoin/discovery/association for ZR and ZED).
This signal is exclusive to ZB_BDB_SIGNAL_DEVICE_REBOOT

Note: No ZB_BDB_SIGNAL_STEERING or ZB_BDB_SIGNAL_FORMATION signals will be generated.

Status codes:

RET_OK: Device started after the NVRAM erase
RET_ERROR: An error of any type.

Signal parameters:

none

      case ZB_BDB_SIGNAL_DEVICE_FIRST_START:
        TRACE_MSG(TRACE_APP1, "Device STARTED OK", (FMT__0));
        bdb_start_top_level_commissioning(ZB_BDB_NETWORK_STEERING);
#ifdef TEST_APS_FRAGMENTATION
        ZB_SCHEDULE_APP_ALARM(send_frag_data, 0, ZB_TIME_ONE_SECOND / 2);
#endif
        break;

◆ ZB_BDB_SIGNAL_DEVICE_REBOOT

#define ZB_BDB_SIGNAL_DEVICE_REBOOT 6U

Device started using the NVRAM contents.

When generated:

Upon the device joining/rejoining Zigbee network using restored parameters.
This signal is exclusive to ZB_BDB_SIGNAL_DEVICE_FIRST_START

Note: No ZB_BDB_SIGNAL_STEERING or ZB_BDB_SIGNAL_FORMATION signals will be generated.

Status codes:

RET_OK: Device started using configuration stored in NVRAM
RET_ERROR: An error of any type.

Signal parameters:

none

      case ZB_BDB_SIGNAL_DEVICE_REBOOT:
        TRACE_MSG(TRACE_APP1, "Device RESTARTED OK", (FMT__0));
#ifndef ZB_USE_BUTTONS
        /* Do not have buttons in simulator - just start periodic on/off sending */
        cmd_in_progress = ZB_FALSE;
        ZB_SCHEDULE_APP_ALARM_CANCEL(button_press_handler, ZB_ALARM_ANY_PARAM);
        ZB_SCHEDULE_APP_ALARM(button_press_handler, 0, 7 * ZB_TIME_ONE_SECOND);
#endif
        break;

◆ ZB_BDB_SIGNAL_FINDING_AND_BINDING_INITIATOR_FINISHED

#define ZB_BDB_SIGNAL_FINDING_AND_BINDING_INITIATOR_FINISHED 13U

BDB finding and binding for an initiator endpoint completed.

When generated:

F&B with a Target succeeded or F&B initiator timeout expired or cancelled.

Status codes:

zdo_fb_initiator_finished_status

Signal parameters:

zb_zdo_signal_fb_initiator_finished_params_t

◆ ZB_BDB_SIGNAL_FINDING_AND_BINDING_TARGET_FINISHED

#define ZB_BDB_SIGNAL_FINDING_AND_BINDING_TARGET_FINISHED 12U

BDB finding and binding for a target endpoint completed.

When generated:

F&B target timeout expires.

Status codes:

RET_OK: F&B completed successfully.
RET_ERROR: An error of any type.

Signal parameters:

none

◆ ZB_BDB_SIGNAL_FORMATION

#define ZB_BDB_SIGNAL_FORMATION 11U

BDB network formation completed (Network formation only).

When generated:

Upon completing Network formation initiated by bdb_start_top_level_commissioning(ZB_BDB_NETWORK_FORMATION).

Status codes:

RET_OK: Network formation completed.
Does not return error status.

Signal parameters:

none

◆ ZB_BDB_SIGNAL_STEERING

#define ZB_BDB_SIGNAL_STEERING 10U

BDB network steering completed (Network steering only).

When generated:

Upon completing Network steering initiated by bdb_start_top_level_commissioning(ZB_BDB_NETWORK_STEERING).

Status codes:

RET_OK: Network steering completed.
Does not return error status.

Has additional data of type zb_zdo_signal_leave_indication_params_t.

Signal parameters:

none

◆ ZB_BDB_SIGNAL_WWAH_REJOIN_STARTED

#define ZB_BDB_SIGNAL_WWAH_REJOIN_STARTED 20U

WWAH Rejoin start indication.

When generated:

Device lost communication with the parent and started WWAH Rejoin procedure.

Status codes:

RET_OK: Leave command received from the child device.
Does not return error status.

Signal parameters: no

◆ ZB_GET_APP_SIGNAL_STATUS

#define ZB_GET_APP_SIGNAL_STATUS ( param ) zb_buf_get_status(param)

Get status from the application signal.

Parameters

param - buffer reference

Returns: status zb_ret_t

◆ ZB_NWK_SIGNAL_DEVICE_ASSOCIATED

#define ZB_NWK_SIGNAL_DEVICE_ASSOCIATED 18U

Obsolete signal, used for pre-R21 ZBOSS API compatibility. Use ZB_ZDO_SIGNAL_DEVICE_ANNCE signal instead!

When generated:

Indicates that there is a new device associated with Zigbee Coordinator or router.

Status codes:

RET_OK: New device associated.
Does not return error status.

Signal parameters:

zb_nwk_signal_device_associated_params_t

◆ ZB_ZDO_AUTHORIZATION_TYPE_LEGACY

#define ZB_ZDO_AUTHORIZATION_TYPE_LEGACY 0U

Authorization type for legacy devices ( < r21)

◆ ZB_ZDO_AUTHORIZATION_TYPE_R21_TCLK

#define ZB_ZDO_AUTHORIZATION_TYPE_R21_TCLK 1U

Authorization type for r21 device through TCLK

◆ ZB_ZDO_FB_INITIATOR_STATUS_ALARM

#define ZB_ZDO_FB_INITIATOR_STATUS_ALARM 2U

F&B on the Initiator side is finished by timeout

◆ ZB_ZDO_FB_INITIATOR_STATUS_CANCEL

#define ZB_ZDO_FB_INITIATOR_STATUS_CANCEL 1U

F&B on the Initiator side is canceled

◆ ZB_ZDO_FB_INITIATOR_STATUS_ERROR

#define ZB_ZDO_FB_INITIATOR_STATUS_ERROR 3U

F&B on the Initiator side is failure finished

◆ ZB_ZDO_FB_INITIATOR_STATUS_SUCCESS

#define ZB_ZDO_FB_INITIATOR_STATUS_SUCCESS 0U

F&B with a Target on the Initiator side is success completed

◆ ZB_ZDO_LEGACY_DEVICE_AUTHORIZATION_FAILED

#define ZB_ZDO_LEGACY_DEVICE_AUTHORIZATION_FAILED 1U

Authorization failed

◆ ZB_ZDO_LEGACY_DEVICE_AUTHORIZATION_SUCCESS

#define ZB_ZDO_LEGACY_DEVICE_AUTHORIZATION_SUCCESS 0U

Authorization success

◆ ZB_ZDO_SIGNAL_CUT_HEADER

#define ZB_ZDO_SIGNAL_CUT_HEADER ( buf ) zb_buf_cut_left(buf, sizeof(zb_zdo_app_signal_hdr_t))

Cuts ZBOSS signal headers while keeping the signal parameter (if it was in the buffer).

Parameters

buf	- pointer to a zb_buf_t structure. The buffer must be the one passed into zboss_signal_handler.

◆ ZB_ZDO_SIGNAL_DEFAULT_START

#define ZB_ZDO_SIGNAL_DEFAULT_START 0U

Obsolete signal, used for pre-R21 ZBOSS API compatibility. Not recommended to use.

When generated:

After the device has been started and the non-BDB commissioning completed.
In case of the commissioning error.

Status codes:

RET_OK: Device has started and joined the network.
RET_ERROR: An error of any type.

Signal parameters:

none

◆ ZB_ZDO_SIGNAL_DEVICE_ANNCE

#define ZB_ZDO_SIGNAL_DEVICE_ANNCE 2U

Notifies the application about the new device appearance.

When generated:

Upon receiving the Device_annce command.

Status codes:

RET_OK: Device_annce command was received.
Does not return error status.

Signal parameters:

zb_zdo_signal_device_annce_params_t

      case ZB_ZDO_SIGNAL_DEVICE_ANNCE:
      {
        zb_zdo_signal_device_annce_params_t *dev_annce_params = ZB_ZDO_SIGNAL_GET_PARAMS(sg_p, zb_zdo_signal_device_annce_params_t);
        simple_gw_dev_annce_cb(dev_annce_params->device_short_addr);
      }
      break;

◆ ZB_ZDO_SIGNAL_ERROR

#define ZB_ZDO_SIGNAL_ERROR 4U

Corrupted or incorrect signal information.

When generated:

Incorrect buffer length detected by zb_get_app_signal (less then zb_zdo_app_signal_hdr_t)

Status codes:

none

Signal parameters:

none

◆ ZB_ZDO_SIGNAL_GET_PARAMS

#define ZB_ZDO_SIGNAL_GET_PARAMS	(	sg_p,
		type
	)	((type )(void )((((zb_uint8_t *)sg_p) + sizeof(zb_zdo_app_signal_hdr_t))))

Obtains pointer to parameters passed with application signal.

Parameters

sg_p	- pointer to application signal
type	- parameter type

Returns: pointer to signal parameters

Example

zb_zdo_signal_device_annce_params_t *dev_annce_params = ZB_ZDO_SIGNAL_GET_PARAMS(sg_p, zb_zdo_signal_device_annce_params_t);

simple_gw_dev_annce_cb(dev_annce_params->device_short_addr);

◆ ZB_ZDO_SIGNAL_LEAVE

#define ZB_ZDO_SIGNAL_LEAVE 3U

Notifies the application that the device itself has left the network.

When generated:

Upon sending the "Leave" command.

Status codes:

RET_OK: Device has sent the "Leave" command.
Does not return error status.

Signal parameters:

zb_zdo_signal_leave_params_t

      case ZB_ZDO_SIGNAL_LEAVE:
      {
        zb_zdo_signal_leave_params_t *leave_params = ZB_ZDO_SIGNAL_GET_PARAMS(sg_p, zb_zdo_signal_leave_params_t);
        light_control_retry_join(leave_params->leave_type);
      }
      break;

◆ ZB_ZDO_SIGNAL_LEAVE_INDICATION

#define ZB_ZDO_SIGNAL_LEAVE_INDICATION 19U

Network leave indication.

When generated:

The child device has left the network.

Status codes:

RET_OK: Leave command received from the child device.
RET_ERROR: An error of any type.

Signal parameters:

zb_zdo_signal_leave_indication_params_t

      case ZB_ZDO_SIGNAL_LEAVE_INDICATION:
      {
        zb_zdo_signal_leave_indication_params_t *leave_ind_params = ZB_ZDO_SIGNAL_GET_PARAMS(sg_p, zb_zdo_signal_leave_indication_params_t);
        if (!leave_ind_params->rejoin)
        {
          simple_gw_leave_indication(leave_ind_params->device_addr);
        }
      }
      break;

◆ ZB_ZDO_SIGNAL_SKIP_STARTUP

#define ZB_ZDO_SIGNAL_SKIP_STARTUP 1U

Notifies the application that ZBOSS framework (scheduler, buffer pool, etc.) has started, but no join/rejoin/formation/BDB initialization has been done yet.

When generated:

When the application calls zboss_start_no_autostart() instead of zboss_start() before the zboss_main_loop(). Used when some hardware must be initialized before the Zigbee commissioning, but already has ZBOSS scheduler running. Example: sensor connected through UART.

Status codes:

RET_OK: Only ZBOSS framework has been initialized.
Does not return error status.

Signal parameters:

none

      case ZB_ZDO_SIGNAL_SKIP_STARTUP:
        TRACE_MSG(TRACE_APP1, "ZB_ZDO_SIGNAL_SKIP_STARTUP: start commissioning", (FMT__0));
        if (zb_bdb_is_factory_new())
        {
          ZB_SCHEDULE_APP_ALARM_CANCEL(sp_com_button_pressed_reset_fd, ZB_ALARM_ANY_PARAM);
        }
 
        /* NVRAM is loaded, init relay state */
        {
          zb_zcl_attr_t *attr_desc_on_off = zb_zcl_get_attr_desc_a(SP_ENDPOINT,ZB_ZCL_CLUSTER_ID_ON_OFF,
                                                                   ZB_ZCL_CLUSTER_SERVER_ROLE,
                                                                   ZB_ZCL_ATTR_ON_OFF_ON_OFF_ID);
 
          sp_relay_on_off((zb_bool_t )ZB_ZCL_GET_ATTRIBUTE_VAL_8(attr_desc_on_off));
 
#ifdef SP_CONTROL4_COMPATIBLE
          if (!zb_bdb_is_factory_new())
          {
            /* Increment BOOT_COUNT attribute */
            g_dev_ctx.c4_attr.boot_count++;
            ZB_SCHEDULE_APP_CALLBACK(sp_write_app_data, 0);
          }
#endif /* SP_CONTROL4_COMPATIBLE */
        }
        /* Have zb_bdb_is_factory_new() check inside */
        ZB_SCHEDULE_APP_CALLBACK(sp_start_join, SP_FIRST_JOIN_ATTEMPT);
        break;

◆ ZB_ZDO_TCLK_AUTHORIZATION_FAILED

#define ZB_ZDO_TCLK_AUTHORIZATION_FAILED 2U

Authorization failed

◆ ZB_ZDO_TCLK_AUTHORIZATION_SUCCESS

#define ZB_ZDO_TCLK_AUTHORIZATION_SUCCESS 0U

Authorization success

◆ ZB_ZDO_TCLK_AUTHORIZATION_TIMEOUT

#define ZB_ZDO_TCLK_AUTHORIZATION_TIMEOUT 1U

Authorization timeout

◆ ZB_ZDP_STATUS_DEVICE_NOT_FOUND

#define ZB_ZDP_STATUS_DEVICE_NOT_FOUND 0x81U

The supplied endpoint was equal to 0x00 or between 0xf1 and 0xff.

◆ ZB_ZDP_STATUS_INSUFFICIENT_SPACE

#define ZB_ZDP_STATUS_INSUFFICIENT_SPACE 0x8aU

The device is not in the proper state to support the requested operation.

◆ ZB_ZDP_STATUS_INV_REQUESTTYPE

#define ZB_ZDP_STATUS_INV_REQUESTTYPE 0x80U

The requested device did not exist on a device following a child descriptor request to a parent.

◆ ZB_ZDP_STATUS_INVALID_EP

#define ZB_ZDP_STATUS_INVALID_EP 0x82U

The requested endpoint is not described by simple descriptor.

◆ ZB_ZDP_STATUS_INVALID_INDEX

#define ZB_ZDP_STATUS_INVALID_INDEX 0x8fU

Custom internal statuses.

◆ ZB_ZDP_STATUS_NO_DESCRIPTOR

#define ZB_ZDP_STATUS_NO_DESCRIPTOR 0x89U

The device does not have storage space to support the requested operation.

◆ ZB_ZDP_STATUS_NO_ENTRY

#define ZB_ZDP_STATUS_NO_ENTRY 0x88U

A child descriptor was not available following a discovery request to a parent.

◆ ZB_ZDP_STATUS_NO_MATCH

#define ZB_ZDP_STATUS_NO_MATCH 0x86U

The unbind request was unsuccessful due to the coordinator or source device not having an entry in its binding table to unbind.

◆ ZB_ZDP_STATUS_NOT_ACTIVE

#define ZB_ZDP_STATUS_NOT_ACTIVE 0x83U

The requested optional feature is not supported on the target device.

◆ ZB_ZDP_STATUS_NOT_AUTHORIZED

#define ZB_ZDP_STATUS_NOT_AUTHORIZED 0x8dU

The index in the received command is out of bounds.

◆ ZB_ZDP_STATUS_NOT_PERMITTED

#define ZB_ZDP_STATUS_NOT_PERMITTED 0x8bU

The device does not have table space to support the operation.

◆ ZB_ZDP_STATUS_NOT_SUPPORTED

#define ZB_ZDP_STATUS_NOT_SUPPORTED 0x84U

A timeout has occurred with the requested operation.

◆ ZB_ZDP_STATUS_SUCCESS

#define ZB_ZDP_STATUS_SUCCESS 0x00U

The requested operation or transmission was completed successfully. The supplied request type was invalid.

◆ ZB_ZDP_STATUS_TABLE_FULL

#define ZB_ZDP_STATUS_TABLE_FULL 0x8cU

The permissions configuration table on the target indicates that the request is not authorized from this device.

◆ ZB_ZDP_STATUS_TIMEOUT

#define ZB_ZDP_STATUS_TIMEOUT 0x85U

The end device bind request was unsuccessful due to a failure to match any suitable clusters.

◆ ZB_ZGP_SIGNAL_COMMISSIONING

#define ZB_ZGP_SIGNAL_COMMISSIONING 21U

ZGP commissioning complete signal.

When generated:

GPCB left the commissioning mode.

Status codes:

RET_OK: commissioning complete.
RET_ERROR: An error of any type.

Signal parameters:

zb_zgp_signal_commissioning_params_s

      case ZB_ZGP_SIGNAL_COMMISSIONING:
      {
        zb_zgp_signal_commissioning_params_t *comm_params = ZB_ZDO_SIGNAL_GET_PARAMS(sg_p, zb_zgp_signal_commissioning_params_t);
        comm_done_cb(comm_params->zgpd_id, comm_params->result);
      }
      break;

Typedef Documentation

◆ zb_nwk_signal_device_associated_params_t

typedef struct zb_nwk_signal_device_associated_params_s zb_nwk_signal_device_associated_params_t

Association parameters.

Stack passes this parameter to application when some device associates to that.

◆ zb_zdo_app_signal_hdr_t

typedef struct zb_zdo_app_signal_hdr_s zb_zdo_app_signal_hdr_t

Application signal header

◆ zb_zdo_app_signal_type_t

typedef zb_uint8_t zb_zdo_app_signal_type_t

Type for signals passed to zboss_signal_handler().

Holds one of zdo_app_signal_type. Previously it was defined as enum but was converted to a set of defines due to MISRA violations.

◆ zb_zdo_authorization_type_t

typedef zb_uint8_t zb_zdo_authorization_type_t

Type for Authorization types for ZB_ZDO_SIGNAL_DEVICE_AUTHORIZED.

◆ zb_zdo_fb_initiator_finished_status_t

typedef zb_uint8_t zb_zdo_fb_initiator_finished_status_t

Type for Status codes for F&B Initiator Finished signal.

Holds one of zdo_fb_initiator_finished_status. Kept only for backward compatibility as zdo_fb_initiator_finished_status were declared previously as enum. Can be removed in future releases.

◆ zb_zdo_legacy_device_authorization_status_t

typedef zb_uint8_t zb_zdo_legacy_device_authorization_status_t

Type for Authorization statuses for ZB_ZDO_AUTHORIZATION_TYPE_LEGACY value of zdo_authorization_type type.

◆ zb_zdo_signal_can_sleep_params_t

typedef struct zb_zdo_signal_can_sleep_params_s zb_zdo_signal_can_sleep_params_t

Sleep signal parameters.

Stack passes this parameter to application when device ready to sleep.

◆ zb_zdo_signal_device_annce_params_t

typedef struct zb_zdo_signal_device_annce_params_s zb_zdo_signal_device_annce_params_t

Association parameters.

Stack passes this parameter to application when some device joins/rejoins to network.

◆ zb_zdo_signal_leave_indication_params_t

typedef struct zb_zdo_signal_leave_indication_params_s zb_zdo_signal_leave_indication_params_t

Leave Indication parameters.

Stack passes this parameter to application upon receipt of leave indication primitive.

◆ zb_zdo_signal_leave_params_t

typedef struct zb_zdo_signal_leave_params_s zb_zdo_signal_leave_params_t

Leave parameters.

Stack passes this parameter to application when device leave the network.

◆ zb_zdo_signal_macsplit_dev_boot_params_t

typedef struct zb_zdo_signal_macsplit_dev_boot_params_s zb_zdo_signal_macsplit_dev_boot_params_t

Macsplit device boot parameters.

Macsplit passes this parameter to application when device is booted.

◆ zb_zdo_signal_nlme_status_indication_params_t

typedef struct zb_zdo_signal_nlme_status_indication_params_s zb_zdo_signal_nlme_status_indication_params_t

NLME status indication parameters.

Stack passes this parameter to application when NLME status indication is generated.

◆ zb_zdo_tclk_authorization_status_t

typedef zb_uint8_t zb_zdo_tclk_authorization_status_t

Type for Authorization types for ZB_ZDO_SIGNAL_DEVICE_AUTHORIZED.

◆ zb_zdp_status_t

typedef zb_uint8_t zb_zdp_status_t

Type for ZDP status values.

Holds one of zdp_status. Kept for backward compatibility as zdp_status were declared previously as enum.

Function Documentation

◆ zb_get_app_signal()

zb_zdo_app_signal_type_t zb_get_app_signal	(	zb_uint8_t	param,
		zb_zdo_app_signal_hdr_t **	sg_p
	)

Unpack application signal buffer in zboss_signal_handler()

Parameters

param	- parameter of zboss_signal_handler()
sg_p	- pointer to the extended signal info, if application wants it. Can be NULL.

Returns: Application signal

◆ zboss_signal_handler()

void zboss_signal_handler ( zb_uint8_t param )

ZBOSS application signal handler.

Mandatory for all applications implemented on the top of ZBOSS stack. See zdo_app_signal_type.

Parameters

param - reference to the buffer which contains signal. See zb_get_app_signal.

Modules

Data Structures

Macros

Typedefs

Functions

ZDP status values

Signals passed to zboss_signal_handler()

Status codes for F&B Initiator Finished signal

Authorization types for @ref ZB_ZDO_SIGNAL_DEVICE_AUTHORIZED

Authorization statuses for ZB_ZDO_AUTHORIZATION_TYPE_LEGACY value of @ref

Authorization statuses for ZB_ZDO_AUTHORIZATION_TYPE_R21_TCLK value of @ref

Detailed Description

Macro Definition Documentation

◆ ZB_BDB_SIGNAL_DEVICE_FIRST_START

◆ ZB_BDB_SIGNAL_DEVICE_REBOOT

◆ ZB_BDB_SIGNAL_FINDING_AND_BINDING_INITIATOR_FINISHED

◆ ZB_BDB_SIGNAL_FINDING_AND_BINDING_TARGET_FINISHED

◆ ZB_BDB_SIGNAL_FORMATION

◆ ZB_BDB_SIGNAL_STEERING

◆ ZB_BDB_SIGNAL_WWAH_REJOIN_STARTED

◆ ZB_GET_APP_SIGNAL_STATUS

◆ ZB_NWK_SIGNAL_DEVICE_ASSOCIATED

◆ ZB_ZDO_AUTHORIZATION_TYPE_LEGACY

◆ ZB_ZDO_AUTHORIZATION_TYPE_R21_TCLK

◆ ZB_ZDO_FB_INITIATOR_STATUS_ALARM

◆ ZB_ZDO_FB_INITIATOR_STATUS_CANCEL

◆ ZB_ZDO_FB_INITIATOR_STATUS_ERROR

◆ ZB_ZDO_FB_INITIATOR_STATUS_SUCCESS

◆ ZB_ZDO_LEGACY_DEVICE_AUTHORIZATION_FAILED

◆ ZB_ZDO_LEGACY_DEVICE_AUTHORIZATION_SUCCESS

◆ ZB_ZDO_SIGNAL_CUT_HEADER

◆ ZB_ZDO_SIGNAL_DEFAULT_START

◆ ZB_ZDO_SIGNAL_DEVICE_ANNCE

◆ ZB_ZDO_SIGNAL_ERROR

◆ ZB_ZDO_SIGNAL_GET_PARAMS

◆ ZB_ZDO_SIGNAL_LEAVE

◆ ZB_ZDO_SIGNAL_LEAVE_INDICATION

◆ ZB_ZDO_SIGNAL_SKIP_STARTUP

◆ ZB_ZDO_TCLK_AUTHORIZATION_FAILED

◆ ZB_ZDO_TCLK_AUTHORIZATION_SUCCESS

◆ ZB_ZDO_TCLK_AUTHORIZATION_TIMEOUT

◆ ZB_ZDP_STATUS_DEVICE_NOT_FOUND

◆ ZB_ZDP_STATUS_INSUFFICIENT_SPACE

◆ ZB_ZDP_STATUS_INV_REQUESTTYPE

◆ ZB_ZDP_STATUS_INVALID_EP

◆ ZB_ZDP_STATUS_INVALID_INDEX

◆ ZB_ZDP_STATUS_NO_DESCRIPTOR

◆ ZB_ZDP_STATUS_NO_ENTRY

◆ ZB_ZDP_STATUS_NO_MATCH

◆ ZB_ZDP_STATUS_NOT_ACTIVE

◆ ZB_ZDP_STATUS_NOT_AUTHORIZED

◆ ZB_ZDP_STATUS_NOT_PERMITTED

◆ ZB_ZDP_STATUS_NOT_SUPPORTED

◆ ZB_ZDP_STATUS_SUCCESS

◆ ZB_ZDP_STATUS_TABLE_FULL

◆ ZB_ZDP_STATUS_TIMEOUT

◆ ZB_ZGP_SIGNAL_COMMISSIONING

Typedef Documentation

◆ zb_nwk_signal_device_associated_params_t

◆ zb_zdo_app_signal_hdr_t

◆ zb_zdo_app_signal_type_t

◆ zb_zdo_authorization_type_t

◆ zb_zdo_fb_initiator_finished_status_t

◆ zb_zdo_legacy_device_authorization_status_t

◆ zb_zdo_signal_can_sleep_params_t

◆ zb_zdo_signal_device_annce_params_t

◆ zb_zdo_signal_leave_indication_params_t

◆ zb_zdo_signal_leave_params_t

◆ zb_zdo_signal_macsplit_dev_boot_params_t

◆ zb_zdo_signal_nlme_status_indication_params_t

◆ zb_zdo_tclk_authorization_status_t

◆ zb_zdp_status_t

Function Documentation

◆ zb_get_app_signal()

◆ zboss_signal_handler()