Skip to content

givenergy-modbus / Gen2Snapshot

Interface: Gen2Snapshot

Defined in: src/model/inverter-snapshot.ts:184

Extends

  • BaseSnapshot

Properties

batteries

batteries: BatterySnapshot[]

Defined in: src/model/inverter-snapshot.ts:178

Inherited from

BaseSnapshot.batteries


batteryChargeEnergyTodayKwh

batteryChargeEnergyTodayKwh: number

Defined in: src/model/inverter-snapshot.ts:140

Battery charge energy today in kWh — e_battery_charge_today IR(36) via toDeci

Inherited from

BaseSnapshot.batteryChargeEnergyTodayKwh


batteryChargeEnergyTotalKwh

batteryChargeEnergyTotalKwh: number

Defined in: src/model/inverter-snapshot.ts:116

Total battery charge energy in kWh

Inherited from

BaseSnapshot.batteryChargeEnergyTotalKwh


batteryCurrent

batteryCurrent: number

Defined in: src/model/inverter-snapshot.ts:83

Battery current in A from IR(51) via toInt16 then toCenti

Inherited from

BaseSnapshot.batteryCurrent


batteryDischargeEnergyTodayKwh

batteryDischargeEnergyTodayKwh: number

Defined in: src/model/inverter-snapshot.ts:142

Battery discharge energy today in kWh — e_battery_discharge_today IR(37) via toDeci

Inherited from

BaseSnapshot.batteryDischargeEnergyTodayKwh


batteryDischargeEnergyTotalKwh

batteryDischargeEnergyTotalKwh: number

Defined in: src/model/inverter-snapshot.ts:118

Total battery discharge energy in kWh

Inherited from

BaseSnapshot.batteryDischargeEnergyTotalKwh


batteryPower

batteryPower: number

Defined in: src/model/inverter-snapshot.ts:49

Battery power as seen by the inverter's DC bus (IR 52, signed int16). Positive = discharging into the house, negative = charging from solar/grid.

This is the system-wide battery power. For per-module detail, see BatterySnapshot — though note that individual battery modules don't report their own power directly.

Inherited from

BaseSnapshot.batteryPower


batteryReservePercent

batteryReservePercent: number

Defined in: src/model/inverter-snapshot.ts:165

Minimum SOC the inverter will discharge to (4-100%), from HR(110) or HR(1109) for three-phase

Inherited from

BaseSnapshot.batteryReservePercent


batteryTemperature

batteryTemperature: number

Defined in: src/model/inverter-snapshot.ts:110

Battery temperature in °C from IR(56) via toDeci — a single reading from the inverter's sensor

Inherited from

BaseSnapshot.batteryTemperature


batteryThroughputTotalKwh

batteryThroughputTotalKwh: number

Defined in: src/model/inverter-snapshot.ts:126

Total battery throughput in kWh — uint32 IR(6,7) via toDeci

Inherited from

BaseSnapshot.batteryThroughputTotalKwh


batteryVoltage

batteryVoltage: number

Defined in: src/model/inverter-snapshot.ts:81

Battery voltage in V from IR(50) via toCenti — measured at the inverter's DC bus

Inherited from

BaseSnapshot.batteryVoltage


chargeRatePercent

chargeRatePercent: number

Defined in: src/model/inverter-snapshot.ts:167

Battery charge rate AC limit (0-100%), from HR(313) or HR(1110) for three-phase

Inherited from

BaseSnapshot.chargeRatePercent


chargerTemperature

chargerTemperature: number

Defined in: src/model/inverter-snapshot.ts:108

Charger temperature in °C from IR(55) via toDeci — labeled "BMS Temperature" in the GivEnergy cloud CSV

Inherited from

BaseSnapshot.chargerTemperature


chargeSlots

chargeSlots: TimeSlot[]

Defined in: src/model/inverter-snapshot.ts:187

Charge timeslots — start/end only, no per-slot target state of charge


chargeTargetStateOfCharge

chargeTargetStateOfCharge: number

Defined in: src/model/inverter-snapshot.ts:155

Legacy charge target SOC % from HR(116) — applies to slot 1 on Gen2

Inherited from

BaseSnapshot.chargeTargetStateOfCharge


consumptionEnergyTodayKwh

consumptionEnergyTodayKwh: number

Defined in: src/model/inverter-snapshot.ts:148

Consumption energy today in kWh — derived: (inverter_out_day - ac_charge_day) - (export_day - import_day)

Inherited from

BaseSnapshot.consumptionEnergyTodayKwh


consumptionEnergyTotalKwh

consumptionEnergyTotalKwh: number

