nRF51 SDK - S110 SoftDevice
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
Device Firmware Update Service

Device Firmware Update Service. More...

Data Structures

struct  ble_dfu_pkt_write_t
 DFU Packet structure. More...
 
struct  ble_pkt_rcpt_notif_req_t
 Packet receipt notification request structure. More...
 
struct  ble_dfu_evt_t
 DFU Event structure. More...
 
struct  ble_dfu_s
 DFU service structure. More...
 
struct  ble_dfu_init_t
 DFU service initialization structure. More...
 

Macros

#define BLE_DFU_SERVICE_UUID   0x1530
 
#define BLE_DFU_PKT_CHAR_UUID   0x1532
 
#define BLE_DFU_CTRL_PT_UUID   0x1531
 
#define BLE_DFU_STATUS_REP_UUID   0x1533
 
#define BLE_DFU_REV_CHAR_UUID   0x1534
 

Typedefs

typedef struct ble_dfu_s ble_dfu_t
 DFU service structure. More...
 
typedef void(* ble_dfu_evt_handler_t )(ble_dfu_t *p_dfu, ble_dfu_evt_t *p_evt)
 DFU Service event handler type.
 

Enumerations

enum  ble_dfu_evt_type_t {
  BLE_DFU_START,
  BLE_DFU_RECEIVE_INIT_DATA,
  BLE_DFU_RECEIVE_APP_DATA,
  BLE_DFU_VALIDATE,
  BLE_DFU_ACTIVATE_N_RESET,
  BLE_DFU_SYS_RESET,
  BLE_DFU_PKT_RCPT_NOTIF_ENABLED,
  BLE_DFU_PKT_RCPT_NOTIF_DISABLED,
  BLE_DFU_PACKET_WRITE,
  BLE_DFU_BYTES_RECEIVED_SEND
}
 DFU Event type. More...
 
enum  ble_dfu_procedure_t {
  BLE_DFU_START_PROCEDURE = 1,
  BLE_DFU_INIT_PROCEDURE = 2,
  BLE_DFU_RECEIVE_APP_PROCEDURE = 3,
  BLE_DFU_VALIDATE_PROCEDURE = 4,
  BLE_DFU_PKT_RCPT_REQ_PROCEDURE = 8
}
 DFU Procedure type. More...
 
enum  ble_dfu_resp_val_t {
  BLE_DFU_RESP_VAL_SUCCESS = 1,
  BLE_DFU_RESP_VAL_INVALID_STATE,
  BLE_DFU_RESP_VAL_NOT_SUPPORTED,
  BLE_DFU_RESP_VAL_DATA_SIZE,
  BLE_DFU_RESP_VAL_CRC_ERROR,
  BLE_DFU_RESP_VAL_OPER_FAILED
}
 DFU Response value type. More...
 

Functions

void ble_dfu_on_ble_evt (ble_dfu_t *p_dfu, ble_evt_t *p_ble_evt)
 Function for handling a BLE event. More...
 
uint32_t ble_dfu_init (ble_dfu_t *p_dfu, ble_dfu_init_t *p_dfu_init)
 Function for initializing the DFU service. More...
 
uint32_t ble_dfu_response_send (ble_dfu_t *p_dfu, ble_dfu_procedure_t dfu_proc, ble_dfu_resp_val_t resp_val)
 Function for sending response to a control point command. More...
 
uint32_t ble_dfu_bytes_rcvd_report (ble_dfu_t *p_dfu, uint32_t num_of_firmware_bytes_rcvd)
 Function for notifying the peer about the number of bytes of firmware data received. More...
 
uint32_t ble_dfu_pkts_rcpt_notify (ble_dfu_t *p_dfu, uint32_t num_of_firmware_bytes_rcvd)
 Function for sending Packet Receipt Notification to the peer. More...
 

Detailed Description

Device Firmware Update Service.

The Device Firmware Update (DFU) service is a GATT based service that can be used for performing firmware updates over BLE. Note that this implementation uses vendor specific UUIDs for service and characteristics and is intended to demonstrate the firmware updates over BLE. Refer Device Firmware Update BLE Service and Device Firmware Update Profile for more information on the service and profile respectively.

Macro Definition Documentation

#define BLE_DFU_CTRL_PT_UUID   0x1531

The UUID of the DFU Control Point.

#define BLE_DFU_PKT_CHAR_UUID   0x1532

The UUID of the DFU Packet Characteristic.

#define BLE_DFU_REV_CHAR_UUID   0x1534

The UUID of the DFU Revision Characteristic.

#define BLE_DFU_SERVICE_UUID   0x1530

The UUID of the DFU Service.

#define BLE_DFU_STATUS_REP_UUID   0x1533

The UUID of the DFU Status Report Characteristic.

Typedef Documentation

typedef struct ble_dfu_s ble_dfu_t

DFU service structure.

This structure contains status information related to the service.

Enumeration Type Documentation

DFU Event type.

This enumeration contains the types of events that will be received from the DFU Service.

Enumerator
BLE_DFU_START 

The event indicating that the peer wants the application to prepare for a new firmware update.

BLE_DFU_RECEIVE_INIT_DATA 

The event indicating that the peer wants the application to prepare to receive init parameters.

BLE_DFU_RECEIVE_APP_DATA 

The event indicating that the peer wants the application to prepare to receive the new firmware image.

BLE_DFU_VALIDATE 

The event indicating that the peer wants the application to validate the newly received firmware image.

BLE_DFU_ACTIVATE_N_RESET 

The event indicating that the peer wants the application to undergo activate new firmware and restart with new valid application

BLE_DFU_SYS_RESET 

