ESPHome Victron BLE 组件

esphome-victron_ble

智能家居, ESP32 ⭐⭐☆☆☆ (2/5) 已发布
Fabian-Schmidt 382 Stars GPL-3.0 BOM 完整度: /5 教程完整度: /5

项目简介

通过官方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 等平台无缝对接。

技术规格

通信协议
硬件平台
软件依赖
数据获取方式
加密方式
支持设备数量
传感器类型

项目资源

物料清单 (BOM)

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

所需工具

工具用途是否必需
计算机 编写和上传 ESPHome 配置 ✅ 是
USB 数据线 连接 ESP32 到计算机 ✅ 是
VictronConnect App 获取设备 MAC 地址和加密密钥 ✅ 是

能力画像

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

所需技能

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

适用场景

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