file: inverters.conf

Setup

Configuring your inverters in inverters.conf is probably the most difficult part of the whole jSunnyreports installation. Please pay close attention to this page! If in doubt read it again. 🙂

This part assumes you have already configured your inverter software correctly and all the location(s) are known where the files are saved. Also refer to the other wiki pages of how to setup the specific software you’re using.

Structure

The inverters you want to monitor are configured in a file called “inverters.conf“. This file can be found in the /conf directory. This file will hold all your inverters. jSunnyreports can monitor multiple inverters at once. All inverters are added to this one single file.

This file can be editted using a texteditor like notepad, notepad++, ultraedit on Windows, or VI or NANO when you’re using a Linux based system.

The internal structure for one inverter looks like this:

inverters2.conf

You see one large vertical rectangle in red. This vertical one shows all the properties for this inverter. These properties all belong to the same inverter because they are grouped by this number.

When adding a second inverter just copy the block, change the .1. in  a 2. for all the lines and you have added a second inverter you can configure.

Some inverters require an extra configuration line. More information about this is in the bottom of this page.

Lets investigate all the lines and their meaning.

Invertername

invertername

The name of your inverter you want to use within jSunnyreports. This name must be unique.

Wattpeak

wattpeak

The amount of wattpeak attached to your inverter.

kWhkWp

kwhkwp

Your expected normalized yearly yield in kWh/kWp format. Example. If you have a set of 2000Wp and you expect to get 1300kWh out of it then the right value here is 1300kWh/(2000Wp/1000) = 1300 / 2 = 650kWh/kWp.

Invertertype

invertertype

Important! This value determines your invertertype in jSunnyreports. This value will tell how the software should process your inverterfiles. The possible values are:

1 .xls: SDC ( Sunnybeam data control classic )
2 .xls: Manual entry ( using manual.xls )
3 .txt: Diehl inverters
4 .csv: Solarlog based logging
5 .xls: Fronius inverters
6 .csv: Sunny Explorer
7 .csv: Sunnybeam Bluetooth
8 .pdl: Solarmax Handicom
9 .csv: Soladin600 MKLogger
10 .log: OK4E inverters ( OK4EManager )
11 .txt: Solarmax Maxtalk
12 .csv: Consospy inverters
13 .csv: Sunesy inverters
14 .csv: MKArduinoLogger
15 .log: Aurora ONE
16 .csv: Schuco inverters
17 .csv: Sunny Webbox
18 .suo: SDC ( Sunnybeam classic )
19 .csv: Mastervolt XS
20 .csv: Omnik
21 .csv: Enphase
22 .csv: kostalpico
23 .csv: MangoDB
24 .csv: SolarLog1000 ( multiple inverters in one file possible! )

inputdirectory

inputdirectory

The directory your logfiles are in. Important note: always use forward slashes “/”.

Barcolor

barcolor

The color of this inverter in the bar charts. All items are in the notation RED,GREEN,BLUE. Where valid values are between 0 till 255.

Examples:

  • 255,0,0 = RED
  • 0,255,0 = GREEN
  • 0,0,255 = BLUE

In the above case the bar charts will be dark blue for this inverter.

linecolor

linecolor

The color of the linecharts. A good practice here is to use the same color as the bar charts.

fromdate

fromdate

The date your inverter went online. Important note. This is in the notation DD-MM-YYYY!

comparelinecolor

comparelinecolor

The compare line color. This line is used in the best vs current day chart. A good practice here is to use a similar color as the bar and line color but make it a bit brighter or darker. In this case its a bit brighter.

correctionfactor

correctionfactor

Some inverters are a bit more optimistic in the yield produced. If you have a meter that is accurate and you know the difference ( percentage ) between the good meter and your inverter you can use this value to correct the values jSunnyreports will display.

Example:

  • A correctionfactor of 0.9 means your inverter is 10% too optimistic. If your inverter says it produced 10kWh on a day but the actual value is 9kWh then 0.9 is  the right value. ( 10kWh * 0.9 = 9kWh yield ).
  • A correctionfactor of 1.1 means your inverter is 10% too pessimistic ( 10kWh * 1.1 = 11kWh ).

inclination and orientation

inclination

orientation

Both values determine the angle of your solar panels towards a compass. Inclination is the angle between a flat horizontal surface and your solar panels.

Orientation is the orientation of your panels compared to a compass. 0 means north, 90 means your panels are facing east, 180 means south, 270 means west.

tilldate

tilldate

If your set is decommissioned but your want to keep all data in jSunnyreports then fill in the date this inverter went offline.

Also in DD-MM-YYYY format.

Examples

 

You are a bit uncertain and want a quick start? Locate your inverter and press the link. You will be forwarded to another wikipage where you can cut and paste the specifics for this inverter.

1 .xls: SDC ( Sunnybeam data control classic )
2 .xls: Manual entry ( using manual.xls )
3 .txt: Diehl inverters
4 .csv: Solarlog based logging
5 .xls: Fronius inverters
6 .csv: Sunny Explorer
7 .csv: Sunnybeam Bluetooth
8 .pdl: Solarmax Handicom
9 .csv: Soladin600 MKLogger
10 .log: OK4E inverters ( OK4EManager )
11 .txt: Solarmax Maxtalk
12 .csv: Consospy inverters
13 .csv: Sunesy inverters
14 .csv: MKArduinoLogger
15 .log: Aurora ONE
16 .csv: Schuco inverters
17 .csv: Sunny Webbox
18 .suo: SDC ( Sunnybeam classic )
19 .csv: Mastervolt XS
20 .csv: Omnik
21 .csv: Enphase
22 .csv: kostalpico
23 .csv MangoDB
24 .csv Solarlog1000

Next up

optional step, enter data in summary.conf