Collaboration diagram for Door Lock server APIs:

Functions
void	tr_door_lock_server_lock (zb_uint8_t endpoint, tr_door_lock_event_source_t event_source, zb_uint8_t *pin)
	API that can be used to lock the door.
void	tr_door_lock_server_unlock (zb_uint8_t endpoint, tr_door_lock_event_source_t event_source, zb_uint8_t *pin)
	API that can be used to unlock the door.
void	tr_door_lock_server_update_lock_state (zb_uint8_t endpoint, zb_uint8_t lock_state, zb_uint8_t source, zb_uint16_t user, zb_uint8_t *pin)
	API used to notify the door lock server plugin of lock state changes.
void	tr_door_lock_server_send_op_event_notification (zb_uint8_t endpoint, zb_uint8_t source, zb_uint8_t code, zb_uint16_t user, zb_uint8_t *pin, zb_uint8_t mask_bit)
	API used to send an operation event notification.
zb_uint32_t	tr_get_auto_relock_time_seconds (zb_uint8_t endpoint)
	API for getting the auto-relock time.
zb_bool_t	tr_door_lock_server_verify_user (zb_uint8_t endpoint, zb_bool_t rf_operation, zb_uint8_t pin, zb_uint16_t user)
	API used to verify a PIN code.
tr_door_lock_set_pin_or_id_status_t	tr_door_lock_server_add_user (zb_uint16_t user, tr_door_lock_user_status_t status, tr_door_lock_user_type_t type, zb_uint8_t *pin)
	API used to add a user to the table.
zb_bool_t	tr_door_lock_server_get_user (zb_uint16_t user, tr_door_lock_get_pin_resp_t *user_info)
	API used to get a user table entry.
zb_bool_t	tr_door_lock_server_delete_user (zb_uint16_t user)
	API to delete an entry from the user table.
void	tr_door_lock_server_delete_all_pin_users (void)
	API to delete ALL entries from the user table.
zb_bool_t	tr_door_lock_server_set_user_status (zb_uint16_t user, tr_door_lock_user_status_t user_status)
	API to set the status for a user in the user able.
zb_bool_t	tr_door_lock_server_get_user_status (zb_uint16_t user, tr_door_lock_get_user_status_resp_t *user_info)
	API to get the status of a user in the user table.
zb_bool_t	tr_door_lock_server_set_user_type (zb_uint16_t user, tr_door_lock_user_type_t user_type)
	API to set the type of a user in the user table.
zb_bool_t	tr_door_lock_server_get_user_type (zb_uint16_t user, tr_door_lock_get_user_type_resp_t *user_info)
	API to get the type of a user from the user table.
void	tr_door_lock_server_print_users (void)
	API to print the user table.

Detailed Description

Function Documentation

◆ tr_door_lock_server_add_user()

tr_door_lock_set_pin_or_id_status_t tr_door_lock_server_add_user	(	zb_uint16_t	user,
		tr_door_lock_user_status_t	status,
		tr_door_lock_user_type_t	type,
		zb_uint8_t *	pin )

API used to add a user to the table.

Parameters

user	index of user table entry
status	ZCL user status
type	ZCL user type
pin	pointer to ZCL octet string (length prefixed) pin code in ASCII

Returns: ZCL set pin status code

◆ tr_door_lock_server_delete_all_pin_users()

void tr_door_lock_server_delete_all_pin_users ( void )

API to delete ALL entries from the user table.

◆ tr_door_lock_server_delete_user()

zb_bool_t tr_door_lock_server_delete_user ( zb_uint16_t user )

API to delete an entry from the user table.

Parameters

user	index of user table entry

Returns: ZB_TRUE if successful, ZB_FALSE if not

◆ tr_door_lock_server_get_user()

zb_bool_t tr_door_lock_server_get_user	(	zb_uint16_t	user,
		tr_door_lock_get_pin_resp_t *	user_info )

API used to get a user table entry.

Parameters

user	index of user table entry
user_info	pointer to ZCL user table entry

Returns: ZB_TRUE if successful, ZB_FALSE if not

◆ tr_door_lock_server_get_user_status()

zb_bool_t tr_door_lock_server_get_user_status	(	zb_uint16_t	user,
		tr_door_lock_get_user_status_resp_t *	user_info )

API to get the status of a user in the user table.

Parameters

user	index of user table entry
user_info	pointer for returned user status info

Returns: ZB_TRUE if successful, ZB_FALSE if not

◆ tr_door_lock_server_get_user_type()

zb_bool_t tr_door_lock_server_get_user_type	(	zb_uint16_t	user,
		tr_door_lock_get_user_type_resp_t *	user_info )

API to get the type of a user from the user table.

