Security subsystem API

Functions
void	zb_secur_setup_nwk_key (zb_uint8_t *key, zb_uint8_t i)
	Setup nwk key to be used by ZCP tests. More...
void	zb_secur_nwk_key_switch_procedure (zb_uint8_t param)
void	zb_secur_set_tc_rejoin_enabled (zb_bool_t enable)
void	zb_secur_set_ignore_tc_rejoin (zb_bool_t enable)

Detailed Description

Function Documentation

zb_secur_nwk_key_switch_procedure()

void zb_secur_nwk_key_switch_procedure

(

zb_uint8_t

param

)

Initiate procedure of NWK key switching.

Generate next NWK key if it not exists, broadcast new NWK key, after delay broadcast NWK key switch command. Can run at TC only.

Parameters

param

- work buffer ID or 0 (is zero, function allocates buffer itself)

zb_secur_set_ignore_tc_rejoin()

void zb_secur_set_ignore_tc_rejoin

(

zb_bool_t

enable

)

Specifies whether Trust Center Rejoin is ignored.

If set to ZB_TRUE, devices that attempted unsecure rejoin will be ignored.

Parameters

enable

- whether to enable or disable TC Rejoin ignore.

zb_secur_set_tc_rejoin_enabled()

void zb_secur_set_tc_rejoin_enabled

(

zb_bool_t

enable

)

Specifies whether unsecure Trust Center Rejoin is allowed.

If set to ZB_FALSE, devices that attempted unsecure rejoin will not be authorized.

Parameters

enable

- whether to enable or disable TC Rejoin.

zb_secur_setup_nwk_key()

void zb_secur_setup_nwk_key	(	zb_uint8_t *	key,
		zb_uint8_t	i
	)

Setup nwk key to be used by ZCP tests.

Parameters

key	- key to be used
i	- key number (0-3)

Call this routine at TC to change random nwk key generated from zb_ib_set_defaults to well-known key. To be used in certification tests.

/* NWK key for the device */
static const zb_uint8_t g_key_nwk[16] = { 0xab, 0xcd, 0xef, 0x01, 0x23, 0x45, 0x67, 0x89, 0, 0, 0, 0, 0, 0, 0, 0};

  zb_secur_setup_nwk_key((zb_uint8_t *) g_key_nwk, 0);

See also

TP_R20_BV-01 sample.