@enyo-energy/sunspec-sdk 0.0.29 → 0.0.30

package/dist/cjs/sunspec-devices.cjs

@@ -31,15 +31,19 @@ class BaseSunspecDevice {
     sunspecClient;
     applianceManager;
     unitId;
+    port;
+    baseAddress;
     applianceId;
     lastUpdateTime = 0;
-    constructor(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId = 1) {
+    constructor(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId = 1, port = 502, baseAddress = 40000) {
         this.energyApp = energyApp;
         this.name = name;
         this.networkDevice = networkDevice;
         this.sunspecClient = sunspecClient;
         this.applianceManager = applianceManager;
         this.unitId = unitId;
+        this.port = port;
+        this.baseAddress = baseAddress;
     }
     /**
      * Check if the device is connected
@@ -56,9 +60,9 @@ class BaseSunspecDevice {
     async ensureConnected() {
         if (!this.sunspecClient.isConnected()) {
             await this.sunspecClient.connect(this.networkDevice.hostname, // primary
-            502, this.unitId, this.networkDevice.ipAddress // secondary fallback
+            this.port, this.unitId, this.networkDevice.ipAddress // secondary fallback
             );
-            await this.sunspecClient.discoverModels();
+            await this.sunspecClient.discoverModels(this.baseAddress);
         }
     }
 }
@@ -71,9 +75,9 @@ class SunspecInverter extends BaseSunspecDevice {
         // Ensure Sunspec client is connected
         if (!this.sunspecClient.isConnected()) {
             await this.sunspecClient.connect(this.networkDevice.hostname, // primary
-            502, this.unitId, this.networkDevice.ipAddress // secondary fallback
+            this.port, this.unitId, this.networkDevice.ipAddress // secondary fallback
             );
-            await this.sunspecClient.discoverModels();
+            await this.sunspecClient.discoverModels(this.baseAddress);
         }
         // Get device info from common block
         const commonData = await this.sunspecClient.readCommonBlock();
@@ -245,6 +249,8 @@ exports.SunspecInverter = SunspecInverter;
  * Sunspec Battery implementation
  */
 class SunspecBattery extends BaseSunspecDevice {
+    dataBusListenerId;
+    dataBus;
     /**
      * Connect to the battery and create/update the appliance
      */
@@ -288,12 +294,14 @@ class SunspecBattery extends BaseSunspecDevice {
                 }
             });
             console.log(`Sunspec Battery connected: ${this.networkDevice.hostname} (${this.applianceId})`);
+            this.startDataBusListening();
         }
         catch (error) {
             console.error(`Failed to create battery appliance: ${error}`);
         }
     }
     async disconnect() {
+        this.stopDataBusListening();
         if (this.applianceId) {
             await this.applianceManager.updateApplianceState(this.applianceId, enyo_appliance_js_1.EnyoApplianceConnectionType.Connector, enyo_appliance_js_1.EnyoApplianceStateEnum.Offline);
         }
@@ -562,6 +570,155 @@ class SunspecBattery extends BaseSunspecDevice {
         }
         return controls.chaGriSet === 1; // 1 = GRID, 0 = PV
     }
