Utility APIs
[Device Module APIs]

Function for Setting/Copying Application instance to Device Manager handle.

Parameters:

[in]	p_appl_instance	Application instance to be set.
[out]	p_handle	Device Manager handle for which the instance is to be copied.

Return values:

NRF_SUCCESS	On success, else an error code indicating reason for failure.
NRF_ERROR_INVALID_STATE	If the API is called without module initialization and/or application registration.
NRF_ERROR_NULL	If p_handle and/or p_addr is NULL.

Definition at line 2310 of file device_manager_peripheral.c.

Function for getting distributed keys for a device.

Parameters:

[in]	p_handle	Device Manager handle identifying the peer.
[out]	p_key_dist	Pointer to distributed keys.

Return values:

NRF_SUCCESS	On success, else an error code indicating reason for failure.
NRF_ERROR_INVALID_STATE	If the API is called without module initialization and/or application registration.
NRF_ERROR_NULL	If the p_handle and/or p_key_dist pointer is NULL.
NRF_ERROR_INVALID_ADDR	If the peer is not identified by the handle provided by the application.

Definition at line 2422 of file device_manager_peripheral.c.

Function for getting the corresponding dm_handle_t based on the connection handle.

Parameters:

[in]	conn_handle	Connection handle as provided by the SoftDevice.
[in,out]	p_handle	Pointer to the p_handle containg the application instance for the registered application. If the application instance is valid then the p_handle will be filled with requested data.

Return values:

NRF_SUCCESS	On success, else an error code indicating reason for failure.
NRF_ERROR_NULL	If the p_handle pointer is NULL.
NRF_ERROR_NOT_FOUND	If no p_handle is found for the provided connection handle.

Definition at line 2907 of file device_manager_peripheral.c.

Function for initializing Device Manager handle.

Parameters:

[in]

p_handle

Device Manager handle to be initialized.

Return values:

NRF_SUCCESS	On success.
NRF_ERROR_NULL	If p_handle is NULL.

Note:

This routine is permitted before initialization of the module.

Definition at line 2324 of file device_manager_peripheral.c.

Function for getting a peer's device address.

Parameters:

[in]	p_handle	Identifies the peer device whose address is requested. Can not be NULL.
[out]	p_addr	Pointer where address is to be copied. Can not be NULL.

Return values:

NRF_SUCCESS	On success, else an error code indicating reason for failure.
NRF_ERROR_INVALID_STATE	If the API is called without module initialization and/or application registration.
NRF_ERROR_NULL	If p_handle and/or p_addr is NULL.
NRF_ERROR_NOT_FOUND	If the peer could not be identified.

Definition at line 2373 of file device_manager_peripheral.c.

Function for setting/updating a peer's device address.

Parameters:

[in]	p_handle	Identifies the peer device whose address is requested to be set/updated.
[out]	p_addr	Address to be set/updated.

Return values:

NRF_SUCCESS	On success, else an error code indicating reason for failure.
NRF_ERROR_INVALID_STATE	If the API is called without module initialization and/or application registration.
NRF_ERROR_NULL	If p_handle and/or p_addr is NULL.
NRF_ERROR_INVALID_ADDR	If the peer is not identified by the handle provided by the application.
NRF_ERROR_INVALID_PARAM	If this procedure is requested while connected to the peer or if the address type was set to BLE_GAP_ADDR_TYPE_RANDOM_PRIVATE_RESOLVABLE.

Note:

Setting or updating a peer's device address is permitted only for a peer that is bonded and disconnected.

Updated address is reflected only after DM_EVT_DEVICE_CONTEXT_STORED is notified to the application for this bonded device instance. In order to avoid abnormal behaviour, it is recommended to not invite/initiate connections on the updated address unless this event has been notified.

Definition at line 2337 of file device_manager_peripheral.c.