Defined in: src/model/inverter-snapshot.ts:124

Total consumption energy in kWh — derived: (inverter_out - ac_charge) - (export - import)

Inherited from

BaseSnapshot.consumptionEnergyTotalKwh


dischargeRatePercent

dischargeRatePercent: number

Defined in: src/model/inverter-snapshot.ts:169

Battery discharge rate AC limit (0-100%), from HR(314) or HR(1108) for three-phase

Inherited from

BaseSnapshot.dischargeRatePercent


dischargeSlots

dischargeSlots: TimeSlot[]

Defined in: src/model/inverter-snapshot.ts:189

Discharge timeslots — start/end only, no per-slot target state of charge


enableCharge

enableCharge: boolean

Defined in: src/model/inverter-snapshot.ts:151

Enable charge flag from HR(96)

Inherited from

BaseSnapshot.enableCharge


enableDischarge

enableDischarge: boolean

Defined in: src/model/inverter-snapshot.ts:153

Enable discharge flag from HR(59)

Inherited from

BaseSnapshot.enableDischarge


epsBackupFrequency

epsBackupFrequency: number

Defined in: src/model/inverter-snapshot.ts:97

EPS backup frequency in Hz from IR(54) via toCenti

Inherited from

BaseSnapshot.epsBackupFrequency


epsBackupPower

epsBackupPower: number

Defined in: src/model/inverter-snapshot.ts:59

EPS backup output power in watts (IR 31)

Inherited from

BaseSnapshot.epsBackupPower


epsBackupVoltage

epsBackupVoltage: number

Defined in: src/model/inverter-snapshot.ts:95

EPS backup voltage in V from IR(53) via toDeci

Inherited from

BaseSnapshot.epsBackupVoltage


generation

generation: "gen2"

Defined in: src/model/inverter-snapshot.ts:185


gridApparentPower

gridApparentPower: number

Defined in: src/model/inverter-snapshot.ts:57

Grid apparent power in VA (IR 43)

Inherited from

BaseSnapshot.gridApparentPower


gridExportEnergyTodayKwh

gridExportEnergyTodayKwh: number

Defined in: src/model/inverter-snapshot.ts:146

Grid export energy today in kWh — e_grid_out_day IR(25) via toDeci

Inherited from

BaseSnapshot.gridExportEnergyTodayKwh


gridExportEnergyTotalKwh

gridExportEnergyTotalKwh: number

Defined in: src/model/inverter-snapshot.ts:122

Total grid export energy in kWh — uint32 IR(21,22) via toDeci

Inherited from

BaseSnapshot.gridExportEnergyTotalKwh


gridFrequency

gridFrequency: number

Defined in: src/model/inverter-snapshot.ts:89

AC grid frequency in Hz from IR(13), with firmware scaling applied

Inherited from

BaseSnapshot.gridFrequency


gridImportEnergyTodayKwh

gridImportEnergyTodayKwh: number

Defined in: src/model/inverter-snapshot.ts:144

Grid import energy today in kWh — e_grid_in_day IR(26) via toDeci

Inherited from

BaseSnapshot.gridImportEnergyTodayKwh


gridImportEnergyTotalKwh

gridImportEnergyTotalKwh: number

Defined in: src/model/inverter-snapshot.ts:120

Total grid import energy in kWh — uint32 IR(32,33) via toDeci

Inherited from

BaseSnapshot.gridImportEnergyTotalKwh


gridPower

gridPower: number

Defined in: src/model/inverter-snapshot.ts:51

Grid power: positive = export, negative = import (IR 30, signed int16)

Inherited from

BaseSnapshot.gridPower


gridVoltage

gridVoltage: number

Defined in: src/model/inverter-snapshot.ts:87

AC grid voltage in V from IR(5) via toDeci

Inherited from

BaseSnapshot.gridVoltage


hoursOfOperation

hoursOfOperation: number

Defined in: src/model/inverter-snapshot.ts:130

Total hours of operation — uint32 IR(47,48)

Inherited from

BaseSnapshot.hoursOfOperation


inverterCurrent

inverterCurrent: number

Defined in: src/model/inverter-snapshot.ts:91

Inverter AC current in A from IR(10) via toDeci

Inherited from

BaseSnapshot.inverterCurrent


inverterHeatsinkTemp

inverterHeatsinkTemp: number

Defined in: src/model/inverter-snapshot.ts:106

Inverter heatsink temperature in °C from IR(41) via toDeci

Inherited from

BaseSnapshot.inverterHeatsinkTemp


inverterOutputPower

inverterOutputPower: number

