Установите HelioPulse так, как удобно вам.

Установите HelioPulse OS на Raspberry Pi.

HelioPulse OS — готовый к работе Linux-образ для Raspberry Pi: система, панель и обновления в одной установке для локального мониторинга энергии.

1. 1

   Скачайте стабильный релиз

   Получите образ и прочитайте примечания к релизу в публичном репозитории releases.

   Скачать последний образ · 2.0 GBВсе релизы
2. 2

   Запишите образ

   Используйте Raspberry Pi Imager или аналогичный инструмент. Выберите файл и целевой SSD или microSD.

3. 3

   Подключите и включите

   Подключите накопитель, сеть, адаптер USB–RS485 и подходящий официальный блок питания Raspberry Pi.

Настройте через браузер.

При первом запуске устройство открывает каптивный портал в браузере: подключите Wi-Fi, создайте администратора и завершите. Без SSH и кабелей к компьютеру.

1. 1

   Вставьте карту и включите

   Вставьте записанную microSD в Raspberry Pi и подключите питание. Первый запуск расширяет систему и запускает HelioPulse; подождите минуту.

2. 2

   Подключитесь к сети HelioPulse

   С телефона или ноутбука подключитесь к открытой сети Wi-Fi HelioPulse-XXXX (без пароля), которую создаёт устройство. Затем откройте браузер и перейдите на http://heliopulse.setup:8090, чтобы открыть портал настройки. На некоторых телефонах портал открывается автоматически; если нет, введите этот адрес вручную.

3. 3

   Подключитесь к Интернету

   Выберите домашний Wi-Fi и введите пароль или продолжите по сетевому кабелю. Уровень сигнала помогает найти нужную сеть.

4. 4

   Создайте администратора

   Задайте имя пользователя и пароль (не менее 8 символов) для входа в панель. Храните их надёжно: это учётная запись администратора.

5. 5

   Необязательно: включите удалённый доступ

   Если устройство это поддерживает, выберите имя, чтобы безопасно открывать панель через Интернет. Локальный доступ работает всегда, поэтому шаг можно пропустить.

6. 6

   Готово к работе

   Портал подтверждает завершение настройки. Теперь устройство в вашей сети Wi-Fi: вернитесь в привычную сеть и откройте панель по адресу http://heliopulse.local:8080 под созданной учётной записью. Сеть HelioPulse-XXXX исчезает, так как больше не нужна.

Запустите HelioPulse в Docker.

Вместо записи образа загрузите контейнер на мини-ПК, NAS или сервер. То же ядро, без Raspberry: ESP32-коллекторы подключаются по сети, а адаптеры USB-RS485 и удалённый доступ работают так же, как в HelioPulse OS.

1. 1

   Запустите контейнер

   Для быстрого знакомства используйте docker run, для постоянной установки — Docker Compose. Образ сам выберет архитектуру.

   Docker Composedocker run

   Копировать

   # compose.yml — постоянная установка (рекомендуется)
   services:
     heliopulse:
       image: public.ecr.aws/j7s7r2j5/heliopulse:latest
       container_name: heliopulse
       ports: ["8080:8080"]
       volumes: ["heliopulse-data:/data"]
       environment: { HP_RUNTIME: docker }
       restart: unless-stopped
       read_only: true
       tmpfs: [/tmp]
       cap_drop: [ALL]
       security_opt: ["no-new-privileges:true"]
       logging: { driver: json-file, options: { max-size: 10m, max-file: "3" } }
   volumes: { heliopulse-data: {} }

2. 2

   Откройте панель

   Откройте http://<IP-хоста>:8080 с любого устройства в сети и создайте учётную запись администратора в мастере настройки.

   Если открыть панель извне локальной сети (например, через порт, опубликованный в интернет), мастер запросит одноразовый код настройки; его можно узнать командой docker exec heliopulse cat /data/config/bootstrap-token. Затем укажите расположение в System › General › Site location: дневные итоги, отчёты и расписания используют его часовой пояс.

3. 3

   Обновляйте

   Обновление — это замена образа: загрузите новую версию и пересоздайте контейнер. Данные останутся в томе.

   ОбновляйтеКопировать

   # Обновление до новой версии (замена образа):
   docker compose pull && docker compose up -d

Установите приложение для Home Assistant.

Запускайте HelioPulse как App в Home Assistant OS: боковая панель, вход администратора и датчики MQTT.

1. 1

   Добавьте репозиторий

   Откройте Настройки → Apps → Магазин Apps → ⋮ → Репозитории и добавьте указанный ниже публичный репозиторий.

   Добавьте репозиторийКопировать

   https://github.com/helios-pulse/heliopulse-releases

   Добавить в мой Home Assistant
2. 2

   Установите и откройте HelioPulse

   Найдите HelioPulse, установите и запустите. Включите показ на боковой панели и откройте HelioPulse с сеансом администратора Home Assistant.

3. 3

   Подключите датчики (по желанию)

   Для датчиков настройте Mosquitto и интеграцию MQTT в Home Assistant. Оставьте mqtt_mode в auto и настройте устройства в HelioPulse. Используйте отдельный topic_prefix для каждого экземпляра.

4. 4

   Обновляйте безопасно

   Перед обновлением создайте резервную копию, затем обновите App через Home Assistant. Версии App независимы от HelioPulse OS и OTA-обновлений.

Локальная модульная платформа.

У каждого устройства есть независимый collector. Сбой или перезапуск одного инвертора не прерывает телеметрию остальных.

Переводчик между устройством и HelioPulse.

Драйвер — это декларативный JSON-файл. Он описывает связь по Modbus RTU и преобразование регистров производителя в общие метрики HelioPulse.

Начните с карты Modbus.

Нужны руководство по протоколу производителя и проверенные показания реального устройства. Минимальная схема требует идентификатор, протокол 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
    }]
  }]
}

Активируйте без SSH.