+    /**
+     * Start listening for storage 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_value_js_1.EnyoDataBusMessageEnum.StartStorageGridChargeV1,
+            enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.StopStorageGridChargeV1,
+            enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.SetStorageDischargeLimitV1
+        ], (entry) => this.handleStorageCommand(entry));
+        console.log(`Battery ${this.applianceId}: started data bus listening (listener ${this.dataBusListenerId})`);
+    }
+    /**
+     * Stop listening for storage commands on the data bus.
+     */
+    stopDataBusListening() {
+        if (this.dataBusListenerId && this.dataBus) {
+            this.dataBus.unsubscribe(this.dataBusListenerId);
+            console.log(`Battery ${this.applianceId}: stopped data bus listening (listener ${this.dataBusListenerId})`);
+        }
+        this.dataBusListenerId = undefined;
+        this.dataBus = undefined;
+    }
+    handleStorageCommand(entry) {
+        if (entry.applianceId !== this.applianceId) {
+            return;
+        }
+        void (async () => {
+            try {
+                switch (entry.message) {
+                    case enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.StartStorageGridChargeV1:
+                        await this.handleStartGridCharge(entry);
+                        break;
+                    case enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.StopStorageGridChargeV1:
+                        await this.handleStopGridCharge(entry);
+                        break;
+                    case enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.SetStorageDischargeLimitV1:
+                        await this.handleSetDischargeLimit(entry);
+                        break;
+                }
+            }
+            catch (error) {
+                console.error(`Battery ${this.applianceId}: error handling ${entry.message}:`, error);
+            }
+        })();
+    }
+    async handleStartGridCharge(msg) {
+        if (!this.isConnected() || !this.applianceId) {
+            this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.Rejected, "Not connected");
+            return;
+        }
+        console.log(`Battery ${this.applianceId}: handling StartStorageGridChargeV1 (powerLimitW=${msg.data.powerLimitW})`);
+        // Read current state for logging and rollback
+        const controls = await this.getBatteryControls();
+        console.log(`Battery ${this.applianceId}: current state - chaGriSet=${controls?.chaGriSet}, wChaMax=${controls?.wChaMax}, storCtlMod=${controls?.storCtlMod}`);
+        const originalChaGriSet = controls?.chaGriSet;
+        const originalWChaMax = controls?.wChaMax;
+        // Step 1: Enable grid charging (Register 17: chaGriSet=GRID)
+        const step1 = await this.enableGridCharging(true);
+        if (!step1) {
+            this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to enable grid charging');
+            return;
+        }
+        // Step 2: Set charging power (Register 2: wChaMax)
+        const step2 = await this.setChargingPower(msg.data.powerLimitW);
+        if (!step2) {
+            // Rollback step 1
+            await this.writeBatteryControls({ chaGriSet: originalChaGriSet });
+            this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to set charging power');
+            return;
+        }
+        // Step 3: Set storage mode to CHARGE (Register 5: storCtlMod=0x0001)
+        const step3 = await this.setStorageMode(sunspec_interfaces_js_1.SunspecStorageMode.CHARGE);
+        if (!step3) {
+            // Rollback steps 1+2
+            await this.writeBatteryControls({ chaGriSet: originalChaGriSet, wChaMax: originalWChaMax });
+            this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to set storage mode to charge');
+            return;
+        }
+        this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.Accepted);
+    }
+    async handleStopGridCharge(msg) {
+        if (!this.isConnected() || !this.applianceId) {
+            this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.NotSupported);
+            return;
+        }
+        console.log(`Battery ${this.applianceId}: handling StopStorageGridChargeV1`);
+        // Read current state for logging and rollback
+        const controls = await this.getBatteryControls();
+        console.log(`Battery ${this.applianceId}: current state - chaGriSet=${controls?.chaGriSet}, storCtlMod=${controls?.storCtlMod}`);
+        const originalChaGriSet = controls?.chaGriSet;
+        // Step 1: Disable grid charging (Register 17: chaGriSet=PV)
+        const step1 = await this.enableGridCharging(false);
+        if (!step1) {
+            this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to disable grid charging');
+            return;
+        }
+        // Step 2: Set storage mode to AUTO (Register 5: storCtlMod=0x0003)
+        const step2 = await this.setStorageMode(sunspec_interfaces_js_1.SunspecStorageMode.AUTO);
+        if (!step2) {
+            // Rollback step 1
+            await this.writeBatteryControls({ chaGriSet: originalChaGriSet });
+            this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to set storage mode to auto');
+            return;
+        }
+        this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.Accepted);
+    }
+    async handleSetDischargeLimit(msg) {
+        if (!this.isConnected() || !this.applianceId) {
+            this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.NotSupported);
+            return;
+        }
+        console.log(`Battery ${this.applianceId}: handling SetStorageDischargeLimitV1 (dischargeLimitPercent=${msg.data.dischargeLimitPercent})`);
+        // Read current state for logging
+        const controls = await this.getBatteryControls();
+        console.log(`Battery ${this.applianceId}: current state - outWRte=${controls?.outWRte}`);
+        // Set discharge limit (Register 12: outWRte)
+        const success = await this.writeBatteryControls({ outWRte: msg.data.dischargeLimitPercent });
+        if (!success) {
+            this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to set discharge limit');
+            return;
+        }
+        this.sendCommandAcknowledge(msg.id, msg.message, enyo_data_bus_value_js_1.EnyoCommandAcknowledgeAnswerEnum.Accepted);
+    }
+    sendCommandAcknowledge(messageId, acknowledgeMessage, answer, rejectionReason) {
+        if (!this.dataBus || !this.applianceId) {
+            return;
+        }
+        const ackMessage = {
+            id: (0, node_crypto_1.randomUUID)(),
+            message: enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.CommandAcknowledgeV1,
+            type: 'answer',
+            source: enyo_source_enum_js_1.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]);
+    }
 }
 exports.SunspecBattery = SunspecBattery;
 /**

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

@@ -14,9 +14,11 @@ export declare abstract class BaseSunspecDevice {
     protected readonly sunspecClient: SunspecModbusClient;
     protected readonly applianceManager: ApplianceManager;
     protected readonly unitId: number;
+    protected readonly port: number;
+    protected readonly baseAddress: number;
     protected applianceId?: string;
     protected lastUpdateTime: number;
-    constructor(energyApp: EnergyApp, name: EnyoApplianceName[], networkDevice: EnyoNetworkDevice, sunspecClient: SunspecModbusClient, applianceManager: ApplianceManager, unitId?: number);
+    constructor(energyApp: EnergyApp, name: EnyoApplianceName[], networkDevice: EnyoNetworkDevice, sunspecClient: SunspecModbusClient, applianceManager: ApplianceManager, unitId?: number, port?: number, baseAddress?: number);
     /**
      * Connect to the device and create/update the appliance
      */
