@enyo-energy/sunspec-sdk 0.0.32 → 0.0.34

package/dist/sunspec-devices.js

@@ -1,23 +1,13 @@
-import { SunspecBatteryChargeState, SunspecModelId, SunspecMPPTOperatingState, SunspecStorageMode } from "./sunspec-interfaces.js";
+import { SunspecBatteryChargeState, SunspecModelId, SunspecMPPTOperatingState, SunspecStorageMode, SunspecInverterCapability } from "./sunspec-interfaces.js";
 import { randomUUID } from "node:crypto";
 import { EnyoApplianceConnectionType, EnyoApplianceStateEnum, EnyoApplianceTopologyFeatureEnum, EnyoApplianceTypeEnum } from "@enyo-energy/energy-app-sdk/dist/types/enyo-appliance.js";
+import { ConnectionRetryManager } from "./connection-retry-manager.js";
 import { EnyoBatteryStateEnum, EnyoCommandAcknowledgeAnswerEnum, EnyoDataBusMessageEnum, EnyoInverterStateEnum, EnyoStringStateEnum } from "@enyo-energy/energy-app-sdk/dist/types/enyo-data-bus-value.js";
 import { EnyoSourceEnum } from "@enyo-energy/energy-app-sdk/dist/types/enyo-source.enum.js";
 import { EnyoMeterApplianceAvailableFeaturesEnum } from "@enyo-energy/energy-app-sdk/dist/types/enyo-meter-appliance.js";
 import { EnyoBatteryFeature, EnyoBatteryStorageMode } from "@enyo-energy/energy-app-sdk/dist/types/enyo-battery-appliance.js";
-/**
- * Extract battery discharge power from MPPT data.
- * Returns the discharge power in Watts (positive value), or 0 if no discharge.
- */
-function extractBatteryDischargePowerFromMPPT(mpptDataList) {
-    let dischargePowerW = 0;
-    for (const mppt of mpptDataList) {
-        if (mppt.stringId === 'StDisCha 4' && mppt.dcPower !== undefined && mppt.dcPower > 0) {
-            dischargePowerW += mppt.dcPower;
-        }
-    }
-    return dischargePowerW;
-}
+// TODO: Remove once added to @enyo-energy/energy-app-sdk EnyoDataBusMessageEnum
+export const ENYO_DATA_BUS_SET_INVERTER_FEED_IN_LIMIT_V1 = 'SetInverterFeedInLimitV1';
 /**
  * Base abstract class for all Sunspec devices
  */
