rinnaicontrolr - Python interface for the Rinnai Control-R API
Python library for communicating with the Rinnai Control-R Water Heaters and control devices via the Rinnai Control-R cloud API.
Rinnai's API is completely insecure. We recommend that you disconnect your water heater from the Control-R system until Rinnai fixes these basic issues.
This library is community supported. Please submit changes and improvements.
Support For
- reading and setting the temperature setpoint
- reading whether heating or recirculation is in progress
- starting recirculation
Limited Support For
- reading schedules, vacation state
- reading flow rates and service parameters
- reading intake temperature, outlet temperature
- reading the address of the device as entered into Control-R
No Support For
- creating schedules
- setting vacation state
Please submit pull requests to add support for your favorite values.
Installation
pip install rinnaicontrolr
Example
rinnai = RinnaiWaterHeater(username, password)
for device in rinnai.get_devices():
rinnai.set_temperature_setpoint(device, 90) # make it annoyingly cold
rinnai.start_recirculation(device, 15) # start recirculation for 15 minutes
if rinnai.is_heating(device):
print(f'heater is heating to a setpoint of {rinnai.get_temperature_setpoint(device)} degrees.')
Known Issues
- Rinnai's API performs no authentication. Sorry, we can't fix this, we don't work for Rinnai.
Future Plans
- Perform authentication once Rinnai's API requires it.
- asyncio interface.
1 maintainer
Metadata
1 maintainer
Release files for rinnaicontrolr 0.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| rinnaicontrolr-0.4.1.tar.gz | 14.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| rinnaicontrolr-0.4.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 29.1 kB
Release files / rinnaicontrolr-0.4.1.tar.gz
| Download URL | rinnaicontrolr-0.4.1.tar.gz |
|---|---|
| Size | 14.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
31b105fbb543e9bed8bc3c732bfdedf86d702306a541dd3beab088d00eb735dd
|
|
BLAKE2b-256 checksum How to use checksums |
38976852a1ffe7a7907bcd4abc189cb23f08c715d4042b742cf75e96eeb7389b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.10.6
|
Release files / rinnaicontrolr-0.4.1-py3-none-any.whl
| Download URL | rinnaicontrolr-0.4.1-py3-none-any.whl |
|---|---|
| Size | 14.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
054a47439619e949749d0b61d16df45bfa32d285f0731202eb7a328fab04cc63
|
|
BLAKE2b-256 checksum How to use checksums |
f92e601d50d7d83a3de6c5ea97f3724eff5ee1626b75c561713bb799385d6921
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.10.6
|