The event indicating that the peer wants the application to undergo a reset and start the currently valid application image.

BLE_DFU_PKT_RCPT_NOTIF_ENABLED 

The event indicating that the peer has enabled packet receipt notifications. It is the responsibility of the application to call ble_dfu_pkts_rcpt_notify each time the number of packets indicated by num_of_pkts field in ble_dfu_evt_t is received.

BLE_DFU_PKT_RCPT_NOTIF_DISABLED 

The event indicating that the peer has disabled the packet receipt notifications.

BLE_DFU_PACKET_WRITE 

The event indicating that the peer has written a value to the 'DFU Packet' characteristic. The data received from the peer will be present in the BLE_DFU_PACKET_WRITE element contained within ble_dfu_evt_t.

BLE_DFU_BYTES_RECEIVED_SEND 

The event indicating that the peer is requesting for the number of bytes of firmware data last received by the application. It is the responsibility of the application to call ble_dfu_pkts_rcpt_notify in response to this event.

DFU Procedure type.

This enumeration contains the types of DFU procedures.

Enumerator
BLE_DFU_START_PROCEDURE 

DFU Start procedure.

BLE_DFU_INIT_PROCEDURE 

DFU Initialization procedure.

BLE_DFU_RECEIVE_APP_PROCEDURE 

Firmware receiving procedure.

BLE_DFU_VALIDATE_PROCEDURE 

Firmware image validation procedure .

BLE_DFU_PKT_RCPT_REQ_PROCEDURE 

Packet receipt notification request procedure.

DFU Response value type.

Enumerator
BLE_DFU_RESP_VAL_SUCCESS 

Success.

BLE_DFU_RESP_VAL_INVALID_STATE 

Invalid state.

BLE_DFU_RESP_VAL_NOT_SUPPORTED 

Operation not supported.

BLE_DFU_RESP_VAL_DATA_SIZE 

Data size exceeds limit.

BLE_DFU_RESP_VAL_CRC_ERROR 

CRC Error.

BLE_DFU_RESP_VAL_OPER_FAILED 

Operation failed.

Function Documentation

uint32_t ble_dfu_bytes_rcvd_report ( ble_dfu_t p_dfu,
uint32_t  num_of_firmware_bytes_rcvd 
)

Function for notifying the peer about the number of bytes of firmware data received.

Parameters
[in]p_dfuPointer to the DFU service structure.
[in]num_of_firmware_bytes_rcvdNumber of bytes.
Returns
NRF_SUCCESS if the DFU Service has successfully requested the S110 SoftDevice to send the notification. Otherwise an error code. This function returns NRF_ERROR_INVALID_STATE if the device is not connected to a peer or if the DFU service is not initialized or if the notification of the DFU Status Report characteristic was not enabled by the peer. It returns NRF_ERROR_NULL if the pointer p_dfu is NULL.
uint32_t ble_dfu_init ( ble_dfu_t p_dfu,
ble_dfu_init_t p_dfu_init 
)

Function for initializing the DFU service.

Parameters
[out]p_dfuDevice Firmware Update service structure. This structure will have to be supplied by the application. It will be initialized by this function, and will later be used to identify the service instance.
[in]p_dfu_initInformation needed to initialize the service.
Returns
NRF_SUCCESS if the DFU service and its characteristics were successfully added to the S110 SoftDevice. Otherwise an error code. This function returns NRF_ERROR_NULL if the value of evt_handler in p_dfu_init structure provided is NULL or if the pointers supplied as input are NULL.
void ble_dfu_on_ble_evt ( ble_dfu_t p_dfu,
ble_evt_t p_ble_evt 
)

Function for handling a BLE event.

The DFU service expects the application to call this function each time an event is received from the S110 SoftDevice. This function processes the event, if it is relevant for the DFU service and calls the DFU event handler of the application if necessary.

Parameters
[in]p_dfuPointer to the DFU service structure.
[in]p_ble_evtPointer to the event received from S110 SoftDevice.
uint32_t ble_dfu_pkts_rcpt_notify ( ble_dfu_t p_dfu,
uint32_t  num_of_firmware_bytes_rcvd 
)

Function for sending Packet Receipt Notification to the peer.

        This function will encode the number of bytes received as input parameter into a
        notification of the control point characteristic and send it to the peer.
Parameters
[in]p_dfuPointer to the DFU service structure.
[in]num_of_firmware_bytes_rcvdNumber of bytes of firmware image received.
Returns
NRF_SUCCESS if the DFU Service has successfully requested the S110 SoftDevice to send the notification. Otherwise an error code. This function returns NRF_ERROR_INVALID_STATE if the device is not connected to a peer or if the DFU service is not initialized or if the notification of the DFU Status Report characteristic was not enabled by the peer. It returns NRF_ERROR_NULL if the pointer p_dfu is NULL.
uint32_t ble_dfu_response_send ( ble_dfu_t p_dfu,
ble_dfu_procedure_t  dfu_proc,
ble_dfu_resp_val_t  resp_val 
)

Function for sending response to a control point command.

This function will encode a DFU Control Point response using the given input parameters and will send a notification of the same to the peer.

Parameters
[in]p_dfuPointer to the DFU service structure.
[in]dfu_procProcedure for which this response is to be sent.
[in]resp_valResponse value.
Returns
NRF_SUCCESS if the DFU Service has successfully requested the S110 SoftDevice to send the notification. Otherwise an error code. This function returns NRF_ERROR_INVALID_STATE if the device is not connected to a peer or if the DFU service is not initialized or if the notification of the DFU Status Report characteristic was not enabled by the peer. It returns NRF_ERROR_NULL if the pointer p_dfu is NULL.