givenergy-modbus

givenergy-modbusGivEnergy Inverter Client

Native Node.js library for local Modbus TCP communication — no cloud required

Getting Started

Real-time Monitoring

Poll solar, battery, and grid power every 15 seconds with automatic push-mode data collection from the inverter.

Inverter Control

Set operating modes, charge/discharge schedules, battery reserves, and rate limits with type-safe methods per generation.

Auto-discovery

Find GivEnergy inverters on your local network automatically. Detects Gen2, Gen3, and three-phase models.

Install

bash

npm install givenergy-modbus

Requires Node.js 20+. TypeScript types included.

Quick Example

ts

import { GivEnergyInverter } from 'givenergy-modbus';

const inverter = await GivEnergyInverter.connect({ host: '192.168.1.100' });

inverter.on('data', (snapshot) => {
  console.log(`Solar: ${snapshot.solarPower}W`);
  console.log(`Battery: ${snapshot.stateOfCharge}%`);
  console.log(`Grid: ${snapshot.gridPower}W`);
});