サイトに戻る導入とドキュメントのセンター

空の Raspberry から最初のエネルギーデータまで。

HelioPulse のインストール、アーキテクチャの理解、機器の接続、ドライバーによる拡張を段階的に案内します。

HelioPulse OS 1.7.0 に基づく内容 リポジトリに沿った手順
実際の製品を確認

インストール前に手順を確認。

このガイドでは、実際に稼働している HelioPulse の画面を使って説明します。

設定とログイン設定とログイン

設定とログイン

SSH を使わずブラウザーから開始します。

リアルタイムのエネルギー概要リアルタイムのエネルギー概要

リアルタイムのエネルギー概要

システムが発電と消費を報告していることを確認します。

ドライバーエディタードライバーエディター

ドライバーエディター

JSON 定義から Modbus ドライバーを作成します。

HelioPulse の現在の機能

今すぐ使えるローカルエネルギープラットフォーム。

現在の製品は、リアルタイム監視、ローカル履歴、デバイス管理、安全な Raspberry Pi 操作をまとめます。

現在利用可能

ローカル優先の監視

アプライアンスにテレメトリーと履歴を保存し、インターネットなしでローカルネットワーク上の運用を続けます。

品質情報付きリアルタイムテレメトリー

WebSocket のライブ更新で太陽光、消費、バッテリー、系統、デバイス接続状態を確認できます。

履歴分析

今日から任意の期間、最大1年まで、発電、消費、SOC、温度、各相を分析できます。

検証済み JSON ドライバー

宣言的な Modbus ドライバーを読み込み、作成、再利用できます。パネルの書き換えは不要です。

複数デバイスの運用

独立した collector、安定したシリアルポート、デバイス状態、start/stop/restart 操作を管理します。

アラームとイベントタイムライン

アラームの変化を追跡し、インシデントを確認し、接続・設定・collector のイベントを監査できます。

日次・週次レポート

エネルギー、異常、アラーム、イベントを含む決定論的レポートを作成します。ローカル AI は任意です。

状態、バックアップ、復旧

Raspberry のリソース、接続、診断を確認し、ローカルバックアップの作成と復旧を行えます。

レスポンシブ多言語 UI

デスクトップまたはモバイルで、9言語とライト/ダークテーマに対応したパネルを使えます。

オプション・高度な機能

太陽光予測

PV アレイの設定後、予測した太陽光エネルギーと実績を比較できます。

Modbus RTU 経由の BMS

互換性のある BMS を独立したデバイスとして登録し、セル、バランス、SOC、SOH、温度、サイクルを確認します。

モックモード

ドライバーから合成テレメトリーを生成し、ハードウェアなしで UI を検証できます。

レポート用ローカル AI

必要に応じてローカルモデルをダウンロードして有効化できます。モデルなしでも決定論的レポートを利用できます。

MQTT と Home Assistant

TLS を使って任意の broker に公開し、Home Assistant Discovery を利用できます。

ローカル自動化

しきい値、スケジュール、アラーム、イベントから MQTT 公開、webhook 呼び出し、イベント記録を実行できます。dry-run にも対応します。

リモートアクセスとアプリ OTA

アウトバウンドトンネルによるアクセスと署名付きアプリ更新は、設定と接続状況に依存します。

ロードマップ

クラウド同期

現在のローカルワークフローには含まれません。

ドライバーマーケットプレイス

現在はドライバーを手動で読み込めます。公開マーケットプレイスは将来の予定です。

独自 BMS プロトコル

CAN、BLE、Modbus 以外の JK プロトコルは現在サポート対象外です。

インバーターへの自動書き込み

このバージョンの自動化はインバーターのパラメーターを書き換えません。

OS 全体の A/B ロールバック

アプリ OTA は別途利用できます。OS 全体の 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 を Raspberry Pi に挿し、電源を接続します。初回起動でシステムが拡張され HelioPulse が起動します。1 分ほどお待ちください。

  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 を持ちます。1台のインバーターの障害や再起動が他のテレメトリーを止めることはありません。

01

デバイス

インバーターまたは BMS がプロトコルを通じてデータを公開します。

02

ドライバー

プロトコル、レジスター、スケール、メトリクスを定義します。

03

コレクター

各デバイスを分離された制御可能なプロセスで読み取ります。

04

パネル

テレメトリー、履歴、アラーム、予測をまとめます。

04ドライバー

機器と HelioPulse の間の翻訳者。

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

実行コードなし

パッケージはデータを記述するだけで、任意のバイナリーをシステムにインストールしません。

保存前に検証

バックエンドはファイルを受け付ける前に構造、プロトコル、レジスターを確認します。

再利用可能

同じドライバーを複数の互換デバイスで使えます。

05ドライバーを作成

Modbus マップから始める。

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

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

デバイスを登録

device ID、ドライバー、永続的な by-id ポート、1〜247 の slave ID を設定します。

手順 3

collector を起動

そのデバイスだけを起動または再起動し、テレメトリーが有効になったことを確認します。

管理された置き換え

同じ ID の別ファイルをアップロードするとドライバーが更新されます。関連デバイスを再起動して新しい定義を適用します。

07リリース展望

これからの予定。

このページではプロジェクトの現在の方向性を示します。技術検証と現場テストにより範囲や順序は変わる可能性があります。

v1.7提供中

インテリジェントなローカル基盤

  • マルチインバーターとパネルドライバー
  • ローカル AI モデルによるレポート
  • 履歴、診断、予測
v1.8予定

ドライバーエコシステム

  • マーケットプレイスと検証可能なカタログ
  • 互換性とドライバーバージョン
  • テストと公開フロー
  • インバーターと BMS ドライバーの拡充
v1.9検討中

信頼性の高い高度な運用

  • 可観測性とガイド付きメンテナンスの拡充
  • 多言語対応と一貫性の拡大
  • インバーター、BMS、シャント間のバッテリー読み取り高度検証
  • メーカー別アラームデコードと複数アクション自動化の強化
将来方向性

マルチサイトとエージェント

  • 1台の主 Raspberry Pi が設備を統括
  • 別の Raspberry Pi または ESP32 の収集エージェント
  • クラウドバックアップ
  • 複数設備の管理
  • Grafana 連携によるカスタムダッシュボード
  • ユーザーが設定できる複数チャネルのリアルタイム通知

インストールの準備はできましたか?

安定版をダウンロードするか、ソースコードとプロジェクトの進化を確認してください。

リリース
はじめに:Raspberry Pi に HelioPulse をインストール | HelioPulse