Shared setups

Shared setups

Ready-made field mappings for inverter, battery and energy-monitor integrations. Paste one into Configure → Import configuration instead of mapping every sensor by hand. No setup contains an API key or system ID: an export never does.

Setups are kept in setups/ in the repository, where the tests check that each one imports cleanly, and are listed below.

Setups in the repository

Integration	Hardware	File
Sigenergy Local Modbus (TypQxQ)	Sigenergy SigenStor	sigenergy-modbus.yaml: lifetime counters, battery fields b1-b5
Sigenergy Local Modbus (TypQxQ)	Sigenergy SigenStor	sigenergy-modbus-extended.yaml: daily counters, battery and grid in extended fields v7-v12 (live example)

Open the file, use Raw to copy it, and paste it into Import configuration.

Using a setup

1. Copy the YAML of your integration below (or from setups/).
2. Settings → Devices & services → PVOutput Uploader → Configure → Import configuration, paste it, and choose:
   • Add the fields not configured yet keeps what you have and adds the rest; Replace all fields starts from the setup.
   • Also take its settings only if you want the setup's upload interval and history settings too.
3. Sensors with other names on your installation are listed on the next screen: pick yours for each. A field left empty is skipped.
4. Check the device page: each field sensor shows its source and unit.

Extended (v7-v12) and battery (b1-b6) fields need a PVOutput donor account.

Sharing yours

1. Configure → Export configuration, copy the YAML.
2. Open a Share a setup issue and paste it. The form asks for the integration and its version, your hardware, and anything others should know. The setup is then added to the repository and listed above. No fork or pull request needed.

Familiar with GitHub? A pull request adding setups/<integration>-<variant>.yaml works too; see the setups README.

Prefer the integration's default entity IDs, so most sensors are found without picking. See Mapping your sensors for what each field expects.

---

Example: hybrid inverter with a battery

A template showing the format; replace the entity IDs with your integration's.

pvoutput_uploader: 1
fields:
  - field: v1
    sensor: sensor.inverter_pv_energy_today
    name: Energy Generation
    value_per_interval: energy_today
  - field: v2
    sensor: sensor.inverter_pv_power
    name: Power Generation
  - field: v3
    sensor: sensor.inverter_load_energy_today
    name: Energy Consumption
    value_per_interval: energy_today
  - field: v4
    sensor: sensor.inverter_load_power
    name: Power Consumption
  - field: v6
    sensor: sensor.inverter_grid_voltage
    name: Voltage
  - field: b1
    sensor: sensor.battery_power
    name: Battery Power
  - field: b2
    sensor: sensor.battery_state_of_charge
    name: Battery State of Charge
    value_per_interval: last
  - field: b3
    constant: 10000
    name: Battery Size