4. Configuration - akrypth/aeclogger GitHub Wiki
There is an example-configuration in the downloaded source package: aeclogger.ini :
In general each line contains one key=value pair, except empty lines (only blanks) or lines starting with |
, these are ignored and treated as comment-lines.
The first "section" contains common program-parameters:
http-port: this is the network-port the AECLogger http-server is listening to - use any free port you like
serial_port: the serial port, the usb-rs485-interface-converter is attached - see this wiki "hardware-requirements"
| Allgemeine Programmparameter
http_port=3038
serial_port=/dev/ttyUSBx
due to the effect, that on some boards the attached usbid changes during operations, the new parameter:
serial_identifier=usb 2-1.2: FTDI USB Serial Device converter now attached
is used, this is a part of the string in dmesg display - die logger searches the last line with this identifier and extracts the correct USB-ID e.g. ttyUSB2 from this line.
tmp_path: the "absolute" path to the directory AECLogger can use to store temporary files and logs. To enhance the lifetime of your SD-Card or NAND-memory, this tmp-directory should be a memory-based Directory (see Linux tempfs). The final inverter-logfiles for a day are transfered once a day (in the night, when the inverter is "sleeping") to the log_path-direcory this should be a place on a permanent memory (e.g. SD-Card). You also should backup this directory to avoid loosing historical data.
tmp_path=/tmp/
log_path=/aelog/
next are the different interval-definition (in seconds) for three types of Events:
log_interval this defines how often (e.g. each 10 seconds) the state of the inverters is stored to the logs (identical for all defined inverters.
log_interval=10
req_interval how often commands for power, state ... are sent via rs485 to the inverters - it therefore defines the resolution of logging and the accuracy of data displayed in the web-interface
req_interval=10
pow_interval the most important information is current-power and yield, so this interval for requesting this information from the inverters can be defined seperately.
pow_interval=5
The next section define the logged inverters - I guess it makes sense not to place more than 5-6 inverters - not tested how the charts in the web-interface look like. From the data-model AECLogger can handle a lot more ... this is s.th. for the todo-list. Just give it a try :-)
the key per inverter is always preceeded by _number, where number is the internal id of the inverter (0-n). there must be no gaps !
log_level
Tis is for logging (Debugging) AECLogger - is is defined as a bitfield to combine the different Output:
| 1 -> bit 0 = Backgroundaktionen (store logs ...) | 2 -> bit 1 = Hexdump - RS485 | 4 -> bit 2 = Get-Requests von Web-app (Ajax)
log_level=0
e.g. loglevel=6 means bit 1+bit2 are set -> Hexdump(RS485) + Ajax-Requests
Coloring
You can define graph-colors per Inverter see below (invertercolor_x).
This coloring is used in the overview-page AND detail-page. It is possible to "override" the Colors in the detail-page for the Live-Chart and Bar-Chart (hour) with the following two settings (optional)
Colors are ALWAYS defined as RGB HexValues !!!
detail_livecolor=0000aa<br>
detail_hourcolor=0022aa<br>
Per Inverter there are 2 mandatory parameters:
inverterid_x this is the AEConversion-ID - the last 5 digits of the serial number (what I experienced till now, the serial-numbers by AEconversion are definied in a way, that the ID has not more then 3 digits (without leading zeroes) e.g. 123400567, that means, the ID is 567.
invertercomment_x The name of the inverter, displayed in the web-interface
| -> Daten für Inverter Nr 1
inverterid_0=123
invertercomment_0=HauptWR Hausdach
optional parameters:
inverterreduce_x this value can be set, if the power of an inverter shall be reduced by default
inverterreduce_0=240
schuecoid_x
this a a bit special, per default all AEConversion-inverters have the same Schueco/KACO -ID - with this parameter the schueco-id is set to this value on program-Startup. This value is stored in the permanent memory of the inverter, so after setting this parameter once you can place a comment-sign before it.
schuecoid_0=11
invertercolor_x
Set the RGB (hex) color-value for the inverter
invertercolor_0=117711