Skip to content

Instantly share code, notes, and snippets.

@MatteCarra
Forked from Floppe/sofar_ktlxg3.yaml
Created December 26, 2022 09:15
Show Gist options
  • Save MatteCarra/3524c1c29f4ef58028ae3d182694490f to your computer and use it in GitHub Desktop.
Save MatteCarra/3524c1c29f4ef58028ae3d182694490f to your computer and use it in GitHub Desktop.
Sofar Solar KTL-X G3 inverter to be used with HomeAssistant Solarman integration
requests:
- start: 0x0404
end: 0x042E
mb_functioncode: 0x03
- start: 0x0484
end: 0x04BC
mb_functioncode: 0x03
- start: 0x0584
end: 0x0589
mb_functioncode: 0x03
- start: 0x0684
end: 0x069B
mb_functioncode: 0x03
parameters:
- group: InverterDC
items:
- name: "PV1 Power"
class: "power"
state_class: "measurement"
uom: "W"
scale: 10
rule: 1
registers: [0x0586]
icon: 'mdi:solar-power'
- name: "PV2 Power"
class: "power"
state_class: "measurement"
uom: "W"
scale: 10
rule: 1
registers: [0x0589]
icon: 'mdi:solar-power'
- name: "PV1 Voltage"
class: "voltage"
state_class: "measurement"
uom: "V"
scale: 0.1
rule: 1
registers: [0x0584]
icon: 'mdi:alpha-v-circle-outline'
- name: "PV2 Voltage"
class: "voltage"
state_class: "measurement"
uom: "V"
scale: 0.1
rule: 1
registers: [0x0587]
icon: 'mdi:alpha-v-circle-outline'
- name: "PV1 Current"
class: "current"
state_class: "measurement"
uom: "A"
scale: 0.01
rule: 1
registers: [0x0585]
icon: 'mdi:current-dc'
- name: "PV2 Current"
class: "current"
state_class: "measurement"
uom: "A"
scale: 0.01
rule: 1
registers: [0x0588]
icon: 'mdi:current-dc'
- group: Inverter
items:
- name: "Inverter status"
class: ""
state_class: "measurement"
uom: ""
scale: 1
rule: 1
registers: [0x0404]
lookup:
- key: 0
value: "Waiting"
- key: 1
value: "Detection"
- key: 2
value: "Grid-Connected"
- key: 3
value: "Emergency Power Supply"
- key: 4
value: "Recoverable Fault"
- key: 5
value: "Permanent Fault"
- key: 6
value: "Upgrade"
- key: 7
value: "Self-charging"
icon: 'mdi:wrench'
- name: "Ambient temperature 1"
class: "temperature"
uom: "°C"
scale: 1
rule: 2
registers: [0x0418]
icon: 'mdi:thermometer'
- name: "Module temperature 1"
class: "temperature"
uom: "°C"
scale: 1
rule: 2
registers: [0x0420]
icon: 'mdi:thermometer'
- name: "Radiator temperature 1"
class: "temperature"
uom: "°C"
scale: 1
rule: 2
registers: [0x041A]
icon: 'mdi:thermometer'
- name: "Insulation Resistance"
class: "none"
uom: "kohm"
scale: 1
rule: 1
registers: [0x042B]
icon: "mdi:omega"
- group: OnGridOutput
items:
- name: "Frequency Grid"
class: "frequency"
uom: "Hz"
scale: 0.01
rule: 1
registers: [0x0484]
icon: 'mdi:sine-wave'
- name: "Total Active Power Output"
class: "energy"
uom: "kW"
scale: 0.01
rule: 1
registers: [0x0485]
icon: "mdi:solar-power"
- name: "Grid Voltage L1"
class: "voltage"
uom: "V"
scale: 0.1
rule: 1
registers: [0x048D]
icon: "mdi:alpha-v-circle-outline"
- name: "Grid Current L1"
class: "current"
uom: "A"
scale: 0.01
rule: 1
registers: [0x048E]
icon: "mdi:alpha-a-circle-outline"
- name: "Grid Voltage L2"
class: "voltage"
uom: "V"
scale: 0.1
rule: 1
registers: [0x0498]
icon: "mdi:alpha-v-circle-outline"
- name: "Grid Current L2"
class: "current"
uom: "A"
scale: 0.01
rule: 1
registers: [0x0499]
icon: "mdi:alpha-a-circle-outline"
- name: "Grid Voltage L3"
class: "voltage"
uom: "V"
scale: 0.1
rule: 1
registers: [0x04A3]
icon: "mdi:alpha-v-circle-outline"
- name: "Grid Current L3"
class: "current"
uom: "A"
scale: 0.01
rule: 1
registers: [0x04A4]
icon: "mdi:alpha-a-circle-outline"
- group: Generation
items:
- name: "PV Generation today"
class: "energy"
state_class: "total_increasing"
uom: "kWh"
scale: 0.01
rule: 3
registers: [0x0685,0x0684]
icon: 'mdi:solar-power'
- name: "PV Generation total"
class: "energy"
state_class: "total_increasing"
uom: "kWh"
scale: 0.1
rule: 3
registers: [0x0687,0x0686]
icon: 'mdi:solar-power'
- name: "Load consumption today"
class: "energy"
state_class: "total_increasing"
uom: "kWh"
scale: 0.01
rule: 3
registers: [0x0689,0x0688]
icon: 'mdi:lightning-bolt-outline'
- name: "Load consumption total"
class: "energy"
state_class: "total_increasing"
uom: "kWh"
scale: 0.1
rule: 3
registers: [0x068B,0x068A]
icon: 'mdi:solar-power'
- group: Alert
items:
- name: "Alert"
class: ""
state_class: ""
uom: ""
scale: 1
rule: 6
registers: [0x0405,0x0406,0x0407,0x0408,0x0409,0x040A,0x040B,0x040C,0x040D,0x040E,0x040F,0x0410]
- name: "Fault 1"
class: ""
state_class: ""
uom: ""
scale: 1
rule: 1
registers: [0x0405]
icon: 'mdi:wrench'
lookup:
- key: 0
value: "No error"
- key: 1
value: "ID01 Grid Over Voltage Protection"
- key: 2
value: "ID02 Grid Under Voltage Protection"
- key: 4
value: "ID03 Grid Over Frequency Protection"
- key: 8
value: "ID04 Grid Under Frequency Protection"
- key: 16
value: "ID05 Leakage current fault"
- key: 32
value: "ID06 High penetration error"
- key: 64
value: "ID07 Low penetration error"
- key: 128
value: "ID08 Islanding error"
- key: 256
value: "ID09 Grid voltage transient value overvoltage 1"
- key: 512
value: "ID10 Grid voltage transient value overvoltage 2"
- key: 1024
value: "ID11 Grid line voltage error"
- key: 2048
value: "ID12 Inverter voltage error"
- key: 4096
value: "ID13 Anti-backflow overload"
- key: 8192
value: "ID14"
- key: 16384
value: "ID15"
- key: 32768
value: "ID16"
- name: "Fault 2"
class: ""
state_class: ""
uom: ""
scale: 1
rule: 1
icon: 'mdi:wrench'
registers: [0x0406]
lookup:
- key: 0
value: "No error"
- key: 1
value: "ID17 Grid current sampling error"
- key: 2
value: "ID18 Grid current DC component sampling error (AC side)"
- key: 4
value: "ID19 Grid voltage sampling error (DC side)"
- key: 8
value: "ID20 Grid voltage sampling error (AC side)"
- key: 16
value: "ID21 Leakage current sampling error (DC side)"
- key: 32
value: "ID22 Leakage current sampling error (AC side)"
- key: 64
value: "ID23 Load voltage DC component sampling error"
- key: 128
value: "ID24 DC input current sampling error"
- key: 256
value: "ID25 DC component sampling error of grid current (DC side)"
- key: 512
value: "ID26 DC input branch current sampling error"
- key: 1024
value: "ID27"
- key: 2048
value: "ID28"
- key: 4096
value: "ID29 Leakage current consistency error"
- key: 8192
value: "ID30 Grid voltage consistency error"
- key: 16384
value: "ID31 DCI consistency error"
- key: 32768
value: "ID32"
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment