Вернуться на сайтЦентр установки и документации

От пустого Raspberry Pi до первого показания энергии.

Пошаговое руководство по установке HelioPulse, его архитектуре, подключению устройств и расширению платформы драйверами.

Основано на HelioPulse OS 1.7.0 Инструкция соответствует репозиторию
Обзор настоящего продукта

Посмотрите шаги до установки.

Руководство иллюстрировано реальными экранами работающей установки HelioPulse.

Настройка и входНастройка и вход

Настройка и вход

Начните в браузере, без SSH.

Обзор энергии в реальном времениОбзор энергии в реальном времени

Обзор энергии в реальном времени

Убедитесь, что система передаёт производство и потребление.

Редактор драйверовРедактор драйверов

Редактор драйверов

Создайте драйвер Modbus из определения JSON.

Что уже есть в HelioPulse

Локальная энергетическая платформа, доступная уже сейчас.

Текущий продукт объединяет мониторинг в реальном времени, локальную историю, управление устройствами и безопасные операции на Raspberry Pi.

Доступно сегодня

Мониторинг с приоритетом локальной работы

Храните телеметрию и историю на appliance и продолжайте работу в локальной сети без Интернета.

Качественная телеметрия в реальном времени

Смотрите солнечную энергию, потребление, батарею, сеть и состояние подключения устройств через WebSocket.

Исторический анализ

Изучайте производство, потребление, SOC, температуры и фазы за период от сегодняшнего дня до года.

Проверенные JSON-драйверы

Загружайте, создавайте и повторно используйте декларативные Modbus-драйверы без переписывания панели.

Работа с несколькими устройствами

Управляйте независимыми collectors, стабильными последовательными портами, состоянием устройств и действиями start/stop/restart.

Аварии и лента событий

Отслеживайте переходы аварий, подтверждайте инциденты и проверяйте события связи, конфигурации и collector.

Ежедневные и еженедельные отчёты

Создавайте детерминированные отчёты об энергии, аномалиях, авариях и событиях; локальный AI необязателен.

Состояние, резервные копии и восстановление

Проверяйте ресурсы Raspberry, связь и диагностику, создавайте локальные копии и восстанавливайтесь из них.

Адаптивный многоязычный интерфейс

Используйте панель на компьютере или мобильном устройстве с девятью языками и светлой или тёмной темой.

Дополнительно и расширенно

Прогноз солнечной энергии

Сравнивайте ожидаемую и произведённую солнечную энергию после настройки PV-массива.

BMS по Modbus RTU

Зарегистрируйте совместимый BMS как отдельное устройство и просматривайте ячейки, балансировку, SOC, SOH, температуры и циклы.

Режим симуляции

Генерируйте синтетическую телеметрию из драйвера для проверки интерфейса без оборудования.

Локальный AI для отчётов

При необходимости скачайте и активируйте локальную модель; детерминированные отчёты доступны и без неё.

MQTT и Home Assistant

Публикуйте данные в необязательный broker через TLS и используйте discovery Home Assistant.

Локальная автоматизация

Используйте пороги, расписания, аварии и события для MQTT, webhook или журнала; доступен dry-run.

Удалённый доступ и OTA приложения

Доступ через исходящий туннель и подписанные обновления приложения зависят от настройки и соединения.

Дорожная карта

Облачная синхронизация

Не входит в текущий локальный сценарий.

Маркетплейс драйверов

Ручная загрузка драйверов уже доступна; публичный маркетплейс появится позже.

Протоколы проприетарных BMS

CAN, BLE и протоколы JK без Modbus пока не входят в поддерживаемый путь.

Автоматическая запись в инверторы

В этой версии автоматизация не изменяет параметры инвертора.

Полный A/B откат ОС

OTA приложения доступна отдельно; полный A/B откат операционной системы появится позже.

01Установка

Подготовьте appliance.

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

Raspberry Pi 4 или 5

Pi 4 с 4 ГБ или Pi 5 с 4/8 ГБ.

Накопитель

Рекомендуется SSD USB 3.0 на 128 ГБ или microSD High Endurance.

Связь

Адаптер 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 в Raspberry Pi и подключите питание. Первый запуск расширяет систему и запускает 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. Готово к работе

Вернитесь в привычную сеть и откройте показанный адрес панели.

Создан для телефона и ноутбука

Портал — это адаптивный пошаговый процесс с индикатором прогресса и светлой/тёмной темами. Без приложения, без SSH и без кабелей к компьютеру.

03Как это работает

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

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

01

Устройство

Инвертор или BMS предоставляет данные через свой протокол.

02

Драйвер

Описывает протокол, регистры, масштабы и метрики.

03

Сборщик

Считывает каждое устройство в изолированном управляемом процессе.

04

Панель

Объединяет телеметрию, историю, аварии и прогноз.

04Драйверы

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

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

Без исполняемого кода

Пакет описывает данные и не устанавливает произвольные бинарные файлы в системе.

Проверка перед сохранением

Backend проверяет структуру, протокол и регистры до принятия файла.

Повторное использование

Один драйвер можно применять на нескольких совместимых устройствах.

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 и slave ID от 1 до 247.

Шаг 3

Запустите collector

Запустите или перезапустите только это устройство и убедитесь, что телеметрия активна.

Контролируемая замена

Загрузка другого файла с тем же ID обновляет драйвер. Перезапустите связанные устройства, чтобы применить новое определение.

07Перспектива релизов

Что будет дальше.

Здесь показано текущее направление проекта. Объём и порядок могут измениться после технической проверки и полевых испытаний.

v1.7Доступно

Интеллектуальная локальная основа

  • Мультиинверторные и панельные драйверы
  • Отчёты с локальными AI-моделями
  • История, диагностика и прогноз
v1.8Запланировано

Экосистема драйверов

  • Маркетплейс и проверяемый каталог
  • Совместимость и версии драйверов
  • Процесс тестирования и публикации
  • Больше драйверов инверторов и BMS
v1.9Изучается

Надёжная расширенная эксплуатация

  • Расширенная наблюдаемость и сопровождение
  • Более широкая многоязычность и согласованность
  • Расширенная проверка показаний батареи между инвертором, BMS и шунтом
  • Декодирование аварий производителей и более богатая автоматизация с несколькими действиями
БудущееНаправление

Несколько площадок с агентами

  • Архитектура с координирующим Raspberry Pi
  • Коллекторы-агенты на Raspberry Pi или ESP32
  • Облачные резервные копии
  • Управление несколькими установками
  • Интеграция Grafana для настраиваемых панелей
  • Уведомления в реальном времени через каналы, настраиваемые пользователем

Готовы к установке?

Скачайте стабильный релиз или изучите исходный код и развитие проекта.

Релизы
Начало работы: установка HelioPulse на Raspberry Pi | HelioPulse