no.nordicsemi.android.dfu.scanner

Interface BootloaderScanner

All Known Implementing Classes:

BootloaderScannerJB, BootloaderScannerLollipop

public interface BootloaderScanner

The DFU Bootloader may advertise with the same address as an application (in case of the buttonless update) or one incremented by 1 (in case of jumping to the DFU mode with a button, or after flashing the new Soft Device (flashing new SD removes the old application)).

The DFU service always connects to the address given as a parameter. However, when flashing SD+BL+App it will first send the SD+BL as part one followed by the App in the second connection. As the service does not know which address was used in the first connection (normal, when buttonless update, or +1 when with-button update) we have to scan for the advertising device after SD+BL part is completed.

Field Summary

Fields

Modifier and Type	Field and Description
static int	ADDRESS_DIFF The bootloader may advertise with the same address or one with the last byte incremented by this value.
static long	TIMEOUT After the buttonless jump from the application mode to the bootloader mode the service will wait this long for the advertising bootloader (in milliseconds).

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	searchFor(java.lang.String deviceAddress) Searches for the advertising bootloader.

Field Detail

TIMEOUT

static final long TIMEOUT

After the buttonless jump from the application mode to the bootloader mode the service will wait this long for the advertising bootloader (in milliseconds).

See Also:

Constant Field Values

ADDRESS_DIFF

static final int ADDRESS_DIFF

The bootloader may advertise with the same address or one with the last byte incremented by this value. F.e. 00:11:22:33:44:55 -> 00:11:22:33:44:56. FF changes to 00.

See Also:

Constant Field Values

Method Detail

searchFor

java.lang.String searchFor(java.lang.String deviceAddress)

Searches for the advertising bootloader. The bootloader may advertise with the same device address or one with the last byte incremented by 1. This method is a blocking one and ends when such device is found. There are two implementations of this interface - one for Androids 4.3 and 4.4.x and one for the Android 5+ devices.

Parameters:

deviceAddress - the application device address

Returns:

the address of the advertising DFU bootloader. If may be the same as the application address or one with the last byte incremented by 1 (AA:BB:CC:DD:EE:45/FF -> AA:BB:CC:DD:EE:46/00).