Skip to content

explosivo22/rinnaicontrolr-ha

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rinnai Control-R for Home Assistant

Support for Rinnai Control-R Water Heater monitoring and control device for Home Assistant.

release_badge release_date License hacs_badge HA integration usage

Buy Me A Coffee

KNOWN ISSUES

  • Rinnai currently has a known bug that will cause recirculation to only run for 5 minutes.
  • OFFICIAL RESPONSE

Thank you for contacting Rinnai.

If you are referring to the on demand timers listed in the Control-R 2.0 app, then yes, that is a known issue and I apologize for the inconvenience. I have been told that there's a large update planned for the app and these should issues should be addressed. For now, if you need the unit to run longer than 5 minutes, I would suggest creating a schedule, even if it's just for a short period like an hour.

If you have any other questions or concerns, feel free to reach out to us again.

Nicholas Valencia Customer Care Agent

WARNING

  • THIS LIBRARY ONLY WORKS IF YOU HAVE MIGRATED TO THE RINNAI 2.0 APP. THIS WILL REQUIRE A FIRMWARE UPDATE TO YOUR CONTROL-R MODULE.
  • IOS
  • Android

IMPORTANT NOTES

  • RINNAI DOESN'T PROVIDE ANY OFFICIALLY SUPPORTED API, THUS THEIR CHANGES MAY BREAK HASS INTEGRATIONS AT ANY TIME.

Features

  • water heater:
    • water temperature (°F)
    • set operating temperature
    • start recirculation (on capable models)(via service)
  • multiple Rinnai devices
  • reduced polling of Rinnai webservice to avoid unintentional DDoS

Special Rinnai Services

The Integration adds specific Rinnai services. Below is a list of the Rinnai specific services:

Service Parameters Description
rinnai.start_recirculation entity_id - Name of entity to start recirculation on.
recirculation_minutes - How long to run recirculation
Start recirculation for the amount of time specified
rinnai.stop_recirculation entity_id - Name of entity to stop recirculation on. Stop recirculation on the specified entity

Installation

Versions

The 'master' branch of this custom component is considered unstable, alpha quality and not guaranteed to work. Please make sure to use one of the official release branches when installing using HACS, see what has changed in each version.

With HACS

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Manual

  1. Copy the rinnai directory from custom_components in this repository and place inside your Home Assistant's custom_components directory.
  2. Restart Home Assistant
  3. Follow the instructions in the Setup section

Warning

If installing manually, in order to be alerted about new releases, you will need to subscribe to releases from this repository.

Setup

Open your Home Assistant instance and start setting up a new integration.

Tip

If you are unable to use the button above, follow the steps below:

  1. Navigate to the Home Assistant Integrations page (Settings --> Devices & Services)
  2. Click the + ADD INTEGRATION button in the lower right-hand corner
  3. Search for Rinnai Control-R Water Heater