Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
39 commits
Select commit Hold shift + click to select a range
c7d2b11
fix: make battery sign conventions consistent
nikitug Feb 20, 2026
365a1b2
fix: add throttled status to inverter status enum
nikitug Feb 23, 2026
9f49102
fix: add convention about `status` telemetry use
nikitug Feb 23, 2026
5d4db3b
docs: add /sensor directory to README repository structure
nikitug Feb 23, 2026
9d3b652
fix: correct typo "Configutaion" in grid charge enabled display_name
nikitug Feb 23, 2026
809ddff
fix: revise gas_lel description to accurately describe explosive conc…
nikitug Feb 23, 2026
38ea6ba
fix: remove redundant "Profile" suffix from inverter, firmware, and l…
nikitug Feb 23, 2026
fc7ca07
fix: change residual_current unit to mA and add UCUM deg unit to coor…
nikitug Feb 23, 2026
9883023
docs: clarify sign convention for bidirectional vs unidirectional power
nikitug Feb 23, 2026
c4e038f
fix: use accurate ac_frequency description for inverters and power me…
nikitug Feb 23, 2026
4e357f6
fix: clarify inverter_nameplate_capacity is apparent power in VA
nikitug Feb 23, 2026
b0ab209
fix: align pv_energy_total description to say "since installation"
nikitug Feb 23, 2026
f198050
fix: improve vague device profile descriptions for battery and pv_cha…
nikitug Feb 23, 2026
784cf9f
fix: note that negative load_total_power is possible but uncommon
nikitug Feb 23, 2026
fcf600d
docs: remove battery chemistry reference
nikitug Feb 23, 2026
ddc02fe
feat: clarify Wh/Ah and W/A unit conventions for battery profiles
nikitug Feb 24, 2026
1af338a
docs: add versioning section to README
nikitug Feb 24, 2026
f0accfa
fix: correct grammar in power meter descriptions
nikitug Feb 24, 2026
8bcdba8
fix: add missing descriptions to library profiles
nikitug Feb 24, 2026
302ad15
fix: add missing trailing periods to descriptions
nikitug Feb 24, 2026
afee76e
fix: add missing unit to power factor telemetry attributes
nikitug Feb 24, 2026
279bba3
fix: remove "profile" word from sensor profile descriptions
nikitug Feb 24, 2026
2890639
feat: add deviec status guide
nikitug Mar 3, 2026
bdc58b2
Restructure README
nikitug Mar 6, 2026
89c0908
fix: Small fixes to profiles based on README/guide
nikitug Mar 9, 2026
2d7e7d4
fix: move hydrogen sensor
nikitug Mar 9, 2026
5ca6401
fix: add BMS status
nikitug Mar 9, 2026
453264f
fix: move pv.stats.energy to pv.energy
nikitug Mar 9, 2026
0efb0ae
fix: change PV string architecture
nikitug Mar 10, 2026
6ea53c5
fix: use lifetime term instead of total
nikitug Mar 10, 2026
a0a3b95
fix: today/daily naming change
nikitug Mar 10, 2026
2e2bafd
fix: fix inverter prefix
nikitug Mar 10, 2026
0d9445e
fix: add missing description to grid_status telemetry field
nikitug Mar 10, 2026
64a7ce0
fix: document why stopping is omitted from battery_status
nikitug Mar 10, 2026
3f91b54
fix: use integer type for battery_nameplate_capacity
nikitug Mar 10, 2026
35b6f6e
fix: clarify timezone for daily energy fields
nikitug Mar 10, 2026
9b0b25d
fix: rename battery charge/energy to charge/lifetime and energy/lifetime
nikitug Mar 10, 2026
6b83839
fix: small naming issues
nikitug Mar 10, 2026
4a2ccf0
feat: add charge controller status
nikitug Mar 10, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
202 changes: 130 additions & 72 deletions README.md

Large diffs are not rendered by default.

6 changes: 4 additions & 2 deletions energy/battery.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,12 @@
blueprint_spec: profile/1.0

display_name: Battery/BMS Profile
description: A profile for battery and battery management systems
display_name: Battery/BMS
description: A profile for battery systems and battery management systems (BMS). Covers state of charge, charge/discharge power and current, and nameplate attributes. Suitable for standalone battery banks and integrated BESS units.

implements:
- lib.device.nameplate
- lib.energy.battery.charge_status
- lib.energy.battery.electrical
- lib.energy.battery.nameplate
- lib.energy.battery.soc
- lib.energy.battery.status
3 changes: 2 additions & 1 deletion energy/battery_inverter/1_phase.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
blueprint_spec: profile/1.0

display_name: Single-Phase Battery Inverter
description: A single-phase battery inverter profile combining all relevant capabilities
description: A profile for single-phase battery inverters (off-grid and grid-tied). Covers battery state of charge and charge/discharge power, AC output measurements, grid import/export and load power, operational status, and nameplate attributes.

