solarmax-metrics

This small piece of code contacts a SolarMax S series inverter (2000S, 3000S, 4200S, 6000S) and provides its metrics in JSON.

Usage

Simple metric query only using the inverters ip and port:
(Inverter id 1 will be used as default)

pi@raspberrypi:~ $ solarmax-metrics -host=192.168.188.19 -port=26126
{"IDC":{"Value":6.27,"Description":"DC Current (A)"},"IL1":{"Value":8.66,"Description":"AC Current Phase 1 (A)"},"KDY":{"Value":3.2,"Description":"Energy today (kWh)"},"KMT":{"Value":133,"Description":"Energy this month (kWh)"},"KT0":{"Value":45689,"Description":"Total Energy(kWh)"},"KYR":{"Value":1724,"Description":"Energy this year (kWh)"},"PAC":{"Value":2000,"Description":"AC Power (W)"},"PRL":{"Value":40,"Description":"Relative power (%)"},"SYS":{"Value":20008,"Description":"System Status: Mains operation"},"TKK":{"Value":47,"Description":"Inverter Temperature (C)"},"TNF":{"Value":50.01,"Description":"Generated Frequency (Hz)"},"TYP":{"Value":20030,"Description":"Type: SolarMax 4200S"},"UDC":{"Value":3343,"Description":"DC Voltage (V)"},"UL1":{"Value":231.3,"Description":"AC Voltage Phase 1 (V)"}}

Combined metric query with jq only using the inverters ip and port: (Default inverter id 1 will be used)

pi@raspberrypi:~ $ solarmax-metrics -host=192.168.188.19 -port=26126 | jq ".PAC"
{
  "Value": 1678,
  "Description": "AC Power (W)"
}

Usage (help option):

pi@raspberrypi:~ $ solarmax-metrics -h
Usage of ./solarmax-metrics:
  -host string
        host/inverter ip address (default "127.0.0.1")
  -inverter int
        inverter id (default 1)
  -loglevel string
        info, warn, debug, trace (default "info")
  -metrics string
        list of metric codes (comma separated) (default "KDY,KMT,KYR,KT0,TNF,TKK,PAC,PRL,IL1,IDC,UL1,UDC,SYS")
  -mode string
        query, loop, listmetrics (default "query")
  -port int
        port number (default 80)

List available metrics:

tpi@raspberrypi:~ $ solarmax-metrics -mode listmetrics
ADR: Address
BDN: Build number
CAC: Start Ups
DDY: Date day
DIN: Date in integer format with offset 23.12.1510
DMT: Date month
DYR: Date year
EC00: Error Code 0
EC01: Error Code 1
EC02: Error Code 2
EC03: Error Code 3
EC04: Error Code 4
EC05: Error Code 5
EC06: Error Code 6
EC07: Error Code 7
EC08: Error Code 8
FDAT: Datetime integer ?
F_AC: Grid Frequency
ID01: String 1 Current (A)
ID02: String 2 Current (A)
ID03: String 3 Current (A)
IDC: DC Current (A)
IL1: AC Current Phase 1 (A)
IL2: AC Current Phase 2 (A)
IL3: AC Current Phase 3 (A)
KDL: Energy yesterday (Wh)
KDY: Energy today (kWh)
KHR: Operating Hours
KLM: Energy last month (kWh)
KLY: Energy last year (kWh)
KMT: Energy this month (kWh)
KT0: Total Energy(kWh)
KYR: Energy this year (kWh)
LAN: Language
MAC: MAC Address
PAC: AC Power (W)
PDC: DC Power (W)
PIN: Installed Power (W)
PRL: Relative power (%)
SAL: System Alarms
SDAT: Datetime integer
SE1: 
SWV: Software Version
SYS: System Status
THR: Time hours
TKK: Inverter Temperature (C)
TMI: Time minutes
TNF: Generated Frequency (Hz)
TNP: Grid period duration
TYP: Inverter Type
UD01: String 1 Voltage (V)
UD02: String 2 Voltage (V)
UD03: String 3 Voltage (V)
UDC: DC Voltage (V)
UL1: AC Voltage Phase 1 (V)
UL2: AC Voltage Phase 2 (V)
UL3: AC Voltage Phase 3 (V)
U_AC: unknown ?
U_L1L2: Phase1 to Phase2 Voltage (V)
U_L2L3: Phase2 to Phase3 Voltage (V)
U_L3L1: Phase3 to Phase1 Voltage (V)