Defined in: src/model/inverter-snapshot.ts:55

Inverter AC output power in watts (IR 24, signed int16)

Inherited from

BaseSnapshot.inverterOutputPower


loadPower

loadPower: number

Defined in: src/model/inverter-snapshot.ts:53

Load demand in watts (IR 42)

Inherited from

BaseSnapshot.loadPower


meters

meters: MeterSnapshot[]

Defined in: src/model/inverter-snapshot.ts:181

Inherited from

BaseSnapshot.meters


mode

mode: InverterMode

Defined in: src/model/inverter-snapshot.ts:163

Operating mode derived from HR(27) and HR(59):

  • 'eco': HR(27)=1, HR(59)=0 — battery charges from solar only, discharges to meet load
  • 'timed_demand': HR(27)=1, HR(59)=1 — battery charges/discharges on schedule
  • 'timed_export': HR(27)=0, HR(59)=1 — battery discharges to grid on schedule

Inherited from

BaseSnapshot.mode


modelCode

modelCode: number

Defined in: src/model/inverter-snapshot.ts:32

Raw device type code from HR(0) — encodes model family and generation

Inherited from

BaseSnapshot.modelCode


powerFlows

powerFlows: PowerFlows

Defined in: src/model/inverter-snapshot.ts:175

Inherited from

BaseSnapshot.powerFlows


pvEnergyTodayKwh

pvEnergyTodayKwh: number

Defined in: src/model/inverter-snapshot.ts:134

PV energy generated today in kWh — sum of both strings: e_pv1_day IR(17) + e_pv2_day IR(19)

Inherited from

BaseSnapshot.pvEnergyTodayKwh


pvEnergyTotalKwh

pvEnergyTotalKwh: number

Defined in: src/model/inverter-snapshot.ts:114

Total PV energy generated in kWh — uint32 IR(11,12) via toDeci

Inherited from

BaseSnapshot.pvEnergyTotalKwh


pvString1Current

pvString1Current: number

Defined in: src/model/inverter-snapshot.ts:67

PV string 1 current in A (IR 8, toDeci)

Inherited from

BaseSnapshot.pvString1Current


pvString1EnergyTodayKwh

pvString1EnergyTodayKwh: number

Defined in: src/model/inverter-snapshot.ts:136

PV string 1 energy generated today in kWh — e_pv1_day IR(17) via toDeci

Inherited from

BaseSnapshot.pvString1EnergyTodayKwh


pvString1Power

pvString1Power: number

Defined in: src/model/inverter-snapshot.ts:38

PV string 1 power in watts (IR 18) — one of the two DC inputs on the inverter

Inherited from

BaseSnapshot.pvString1Power


pvString1Voltage

pvString1Voltage: number

Defined in: src/model/inverter-snapshot.ts:63

PV string 1 voltage in V (IR 1, toDeci)

Inherited from

BaseSnapshot.pvString1Voltage


pvString2Current

pvString2Current: number

Defined in: src/model/inverter-snapshot.ts:69

PV string 2 current in A (IR 9, toDeci)

Inherited from

BaseSnapshot.pvString2Current


pvString2EnergyTodayKwh

pvString2EnergyTodayKwh: number

Defined in: src/model/inverter-snapshot.ts:138

PV string 2 energy generated today in kWh — e_pv2_day IR(19) via toDeci

Inherited from

BaseSnapshot.pvString2EnergyTodayKwh


pvString2Power

pvString2Power: number

Defined in: src/model/inverter-snapshot.ts:40

PV string 2 power in watts (IR 20) — the second DC input on the inverter

Inherited from

BaseSnapshot.pvString2Power


pvString2Voltage

pvString2Voltage: number

Defined in: src/model/inverter-snapshot.ts:65

PV string 2 voltage in V (IR 2, toDeci)

Inherited from

BaseSnapshot.pvString2Voltage


serialNumber

serialNumber: string

Defined in: src/model/inverter-snapshot.ts:30

10-character inverter serial number from HR(13-17)

Inherited from

BaseSnapshot.serialNumber


solarPower

solarPower: number

Defined in: src/model/inverter-snapshot.ts:36

Total solar generation: p_pv1 (IR 18) + p_pv2 (IR 20)

Inherited from

BaseSnapshot.solarPower


stateOfCharge

stateOfCharge: number

Defined in: src/model/inverter-snapshot.ts:79

State of charge 0-100% from IR(59), with fallback applied

Inherited from

BaseSnapshot.stateOfCharge


systemTime

systemTime: Date

Defined in: src/model/inverter-snapshot.ts:172

Inherited from

BaseSnapshot.systemTime