导航|地址|刷新
Push Services — PVOutput documentation









Overview

General Features

Daily Page

Search

Compare

Teams

Maps

Live Data

Extended Data

Data Aggregation

Alerts

Tariffs

Bulk Loading

Auto Uploader

Push Services
Fronius Push
Fronius Inverter
Parameter dayenergy

Parameter pac

Examples


Fronius Meter
Meter Parameters

Parameter auto

Examples


Fronius Log Data Push
Log Data Push Parameters

Parameter pac

Parameter mode

Examples


Recommended Configuration

Restrictions and Limitations


Eagle Push
Service URL

Parameters

Restrictions and Limitations


IoTaWatt Push

Raven Push
Service URL

Parameters

Restrictions and Limitations


Billion Gateway
Billion Configuration

Restrictions and Limitations


eGauge Push
eGauge Monitor

Example URI Configurations

Restrictions and Limitations



Service Integration

API Specification

Data Services

Managed Systems

Widgets and Portlets

Donations

Commercial Use

Privacy and Security

Terms and Definitions

Terms of Service



PVOutput





Push Services



------





Push Services

Push services are built-in facilities by logging hardware/software to periodically send data to an external location such as PVOutput.

Using a push service requires a PVOutput API key and System Id.

Refer to Service API on how to obtain the SystemId and API Key


Fronius Push

The PVOutput Fronius Push service accepts energy and power data directly from the Fronius inverters with push capability.

This setup requires configuration on the Fronius Push facility and the PVOutput API enabled.


Fronius Inverter

On the Fronius Settings - Push Service screen apply the following settings

Config	Setting
Name	Fronius Push to PVOutput
Data format	SolarAPIv1-CurrentData-Inverter
by	HTTP POST
Interval	5min
activated	checked
Server:Port	pvoutput.org:80
Upload file name	/service/r2/froniuspost.jsp?sid=your_sid&key=your_key
Login	unchecked

Note

Replace your_sid with the System Id and your_key with the PVOutput API Key.


The Upload file name Inverter setting can be updated with the following optional parameters -

Parameter	Description	Values
dayenergy	Enable DAY_ENERGY	0 or 1	Default is 0
pac	Enable PAC	0 or 1	Default is 1

Parameter dayenergy

The energy generation dayenergy setting uses the DAY_ENERGY value sent by the inverter. Enable this setting to use DAY_ENERGY and do not calculate from power (PAC).


Warning

Some Fronius inverters may report incorrect DAY_ENERGY data which will stop increasing at a certain point during the day.

Setting dayenergy=1 may result in under reporting energy generation for certain Fronius hardware and/or firmware setups.




Parameter pac

The power generation pac setting uses the PAC value sent by the inverter. Disable PAC to calculate power from DAY_ENERGY.


Note

PAC is automatically enabled when pac and dayenergy are both disabled.




Examples

Enable generation energy upload and calculate power

/service/r2/froniuspost.jsp?sid=your_sid&key=your_key&dayenergy=1&pac=0

Enable both generation energy and power upload. No calculations

/service/r2/froniuspost.jsp?sid=your_sid&key=your_key&dayenergy=1&pac=1

Enable generation power upload and calculate energy. This is the default with no parameters.

/service/r2/froniuspost.jsp?sid=your_sid&key=your_key&dayenergy=0&pac=1

Fronius Meter

To accept meter consumption data, on the Fronius Settings - Push Service screen apply the following settings.

Config	Setting
Name	Fronius Push to PVOutput
Data format	SolarAPIv1-CurrentData-Meter
by	HTTP POST
Interval	5min
activated	checked
Server:Port	pvoutput.org:80
Upload file name	/service/r2/froniuspost.jsp?sid=your_sid&key=your_key
Login	unchecked

Note

Replace your_sid with the System Id and your_key with the PVOutput API Key.


The Upload file name Inverter setting can be updated with the following optional parameters -

Parameter	Description	Values	Donation
n	Net Flag	0 or 1
auto	Net Auto	0 or 1	Required
c1	Cumulative	0 or 1
v3	Energy Consumed	See Meter Parameters
v4	Power Consumed	See Meter Parameters
v6	Voltage	See Meter Parameters
v7	Extended v7	See Meter Parameters	Required
v8	Extended v8	See Meter Parameters	Required
v9	Extended v9	See Meter Parameters	Required
v10	Extended v10	See Meter Parameters	Required
v11	Extended v11	See Meter Parameters	Required
v12	Extended v12	See Meter Parameters	Required

Meter Parameters

The following meter push values can be set to an extended parameter (v7-v12) , e.g. v12=Voltage_AC_Phase_1 will record voltage values on v12.



PowerReal_P_Sum



Meter_Location_Current



PowerReal_P_Phase_1



PowerReactive_Q_Sum



PowerReactive_Q_Phase_1



