Skip to content

v1.0.0 - Initial Release

Choose a tag to compare

View all tags
@Phil-Barker Phil-Barker released this 16 Oct 18:40
Immutable release. Only release title and notes can be modified.
v1.0.0
54619cc

Bosch eBike Flow Integration v1.0.0

First official release of the Bosch eBike Flow integration for Home Assistant! 🚴‍♂️⚡

⚠️ Requirements

Before installing, please note:

  • 🔌 ConnectModule hardware required (~€100-150, sold separately)
  • 💳 Flow+ subscription required (~€30-50/year)
  • 📱 Bosch eBike Flow app (Gen 4 systems only)
  • ❌ NOT compatible with older Bosch eBike Connect app (Gen 3)

Features

  • 📊 Battery Monitoring - Track level, capacity, and remaining energy
  • ⚡ Charging Status - Monitor charging progress in real-time
  • 🔋 Smart Charging - Create automations to stop at 80% for battery health
  • 📈 Statistics - Charge cycles, total distance, lifetime energy
  • 🌍 Range Estimates - Reachable range per riding mode
  • 🔐 Secure OAuth2 - Authenticated with Bosch eBike Flow
  • 🚲 Multi-bike Support - Monitor multiple eBikes

Installation

Via HACS (Custom Repository)

  1. Open HACS → Integrations
  2. Click ⋮ menu → Custom repositories
  3. Add: https://github.com/Phil-Barker/hass-bosch-ebike
  4. Category: Integration
  5. Install "Bosch eBike Flow"
  6. Restart Home Assistant
  7. Add integration via Settings → Devices & Services

Documentation

What's Included

Sensors (Enabled by Default)

  • Battery Level (%)
  • Battery Remaining Energy (Wh)
  • Battery Capacity (Wh)
  • Battery Charging (on/off)
  • Total Distance
  • Charge Cycles
  • Lifetime Energy Delivered

Sensors (Disabled by Default)

  • Reachable Range (only when bike online)
  • Charger Connected (limited reliability - see docs)
  • Lock Status (experimental)
  • Alarm Status (experimental)

Known Limitations

  • ConnectModule only updates when bike is charging/powered on/alarm active
  • Charger Connected sensor can't reliably detect unplugging (bike goes offline)
  • Lock/Alarm sensors disabled by default pending investigation

See SENSOR_RELIABILITY.md for details.

Example Automations

Stop charging at 80% for battery health:

automation:
  - alias: "eBike: Stop charging at 80%"
    trigger:
      - platform: numeric_state
        entity_id: sensor.your_bike_battery_level
        above: 80
    action:
      - service: switch.turn_off
        target:
          entity_id: switch.bike_charger_plug

More examples in the README!

Support

Disclaimer

This is an unofficial integration and is not affiliated with or endorsed by Bosch eBike Systems.

Full Changelog: https://github.com/Phil-Barker/hass-bosch-ebike/commits/v1.0.0

Assets 3
Loading