Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

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

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

bluetooth esphome esphome-component hacktoberfest

Last synced: 2 months ago
JSON representation

ESPHome component to monitor a Tianpower Battery Management System via BLE

Host: GitHub
URL: https://github.com/syssi/esphome-tianpower-bms
Owner: syssi
License: apache-2.0
Created: 2023-06-03T13:38:53.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-10-22T09:07:48.000Z (2 months ago)
Last Synced: 2024-10-24T11:45:38.340Z (2 months ago)
Topics: bluetooth, esphome, esphome-component, hacktoberfest
Language: C++
Homepage:
Size: 393 KB
Stars: 7
Watchers: 2
Forks: 0
Open Issues: 3
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        # esphome-tianpower-bms

![GitHub actions](https://github.com/syssi/esphome-tianpower-bms/actions/workflows/ci.yaml/badge.svg)

![GitHub stars](https://img.shields.io/github/stars/syssi/esphome-tianpower-bms)

![GitHub forks](https://img.shields.io/github/forks/syssi/esphome-tianpower-bms)

![GitHub watchers](https://img.shields.io/github/watchers/syssi/esphome-tianpower-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 Tianpower Battery Management System via BLE

Credits: Thanks to [@xpinguinx](https://github.com/xpinguinx) for heavily testing the early beta versions and sponsoring the first release!

## Supported devices

* Tianpower TP-LT55 used in BASEN 48V 200Ah Bluetooth battery bank


  Probably advertised via BLE as `TP_123456`

* Tianpower TP-LT55AT used in BASEN 48V 280Ah/300Ah Bluetooth battery bank ([#17](https://github.com/syssi/esphome-tianpower-bms/issues/17))


  Probably advertised via BLE as `TP_123456`

* Tianpower BMS used in BASEN 10KW Wall-Mounted 51.2V 200Ah battery bank ([#16](https://github.com/syssi/esphome-tianpower-bms/issues/16))


  Probably advertised via BLE as `TP_BSTBD-23I-xxx`

* Tianpower TP-LT52 (SW 0.1.31) used in BASENGREEN 10kWh Wall-Mounted 51.2V 200Ah battery bank ([#19](https://github.com/syssi/esphome-tianpower-bms/discussions/19))


  Probably advertised via BLE as `TP_BSTBD-23F-xxx`

* Tianpower TP-LT55AT (BN-HES16S48V200LT55A-V1.1.2) used in BASENGREEN BR-OW-LV 14.33kWh 51.2V 280Ah battery bank ([#22](https://github.com/syssi/esphome-tianpower-bms/discussions/22))


  Probably advertised via BLE as `TP_BSTBD-24C-xxxx`

* Tianpower TP-LT55A in BASENGREEN 48V DIY KITS V2 battery bank ([#31](https://github.com/syssi/esphome-tianpower-bms/issues/31))


  Probably advertised via BLE as `TP_123456`

## 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-tianpower-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-tianpower-bms.git

cd esphome-tianpower-bms

# Create a secrets.yaml containing some setup specific secrets

cat > secrets.yaml <