A .NET Client wrapper for the Fronius Solar API to obtain data from various Fronius devices (inverters, SensorCards, StringControls) in a defined format through a central facility which acts as a proxy(e.g. FroniusDatalogger Web or Fronius Solar web).

Install the NuGet package

Install-Package FroniusSolarClient.Core

using FroniusSolarClient.Entities.SolarAPI.V1;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;

// Configure logger
var serviceProvider = new ServiceCollection()
    .AddLogging(build => build.AddConsole())
    .Configure<LoggerFilterOptions>(opt => opt.MinLevel = LogLevel.Debug)
    .BuildServiceProvider();

var client = new SolarClient("IP_ADDRESS", 1, serviceProvider.GetService<ILogger<SolarClient>>());

see examples

Internal logging has been implemented so you can parse in your own logger implementation see Microsoft.Extensions.Logging

Realtime Requests

• GetInverterRealtimeData
• GetPowerFlowRealtimeData

Archive Data Requests

• Channels

These requests will be provided where direct access to the realtime data of the devices is possible. This is currently the case for the Fronius Datalogger Web and the Fronius Datamanager.

This request does not care about the configured visibility of single inverters. All inverters are reported.

• CumulationInverterData - Values which are cumulated to generate a system overview.
• CommonInverterData - Values which are provided by all types of Fronius inverters.
• P3InverterData (3PInverterData) - Values which are provided by 3phase Fronius inverters.
• MinMaxInverterData - Minimum and Maximum values of various inverter values.

This request provides detailed information about the local energy grid. The values replied represent the current state. Because of data has multiple asynchronous origins it is a matter of facts that the sum of all powers (grid,load and generate) will differ from zero. This request does not care about the configured visibility of single inverters. All inverters are reported.

Archive requests are provided whenever access to historic device-data is possible. The Datalogger web can only provide what is stored in its internal memory and has not been overwritten by newer data yet, it can loose data due to capacity reasons. The number of days stored is dependant on the number of connected units that are logging data.

Each channel is handled and requested by name. Most of the channels are recorded in constant cyclic intervals which can be set between 5 and 30 minutes. Only Digital_PowerManagementRelay_Out_1, InverterErrors, InverterEvents and Hybrid_Operating_State are event triggered and may occur every time.

• GetInverterRealtimeData
• GetArchiveData

Get CommonInverterData

var response = client.GetCommonInverterData();

Console.WriteLine($"{response.Head.Status.Code} at {response.Head.Timestamp}");
Console.WriteLine(response.Body.Data.TotalEnergy);

Provide device id and scope

var response = client.GetCommonInverterData(2, Scope.System);

Get channel Voltage_AC_Phase data over the past 24 hours

var channels = new List<Channel> { Channel.Voltage_AC_Phase_1, Channel.Voltage_AC_Phase_2, Channel.Voltage_AC_Phase_3 };

var response = client.GetArchiveData(DateTime.Now.AddDays(-1), DateTime.Now, channels);

or between 2 dates

var dateFrom = DateTime.Parse("01/08/2019");
var dateTo = DateTime.Parse("05/08/2019");

var response = client.GetArchiveData(dateFrom, dateTo, channels);

Query intervals are restricted to a maximum of 16 days and the number of parallel queries is system wide restricted to 4 clients.

See Program.cs for more examples