@@ -62,6 +64,8 @@ export declare class SunspecInverter extends BaseSunspecDevice {
  * Sunspec Battery implementation
  */
 export declare class SunspecBattery extends BaseSunspecDevice {
+    private dataBusListenerId?;
+    private dataBus?;
     /**
      * Connect to the battery and create/update the appliance
      */
@@ -150,6 +154,20 @@ export declare class SunspecBattery extends BaseSunspecDevice {
      * @returns Promise<boolean | null> - true if enabled, false if disabled, null if error
      */
     isGridChargingEnabled(): Promise<boolean | null>;
+    /**
+     * Start listening for storage commands on the data bus.
+     * Idempotent — does nothing if already listening.
+     */
+    startDataBusListening(): void;
+    /**
+     * Stop listening for storage commands on the data bus.
+     */
+    stopDataBusListening(): void;
+    private handleStorageCommand;
+    private handleStartGridCharge;
+    private handleStopGridCharge;
+    private handleSetDischargeLimit;
+    private sendCommandAcknowledge;
 }
 /**
  * Sunspec Meter implementation

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

@@ -29,7 +29,6 @@ class SunspecModbusClient {
     modbusClient = null;
     discoveredModels = new Map();
     connected = false;
-    baseAddress = 40001;
     connectionHealth;
     faultTolerantReader = null;
     modbusDataTypeConverter;
@@ -225,16 +224,48 @@ class SunspecModbusClient {
     /**
      * Detect the base address and addressing mode (0-based or 1-based) for SunSpec
      */
-    async detectSunspecBaseAddress() {
+    async detectSunspecBaseAddress(customBaseAddress) {
         if (!this.modbusClient) {
             throw new Error('Modbus client not initialized');
         }
+        // If custom base address provided, try it first (1-based, then 0-based variant)
+        if (customBaseAddress !== undefined) {
+            // Try 1-based at custom address (customBaseAddress + 1)
+            try {
+                const sunspecId = await this.modbusClient.readRegisterStringValue(customBaseAddress + 1, 2);
+                if (sunspecId.includes('SunS')) {
+                    console.log(`Detected 1-based addressing mode (base address: ${customBaseAddress + 1})`);
+                    return {
+                        baseAddress: customBaseAddress + 1,
+                        isZeroBased: false,
+                        nextAddress: customBaseAddress + 3
+                    };
+                }
+            }
+            catch (error) {
+                console.debug(`Could not read SunS at ${customBaseAddress + 1}:`, error);
+            }
+            // Try 0-based at custom address
+            try {
+                const sunspecId = await this.modbusClient.readRegisterStringValue(customBaseAddress, 2);
+                if (sunspecId.includes('SunS')) {
+                    console.log(`Detected 0-based addressing mode (base address: ${customBaseAddress})`);
+                    return {
+                        baseAddress: customBaseAddress,
+                        isZeroBased: true,
+                        nextAddress: customBaseAddress + 2
+                    };
+                }
+            }
+            catch (error) {
+                console.debug(`Could not read SunS at ${customBaseAddress}:`, error);
+            }
+        }
         // Try 1-based addressing first (most common)
         try {
             const sunspecId = await this.modbusClient.readRegisterStringValue(40001, 2);
             if (sunspecId.includes('SunS')) {
                 console.log('Detected 1-based addressing mode (base address: 40001)');
-                this.baseAddress = 40001;
                 return {
                     baseAddress: 40001,
                     isZeroBased: false,
@@ -250,7 +281,6 @@ class SunspecModbusClient {
             const sunspecId = await this.modbusClient.readRegisterStringValue(40000, 2);
             if (sunspecId.includes('SunS')) {
                 console.log('Detected 0-based addressing mode (base address: 40000)');
-                this.baseAddress = 40000;
                 return {
                     baseAddress: 40000,
                     isZeroBased: true,
@@ -261,13 +291,16 @@ class SunspecModbusClient {
         catch (error) {
             console.debug('Could not read SunS at 40000:', error);
         }
-        throw new Error('Device is not SunSpec compliant - "SunS" identifier not found at addresses 40000 or 40001');
+        const addressesChecked = customBaseAddress !== undefined
+            ? `${customBaseAddress}, ${customBaseAddress + 1}, 40000, or 40001`
+            : '40000 or 40001';
+        throw new Error(`Device is not SunSpec compliant - "SunS" identifier not found at addresses ${addressesChecked}`);
     }
     /**
      * Discover all available Sunspec models
      * Automatically detects base address (40000 or 40001) and scans from there
      */
-    async discoverModels() {
+    async discoverModels(customBaseAddress) {
         if (!this.connected) {
             throw new Error('Not connected to Modbus device');
         }
@@ -277,7 +310,7 @@ class SunspecModbusClient {
         console.log('Starting Sunspec model discovery...');
         try {
             // Detect the base address and addressing mode
-            const addressInfo = await this.detectSunspecBaseAddress();
+            const addressInfo = await this.detectSunspecBaseAddress(customBaseAddress);
             currentAddress = addressInfo.nextAddress;
             while (currentAddress < maxAddress) {
                 // Read model ID and length

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

@@ -25,7 +25,6 @@ export declare class SunspecModbusClient {
     private modbusClient;
     private discoveredModels;
     private connected;
-    private baseAddress;
     private connectionHealth;
     private faultTolerantReader;
     private modbusDataTypeConverter;
@@ -76,7 +75,7 @@ export declare class SunspecModbusClient {
     /**
      * Detect the base address and addressing mode (0-based or 1-based) for SunSpec
      */
-    detectSunspecBaseAddress(): Promise<{
+    detectSunspecBaseAddress(customBaseAddress?: number): Promise<{
         baseAddress: number;
         isZeroBased: boolean;
         nextAddress: number;
@@ -85,7 +84,7 @@ export declare class SunspecModbusClient {
      * Discover all available Sunspec models
      * Automatically detects base address (40000 or 40001) and scans from there
      */
-    discoverModels(): Promise<Map<number, SunspecModel>>;
+    discoverModels(customBaseAddress?: number): Promise<Map<number, SunspecModel>>;
     /**
      * Find a specific model by ID
      */

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.29';
+exports.SDK_VERSION = '0.0.30';
 /**
  * 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.29";
+export declare const SDK_VERSION = "0.0.30";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/sunspec-devices.d.ts

@@ -14,9 +14,11 @@ export declare abstract class BaseSunspecDevice {
     protected readonly sunspecClient: SunspecModbusClient;
     protected readonly applianceManager: ApplianceManager;
     protected readonly unitId: number;
+    protected readonly port: number;
+    protected readonly baseAddress: number;
     protected applianceId?: string;
     protected lastUpdateTime: number;
-    constructor(energyApp: EnergyApp, name: EnyoApplianceName[], networkDevice: EnyoNetworkDevice, sunspecClient: SunspecModbusClient, applianceManager: ApplianceManager, unitId?: number);
+    constructor(energyApp: EnergyApp, name: EnyoApplianceName[], networkDevice: EnyoNetworkDevice, sunspecClient: SunspecModbusClient, applianceManager: ApplianceManager, unitId?: number, port?: number, baseAddress?: number);
     /**
      * Connect to the device and create/update the appliance
      */
@@ -62,6 +64,8 @@ export declare class SunspecInverter extends BaseSunspecDevice {
  * Sunspec Battery implementation
  */
 export declare class SunspecBattery extends BaseSunspecDevice {
+    private dataBusListenerId?;
+    private dataBus?;
     /**
      * Connect to the battery and create/update the appliance
      */
@@ -150,6 +154,20 @@ export declare class SunspecBattery extends BaseSunspecDevice {
      * @returns Promise<boolean | null> - true if enabled, false if disabled, null if error
      */
     isGridChargingEnabled(): Promise<boolean | null>;
+    /**
+     * Start listening for storage commands on the data bus.
+     * Idempotent — does nothing if already listening.
+     */
+    startDataBusListening(): void;
+    /**
+     * Stop listening for storage commands on the data bus.
+     */
+    stopDataBusListening(): void;
+    private handleStorageCommand;
+    private handleStartGridCharge;
+    private handleStopGridCharge;
+    private handleSetDischargeLimit;
+    private sendCommandAcknowledge;
 }
 /**
  * Sunspec Meter implementation

package/dist/sunspec-devices.js

@@ -1,7 +1,7 @@
 import { SunspecBatteryChargeState, SunspecModelId, SunspecMPPTOperatingState, SunspecStorageMode } 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 { EnyoBatteryStateEnum, EnyoDataBusMessageEnum, EnyoInverterStateEnum, EnyoStringStateEnum } from "@enyo-energy/energy-app-sdk/dist/types/enyo-data-bus-value.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";
@@ -28,15 +28,19 @@ export class BaseSunspecDevice {
     sunspecClient;
     applianceManager;
     unitId;
+    port;
+    baseAddress;
     applianceId;
     lastUpdateTime = 0;
-    constructor(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId = 1) {
+    constructor(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId = 1, port = 502, baseAddress = 40000) {
         this.energyApp = energyApp;
         this.name = name;
         this.networkDevice = networkDevice;
         this.sunspecClient = sunspecClient;
         this.applianceManager = applianceManager;
         this.unitId = unitId;
+        this.port = port;
+        this.baseAddress = baseAddress;
     }
     /**
      * Check if the device is connected
@@ -53,9 +57,9 @@ export class BaseSunspecDevice {
     async ensureConnected() {
         if (!this.sunspecClient.isConnected()) {
             await this.sunspecClient.connect(this.networkDevice.hostname, // primary
-            502, this.unitId, this.networkDevice.ipAddress // secondary fallback
+            this.port, this.unitId, this.networkDevice.ipAddress // secondary fallback
             );
-            await this.sunspecClient.discoverModels();
+            await this.sunspecClient.discoverModels(this.baseAddress);
         }
     }
 }
@@ -67,9 +71,9 @@ export class SunspecInverter extends BaseSunspecDevice {
         // Ensure Sunspec client is connected
         if (!this.sunspecClient.isConnected()) {
             await this.sunspecClient.connect(this.networkDevice.hostname, // primary
-            502, this.unitId, this.networkDevice.ipAddress // secondary fallback
+            this.port, this.unitId, this.networkDevice.ipAddress // secondary fallback
             );
-            await this.sunspecClient.discoverModels();
+            await this.sunspecClient.discoverModels(this.baseAddress);
         }
         // Get device info from common block
         const commonData = await this.sunspecClient.readCommonBlock();
@@ -240,6 +244,8 @@ export class SunspecInverter extends BaseSunspecDevice {
  * Sunspec Battery implementation
  */
 export class SunspecBattery extends BaseSunspecDevice {
+    dataBusListenerId;
+    dataBus;
     /**
      * Connect to the battery and create/update the appliance
      */
@@ -283,12 +289,14 @@ export class SunspecBattery extends BaseSunspecDevice {
                 }
             });
             console.log(`Sunspec Battery connected: ${this.networkDevice.hostname} (${this.applianceId})`);
+            this.startDataBusListening();
         }
         catch (error) {
             console.error(`Failed to create battery appliance: ${error}`);
         }
     }
     async disconnect() {
+        this.stopDataBusListening();
         if (this.applianceId) {
             await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Offline);
         }
@@ -557,6 +565,155 @@ export class SunspecBattery extends BaseSunspecDevice {
         }
         return controls.chaGriSet === 1; // 1 = GRID, 0 = PV
     }
+    /**
+     * Start listening for storage 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([
+            EnyoDataBusMessageEnum.StartStorageGridChargeV1,
+            EnyoDataBusMessageEnum.StopStorageGridChargeV1,
+            EnyoDataBusMessageEnum.SetStorageDischargeLimitV1
+        ], (entry) => this.handleStorageCommand(entry));
+        console.log(`Battery ${this.applianceId}: started data bus listening (listener ${this.dataBusListenerId})`);
+    }
+    /**
+     * Stop listening for storage commands on the data bus.
+     */
+    stopDataBusListening() {
+        if (this.dataBusListenerId && this.dataBus) {
+            this.dataBus.unsubscribe(this.dataBusListenerId);
+            console.log(`Battery ${this.applianceId}: stopped data bus listening (listener ${this.dataBusListenerId})`);
+        }
+        this.dataBusListenerId = undefined;
+        this.dataBus = undefined;
+    }
+    handleStorageCommand(entry) {
+        if (entry.applianceId !== this.applianceId) {
+            return;
+        }
+        void (async () => {
+            try {
+                switch (entry.message) {
+                    case EnyoDataBusMessageEnum.StartStorageGridChargeV1:
+                        await this.handleStartGridCharge(entry);
+                        break;
+                    case EnyoDataBusMessageEnum.StopStorageGridChargeV1:
+                        await this.handleStopGridCharge(entry);
+                        break;
+                    case EnyoDataBusMessageEnum.SetStorageDischargeLimitV1:
+                        await this.handleSetDischargeLimit(entry);
+                        break;
+                }
+            }
+            catch (error) {
+                console.error(`Battery ${this.applianceId}: error handling ${entry.message}:`, error);
+            }
+        })();
+    }
+    async handleStartGridCharge(msg) {
+        if (!this.isConnected() || !this.applianceId) {
+            this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Rejected, "Not connected");
+            return;
+        }
+        console.log(`Battery ${this.applianceId}: handling StartStorageGridChargeV1 (powerLimitW=${msg.data.powerLimitW})`);
+        // Read current state for logging and rollback
+        const controls = await this.getBatteryControls();
+        console.log(`Battery ${this.applianceId}: current state - chaGriSet=${controls?.chaGriSet}, wChaMax=${controls?.wChaMax}, storCtlMod=${controls?.storCtlMod}`);
+        const originalChaGriSet = controls?.chaGriSet;
+        const originalWChaMax = controls?.wChaMax;
+        // Step 1: Enable grid charging (Register 17: chaGriSet=GRID)
+        const step1 = await this.enableGridCharging(true);
+        if (!step1) {
+            this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to enable grid charging');
+            return;
+        }
+        // Step 2: Set charging power (Register 2: wChaMax)
+        const step2 = await this.setChargingPower(msg.data.powerLimitW);
+        if (!step2) {
+            // Rollback step 1
+            await this.writeBatteryControls({ chaGriSet: originalChaGriSet });
+            this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to set charging power');
+            return;
+        }
+        // Step 3: Set storage mode to CHARGE (Register 5: storCtlMod=0x0001)
+        const step3 = await this.setStorageMode(SunspecStorageMode.CHARGE);
+        if (!step3) {
+            // Rollback steps 1+2
+            await this.writeBatteryControls({ chaGriSet: originalChaGriSet, wChaMax: originalWChaMax });
+            this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to set storage mode to charge');
+            return;
+        }
+        this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Accepted);
+    }
+    async handleStopGridCharge(msg) {
+        if (!this.isConnected() || !this.applianceId) {
+            this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.NotSupported);
+            return;
+        }
+        console.log(`Battery ${this.applianceId}: handling StopStorageGridChargeV1`);
+        // Read current state for logging and rollback
+        const controls = await this.getBatteryControls();
+        console.log(`Battery ${this.applianceId}: current state - chaGriSet=${controls?.chaGriSet}, storCtlMod=${controls?.storCtlMod}`);
+        const originalChaGriSet = controls?.chaGriSet;
+        // Step 1: Disable grid charging (Register 17: chaGriSet=PV)
+        const step1 = await this.enableGridCharging(false);
+        if (!step1) {
+            this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to disable grid charging');
+            return;
+        }
+        // Step 2: Set storage mode to AUTO (Register 5: storCtlMod=0x0003)
+        const step2 = await this.setStorageMode(SunspecStorageMode.AUTO);
+        if (!step2) {
+            // Rollback step 1
+            await this.writeBatteryControls({ chaGriSet: originalChaGriSet });
+            this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Rejected, 'Failed to set storage mode to auto');
+            return;
+        }
+        this.sendCommandAcknowledge(msg.id, msg.message, EnyoCommandAcknowledgeAnswerEnum.Accepted);
+    }
+    async handleSetDischargeLimit(msg) {
+        if (!this.isConnected() || !this.applianceId) {
+            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
+        const controls = await this.getBatteryControls();
+        console.log(`Battery ${this.applianceId}: current state - outWRte=${controls?.outWRte}`);
+        // Set discharge limit (Register 12: outWRte)
+        const success = await this.writeBatteryControls({ outWRte: msg.data.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

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

@@ -25,7 +25,6 @@ export declare class SunspecModbusClient {
     private modbusClient;
     private discoveredModels;
     private connected;
-    private baseAddress;
     private connectionHealth;
     private faultTolerantReader;
     private modbusDataTypeConverter;
@@ -76,7 +75,7 @@ export declare class SunspecModbusClient {
     /**
      * Detect the base address and addressing mode (0-based or 1-based) for SunSpec
      */
-    detectSunspecBaseAddress(): Promise<{
+    detectSunspecBaseAddress(customBaseAddress?: number): Promise<{
         baseAddress: number;
         isZeroBased: boolean;
         nextAddress: number;
@@ -85,7 +84,7 @@ export declare class SunspecModbusClient {
      * Discover all available Sunspec models
      * Automatically detects base address (40000 or 40001) and scans from there
      */
-    discoverModels(): Promise<Map<number, SunspecModel>>;
+    discoverModels(customBaseAddress?: number): Promise<Map<number, SunspecModel>>;
     /**
      * Find a specific model by ID
      */

package/dist/sunspec-modbus-client.js

@@ -26,7 +26,6 @@ export class SunspecModbusClient {
     modbusClient = null;
     discoveredModels = new Map();
     connected = false;
-    baseAddress = 40001;
     connectionHealth;
     faultTolerantReader = null;
     modbusDataTypeConverter;
@@ -222,16 +221,48 @@ export class SunspecModbusClient {
     /**
      * Detect the base address and addressing mode (0-based or 1-based) for SunSpec
      */
-    async detectSunspecBaseAddress() {
+    async detectSunspecBaseAddress(customBaseAddress) {
         if (!this.modbusClient) {
             throw new Error('Modbus client not initialized');
         }
+        // If custom base address provided, try it first (1-based, then 0-based variant)
+        if (customBaseAddress !== undefined) {
+            // Try 1-based at custom address (customBaseAddress + 1)
+            try {
+                const sunspecId = await this.modbusClient.readRegisterStringValue(customBaseAddress + 1, 2);
+                if (sunspecId.includes('SunS')) {
+                    console.log(`Detected 1-based addressing mode (base address: ${customBaseAddress + 1})`);
+                    return {
+                        baseAddress: customBaseAddress + 1,
+                        isZeroBased: false,
+                        nextAddress: customBaseAddress + 3
+                    };
+                }
+            }
+            catch (error) {
+                console.debug(`Could not read SunS at ${customBaseAddress + 1}:`, error);
+            }
+            // Try 0-based at custom address
+            try {
+                const sunspecId = await this.modbusClient.readRegisterStringValue(customBaseAddress, 2);
+                if (sunspecId.includes('SunS')) {
+                    console.log(`Detected 0-based addressing mode (base address: ${customBaseAddress})`);
+                    return {
+                        baseAddress: customBaseAddress,
+                        isZeroBased: true,
+                        nextAddress: customBaseAddress + 2
+                    };
+                }
+            }
+            catch (error) {
+                console.debug(`Could not read SunS at ${customBaseAddress}:`, error);
+            }
+        }
         // Try 1-based addressing first (most common)
         try {
             const sunspecId = await this.modbusClient.readRegisterStringValue(40001, 2);
             if (sunspecId.includes('SunS')) {
                 console.log('Detected 1-based addressing mode (base address: 40001)');
-                this.baseAddress = 40001;
                 return {
                     baseAddress: 40001,
                     isZeroBased: false,
@@ -247,7 +278,6 @@ export class SunspecModbusClient {
             const sunspecId = await this.modbusClient.readRegisterStringValue(40000, 2);
             if (sunspecId.includes('SunS')) {
                 console.log('Detected 0-based addressing mode (base address: 40000)');
-                this.baseAddress = 40000;
                 return {
                     baseAddress: 40000,
                     isZeroBased: true,
@@ -258,13 +288,16 @@ export class SunspecModbusClient {
         catch (error) {
             console.debug('Could not read SunS at 40000:', error);
         }
-        throw new Error('Device is not SunSpec compliant - "SunS" identifier not found at addresses 40000 or 40001');
+        const addressesChecked = customBaseAddress !== undefined
+            ? `${customBaseAddress}, ${customBaseAddress + 1}, 40000, or 40001`
+            : '40000 or 40001';
+        throw new Error(`Device is not SunSpec compliant - "SunS" identifier not found at addresses ${addressesChecked}`);
     }
     /**
      * Discover all available Sunspec models
      * Automatically detects base address (40000 or 40001) and scans from there
      */
-    async discoverModels() {
+    async discoverModels(customBaseAddress) {
         if (!this.connected) {
             throw new Error('Not connected to Modbus device');
         }
@@ -274,7 +307,7 @@ export class SunspecModbusClient {
         console.log('Starting Sunspec model discovery...');
         try {
             // Detect the base address and addressing mode
-            const addressInfo = await this.detectSunspecBaseAddress();
+            const addressInfo = await this.detectSunspecBaseAddress(customBaseAddress);
             currentAddress = addressInfo.nextAddress;
             while (currentAddress < maxAddress) {
                 // Read model ID and length

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enyo-energy/sunspec-sdk",
-  "version": "0.0.29",
+  "version": "0.0.30",
   "description": "enyo Energy Sunspec SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -37,7 +37,7 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@enyo-energy/energy-app-sdk": "^0.0.58"
+    "@enyo-energy/energy-app-sdk": "^0.0.60"
   },
   "volta": {
     "node": "22.17.0"