返回网站入门与文档中心

从空白 Raspberry Pi 到第一条能源数据。

循序渐进地安装 HelioPulse、了解架构、连接设备并通过驱动扩展平台。

基于 HelioPulse OS 1.7.0 说明与仓库保持一致
真实产品演示

安装前先了解这些步骤。

本指南使用 HelioPulse 实际运行环境的真实屏幕进行说明。

设置与登录设置与登录

设置与登录

无需 SSH,从浏览器开始。

实时能源总览实时能源总览

实时能源总览

确认系统正在报告生产和消耗数据。

驱动编辑器驱动编辑器

驱动编辑器

从 JSON 定义创建 Modbus 驱动。

HelioPulse 当前提供的功能

现在就能使用的本地能源平台。

当前产品将实时监控、本地历史、设备管理和 Raspberry Pi 上的安全操作结合在一起。

当前可用

本地优先监控

将遥测和历史保存在 appliance 上,即使没有互联网也能继续在本地网络中运行。

带质量信息的实时遥测

通过 WebSocket 实时查看太阳能、消耗、电池、电网和设备连接状态。

历史分析

从今天、自定义时间范围到一年,查看生产、消耗、SOC、温度和各相数据。

经过验证的 JSON 驱动

加载、创建并复用声明式 Modbus 驱动,无需重写面板。

多设备操作

管理独立 collectors、稳定串口、设备状态以及 start/stop/restart 操作。

告警与事件时间线

跟踪告警变化、确认事件,并审计连接、配置和 collector 事件。

日报与周报

生成包含能源、异常、告警和事件的确定性报告;本地 AI 可选。

健康状态、备份与恢复

检查 Raspberry 资源、连接和诊断,然后创建备份并在本地恢复。

响应式多语言界面

在桌面或移动设备上使用面板,支持九种语言和浅色/深色主题。

可选与高级功能

太阳能预测

配置 PV 阵列后,比较预期和实际产生的太阳能。

通过 Modbus RTU 连接 BMS

将兼容的 BMS 注册为独立设备,查看电芯、均衡、SOC、SOH、温度和循环次数。

模拟模式

从驱动生成模拟遥测,在没有硬件时验证界面。

用于报告的本地 AI

可选下载并启用本地模型;没有模型时仍可使用确定性报告。

MQTT 和 Home Assistant

通过 TLS 发布到可选 broker,并支持 Home Assistant Discovery。

本地自动化

使用阈值、计划、告警或事件发布 MQTT、调用 webhook 或记录事件;支持 dry-run。

远程访问与应用 OTA

出站隧道访问和签名应用更新取决于配置与网络连接。

路线图

云同步

不属于当前本地工作流。

驱动市场

目前支持手动加载驱动;公共驱动市场属于未来工作。

专有 BMS 协议

CAN、BLE 和非 Modbus 的 JK 协议不属于当前支持路径。

自动写入逆变器

此版本的自动化不会写入逆变器参数。

完整操作系统 A/B 回滚

应用 OTA 可单独使用;完整操作系统 A/B 回滚属于未来工作。

01安装

准备 appliance。

HelioPulse OS 是为本地能源监控设计的 Raspberry Pi Linux 镜像。

Raspberry Pi 4 或 5

Pi 4 配备 4 GB,或 Pi 5 配备 4/8 GB。

存储设备

推荐使用 128 GB USB 3.0 SSD 或 High Endurance microSD。

通信

带电气隔离的 USB–RS485 转接器。

  1. 1

    下载稳定版本

    从公开 releases 仓库获取镜像并阅读版本说明。

    查看所有版本
  2. 2

    写入镜像

    使用 Raspberry Pi Imager 或同类工具,选择下载的文件和目标 SSD 或 microSD。

  3. 3

    连接并开机

    连接存储、网络、USB–RS485 转接器和适合 Raspberry Pi 的官方电源。

请在断电状态下操作

按照制造商手册连接 RS485。不要处理带电的逆变器连接。

02首次启动

通过浏览器配置。

首次启动时,设备会在浏览器中打开一个强制门户:连接 Wi-Fi、创建管理员并完成。无需 SSH,也无需连接到你电脑的线缆。