implements:
- lib.device.nameplate
- lib.energy.battery.charge_status
- lib.energy.battery.electrical
- lib.energy.battery.nameplate
- lib.energy.battery.soc
Expand Down
3 changes: 2 additions & 1 deletion energy/battery_inverter/3_phase.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
blueprint_spec: profile/1.0

display_name: Three-Phase Battery Inverter
description: A three-phase battery inverter profile combining all relevant capabilities
description: A profile for three-phase battery inverters (off-grid and grid-tied). Covers battery state of charge and charge/discharge power, AC output measurements, grid import/export and load power, operational status, and nameplate attributes.

implements:
- lib.device.nameplate
- lib.energy.battery.charge_status
- lib.energy.battery.electrical
- lib.energy.battery.nameplate
- lib.energy.battery.soc
Expand Down
3 changes: 2 additions & 1 deletion energy/hybrid_inverter/1_phase.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
blueprint_spec: profile/1.0

display_name: Single-Phase Hybrid Inverter
description: A single-phase hybrid inverter profile combining battery and PV capabilities
description: A profile for single-phase hybrid inverters with integrated PV input and battery management. Covers PV input power, battery state of charge and power, AC output measurements, grid and load power, operational status, and nameplate attributes.

implements:
- lib.device.nameplate
- lib.energy.battery.charge_status
- lib.energy.battery.electrical
- lib.energy.battery.nameplate
- lib.energy.battery.soc
Expand Down
3 changes: 2 additions & 1 deletion energy/hybrid_inverter/3_phase.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
blueprint_spec: profile/1.0

display_name: Three-Phase Hybrid Inverter
description: A three-phase hybrid inverter profile combining battery and PV capabilities
description: A profile for three-phase hybrid inverters with integrated PV input and battery management. Covers PV input power, battery state of charge and power, AC output measurements, grid and load power, operational status, and nameplate attributes.

implements:
- lib.device.nameplate
- lib.energy.battery.charge_status
- lib.energy.battery.electrical
- lib.energy.battery.nameplate
- lib.energy.battery.soc
Expand Down
4 changes: 2 additions & 2 deletions energy/power_meter/ac/1_phase.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
blueprint_spec: profile/1.0

display_name: Single-Phase Power Meter
description: A single-phase power meter profile
description: A profile for single-phase AC power meters. Covers voltage, current, power, and cumulative energy consumption.

implements:
- lib.device.nameplate
- lib.energy.power_meter.ac.1_phase
- lib.energy.power_meter.energy.total
- lib.energy.power_meter.energy.lifetime
- lib.energy.power_meter.power
4 changes: 2 additions & 2 deletions energy/power_meter/ac/3_phase.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
blueprint_spec: profile/1.0

display_name: Three-Phase Power Meter
description: A three-phase power meter profile
description: A profile for three-phase AC power meters. Covers per-phase and total voltage, current, power, and cumulative energy consumption.

implements:
- lib.device.nameplate
- lib.energy.power_meter.ac.3_phase
- lib.energy.power_meter.energy.total
- lib.energy.power_meter.energy.lifetime
- lib.energy.power_meter.power
4 changes: 3 additions & 1 deletion energy/pv_charge_controller.yml
Original file line number Diff line number Diff line change
@@ -1,11 +1,13 @@
blueprint_spec: profile/1.0

display_name: PV Charge Controller
description: A profile for PV charge controllers
description: A profile for solar charge controllers (MPPT and PWM). Covers PV input power, battery state of charge, charge/discharge current, battery nameplate attributes, and operational status.

implements:
- lib.device.nameplate
- lib.energy.battery.charge_status
- lib.energy.battery.electrical
- lib.energy.battery.nameplate
- lib.energy.battery.soc
- lib.energy.charge_controller.status
- lib.energy.pv.power
2 changes: 1 addition & 1 deletion energy/pv_inverter/1_phase.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
blueprint_spec: profile/1.0

display_name: Single-Phase PV Inverter
description: A single-phase PV inverter profile combining all relevant capabilities
description: A profile for single-phase grid-tied PV inverters. Covers PV input power, AC output voltage/current/power, total AC power, operational status, and nameplate capacity.

implements:
- lib.device.nameplate
Expand Down
2 changes: 1 addition & 1 deletion energy/pv_inverter/3_phase.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
blueprint_spec: profile/1.0

display_name: Three-Phase PV Inverter
description: A three-phase PV inverter profile combining all relevant capabilities
description: A profile for three-phase grid-tied PV inverters. Covers PV input power, per-phase and total AC output power, operational status, and nameplate capacity.

implements:
- lib.device.nameplate
Expand Down
Loading