あなたに合った方法で HelioPulse を導入。

Raspberry Pi に HelioPulse OS をインストール。

HelioPulse OS は Raspberry Pi 向けのすぐに使える Linux イメージです。システム、パネル、アップデートを一つにまとめ、ローカルのエネルギー監視向けに設計されています。

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 が起動します。1 分ほどお待ちください。

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 ネットワークは不要になるため消えます。

Docker で HelioPulse を動かす。

イメージを書き込む代わりに、ミニ PC、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 を開き、セットアップウィザードで管理者アカウントを作成します。

   ローカルネットワークの外から開く場合（例：インターネットに公開したポート）、ウィザードは1回限りのセットアップコードを求めます。docker exec heliopulse cat /data/config/bootstrap-token で確認できます。その後、システム › 一般 › サイトの位置 を設定してください。日次合計、レポート、スケジュールはそのタイムゾーンを使います。

3. 3

   最新の状態を保つ

   更新はイメージの置き換えです。新しいバージョンを取得してコンテナを再作成します。データはボリュームに残ります。

   最新の状態を保つコピー

   # 新しいバージョンに更新（イメージの置き換え）：
   docker compose pull && docker compose up -d

Home Assistant アプリをインストール。

Home Assistant OS 内で HelioPulse を App として実行。サイドバー、管理者ログイン、MQTT センサーに対応します。

1. 1

   リポジトリを追加

   設定 → Apps → App ストア → ⋮ → リポジトリを開き、下記の公開リポジトリを追加します。

   リポジトリを追加コピー

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

   自分の Home Assistant に追加
2. 2

   HelioPulse をインストールして開く

   HelioPulse を検索してインストールし、起動します。「サイドバーに表示」を有効にし、Home Assistant の管理者セッションで開きます。

3. 3

   センサーを接続（任意）

   センサーには Home Assistant で Mosquitto と MQTT 統合を設定します。mqtt_mode は auto のまま、HelioPulse でデバイスを設定します。インスタンスごとに異なる topic_prefix を使います。

4. 4

   安全にアップデート

   バックアップを作成してから Home Assistant で App を更新します。App のバージョンは HelioPulse OS や OTA 更新とは独立しています。

ローカルでモジュール式のプラットフォーム。

各デバイスは独立した collector を持ちます。1台のインバーターの障害や再起動が他のテレメトリーを止めることはありません。

機器と HelioPulse の間の翻訳者。

ドライバーは宣言型 JSON ファイルです。Modbus RTU での通信方法と、メーカーのレジスターを HelioPulse 共通メトリクスへ変換する方法を定義します。

Modbus マップから始める。

メーカーのプロトコルマニュアルと実機で検証した読み取り値が必要です。最小スキーマには識別子、modbus_rtu プロトコル、1つ以上のレジスターを含むグループが必要です。

{
  "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 なしで有効にする。