Skip to content

Latest commit

 

History

History
115 lines (85 loc) · 5.79 KB

README.md

File metadata and controls

115 lines (85 loc) · 5.79 KB
Raw

SolarThing

SolarThing

Stores solar data in a database to view on Android, Grafana, or PVOutput

View full documentation at https://solarthing.readthedocs.io/

Contents

Supported Products

  • Outback MATEs (FX Inverter, MX/FM Charge Controller)
  • Renogy Rover (And other Renogy products) over modbus serial.
    • Includes Rover, Rover Elite, Wanderer, Adventurer, Dual Input DCDC Charger, Rover Boost and possibly others
    • Compatible with all SRNE Solar Charge Controllers (And rebranded products)
    • Compatible with Zenith Grape Solar Charge Controller, PowMr MPPT Charge Controller, RICH SOLAR MPPT, WindyNations TrakMax MPPT
  • EPEver Tracer
    • Includes the AN series and the TRIRON N series
    • Possibly includes the BN series (untested)
  • DS18B20 Temperature Sensors and PZEM-003 and PZEM-017 Shunts

Quickstart

Ready to install? Use the Quickstart!

Features

  • Supports multiple types of solar products.
  • Runs reliably 24-7. Recovers from connection errors and has verbose logging features.
  • Fully customizable through JSON (No programming experience required).
  • Supports CouchDB, InfluxDB, local JSON file, and PVOutput exporting.
    • Multiple databases can even be used at the same time!
    • Packets are uploaded in parallel to multiple databases at the same time
  • Can report CPU temperature.
  • Runs inside a Docker container

Viewing Your Data

If you are wondering how to set up SolarThing to view your data, you can head here: https://solarthing.readthedocs.io/en/latest/quickstart/data/index.html

Supported Databases

  • CouchDB
    • Recommended database and best supported database for SolarThing
    • Used with Wild GraphQL Data Source to view data in Grafana
    • Used with SolarThing Android to view data in the Android app
    • Used as intermediate storage before data is aggregated and uploaded to PVOutput
  • InfluxDB
    • Upload statistics to InfluxDB and view them in your visualization tool of choice (Grafana is an option)
  • REST API
    • With the "post" database, all packets can be posted to a URL endpoint, useful for REST APIs

Screenshots and Examples

You can get data in Grafana via CouchDB+SolarThing Server or via InfluxDB (InfluxDB not recommended).

Grafana is customizable. Rearrange graphs and make it how you want! Pre-made Grafana dashboards are coming soon.

alt text

PVOutput Wild Mountain Farms: PVOutput System and PVOutput SolarThing Teams

SolarThing Android: GitHub | Google Play

SolarThing Android displays data in a persistent notification that updates at a configurable rate alt text

Suggestions?

If you have suggestions on how to improve the documentation or have a feature request, I'd love to hear from you! SolarThing Issues or SolarThing Discussions

Any confusion you get while setting up SolarThing is something that can be improved upon. If you need help, ask for help! That way we can make the documentation clearer for everyone!