Skip to content

givenergy-modbus / Gen2Snapshot

Interface: Gen2Snapshot

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

Extends

  • BaseSnapshot

Properties

batteries

batteries: BatterySnapshot[]

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

Inherited from

BaseSnapshot.batteries


batteryChargeEnergyTodayKwh

batteryChargeEnergyTodayKwh: number

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

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:122

Total battery charge energy in kWh

Inherited from

BaseSnapshot.batteryChargeEnergyTotalKwh


batteryCurrent

batteryCurrent: number

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

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:148

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:124

Total battery discharge energy in kWh

Inherited from

BaseSnapshot.batteryDischargeEnergyTotalKwh


batteryPower

batteryPower: number

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

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:172

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:116

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:132

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:87

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:174

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:114

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:194

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


chargeTargetStateOfCharge

chargeTargetStateOfCharge: number

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

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:154

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:130

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:176

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:196

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


ecoMode

ecoMode: boolean

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

Eco mode toggle from HR(27). When enabled, battery charges from solar only and discharges to meet load.

Inherited from

BaseSnapshot.ecoMode


epsBackupFrequency

epsBackupFrequency: number

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

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

Inherited from

BaseSnapshot.epsBackupFrequency


epsBackupPower

epsBackupPower: number

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

EPS backup output power in watts (IR 31)

Inherited from

BaseSnapshot.epsBackupPower


epsBackupVoltage

epsBackupVoltage: number

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

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

Inherited from

BaseSnapshot.epsBackupVoltage


generation

generation: "gen2"

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


gridApparentPower

gridApparentPower: number

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

Grid apparent power in VA (IR 43)

Inherited from

BaseSnapshot.gridApparentPower


gridExportEnergyTodayKwh

gridExportEnergyTodayKwh: number

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

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:128

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:95

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:150

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:126

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:57

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

Inherited from

BaseSnapshot.gridPower


gridVoltage

gridVoltage: number

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

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

Inherited from

BaseSnapshot.gridVoltage


hoursOfOperation

hoursOfOperation: number

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

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

Inherited from

BaseSnapshot.hoursOfOperation


inverterCurrent

inverterCurrent: number

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

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

Inherited from

BaseSnapshot.inverterCurrent


inverterHeatsinkTemp

inverterHeatsinkTemp: number

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

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

Inherited from

BaseSnapshot.inverterHeatsinkTemp


inverterOutputPower

inverterOutputPower: number

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

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

Inherited from

BaseSnapshot.inverterOutputPower


loadPower

loadPower: number

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

Load demand in watts (IR 42)

Inherited from

BaseSnapshot.loadPower


meters

meters: MeterSnapshot[]

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

Inherited from

BaseSnapshot.meters


modelCode

modelCode: number

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

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:182

Inherited from

BaseSnapshot.powerFlows


pvEnergyTodayKwh

pvEnergyTodayKwh: number

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

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:120

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:73

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

Inherited from

BaseSnapshot.pvString1Current


pvString1EnergyTodayKwh

pvString1EnergyTodayKwh: number

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

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:44

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:69

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

Inherited from

BaseSnapshot.pvString1Voltage


pvString2Current

pvString2Current: number

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

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

Inherited from

BaseSnapshot.pvString2Current


pvString2EnergyTodayKwh

pvString2EnergyTodayKwh: number

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

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:46

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:71

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

Inherited from

BaseSnapshot.pvString2Voltage


serialNumber

serialNumber: string

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

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

Inherited from

BaseSnapshot.serialNumber


solarPower

solarPower: number

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

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:85

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:179

Inherited from

BaseSnapshot.systemTime


timedCharge

timedCharge: boolean

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

Timed charge toggle from HR(96) — enables charge schedule slots

Inherited from

BaseSnapshot.timedCharge


timedExport

timedExport: boolean

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

Timed export toggle from HR(59). When enabled, battery discharges to grid on schedule. Independent of eco mode — both can be on simultaneously.

Inherited from

BaseSnapshot.timedExport