Python interface for Rinnai Control-R API
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
rinnaicontrolr-0.4.0.tar.gz
(14.3 kB
view hashes)
Built Distribution
Close
Hashes for rinnaicontrolr-0.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 50027b7d4876784392ac1cabf961d8a01923dbeebfbae28bc8cb1469bc1d882b |
|
MD5 | 760984fdcd3af424c1dba645b52732ad |
|
BLAKE2b-256 | 49e9886c2ab949da546093cd7465feebda69ac91c8460f6e4d62394dbbeb8dba |