@enyo-energy/sunspec-sdk 0.0.32 → 0.0.34

package/dist/cjs/sunspec-devices.d.cts

@@ -1,9 +1,22 @@
-import { type SunspecBatteryBaseData, type SunspecBatteryControls, SunspecStorageMode } from "./sunspec-interfaces.cjs";
+import { type SunspecBatteryBaseData, type SunspecBatteryControls, SunspecStorageMode, SunspecInverterCapability, SunspecBatteryCapability, SunspecMeterCapability } from "./sunspec-interfaces.cjs";
 import { ApplianceManager, EnergyApp } from "@enyo-energy/energy-app-sdk";
 import { EnyoApplianceName } from "@enyo-energy/energy-app-sdk/dist/types/enyo-appliance.js";
 import { EnyoNetworkDevice } from "@enyo-energy/energy-app-sdk/dist/types/enyo-network-device.js";
 import { SunspecModbusClient } from "./sunspec-modbus-client.cjs";
-import { EnyoDataBusMessage, EnyoDataBusMessageResolution } from "@enyo-energy/energy-app-sdk/dist/types/enyo-data-bus-value.js";
+import { ConnectionRetryManager } from "./connection-retry-manager.cjs";
+import { type IRetryConfig } from "./sunspec-interfaces.cjs";
+import { EnyoCommandAcknowledgeAnswerEnum, EnyoDataBusMessage, EnyoDataBusMessageEnum, EnyoDataBusMessageResolution } from "@enyo-energy/energy-app-sdk/dist/types/enyo-data-bus-value.js";
+import { EnergyAppDataBus } from "@enyo-energy/energy-app-sdk/dist/packages/energy-app-data-bus.js";
+export declare const ENYO_DATA_BUS_SET_INVERTER_FEED_IN_LIMIT_V1 = "SetInverterFeedInLimitV1";
+export interface EnyoDataBusSetInverterFeedInLimitV1 {
+    id: string;
+    type: 'message';
+    message: string;
+    applianceId: string;
+    data: {
+        feedInLimitW: number | null;
+    };
+}
 /**
  * Base abstract class for all Sunspec devices
  */
