Android SDK Developer Guide
The ZentriOS BLE Android SDK is a set of Java libraries.
For detailed API documentation, see Java API.
The following provides an overview of each library.
zentri_ble
zentri_ble
handles the low level details of the BLE interface on Android. The zentri_ble
library is one part of the Zentri BLE Android library set.
This library is designed to work with zentri_ble_command
and/or zentri_ble_ota
to
communicate with, control and update the firmware of Zentri BLE devices.
zentri_ble handles the following:
- Queueing BLE operations
- Connections and disconnections
- Service discovery (searches for characteristics, not a particular service UUID)
- Reading and writing characteristics
- Sending and receiving data (ASCII and binary)
There are demo applications available to show how these libraries should be used to build your application. Contact Zentri at www.zentri.com for the source to these applications.
To use the library, typically the application should not access it directly. Instead it should
use the zentri_ble_ota
and zentri_ble_command
libraries that depend on zentri_ble
.
To use this library standalone, the application must provide a callback object that implements the BLECallbacks interface. All results and events are communicated to an application through these callbacks.
zentri_ble_command
zentri_ble_command
allows an application to execute ZentriOS BLE commands remotely.
Note: This library is designed to work with zentri_ble
to manage the low level BLE
operations.
There are demo applications available to show how these libraries should be used to build your application. Contact Zentri at www.zentri.com for the source to these applications.
zentri_ble_command handles the following:
- Running commands on a remote ZentriOS BLE device (over BLE) and returning results
- Sending and receiving data in stream mode
- Changing ZentriOS BLE modes remotely
To use this library, the application must provide a callback object that implements the BLECallbacks interface. All results and events are communicated to an application through these callbacks.
zentri_ble_ota
zentri_ble_ota
allows an application to perform an Over The Air(OTA) firmware update of
Zentri BLE devices. The library is one part of the Zentri BLE Android library set.
The library checks the remote Zentri BLE OTA server for new releases. The server can be checked for a custom firmware release if the filename is provided.
Note: This library is designed to work with zentri_ble
to manage the low level BLE
operations.
There are demo applications available to show how these libraries should be used to build your application. Contact Zentri at www.zentri.com for the source to these applications.
zentri_ble_ota
handles the following:
- Checking for new updates
- Standard Zentri BLE and custom images (contact Zentri at www.zentri.com for custom images)
- Uploading firmware images to Zentri BLE devices
- Updating from legacy firmware images
- Downgrading to legacy versions from current images
To use this library, the application must provide a callback object that implements the OTACallbacks interface. All results and events are communicated to an application through these callbacks.