This Android app collects data from your Bosch eBike by listening to the Bluetooth traffic between the LED remote and the Flow app, then pushes the values to an MQTT broker. It acts as a bridge between your Bosch Gen4 Smart System eBike and your smart home system (e.g., Home Assistant).
The app separates data for different bikes and batteries. If you use multiple eBikes or battery packs, the app will automatically detect and display the data for the currently connected hardware.
The app features a simple dashboard to display current sensor values.
The eBikeMonitor listens to the BLE traffic between the eBike and the official Bosch Flow app. Since this requires a bonded BLE connection, eBikeMonitor must be installed on the same Android device as the Bosch Flow app.
For decoding see BLE TOPICS.
- Pairing: Ensure your eBike is paired (bonded) with your Android device via the system Bluetooth settings.
- Permissions: The app requires Usage Access permission to detect if the Bosch Flow app is running. The dashboard will display a warning and prompt you to grant this if it is missing. Also, ensure Bluetooth is enabled.
- Settings Configuration:
- Open the Settings screen (gear icon).
- eBike Name: Enter a name for your eBike. This name will be used for the MQTT device in Home Assistant.
- Select eBike: Choose your paired eBike from the Bluetooth devices list.
- MQTT Setup: Enter your MQTT broker URI (e.g.,
tcp://192.168.1.10:1883), username, and password. - Preferences: Toggle auto-connect for BLE and MQTT, and auto-launch for the Flow app as desired.
- Initial Connection: For the first-time setup, ensure the Flow app is not connected to the eBike before eBikeMonitor establishes its BLE connection. This allows the app to correctly capture the assist mode names from the system.
To detect if the Bosch Flow app is running, this app requires the Usage Access (PACKAGE_USAGE_STATS) permission. Additionally, it uses the Query All Packages (QUERY_ALL_PACKAGES) permission to locate the Flow app on your device. These permissions are used exclusively for local state detection and automation (auto-launching/stopping). No personal browsing data or package lists are transmitted or collected.
As soon as BLE connects to the eBike, the latest active data is updated on the screen. Assist mode-specific distance and energy data require internal decoding. You may need to ride for a short distance in each mode before valid data can be transmitted via MQTT.
To ensure reliable data collection, follow this precise sequence:
- Turn on your eBike.
- Launch the eBikeMonitor app.
- If auto-connect is enabled in settings, eBikeMonitor will automatically connect to the eBike (BLE) and start the MQTT connection. The corresponding action buttons will turn green.
- If auto-launch is enabled, eBikeMonitor will automatically start the Bosch Flow app once the BLE connection is established. Otherwise, tap the FLOW action button to start it.
- Keep the Flow app open until real-time data appears on the eBikeMonitor dashboard. This typically takes about 2 seconds.
- Automatic MQTT Reconnection: You can launch the app and start your ride even if you are away from home. If auto-connect is enabled, the app will automatically establish the MQTT connection as soon as your phone reaches your local network (or becomes able to reach your broker) and will immediately transmit the latest sensor data.
- Action Buttons: The top row shows the status of MQTT, BLE, and the FLOW app. Green means connected/running, red/gray means disconnected/stopped. You can tap these to manually toggle connections or launch/stop the Flow app.
- Charging: To monitor charging, follow the startup sequence above, then connect the charger to the bike. The battery must be charged while mounted in the eBike, and the smartphone must maintain a BLE connection to the eBike throughout the process.
- Versions: The lower-left corner of the UI displays the eBikeMonitor version and the LED remote software version.
Charging curve example:
The eBikeMonitor app supports MQTT Discovery for Home Assistant, meaning you do not need to manually configure sensors.
- Ensure the MQTT connection is active (the MQTT button on the dashboard is green).
- Go to the Settings screen.
- Tap the "Send Discovery to Home Assistant" button.
- Your eBike will automatically appear as a new Device in Home Assistant, with all its sensors (Speed, Battery, Assist Mode, Power, etc.) ready to use.
- The mounted battery will be automatically discovered and shown as a new device in Home Assistant. You can rename these devices or update their Entity IDs to match your preferred naming convention.
For detailed MQTT topics see MQTT TOPICS.
BLE decoding info is based on: https://github.com/RobbyPee/Bosch-Smart-System-Ebike-Garmin-Android
This project is licensed under the GNU GPL v3.0 - see the [LICENSE] file for details.