Current_AC_Sum



Current_AC_Phase_1



Voltage_AC_Phase_1



Frequency_Phase_Average



PowerApparent_S_Sum



PowerApparent_S_Phase_1



PowerFactor_Sum



PowerFactor_Phase_1



EnergyReal_WAC_Sum_Produced



EnergyReal_WAC_Phase_1_Produced



EnergyReal_WAC_Sum_Consumed



EnergyReal_WAC_Phase_1_Consumed



EnergyReactive_VArAC_Sum_Produced



EnergyReactive_VArAC_Phase_1_Produced



EnergyReactive_VArAC_Sum_Consumed



EnergyReactive_VArAC_Phase_1_Consumed



EnergyReal_WAC_Plus_Absolute



EnergyReal_WAC_Minus_Absolute






Parameter auto

The auto setting is recommended over n when the Fronius Meter is pushing Net data.

Net energy is calculated from the following push data -



EnergyReal_WAC_Plus_Absolute



EnergyReal_WAC_Minus_Absolute




This will produce average power readings using the above energy data instead of instantaneous PowerReal_P_Sum power with n=1


Note

This option requires the start of day energy to be recorded to accurately calculate changes to energy throughout the day. It is recommended to switch to the auto option after sunset then review the results the following day.




Examples

Configuring voltage data

/service/r2/froniuspost.jsp?sid=your_sid&key=your_key&v6=Voltage_AC_Phase_1

Voltage and extended parameter

/service/r2/froniuspost.jsp?sid=your_sid&key=your_key&v6=Voltage_AC_Phase_1&v7=Current_AC_Sum

Disable consumption energy upload, i.e. calculate from power

/service/r2/froniuspost.jsp?sid=your_sid&key=your_key&v3=None

Cumulative Energy

/service/r2/froniuspost.jsp?sid=your_sid&key=your_key&v3=EnergyReal_WAC_Phase_1_Consumed&c1=1&v4=None

Automatically calculate net data from lifetime energy

/service/r2/froniuspost.jsp?sid=your_sid&key=your_key&auto=1

Fronius Log Data Push

The log data push is an optional push config that can be added to send PVOutput hourly updates of all 5-minute data points throughout the day.



This push will record average power values reported by the inverter, the result will be identical to the data recorded on Fronius solarweb.



Data gaps will due to connection issues from the 5-minute current data push be filled in each hour throughout the day by this push.



Instantaneous 5-minute data pushed by CurrentData in the last hour will by overwritten by average 5-minute data.



Meter data is assumed to be Net. To handle gross data, use the mode parameter.



This service is only available in Donation mode.




On the Fronius Settings - Push Service screen apply the following settings -

Config	Setting
Name	Fronius Push to PVOutput (LogData)
Data format	SolarAPIv1-Logdata-Data
by	HTTP POST
Interval	1hour
activated	checked
Server:Port	pvoutput.org:80
Upload file name	/service/r2/froniuspost.jsp?sid=your_sid&key=your_key
Login	unchecked

Note

Replace your_sid with the System Id and your_key with the PVOutput API Key.


The Upload file name Log Data setting can be updated with the following optional parameters -

Parameter	Description	Values
pac	Power Calculation	See Values	Default is 1
mode	Gross Consumption Mode	See Values
v6	Voltage	See Log Parameters
v7	Extended v7	See Log Parameters
v8	Extended v8	See Log Parameters
v9	Extended v9	See Log Parameters
v10	Extended v10	See Log Parameters
v11	Extended v11	See Log Parameters
v12	Extended v12	See Log Parameters

Log Data Push Parameters

The following hourly log push values can be set to an extended parameter (v7-v12) or voltage (v6) , e.g. v12=Voltage_DC_String_1 will record voltage values on v12.



Current_DC_String_1



Current_DC_String_2



EnergyReal_WAC_Sum_Produced



Voltage_DC_String_1



Voltage_DC_String_2




Note extended parameters set on the hourly log push will overwrite the same parameter data set on the 5-minute meter push.



Parameter pac

The pac setting controls how power generation is calculated from the Meter Log Push data.

In the Meter Log Data feed, power is calculated from EnergyReal_WAC_Sum_Produced. The resulting power calculation can result in alternating power ‘ripples’ observed on the graph during periods of peak or increase/decreasing production.

Use options 0 or 2 described below to mitigate these effects.

pac=0 Off
Disable power generation calculation from EnergyReal_WAC_Sum_Produced. Use this option to retain 5-minute PAC values from the Inverter Log push or power values calculated from DAY_ENERGY if PAC is also disabled on the inverter.
pac=1 Calculate
Calculate power generation from EnergyReal_WAC_Sum_Produced. This is the default option and will overwrite 5-minute PAC values from the Inverter Log push.
pac=2 Simple Moving Average
Calculate power generation from EnergyReal_WAC_Sum_Produced with a simple moving average when ripples are detected.

