# Huawei Solar

![CI](https://github.com/javierav/huawei_solar/workflows/CI/badge.svg)

A Ruby library for connect to Huawei Solar inverters using Modbus TCP.

## Status

> :warning: **This project is still experimental, use with caution!**

PR are welcome to increase the property list in [data/registers.yml](data/registers.yml)

## Example

```ruby
require "huawei_solar"

hs = HuaweiSolar.new("192.168.0.110", 502)

hs.read(:inverter_model) # => "SUN2000-3.68KTL-L1"
hs.read(:inverter_input_power) # => 234.0
hs.read(:inverter_input_power, with_unit: true) # => "234.0 W"

hs.read(%i[inverter_output_power inverter_daily_energy meter_grid_power])
# => [225.0, 5.82, -339.0]

hs.read(%i[inverter_output_power inverter_daily_energy meter_grid_power], with_unit: true)
# => ["225.0 W", "5.82 kWh", "-339.0 W"]

hs.close
```

## License

Copyright © 2023 Javier Aranda. Released under the terms of the [MIT license](LICENSE).