Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/syssi/esphome-basen-bms

ESPHome component to monitor a Basen Battery Management System via BLE
https://github.com/syssi/esphome-basen-bms

basen-bms bluetooth ee-bms esphome esphome-component hacktoberfest mabru-bms roamer-bms vip-bms

Last synced: 2 months ago
JSON representation

ESPHome component to monitor a Basen Battery Management System via BLE

Awesome Lists containing this project

README

        

# esphome-basen-bms

![GitHub actions](https://github.com/syssi/esphome-basen-bms/actions/workflows/ci.yaml/badge.svg)
![GitHub stars](https://img.shields.io/github/stars/syssi/esphome-basen-bms)
![GitHub forks](https://img.shields.io/github/forks/syssi/esphome-basen-bms)
![GitHub watchers](https://img.shields.io/github/watchers/syssi/esphome-basen-bms)
[!["Buy Me A Coffee"](https://img.shields.io/badge/buy%20me%20a%20coffee-donate-yellow.svg)](https://www.buymeacoffee.com/syssi)

ESPHome component to monitor a Basen Battery Management System (Basen-BMS) via BLE

The Basen BMS is probably a rebrand of the VIP-BMS, EE-BMS, Mabru-BMS or Roamer BMS.

Credits: Thanks to [@mager33](https://github.com/mager33) for heavily testing the early beta versions.

## Supported devices

* BASEN 24V 100Ah Bluetooth (BG-24100, reported by [@mager33](https://github.com/syssi/esphome-basen-bms/issues/5#issuecomment-1445179807))
* ROAMER 200SMART2 12V 200AH (200SMART2, reported by [@DrRob](https://github.com/syssi/esphome-basen-bms/issues/26))

## Untested devices

* BASEN 24V 200Ah Bluetooth (BG-24200)
* BASEN 24V 230Ah Bluetooth (BG-24230)

## Requirements

* [ESPHome 2024.6.0 or higher](https://github.com/esphome/esphome/releases).
* Generic ESP32 board

## Installation

You can install this component with [ESPHome external components feature](https://esphome.io/components/external_components.html) like this:
```yaml
external_components:
- source: github://syssi/esphome-basen-bms@main
```

or just use the `esp32-example.yaml` as proof of concept:

```bash
# Install esphome
pip3 install esphome

# Clone this external component
git clone https://github.com/syssi/esphome-basen-bms.git
cd esphome-basen-bms

# Create a secrets.yaml containing some setup specific secrets
cat > secrets.yaml <