Sofar 12KTLX-G3 / Solarman 23xxx LSW3 custom yaml

[nacree]

Hi,

Just wanted to share with you guys the custom yaml I have found somewhere which works for my Sofar 12KTLX-G3 / Solarman LSW3_15_270A_1.68 (23xxxxx). For some reason other versions haven't been working, so try with this one if you have problems!

# Solarman LSW3_15_270A_1.68
# SN: 23xxxxxxxxx

requests:
  - start: 0x0400
    end: 0x042E
    mb_functioncode: 0x03
  - start: 0x0480
    end: 0x04AF
    mb_functioncode: 0x03
#  - start: 0x0500
#    end: 0x041F
#    mb_functioncode: 0x03
  - start: 0x0580
    end: 0x0589
    mb_functioncode: 0x03
#  - start: 0x0600
#    end: 0x060A
#    mb_functioncode: 0x03
  - start: 0x0680
    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: "power"
        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"
      
      - name: "Fault 3"
        class: ""
        state_class: ""      
        uom: ""
        scale: 1
        rule: 1
        registers: [0x0407]
        lookup: 
        -  key: 0
           value: "No error"
        -  key: 1
           value: "ID33 Reserved"
        -  key: 2
           value: "ID34 Reserved"
        -  key: 4
           value: "ID35 Reserved"
        -  key: 8
           value: "ID36 Reserved"
        -  key: 16
           value: "ID37 Reserved"
        -  key: 32
           value: "ID38 Reserved"
        -  key: 64
           value: "ID39 Reserved"
        -  key: 128
           value: "ID40 Reserved"
        -  key: 256
           value: "ID41 Reserved"
        -  key: 512
           value: "ID42 Reserved"
        -  key: 1024
           value: "ID43 Reserved"
        -  key: 2048
           value: "ID44 Reserved"
        -  key: 4096
           value: "ID45 Reserved"
        -  key: 8192
           value: "ID46 Reserved"
        -  key: 16384
           value: "ID47 Reserved"
        -  key: 32768
           value: "ID48 Reserved"
        icon: 'mdi:wrench' 

      - name: "Fault 4"
        class: ""
        state_class: ""      
        uom: ""
        scale: 1
        rule: 1
        registers: [0x0408]
        lookup: 
        -  key: 0
           value: "No error"
        -  key: 1
           value: "ID49 Grid voltage sampling value between master and slave DSP vary widely"
        -  key: 2
           value: "ID50 Grid frequency sampling value between master and slave DSP vary widely"
        -  key: 4
           value: "ID51 DCI sampling value between master and slave DSP vary widely"
        -  key: 8
           value: "ID52 GFCI sampling value between master and slave DSP vary widely"
        -  key: 16
           value: "ID53 Communication failure between master and slave DSP failure"
        -  key: 32
           value: "ID53 Communication failure between slave and communication board"
        -  key: 64
           value: "ID55 Relay fault"
        -  key: 128
           value: "ID56 Insulation resistance between PV array and the earth is too low"
        -  key: 256
           value: "ID57 Inverter temp is too high"
        -  key: 512
           value: "ID58 Boost temp is too high"
        -  key: 1024
           value: "ID59 Environment temp is too high"
        -  key: 2048
           value: "ID60 Brak podłączenie falownika do kabla PE"
        -  key: 4096
           value: "ID61 Reserved"
        -  key: 8192
           value: "ID62 Reserved"
        -  key: 16384
           value: "ID63 Reserved"
        -  key: 32768
           value: "ID64 Reserved"
        icon: 'mdi:wrench'    

      - name: "Fault 5"
        class: ""
        state_class: ""      
        uom: ""
        scale: 1
        rule: 1
        registers: [0x0409]
        lookup: 
        -  key: 0
           value: "No error"
        -  key: 1
           value: "ID65 Grid current is too high and causes unrecoverable fault"
        -  key: 2
           value: "ID66 Bus voltage is too high and causes unrecoverable fault"
        -  key: 4
           value: "ID67 Grid current is unbalanced and causes unrecoverable fault"
        -  key: 8
           value: "ID68 Input current is unbalanced and causes unrecoverable fault"
        -  key: 16
           value: "ID69 Bus voltage is unbalanced and causes unrecoverable fault"
        -  key: 32
           value: "ID70 Grid current is too high and causes unrecoverable fault"
        -  key: 64
           value: "ID65 PV Input Mode Configuration is wrong and causes unrecoverable fault"
        -  key: 128
           value: "ID72 Reserved"
        -  key: 256
           value: "ID73 Reserved"
        -  key: 512
           value: "ID74 Input current is too high and causes unrecoverable fault"
        -  key: 1024
           value: "ID75 Error reading from EEPROM"
        -  key: 2048
           value: "ID76 Error writing to EEPROM"
        -  key: 4096
           value: "ID77 Relay fauilure causes unrecoverable fault"
        -  key: 8192
           value: "ID78 Reserved"
        -  key: 16384
           value: "ID79 Reserved"
        -  key: 32768
           value: "ID80 Reserved"
        icon: 'mdi:wrench'

[nacree]

Now after looking a bit around, this topic seems to be discussed in #172

I just fixed the class of the "Total Active Power Output" sensor.

[davidrapan]

Hi @nacree, If you have the same device update your firmware (of inverter, not logger).

Also why you didn't put your inverter manufacturer and model into the name of discussion? It's way more important than logger type. 😉

[nacree]

@davidrapan oh thanks for the tip to update!

I'm pretty new owner of this house, so I'm still a bit confused about how that solar thing works :D But it's good point that this seems to be the logger type - no wonder I could not find matching yaml.

By connecting to logger with IP it does not show the inverter details, but from Solarman app it seems indeed to say that model is 12KTLX-G3. No idea what of those firmware versions are correct, but I'm pretty sure it is outdated..

I will update the firmware once it gets some plus degrees outside 😁

Thanks!