PVOutput Integration Service Installation Guide v1.4.9

Software Requirements

1. Java Runtime Edition 1.6 or later - Download

Installation

1. Extract the files to a directory on your computer
2. Run bin\Install-Service.bat. This will install the program as a windows service called PVOutput Integration Service
• Ensure you are logged in as an Windows administrative user with rights to install services on your machine.
• Windows 7 users may need to change User Account Control Settings to Never Notify and restart the computer prior to installing.

API Setup

1. Open conf\pvoutput.ini and replace the values shown in red below

# Request an API key from the pvoutput.org 'Settings' menu option key=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # Your System Id is shown in the pvoutput.org 'Settings' menu option sid=0

Configuration for Live Outputs

Follow the instructions below to setup sending live outputs recorded from your inverter log to pvoutput

# The directory where your daily data logs are stored dir=c:/logs # # Inverter/monitor type - valid values are # # aurora # xantrex # solarlog # growatt # suntellite # currentcost # flukso # sunnyroo # ted5000 # enphase # pvmate # enasolar # kaco # owl # danfoss # sdc # csv format=aurora

CurrentCost Configuration

Open conf\currentcost.ini and replace the port, rate and channels properties with your current cost device settings.

Example 1 - monitor whole house consumption

sensor=0 direction=in

sensor=1 direction=out

sensor=1,2 direction=in,in

sensor=0,1 direction=in,out

Ted5000 Configuration

Open conf\ted5000.ini and configure the url setting with your gateway hostname.

Enphase Configuration

Open conf\enphase.ini and configure your Enlighten API Key and System Id

Flukso Configuration

Open conf\flukso.ini and replace the token setting with your own Flukso token.

Xantrex SG View

Uncomment the file configuration in conf\pvoutput.ini and add the following line

file=SGTData Data Log {MM-dd-yyyy}.xls

SolarLog Configuration

Uncomment the file configuration in conf\pvoutput.ini and enter the location of the 'min_day.js' file

file=http://192.168.0.5/log/min_day.js OR file=ftp://username:password@192.168.0.5/min_day.js

Growatt Configuration

Open conf\growatt.ini and enter the your serial number(s).

This is used to determine the filename of your MDB file e.g 0030001234_20112.MDB.

serial_number=0030001234

For multiple inverters separate each inverter serial number with a comma.

serial_number=0030001234,0030005678

Sunnyroo Configuration

Open conf\sunnyroo.ini and follow the instructions on how to add an ODBC Datasource.

datasources=sunnyroo

For multiple data sources separate each data source with a comma.

datasources=sunnyroo,sunnyroo2

Suntellite / Solar-River Configuration

Open conf\suntellite.ini and enter the your static CSV filename.

If you have more than one inverter, separate each inverter filename with a comma

filename=S5123A9876.csv

Configure the dir parameter in conf\pvoutput.ini without the date in the directory location i.e.

dir=C:/logs/Suntellite/Data/Daily

This will read the daily log file at C:\logs\Suntellite\Data\Daily\2011-2-19\S5123A9876.csv

PV Mate Configuration

Open conf\pvmate.ini and enter the location of your database and serial number(s).

The database is located where PV Mate is installed. The database file should be called 'pvmate.db'

database=C:/Program Files/PVMate Data Manager/pvmate.db

The serial number is the 'SN_Name' value under the 'Data logging' tab in PV Mate Data Manager.

serial_number=S/N 46S11010099

For multiple inverters separate each inverter serial number with a comma.

serial_number=S/N 46S11010099,S/N 46S11010098

Enasolar Configuration

Open conf\enasolar.ini and configure the url setting with your inverter hostname.

Combining Outputs and Inputs

You can combine two or more formats to uploading e.g. an pv export and energy monitor import.

The following configuration in conf\pvoutput.ini uses an Aurora export and Current Cost import format.

The Aurora log file is located in c:\logs and the current cost logs is generated in c:\tmp. The power and energy readings for Aurora and Current Cost are uploaded separately.

dir=c:/logs,c:/tmp format=aurora,currentcost

The following configuration in conf\pvoutput.ini uses an Aurora export and Xantrex export format.

Both inverter log files are located in c:\logs. The power and energy readings from both inverters are combined and uploaded.

dir=c:/logs,c:/logs format=aurora,xantrex

Configuration for Daily Outputs

Follow the instructions below to setup sending daily outputs recorded in an Excel spreadsheet to pvoutput

1. Open conf\excel.ini and replace the values shown in red below

# The file location of your spreadsheet (use forward slashes '/' and no quotes) daily-file=c:/logs/solar.xls # The worksheet where your data is stored, 0 - first, 1 - second etc daily-worksheet=0 # The output date column, 0 - A, 1 - B etc daily-column-date=0 # The output energy column (kWh) daily-column-energy=1

Running

1. Run bin\Start-Service.bat to start the service.

Linux

Installation

1. Extract or upload the following directories from the installation -
• logs
• conf
• data
• lib
• bin
2. Execute chmod 755 bin/pvoutput.sh

Running

1. Run bin/pvoutput.sh to start the process.

Notes

• Both live and daily outputs can be setup and run at the same time.
• Daily outputs will be submitted after the spreadsheet has been saved or modified.
• Only outputs missing from pvoutput but present in the spreadsheet will be submitted.