rob
/
solar-toolkit
1
0
Fork 0
Code Issues 2 Pull Requests Projects Releases Wiki Activity
A toolkit for reading and storing metrics from a Goodwe solar inverter
go
32 Commits 1 Branch 0 Tags 346 KiB
Go 99%
Dockerfile 1%
Go to file
Rob Watson 00fb2c7f2f
continuous-integration/drone/push Build is passing Details
docs: update README.md 		2023-10-01 08:56:42 +02:00
cmd Write meter data to store 2022-07-19 21:34:32 +02:00
command docs: update README.md 2023-10-01 08:56:42 +02:00
gateway Write meter data to store 2022-07-19 21:34:32 +02:00
inverter docs: update README.md 2023-10-01 08:56:42 +02:00
.drone.yml chore: upgrade Go to 1.21.1 2023-09-11 21:57:25 +02:00
Dockerfile chore: upgrade Go to 1.21.1 2023-09-11 21:57:25 +02:00
LICENSE Add LICENSE 2022-07-13 19:04:13 +02:00
README.md docs: update README.md 2023-10-01 08:56:42 +02:00
go.mod chore: upgrade deps 2023-09-11 22:00:45 +02:00
go.sum chore: upgrade deps 2023-09-11 22:00:45 +02:00
picture.png docs: update README.md 2023-10-01 08:56:42 +02:00

README.md

solar-toolkit

A side project to collect, transport and store data from a Goodwe solar inverter.

Based on Marcel Blijleven's Python library, ported to Go and re-packaged as a client/server application.

This project is mostly for personal use - it hasn't been polished for wider usage and isn't yet compatible with the full range of inverters supported by the above library (it has been tested against a GW5000-EH).

Git

The main git repo is: https://git.netflux.io/rob/solar-toolkit

It is also mirrored on GitHub: https://github.com/rfwatson/solar-toolkit

Components

solar-toolkit-daemon

A binary which can be triggered using using a cronjob. It queries the inverter for metrics, parses and encodes them and sends the result over HTTPS to the server process.

solar-toolkit-gateway

A binary which accepts incoming HTTP requests containing inverter metrics, and writes them to a PostgreSQL database.

Visualisation

Once collected, the metrics can be visualised using any graphing software, e.g. Grafana.

Solar metrics

TODO

  • (client) improve error handling, e.g. during network outage
  • (client) support more Goodwe models
  • (client) allow fine-tuning of the collected metrics (e.g. ignore selected metrics)
  • (database) migrate from fixed schema to a single JSONB column

Build

go build ./...

To build the client for linux-arm64 (e.g. Raspberry Pi):

GOOS=linux GOARCH=arm go build -o solar-toolkit-daemon ./cmd/daemon

License

Licensed under the MIT license. See the LICENSE file.