A ripple is defined as four or more alternating power values that is less than 2% of the system size. Values outside the tolerance and pattern will be calculated normally.




Tip

To derive power from the inverter DAY_ENERGY data, set pac=0 on the Meter Log push and pac=0&dayenergy=1 on the Inverter Log push.



Warning

When disabling PAC on both inverter and Meter Log push ensure that the inverter does not have the DAY_ENERGY bug.

Otherwise use the pac=2 simple moving average option to fix power ripples.




Parameter mode

Set the mode if the meter is recording gross consumption. If this parameter is not set, meter data is treated as Net data.

mode=1 Export Meter
Gross consumption recorded on the export meter EnergyReal_WAC_Minus_Absolute. Used in the Meter Log Data push
mode=2 Import Meter
Gross consumption recorded on the import meter EnergyReal_WAC_Plus_Absolute. Used in the Meter Log Data push
mode=2 Reverse
Inverter generation push values registered as consumption. Using in either Inverter Push or Inverter Log Data push





Examples

Use simple moving average for power generation and record Voltage_DC_String_1 on v7

/service/r2/froniuspost.jsp?sid=your_sid&key=your_key&pac=2&v7=Voltage_DC_String_1

Recommended Configuration

The following 3 push configurations provides the best results for inverter and meter data -



Inverter Push (SolarAPI v1 - CurrentData - Inverter)



Meter Push (SolarAPI v1 - CurrentData - Meter)



Log Data Push (SolarAPI v1 - Logdata - Data)






Restrictions and Limitations



Net Meter data pushes must be used in conjunction with inverter push



Default v4 key is PowerApparent_S_Sum



Default n key is PowerReal_P_Sum



Negative net value is treated as export, positive is import



Overwrite the net key by setting the v4 key



Cumulative cannot be used with net data







Eagle Push

The Eagle Push Service accepts a RAVEn InstantaneousDemand XML message and merges the net power with existing generation data.

Data can be sent at a high frequency and will be rounded to the nearest 5 minutes.


Service URL

https://pvoutput.org/service/r2/eaglepost.jsp

Parameters

This service accepts POST requests with the following parameters -

Parameter	Field	Required	Example
n	Net	No	0	Set to 1 (on) if no net flag is set
tz	Timezone	No	See Timezone	Defaults to UTC if no timezone set

The XML data should be sent in the body of the POST request.

curl -X GET -d @c:/tmp/eagle.xml “https://pvoutput.org/service/r2/eaglepost.jsp?sid=Your-SystemId&key=Your-API-Key”

Restrictions and Limitations



Negative power values are treated as export, positive values import



All power is treated as Net by default. Import and Export will be merged with existing Gross generation data to calculate gross consumption



This service is only available in Donation mode







IoTaWatt Push

IoTaWatt devices may be configured to push generation and consumption data directly to PVOutput.

Refer to the IoTaWatt documentation for details -



https://docs.iotawatt.com/en/master/PVoutput.html#configure-iotawatt






Raven Push

The Raven Push Service accepts a RAVEn InstantaneousDemand XML message and merges the net power with existing generation data.

Data should be sent every 5 minutes to ensure requests are kept within the API Rate Limits.


Service URL

https://pvoutput.org/service/r2/ravenpost.jsp

Parameters

This service accepts POST requests with the following parameters -

Parameter	Field	Required	Example
n	Net	No	0	Set to 1 (on) if no net flag is set
tz	Timezone	No	See Timezone	Defaults to Australia/Sydney if no timezone set

The XML data should be sent in the body of the POST request.

curl -d @c:/tmp/raven.xml “https://pvoutput.org/service/r2/ravenpost.jsp?sid=Your-SystemId&key=Your-API-Key”

Restrictions and Limitations



Negative power values are treated as export, positive values import



All power is treated as Net by default. Import and Export will be merged with existing Gross generation data to calculate gross consumption







Billion Gateway

The PVOutput Billion Push service accepts power data directly from the Billion Smart Energy Gateway (SG6200NXL) device.

This setup requires configuration on the Billion Smart Energy Gateway and the PVOutput API enabled.


Billion Configuration

On the router Configuration screen apply the following settings -

Config	Setting
Enabled	Checked
Server Name	api.pvoutput.org
port	80
HTTP Post Interval	5
Index Page	service/r2/bilpost.jsp?sid=your_sid&key=your_key
Historical Interval	5

Note

Replace your_sid with the System Id and your_key with the PVOutput API Key.


The Index Page setting can be updated with the following optional parameters -

Parameter	Description	Values
n	Net Flag	0 or 1

Restrictions and Limitations



Positive data is recorded as consumption and negative data is recorded as generation.







eGauge Push

…(内容过长已截断)

------
导航页 打开网址