@atelieruldetehnologii/node-red-custome-solutions 0.62.22

package/fronius-read/lib/inverter-profiles.js

@@ -0,0 +1,711 @@
+const AC_OPTIONS_COMMON = [
+
+    { value: "summary.ac.power_w", label: "Putere AC (W)" },
+
+    { value: "summary.ac.frequency_hz", label: "Frecvență (Hz)" },
+
+    { value: "summary.ac.apparent_power_va", label: "Putere aparentă (VA)" },
+
+    { value: "summary.ac.reactive_power_var", label: "Putere reactivă (var)" }
+
+];
+
+
+const AC_OPTIONS_SINGLE_PHASE = [
+
+    { value: "summary.ac.current_total_a", label: "Curent total (A)" },
+
+    { value: "summary.ac.current_l1_a", label: "Curent L1 (A)" },
+
+    { value: "summary.ac.voltage_l1_v", label: "Tensiune L1 (V)" }
+
+];
+
+
+const AC_OPTIONS_THREE_PHASE = [
+
+    { value: "summary.ac.current_total_a", label: "Curent total (A)" },
+
+    { value: "summary.ac.current_l1_a", label: "Curent L1 (A)" },
+
+    { value: "summary.ac.current_l2_a", label: "Curent L2 (A)" },
+
+    { value: "summary.ac.current_l3_a", label: "Curent L3 (A)" },
+
+    { value: "summary.ac.voltage_ll_ab_v", label: "Tensiune AB (V)" },
+
+    { value: "summary.ac.voltage_ll_bc_v", label: "Tensiune BC (V)" },
+
+    { value: "summary.ac.voltage_ll_ca_v", label: "Tensiune CA (V)" },
+
+    { value: "summary.ac.voltage_l1_v", label: "Tensiune L1 (V)" },
+
+    { value: "summary.ac.voltage_l2_v", label: "Tensiune L2 (V)" },
+
+    { value: "summary.ac.voltage_l3_v", label: "Tensiune L3 (V)" }
+
+];
+
+
+const PAYLOAD_OPTION_GROUPS = {
+
+    dcGeneral: [
+
+        { value: "summary.dc.dc_total_power_w", label: "Putere DC totală (W)" },
+
+        { value: "summary.dc.module_count", label: "Număr module/stringuri DC (brut)" },
+
+        { value: "summary.dc.global_event", label: "Eveniment DC global" }
+
+    ],
+
+
+    device: [
+
+        { value: "summary.common.manufacturer", label: "Producător" },
+
+        { value: "summary.common.model", label: "Model" },
+
+        { value: "summary.common.options", label: "Opțiuni" },
+
+        { value: "summary.common.version", label: "Versiune" },
+
+        { value: "summary.common.serial", label: "Serie" },
+
+        { value: "summary.common.device_address", label: "Adresă device" }
+
+    ]
+
+};
+
+
+const INVERTER_PROFILES = {
+
+    auto: {
+
+        key: "auto",
+
+        label: "Auto Detect",
+
+        manufacturer: null,
+
+        family: "generic",
+
+        fallbackMpptCount: 4,
+
+        fallbackPhaseMode: "unknown",
+
+        includeAC: true,
+
+        includeDCGeneral: true,
+
+        includeDevice: true
+
+    },
+
+
+    fronius_verto: {
+
+        key: "fronius_verto",
+
+        label: "Fronius Verto",
+
+        manufacturer: "fronius",
+
+        family: "verto",
+
+        fallbackMpptCount: 4,
+
+        fallbackPhaseMode: "three_phase",
+
+        includeAC: true,
+
+        includeDCGeneral: true,
+
+        includeDevice: true
+
+    },
+
+
+    fronius_symo: {
+
+        key: "fronius_symo",
+
+        label: "Fronius Symo",
+
+        manufacturer: "fronius",
+
+        family: "symo",
+
+        fallbackMpptCount: 2,
+
+        fallbackPhaseMode: "three_phase",
+
+        includeAC: true,
+
+        includeDCGeneral: true,
+
+        includeDevice: true
+
+    },
+
+
+    fronius_primo: {
+
+        key: "fronius_primo",
+
+        label: "Fronius Primo",
+
+        manufacturer: "fronius",
+
+        family: "primo",
+
+        fallbackMpptCount: 2,
+
+        fallbackPhaseMode: "single_phase",
+
+        includeAC: true,
+
+        includeDCGeneral: true,
+
+        includeDevice: true
+
+    },
+
+
+    fronius_eco: {
+
+        key: "fronius_eco",
+
+        label: "Fronius Eco",
+
+        manufacturer: "fronius",
+
+        family: "eco",
+
+        fallbackMpptCount: 1,
+
+        fallbackPhaseMode: "three_phase",
+
+        includeAC: true,
+
+        includeDCGeneral: true,
+
+        includeDevice: true
+
+    },
+
+
+    fronius_tauro: {
+
+        key: "fronius_tauro",
+
+        label: "Fronius Tauro",
+
+        manufacturer: "fronius",
+
+        family: "tauro",
+
+        fallbackMpptCount: 3,
+
+        fallbackPhaseMode: "three_phase",
+
+        includeAC: true,
+
+        includeDCGeneral: true,
+
+        includeDevice: true
+
+    },
+
+
+    fronius_tauro_eco: {
+
+        key: "fronius_tauro_eco",
+
+        label: "Fronius Tauro Eco",
+
+        manufacturer: "fronius",
+
+        family: "tauro_eco",
+
+        fallbackMpptCount: 1,
+
+        fallbackPhaseMode: "three_phase",
+
+        includeAC: true,
+
+        includeDCGeneral: true,
+
+        includeDevice: true
+
+    }
+
+};
+
+
+function buildMpptOptions(mpptIndex) {
+
+    return [
+
+        { value: `summary.dc.mppts.${mpptIndex}.dc_voltage_v`, label: "Tensiune (V)" },
+
+        { value: `summary.dc.mppts.${mpptIndex}.dc_current_a`, label: "Curent (A)" },
+
+        { value: `summary.dc.mppts.${mpptIndex}.dc_power_w`, label: "Putere (W)" },
+
+        { value: `summary.dc.mppts.${mpptIndex}.dc_energy_wh`, label: "Energie (Wh)" }
+
+    ];
+
+}
+
+
+function buildAcOptions(phaseMode) {
+
+    const common = AC_OPTIONS_COMMON.slice();
+
+
+    if (phaseMode === "single_phase") {
+
+        return common.concat(AC_OPTIONS_SINGLE_PHASE);
+
+    }
+
+
+    if (phaseMode === "three_phase") {
+
+        return common.concat(AC_OPTIONS_THREE_PHASE);
+
+    }
+
+
+    const merged = [];
+
+    const seen = new Set();
+
+
+    common
+
+        .concat(AC_OPTIONS_SINGLE_PHASE)
+
+        .concat(AC_OPTIONS_THREE_PHASE)
+
+        .forEach((item) => {
+
+            if (!seen.has(item.value)) {
+
+                seen.add(item.value);
+
+                merged.push(item);
+
+            }
+
+        });
+
+
+    return merged;
+
+}
+
+
+function normalizeText(value) {
+
+    return String(value || "")
+
+        .toLowerCase()
+
+        .replace(/[^a-z0-9]+/g, " ")
+
+        .trim();
+
+}
+
+
+function hasNumericValue(value) {
+
+    return Number.isFinite(value);
+
+}
+
+
+function getDetectedMpptCount(summary) {
+
+    if (!summary || !summary.dc) {
+
+        return null;
+
+    }
+
+
+    if (Number.isFinite(summary.dc.module_count) && summary.dc.module_count > 0) {
+
+        return summary.dc.module_count;
+
+    }
+
+
+    if (Array.isArray(summary.dc.mppts) && summary.dc.mppts.length > 0) {
+
+        return summary.dc.mppts.length;
+
+    }
+
+
+    return null;
+
+}
+
+
+function detectPhaseMode(summary) {
+
+    const ac = summary && summary.ac ? summary.ac : null;
+
+
+    if (!ac) {
+
+        return "unknown";
+
+    }
+
+
+    const hasThreePhaseEvidence =
+
+        hasNumericValue(ac.current_l2_a) ||
+
+        hasNumericValue(ac.current_l3_a) ||
+
+        hasNumericValue(ac.voltage_l2_v) ||
+
+        hasNumericValue(ac.voltage_l3_v) ||
+
+        hasNumericValue(ac.voltage_ll_ab_v) ||
+
+        hasNumericValue(ac.voltage_ll_bc_v) ||
+
+        hasNumericValue(ac.voltage_ll_ca_v);
+
+
+    if (hasThreePhaseEvidence) {
+
+        return "three_phase";
+
+    }
+
+
+    const hasSinglePhaseEvidence =
+
+        hasNumericValue(ac.current_l1_a) ||
+
+        hasNumericValue(ac.voltage_l1_v) ||
+
+        hasNumericValue(ac.current_total_a);
+
+
+    if (hasSinglePhaseEvidence) {
+
+        return "single_phase";
+
+    }
+
+
+    return "unknown";
+
+}
+
+
+function detectFroniusProfileKey(combinedText) {
+
+    if (/\btauro\s+eco\b/i.test(combinedText) || /\btauro[-\s]*eco\b/i.test(combinedText)) {
+
+        return "fronius_tauro_eco";
+
+    }
+
+
+    if (/\btauro\b/i.test(combinedText)) {
+
+        return "fronius_tauro";
+
+    }
+
+
+    if (/\bverto\b/i.test(combinedText)) {
+
+        return "fronius_verto";
+
+    }
+
+
+    if (/\bsymo\b/i.test(combinedText) || /\bsnap\s?inverter\b/i.test(combinedText)) {
+
+        return "fronius_symo";
+
+    }
+
+
+    if (/\bprimo\b/i.test(combinedText)) {
+
+        return "fronius_primo";
+
+    }
+
+
+    if (/\beco\b/i.test(combinedText)) {
+
+        return "fronius_eco";
+
+    }
+
+
+    return null;
+
+}
+
+
+function buildDetectionResult(profile, phaseMode, detectedMpptCount, detectionSource) {
+
+    return {
+
+        profile_key: profile.key,
+
+        profile_label: profile.label,
+
+        manufacturer: profile.manufacturer,
+
+        family: profile.family,
+
+        phase_mode: phaseMode !== "unknown" ? phaseMode : profile.fallbackPhaseMode,
+
+        mppt_count:
+
+            Number.isFinite(detectedMpptCount) && detectedMpptCount > 0
+
+                ? detectedMpptCount
+
+                : profile.fallbackMpptCount,
+
+        detection_source: detectionSource,
+
+        detected_mppt_count: detectedMpptCount
+
+    };
+
+}
+
+
+function detectInverterProfile(summary) {
+
+    const common = summary && summary.common ? summary.common : {};
+
+    const manufacturer = normalizeText(common.manufacturer);
+
+    const model = normalizeText(common.model);
+
+    const options = normalizeText(common.options);
+
+    const version = normalizeText(common.version);
+
+    const combined = `${manufacturer} ${model} ${options} ${version}`.trim();
+
+
+    const phaseMode = detectPhaseMode(summary);
+
+    const detectedMpptCount = getDetectedMpptCount(summary);
+
+
+    if (manufacturer.includes("fronius")) {
+
+        const matchedProfileKey = detectFroniusProfileKey(combined);
+
+
+        if (matchedProfileKey) {
+
+            return buildDetectionResult(
+
+                INVERTER_PROFILES[matchedProfileKey],
+
+                phaseMode,
+
+                detectedMpptCount,
+
+                "manufacturer_model+ac+dc"
+
+            );
+
+        }
+
+
+        if (phaseMode === "single_phase" && detectedMpptCount === 2) {
+
+            return buildDetectionResult(
+
+                INVERTER_PROFILES.fronius_primo,
+
+                "single_phase",
+
+                detectedMpptCount,
+
+                "ac+dc_inference"
+
+            );
+
+        }
+
+
+        if (phaseMode === "three_phase" && detectedMpptCount === 4) {
+
+            return buildDetectionResult(
+
+                INVERTER_PROFILES.fronius_verto,
+
+                "three_phase",
+
+                detectedMpptCount,
+
+                "ac+dc_inference"
+
+            );
+
+        }
+
+
+        if (phaseMode === "three_phase" && detectedMpptCount === 3) {
+
+            return buildDetectionResult(
+
+                INVERTER_PROFILES.fronius_tauro,
+
+                "three_phase",
+
+                detectedMpptCount,
+
+                "ac+dc_inference"
+
+            );
+
+        }
+
+
+        if (phaseMode === "three_phase" && detectedMpptCount === 2) {
+
+            return buildDetectionResult(
+
+                INVERTER_PROFILES.fronius_symo,
+
+                "three_phase",
+
+                detectedMpptCount,
+
+                "ac+dc_inference"
+
+            );
+
+        }
+
+
+        if (phaseMode === "three_phase" && detectedMpptCount === 1) {
+
+            return buildDetectionResult(
+
+                INVERTER_PROFILES.fronius_eco,
+
+                "three_phase",
+
+                detectedMpptCount,
+
+                "ac+dc_inference"
+
+            );
+
+        }
+
+    }
+
+
+    return {
+
+        profile_key: "auto",
+
+        profile_label: INVERTER_PROFILES.auto.label,
+
+        manufacturer: manufacturer || null,
+
+        family: "generic",
+
+        phase_mode: phaseMode,
+
+        mppt_count:
+
+            Number.isFinite(detectedMpptCount) && detectedMpptCount > 0
+
+                ? detectedMpptCount
+
+                : INVERTER_PROFILES.auto.fallbackMpptCount,
+
+        detection_source: combined ? "fallback_generic" : "fallback_no_identity",
+
+        detected_mppt_count: detectedMpptCount
+
+    };
+
+}
+
+
+function resolveProfile(profileKey, detectedMpptCount, detectedPhaseMode) {
+
+    const profile = INVERTER_PROFILES[profileKey] || INVERTER_PROFILES.auto;
+
+
+    const resolvedMpptCount =
+
+        Number.isFinite(detectedMpptCount) && detectedMpptCount > 0
+
+            ? detectedMpptCount
+
+            : profile.fallbackMpptCount;
+
+
+    const resolvedPhaseMode =
+
+        detectedPhaseMode && detectedPhaseMode !== "unknown"
+
+            ? detectedPhaseMode
+
+            : profile.fallbackPhaseMode;
+
+
+    return {
+
+        ...profile,
+
+        resolvedMpptCount,
+
+        resolvedPhaseMode
+
+    };
+
+}
+
+
+module.exports = {
+
+    PAYLOAD_OPTION_GROUPS,
+
+    INVERTER_PROFILES,
+
+    buildMpptOptions,
+
+    buildAcOptions,
+
+    normalizeText,
+
+    getDetectedMpptCount,
+
+    detectPhaseMode,
+
+    detectInverterProfile,
+
+    resolveProfile
+
+};