{ "$schema": "https://raw.githubusercontent.com/nobrega8/mbmap-library/main/schema/mbmap-2.schema.json", "mbmap": 2, "vendor": "SolarEdge", "model": "Inverters (SunSpec 101-103)", "vendor_website": "solaredge.com", "description": "SolarEdge single, split and three phase inverters with SetApp or LCD firmware 3.xxxx+, monitoring data through SunSpec. Multi-MPPT model 160 (Synergy) and the energy meters are separate maps", "revision": 2, "revised": "2026-11-10", "source": "SolarEdge, \"SolarEdge Inverters - SunSpec Logging - Technical Note\" v2.6 (December 2023), register mapping; SunSpec Alliance information model definitions (github.com/sunspec/models), models 1 and 103", "sources": [ {"title": "SolarEdge Inverters - SunSpec Logging - Technical Note", "version": "2.6", "date": "2023-12", "note": "register mapping"}, {"title": "SunSpec Alliance information model definitions", "url": "https://github.com/sunspec/models", "note": "models 1 and 103"} ], "notes": [ "SolarEdge inverters, SunSpec monitoring data (models 101, 102 and 103).", "Values are integers with scale factor registers; values a model does not use read 0xFFFF or 0x8000.", "Modbus TCP is off by default: enable it in the inverter's LAN or communication menu." ], "protocol": "tcp+rtu", "unit_id": 1, "port": 502, "baudrate": 115200, "parity": "N", "databits": 8, "stopbits": 1, "byte_order": "big", "word_order": "big", "address_base": 0, "enums": { "inverter_state": {"1": "Off", "2": "Sleeping", "3": "Starting", "4": "MPPT", "5": "Throttled", "6": "Shutting down", "7": "Fault", "8": "Standby"} }, "sentinels": { "int16": {"-32768": "Not implemented"}, "uint16": {"0xFFFF": "Not implemented"}, "int32": {"-2147483648": "Not implemented"}, "uint32": {"0xFFFFFFFF": "Not implemented"} }, "x_status": "official", "registers": [ {"name": "SunSpec marker", "group": "Device", "area": "holding", "address": 40000, "type": "string", "length": 2, "access": "R", "description": "Reads SunS\" on a SunSpec device\""}, {"name": "Common block ID", "group": "Device", "area": "holding", "address": 40002, "type": "uint16", "access": "R", "description": "SunSpec ID"}, {"name": "Common block length", "group": "Device", "area": "holding", "address": 40003, "type": "uint16", "access": "R", "description": "SunSpec L"}, {"name": "Manufacturer", "group": "Device", "area": "holding", "address": 40004, "type": "string", "length": 16, "access": "R", "description": "SunSpec Mn"}, {"name": "Model", "group": "Device", "area": "holding", "address": 40020, "type": "string", "length": 16, "access": "R", "description": "SunSpec Md"}, {"name": "Options", "group": "Device", "area": "holding", "address": 40036, "type": "string", "length": 8, "access": "R", "description": "SunSpec Opt"}, {"name": "Version", "group": "Device", "area": "holding", "address": 40044, "type": "string", "length": 8, "access": "R", "role": "firmware", "description": "SunSpec Vr"}, {"name": "Serial number", "group": "Device", "area": "holding", "address": 40052, "type": "string", "length": 16, "access": "R", "role": "serial", "description": "SunSpec SN"}, {"name": "Modbus address", "group": "Device", "area": "holding", "address": 40068, "type": "uint16", "access": "R", "description": "SunSpec DA. This point is mandatory for all SunSpec RTU devices and, for those devices, they must support values from 1-247."}, {"name": "Inverter model ID", "group": "Model header", "area": "holding", "address": 40069, "type": "uint16", "access": "R", "description": "SunSpec ID. 101 = single phase, 102 = split phase, 103 = three phase"}, {"name": "Inverter model length", "group": "Model header", "area": "holding", "address": 40070, "type": "uint16", "access": "R", "description": "SunSpec L"}, {"name": "AC Current", "group": "AC side", "area": "holding", "address": 40071, "type": "uint16", "scale_factor": "A_SF", "unit": "A", "access": "R", "description": "SunSpec A. Sum of active phases"}, {"name": "Phase A Current", "group": "AC side", "area": "holding", "address": 40072, "type": "uint16", "scale_factor": "A_SF", "unit": "A", "access": "R", "description": "SunSpec AphA. Connected Phase"}, {"name": "Phase B Current", "group": "AC side", "area": "holding", "address": 40073, "type": "uint16", "scale_factor": "A_SF", "unit": "A", "access": "R", "description": "SunSpec AphB. Connected Phase"}, {"name": "Phase C Current", "group": "AC side", "area": "holding", "address": 40074, "type": "uint16", "scale_factor": "A_SF", "unit": "A", "access": "R", "description": "SunSpec AphC. Connected Phase"}, {"name": "A_SF", "group": "Scale factors", "area": "holding", "address": 40075, "type": "int16", "access": "R", "description": "SunSpec A_SF"}, {"name": "Phase Voltage AB", "group": "AC side", "area": "holding", "address": 40076, "type": "uint16", "scale_factor": "V_SF", "unit": "V", "access": "R", "description": "SunSpec PPVphAB"}, {"name": "Phase Voltage BC", "group": "AC side", "area": "holding", "address": 40077, "type": "uint16", "scale_factor": "V_SF", "unit": "V", "access": "R", "description": "SunSpec PPVphBC"}, {"name": "Phase Voltage CA", "group": "AC side", "area": "holding", "address": 40078, "type": "uint16", "scale_factor": "V_SF", "unit": "V", "access": "R", "description": "SunSpec PPVphCA"}, {"name": "Phase Voltage AN", "group": "AC side", "area": "holding", "address": 40079, "type": "uint16", "scale_factor": "V_SF", "unit": "V", "access": "R", "description": "SunSpec PhVphA. Split-phase configurations only (Japanese grid, 240 V North America)"}, {"name": "Phase Voltage BN", "group": "AC side", "area": "holding", "address": 40080, "type": "uint16", "scale_factor": "V_SF", "unit": "V", "access": "R", "description": "SunSpec PhVphB. Split-phase configurations only (Japanese grid, 240 V North America)"}, {"name": "Phase Voltage CN", "group": "AC side", "area": "holding", "address": 40081, "type": "uint16", "scale_factor": "V_SF", "unit": "V", "access": "R", "description": "SunSpec PhVphC. Split-phase configurations only (Japanese grid, 240 V North America)"}, {"name": "V_SF", "group": "Scale factors", "area": "holding", "address": 40082, "type": "int16", "access": "R", "description": "SunSpec V_SF"}, {"name": "AC Power", "group": "AC side", "area": "holding", "address": 40083, "type": "int16", "scale_factor": "W_SF", "unit": "W", "access": "R", "description": "SunSpec W"}, {"name": "W_SF", "group": "Scale factors", "area": "holding", "address": 40084, "type": "int16", "access": "R", "description": "SunSpec W_SF"}, {"name": "Line Frequency", "group": "AC side", "area": "holding", "address": 40085, "type": "uint16", "scale_factor": "Hz_SF", "unit": "Hz", "access": "R", "description": "SunSpec Hz"}, {"name": "Hz_SF", "group": "Scale factors", "area": "holding", "address": 40086, "type": "int16", "access": "R", "description": "SunSpec Hz_SF"}, {"name": "AC Apparent Power", "group": "AC side", "area": "holding", "address": 40087, "type": "int16", "scale_factor": "VA_SF", "unit": "VA", "access": "R", "description": "SunSpec VA"}, {"name": "VA_SF", "group": "Scale factors", "area": "holding", "address": 40088, "type": "int16", "access": "R", "description": "SunSpec VA_SF"}, {"name": "AC Reactive Power", "group": "AC side", "area": "holding", "address": 40089, "type": "int16", "scale_factor": "VAr_SF", "unit": "var", "access": "R", "description": "SunSpec VAr"}, {"name": "VAr_SF", "group": "Scale factors", "area": "holding", "address": 40090, "type": "int16", "access": "R", "description": "SunSpec VAr_SF"}, {"name": "AC Power Factor", "group": "AC side", "area": "holding", "address": 40091, "type": "int16", "scale_factor": "PF_SF", "unit": "%", "access": "R", "description": "SunSpec PF"}, {"name": "PF_SF", "group": "Scale factors", "area": "holding", "address": 40092, "type": "int16", "access": "R", "description": "SunSpec PF_SF"}, {"name": "AC Energy", "group": "Energy", "area": "holding", "address": 40093, "type": "uint32", "scale_factor": "WH_SF", "unit": "Wh", "access": "R", "description": "SunSpec WH"}, {"name": "WH_SF", "group": "Scale factors", "area": "holding", "address": 40095, "type": "int16", "access": "R", "description": "SunSpec WH_SF. The SolarEdge note lists this register as uint16; it is the signed SunSpec scale factor (int16)"}, {"name": "DC Current", "group": "DC side", "area": "holding", "address": 40096, "type": "uint16", "scale_factor": "DCA_SF", "unit": "A", "access": "R", "description": "SunSpec DCA"}, {"name": "DCA_SF", "group": "Scale factors", "area": "holding", "address": 40097, "type": "int16", "access": "R", "description": "SunSpec DCA_SF"}, {"name": "DC Voltage", "group": "DC side", "area": "holding", "address": 40098, "type": "uint16", "scale_factor": "DCV_SF", "unit": "V", "access": "R", "description": "SunSpec DCV"}, {"name": "DCV_SF", "group": "Scale factors", "area": "holding", "address": 40099, "type": "int16", "access": "R", "description": "SunSpec DCV_SF"}, {"name": "DC Power", "group": "DC side", "area": "holding", "address": 40100, "type": "int16", "scale_factor": "DCW_SF", "unit": "W", "access": "R", "description": "SunSpec DCW"}, {"name": "DCW_SF", "group": "Scale factors", "area": "holding", "address": 40101, "type": "int16", "access": "R", "description": "SunSpec DCW_SF"}, {"name": "Heat Sink Temperature", "group": "Temperature", "area": "holding", "address": 40103, "type": "int16", "scale_factor": "Tmp_SF", "unit": "°C", "access": "R", "description": "SunSpec TmpSnk"}, {"name": "Tmp_SF", "group": "Scale factors", "area": "holding", "address": 40106, "type": "int16", "access": "R", "description": "SunSpec Tmp_SF"}, {"name": "Operating state", "group": "Status", "area": "holding", "address": 40107, "type": "uint16", "access": "R", "enum": "inverter_state", "description": "SunSpec St"}, {"name": "Vendor specific operating state code", "group": "Status", "area": "holding", "address": 40108, "type": "uint16", "access": "R", "description": "SunSpec StVnd. Vendor status and error codes: see the SolarEdge installation guide"} ] }