ESPHome Victron BLE 组件 esphome-victron_ble

智能家居, ESP32 2/5 已发布
Fabian-Schmidt 382 Stars GPL-3.0 BOM 完整度: 0/5 教程完整度: 0/5
ESPHome Victron BLE 组件

项目简介

通过官方Victron BLE端点,用ESPHome经蓝牙LE获取Victron设备数据。


esphome-victron_ble 是一个专为 ESPHome 平台开发的第三方开源组件,旨在通过蓝牙低功耗(BLE)协议,将 Victron Energy 旗下各类设备的实时运行数据无缝接入到家庭自动化系统(如 Home Assistant)中。该项目并非 Victron 官方出品,但严格遵循其公开的蓝牙广播协议,能够安全、高效地读取设备广播的加密数据。

标签

项目特点

**官方协议支持**:使用 Victron 官方蓝牙广播协议,无需与设备建立连接即可获取数据。
**多设备兼容**:支持 Smart Shunt、Smart Solar、逆变器、DC/DC 转换器、SmartLithium、Inverter RS、AC Charger、Smart Battery Protect、Smart Battery Sense、(Lynx Smart) BMS、Multi RS、VE.Bus、DC Energy Meter、Orion XS 和 Blue Smart Chargers 等多种 Victron 设备。
**丰富的数据类型**:提供传感器(电压、电流、功率、电量等)、二进制传感器(报警、故障状态)和文本传感器(设备状态、错误原因)等多种数据接口。
**自动化触发**:支持基于消息类型的自动化触发器,如 `on_message`、`on_battery_monitor_message` 等,便于实现自定义逻辑。
**易于集成**:作为 ESPHome 外部组件,可轻松添加到现有 ESPHome 配置中,与 Home Assistant 等平台无缝对接。

技术规格

通信协议 Victron 蓝牙广播协议(推荐)或标准 BLE 连接协议
硬件平台 ESP32(如 ESP32 Dev Board)
软件依赖 ESPHome 框架
数据获取方式 通过 BLE 广播包解密获取,无需建立连接
加密方式 AES 加密(需提供设备的 bindkey)
支持设备数量 可同时监控多个 Victron 设备
传感器类型 传感器(sensor)、二进制传感器(binary_sensor)、文本传感器(text_sensor)

项目资源

物料清单 (BOM)

物料名称 数量 参考价格 备注
ESP32 开发板 1 如 ESP32 Dev Board
Victron 设备 1+ 如 Smart Shunt、Smart Solar 等
ESPHome 1 需安装并配置
VictronConnect App 1 用于获取设备信息

能力画像

⚪ 记忆与知识检索: 2/5
🔵 逻辑推演: 3/5
⚪ 表达与交流: 1/5
⚪ 感知与观察: 1/5
⚪ 数理与计算: 2/5
⚪ 动手与操作: 3/5
⚪ 狂热与坚持: 2/5
⚪ 创造与创新: 2/5

所需技能

🔧 **动手能力**:需要能够连接和配置 ESP32 开发板,以及使用 VictronConnect App 获取设备信息。 💻 **编程能力**:需要熟悉 YAML 配置语法,能够编写和修改 ESPHome 配置文件。 ⚡ **电子电路**:无需复杂的电路知识,但了解 BLE 通信和基本网络配置会有帮助。

适用场景

**家庭能源监控**:将 Victron 太阳能充电控制器、电池监测器等设备的数据集成到 Home Assistant,实现实时能源监控。
**离网系统管理**:在离网太阳能系统中,通过 ESP32 和 ESPHome 远程监控电池状态、发电量和负载情况。
**移动设备监控**:在房车或船只上,利用 BLE 无线监控 Victron 设备,无需布线。