Collect your Microinverter Data

Collect and normalize local microinverter energy and power production data through off-cloud API requests. Currently supports 'APSystems', 'Enphase', and 'Fronius' microinverters.


microinverterdata

R-CMD-check Lifecycle:experimental CRANstatus

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")

Or 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 E07000011776 1                  66        0.138            478.
#> 2 E07000011776 2                  69        0.145            489.

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 in parallel.

## 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 E07000011776 1                  66        0.138            478.
#> 2 E07000011776 2                  69        0.145            489.
#> 3 E07000011433 1                  68        0.145            265.
#> 4 E07000011433 2                  68        0.144            276.

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

Microinverter 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 Manufacturer Inverter Model Firmware version Configuration
APSystems EZ1 ≥ 1.7.0 Continuous local mode (off-cloud)
Fronius multiple ≥ 1.7.2 off-cloud (Need testers)
Enphase Envoy-S D5.x.x off-cloud (Need testers)
Enphase Energy < 7.x off-cloud (Need testers)

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("microinverterdata")

0.4.0 by Christophe Regouby, a year ago


https://camembr.github.io/microinverterdata/, https://github.com/CamembR/microinverterdata


Report a bug at https://github.com/CamembR/microinverterdata/issues


Browse source code at https://github.com/cran/microinverterdata


Authors: Christophe Regouby [aut, cre, cph]


Documentation:   PDF Manual  


MIT + file LICENSE license


Imports cli, dplyr, glue, httr2, purrr, rlang, tidyr, units

Suggests httptest2, knitr, lubridate, pins, rmarkdown, tibble, tsibble, imputeTS, testthat


See at CRAN