本地网络找到 Raspberry Pi
初始账户创建安全凭据
首个设备驱动、端口和 slave ID
  1. 1

    插入存储卡并上电

    把烧录好的 microSD 插入树莓派并接通电源。首次启动会扩展系统并启动 HelioPulse,请稍等一分钟。

  2. 2

    连接 HelioPulse 网络

    用手机或电脑连接设备创建的临时 Wi-Fi 网络。配置门户会在浏览器中自动打开;如果没有,请打开屏幕上显示的地址。

  3. 3

    1. 连接互联网

    选择你家的 Wi-Fi 并输入密码,或选择使用网线继续。信号强度可帮助你识别正确的网络。

  4. 4

    2. 创建管理员

    设置用于登录面板的用户名和密码(至少 8 个字符)。请妥善保管:这是你的管理员账户。

  5. 5

    可选:启用远程访问

    如果设备支持,选择一个名称以便通过互联网安全打开面板。本地访问始终有效,因此可以跳过此步骤。

  6. 6

    3. 可以使用

    门户会确认配置完成并显示面板地址。重新连接到你常用的网络并打开它,使用你创建的账户登录。

1. 连接互联网1. 连接互联网

1. 连接互联网

选择你的 Wi-Fi 网络(或使用网线继续)。

2. 创建管理员2. 创建管理员

2. 创建管理员

设置用于登录面板的凭据。

3. 可以使用3. 可以使用

3. 可以使用

重新连接到你常用的网络,并打开显示的面板地址。

为手机和电脑设计

门户是一个响应式的引导流程,带有进度条和浅色/深色主题。无需 App、无需 SSH,也无需连接到电脑的线缆。

03工作原理

本地化、模块化的平台。

每个设备都有独立的 collector。一个逆变器故障或重启不会中断其他设备的遥测。

01

设备

逆变器或 BMS 通过自身协议提供数据。

02

驱动

描述协议、寄存器、缩放和指标。

03

采集器

在隔离且可控的进程中读取每个设备。

04

面板

汇总遥测、历史、告警和预测。

04驱动

设备与 HelioPulse 之间的翻译器。

驱动是声明式 JSON 文件,定义如何通过 Modbus RTU 通信,以及如何将制造商寄存器转换为 HelioPulse 通用指标。

不含可执行代码

软件包只描述数据,不会在系统中安装任意二进制文件。

保存前验证

后端会在接受文件前检查结构、协议和寄存器。

可复用

同一驱动可以用于多个兼容设备。

05创建驱动

从 Modbus 映射开始。

你需要制造商的协议手册和真实设备上的验证读数。最小模式要求标识符、modbus_rtu 协议,以及至少包含一个寄存器的分组。

my-inverter-modbus.json 最小示例
{
  "id": "my-inverter-modbus",
  "name": "My inverter",
  "manufacturer": "Manufacturer",
  "models": ["Model A"],
  "protocol": {
    "type": "modbus_rtu",
    "baud_rate": 9600,
    "slave_id": 1
  },
  "register_groups": [{
    "name": "battery",
    "interval": "5s",
    "registers": [{
      "address": 256,
      "name": "battery_soc",
      "metric": "battery.soc_pct",
      "unit": "%",
      "scale": 1,
      "signed": false
    }]
  }]
}

发布前检查

  • 使用稳定、安全的 ID 作为文件名。
  • 确认 baud rate、奇偶校验、stop bits 和 slave ID。
  • 核对每个寄存器的地址、符号、缩放和单位。
  • 将功率和能量与设备实体面板进行比较。
  • 测试断开连接和超出范围的值。
06加载并连接

无需 SSH 即可启用。

步骤 1

上传 JSON

在设备 → 驱动中选择文件。HelioPulse 会在保存前验证模式。

步骤 2

注册设备

设置设备 ID、驱动、持久化 by-id 端口,以及 1 到 247 之间的 slave ID。

步骤 3

启动 collector

只启动或重启该设备,并确认遥测变为活跃状态。

受控替换

上传相同 ID 的另一个文件会更新驱动。重启关联设备以应用新定义。

07版本展望

接下来会有什么。

这里展示项目当前的发展方向。范围和顺序可能会根据技术验证与现场测试而调整。

v1.7已提供

智能本地基础

  • 多逆变器与面板驱动
  • 使用本地 AI 模型生成报告
  • 历史、诊断与预测
v1.8计划中

驱动生态

  • 市场与可验证目录
  • 兼容性与驱动版本
  • 测试与发布流程
  • 更多逆变器和 BMS 驱动
v1.9研究中

可靠的高级运营

  • 可观测性与引导式维护增强
  • 更广泛的多语言覆盖与一致性
  • 跨逆变器、BMS 与分流器的电池读数高级验证
  • 按制造商解码告警并支持更丰富的多动作自动化
未来方向

多站点与代理

  • 一台主 Raspberry Pi 协调整个安装
  • Raspberry Pi 或 ESP32 上的采集代理
  • 云端备份
  • 多安装点管理
  • 集成 Grafana 构建自定义仪表板
  • 通过用户可配置的渠道发送实时通知

准备安装了吗?

下载稳定版本,或查看源代码和项目演进。

版本
快速开始:在树莓派上安装 HelioPulse | HelioPulse