Object Transfer Service client module.
More...
|
enum | ble_ots_c_oacp_proc_type_t {
NRF_BLE_OTS_C_OACP_PROC_CREATE = 0x01,
NRF_BLE_OTS_C_OACP_PROC_DELETE = 0x02,
NRF_BLE_OTS_C_OACP_PROC_CALC_CHKSUM = 0x03,
NRF_BLE_OTS_C_OACP_PROC_EXECUTE = 0x04,
NRF_BLE_OTS_C_OACP_PROC_READ = 0x05,
NRF_BLE_OTS_C_OACP_PROC_WRITE = 0x06,
NRF_BLE_OTS_C_OACP_PROC_ABORT = 0x07,
NRF_BLE_OTS_C_OACP_PROC_RESP = 0x60
} |
| Types of Object Action Control Point Procedures. More...
|
|
enum | ble_ots_c_oacp_res_code_t {
NRF_BLE_OTS_C_OACP_RES_SUCCESS = 0x01,
NRF_BLE_OTS_C_OACP_RES_OPCODE_NOT_SUP = 0x02,
NRF_BLE_OTS_C_OACP_RES_INV_PARAM = 0x03,
NRF_BLE_OTS_C_OACP_RES_INSUFF_RES = 0x04,
NRF_BLE_OTS_C_OACP_RES_INV_OBJ = 0x05,
NRF_BLE_OTS_C_OACP_RES_CHAN_UNAVAIL = 0x06,
NRF_BLE_OTS_C_OACP_RES_UNSUP_TYPE = 0x07,
NRF_BLE_OTS_C_OACP_RES_NOT_PERMITTED = 0x08,
NRF_BLE_OTS_C_OACP_RES_OBJ_LOCKED = 0x09,
NRF_BLE_OTS_C_OACP_RES_OPER_FAILED = 0x0A
} |
| Object Action Control Point return codes. More...
|
|
enum | nrf_ble_ots_c_evt_type_t {
NRF_BLE_OTS_C_EVT_DISCOVERY_FAILED,
NRF_BLE_OTS_C_EVT_DISCOVERY_COMPLETE,
NRF_BLE_OTS_C_EVT_DISCONN_COMPLETE,
NRF_BLE_OTS_C_EVT_FEATURE_READ_RESP,
NRF_BLE_OTS_C_EVT_OACP_RESP,
NRF_BLE_OTS_C_EVT_OBJ_READ,
NRF_BLE_OTS_C_EVT_CHANNEL_RELEASED,
NRF_BLE_OTS_C_EVT_SIZE_READ_RESP
} |
| Type of the Object Transfer Service client event. More...
|
|
Object Transfer Service client module.
This is the main module of the Object Transfer Service (OTS) client.
#define NRF_BLE_OTS_C_DEF |
( |
|
_name | ) |
|
Macro for defining a ble_ots instance.
- Parameters
-
_name | Name of the instance. |
Types of Object Action Control Point Procedures.
Enumerator |
---|
NRF_BLE_OTS_C_OACP_PROC_CREATE |
Create object.
|
NRF_BLE_OTS_C_OACP_PROC_DELETE |
Delete object.
|
NRF_BLE_OTS_C_OACP_PROC_CALC_CHKSUM |
Calculate Checksum.
|
NRF_BLE_OTS_C_OACP_PROC_EXECUTE |
Execute Object.
|
NRF_BLE_OTS_C_OACP_PROC_READ |
Read object.
|
NRF_BLE_OTS_C_OACP_PROC_WRITE |
Write object.
|
NRF_BLE_OTS_C_OACP_PROC_ABORT |
Abort object.
|
NRF_BLE_OTS_C_OACP_PROC_RESP |
Procedure response.
|
Object Action Control Point return codes.
Enumerator |
---|
NRF_BLE_OTS_C_OACP_RES_SUCCESS |
Success.
|
NRF_BLE_OTS_C_OACP_RES_OPCODE_NOT_SUP |
Not supported.
|
NRF_BLE_OTS_C_OACP_RES_INV_PARAM |
Invalid parameter.
|
NRF_BLE_OTS_C_OACP_RES_INSUFF_RES |
Insufficient resources.
|
NRF_BLE_OTS_C_OACP_RES_INV_OBJ |
Invalid object.
|
NRF_BLE_OTS_C_OACP_RES_CHAN_UNAVAIL |
Channel unavailable.
|
NRF_BLE_OTS_C_OACP_RES_UNSUP_TYPE |
Unsupported procedure.
|
NRF_BLE_OTS_C_OACP_RES_NOT_PERMITTED |
Procedure not permitted.
|
NRF_BLE_OTS_C_OACP_RES_OBJ_LOCKED |
Object locked.
|
NRF_BLE_OTS_C_OACP_RES_OPER_FAILED |
Operation Failed.
|
Type of the Object Transfer Service client event.
Enumerator |
---|
NRF_BLE_OTS_C_EVT_DISCOVERY_FAILED |
Event indicating that the Object Transfer Service has not been found on the peer.
|
NRF_BLE_OTS_C_EVT_DISCOVERY_COMPLETE |
Event indicating that the Object Transfer Service is present on the peer device.
|
NRF_BLE_OTS_C_EVT_DISCONN_COMPLETE |
Event indicating that the Object Transfer Service client module has finished processing the BLE_GAP_EVT_DISCONNECTED event. The event can be used by the application to do clean up related to the Object Transfer Service client.
|
NRF_BLE_OTS_C_EVT_FEATURE_READ_RESP |
Event indicating that the feature characteristic was read, The available features of the peer will be provided in the event.
|
NRF_BLE_OTS_C_EVT_OACP_RESP |
Event indicating that a response was received (result of a write to the OACP).
|
NRF_BLE_OTS_C_EVT_OBJ_READ |
Event indicating that the Object Transfer Service client finished reading object from the peer.
|
NRF_BLE_OTS_C_EVT_CHANNEL_RELEASED |
Event indicating that the L2CAP Connection Oriented Channel has been disconnected.
|
NRF_BLE_OTS_C_EVT_SIZE_READ_RESP |
Event indicating that the object size characteristic was read.
|
Function for reading the features characteristic (BLE_UUID_OTS_FEATURES) on the server.
- Parameters
-
[in,out] | p_ots_c | Pointer to Object Transfer client structure. |
- Return values
-
NRF_SUCCESS | Operation success. |
- Returns
- If functions from other modules return errors to this function, the SoftDevice Global Error Codes are propagated.
Function for assigning handles to a Object Transfer Service client instance.
Call this function when a link has been established with a peer to associate this link to an instance of the module. This makes it possible to handle several link and associate each link to a particular instance of the Object Transfer Service client module. The connection handle and attribute handles will be provided from the discovery event NRF_BLE_OTS_C_EVT_DISCOVERY_COMPLETE.
- Parameters
-
[in,out] | p_ots_c | Pointer to the Object Transfer Service client structure instance to associate with the handles. |
[in] | conn_handle | Connection handle to be associated with the given Object Transfer Service client Instance. |
[in] | p_peer_handles | Attribute handles on the Object Transfer Service server that you want this Object Transfer Service client to interact with. |
- Return values
-
NRF_SUCCESS | If the connection handle was successfully stored in the Object Transfer Service instance. |
NRF_ERROR_NULL | If any of the input parameters are NULL. |
Function for initializing the Object Transfer client module.
- Parameters
-
[in,out] | p_ots_c | Pointer to the Object Transfer Service client structure instance. |
[in] | p_ots_c_init | Init parameters contraining the event handler that is called by the Object Transfer client module when any related event occurs. |
- Return values
-
NRF_SUCCESS | If the service was initialized successfully. |
NRF_ERROR_NULL | If any of the input parameters are NULL. |
- Returns
- If functions from other modules return errors to this function, the SoftDevice Global Error Codes are propagated.
Function for reading the Object Size characteristic (BLE_UUID_OTS_FEATURES) on the server.
- Parameters
-
[in,out] | p_ots_c | Pointer to Object Transfer client structure. |
- Return values
-
NRF_SUCCESS | Operation success. |
- Returns
- NRF_ERROR_INVALID_STATE if the Object Size characteristic has not been discovered. If functions from other modules return errors to this function, the SoftDevice Global Error Codes are propagated.
void nrf_ble_ots_c_on_ble_evt |
( |
const ble_evt_t *const |
p_ble_evt, |
|
|
void * |
p_context |
|
) |
| |
Function for handling the Application's BLE Stack events.
- Parameters
-
[in] | p_ble_evt | Pointer to the BLE event received. |
[in,out] | p_context | Pointer to the Object Transfer Service client structure instance. |
Function for handling events from the database discovery module.
This function will handle an event from the database discovery module, and determine if it relates to the discovery of Object Transfer Service at the peer. If so, it will call the application's event handler indicating that Object Transfer Service has been discovered at the peer.
- Parameters
-
[in,out] | p_ots_c | Pointer to the Object Transfer Service client structure instance. |
[in] | p_evt | Pointer to the event received from the database discovery module. |