no.nordicsemi.android.dfu

Interface DfuProgressListener

All Known Implementing Classes:

DfuProgressListenerAdapter

public interface DfuProgressListener

Listener for status, progress and error events. This listener should be used instead of creating the BroadcastReceiver on your own.

See Also:

DfuServiceListenerHelper

Method Summary

Modifier and Type	Method and Description
void	onDeviceConnected(String deviceAddress) Method called when the service has successfully connected, discovered services and found DFU service on the DFU target.
void	onDeviceConnecting(String deviceAddress) Method called when the DFU service started connecting with the DFU target.
void	onDeviceDisconnected(String deviceAddress) Method called when the service disconnected from the device.
void	onDeviceDisconnecting(String deviceAddress) Method called when the service started to disconnect from the target device.
void	onDfuAborted(String deviceAddress) Method called when the DFU process has been aborted.
void	onDfuCompleted(String deviceAddress) Method called when the DFU process succeeded.
void	onDfuProcessStarted(String deviceAddress) Method called when the DFU process was started and bytes about to be sent.
void	onDfuProcessStarting(String deviceAddress) Method called when the DFU process is starting.
void	onEnablingDfuMode(String deviceAddress) Method called when the service discovered that the DFU target is in the application mode and must be switched to DFU mode.
void	onError(String deviceAddress, int error, int errorType, String message) Method called when an error occur.
void	onFirmwareValidating(String deviceAddress) Method called when the new firmware is being validated on the target device.
void	onProgressChanged(String deviceAddress, int percent, float speed, float avgSpeed, int currentPart, int partsTotal) Method called during uploading the firmware.

Method Detail

onDeviceConnecting

void onDeviceConnecting(String deviceAddress)

Method called when the DFU service started connecting with the DFU target.

Parameters:

deviceAddress - the target device address.

onDeviceConnected

void onDeviceConnected(String deviceAddress)

Method called when the service has successfully connected, discovered services and found DFU service on the DFU target.

Parameters:

deviceAddress - the target device address.

onDfuProcessStarting

void onDfuProcessStarting(String deviceAddress)

Method called when the DFU process is starting. This includes reading the DFU Version characteristic, sending DFU_START command as well as the Init packet, if set.

Parameters:

deviceAddress - the target device address.

onDfuProcessStarted

void onDfuProcessStarted(String deviceAddress)

Method called when the DFU process was started and bytes about to be sent.

Parameters:

deviceAddress - the target device address

onEnablingDfuMode

void onEnablingDfuMode(String deviceAddress)

Method called when the service discovered that the DFU target is in the application mode and must be switched to DFU mode. The switch command will be sent and the DFU process should start again. There will be no onDeviceDisconnected(String) event following this call.

Parameters:

deviceAddress - the target device address.

onProgressChanged

void onProgressChanged(String deviceAddress,
                       int percent,
                       float speed,
                       float avgSpeed,
                       int currentPart,
                       int partsTotal)

Method called during uploading the firmware. It will not be called twice with the same value of percent, however, in case of small firmware files, some values may be omitted.

Parameters:

deviceAddress - the target device address.

percent - the current status of upload (0-99).

speed - the current speed in bytes per millisecond.

avgSpeed - the average speed in bytes per millisecond

currentPart - the number pf part being sent. In case the ZIP file contains a Soft Device and/or a Bootloader together with the application the SD+BL are sent as part 1, then the service starts again and send the application as part 2.

partsTotal - total number of parts.

onFirmwareValidating

void onFirmwareValidating(String deviceAddress)

Method called when the new firmware is being validated on the target device.

Parameters:

deviceAddress - the target device address.

onDeviceDisconnecting

void onDeviceDisconnecting(String deviceAddress)

Method called when the service started to disconnect from the target device.

Parameters:

deviceAddress - the target device address.

onDeviceDisconnected

void onDeviceDisconnected(String deviceAddress)

Method called when the service disconnected from the device. The device has been reset.

Parameters:

deviceAddress - the target device address.

onDfuCompleted

void onDfuCompleted(String deviceAddress)

Method called when the DFU process succeeded.

Parameters:

deviceAddress - the target device address.

onDfuAborted

void onDfuAborted(String deviceAddress)

Method called when the DFU process has been aborted.

Parameters:

deviceAddress - the target device address.

onError

void onError(String deviceAddress,
             int error,
             int errorType,
             String message)

Method called when an error occur.

Parameters:

deviceAddress - the target device address.

error - error number.

errorType - the error type, one of DfuBaseService.ERROR_TYPE_COMMUNICATION_STATE, DfuBaseService.ERROR_TYPE_COMMUNICATION, DfuBaseService.ERROR_TYPE_DFU_REMOTE, DfuBaseService.ERROR_TYPE_OTHER.

message - the error message.