@enyo-energy/sunspec-sdk 0.0.82 → 0.0.84

package/dist/cjs/sunspec-devices.cjs

@@ -346,6 +346,12 @@ class SunspecInverter extends BaseSunspecDevice {
     storage;
     errorState = { activeCodes: [], lastStatus: 'healthy' };
     snapshotService;
+    // Whether we've emitted a status update at least once since (re)connecting.
+    // The persisted errorState can diverge from what the core actually shows
+    // (e.g. a faulted that was never cleared while our local state reads
+    // healthy), so we force one re-assert of the current status on the first
+    // successful read of each session to converge the core.
+    statusReassertedThisSession = false;
     constructor(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId = 1, port = 502, baseAddress = 40000, capabilities = [], retryConfig, appliance, useTls) {
         super(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId, port, baseAddress, retryConfig, appliance, useTls);
         this.capabilities = capabilities;
@@ -394,9 +400,13 @@ class SunspecInverter extends BaseSunspecDevice {
         else {
             try {
                 const existingAppliance = await this.applianceManager.findApplianceById(this.applianceId);
+                // Drop any previously core-stored `status` so we don't echo a
+                // stale `faulted` back through ApplianceSave — status is driven
+                // solely by ApplianceStateUpdateV1 (detectAndEmitStatusTransition).
+                const { status: _staleStatus, ...prevMetadata } = existingAppliance?.metadata ?? {};
                 await this.applianceManager.updateAppliance(this.applianceId, {
                     metadata: {
-                        ...existingAppliance?.metadata,
+                        ...prevMetadata,
                         connectionType: enyo_appliance_js_1.EnyoApplianceConnectionType.Connector,
                         state: enyo_appliance_js_1.EnyoApplianceStateEnum.Connected,
                         modbus: { unitId: this.unitId, baseAddress: this.baseAddress },
@@ -420,6 +430,9 @@ class SunspecInverter extends BaseSunspecDevice {
             console.log(`MPPT model found for inverter ${this.networkDevice.hostname}`);
         }
         await this.loadErrorState();
+        // Fresh session: force the next successful read to re-assert the true
+        // status so a stale faulted in the core is cleared on (re)start.
+        this.statusReassertedThisSession = false;
         this.startDataBusListening();
         // Cold-start recovery: if the persisted state says we were stuck in
         // connection_lost but connect() just succeeded (we read commonBlock,
@@ -638,16 +651,30 @@ class SunspecInverter extends BaseSunspecDevice {
         if (!this.applianceId || !this.dataBus)
             return;
         const { codes, codeIds } = this.decodeActiveErrors(data);
-        const recoveringFromConnectionLoss = this.errorState.lastStatus === 'connection_lost';
-        if (!recoveringFromConnectionLoss && !this.hasErrorSetChanged(codeIds)) {
+        // Status is driven by BOTH the decoded event-register error bits AND the
+        // SunSpec operating state. Only operatingState 7 (FAULT) is a genuine
+        // fault; MPPT (4), SLEEPING (2) and the other states are normal. This
+        // is re-evaluated every poll so a producing inverter (operatingState=4,
+        // no error bits) reports Healthy even if it was previously faulted.
+        const operatingFault = data.operatingState === sunspec_interfaces_js_1.SunspecInverterOperatingState.FAULT;
+        const newStatus = (codeIds.length > 0 || operatingFault)
+            ? enyo_appliance_js_1.EnyoApplianceStatusEnum.Faulted
+            : enyo_appliance_js_1.EnyoApplianceStatusEnum.Healthy;
+        const newLastStatus = newStatus === enyo_appliance_js_1.EnyoApplianceStatusEnum.Healthy ? 'healthy' : 'faulted';
+        // Emit when the effective status changed (covers faulted/connection_lost
+        // -> healthy convergence), when the active error-code set changed, or
+        // once per session to re-assert the true status to the core (clears a
+        // stale faulted that diverged from our local state). Otherwise stay
+        // quiet so we don't republish the same status every 10s poll.
+        const statusChanged = newLastStatus !== this.errorState.lastStatus;
+        const mustReassert = !this.statusReassertedThisSession;
+        if (!statusChanged && !this.hasErrorSetChanged(codeIds) && !mustReassert) {
             return;
         }
-        const newStatus = codeIds.length === 0
-            ? enyo_appliance_js_1.EnyoApplianceStatusEnum.Healthy
-            : enyo_appliance_js_1.EnyoApplianceStatusEnum.Faulted;
         const message = this.buildStatusMessage(newStatus, codes, timestamp);
-        console.log(`Inverter ${this.applianceId}: status transition -> ${newStatus} (codes=[${codeIds.join(', ')}])`);
+        console.log(`Inverter ${this.applianceId}: status transition -> ${newStatus} (codes=[${codeIds.join(', ')}], operatingState=${data.operatingState})`);
         this.dataBus.sendMessage([message]);
+        this.statusReassertedThisSession = true;
         this.errorState = {
             evt1: data.events,
             evt2: data.events2,
@@ -656,7 +683,7 @@ class SunspecInverter extends BaseSunspecDevice {
             evtVnd3: data.vendorEvents3,
             evtVnd4: data.vendorEvents4,
             activeCodes: codeIds,
-            lastStatus: newStatus === enyo_appliance_js_1.EnyoApplianceStatusEnum.Healthy ? 'healthy' : 'faulted',
+            lastStatus: newLastStatus,
         };
         await this.persistErrorState();
     }
@@ -1649,6 +1676,20 @@ class SunspecMeter extends BaseSunspecDevice {
         super(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId, port, baseAddress, retryConfig, appliance, useTls);
         this.capabilities = capabilities;
     }
+    /**
+     * The specific meter model instance this meter reads, when its unit hosts more than one
+     * embedded meter (e.g. a SolarEdge SE16K with the inverter + multiple meters on unit 1).
+     * When set, identity and telemetry are read from THIS block and its own preceding Common
+     * block rather than the unit's first/only meter. Unset → legacy single-meter behavior.
+     */
+    meterModel;
+    /**
+     * Bind this meter to a specific discovered meter model instance (from
+     * {@link SunspecModbusClient.findModels}). Call before {@link connect}.
+     */
+    bindMeterModel(model) {
+        this.meterModel = model;
+    }
     /**
      * Connect to the meter and create/update the appliance
      */
@@ -1656,7 +1697,8 @@ class SunspecMeter extends BaseSunspecDevice {
         // Connect with specific unit ID for meter
         await this.ensureConnected();
         // Check if meter models exist (int+SF: 201/203/204, float: 211/212/213/214)
-        const hasMeter = this.sunspecClient.findModel(this.unitId, sunspec_interfaces_js_1.SunspecModelId.Meter3Phase) !== undefined ||
+        const hasMeter = this.meterModel !== undefined ||
+            this.sunspecClient.findModel(this.unitId, sunspec_interfaces_js_1.SunspecModelId.Meter3Phase) !== undefined ||
             this.sunspecClient.findModel(this.unitId, sunspec_interfaces_js_1.SunspecModelId.MeterWye) !== undefined ||
             this.sunspecClient.findModel(this.unitId, sunspec_interfaces_js_1.SunspecModelId.MeterSinglePhase) !== undefined ||
             this.sunspecClient.findModel(this.unitId, sunspec_interfaces_js_1.SunspecModelId.Meter3PhaseWyeFloat) !== undefined ||
@@ -1666,8 +1708,12 @@ class SunspecMeter extends BaseSunspecDevice {
         if (!hasMeter) {
             throw new Error('No meter model found in device');
         }
-        // Get device info
-        const commonData = await this.sunspecClient.readCommonBlock(this.unitId);
+        // Get device info. For a bound meter instance, read ITS own Common block (the one
+        // preceding its meter model) so the appliance gets the meter's own manufacturer/model/
+        // serial — not the inverter's or a sibling meter's (the unit's first Common).
+        const commonData = this.meterModel
+            ? await this.sunspecClient.readCommonBlockForModel(this.unitId, this.meterModel)
+            : await this.sunspecClient.readCommonBlock(this.unitId);
         // Create or update appliance (skip if an existing appliance was provided)
         if (!this.applianceId) {
             try {
@@ -1741,8 +1787,8 @@ class SunspecMeter extends BaseSunspecDevice {
         const messages = [];
         const timestamp = new Date();
         try {
-            // Read meter data
-            const meterData = await this.sunspecClient.readMeterData(this.unitId);
+            // Read meter data (from the bound instance when this unit hosts multiple meters)
+            const meterData = await this.sunspecClient.readMeterData(this.unitId, this.meterModel);
             // SDK readers swallow modbus errors and return null; detect that here so the
             // appliance is marked offline and the retry manager starts its backoff.
             if (await this.markOfflineIfUnhealthy()) {

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

@@ -3,6 +3,7 @@ import { ApplianceManager, EnergyApp } from "@enyo-energy/energy-app-sdk";
 import { type EnyoAppliance, type EnyoApplianceErrorCode, 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 { SunspecModel } from "./sunspec-interfaces.cjs";
 import { ConnectionRetryManager } from "./connection-retry-manager.cjs";
 import { EnyoCommandAcknowledgeAnswerEnum, EnyoDataBusMessage, EnyoDataBusMessageEnum, EnyoDataBusMessageResolution } from "@enyo-energy/energy-app-sdk/dist/types/enyo-data-bus-value.js";
 import { BatteryCalibrator, type BatteryCalibratorConfig, type CalibrationResult, type CalibrationResultStore, type CalibrationSnapshot, type RestoreReason, SnapshotService } from "@enyo-energy/appliance-calibration";
@@ -131,6 +132,7 @@ export declare class SunspecInverter extends BaseSunspecDevice {
     private storage?;
     private errorState;
     private snapshotService?;
+    private statusReassertedThisSession;
     constructor(energyApp: EnergyApp, name: EnyoApplianceName[], networkDevice: EnyoNetworkDevice, sunspecClient: SunspecModbusClient, applianceManager: ApplianceManager, unitId?: number, port?: number, baseAddress?: number, capabilities?: SunspecInverterCapability[], retryConfig?: IRetryConfig, appliance?: EnyoAppliance, useTls?: boolean);
     connect(): Promise<void>;
     disconnect(): Promise<void>;
@@ -468,6 +470,18 @@ export declare class SunspecBattery extends BaseSunspecDevice {
 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, appliance?: EnyoAppliance, useTls?: boolean);
+    /**
+     * The specific meter model instance this meter reads, when its unit hosts more than one
+     * embedded meter (e.g. a SolarEdge SE16K with the inverter + multiple meters on unit 1).
+     * When set, identity and telemetry are read from THIS block and its own preceding Common
+     * block rather than the unit's first/only meter. Unset → legacy single-meter behavior.
+     */
+    private meterModel?;
+    /**
+     * Bind this meter to a specific discovered meter model instance (from
+     * {@link SunspecModbusClient.findModels}). Call before {@link connect}.
+     */
+    bindMeterModel(model: SunspecModel): void;
     /**
      * Connect to the meter and create/update the appliance
      */

package/dist/cjs/sunspec-interfaces.cjs

@@ -3,7 +3,7 @@
  * SunSpec block interfaces with block numbers
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUNSPEC_CONTROLLABLE_FEATURES = exports.SunspecMeterCapability = exports.SunspecBatteryFeatureModeKind = 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.SUNSPEC_CONNECTION_LOST_CODE = exports.SunspecInverterEvent1 = exports.SunspecModelId = exports.DEFAULT_RETRY_CONFIG = void 0;
+exports.SUNSPEC_CONTROLLABLE_FEATURES = exports.SunspecMeterCapability = exports.SunspecBatteryFeatureModeKind = 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.SunspecInverterOperatingState = exports.SunspecMPPTOperatingState = exports.SUNSPEC_CONNECTION_LOST_CODE = exports.SunspecInverterEvent1 = exports.SunspecModelId = exports.DEFAULT_RETRY_CONFIG = void 0;
 const enyo_battery_appliance_js_1 = require("@enyo-energy/energy-app-sdk/dist/types/enyo-battery-appliance.js");
 exports.DEFAULT_RETRY_CONFIG = {
     phases: [
@@ -87,6 +87,22 @@ var SunspecMPPTOperatingState;
     SunspecMPPTOperatingState[SunspecMPPTOperatingState["TEST"] = 9] = "TEST";
     SunspecMPPTOperatingState[SunspecMPPTOperatingState["RESERVED_10"] = 10] = "RESERVED_10";
 })(SunspecMPPTOperatingState || (exports.SunspecMPPTOperatingState = SunspecMPPTOperatingState = {}));
+/**
+ * Inverter Operating State values (SunSpec `St`, register offset 38) for
+ * models 101/103/111/112/113. Mirrors the SunSpec spec. Only `FAULT` is a
+ * genuine fault; `SLEEPING` and `MPPT` are normal production/standby states.
+ */
+var SunspecInverterOperatingState;
+(function (SunspecInverterOperatingState) {
+    SunspecInverterOperatingState[SunspecInverterOperatingState["OFF"] = 1] = "OFF";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["SLEEPING"] = 2] = "SLEEPING";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["STARTING"] = 3] = "STARTING";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["MPPT"] = 4] = "MPPT";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["THROTTLED"] = 5] = "THROTTLED";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["SHUTTING_DOWN"] = 6] = "SHUTTING_DOWN";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["FAULT"] = 7] = "FAULT";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["STANDBY"] = 8] = "STANDBY";
+})(SunspecInverterOperatingState || (exports.SunspecInverterOperatingState = SunspecInverterOperatingState = {}));
 /**
  * Battery Charge State values for Model 124
  */

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

@@ -222,6 +222,21 @@ export declare enum SunspecMPPTOperatingState {
     TEST = 9,
     RESERVED_10 = 10
 }
+/**
+ * Inverter Operating State values (SunSpec `St`, register offset 38) for
+ * models 101/103/111/112/113. Mirrors the SunSpec spec. Only `FAULT` is a
+ * genuine fault; `SLEEPING` and `MPPT` are normal production/standby states.
+ */
+export declare enum SunspecInverterOperatingState {
+    OFF = 1,
+    SLEEPING = 2,
+    STARTING = 3,
+    MPPT = 4,// Maximum Power Point Tracking active (producing)
+    THROTTLED = 5,// Power output is being limited
+    SHUTTING_DOWN = 6,
+    FAULT = 7,
+    STANDBY = 8
+}
 /**
  * Battery Charge State values for Model 124
  */

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

@@ -83,7 +83,15 @@ class SunspecModbusClient {
     // many unit IDs share that client (each unit ID is one EnergyAppModbusInstance underneath).
     modbusInstances = new Map();
     faultTolerantReaders = new Map();
+    // First-instance-wins directory (lowest address per model id). SunSpec allows a model id to
+    // repeat on one unit — most notably Common (id 1), which appears once per logical device
+    // (inverter, then each embedded meter). Keyed lookups want the PRIMARY (first) instance, so
+    // findModel/readCommonBlock resolve to the device's own block, not a later meter's.
     discoveredModelsByUnit = new Map();
+    // Full address-ordered list of every discovered instance, including repeats. Used by
+    // findModels()/readCommonBlockForModel() to enumerate multiple meters and pair each meter
+    // block with its own preceding Common block.
+    discoveredModelListByUnit = new Map();
     connectionHealth;
     modbusDataTypeConverter;
     connectionParams = null;
@@ -306,6 +314,7 @@ class SunspecModbusClient {
         this.modbusInstances.delete(unitId);
         this.faultTolerantReaders.delete(unitId);
         this.discoveredModelsByUnit.delete(unitId);
+        this.discoveredModelListByUnit.delete(unitId);
         if (instance) {
             try {
                 await instance.disconnect();
@@ -376,6 +385,17 @@ class SunspecModbusClient {
         }
         return m;
     }
+    /**
+     * Get (or create) the address-ordered list of every discovered model instance for a unit.
+     */
+    getModelList(unitId) {
+        let list = this.discoveredModelListByUnit.get(unitId);
+        if (!list) {
+            list = [];
+            this.discoveredModelListByUnit.set(unitId, list);
+        }
+        return list;
+    }
     /**
      * Enable or disable automatic reconnection
      */
@@ -473,6 +493,8 @@ class SunspecModbusClient {
         const instance = this.getInstance(unitId);
         const models = this.getModelsMap(unitId);
         models.clear();
+        const modelList = this.getModelList(unitId);
+        modelList.length = 0;
         const maxAddress = 50000; // Safety limit
         let currentAddress = 0;
         console.log(`Starting Sunspec model discovery for unit ${unitId}...`);
@@ -514,7 +536,13 @@ class SunspecModbusClient {
                     address: currentAddress,
                     length: modelLength
                 };
-                models.set(modelId, model);
+                // Keep the FIRST (lowest-address) instance per id in the keyed directory so
+                // findModel() resolves to the device's own block. Record every instance —
+                // including repeats like a meter's Common (id 1) — in the ordered list.
+                if (!models.has(modelId)) {
+                    models.set(modelId, model);
+                }
+                modelList.push(model);
                 // Per-model discovery step. The end-of-discovery summary below is the
                 // info-level outcome; the per-model walk is debug-only.
                 console.debug(`Discovered Model ${modelId} at address ${currentAddress} with length ${modelLength} (unit ${unitId})`);
@@ -525,7 +553,9 @@ class SunspecModbusClient {
         catch (error) {
             console.error(`Error during model discovery at address ${currentAddress} (unit ${unitId}): ${error}`);
         }
-        console.log(`Discovery complete for unit ${unitId}. Found ${models.size} models: [${[...models.keys()].sort((a, b) => a - b).join(', ')}]`);
+        // Report every instance in address order so repeated ids (e.g. two Common blocks, or
+        // multiple meters) are visible — models.size would hide them behind the unique keys.
+        console.log(`Discovery complete for unit ${unitId}. Found ${modelList.length} model instance(s): [${modelList.map(m => m.id).join(', ')}]`);
         return models;
     }
     /**
@@ -534,6 +564,17 @@ class SunspecModbusClient {
     findModel(unitId, modelId) {
         return this.discoveredModelsByUnit.get(unitId)?.get(modelId);
     }
+    /**
+     * Find every instance of a model id on a unit, in ascending address order.
+     *
+     * SunSpec permits a model id to repeat on a single unit — e.g. SolarEdge SE16K-class
+     * inverters expose the inverter, then one or more embedded meters, on the same Modbus unit,
+     * each meter advertising its own meter model (203/204/...) and its own Common block (id 1).
+     * `findModel` only returns the first instance; use this to enumerate them all.
+     */
+    findModels(unitId, modelId) {
+        return (this.discoveredModelListByUnit.get(unitId) ?? []).filter(m => m.id === modelId);
+    }
     /**
      * Check if a value is "unimplemented" according to Sunspec specification
      * Returns true if the value represents an unimplemented/not applicable register
@@ -1834,7 +1875,16 @@ class SunspecModbusClient {
      * When a device advertises BOTH encodings, picks the family with more discovered models
      * for this unit (see getPreferredEncoding). Never reads both.
      */
-    async readMeterData(unitId) {
+    async readMeterData(unitId, meterModel) {
+        // When a specific meter instance is given (a unit with multiple embedded meters), read
+        // exactly that block — don't let findModel pick the first/only directory entry.
+        if (meterModel) {
+            console.debug(`Using bound meter Model ${meterModel.id} at address ${meterModel.address} (length ${meterModel.length}) on unit ${unitId}`);
+            const floatIds = [211, 212, 213, 214];
+            return floatIds.includes(meterModel.id)
+                ? this.readFloatMeterData(unitId, meterModel, meterModel.id)
+                : this.readIntSfMeterData(unitId, meterModel);
+        }
         const preferred = this.getPreferredEncoding(unitId);
         const tryFloat = async () => {
             const floatIds = [213, 214, 212, 211];
@@ -1992,7 +2042,12 @@ class SunspecModbusClient {
         }
     }
     /**
-     * Read common block data (Model 1)
+     * Read common block data (Model 1).
+     *
+     * Resolves to the unit's FIRST Common block — the leading device's own identity (the
+     * inverter on a SolarEdge SE16K-class unit). When a unit embeds meters, each meter has its
+     * own later Common block; read those with {@link readCommonBlockForModel} so a meter reports
+     * its own manufacturer/model/serial instead of the inverter's (or a sibling meter's).
      */
     async readCommonBlock(unitId) {
         const model = this.findModel(unitId, sunspec_interfaces_js_1.SunspecModelId.Common);
@@ -2002,6 +2057,31 @@ class SunspecModbusClient {
             console.debug(`Common block model not found on unit ${unitId}`);
             return null;
         }
+        return this.readCommonBlockAt(unitId, model);
+    }
+    /**
+     * Read the Common (id 1) block that belongs to a specific device model — the Common instance
+     * immediately preceding the model's address. SunSpec lays out each logical device as
+     * `Common → device model(s)`, so a meter's identity is the Common block right before its meter
+     * model. Falls back to the unit's first Common when none precedes (shouldn't happen for a
+     * well-formed map). Used to give each embedded meter its own appliance identity.
+     */
+    async readCommonBlockForModel(unitId, deviceModel) {
+        const preceding = this.findModels(unitId, sunspec_interfaces_js_1.SunspecModelId.Common)
+            .filter(c => c.address <= deviceModel.address)
+            .sort((a, b) => a.address - b.address)
+            .pop();
+        const model = preceding ?? this.findModel(unitId, sunspec_interfaces_js_1.SunspecModelId.Common);
+        if (!model) {
+            console.debug(`Common block model not found on unit ${unitId} for model ${deviceModel.id}@${deviceModel.address}`);
+            return null;
+        }
+        return this.readCommonBlockAt(unitId, model);
+    }
+    /**
+     * Decode a given Common (Model 1) block instance into identity fields.
+     */
+    async readCommonBlockAt(unitId, model) {
         console.debug(`Reading Common Block - Model address: ${model.address} (unit ${unitId})`);
         try {
             // Read entire model block in a single Modbus call

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

@@ -37,6 +37,7 @@ export declare class SunspecModbusClient {
     private modbusInstances;
     private faultTolerantReaders;
     private discoveredModelsByUnit;
+    private discoveredModelListByUnit;
     private connectionHealth;
     private modbusDataTypeConverter;
     private connectionParams;
@@ -128,6 +129,10 @@ export declare class SunspecModbusClient {
      * Get (or create) the discovered-models map for a unit.
      */
     private getModelsMap;
+    /**
+     * Get (or create) the address-ordered list of every discovered model instance for a unit.
+     */
+    private getModelList;
     /**
      * Enable or disable automatic reconnection
      */
@@ -153,6 +158,15 @@ export declare class SunspecModbusClient {
      * Find a specific model by ID for a given unit
      */
     findModel(unitId: number, modelId: number): SunspecModel | undefined;
+    /**
+     * Find every instance of a model id on a unit, in ascending address order.
+     *
+     * SunSpec permits a model id to repeat on a single unit — e.g. SolarEdge SE16K-class
+     * inverters expose the inverter, then one or more embedded meters, on the same Modbus unit,
+     * each meter advertising its own meter model (203/204/...) and its own Common block (id 1).
+     * `findModel` only returns the first instance; use this to enumerate them all.
+     */
+    findModels(unitId: number, modelId: number): SunspecModel[];
     /**
      * Check if a value is "unimplemented" according to Sunspec specification
      * Returns true if the value represents an unimplemented/not applicable register
@@ -337,7 +351,7 @@ export declare class SunspecModbusClient {
      * When a device advertises BOTH encodings, picks the family with more discovered models
      * for this unit (see getPreferredEncoding). Never reads both.
      */
-    readMeterData(unitId: number): Promise<SunspecMeterData | null>;
+    readMeterData(unitId: number, meterModel?: SunspecModel): Promise<SunspecMeterData | null>;
     /**
      * Read meter data from an int+SF variant model (201/203/204). Extracted from the original
      * readMeterData body so the preferred-encoding dispatcher above can branch cleanly without
@@ -362,9 +376,26 @@ export declare class SunspecModbusClient {
      */
     private readFloatMeterData;
     /**
-     * Read common block data (Model 1)
+     * Read common block data (Model 1).
+     *
+     * Resolves to the unit's FIRST Common block — the leading device's own identity (the
+     * inverter on a SolarEdge SE16K-class unit). When a unit embeds meters, each meter has its
+     * own later Common block; read those with {@link readCommonBlockForModel} so a meter reports
+     * its own manufacturer/model/serial instead of the inverter's (or a sibling meter's).
      */
     readCommonBlock(unitId: number): Promise<any>;
+    /**
+     * Read the Common (id 1) block that belongs to a specific device model — the Common instance
+     * immediately preceding the model's address. SunSpec lays out each logical device as
+     * `Common → device model(s)`, so a meter's identity is the Common block right before its meter
+     * model. Falls back to the unit's first Common when none precedes (shouldn't happen for a
+     * well-formed map). Used to give each embedded meter its own appliance identity.
+     */
+    readCommonBlockForModel(unitId: number, deviceModel: SunspecModel): Promise<any>;
+    /**
+     * Decode a given Common (Model 1) block instance into identity fields.
+     */
+    private readCommonBlockAt;
     /**
      * Get serial number from device
      */

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

package/dist/sunspec-devices.d.ts

@@ -3,6 +3,7 @@ import { ApplianceManager, EnergyApp } from "@enyo-energy/energy-app-sdk";
 import { type EnyoAppliance, type EnyoApplianceErrorCode, 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.js";
+import { SunspecModel } from "./sunspec-interfaces.js";
 import { ConnectionRetryManager } from "./connection-retry-manager.js";
 import { EnyoCommandAcknowledgeAnswerEnum, EnyoDataBusMessage, EnyoDataBusMessageEnum, EnyoDataBusMessageResolution } from "@enyo-energy/energy-app-sdk/dist/types/enyo-data-bus-value.js";
 import { BatteryCalibrator, type BatteryCalibratorConfig, type CalibrationResult, type CalibrationResultStore, type CalibrationSnapshot, type RestoreReason, SnapshotService } from "@enyo-energy/appliance-calibration";
@@ -131,6 +132,7 @@ export declare class SunspecInverter extends BaseSunspecDevice {
     private storage?;
     private errorState;
     private snapshotService?;
+    private statusReassertedThisSession;
     constructor(energyApp: EnergyApp, name: EnyoApplianceName[], networkDevice: EnyoNetworkDevice, sunspecClient: SunspecModbusClient, applianceManager: ApplianceManager, unitId?: number, port?: number, baseAddress?: number, capabilities?: SunspecInverterCapability[], retryConfig?: IRetryConfig, appliance?: EnyoAppliance, useTls?: boolean);
     connect(): Promise<void>;
     disconnect(): Promise<void>;
@@ -468,6 +470,18 @@ export declare class SunspecBattery extends BaseSunspecDevice {
 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, appliance?: EnyoAppliance, useTls?: boolean);
+    /**
+     * The specific meter model instance this meter reads, when its unit hosts more than one
+     * embedded meter (e.g. a SolarEdge SE16K with the inverter + multiple meters on unit 1).
+     * When set, identity and telemetry are read from THIS block and its own preceding Common
+     * block rather than the unit's first/only meter. Unset → legacy single-meter behavior.
+     */
+    private meterModel?;
+    /**
+     * Bind this meter to a specific discovered meter model instance (from
+     * {@link SunspecModbusClient.findModels}). Call before {@link connect}.
+     */
+    bindMeterModel(model: SunspecModel): void;
     /**
      * Connect to the meter and create/update the appliance
      */

package/dist/sunspec-devices.js

@@ -1,4 +1,4 @@
-import { SunspecBatteryChargeState, SunspecBatteryFeatureModeKind, SunspecEnableControl, SunspecInverterCapability, SunspecInverterEvent1, SunspecModelId, SunspecMPPTOperatingState, SunspecStorageMode, SUNSPEC_CONNECTION_LOST_CODE } from "./sunspec-interfaces.js";
+import { SunspecBatteryChargeState, SunspecBatteryFeatureModeKind, SunspecEnableControl, SunspecInverterCapability, SunspecInverterEvent1, SunspecInverterOperatingState, SunspecModelId, SunspecMPPTOperatingState, SunspecStorageMode, SUNSPEC_CONNECTION_LOST_CODE } from "./sunspec-interfaces.js";
 import { randomUUID } from "node:crypto";
 import { EnyoApplianceConnectionType, EnyoApplianceStateEnum, EnyoApplianceStatusEnum, EnyoApplianceTopologyFeatureEnum, EnyoApplianceTypeEnum } from "@enyo-energy/energy-app-sdk/dist/types/enyo-appliance.js";
 import { ConnectionRetryManager } from "./connection-retry-manager.js";
@@ -339,6 +339,12 @@ export class SunspecInverter extends BaseSunspecDevice {
     storage;
     errorState = { activeCodes: [], lastStatus: 'healthy' };
     snapshotService;
+    // Whether we've emitted a status update at least once since (re)connecting.
+    // The persisted errorState can diverge from what the core actually shows
+    // (e.g. a faulted that was never cleared while our local state reads
+    // healthy), so we force one re-assert of the current status on the first
+    // successful read of each session to converge the core.
+    statusReassertedThisSession = false;
     constructor(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId = 1, port = 502, baseAddress = 40000, capabilities = [], retryConfig, appliance, useTls) {
         super(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId, port, baseAddress, retryConfig, appliance, useTls);
         this.capabilities = capabilities;
@@ -387,9 +393,13 @@ export class SunspecInverter extends BaseSunspecDevice {
         else {
             try {
                 const existingAppliance = await this.applianceManager.findApplianceById(this.applianceId);
+                // Drop any previously core-stored `status` so we don't echo a
+                // stale `faulted` back through ApplianceSave — status is driven
+                // solely by ApplianceStateUpdateV1 (detectAndEmitStatusTransition).
+                const { status: _staleStatus, ...prevMetadata } = existingAppliance?.metadata ?? {};
                 await this.applianceManager.updateAppliance(this.applianceId, {
                     metadata: {
-                        ...existingAppliance?.metadata,
+                        ...prevMetadata,
                         connectionType: EnyoApplianceConnectionType.Connector,
                         state: EnyoApplianceStateEnum.Connected,
                         modbus: { unitId: this.unitId, baseAddress: this.baseAddress },
@@ -413,6 +423,9 @@ export class SunspecInverter extends BaseSunspecDevice {
             console.log(`MPPT model found for inverter ${this.networkDevice.hostname}`);
         }
         await this.loadErrorState();
+        // Fresh session: force the next successful read to re-assert the true
+        // status so a stale faulted in the core is cleared on (re)start.
+        this.statusReassertedThisSession = false;
         this.startDataBusListening();
         // Cold-start recovery: if the persisted state says we were stuck in
         // connection_lost but connect() just succeeded (we read commonBlock,
@@ -631,16 +644,30 @@ export class SunspecInverter extends BaseSunspecDevice {
         if (!this.applianceId || !this.dataBus)
             return;
         const { codes, codeIds } = this.decodeActiveErrors(data);
-        const recoveringFromConnectionLoss = this.errorState.lastStatus === 'connection_lost';
-        if (!recoveringFromConnectionLoss && !this.hasErrorSetChanged(codeIds)) {
+        // Status is driven by BOTH the decoded event-register error bits AND the
+        // SunSpec operating state. Only operatingState 7 (FAULT) is a genuine
+        // fault; MPPT (4), SLEEPING (2) and the other states are normal. This
+        // is re-evaluated every poll so a producing inverter (operatingState=4,
+        // no error bits) reports Healthy even if it was previously faulted.
+        const operatingFault = data.operatingState === SunspecInverterOperatingState.FAULT;
+        const newStatus = (codeIds.length > 0 || operatingFault)
+            ? EnyoApplianceStatusEnum.Faulted
+            : EnyoApplianceStatusEnum.Healthy;
+        const newLastStatus = newStatus === EnyoApplianceStatusEnum.Healthy ? 'healthy' : 'faulted';
+        // Emit when the effective status changed (covers faulted/connection_lost
+        // -> healthy convergence), when the active error-code set changed, or
+        // once per session to re-assert the true status to the core (clears a
+        // stale faulted that diverged from our local state). Otherwise stay
+        // quiet so we don't republish the same status every 10s poll.
+        const statusChanged = newLastStatus !== this.errorState.lastStatus;
+        const mustReassert = !this.statusReassertedThisSession;
+        if (!statusChanged && !this.hasErrorSetChanged(codeIds) && !mustReassert) {
             return;
         }
-        const newStatus = codeIds.length === 0
-            ? EnyoApplianceStatusEnum.Healthy
-            : EnyoApplianceStatusEnum.Faulted;
         const message = this.buildStatusMessage(newStatus, codes, timestamp);
-        console.log(`Inverter ${this.applianceId}: status transition -> ${newStatus} (codes=[${codeIds.join(', ')}])`);
+        console.log(`Inverter ${this.applianceId}: status transition -> ${newStatus} (codes=[${codeIds.join(', ')}], operatingState=${data.operatingState})`);
         this.dataBus.sendMessage([message]);
+        this.statusReassertedThisSession = true;
         this.errorState = {
             evt1: data.events,
             evt2: data.events2,
@@ -649,7 +676,7 @@ export class SunspecInverter extends BaseSunspecDevice {
             evtVnd3: data.vendorEvents3,
             evtVnd4: data.vendorEvents4,
             activeCodes: codeIds,
-            lastStatus: newStatus === EnyoApplianceStatusEnum.Healthy ? 'healthy' : 'faulted',
+            lastStatus: newLastStatus,
         };
         await this.persistErrorState();
     }
@@ -1640,6 +1667,20 @@ export class SunspecMeter extends BaseSunspecDevice {
         super(energyApp, name, networkDevice, sunspecClient, applianceManager, unitId, port, baseAddress, retryConfig, appliance, useTls);
         this.capabilities = capabilities;
     }
+    /**
+     * The specific meter model instance this meter reads, when its unit hosts more than one
+     * embedded meter (e.g. a SolarEdge SE16K with the inverter + multiple meters on unit 1).
+     * When set, identity and telemetry are read from THIS block and its own preceding Common
+     * block rather than the unit's first/only meter. Unset → legacy single-meter behavior.
+     */
+    meterModel;
+    /**
+     * Bind this meter to a specific discovered meter model instance (from
+     * {@link SunspecModbusClient.findModels}). Call before {@link connect}.
+     */
+    bindMeterModel(model) {
+        this.meterModel = model;
+    }
     /**
      * Connect to the meter and create/update the appliance
      */
@@ -1647,7 +1688,8 @@ export class SunspecMeter extends BaseSunspecDevice {
         // Connect with specific unit ID for meter
         await this.ensureConnected();
         // Check if meter models exist (int+SF: 201/203/204, float: 211/212/213/214)
-        const hasMeter = this.sunspecClient.findModel(this.unitId, SunspecModelId.Meter3Phase) !== undefined ||
+        const hasMeter = this.meterModel !== undefined ||
+            this.sunspecClient.findModel(this.unitId, SunspecModelId.Meter3Phase) !== undefined ||
             this.sunspecClient.findModel(this.unitId, SunspecModelId.MeterWye) !== undefined ||
             this.sunspecClient.findModel(this.unitId, SunspecModelId.MeterSinglePhase) !== undefined ||
             this.sunspecClient.findModel(this.unitId, SunspecModelId.Meter3PhaseWyeFloat) !== undefined ||
@@ -1657,8 +1699,12 @@ export class SunspecMeter extends BaseSunspecDevice {
         if (!hasMeter) {
             throw new Error('No meter model found in device');
         }
-        // Get device info
-        const commonData = await this.sunspecClient.readCommonBlock(this.unitId);
+        // Get device info. For a bound meter instance, read ITS own Common block (the one
+        // preceding its meter model) so the appliance gets the meter's own manufacturer/model/
+        // serial — not the inverter's or a sibling meter's (the unit's first Common).
+        const commonData = this.meterModel
+            ? await this.sunspecClient.readCommonBlockForModel(this.unitId, this.meterModel)
+            : await this.sunspecClient.readCommonBlock(this.unitId);
         // Create or update appliance (skip if an existing appliance was provided)
         if (!this.applianceId) {
             try {
@@ -1732,8 +1778,8 @@ export class SunspecMeter extends BaseSunspecDevice {
         const messages = [];
         const timestamp = new Date();
         try {
-            // Read meter data
-            const meterData = await this.sunspecClient.readMeterData(this.unitId);
+            // Read meter data (from the bound instance when this unit hosts multiple meters)
+            const meterData = await this.sunspecClient.readMeterData(this.unitId, this.meterModel);
             // SDK readers swallow modbus errors and return null; detect that here so the
             // appliance is marked offline and the retry manager starts its backoff.
             if (await this.markOfflineIfUnhealthy()) {

package/dist/sunspec-interfaces.d.ts

@@ -222,6 +222,21 @@ export declare enum SunspecMPPTOperatingState {
     TEST = 9,
     RESERVED_10 = 10
 }
+/**
+ * Inverter Operating State values (SunSpec `St`, register offset 38) for
+ * models 101/103/111/112/113. Mirrors the SunSpec spec. Only `FAULT` is a
+ * genuine fault; `SLEEPING` and `MPPT` are normal production/standby states.
+ */
+export declare enum SunspecInverterOperatingState {
+    OFF = 1,
+    SLEEPING = 2,
+    STARTING = 3,
+    MPPT = 4,// Maximum Power Point Tracking active (producing)
+    THROTTLED = 5,// Power output is being limited
+    SHUTTING_DOWN = 6,
+    FAULT = 7,
+    STANDBY = 8
+}
 /**
  * Battery Charge State values for Model 124
  */

package/dist/sunspec-interfaces.js

@@ -84,6 +84,22 @@ export var SunspecMPPTOperatingState;
     SunspecMPPTOperatingState[SunspecMPPTOperatingState["TEST"] = 9] = "TEST";
     SunspecMPPTOperatingState[SunspecMPPTOperatingState["RESERVED_10"] = 10] = "RESERVED_10";
 })(SunspecMPPTOperatingState || (SunspecMPPTOperatingState = {}));
+/**
+ * Inverter Operating State values (SunSpec `St`, register offset 38) for
+ * models 101/103/111/112/113. Mirrors the SunSpec spec. Only `FAULT` is a
+ * genuine fault; `SLEEPING` and `MPPT` are normal production/standby states.
+ */
+export var SunspecInverterOperatingState;
+(function (SunspecInverterOperatingState) {
+    SunspecInverterOperatingState[SunspecInverterOperatingState["OFF"] = 1] = "OFF";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["SLEEPING"] = 2] = "SLEEPING";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["STARTING"] = 3] = "STARTING";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["MPPT"] = 4] = "MPPT";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["THROTTLED"] = 5] = "THROTTLED";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["SHUTTING_DOWN"] = 6] = "SHUTTING_DOWN";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["FAULT"] = 7] = "FAULT";
+    SunspecInverterOperatingState[SunspecInverterOperatingState["STANDBY"] = 8] = "STANDBY";
+})(SunspecInverterOperatingState || (SunspecInverterOperatingState = {}));
 /**
  * Battery Charge State values for Model 124
  */

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

@@ -37,6 +37,7 @@ export declare class SunspecModbusClient {
     private modbusInstances;
     private faultTolerantReaders;
     private discoveredModelsByUnit;
+    private discoveredModelListByUnit;
     private connectionHealth;
     private modbusDataTypeConverter;
     private connectionParams;
@@ -128,6 +129,10 @@ export declare class SunspecModbusClient {
      * Get (or create) the discovered-models map for a unit.
      */
     private getModelsMap;
+    /**
+     * Get (or create) the address-ordered list of every discovered model instance for a unit.
+     */
+    private getModelList;
     /**
      * Enable or disable automatic reconnection
      */
@@ -153,6 +158,15 @@ export declare class SunspecModbusClient {
      * Find a specific model by ID for a given unit
      */
     findModel(unitId: number, modelId: number): SunspecModel | undefined;
+    /**
+     * Find every instance of a model id on a unit, in ascending address order.
+     *
+     * SunSpec permits a model id to repeat on a single unit — e.g. SolarEdge SE16K-class
+     * inverters expose the inverter, then one or more embedded meters, on the same Modbus unit,
+     * each meter advertising its own meter model (203/204/...) and its own Common block (id 1).
+     * `findModel` only returns the first instance; use this to enumerate them all.
+     */
+    findModels(unitId: number, modelId: number): SunspecModel[];
     /**
      * Check if a value is "unimplemented" according to Sunspec specification
      * Returns true if the value represents an unimplemented/not applicable register
@@ -337,7 +351,7 @@ export declare class SunspecModbusClient {
      * When a device advertises BOTH encodings, picks the family with more discovered models
      * for this unit (see getPreferredEncoding). Never reads both.
      */
-    readMeterData(unitId: number): Promise<SunspecMeterData | null>;
+    readMeterData(unitId: number, meterModel?: SunspecModel): Promise<SunspecMeterData | null>;
     /**
      * Read meter data from an int+SF variant model (201/203/204). Extracted from the original
      * readMeterData body so the preferred-encoding dispatcher above can branch cleanly without
@@ -362,9 +376,26 @@ export declare class SunspecModbusClient {
      */
     private readFloatMeterData;
     /**
-     * Read common block data (Model 1)
+     * Read common block data (Model 1).
+     *
+     * Resolves to the unit's FIRST Common block — the leading device's own identity (the
+     * inverter on a SolarEdge SE16K-class unit). When a unit embeds meters, each meter has its
+     * own later Common block; read those with {@link readCommonBlockForModel} so a meter reports
+     * its own manufacturer/model/serial instead of the inverter's (or a sibling meter's).
      */
     readCommonBlock(unitId: number): Promise<any>;
+    /**
+     * Read the Common (id 1) block that belongs to a specific device model — the Common instance
+     * immediately preceding the model's address. SunSpec lays out each logical device as
+     * `Common → device model(s)`, so a meter's identity is the Common block right before its meter
+     * model. Falls back to the unit's first Common when none precedes (shouldn't happen for a
+     * well-formed map). Used to give each embedded meter its own appliance identity.
+     */
+    readCommonBlockForModel(unitId: number, deviceModel: SunspecModel): Promise<any>;
+    /**
+     * Decode a given Common (Model 1) block instance into identity fields.
+     */
+    private readCommonBlockAt;
     /**
      * Get serial number from device
      */

package/dist/sunspec-modbus-client.js

@@ -78,7 +78,15 @@ export class SunspecModbusClient {
     // many unit IDs share that client (each unit ID is one EnergyAppModbusInstance underneath).
     modbusInstances = new Map();
     faultTolerantReaders = new Map();
+    // First-instance-wins directory (lowest address per model id). SunSpec allows a model id to
+    // repeat on one unit — most notably Common (id 1), which appears once per logical device
+    // (inverter, then each embedded meter). Keyed lookups want the PRIMARY (first) instance, so
+    // findModel/readCommonBlock resolve to the device's own block, not a later meter's.
     discoveredModelsByUnit = new Map();
+    // Full address-ordered list of every discovered instance, including repeats. Used by
+    // findModels()/readCommonBlockForModel() to enumerate multiple meters and pair each meter
+    // block with its own preceding Common block.
+    discoveredModelListByUnit = new Map();
     connectionHealth;
     modbusDataTypeConverter;
     connectionParams = null;
@@ -301,6 +309,7 @@ export class SunspecModbusClient {
         this.modbusInstances.delete(unitId);
         this.faultTolerantReaders.delete(unitId);
         this.discoveredModelsByUnit.delete(unitId);
+        this.discoveredModelListByUnit.delete(unitId);
         if (instance) {
             try {
                 await instance.disconnect();
@@ -371,6 +380,17 @@ export class SunspecModbusClient {
         }
         return m;
     }
+    /**
+     * Get (or create) the address-ordered list of every discovered model instance for a unit.
+     */
+    getModelList(unitId) {
+        let list = this.discoveredModelListByUnit.get(unitId);
+        if (!list) {
+            list = [];
+            this.discoveredModelListByUnit.set(unitId, list);
+        }
+        return list;
+    }
     /**
      * Enable or disable automatic reconnection
      */
@@ -468,6 +488,8 @@ export class SunspecModbusClient {
         const instance = this.getInstance(unitId);
         const models = this.getModelsMap(unitId);
         models.clear();
+        const modelList = this.getModelList(unitId);
+        modelList.length = 0;
         const maxAddress = 50000; // Safety limit
         let currentAddress = 0;
         console.log(`Starting Sunspec model discovery for unit ${unitId}...`);
@@ -509,7 +531,13 @@ export class SunspecModbusClient {
                     address: currentAddress,
                     length: modelLength
                 };
-                models.set(modelId, model);
+                // Keep the FIRST (lowest-address) instance per id in the keyed directory so
+                // findModel() resolves to the device's own block. Record every instance —
+                // including repeats like a meter's Common (id 1) — in the ordered list.
+                if (!models.has(modelId)) {
+                    models.set(modelId, model);
+                }
+                modelList.push(model);
                 // Per-model discovery step. The end-of-discovery summary below is the
                 // info-level outcome; the per-model walk is debug-only.
                 console.debug(`Discovered Model ${modelId} at address ${currentAddress} with length ${modelLength} (unit ${unitId})`);
@@ -520,7 +548,9 @@ export class SunspecModbusClient {
         catch (error) {
             console.error(`Error during model discovery at address ${currentAddress} (unit ${unitId}): ${error}`);
         }
-        console.log(`Discovery complete for unit ${unitId}. Found ${models.size} models: [${[...models.keys()].sort((a, b) => a - b).join(', ')}]`);
+        // Report every instance in address order so repeated ids (e.g. two Common blocks, or
+        // multiple meters) are visible — models.size would hide them behind the unique keys.
+        console.log(`Discovery complete for unit ${unitId}. Found ${modelList.length} model instance(s): [${modelList.map(m => m.id).join(', ')}]`);
         return models;
     }
     /**
@@ -529,6 +559,17 @@ export class SunspecModbusClient {
     findModel(unitId, modelId) {
         return this.discoveredModelsByUnit.get(unitId)?.get(modelId);
     }
+    /**
+     * Find every instance of a model id on a unit, in ascending address order.
+     *
+     * SunSpec permits a model id to repeat on a single unit — e.g. SolarEdge SE16K-class
+     * inverters expose the inverter, then one or more embedded meters, on the same Modbus unit,
+     * each meter advertising its own meter model (203/204/...) and its own Common block (id 1).
+     * `findModel` only returns the first instance; use this to enumerate them all.
+     */
+    findModels(unitId, modelId) {
+        return (this.discoveredModelListByUnit.get(unitId) ?? []).filter(m => m.id === modelId);
+    }
     /**
      * Check if a value is "unimplemented" according to Sunspec specification
      * Returns true if the value represents an unimplemented/not applicable register
@@ -1829,7 +1870,16 @@ export class SunspecModbusClient {
      * When a device advertises BOTH encodings, picks the family with more discovered models
      * for this unit (see getPreferredEncoding). Never reads both.
      */
-    async readMeterData(unitId) {
+    async readMeterData(unitId, meterModel) {
+        // When a specific meter instance is given (a unit with multiple embedded meters), read
+        // exactly that block — don't let findModel pick the first/only directory entry.
+        if (meterModel) {
+            console.debug(`Using bound meter Model ${meterModel.id} at address ${meterModel.address} (length ${meterModel.length}) on unit ${unitId}`);
+            const floatIds = [211, 212, 213, 214];
+            return floatIds.includes(meterModel.id)
+                ? this.readFloatMeterData(unitId, meterModel, meterModel.id)
+                : this.readIntSfMeterData(unitId, meterModel);
+        }
         const preferred = this.getPreferredEncoding(unitId);
         const tryFloat = async () => {
             const floatIds = [213, 214, 212, 211];
@@ -1987,7 +2037,12 @@ export class SunspecModbusClient {
         }
     }
     /**
-     * Read common block data (Model 1)
+     * Read common block data (Model 1).
+     *
+     * Resolves to the unit's FIRST Common block — the leading device's own identity (the
+     * inverter on a SolarEdge SE16K-class unit). When a unit embeds meters, each meter has its
+     * own later Common block; read those with {@link readCommonBlockForModel} so a meter reports
+     * its own manufacturer/model/serial instead of the inverter's (or a sibling meter's).
      */
     async readCommonBlock(unitId) {
         const model = this.findModel(unitId, SunspecModelId.Common);
@@ -1997,6 +2052,31 @@ export class SunspecModbusClient {
             console.debug(`Common block model not found on unit ${unitId}`);
             return null;
         }
+        return this.readCommonBlockAt(unitId, model);
+    }
+    /**
+     * Read the Common (id 1) block that belongs to a specific device model — the Common instance
+     * immediately preceding the model's address. SunSpec lays out each logical device as
+     * `Common → device model(s)`, so a meter's identity is the Common block right before its meter
+     * model. Falls back to the unit's first Common when none precedes (shouldn't happen for a
+     * well-formed map). Used to give each embedded meter its own appliance identity.
+     */
+    async readCommonBlockForModel(unitId, deviceModel) {
+        const preceding = this.findModels(unitId, SunspecModelId.Common)
+            .filter(c => c.address <= deviceModel.address)
+            .sort((a, b) => a.address - b.address)
+            .pop();
+        const model = preceding ?? this.findModel(unitId, SunspecModelId.Common);
+        if (!model) {
+            console.debug(`Common block model not found on unit ${unitId} for model ${deviceModel.id}@${deviceModel.address}`);
+            return null;
+        }
+        return this.readCommonBlockAt(unitId, model);
+    }
+    /**
+     * Decode a given Common (Model 1) block instance into identity fields.
+     */
+    async readCommonBlockAt(unitId, model) {
         console.debug(`Reading Common Block - Model address: ${model.address} (unit ${unitId})`);
         try {
             // Read entire model block in a single Modbus call

package/dist/version.d.ts

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export declare const SDK_VERSION = "0.0.82";
+export declare const SDK_VERSION = "0.0.84";
 /**
  * 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.82';
+export const SDK_VERSION = '0.0.84';
 /**
  * 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.82",
+  "version": "0.0.84",
   "description": "enyo Energy Sunspec SDK",
   "type": "module",
   "main": "dist/index.js",