BGXpressService

Starts this service to perform action Start Scan.

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

Parameters

context

Interface to global information about an Android application environment.

See also

IntentService

Starts this service to perform action Stop Scan.

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

Parameters

context

Interface to global information about an Android application environment.

See also

IntentService

startActionBGXConnect

Attempt to connect to the specified device. The process of the connection can be tracked by receiving a series of BGX_CONNECTION_STATUS_CHANGE intents.

Parameters

context	Interface to global information about an Android application environment.
deviceAddress	the Bluetooth address of the device to which to connect.

startActionBGXCancelConnect

Attempt to cancel an in-progress connection operation.

Parameters

context	Interface to global information about an Android application environment.
deviceAddress	The Bluetooth address of the device to which to cancel the connection in progress.

startActionBGXDisconnect

Disconnect a BGX Device.

Parameters

context	Interface to global information about an Android application environment.
deviceAddress	the Bluetooth address of the device to which you wish to connect.

getBGXDeviceInfo

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

Parameters

context	Interface to global information about an Android application environment.
deviceAddress	The device to which the operation pertains.

getBGXBootloaderVersion

Gets the BGXBootloader version if possible to do so. This value is available only after the device is connected.

Parameters

deviceAddress

Address of the device to retrieve the bootloader version

Returns

-1 on error, or the bootloader version (a positive integer).

getFirmwareRevision

Parameters

deviceAddress

Address of the device to retrieve the firmware revision

Returns

String containing the firmware version if available, otherwise NULL.

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.

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. DeviceAddress - String the address of the device on which to set the bus mode. password - String - If supplied, this value will be used as the password for REMOTE_COMMAND_MODE

Writes data to the BGX.

value - String - the data to be written.

Writes byte data to the BGX.

value - byte [] - the byte array to be written.

Gets the firmware versions available from DMS.

Either bgx-part-id or bgx-part-identifier (preferred) must be specified. bgx-part-identifier is used if both are specified.

Extras: bgx-part-id - An enum value from BGXPartID . Preserved for compatibility. bgx-part-identifier - an 8 character string identifying the type of BGX (preferred).

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

When finished, the broadcast intent DMS_VERSION_LOADED is sent. Either bgx-part-id or bgx-part-identifier (preferred) must be specified. bgx-part-identifier is used if both are specified.

Extras: bgx-part-id - BGXPartID - Optional one of the following values: BGX13S or BGX13P (Preserved for compatibility) bgx-part-identifier - String - an 8 character string identifying the kind of BGX (Preferred) dms-version - String - the DMS version number you want to retrieve.

Extras: image_path - String - path to the image file.

You could get this from a DMS_VERSION_LOADED broadcast intent. DeviceAddress - String - The address of the device to update. password - String - the password to use for the OTA update if one is set.

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). DeviceAddress - address of the BGX.

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.

This intent is sent when a password is required to change the bus mode to remote command mode.

This contains the following extras: DeviceAddress : the address of the device.

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

DeviceAddress - string - the address of the BGX that received data.

This change is sent when scanning begins or ends.

It has one extra.

isscanning - boolean - indicates whether scanning is happening.

BGX_MTU_CHANGE.

Parameters

deviceAddress	device address
status	operation status
mtu	the new mtu size

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

Parameters

DeviceRecord

a HashMap containing information about the device that was discovered. The HashMap contains the following keys: name - Device name uuid - Device address rssi - the device's current RSSI.

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.

Notification message that is sent when invalid GATT handles are detected.

Invalid GATT handles result in operations failing to work correctly. Invalid GATT handles occur as a result of a firmware update that adds or removes Bluetooth characteristics and/or services to the BGX when you have an existing bond on your Android device. To fix this condition, you would need to go to the Bluetooth Settings on your Android device, select the BGX, and choose "Forget". The next time you connect, the bond will be reestablished. This broadcast intent will be sent when the BGXpressService is unable to read a valid part id or when it is unable to read a valid firmware version. Your app should respond to this broadcast intent by showing the user a message explaining the situation and telling them how to recover from it.

This broadcast intent contains the following extras: DeviceAddress: String - The address of the BGX device. DeviceName: String - The name of the BGX device.

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

param: bgx-device-uuid - a String param: bgx-part-id - a BGXPartID param: bgx-part-identifier - an 8 character String that identifies the type of BGX.

This is sent when the BGXConnectionState moves from Connecting to Disconnecting due to an error.

param: status - a GATT Status value as returned by the Android GATT API.

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.