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