Parameters

user	index of user table entry
user_info	pointer for returned user type info

Returns: ZB_TRUE if successful, ZB_FALSE if not

◆ tr_door_lock_server_lock()

void tr_door_lock_server_lock	(	zb_uint8_t	endpoint,
		tr_door_lock_event_source_t	event_source,
		zb_uint8_t *	pin )

API that can be used to lock the door.

Parameters

endpoint	device endpoint
event_source	source of the lock door event
pin	pointer to ZCL octet string (length prefixed) pin code in ASCII

◆ tr_door_lock_server_print_users()

void tr_door_lock_server_print_users ( void )

API to print the user table.

◆ tr_door_lock_server_send_op_event_notification()

void tr_door_lock_server_send_op_event_notification	(	zb_uint8_t	endpoint,
		zb_uint8_t	source,
		zb_uint8_t	code,
		zb_uint16_t	user,
		zb_uint8_t *	pin,
		zb_uint8_t	mask_bit )

API used to send an operation event notification.

Parameters

endpoint	device endpoint
source	ZCL source of operation event notification
code	ZCL operation event code
user	user id
pin	pointer to ZCL octet string (length prefixed) pin code in ASCII
mask_bit	bit to compare against the event mask attribute

◆ tr_door_lock_server_set_user_status()

zb_bool_t tr_door_lock_server_set_user_status	(	zb_uint16_t	user,
		tr_door_lock_user_status_t	user_status )

API to set the status for a user in the user able.

Parameters

user	index of user table entry
user_status	ZCL user status

Returns: ZB_TRUE if successful, ZB_FALSE if not

◆ tr_door_lock_server_set_user_type()

zb_bool_t tr_door_lock_server_set_user_type	(	zb_uint16_t	user,
		tr_door_lock_user_type_t	user_type )

API to set the type of a user in the user table.

Parameters

user	index of user table entry
user_type	ZCL user type

Returns: ZB_TRUE if successful, ZB_FALSE if not

◆ tr_door_lock_server_unlock()

void tr_door_lock_server_unlock	(	zb_uint8_t	endpoint,
		tr_door_lock_event_source_t	event_source,
		zb_uint8_t *	pin )

API that can be used to unlock the door.

Parameters

endpoint	device endpoint
event_source	source of the unlock door event
pin	pointer to ZCL octet string (length prefixed) pin code in ASCII

◆ tr_door_lock_server_update_lock_state()

void tr_door_lock_server_update_lock_state	(	zb_uint8_t	endpoint,
		zb_uint8_t	lock_state,
		zb_uint8_t	source,
		zb_uint16_t	user,
		zb_uint8_t *	pin )

API used to notify the door lock server plugin of lock state changes.

Parameters

endpoint	device endpoint
lock_state	new ZCL lock state
source	ZCL source for change
user	user id
pin	pointer to ZCL octet string (length prefixed) pin code in ASCII

◆ tr_door_lock_server_verify_user()

zb_bool_t tr_door_lock_server_verify_user	(	zb_uint8_t	endpoint,
		zb_bool_t	rf_operation,
		zb_uint8_t *	pin,
		zb_uint16_t *	user )

API used to verify a PIN code.

Parameters

endpoint	device endpoint
rf_operation	ZB_TRUE if this is an RF operation, ZB_FALSE is manual
pin	pointer to ZCL octet string (length prefixed) pin code in ASCII
user	pointer used to return the user associated with the pin. only valid if return is ZB_TRUE

Returns: ZB_TRUE if user is valid, ZB_FALSE if not

◆ tr_get_auto_relock_time_seconds()

zb_uint32_t tr_get_auto_relock_time_seconds ( zb_uint8_t endpoint )

API for getting the auto-relock time.

Parameters

endpoint device endpoint

Returns: Auto-relock time in seconds. 0 indicates auto-relock is disabled

Trident IoT Zigbee SDK

Functions

Detailed Description

Function Documentation

◆ tr_door_lock_server_add_user()

◆ tr_door_lock_server_delete_all_pin_users()

◆ tr_door_lock_server_delete_user()

◆ tr_door_lock_server_get_user()

◆ tr_door_lock_server_get_user_status()

◆ tr_door_lock_server_get_user_type()

◆ tr_door_lock_server_lock()

◆ tr_door_lock_server_print_users()

◆ tr_door_lock_server_send_op_event_notification()

◆ tr_door_lock_server_set_user_status()

◆ tr_door_lock_server_set_user_type()

◆ tr_door_lock_server_unlock()

◆ tr_door_lock_server_update_lock_state()

◆ tr_door_lock_server_verify_user()

◆ tr_get_auto_relock_time_seconds()