README.md
In microinverterdata: Collect your Microinverter Data

microinverterdata

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

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

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().

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