@@ -32,7 +22,10 @@ export class BaseSunspecDevice {
     baseAddress;
     applianceId;
     lastUpdateTime = 0;
-    constructor(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId = 1, port = 502, baseAddress = 40000) {
+    dataBusListenerId;
+    dataBus;
+    retryManager;
+    constructor(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId = 1, port = 502, baseAddress = 40000, retryConfig) {
         this.energyApp = energyApp;
         this.name = name;
         this.networkDevice = networkDevice;
@@ -41,6 +34,7 @@ export class BaseSunspecDevice {
         this.unitId = unitId;
         this.port = port;
         this.baseAddress = baseAddress;
+        this.retryManager = new ConnectionRetryManager(retryConfig);
     }
     /**
      * Check if the device is connected
@@ -62,11 +56,86 @@ export class BaseSunspecDevice {
             await this.sunspecClient.discoverModels(this.baseAddress);
         }
     }
+    /**
+     * Attempt a reconnection if the tiered retry schedule allows it.
+     * Called from readData() when the device is disconnected.
+     * Returns true if reconnection succeeded.
+     */
+    async tryReconnect() {
+        this.retryManager.markDisconnected();
+        if (!this.retryManager.shouldAttemptNow()) {
+            return false;
+        }
+        this.retryManager.recordAttempt();
+        const phase = this.retryManager.getCurrentPhase();
+        const attempt = this.retryManager.getAttemptCount();
+        const elapsed = Math.round(this.retryManager.getElapsedMs() / 1000);
+        console.log(`${this.constructor.name} ${this.applianceId}: Reconnect attempt #${attempt} ` +
+            `(phase: ${phase.intervalMs / 1000}s interval, elapsed: ${elapsed}s)`);
+        try {
+            const success = await this.sunspecClient.reconnect();
+            if (success) {
+                // Re-discover models after reconnect
+                await this.sunspecClient.discoverModels(this.baseAddress);
+                this.retryManager.reset();
+                // Update appliance state to Connected
+                if (this.applianceId) {
+                    await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Connected);
+                }
+                console.log(`${this.constructor.name} ${this.applianceId}: Reconnection successful after ${attempt} attempt(s)`);
+                return true;
+            }
+        }
+        catch (error) {
+            console.error(`${this.constructor.name} ${this.applianceId}: Reconnect attempt #${attempt} failed: ${error}`);
+        }
+        return false;
+    }
+    /**
+     * Mark the device as offline: update appliance state and start tracking disconnection.
+     */
+    async markOffline() {
+        this.retryManager.markDisconnected();
+        if (this.applianceId) {
+            try {
+                await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Offline);
+            }
+            catch (error) {
+                console.error(`${this.constructor.name} ${this.applianceId}: Failed to mark appliance offline: ${error}`);
+            }
+        }
+    }
+    sendCommandAcknowledge(messageId, acknowledgeMessage, answer, rejectionReason) {
+        if (!this.dataBus || !this.applianceId) {
+            return;
+        }
+        const ackMessage = {
+            id: randomUUID(),
+            message: EnyoDataBusMessageEnum.CommandAcknowledgeV1,
+            type: 'answer',
+            source: EnyoSourceEnum.Device,
+            applianceId: this.applianceId,
+            timestampIso: new Date().toISOString(),
+            data: {
+                messageId,
+                acknowledgeMessage: acknowledgeMessage,
+                answer,
+                rejectionReason
+            }
+        };
+        console.log(`${this.constructor.name} ${this.applianceId}: sending ${answer} for ${acknowledgeMessage} (messageId=${messageId}${rejectionReason ? `, reason=${rejectionReason}` : ''})`);
+        this.dataBus.sendMessage([ackMessage]);
+    }
 }
 /**
  * Sunspec Inverter implementation using dynamic model discovery
  */
 export class SunspecInverter extends BaseSunspecDevice {
+    capabilities;
+    constructor(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId = 1, port = 502, baseAddress = 40000, capabilities = [], retryConfig) {
+        super(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId, port, baseAddress, retryConfig);
+        this.capabilities = capabilities;
+    }
     async connect() {
         // Ensure Sunspec client is connected
         if (!this.sunspecClient.isConnected()) {
@@ -107,8 +176,10 @@ export class SunspecInverter extends BaseSunspecDevice {
         if (mpptModel) {
             console.log(`MPPT model found for inverter ${this.networkDevice.hostname}`);
         }
+        this.startDataBusListening();
     }
     async disconnect() {
+        this.stopDataBusListening();
         if (this.applianceId) {
             await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Offline);
         }
@@ -119,7 +190,9 @@ export class SunspecInverter extends BaseSunspecDevice {
     }
     async readData(clockId, resolution) {
         if (!this.isConnected()) {
-            return [];
+            await this.tryReconnect();
+            if (!this.isConnected())
+                return [];
         }
         const messages = [];
         const timestamp = new Date();
@@ -129,12 +202,9 @@ export class SunspecInverter extends BaseSunspecDevice {
             const mpptDataList = await this.sunspecClient.readAllMPPTData();
             const inverterSettings = await this.sunspecClient.readInverterSettings();
             const dcStrings = this.mapMPPTToStrings(mpptDataList);
-            // Calculate battery discharge power to subtract from AC power
-            const batteryDischargePowerW = extractBatteryDischargePowerFromMPPT(mpptDataList);
             if (inverterData) {
-                const totalAcPowerW = inverterData.acPower || 0;
-                const purePvPowerW = Math.max(0, totalAcPowerW - batteryDischargePowerW);
-                console.log(`Got Battery Discharge power ${batteryDischargePowerW} and Inverter Power W ${totalAcPowerW} with pure PV Power ${purePvPowerW}`);
+                const pvPowerW = dcStrings.reduce((sum, s) => sum + (s.powerW || 0), 0);
+                console.log(`Got PV Power from DC strings: ${pvPowerW}W`);
                 const inverterMessage = {
                     id: randomUUID(),
                     message: EnyoDataBusMessageEnum.InverterValuesUpdateV1,
@@ -145,7 +215,7 @@ export class SunspecInverter extends BaseSunspecDevice {
                     timestampIso: timestamp.toISOString(),
                     resolution,
                     data: {
-                        pvPowerW: purePvPowerW,
+                        pvPowerW,
                         activePowerLimitationW: inverterSettings?.WMax,
                         state: this.mapOperatingState(inverterData.operatingState),
                         voltageL1: inverterData.voltageAN || 0,
@@ -169,6 +239,7 @@ export class SunspecInverter extends BaseSunspecDevice {
         }
         catch (error) {
             console.error(`Error updating inverter data: ${error}`);
+            await this.markOffline();
         }
         return messages;
     }
@@ -239,13 +310,72 @@ export class SunspecInverter extends BaseSunspecDevice {
     mapDcStringToApplianceMetadata(mpptDataList) {
         return mpptDataList.map(s => ({ index: s.index, name: s.name }));
     }
+    /**
+     * Start listening for inverter commands on the data bus.
+     * Idempotent — does nothing if already listening.
+     */
+    startDataBusListening() {
+        if (this.dataBusListenerId) {
+            return;
+        }
+        this.dataBus = this.energyApp.useDataBus();
+        this.dataBusListenerId = this.dataBus.listenForMessages([ENYO_DATA_BUS_SET_INVERTER_FEED_IN_LIMIT_V1], (entry) => this.handleInverterCommand(entry));
+        console.log(`Inverter ${this.applianceId}: started data bus listening (listener ${this.dataBusListenerId})`);
+    }
+    /**
+     * Stop listening for inverter commands on the data bus.
+     */
+    stopDataBusListening() {
+        if (this.dataBusListenerId && this.dataBus) {
+            this.dataBus.unsubscribe(this.dataBusListenerId);
+            console.log(`Inverter ${this.applianceId}: stopped data bus listening (listener ${this.dataBusListenerId})`);
+        }
+        this.dataBusListenerId = undefined;
+        this.dataBus = undefined;
+    }
+    handleInverterCommand(entry) {
+        if (entry.applianceId !== this.applianceId) {
+            return;
+        }
+        void (async () => {
+            try {
+                if (entry.message === ENYO_DATA_BUS_SET_INVERTER_FEED_IN_LIMIT_V1) {
+                    await this.handleSetFeedInLimit(entry);
+                }
+            }
+            catch (error) {
+                console.error(`Inverter ${this.applianceId}: error handling ${entry.message}:`, error);
+            }
+        })();
+    }
+    async handleSetFeedInLimit(msg) {
+        // Check capability
+        if (!this.capabilities.includes(SunspecInverterCapability.FeedInLimit)) {
+            this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.NotSupported, 'FeedInLimit capability not enabled');
+            return;
+        }
+        if (!this.isConnected() || !this.applianceId) {
+            this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Not connected');
+            return;
+        }
+        console.log(`Inverter ${this.applianceId}: handling SetInverterFeedInLimitV1 (feedInLimitW=${msg.data.feedInLimitW})`);
+        const success = await this.sunspecClient.setFeedInLimit(msg.data.feedInLimitW);
+        if (!success) {
+            this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to set feed-in limit');
+            return;
+        }
+        this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Accepted);
+    }
 }
 /**
  * Sunspec Battery implementation
  */
 export class SunspecBattery extends BaseSunspecDevice {
-    dataBusListenerId;
-    dataBus;
+    capabilities;
+    constructor(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId = 1, port = 502, baseAddress = 40000, capabilities = [], retryConfig) {
+        super(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId, port, baseAddress, retryConfig);
+        this.capabilities = capabilities;
+    }
     /**
      * Connect to the battery and create/update the appliance
      */
@@ -332,7 +462,9 @@ export class SunspecBattery extends BaseSunspecDevice {
      */
     async readData(clockId, resolution) {
         if (!this.isConnected()) {
-            return [];
+            await this.tryReconnect();
+            if (!this.isConnected())
+                return [];
         }
         const messages = [];
         const timestamp = new Date();
@@ -390,6 +522,7 @@ export class SunspecBattery extends BaseSunspecDevice {
         }
         catch (error) {
             console.error(`Error updating battery data: ${error}`);
+            await this.markOffline();
         }
         return messages;
     }
@@ -706,44 +839,35 @@ export class SunspecBattery extends BaseSunspecDevice {
             this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.NotSupported);
             return;
         }
-        console.log(`Battery ${this.applianceId}: handling SetStorageDischargeLimitV1 (dischargeLimitPercent=${msg.data.dischargeLimitPercent})`);
-        // Read current state for logging
+        console.log(`Battery ${this.applianceId}: handling SetStorageDischargeLimitV1 (dischargeLimitW=${msg.data.dischargeLimitW})`);
+        // Read current state to get wChaMax for percentage conversion
         const controls = await this.getBatteryControls();
-        console.log(`Battery ${this.applianceId}: current state - outWRte=${controls?.outWRte}`);
+        console.log(`Battery ${this.applianceId}: current state - outWRte=${controls?.outWRte}, wChaMax=${controls?.wChaMax}`);
+        if (!controls?.wChaMax) {
+            this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to read wChaMax for discharge limit conversion');
+            return;
+        }
+        // Convert watts to percentage of WDisChaMax (using wChaMax), clamped to 0-100%
+        const dischargeLimitPercent = Math.min(100, Math.max(0, (msg.data.dischargeLimitW / controls.wChaMax) * 100));
+        console.log(`Battery ${this.applianceId}: calculated discharge limit: ${dischargeLimitPercent.toFixed(1)}% (${msg.data.dischargeLimitW}W / ${controls.wChaMax}W)`);
         // Set discharge limit (Register 12: outWRte)
-        const success = await this.writeBatteryControls({ outWRte: msg.data.dischargeLimitPercent });
+        const success = await this.writeBatteryControls({ outWRte: dischargeLimitPercent });
         if (!success) {
             this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to set discharge limit');
             return;
         }
         this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Accepted);
     }
-    sendCommandAcknowledge(messageId, acknowledgeMessage, answer, rejectionReason) {
-        if (!this.dataBus || !this.applianceId) {
-            return;
-        }
-        const ackMessage = {
-            id: randomUUID(),
-            message: EnyoDataBusMessageEnum.CommandAcknowledgeV1,
-            type: 'answer',
-            source: EnyoSourceEnum.Device,
-            applianceId: this.applianceId,
-            timestampIso: new Date().toISOString(),
-            data: {
-                messageId,
-                acknowledgeMessage,
-                answer,
-                rejectionReason
-            }
-        };
-        console.log(`Battery ${this.applianceId}: sending ${answer} for ${acknowledgeMessage} (messageId=${messageId}${rejectionReason ? `, reason=${rejectionReason}` : ''})`);
-        this.dataBus.sendMessage([ackMessage]);
-    }
 }
 /**
  * Sunspec Meter implementation
  */
 export class SunspecMeter extends BaseSunspecDevice {
+    capabilities;
+    constructor(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId = 1, port = 502, baseAddress = 40000, capabilities = [], retryConfig) {
+        super(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId, port, baseAddress, retryConfig);
+        this.capabilities = capabilities;
+    }
     /**
      * Connect to the meter and create/update the appliance
      */
@@ -800,7 +924,9 @@ export class SunspecMeter extends BaseSunspecDevice {
      */
     async readData(clockId, resolution) {
         if (!this.isConnected()) {
-            return [];
+            await this.tryReconnect();
+            if (!this.isConnected())
+                return [];
         }
         const messages = [];
         const timestamp = new Date();
@@ -831,6 +957,7 @@ export class SunspecMeter extends BaseSunspecDevice {
         }
         catch (error) {
             console.error(`Error updating meter data: ${error}`);
+            await this.markOffline();
         }
         return messages;
     }

package/dist/sunspec-interfaces.d.ts

@@ -2,13 +2,17 @@
  * SunSpec block interfaces with block numbers
  */
 /**
- * Configuration for connection retry with exponential backoff
+ * A single phase in the tiered retry schedule
+ */
+export interface IRetryPhase {
+    intervalMs: number;
+    durationMs: number;
+}
+/**
+ * Configuration for connection retry with tiered schedule
  */
 export interface IRetryConfig {
-    initialDelayMs: number;
-    maxDelayMs: number;
-    backoffFactor: number;
-    maxAttempts: number;
+    phases: IRetryPhase[];
 }
 export declare const DEFAULT_RETRY_CONFIG: IRetryConfig;
 /**
@@ -551,6 +555,15 @@ export declare enum SunspecStorageMode {
  * 2. Set chaGriSet = 1 to allow grid charging
  * 3. Set wChaMax to the desired charging power in Watts
  */
+export declare enum SunspecInverterCapability {
+    FeedInLimit = "feed-in-limit"
+}
+export declare enum SunspecBatteryCapability {
+    GridCharging = "grid-charging",
+    DischargeLimit = "discharge-limit"
+}
+export declare enum SunspecMeterCapability {
+}
 export interface SunspecBatteryControls {
     storCtlMod?: number;
     chaGriSet?: number;

package/dist/sunspec-interfaces.js

@@ -2,10 +2,12 @@
  * SunSpec block interfaces with block numbers
  */
 export const DEFAULT_RETRY_CONFIG = {
-    initialDelayMs: 1000,
-    maxDelayMs: 30000,
-    backoffFactor: 1.5,
-    maxAttempts: 10
+    phases: [
+        { intervalMs: 10_000, durationMs: 60_000 }, // Phase 1: every 10s for 1 minute
+        { intervalMs: 30_000, durationMs: 120_000 }, // Phase 2: every 30s for 2 minutes
+        { intervalMs: 60_000, durationMs: 300_000 }, // Phase 3: every 1m for 5 minutes
+        { intervalMs: 300_000, durationMs: 0 }, // Phase 4: every 5m forever
+    ]
 };
 /**
  * Common Sunspec Model IDs
@@ -197,3 +199,24 @@ export var SunspecStorageMode;
     SunspecStorageMode["HOLDING"] = "holding";
     SunspecStorageMode["AUTO"] = "auto"; // Both charge and discharge allowed
 })(SunspecStorageMode || (SunspecStorageMode = {}));
+/**
+ * Battery control structure for writing to Model 124
+ * Used for controlling battery charge/discharge behavior
+ *
+ * IMPORTANT: To enable grid charging with specific power:
+ * 1. Set storCtlMod with appropriate bits to enable external control
+ * 2. Set chaGriSet = 1 to allow grid charging
+ * 3. Set wChaMax to the desired charging power in Watts
+ */
+export var SunspecInverterCapability;
+(function (SunspecInverterCapability) {
+    SunspecInverterCapability["FeedInLimit"] = "feed-in-limit";
+})(SunspecInverterCapability || (SunspecInverterCapability = {}));
+export var SunspecBatteryCapability;
+(function (SunspecBatteryCapability) {
+    SunspecBatteryCapability["GridCharging"] = "grid-charging";
+    SunspecBatteryCapability["DischargeLimit"] = "discharge-limit";
+})(SunspecBatteryCapability || (SunspecBatteryCapability = {}));
+export var SunspecMeterCapability;
+(function (SunspecMeterCapability) {
+})(SunspecMeterCapability || (SunspecMeterCapability = {}));

package/dist/sunspec-modbus-client.d.ts

@@ -16,9 +16,8 @@
  * - pad: 0x8000 (always returns this value)
  * - string: all registers 0x0000 (NULL)
  */
-import { type SunspecInverterControls, type SunspecInverterData, type SunspecInverterSettings, type SunspecMeterData, type SunspecModel, type SunspecMPPTData, type SunspecBatteryData, type SunspecBatteryBaseData, type SunspecBatteryControls, SunspecStorageMode, type IRetryConfig } from "./sunspec-interfaces.js";
-import { ConnectionRetryManager } from "./connection-retry-manager.js";
-import { IConnectionHealth } from "@enyo-energy/energy-app-sdk/dist/implementations/modbus/interfaces.js";
+import { type SunspecInverterControls, type SunspecInverterData, type SunspecInverterSettings, type SunspecMeterData, type SunspecModel, type SunspecMPPTData, type SunspecBatteryData, type SunspecBatteryBaseData, type SunspecBatteryControls, SunspecStorageMode } from "./sunspec-interfaces.js";
+import { EnergyAppModbusDataType, IConnectionHealth } from "@enyo-energy/energy-app-sdk/dist/implementations/modbus/interfaces.js";
 import { EnergyApp } from "@enyo-energy/energy-app-sdk";
 export declare class SunspecModbusClient {
     private energyApp;
@@ -29,9 +28,8 @@ export declare class SunspecModbusClient {
     private faultTolerantReader;
     private modbusDataTypeConverter;
     private connectionParams;
-    private retryManager;
     private autoReconnectEnabled;
-    constructor(energyApp: EnergyApp, retryConfig?: Partial<IRetryConfig>);
+    constructor(energyApp: EnergyApp);
     /**
      * Connect to Modbus device
      * @param host Primary host (hostname) to connect to
@@ -55,11 +53,6 @@ export declare class SunspecModbusClient {
      * Returns true if successful, false otherwise
      */
     private attemptConnection;
-    /**
-     * Check connection health and trigger automatic reconnection if unhealthy
-     * Returns true if connection is healthy or was successfully restored
-     */
-    ensureHealthyConnection(): Promise<boolean>;
     /**
      * Enable or disable automatic reconnection
      */
@@ -68,10 +61,6 @@ export declare class SunspecModbusClient {
      * Check if auto-reconnect is enabled
      */
     isAutoReconnectEnabled(): boolean;
-    /**
-     * Get the retry manager for advanced configuration
-     */
-    getRetryManager(): ConnectionRetryManager;
     /**
      * Detect the base address and addressing mode (0-based or 1-based) for SunSpec
      */
@@ -119,13 +108,13 @@ export declare class SunspecModbusClient {
     /**
      * Helper to read register value(s) using the fault-tolerant reader with data type conversion
      */
-    private readRegisterValue;
+    readRegisterValue(address: number, quantity: number | undefined, dataType: EnergyAppModbusDataType): Promise<number | string | number[]>;
     /**
      * Helper to write register value(s)
      */
-    private writeRegisterValue;
+    writeRegisterValue(address: number, value: number | number[], dataType?: EnergyAppModbusDataType): Promise<boolean>;
     /**
-     * Read inverter data from Model 103 (Three Phase)
+     * Read inverter data from Model 101 (Single Phase) / Model 103 (Three Phase)
      */
     readInverterData(): Promise<SunspecInverterData | null>;
     /**
@@ -140,11 +129,10 @@ export declare class SunspecModbusClient {
      * Apply scale factor to a value
      * Returns undefined if the value is unimplemented or scale factor is out of range
      */
-    private applyScaleFactor;
-    private logRegisterRead;
+    applyScaleFactor(value: number, scaleFactor: number, dataType?: 'uint16' | 'int16' | 'acc32', fieldName?: string, offset?: number, modelId?: number): number | undefined;
+    logRegisterRead(modelId: number, offset: number, fieldName: string, rawValue: number | string | undefined, dataType?: string): void;
     /**
-     * Read MPPT Scale Factors for a specific module
-     * Returns the scale factors for DC Current, DC Voltage, DC Power, and DC Energy
+     * Read scale factors from Model 160 (MPPT)
      *
      * MPPT Model 160 Scale Factor Register Offsets (relative to module start):
      * - DCA_SF (Current Scale Factor): Offset 2
@@ -165,7 +153,7 @@ export declare class SunspecModbusClient {
      */
     readMPPTData(moduleId?: number): Promise<SunspecMPPTData | null>;
     /**
-     * Read all available MPPT strings
+     * Read all MPPT strings from Model 160 (Multiple MPPT)
      */
     readAllMPPTData(): Promise<SunspecMPPTData[]>;
     /**
@@ -191,7 +179,7 @@ export declare class SunspecModbusClient {
      */
     readBatteryBaseData(): Promise<SunspecBatteryBaseData | null>;
     /**
-     * Read battery data from Model 124 (Basic Storage Controls)
+     * Read battery data from Model 124 (Basic Storage) with fallback to Model 802 / Model 803
      */
     readBatteryData(): Promise<SunspecBatteryData | null>;
     /**
@@ -207,11 +195,11 @@ export declare class SunspecModbusClient {
      */
     enableGridCharging(enable: boolean): Promise<boolean>;
     /**
-     * Read current battery control settings
+     * Read battery control settings from Model 124 (Basic Storage Controls)
      */
     readBatteryControls(): Promise<SunspecBatteryControls | null>;
     /**
-     * Read meter data (Model 203 for 3-phase)
+     * Read meter data from Model 201 (Single Phase) / Model 203 (Three Phase) / Model 204 (Split Phase)
      */
     readMeterData(): Promise<SunspecMeterData | null>;
     /**
@@ -235,11 +223,11 @@ export declare class SunspecModbusClient {
      */
     getConnectionHealth(): IConnectionHealth;
     /**
-     * Read Block 121 - Inverter Basic Settings
+     * Read inverter settings from Model 121 (Inverter Settings)
      */
     readInverterSettings(): Promise<SunspecInverterSettings | null>;
     /**
-     * Read Block 123 - Immediate Inverter Controls
+     * Read inverter controls from Model 123 (Immediate Inverter Controls)
      */
     readInverterControls(): Promise<SunspecInverterControls | null>;
     /**
@@ -247,7 +235,18 @@ export declare class SunspecModbusClient {
      */
     writeInverterSettings(settings: Partial<SunspecInverterSettings>): Promise<boolean>;
     /**
-     * Write Block 123 - Immediate Inverter Controls
+     * Write inverter controls to Model 123 (Immediate Inverter Controls)
      */
     writeInverterControls(controls: Partial<SunspecInverterControls>): Promise<boolean>;
+    /**
+     * Set the inverter feed-in power limit using Model 123 (Immediate Inverter Controls)
+     *
+     * When limitW is a number, reads WMax from Model 121, computes percentage,
+     * writes WMaxLimPct and enables WMaxLim_Ena.
+     * When limitW is null, disables the limit by setting WMaxLim_Ena = DISABLED.
+     *
+     * @param limitW - Power limit in Watts, or null to remove the limit
+     * @returns true if successful, false otherwise
+     */
+    setFeedInLimit(limitW: number | null): Promise<boolean>;
 }