ESPHome Victron BLE 组件
esphome-victron_ble
智能家居, ESP32
2/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 等平台无缝对接。
技术规格
| 通信协议 | 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 设备,无需布线。