@@ -18,7 +31,10 @@ export declare abstract class BaseSunspecDevice {
     protected readonly baseAddress: number;
     protected applianceId?: string;
     protected lastUpdateTime: number;
-    constructor(energyApp: EnergyApp, name: EnyoApplianceName[], networkDevice: EnyoNetworkDevice, sunspecClient: SunspecModbusClient, applianceManager: ApplianceManager, unitId?: number, port?: number, baseAddress?: number);
+    protected dataBusListenerId?: string;
+    protected dataBus?: EnergyAppDataBus;
+    protected retryManager: ConnectionRetryManager;
+    constructor(energyApp: EnergyApp, name: EnyoApplianceName[], networkDevice: EnyoNetworkDevice, sunspecClient: SunspecModbusClient, applianceManager: ApplianceManager, unitId?: number, port?: number, baseAddress?: number, retryConfig?: IRetryConfig);
     /**
      * Connect to the device and create/update the appliance
      */
@@ -42,11 +58,24 @@ export declare abstract class BaseSunspecDevice {
      * Ensure the Sunspec client is connected and models are discovered
      */
     protected ensureConnected(): Promise<void>;
+    /**
+     * Attempt a reconnection if the tiered retry schedule allows it.
+     * Called from readData() when the device is disconnected.
+     * Returns true if reconnection succeeded.
+     */
+    protected tryReconnect(): Promise<boolean>;
+    /**
+     * Mark the device as offline: update appliance state and start tracking disconnection.
+     */
+    protected markOffline(): Promise<void>;
+    protected sendCommandAcknowledge(messageId: string, acknowledgeMessage: EnyoDataBusMessageEnum | string, answer: EnyoCommandAcknowledgeAnswerEnum, rejectionReason?: string): void;
 }
 /**
  * Sunspec Inverter implementation using dynamic model discovery
  */
 export declare class SunspecInverter extends BaseSunspecDevice {
+    private readonly capabilities;
+    constructor(energyApp: EnergyApp, name: EnyoApplianceName[], networkDevice: EnyoNetworkDevice, sunspecClient: SunspecModbusClient, applianceManager: ApplianceManager, unitId?: number, port?: number, baseAddress?: number, capabilities?: SunspecInverterCapability[], retryConfig?: IRetryConfig);
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     isConnected(): boolean;
@@ -59,13 +88,24 @@ export declare class SunspecInverter extends BaseSunspecDevice {
     private mapMPPTToStrings;
     private mapMPPTOperatingState;
     private mapDcStringToApplianceMetadata;
+    /**
+     * Start listening for inverter commands on the data bus.
+     * Idempotent — does nothing if already listening.
+     */
+    startDataBusListening(): void;
+    /**
+     * Stop listening for inverter commands on the data bus.
+     */
+    stopDataBusListening(): void;
+    private handleInverterCommand;
+    private handleSetFeedInLimit;
 }
 /**
  * Sunspec Battery implementation
  */
 export declare class SunspecBattery extends BaseSunspecDevice {
-    private dataBusListenerId?;
-    private dataBus?;
+    private readonly capabilities;
+    constructor(energyApp: EnergyApp, name: EnyoApplianceName[], networkDevice: EnyoNetworkDevice, sunspecClient: SunspecModbusClient, applianceManager: ApplianceManager, unitId?: number, port?: number, baseAddress?: number, capabilities?: SunspecBatteryCapability[], retryConfig?: IRetryConfig);
     /**
      * Connect to the battery and create/update the appliance
      */
@@ -176,12 +216,13 @@ export declare class SunspecBattery extends BaseSunspecDevice {
     private handleStartGridCharge;
     private handleStopGridCharge;
     private handleSetDischargeLimit;
-    private sendCommandAcknowledge;
 }
 /**
  * Sunspec Meter implementation
  */
 export declare class SunspecMeter extends BaseSunspecDevice {
+    private readonly capabilities;
+    constructor(energyApp: EnergyApp, name: EnyoApplianceName[], networkDevice: EnyoNetworkDevice, sunspecClient: SunspecModbusClient, applianceManager: ApplianceManager, unitId?: number, port?: number, baseAddress?: number, capabilities?: SunspecMeterCapability[], retryConfig?: IRetryConfig);
     /**
      * Connect to the meter and create/update the appliance
      */

package/dist/cjs/sunspec-interfaces.cjs

@@ -3,12 +3,14 @@
  * SunSpec block interfaces with block numbers
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SunspecStorageMode = exports.SunspecChargeSource = exports.SunspecVArPctMode = exports.SunspecEnableControl = exports.SunspecConnectionControl = exports.SunspecStorageControlMode = exports.SunspecBatteryEvent1 = exports.SunspecBatteryBankState = exports.SunspecBatteryType = exports.SunspecBatteryControlMode = exports.SunspecBatteryChargeState = exports.SunspecMPPTOperatingState = exports.SunspecModelId = exports.DEFAULT_RETRY_CONFIG = void 0;
+exports.SunspecMeterCapability = exports.SunspecBatteryCapability = exports.SunspecInverterCapability = exports.SunspecStorageMode = exports.SunspecChargeSource = exports.SunspecVArPctMode = exports.SunspecEnableControl = exports.SunspecConnectionControl = exports.SunspecStorageControlMode = exports.SunspecBatteryEvent1 = exports.SunspecBatteryBankState = exports.SunspecBatteryType = exports.SunspecBatteryControlMode = exports.SunspecBatteryChargeState = exports.SunspecMPPTOperatingState = exports.SunspecModelId = exports.DEFAULT_RETRY_CONFIG = void 0;
 exports.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
@@ -200,3 +202,24 @@ var SunspecStorageMode;
     SunspecStorageMode["HOLDING"] = "holding";
     SunspecStorageMode["AUTO"] = "auto"; // Both charge and discharge allowed
 })(SunspecStorageMode || (exports.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
+ */
+var SunspecInverterCapability;
+(function (SunspecInverterCapability) {
+    SunspecInverterCapability["FeedInLimit"] = "feed-in-limit";
+})(SunspecInverterCapability || (exports.SunspecInverterCapability = SunspecInverterCapability = {}));
+var SunspecBatteryCapability;
+(function (SunspecBatteryCapability) {
+    SunspecBatteryCapability["GridCharging"] = "grid-charging";
+    SunspecBatteryCapability["DischargeLimit"] = "discharge-limit";
+})(SunspecBatteryCapability || (exports.SunspecBatteryCapability = SunspecBatteryCapability = {}));
+var SunspecMeterCapability;
+(function (SunspecMeterCapability) {
+})(SunspecMeterCapability || (exports.SunspecMeterCapability = SunspecMeterCapability = {}));

package/dist/cjs/sunspec-interfaces.d.cts

@@ -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/cjs/sunspec-modbus-client.cjs

@@ -20,7 +20,6 @@ exports.SunspecModbusClient = void 0;
  * - string: all registers 0x0000 (NULL)
  */
 const sunspec_interfaces_js_1 = require("./sunspec-interfaces.cjs");
-const connection_retry_manager_js_1 = require("./connection-retry-manager.cjs");
 const EnergyAppModbusConnectionHealth_js_1 = require("@enyo-energy/energy-app-sdk/dist/implementations/modbus/EnergyAppModbusConnectionHealth.js");
 const EnergyAppModbusFaultTolerantReader_js_1 = require("@enyo-energy/energy-app-sdk/dist/implementations/modbus/EnergyAppModbusFaultTolerantReader.js");
 const EnergyAppModbusDataTypeConverter_js_1 = require("@enyo-energy/energy-app-sdk/dist/implementations/modbus/EnergyAppModbusDataTypeConverter.js");
@@ -33,13 +32,11 @@ class SunspecModbusClient {
     faultTolerantReader = null;
     modbusDataTypeConverter;
     connectionParams = null;
-    retryManager;
     autoReconnectEnabled = true;
-    constructor(energyApp, retryConfig) {
+    constructor(energyApp) {
         this.energyApp = energyApp;
         this.connectionHealth = new EnergyAppModbusConnectionHealth_js_1.EnergyAppModbusConnectionHealth();
         this.modbusDataTypeConverter = new EnergyAppModbusDataTypeConverter_js_1.EnergyAppModbusDataTypeConverter();
-        this.retryManager = new connection_retry_manager_js_1.ConnectionRetryManager(retryConfig);
     }
     /**
      * Connect to Modbus device
@@ -66,15 +63,12 @@ class SunspecModbusClient {
         }
         this.connected = true;
         this.connectionHealth.recordSuccess();
-        this.retryManager.reset();
         console.log(`Connected to Sunspec device at ${host}:${port} unit ${unitId}`);
     }
     /**
      * Disconnect from Modbus device
      */
     async disconnect() {
-        // Cancel any pending retry attempts
-        this.retryManager.cancelPendingRetry();
         if (this.modbusClient && this.connected) {
             await this.modbusClient.disconnect();
             this.modbusClient = null;
@@ -153,61 +147,12 @@ class SunspecModbusClient {
             return false;
         }
     }
-    /**
-     * Check connection health and trigger automatic reconnection if unhealthy
-     * Returns true if connection is healthy or was successfully restored
-     */
-    async ensureHealthyConnection() {
-        // If already healthy, return immediately
-        if (this.isHealthy()) {
-            return true;
-        }
-        // If no connection params, we can't reconnect
-        if (!this.connectionParams) {
-            console.error('Connection unhealthy and no connection parameters stored for reconnection.');
-            return false;
-        }
-        // If auto-reconnect is disabled, just report the status
-        if (!this.autoReconnectEnabled) {
-            console.log('Connection unhealthy but auto-reconnect is disabled.');
-            return false;
-        }
-        // If a retry is already in progress, don't start another
-        if (this.retryManager.isRetryInProgress()) {
-            console.log('Retry already in progress...');
-            return false;
-        }
-        console.log('Connection unhealthy, initiating reconnection with exponential backoff...');
-        // Attempt reconnection with exponential backoff
-        let success = false;
-        while (this.retryManager.shouldRetry() && !success) {
-            success = await this.retryManager.scheduleRetry(() => this.reconnect());
-            if (success) {
-                // Re-discover models after successful reconnection
-                try {
-                    await this.discoverModels();
-                    console.log('Models re-discovered after reconnection.');
-                }
-                catch (e) {
-                    console.warn('Failed to re-discover models after reconnection:', e);
-                }
-                return true;
-            }
-        }
-        if (!success) {
-            console.error('Failed to restore healthy connection after all retry attempts.');
-        }
-        return success;
-    }
     /**
      * Enable or disable automatic reconnection
      */
     setAutoReconnect(enabled) {
         this.autoReconnectEnabled = enabled;
         console.log(`Auto-reconnect ${enabled ? 'enabled' : 'disabled'}`);
-        if (!enabled) {
-            this.retryManager.cancelPendingRetry();
-        }
     }
     /**
      * Check if auto-reconnect is enabled
@@ -215,12 +160,6 @@ class SunspecModbusClient {
     isAutoReconnectEnabled() {
         return this.autoReconnectEnabled;
     }
-    /**
-     * Get the retry manager for advanced configuration
-     */
-    getRetryManager() {
-        return this.retryManager;
-    }
     /**
      * Detect the base address and addressing mode (0-based or 1-based) for SunSpec
      */
@@ -500,7 +439,7 @@ class SunspecModbusClient {
         }
     }
     /**
-     * Read inverter data from Model 103 (Three Phase)
+     * Read inverter data from Model 101 (Single Phase) / Model 103 (Three Phase)
      */
     async readInverterData() {
         const model = this.findModel(sunspec_interfaces_js_1.SunspecModelId.Inverter3Phase);
@@ -717,8 +656,7 @@ class SunspecModbusClient {
         }
     }
     /**
-     * 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
@@ -838,7 +776,7 @@ class SunspecModbusClient {
         }
     }
     /**
-     * Read all available MPPT strings
+     * Read all MPPT strings from Model 160 (Multiple MPPT)
      */
     async readAllMPPTData() {
         const mpptData = [];
@@ -1152,7 +1090,7 @@ class SunspecModbusClient {
         }
     }
     /**
-     * Read battery data from Model 124 (Basic Storage Controls)
+     * Read battery data from Model 124 (Basic Storage) with fallback to Model 802 / Model 803
      */
     async readBatteryData() {
         // Try Model 124 first (Basic Storage Controls)
@@ -1420,7 +1358,7 @@ class SunspecModbusClient {
         return this.writeBatteryControls({ chaGriSet });
     }
     /**
-     * Read current battery control settings
+     * Read battery control settings from Model 124 (Basic Storage Controls)
      */
     async readBatteryControls() {
         const model = this.findModel(sunspec_interfaces_js_1.SunspecModelId.Battery);
@@ -1465,7 +1403,7 @@ class SunspecModbusClient {
         }
     }
     /**
-     * Read meter data (Model 203 for 3-phase)
+     * Read meter data from Model 201 (Single Phase) / Model 203 (Three Phase) / Model 204 (Split Phase)
      */
     async readMeterData() {
         let model = this.findModel(sunspec_interfaces_js_1.SunspecModelId.Meter3Phase);
@@ -1627,7 +1565,7 @@ class SunspecModbusClient {
         return this.connectionHealth;
     }
     /**
-     * Read Block 121 - Inverter Basic Settings
+     * Read inverter settings from Model 121 (Inverter Settings)
      */
     async readInverterSettings() {
         const model = this.findModel(sunspec_interfaces_js_1.SunspecModelId.Settings);
@@ -1716,7 +1654,7 @@ class SunspecModbusClient {
         }
     }
     /**
-     * Read Block 123 - Immediate Inverter Controls
+     * Read inverter controls from Model 123 (Immediate Inverter Controls)
      */
     async readInverterControls() {
         const model = this.findModel(sunspec_interfaces_js_1.SunspecModelId.Controls);
@@ -1846,7 +1784,7 @@ class SunspecModbusClient {
         }
     }
     /**
-     * Write Block 123 - Immediate Inverter Controls
+     * Write inverter controls to Model 123 (Immediate Inverter Controls)
      */
     async writeInverterControls(controls) {
         const model = this.findModel(sunspec_interfaces_js_1.SunspecModelId.Controls);
@@ -1856,32 +1794,35 @@ class SunspecModbusClient {
         }
         const baseAddr = model.address;
         try {
-            // Connection control
-            if (controls.Conn !== undefined && this.modbusClient) {
-                // Writing registers needs to be implemented in EnergyAppModbusInstance
-                console.log(`Would write connection control ${controls.Conn} to register ${baseAddr + 2}`);
+            // Connection control (Register 2)
+            if (controls.Conn !== undefined) {
+                await this.writeRegisterValue(baseAddr + 2, controls.Conn, 'uint16');
+                console.log(`Set connection control to ${controls.Conn}`);
             }
-            // Power limit control
-            if (controls.WMaxLimPct !== undefined && this.modbusClient) {
-                const sfBuffer = await this.modbusClient.readHoldingRegisters(baseAddr + 21, 1);
-                const scaleFactor = sfBuffer.readInt16BE(0);
+            // Power limit control (Register 3) - needs scale factor
+            if (controls.WMaxLimPct !== undefined) {
+                const scaleFactor = await this.readRegisterValue(baseAddr + 21, 1, 'int16');
                 const scaledValue = Math.round(controls.WMaxLimPct / Math.pow(10, scaleFactor));
-                console.log(`Would write power limit ${scaledValue} to register ${baseAddr + 3}`);
+                await this.writeRegisterValue(baseAddr + 3, scaledValue, 'uint16');
+                console.log(`Set power limit to ${controls.WMaxLimPct}% (scaled: ${scaledValue})`);
             }
-            if (controls.WMaxLim_Ena !== undefined && this.modbusClient) {
-                console.log(`Would write throttle enable ${controls.WMaxLim_Ena} to register ${baseAddr + 7}`);
+            // Throttle enable/disable (Register 7)
+            if (controls.WMaxLim_Ena !== undefined) {
+                await this.writeRegisterValue(baseAddr + 7, controls.WMaxLim_Ena, 'uint16');
+                console.log(`Set throttle enable to ${controls.WMaxLim_Ena}`);
             }
-            // Power factor control
-            if (controls.OutPFSet !== undefined && this.modbusClient) {
-                const sfBuffer = await this.modbusClient.readHoldingRegisters(baseAddr + 22, 1);
-                const scaleFactor = sfBuffer.readInt16BE(0);
+            // Power factor control (Register 8) - needs scale factor
+            if (controls.OutPFSet !== undefined) {
+                const scaleFactor = await this.readRegisterValue(baseAddr + 22, 1, 'int16');
                 const scaledValue = Math.round(controls.OutPFSet / Math.pow(10, scaleFactor));
-                console.log(`Would write power factor ${scaledValue} to register ${baseAddr + 8}`);
+                await this.writeRegisterValue(baseAddr + 8, scaledValue, 'int16');
+                console.log(`Set power factor to ${controls.OutPFSet} (scaled: ${scaledValue})`);
             }
-            if (controls.OutPFSet_Ena !== undefined && this.modbusClient) {
-                console.log(`Would write PF enable ${controls.OutPFSet_Ena} to register ${baseAddr + 12}`);
+            // Power factor enable/disable (Register 12)
+            if (controls.OutPFSet_Ena !== undefined) {
+                await this.writeRegisterValue(baseAddr + 12, controls.OutPFSet_Ena, 'uint16');
+                console.log(`Set PF enable to ${controls.OutPFSet_Ena}`);
             }
-            // Add more control writes as needed
             console.log('Inverter controls written successfully');
             return true;
         }
@@ -1890,5 +1831,34 @@ class SunspecModbusClient {
             return false;
         }
     }
+    /**
+     * 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
+     */
+    async setFeedInLimit(limitW) {
+        if (limitW === null) {
+            // Remove limit: disable WMaxLim_Ena
+            console.log('Removing feed-in limit (disabling WMaxLim_Ena)');
+            return this.writeInverterControls({ WMaxLim_Ena: sunspec_interfaces_js_1.SunspecEnableControl.DISABLED });
+        }
+        // Read WMax from Model 121 to compute percentage
+        const settings = await this.readInverterSettings();
+        if (!settings || !settings.WMax) {
+            console.error('Cannot set feed-in limit: unable to read WMax from Model 121');
+            return false;
+        }
+        const pct = (limitW / settings.WMax) * 100;
+        console.log(`Setting feed-in limit to ${limitW}W (${pct.toFixed(2)}% of WMax ${settings.WMax}W)`);
+        return this.writeInverterControls({
+            WMaxLimPct: pct,
+            WMaxLim_Ena: sunspec_interfaces_js_1.SunspecEnableControl.ENABLED
+        });
+    }
 }
 exports.SunspecModbusClient = SunspecModbusClient;

package/dist/cjs/sunspec-modbus-client.d.cts

@@ -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.cjs";
-import { ConnectionRetryManager } from "./connection-retry-manager.cjs";
-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.cjs";
+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>;
 }

package/dist/cjs/version.cjs

@@ -9,7 +9,7 @@ exports.getSdkVersion = getSdkVersion;
 /**
  * Current version of the enyo Energy App SDK.
  */
-exports.SDK_VERSION = '0.0.32';
+exports.SDK_VERSION = '0.0.34';
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/cjs/version.d.cts

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export declare const SDK_VERSION = "0.0.32";
+export declare const SDK_VERSION = "0.0.34";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK