aurora(1) aurora aurora(1)

aurora - communicate with an Magnetek/Power One/ABB Aurora Photovoltaic (solar) Power Inverter

aurora [Options] -a InverterAddress Device

Inverter address. 1-31 on older inverters, 1-63 on newer inverters.
Serial Device. Example, /dev/ttyUSB0 or /dev/ttyS0.

Get last four alarms (once displayed FIFO queue is cleared)
Verbose mode. For maximum effectiveness should be the first option on the command line
Calculate monetary value using <num> * kWh. ":$" is optional and if included the character(s) represented by the "$" will be used to denote monetary type in the output. Defaults to "$"
Output data in columns --> for -d, -e, -D, -3, -E, -t options only, will disable all other options -- if value ends with an "*" reporting of that item may not be in inverters firmware
Get DSP data <num> indicates string to get data for. 0 indicates both 1 for only string 1, 2 for only string 2. <num> is required for short option and <num> is optional for long option and if omitted for long option data for both input strings will be retrieved
Get more DSP data
-3, --get-dsp-3phase
Get 3-Phase DSP data
Get Cumulated Energy readings (Excluding Central)
Get Cumulated Float Energy readings (Central & TRIO only) <num> days 1 to 366 Default 366 <num> is required for short option and optional for long option
Query for Firmware Version string
Query for Inverter Manufacturing Date
This text
Display Inverter Time Counters <bitmask> is required for short option is optional for long option and if omitted for long option then all counters will be displayed and Partial counter will be reset
1 = "Total Run Time" 4 = "Grid Connection Time"
2 = "Partial Run Time" 8 = "Reset Partial Run Time"
Display Energy accumulated in the last 10 seconds
Adjust vaules reported by -k, --daily-kwh by "<num>" multiplier
Get past daily KWH for <num> days (1-366) <num> is optional for long option and if omitted all 366 days or as many that are found will be displayed. It is suggested that the -Y option be used with this due to the extensive length of time it takes to get all the data from the inverter
Automatically adjust the inverter time if it differs from the computer time. If <num> is 0 (zero) do a Daylight Savings Time check. If <num> is >= 1 change the inverter time if it differs by <num> or more seconds. See the README for more information and the constraints this option uses to the determine if the time should be changed due to Daylight Savings Time
Timeout for the read to the serial port. <num> in 1/10ths seconds. Default is 1 (0.1 sec). See the README file for important information on this option
Maximum amount of time in seconds that aurora will run trying to get data from the inverter
Query for Inverter System Configuration
Query for Inverter Serial Number
Indicates Aurora Central 0 indicates Master, 1 indicates Slave
Append data to file (Created if nonexistant) Note: If -c option is used only -d, -e, -D, -3, -E, -t, & -T options will output to file
Query for Inverter Part Number (Central only)
Query for Inverter Part Number
Wait <num> uS between sending commands to inverter (1-1000000)
Use inverter specific multiplier if known to adjust values reported by -q, --energy-sent
Get past energy delivered to the grid at 10 second intervals for <num> minutes (1-1440) starting with the oldest data available. <num> is optional for long option and if omitted all data, ~24 hours worth will be reported. It is suggested that the -Y option be used with this due to the extensive length of time it takes to get all the data from the inverter. See the README file for important information on this option
Serial port read retry timeout value when reading a character from the Inverter (mS - minimum 200) See the README file for important information on this option
Calc Grid power using Grid Voltage * Grid Current, instead of reporting the Inverter's value. --> for -d option only, ignored when used with -c option. (Inverter typically reports a lower value. This affects Inverter conversion efficiency value.)
Set Inverter Date/Time to system time
Get Inverter State
Display computer Date/Time
Display Inverter Date/Time
Pause <num> milli-seconds after sending command to inverter before reading response from inverter (1-10000)
Report when/that pausing before read
Aurora communications program version
Query for Version string
Swap Endianness
Milliseconds to wait to lock serial port. (10.0-30000.0 mS) Default 0.0 mS meaning only one attempt to get the lock will be made. A random number of attempts to lock the port (minimum of 10 maximum of 100 per second) will be done for a maximum 30 second duration.
Enable RTS/CTS on the serial port.
Enable XON/XOFF on the serial port.
Retry failed communications with inverter up to <num> times (1-100)
Report the number of retires done

aurora is a program that communicates with Aurora Magnetek Photovoltaic (solar) Power Inverters written by Curt Blank. It can retrieve data and statistics from a variety of Aurora Inverters through either USB or Serial interfaces.

aurora -T -c -e -d 0 -a 2 -w 15 /dev/ttyS0

aurora -Y 100 -T -a 2 -w 10 -e /dev/ttyUSB0

This manpage was initially written by Dustin Kirkland <kirkland@canonical.com> and is maintained by Curt Blank <solar@curtronics.com>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 published by the Free Software Foundation.

21 Jan 2016 aurora