Security subsystem API

Functions
void	zb_secur_setup_nwk_key (zb_uint8_t *key, zb_uint8_t i)
zb_ret_t	zb_secur_ic_add (zb_ieee_addr_t address, zb_uint8_t *ic)
zb_ret_t	zb_secur_ic_remove (zb_ieee_addr_t address)
zb_ret_t	zb_secur_ic_set (zb_uint8_t *ic)
void	zb_set_installcode_policy (zb_bool_t allow_ic_only)

Detailed Description

Function Documentation

zb_ret_t zb_secur_ic_add	(	zb_ieee_addr_t	address,
		zb_uint8_t *	ic
	)

Add the install code for the device with specified long address.

This valid is valid only for the TC (ZC).

Parameters

address	- long address of the device to add the install code.
ic	- pointer to the install code buffer.

Returns

RET_OK on success or RET_CONVERSION_ERROR on error in install code CRC

static void enter_wrong_ic(zb_uint8_t param)
{
 int i;
 zb_ret_t ret;

 ZVUNUSED(param);

 ZB_MEMCPY(s_temp_ic, g_ic1, 18);
 for (i = 0; i < 4; ++i)
 {
 s_temp_ic[i] = ~s_temp_ic[i];
 }
 ret = zb_secur_ic_add(g_ieee_addr_thr1, s_temp_ic);

zb_ret_t zb_secur_ic_remove

(

zb_ieee_addr_t

address

)

Remove the install code for the device with specified long address.

This valid is valid only for the TC (ZC).

Parameters

address

- long address of the device to remove the install code.

Returns

RET_OK on success or RET_NO_MATCH if installcode for address isn't present

zb_ret_t zb_secur_ic_set

(

zb_uint8_t *

ic

)

Add the client install code.

This function is to be run at client side (not at TC).

Parameters

ic	- pointer to the install code buffer.

Returns

RET_OK on success or RET_CONVERSION_ERROR on error in install code CRC

void zb_secur_setup_nwk_key	(	zb_uint8_t *	key,
		zb_uint8_t	i
	)

Setup nwk key to be used by ZCP tests.

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.

Parameters

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

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 TP_R20_BV-01 sample.

void zb_set_installcode_policy

(

zb_bool_t

allow_ic_only

)

Set installcode policy flag.

Parameters

allow_ic_only

- use ZB_TRUE value to check installcodes