dariuszseweryn/RxAndroidBle
RxAndroidBle
RxAndroidBle is a reactive framework designed to simplify Bluetooth Low Energy interactions on Android. It functions as a wrapper for the system Bluetooth stack, converting low-level asynchronous callbacks into observable streams to manage device discovery, connection lifecycles, and data communication.
The library distinguishes itself by normalizing inconsistent vendor-specific Bluetooth behaviors into a predictable interface, ensuring reliable cross-device compatibility. It incorporates an internal operation queueing mechanism that serializes concurrent hardware requests, preventing command collisions and ensuring stable communication with peripherals. Furthermore, it automates resource management by disposing of connections and releasing system resources when subscriptions are cancelled, which prevents memory leaks and orphaned links.
The framework provides a comprehensive suite of tools for peripheral management, including utilities for reading, writing, and parsing characteristic data into usable application formats. It also includes built-in observability features that monitor connection states in real-time and validate system prerequisites, such as hardware adapter status and location services, before executing communication tasks. Internal logging capabilities are provided to assist in debugging connection failures and data transfer errors.
Features
- BLE Development Frameworks - Provides a framework for discovering, connecting to, and communicating with Bluetooth hardware peripherals through reactive event handling.
- Bluetooth Connectivity - Provides a framework for building Android applications that communicate with external hardware using reactive streams.
- Peripheral Device Managers - Provides reactive management of peripheral connections, handling lifecycle and resource cleanup for reliable hardware communication.
- Bluetooth Connectivity - Establishes and maintains stable links to external Bluetooth peripherals with automated resource cleanup and error recovery.
- GATT Operation Queues - Serializes concurrent GATT requests into a managed pipeline to prevent command collisions and ensure stable communication.
- Disposable Resource Management - Automatically disposes of hardware connections and releases system resources upon subscription cancellation to prevent memory leaks.
- Device Discovery - Discovers nearby low-energy peripherals using reactive streams with consistent detection behavior across Android versions.
- Characteristic Data Exchange - Facilitates reading, writing, and parsing characteristic data into usable application formats.
- Hardware Communication - Integrates asynchronous hardware interactions into applications by converting raw device signals into observable data streams.
- Hardware Abstraction Layers - Normalizes inconsistent vendor-specific Bluetooth behaviors into a predictable API surface for cross-device compatibility.
- Hardware Communication Libraries - Provides a toolkit for performing read, write, and notification operations on Bluetooth devices with lifecycle management.
- Cross-Version Android Support - Enables reliable peripheral discovery across diverse Android hardware and software versions through a unified interface.
- Asynchronous Operation Execution - Executes asynchronous read, write, and notification operations on connected devices using reactive patterns.
- Reactive Stream Lifecycles - Wraps low-level hardware callbacks into observable sequences to manage complex device communication lifecycles.
- Bluetooth State Streams - Interfaces with the system Bluetooth stack to expose hardware events through observable reactive streams.
- Device Connectivity Tracking - Monitors hardware link status through continuous event streams to keep application logic synchronized with the physical device state.
- Device State Monitors - Emits real-time updates for device link status changes to keep applications synchronized with hardware states.
