From an empty Raspberry Pi to your first energy reading.

Prepare the appliance.

HelioPulse OS is a Linux image for Raspberry Pi designed for local energy monitoring.

1. 1

   Download the stable release

   Get the image and review the release notes from the public releases repository.

   View all releases
2. 2

   Flash the image

   Use Raspberry Pi Imager or an equivalent tool. Select the downloaded file and the destination SSD or microSD.

3. 3

   Connect and power on

   Connect storage, network, USB–RS485 adapter and the official power supply suitable for your Raspberry Pi.

Configure from your browser.

On first boot the appliance opens a captive portal from your browser: connect Wi-Fi, create your administrator and finish. No SSH, no cables to your computer.

1. 1

   Insert the card and power on

   Put the flashed microSD into the Raspberry Pi and connect the power. The first boot expands the system and starts HelioPulse; give it a minute.

2. 2

   Join the HelioPulse network

   From your phone or laptop, connect to the temporary Wi-Fi network the device creates. The setup portal opens automatically in your browser; if it does not, open the address shown on screen.

3. 3

   1. Connect to the Internet

   Pick your home Wi-Fi and enter its password, or choose to continue with a network cable. The signal strength helps you find the right network.

4. 4

   2. Create your administrator

   Set the username and password (at least 8 characters) you will use to sign in to the panel. Keep them safe: this is your administrator account.

5. 5

   Optional: enable remote access

   If your device supports it, pick a name to reach the panel securely over the Internet. Local access always keeps working, so you can skip this step.

6. 6

   3. Ready to use

   The portal confirms setup is complete and shows the panel address. Reconnect to your usual network and open it to sign in with the account you created.

1. Connect to the Internet

Pick your Wi-Fi network (or continue with a network cable).

2. Create your administrator

Set the credentials you will use to sign in to the panel.

3. Ready to use

Reconnect to your usual network and open the panel address shown.

A local, modular platform.

Each device has an independent collector. A failure or restart in one inverter does not interrupt telemetry from the others.

The translator between your device and HelioPulse.

A driver is a declarative JSON file. It defines how to communicate over Modbus RTU and convert manufacturer registers into common HelioPulse metrics.

Start with the Modbus map.

You need the manufacturer's protocol manual and verified readings from a real device. The minimum schema requires an identifier, modbus_rtu protocol and at least one group with one register.

{
  "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
    }]
  }]
}

Activate it without SSH.