BDB Finding and Binding

Typedefs
typedef enum zb_bdb_comm_binding_cb_state_e	zb_bdb_comm_binding_cb_state_t
typedef zb_bool_t(*	zb_bdb_comm_binding_callback_t )(zb_int16_t status, zb_ieee_addr_t addr, zb_uint8_t ep, zb_uint16_t cluster)
	BDB finding and binding callback template. More...

Enumerations
enum	zb_bdb_comm_binding_cb_state_e { ZB_BDB_COMM_BIND_SUCCESS = 0, ZB_BDB_COMM_BIND_FAIL = 1, ZB_BDB_COMM_BIND_ASK_USER = 2 }

Functions
zb_ret_t	zb_bdb_finding_binding_target (zb_uint8_t endpoint)
	Starts EZ-Mode Finding and binding mechanism at the target's endpoint. More...
zb_ret_t	zb_bdb_finding_binding_initiator (zb_uint8_t endpoint, zb_bdb_comm_binding_callback_t user_binding_cb)
	Start BDB finding and binding procedure on initiator. More...
void	zb_bdb_finding_binding_target_cancel (void)
void	zb_bdb_finding_binding_initiator_cancel (void)

Detailed Description

Typedef Documentation

typedef zb_bool_t( * zb_bdb_comm_binding_callback_t)(zb_int16_t status, zb_ieee_addr_t addr, zb_uint8_t ep, zb_uint16_t cluster)

BDB finding and binding callback template.

Function is used both to interact with user application, get decision if new binding is needed or not, and to report the binding result

Parameters

status

- status of the binding (ask user, success or fail)

See also

zb_bdb_comm_binding_cb_state_t

Parameters

addr	- extended address of a device to bind
ep	- endpoint of a device to bind
cluster	- cluster id to bind

Returns

bool - agree or disagree

Example:

static zb_bool_t finding_binding_cb(zb_int16_t status,
 zb_ieee_addr_t addr,
 zb_uint8_t ep,
 zb_uint16_t cluster)
{
 TRACE_MSG(TRACE_ZCL1, "finding_binding_cb status %d addr " TRACE_FORMAT_64 " ep %hd cluster %d",
 (FMT__D_A_H_D, status, TRACE_ARG_64(addr), ep, cluster));
 return ZB_TRUE;
}


static void trigger_fb_ini(zb_uint8_t unused)
{
 ZVUNUSED(unused);
 zb_bdb_finding_binding_initiator(DUT_ENDPOINT, finding_binding_cb);
}

typedef enum zb_bdb_comm_binding_cb_state_e zb_bdb_comm_binding_cb_state_t

List of EZ-Mode binding callback states

Enumeration Type Documentation

enum zb_bdb_comm_binding_cb_state_e

List of EZ-Mode binding callback states

Enumerator
ZB_BDB_COMM_BIND_SUCCESS	Previously user applied bind finished successfully
ZB_BDB_COMM_BIND_FAIL	Previously user applied bind failed
ZB_BDB_COMM_BIND_ASK_USER	Ask user whether to perform binding

Function Documentation

zb_ret_t zb_bdb_finding_binding_initiator	(	zb_uint8_t	endpoint,
		zb_bdb_comm_binding_callback_t	user_binding_cb
	)

Start BDB finding and binding procedure on initiator.

Summary: Finding and binding as initiator zb_bdb_finding_binding_initiator() returns RET_OK if procedure was started successfully, error code otherwise. To report procedure status, user callback is called. It may be called several times with Success status and only once with error status. If any error appears, finding and binding stops.

Parameters

endpoint	- initiator endpoint
user_binding_cb	- user callback, see zb_bdb_comm_binding_callback_t

Returns

bool - RET_OK or error code

Example:

static zb_bool_t finding_binding_cb(zb_int16_t status,
 zb_ieee_addr_t addr,
 zb_uint8_t ep,
 zb_uint16_t cluster)
{
 TRACE_MSG(TRACE_ZCL1, "finding_binding_cb status %d addr " TRACE_FORMAT_64 " ep %hd cluster %d",
 (FMT__D_A_H_D, status, TRACE_ARG_64(addr), ep, cluster));
 return ZB_TRUE;
}


static void trigger_fb_ini(zb_uint8_t unused)
{
 ZVUNUSED(unused);
 zb_bdb_finding_binding_initiator(DUT_ENDPOINT, finding_binding_cb);
}

void zb_bdb_finding_binding_initiator_cancel

(

void

)

Cancel previously started finding and binding procedure on initiator

zb_ret_t zb_bdb_finding_binding_target

(

zb_uint8_t

endpoint

)

Starts EZ-Mode Finding and binding mechanism at the target's endpoint.

Put device into identifying mode; default duration is 3 minutes.

Parameters

endpoint

- target endpoint

Returns

RET_OK if procedure was successfully started

Note

: endpoint should be registered on target

Example

ZB_ZDO_STARTUP_COMPLETE(zb_uint8_t param)
{
 zb_zdo_app_signal_type_t sig = zb_get_app_signal(param, NULL);

 if (ZB_GET_APP_SIGNAL_STATUS(param) == 0)
 {
 switch(sig)
 {
 case ZB_BDB_SIGNAL_DEVICE_FIRST_START:
 TRACE_MSG(TRACE_APS1, "Device STARTED OK", (FMT__0));
 bdb_start_top_level_commissioning(ZB_BDB_NETWORK_STEERING);
 break;

 case ZB_BDB_SIGNAL_STEERING:
 TRACE_MSG(TRACE_APS1, "Successfull steering", (FMT__0));
 zb_bdb_finding_binding_target(DUT_ENDPOINT);
 break;

 default:
 TRACE_MSG(TRACE_APS1, "Unknown signal", (FMT__0));
 }
 }
 else
 {
 TRACE_MSG(TRACE_ERROR, "Device started FAILED status %d", (FMT__D, ZB_GET_APP_SIGNAL_STATUS(param)));
 }
 zb_free_buf(ZB_BUF_FROM_REF(param));
}

void zb_bdb_finding_binding_target_cancel

(

void

)

Cancel previously started finding and binding procedure on target