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")
install.packages("microinverterdata", repos = c('https://camembr.r-universe.dev', 'https://cloud.r-project.org'))
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 311 0.644 481.
#> 2 E07000011776 2 323 0.697 492.
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 311 0.644 481.
#> 2 E07000011776 2 323 0.697 492.
#> 3 E07000011433 1 319 0.690 268.
#> 4 E07000011433 2 312 0.679 279.
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) |
No matter your current skills, it’s possible to contribute to microinverterdata development. We welcome all kinds of contributions, from correcting typos via bug fixes to feature additions.
To fix typos, spelling mistakes, or grammatical errors, you need to make changes in the source .R file in question, not in the generated .Rd file.
If you find a bug in microinverterdata, please open an New issue here. Please provide detailed information on your microinverter (model, version, ) . It would be great to also provide a link to the documentation of its API.
Feel free to open a New issue here, and add the feature-request tag. Also try searching if there’s already an open issue for your feature-request – in this case it’s better to comment or upvote it instead of opening a new one.