Learn R Programming

microinverterdata

The goal of microinverterdata is to provide access to your local micro-inverter data.

Installation

You can install the released version from CRAN with:

install.packages("microinverterdata")

You can install the development version of {microinverterdata} from GitHub with:

# install.packages("pak")
pak::pak("CamembR/microinverterdata")

Example

This is a basic example to get inverter data for a single device:

library(microinverterdata)

## single micro-inverter device data
get_output_data(device_ip = "192.168.0.75")
#> # A tibble: 2 × 5
#>   device_id    inverter   output_power today_energy lifetime_energy
#>   <chr>        <chr>               [W]         [kW/h]          [kW/h]
#> 1 E07000017176 inverter_1          127          0.336            251.
#> 2 E07000017176 inverter_2          128          0.342            265.

The single device here includes 2 separated inverters. We get one row of data per inverter, i.e. per solar panel.

You can also use a vector of IP addresses for device_ip. Thus the command would run on all the inverters

## multiple inverters data
get_output_data(device_ip = c("192.168.0.75", "192.168.0.186"))
#> # A tibble: 4 × 5
#>   device_id    inverter   output_power today_energy lifetime_energy
#>   <chr>        <chr>               [W]         [kW/h]          [kW/h]
#> 1 E07000017176 inverter_1          126          0.336           251. 
#> 2 E07000017176 inverter_2          128          0.342           265. 
#> 3 E07000021746 inverter_1          125          0.334            44.0
#> 4 E07000021746 inverter_2          123          0.329            59.0

The packages also gives access to inverter information through get_device_info() and inverter internal alarms through get_alarm().

Inverter support and configuration

The package allow querying values on diverse device models through the model = "..." parameter.

{microinverterdata} may require a minimal software version and configuration for the supported inverters :

Inverter ManufacturerInverter ModelFirmware versionConfiguration
APSystemsEZ1≥ 1.7.0Continuous local mode (off-cloud)
Froniusmultiple≥ 1.7.2off-cloud (Need testers)
EnphaseEnvoy-SD5.x.xoff-cloud (Need testers)
EnphaseEnergy< 7.xoff-cloud (Need testers)

Copy Link

Version

Install

install.packages('microinverterdata')

Monthly Downloads

532

Version

0.3.0

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Christophe Regouby

Last Published

April 14th, 2025

Functions in microinverterdata (0.3.0)

query_ap_device

AP System single device query
query_ap_devices

AP System multi-device query
query_fronius_devices

Fronius multi-device query
query_enphaseenergy_device

Enphase Energy single device query
get_output_data

Get inverter output data
query_fronius_device

Fronius single device query
get_device_info

Get inverter device information
get_alarm

Get inverter device alarms
query_enphaseenvoy_device

Enphase Envoy single device query