

设置与登录
无需 SSH,从浏览器开始。
循序渐进地安装 HelioPulse、了解架构、连接设备并通过驱动扩展平台。
本指南使用 HelioPulse 实际运行环境的真实屏幕进行说明。


无需 SSH,从浏览器开始。


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


从 JSON 定义创建 Modbus 驱动。
当前产品将实时监控、本地历史、设备管理和 Raspberry Pi 上的安全操作结合在一起。
将遥测和历史保存在 appliance 上,即使没有互联网也能继续在本地网络中运行。
通过 WebSocket 实时查看太阳能、消耗、电池、电网和设备连接状态。
从今天、自定义时间范围到一年,查看生产、消耗、SOC、温度和各相数据。
加载、创建并复用声明式 Modbus 驱动,无需重写面板。
管理独立 collectors、稳定串口、设备状态以及 start/stop/restart 操作。
跟踪告警变化、确认事件,并审计连接、配置和 collector 事件。
生成包含能源、异常、告警和事件的确定性报告;本地 AI 可选。
检查 Raspberry 资源、连接和诊断,然后创建备份并在本地恢复。
在桌面或移动设备上使用面板,支持九种语言和浅色/深色主题。
配置 PV 阵列后,比较预期和实际产生的太阳能。
将兼容的 BMS 注册为独立设备,查看电芯、均衡、SOC、SOH、温度和循环次数。
从驱动生成模拟遥测,在没有硬件时验证界面。
可选下载并启用本地模型;没有模型时仍可使用确定性报告。
通过 TLS 发布到可选 broker,并支持 Home Assistant Discovery。
使用阈值、计划、告警或事件发布 MQTT、调用 webhook 或记录事件;支持 dry-run。
出站隧道访问和签名应用更新取决于配置与网络连接。
不属于当前本地工作流。
目前支持手动加载驱动;公共驱动市场属于未来工作。
CAN、BLE 和非 Modbus 的 JK 协议不属于当前支持路径。
此版本的自动化不会写入逆变器参数。
应用 OTA 可单独使用;完整操作系统 A/B 回滚属于未来工作。
HelioPulse OS 是为本地能源监控设计的 Raspberry Pi Linux 镜像。
Pi 4 配备 4 GB,或 Pi 5 配备 4/8 GB。
推荐使用 128 GB USB 3.0 SSD 或 High Endurance microSD。
带电气隔离的 USB–RS485 转接器。
使用 Raspberry Pi Imager 或同类工具,选择下载的文件和目标 SSD 或 microSD。
连接存储、网络、USB–RS485 转接器和适合 Raspberry Pi 的官方电源。
按照制造商手册连接 RS485。不要处理带电的逆变器连接。
首次启动时,设备会在浏览器中打开一个强制门户:连接 Wi-Fi、创建管理员并完成。无需 SSH,也无需连接到你电脑的线缆。
把烧录好的 microSD 插入树莓派并接通电源。首次启动会扩展系统并启动 HelioPulse,请稍等一分钟。
用手机或电脑连接设备创建的临时 Wi-Fi 网络。配置门户会在浏览器中自动打开;如果没有,请打开屏幕上显示的地址。
选择你家的 Wi-Fi 并输入密码,或选择使用网线继续。信号强度可帮助你识别正确的网络。
设置用于登录面板的用户名和密码(至少 8 个字符)。请妥善保管:这是你的管理员账户。
如果设备支持,选择一个名称以便通过互联网安全打开面板。本地访问始终有效,因此可以跳过此步骤。
门户会确认配置完成并显示面板地址。重新连接到你常用的网络并打开它,使用你创建的账户登录。


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


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


重新连接到你常用的网络,并打开显示的面板地址。
门户是一个响应式的引导流程,带有进度条和浅色/深色主题。无需 App、无需 SSH,也无需连接到电脑的线缆。
每个设备都有独立的 collector。一个逆变器故障或重启不会中断其他设备的遥测。
逆变器或 BMS 通过自身协议提供数据。
描述协议、寄存器、缩放和指标。
在隔离且可控的进程中读取每个设备。
汇总遥测、历史、告警和预测。
驱动是声明式 JSON 文件,定义如何通过 Modbus RTU 通信,以及如何将制造商寄存器转换为 HelioPulse 通用指标。
软件包只描述数据,不会在系统中安装任意二进制文件。
后端会在接受文件前检查结构、协议和寄存器。
同一驱动可以用于多个兼容设备。
你需要制造商的协议手册和真实设备上的验证读数。最小模式要求标识符、modbus_rtu 协议,以及至少包含一个寄存器的分组。
{
"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
}]
}]
}在设备 → 驱动中选择文件。HelioPulse 会在保存前验证模式。
设置设备 ID、驱动、持久化 by-id 端口,以及 1 到 247 之间的 slave ID。
只启动或重启该设备,并确认遥测变为活跃状态。
上传相同 ID 的另一个文件会更新驱动。重启关联设备以应用新定义。
这里展示项目当前的发展方向。范围和顺序可能会根据技术验证与现场测试而调整。
下载稳定版本,或查看源代码和项目演进。