Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/enwi/rngbridgedoc

Documentation and guides for RNGBridge the renogy to wifi bridge with PVOutput and MQTT support and much more
https://github.com/enwi/rngbridgedoc

charge-controller esp8266 mqtt pvoutput renogy renogy-rover solar user-interface webinterface

Last synced: 5 days ago
JSON representation

Documentation and guides for RNGBridge the renogy to wifi bridge with PVOutput and MQTT support and much more

Host: GitHub
URL: https://github.com/enwi/rngbridgedoc
Owner: enwi
Created: 2022-02-23T16:45:22.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2022-12-05T19:00:50.000Z (almost 2 years ago)
Last Synced: 2024-05-02T05:20:05.130Z (6 months ago)
Topics: charge-controller, esp8266, mqtt, pvoutput, renogy, renogy-rover, solar, user-interface, webinterface
Homepage:
Size: 117 MB
Stars: 13
Watchers: 2
Forks: 0
Open Issues: 6
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        [![Discord](https://img.shields.io/discord/781219798931603527.svg?label=enwi&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/YxVyJWX62h)

# RNGBridgeDoc V3 

Documentation and guides for RNGBridge V3, an RS485 or RS232 to WiFi bridge for Renogy solar charge controllers with PVOutput and MQTT support.

Trying to find documentation of an older version?

- [V2 documentation](https://github.com/enwi/RNGBridgeDoc/tree/v2)

- [V1 documentation](https://github.com/enwi/RNGBridgeDoc/tree/v1)

## Feature overview

- Beautiful web interface

   - Control `Load`, `Out1`, `Out2` and `Out3` remotely

   - Get more information about system errors by hovering over them

   - Battery capacity intuitively visualized

   - ![web interface](https://github.com/enwi/RNGBridgeDoc/blob/main/images/webinterface.png)

- Over the air software updates (`OTA`)

   - Displays a banner with download link when a new update is available (since [V2.5.0](https://github.com/enwi/RNGBridgeDoc/releases/tag/2.5.0))

   - Keeps configuration after update

- Optional data publishing to [MQTT](https://en.wikipedia.org/wiki/MQTT)

   - Works with protected Brokers (`username`, `password`)

   - Configurable `topic`, `client id`, `port` and `ip`

   - Configurable update interval (since [V2.3.0](https://github.com/enwi/RNGBridgeDoc/releases/tag/2.3.0))

   - Control `Load`, `Out1`, `Out2` and `Out3` (since [V2.7.0](https://github.com/enwi/RNGBridgeDoc/releases/tag/2.7.0))

   - Supports [Homeassistant Discovery](https://www.home-assistant.io/docs/mqtt/discovery/) (since [V2.7.0](https://github.com/enwi/RNGBridgeDoc/releases/tag/2.7.0))

   - Publish data on individual topics (since [V2.10.0](https://github.com/enwi/RNGBridgeDoc/releases/tag/2.10.0))

- Optional data publishing to [PVOutput](https://pvoutput.org)

   - Configurable time offset

- Automatic `Load`, `Out1`, `Out2` and `Out3` control

   - lower/upper setpoint

   - can be inverted

   - control depending on battery SOC(state of charge), battery voltage, panel voltage (since [V2.6.0](https://github.com/enwi/RNGBridgeDoc/releases/tag/2.6.0)) or panel current (since [V2.6.0](https://github.com/enwi/RNGBridgeDoc/releases/tag/2.6.0))

- [REST API](https://github.com/enwi/RNGBridgeDoc/blob/main/rest.md)

   - Control `Load`, `Out1`, `Out2` and `Out3`

   - Request current charge controller state (since [V2.7.0](https://github.com/enwi/RNGBridgeDoc/releases/tag/2.7.0))

Missing anything? If you want support for a custom feature or want to suggest something, feel free to open an issue or join the [Discord Server](https://discord.gg/YxVyJWX62h).

## Where to buy



- [Get the RS485 kit here](https://www.tindie.com/products/28668/)

- [Get the RS232 kit here](https://www.tindie.com/products/21360/)

## Supported devices

All supported and tested Charge Controllers can be found [here](https://github.com/enwi/RNGBridgeDoc/blob/main/controllers.md)

## Getting started

- [Assemble `RNGBridge` using the build instructions](https://github.com/enwi/RNGBridgeDoc/blob/main/soldering.md)

- [Setup your device using the commissioning guide](https://github.com/enwi/RNGBridgeDoc/blob/main/comissioning.md)

- [Connect `RNGBridge` to your MQTT Broker](https://github.com/enwi/RNGBridgeDoc/blob/main/mqtt.md)

- [Publishing data to PVOutput](https://github.com/enwi/RNGBridgeDoc/blob/main/pvoutput.md)

- [Automatically control load output and `Out1`, `Out2` and `Out3`](https://github.com/enwi/RNGBridgeDoc/blob/main/control.md)

- [Control `Load`, `Out1`, `Out2` and `Out3` through REST api](https://github.com/enwi/RNGBridgeDoc/blob/main/rest.md)

- [Request current charge controller state](https://github.com/enwi/RNGBridgeDoc/blob/main/rest.md)

- [Get debug output](https://github.com/enwi/RNGBridgeDoc/blob/main/debugging.md)

## About

See the about section [here](https://github.com/enwi/RNGBridgeDoc/blob/main/about.md)