BGXpressService

Starts this service to perform action Start Scan.

If the service is already performing a task this action will be queued.

See also

IntentService

Starts this service to perform action Stop Scan.

If the service is already performing a task this action will be queued.

See also

IntentService

startActionBGXConnect

Attempt to connect to the specified device.

Parameters

context
deviceAddress	the Bluetooth address of the device to which you wish to connect.

startActionBGXCancelConnect

Attempt to cancel an in-progress connection operation.

Parameters

context

clearCancelFlag

Call this before initiating a connection in order to clear the connection cancel flag.

To Do: maybe we can clear this a better way (such as when the user calls connect?)

getBGXDeviceInfo

Starts an operation to get the device info which is the part id and the device uuid.

Parameters

context

The BGXpressService receives this intent and it begins scanning.

There is no need to directly send this. You can call startActionStartScan() instead.

The BGXpressService receives this intent and it stops scanning.

There is no need to directly send this. You can call startActionStopScan() instead.

This is sent to cause the BGXpressService to connect to a BGX.

Extras:

DeviceAddress - String - The bluetooth address of the device to which to connect.

There is no need to directly send this. You can call startActionBGXConnect() using the device address instead.

This is sent to cause the BGXpressService to disconnect from a connected BGX.

TODO: Add a static method for this to send the intent.

Attempt to cancel an in-progress connection operation.

There is no need to call this directly. Use startActionBGXCancelConnect() instead.

Reads the bus mode.

When the read operation completes, a broadcast intent will be sent with the action BGX_MODE_STATE_CHANGE.

Writes the bus mode.

The service will not send a notification to indicate that it succeeded at this time.

Extras: busmode - int - one of the values from BusMode: STREAM_MODE, LOCAL_COMMAND_MODE, or REMOTE_COMMAND_MODE.

Writes data to the BGX.

value - String - the data to be written.

This request causes the BGXpressService to read the device uuid and determine the part id.

The result is sent out as a broadcast intent BGX_DEVICE_INFO with the following extras: bgx-device-uuid - A string containing the device uuid. bgx-part-id - An enum value from BGXPartID.

Gets the firmware versions available from DMS.

Extras: bgx-part-id - BGXPartID - one of the following values: BGX13S or BGX13P

This request causes the specified DMS version to be loaded onto the phone.

When finished, the broadcast intent DMS_VERSION_LOADED is sent.

Extras: bgx-part-id - BGXPartID - one of the following values: BGX13S or BGX13P dms-version - String - the DMS version number you want to retrieve.

TO DO: Handle fail cases (e.g. specify a version number that doesn't exist as right now the calling app gets no reply.)

image_path - String - path to the image file.

You could get this from a DMS_VERSION_LOADED broadcast intent.

Attempts to cancel an OTA operation in progress.

If the cancellation is successful you will get an OTA_STATUS_MESSAGE where the ota_status is UserCanceled

Extras: bgx-connection-status - a value from the BGX_CONNECTION_STATUS enum which is the new status.

device - a BluetoothDevice (not present for DISCONNECTED).

Broadcast Intent which indicates a state change in the bgxss mode.

Extras: busmode - int - one of the values from BusMode: STREAM_MODE, LOCAL_COMMAND_MODE, or REMOTE_COMMAND_MODE.

Extras: data - String - contains the data that was received from the BGX.

This change is sent when scanning begins or ends.

It has one extra.

isscanning - boolean - indicates whether scanning is happening.

This is sent as a broadcast intent when a BGX device is discovered during scanning.

Notification that a specific version has been loaded and is attached to the intent as "file_path".

file_path - string of the path to the file containing the version.

This contains the following extras: ota_failed : boolean.

True means it failed. Use false as the default. ota_status : OTA_Status enum. Tells the current status of the ota. Use Invalid as the default. bytes_sent : int - number of bytes transfered in the firmware image. Not always present.

This is sent when connection state becomes connected for the device.

param: bgx-device-uuid - a String param: bgx-part-id - a BGXPartID

Broadcast intent sent when the list of versions is retrieved from DMS.

Extras: versions-available-json - String - Contains JSON response from DMS with the list of firmware versions available.