modbus_inverter v1.0.5

Modbus Inverter

This module is based on the SMA_Modbus module. Module

Changes

V1.0.3

• add method
  • getInverterStatus
  • getRecommendedAction
  • getOperatingCondition
  • getCurrentPower_L1_L2_L3

V1.0.2

• change Package name to Modbus Inverter V1.0.1
• add method getHealthStatus for SMA Sunny Tripower 8.0 (testet) V1.0.0
• changed function "readModbus" to "readModbusHR" for Holding Registers
• add function "readModbusIR" for Inputregisters
• ClientID / SlaveID switched to SMA Object, you can declare at create Object
• add SMA Sunny Tripower 8.0 Profil

Next Steps

• integrate in ioBroker Adapter

Introduction

The module provides easy access to the data provided by SMA devices with ModBus support.

It automatically establishes a new connection on disconnect, and parses incoming byte data to their respective format.

Typescript definitions are included out-of-the-box.

Usage

Common requests are included for some devices, such as:

• current battery percentage of Sunny Island devices
• power of Sunny Boy devices
• total production of Sunny Boy devices
• etc.

If more advanced requests are required, the library provides a easy method to access all registers with automatic data parsing.

The register values can be found on SMAs website under "Downloads" -> "Technical Information" -> "Modbus Interface". An Excel file containing all registers with datatype and description can be downloaded.

Examples

// require or import can be used to acquire the package
const SMA = require('sma_modbus');
let sunnyIsland = new SMA.SunnyIsland("192.168.188.60", 502);
sunnyIsland.getPower().then((x) => {
        console.log("Power: " + x + " W");
});

// Modbus addresses and datatypes can be found in the SMA docs
sunnyIsland.readModbus(40073, SMA.ModbusDatatype.uint16).then((x) => {
    console.log("Interface speed: " + x + " Mb/s");
});