Rinnai Control-R for Home Assistant

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

Caution

⚠️ Upgrading from v1.x.x? Migration Required!

Version 2.0.0 renamed the integration folder from rinnaicontrolr-ha to rinnai. HACS cannot handle this automatically.

You must:

1. Remove the integration from Home Assistant
2. Remove via HACS
3. Manually delete custom_components/rinnaicontrolr-ha/
4. Restart Home Assistant
5. Install v2.0.0 fresh

📖 Full Migration Guide

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

• Connection Modes:

  • Cloud - Uses Rinnai Control-R cloud API (default)
  • Local - Direct TCP connection to water heater (port 9798) for faster, more reliable control
  • Hybrid - Local primary with automatic cloud fallback

• Water Heater Control:

  • Water temperature (°F)
  • Set operating temperature (110-140°F)
  • Operation mode (on/off)
  • Vacation/away mode
  • Start/stop recirculation (on capable models)(via service)

• Sensors:

  Sensor	Description
  Outlet Temperature	Current hot water outlet temperature
  Inlet Temperature	Cold water inlet temperature
  Water Flow Rate	Current water flow in GPM
  Combustion Cycles	Total burner ignition cycles
  Operation Hours	Total burner operation hours
  Pump Hours	Recirculation pump run hours
  Pump Cycles	Recirculation pump cycle count
  Fan Current	Combustion fan current (mA)
  Fan Frequency	Combustion fan speed (Hz)

• Binary Sensors:

  Sensor	Description
  Heating	On when water heater is actively heating
  Recirculation	On when recirculation pump is running

• Switch:

  Switch	Description
  Recirculation	Toggle to start/stop recirculation with configurable duration

• Additional Features:

  • Multiple Rinnai devices support
  • Reduced polling of Rinnai webservice to avoid unintentional DDoS
  • Multi-language support (14 languages)
  • Proactive token refresh before expiration
  • Dynamic device discovery without reload

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 (5-300)	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

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

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

Configuration Options

After setup, configure options via the integration's Configure button:

Option	Description	Default
Enable maintenance data	Retrieves detailed sensor data every 5 minutes	Off
Recirculation duration	Default duration for recirculation switch (5-300 min)	10 min

Local Mode Requirements

For local/hybrid connection modes:

• Control-R module must be accessible on your local network
• Port 9798 must not be blocked by firewall
• Static IP or DHCP reservation recommended