@enyo-energy/sunspec-sdk 0.0.1

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

@@ -0,0 +1,240 @@
+/**
+ * SunSpec block interfaces with block numbers
+ */
+/**
+ * Base interface for all SunSpec blocks
+ */
+export interface SunspecBlock {
+    blockNumber: number;
+    blockAddress?: number;
+    blockLength?: number;
+}
+/**
+ * Common Sunspec Model IDs
+ */
+export declare enum SunspecModelId {
+    Common = 1,
+    Inverter3Phase = 103,
+    InverterSinglePhase = 101,
+    MPPT = 160,
+    Battery = 124,
+    BatteryBase = 802,
+    BatteryControl = 803,
+    MeterSinglePhase = 201,
+    Meter3Phase = 203,
+    MeterWye = 204,
+    Nameplate = 120,
+    Settings = 121,
+    Status = 122,
+    Controls = 123,
+    EndMarker = 65535
+}
+/**
+ * Model information discovered during scanning
+ */
+export interface SunspecModel {
+    id: number;
+    address: number;
+    length: number;
+}
+/**
+ * Data types for Sunspec registers
+ */
+export type RegisterValue = number | string | bigint;
+/**
+ * Scale factor cache
+ */
+export interface ScaleFactors {
+    [key: string]: number;
+}
+/**
+ * Common block (Model 1) data structure
+ */
+export interface SunspecCommonBlock extends SunspecBlock {
+    blockNumber: 1;
+    manufacturer?: string;
+    model?: string;
+    options?: string;
+    version?: string;
+    serialNumber?: string;
+    deviceAddress?: number;
+}
+/**
+ * Inverter data structure based on Model 103
+ */
+export interface SunspecInverterData extends SunspecBlock {
+    blockNumber: 103 | 101;
+    acCurrent?: number;
+    phaseACurrent?: number;
+    phaseBCurrent?: number;
+    phaseCCurrent?: number;
+    voltageAB?: number;
+    voltageBC?: number;
+    voltageCA?: number;
+    voltageAN?: number;
+    voltageBN?: number;
+    voltageCN?: number;
+    acPower?: number;
+    frequency?: number;
+    apparentPower?: number;
+    reactivePower?: number;
+    powerFactor?: number;
+    acEnergy?: bigint;
+    dcCurrent?: number;
+    dcVoltage?: number;
+    dcPower?: number;
+    cabinetTemperature?: number;
+    heatSinkTemperature?: number;
+    transformerTemperature?: number;
+    otherTemperature?: number;
+    operatingState?: number;
+    vendorState?: number;
+    events?: number;
+    events2?: number;
+    vendorEvents1?: number;
+    vendorEvents2?: number;
+    vendorEvents3?: number;
+    vendorEvents4?: number;
+}
+/**
+ * MPPT data structure based on Model 160
+ */
+export interface SunspecMPPTData extends SunspecBlock {
+    blockNumber: 160;
+    id: number;
+    stringId?: string;
+    dcCurrent?: number;
+    dcCurrentSF?: number;
+    dcVoltage?: number;
+    dcVoltageSF?: number;
+    dcPower?: number;
+    dcPowerSF?: number;
+    dcEnergy?: bigint;
+    dcEnergySF?: number;
+    timestamp?: number;
+    temperature?: number;
+    temperatureSF?: number;
+    operatingState?: number;
+    vendorState?: number;
+    events?: number;
+}
+/**
+ * Battery data structure
+ */
+export interface SunspecBatteryData extends SunspecBlock {
+    blockNumber: 124 | 802 | 803;
+    soc?: number;
+    soh?: number;
+    chargePower?: number;
+    dischargePower?: number;
+    voltage?: number;
+    current?: number;
+    temperature?: number;
+    status?: number;
+}
+/**
+ * Meter data structure
+ */
+export interface SunspecMeterData extends SunspecBlock {
+    blockNumber: 201 | 203 | 204;
+    totalPower?: number;
+    phaseAPower?: number;
+    phaseBPower?: number;
+    phaseCPower?: number;
+    totalEnergy?: bigint;
+    exportedEnergy?: bigint;
+    importedEnergy?: bigint;
+    voltage?: number;
+    current?: number;
+    frequency?: number;
+}
+/**
+ * Block 121 - Inverter Basic Settings
+ * Reference: SunSpec Model 121
+ */
+export interface SunspecInverterSettings extends SunspecBlock {
+    blockNumber: 121;
+    WMax?: number;
+    WMax_SF?: number;
+    VRef?: number;
+    VRef_SF?: number;
+    VRefOfs?: number;
+    VRefOfs_SF?: number;
+    VMax?: number;
+    VMin?: number;
+    VMinMax_SF?: number;
+    VAMax?: number;
+    VAMax_SF?: number;
+    VArMaxQ1?: number;
+    VArMaxQ2?: number;
+    VArMaxQ3?: number;
+    VArMaxQ4?: number;
+    VArMax_SF?: number;
+    WGra?: number;
+    WGra_SF?: number;
+    PFMinQ1?: number;
+    PFMinQ2?: number;
+    PFMinQ3?: number;
+    PFMinQ4?: number;
+    PFMin_SF?: number;
+    VArAct?: number;
+    ClcTotVA?: number;
+    MaxRmpRte?: number;
+    MaxRmpRte_SF?: number;
+    ECPNomHz?: number;
+    ECPNomHz_SF?: number;
+    ConnPh?: number;
+}
+/**
+ * Block 123 - Immediate Inverter Controls
+ * Reference: SunSpec Model 123
+ */
+export interface SunspecInverterControls extends SunspecBlock {
+    blockNumber: 123;
+    Conn_WinTms?: number;
+    Conn_RvrtTms?: number;
+    Conn?: number;
+    WMaxLimPct?: number;
+    WMaxLimPct_SF?: number;
+    WMaxLimPct_WinTms?: number;
+    WMaxLimPct_RvrtTms?: number;
+    WMaxLimPct_RmpTms?: number;
+    WMaxLim_Ena?: number;
+    OutPFSet?: number;
+    OutPFSet_SF?: number;
+    OutPFSet_WinTms?: number;
+    OutPFSet_RvrtTms?: number;
+    OutPFSet_RmpTms?: number;
+    OutPFSet_Ena?: number;
+    VArWMaxPct?: number;
+    VArMaxPct?: number;
+    VArAvalPct?: number;
+    VArPct_SF?: number;
+    VArPct_WinTms?: number;
+    VArPct_RvrtTms?: number;
+    VArPct_RmpTms?: number;
+    VArPct_Mod?: number;
+    VArPct_Ena?: number;
+}
+/**
+ * Enum values for connection control
+ */
+export declare enum SunspecConnectionControl {
+    DISCONNECT = 0,
+    CONNECT = 1
+}
+/**
+ * Enum values for enable/disable controls
+ */
+export declare enum SunspecEnableControl {
+    DISABLED = 0,
+    ENABLED = 1
+}
+/**
+ * Enum values for VAR percent mode
+ */
+export declare enum SunspecVArPctMode {
+    NONE = 0,
+    WMAX = 1,
+    VARMAX = 2
+}