Apache License 2.0

项目介绍

fancyui/Gobel-Battery-HA-Addon 是一个托管在 GitHub 上的开源项目,主要使用 Python 编写,采用 Apache License 2.0 许可证,目前获得 30 个 Star、18 次 Fork。

仓库全名
fancyui/Gobel-Battery-HA-Addon
开源许可证
Apache License 2.0
Star 数
30
Fork 数
18
未关闭 Issue
10

README 摘要

description: Gobel Power Battery Home Assistant Add-on (JK BMS, Pace BMS, TDT BMS) Deutsch | 简体中文 Note: Looking for the ioBroker version? Check out the ioBroker Gobel BMS Monitor Adapter. [!TIP] Looking for a Native Home Assistant Integration? We have launched a pre-release of the native Gobel Power Battery Home Assistant Integration! It runs directly inside Home Assistant without requiring an MQTT broker, and…

完整内容见 GitHub 原始 README 或本页 。

常见问题

Gobel-Battery-HA-Addon 用什么语言开发?

主要使用 Python 编写,采用 Apache License 2.0 许可证,目前有 30 个 Star。

Gobel-Battery-HA-Addon 可以免费商用吗?

仓库采用 Apache License 2.0 许可证,可免费使用与修改,商业使用请遵守许可证条款(例如保留版权声明与许可声明)。

如何获取 Gobel-Battery-HA-Addon 的源码?

可以直接克隆仓库:git clone https://github.com/fancyui/Gobel-Battery-HA-Addon.git,默认分支为 main;安装与运行步骤见仓库 README。

Gobel-Battery-HA-Addon 最近还在维护吗?

仓库最近一次更新为 2 周前,当前有 10 个未关闭 Issue;Star 数为 30,可作为社区活跃度的参考。

关于

Home Assistant Add-on to integrate LiFePO4 batteries via JK BMS, Pace BMS, and TDT BMS. Supports RS232, RS485, WiFi, and Ethernet for real-time monitoring of SoC, cell voltages, and diagnostics. Master-slave configuration supported.

描述取自 GitHub 官方 API,中文内容由 GitRead 中文社区 编辑团队整理。

简要分析

热度分
71
价值分
23
活跃状态
活跃

README


description:

Gobel Power Battery Home Assistant Add-on (JK BMS, Pace BMS, TDT BMS)

Deutsch | 简体中文

Note: Looking for the ioBroker version? Check out the ioBroker Gobel BMS Monitor Adapter.

[!TIP] Looking for a Native Home Assistant Integration?
We have launched a pre-release of the native Gobel Power Battery Home Assistant Integration!
It runs directly inside Home Assistant without requiring an MQTT broker, and supports multi-site monitoring (connecting to multiple batteries on different IPs, ports, or serial interfaces simultaneously). We welcome your testing and feedback!

The ultimate Home Assistant integration for smart energy storage monitoring. This add-on provides robust, real-time data logging and diagnostics for your LiFePO4 battery banks running Pace BMS, JK BMS, or TDT BMS hardware.

Seamlessly bridge your solar energy storage system (ESS) with your home automation network using standard protocols like MQTT to monitor battery health, individual cell voltages, state of charge (SoC), and system protections.

Key Features & Capabilities:

  • Multi-BMS Compatibility: Native support for Pace BMS, JK BMS (55AA protocol), and TDT BMS (Note: TDT BMS may only be compatible with specific versions and support may be removed in future releases).
  • Versatile Connectivity Options: Connect your hardware via RS232-USB, RS232-to-Ethernet, RS232-to-WiFi, RS485-to-Ethernet, or RS485-to-WiFi.
  • Comprehensive Telemetry: Tracks state of charge (SoC), state of health (SoH), total voltage, current, individual cell balancing, temperatures, warnings, and fault protections.
  • One Connection for All (Master-Slave): Simplify your wiring. Connect directly to the Master BMS to automatically discover and aggregate data from all parallel-connected slave battery packs.
  • Plug-and-Play Home Assistant Setup: Quickly deploy and generate automated dashboards for real-time energy tracking.

Documents & Tools

Gobel Power Battery Home Assistant Addon Manual
Online Home Assistant Dashboard Generator

Dashboard Example:

image

Pace BMS Connection Instructions:

  • RS232-WIFI/Ethernet modual or RS232-USB cable needed
  • Connection Port: Connect Home Assistant to the RS232 or WIFI interface of the Pace BMS.
  • Master BMS: The connection must be made to the Master BMS.
  • DIP Switch Settings: Ensure the DIP switch (Dial) of master BMS is set to 1000.

JK BMS Connection Instructions:

  • RS485-WIFI/Ethernet modual or RS485-USB cable needed
  • Connection Port: Connect Home Assistant to the RS485B or RS485C interface of the JK BMS.
  • Master BMS: The connection must be made to the Master BMS.
  • DIP Switch Settings: Ensure the DIP switch (Dial) of master BMS is set to 0000.

Configuration Notes:

MQTT Discovery Prefix (host_name)

Important 重要

Correctly configure the MQTT Discovery Prefix (host_name) in the Add-on Options:

  • Default: homeassistant
  • Must Match Home Assistant’s Discovery Prefix: This option sets the topic prefix under which MQTT discovery messages are published. It must exactly match the Discovery prefix set in your Home Assistant MQTT integration (navigate to Settings > Devices & services > MQTT > Configure > view options; default is homeassistant).
  • Do NOT Use Your Machine’s Hostname: Do NOT set this field to your computer’s OS hostname (e.g. rpi5, homeassistant.local, etc.). If it does not match HA’s Discovery Prefix, the MQTT broker will receive the battery data, but Home Assistant will not automatically discover or create the battery devices and sensors (see Issue #79).

TDT BMS Compatibility Notice

Warning 警告

TDT BMS Compatibility Notice: TDT BMS support may only be compatible with specific hardware/firmware versions. Please note that support for TDT BMS may be deprecated or removed in future releases.

Installation:

Click the button to add the addon to Home Assistant

Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.

评论

暂无评论