Skip to content

aiautobusinesses/rointe-hacs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rointe Nexa – Home Assistant Custom Integration

hacs_badge Version License: MIT

This is a custom integration for Home Assistant that connects to the Rointe Nexa cloud platform. It allows you to control your Rointe radiators and heaters directly from Home Assistant.


✨ Features

  • Dual Authentication System: REST API + Firebase authentication for maximum compatibility
  • Real-time Updates: WebSocket connection for instant device state updates
  • Automatic Device Discovery: Finds all installations, zones, and devices automatically
  • Multiple Device Types: Support for radiators, towel rails, thermostats, and oval towel warmers

Climate Control

  • Turn on/off (comfort/eco/ice modes)
  • Set target temperature with mode-specific ranges
  • View current temperature and HVAC mode
  • Enhanced device information (model, power rating, serial number)

Energy Monitoring

  • Power Consumption Sensor: Real-time power usage in watts
  • Energy Consumption Sensor: Total energy consumption in kWh
  • Current Temperature Sensor: Separate temperature monitoring

Firmware Management

  • Firmware Update Detection: Binary sensor for update notifications
  • Version Tracking: Current and latest firmware versions

Device Information

  • Device category detection (radiator, towel_rail, thermostat, oval_towel)
  • Serial numbers and MAC addresses
  • Zone and installation information
  • Online/offline status tracking

📦 Installation

  1. Copy the rointe folder into:

<config>/custom_components/rointe

where <config> is your Home Assistant config directory.

  1. Restart Home Assistant.

  2. In HA, go to:
    Settings → Devices & Services → Add Integration → Search for “Rointe”

  3. Enter your Rointe Nexa email + password.

  • Home Assistant exchanges this for a refreshToken.
  • Only the refresh token is stored; your password is not kept.
  1. Your Rointe devices will appear as Climate entities.

📂 Directory Layout


custom_components/rointe/
├── **init**.py
├── api.py
├── auth.py
├── climate.py
├── config_flow.py
├── const.py
├── manifest.json
├── strings.json
└── translations/
└── en.json


⚠️ Notes

  • Requires a valid Rointe Nexa cloud account (same as the mobile app).
  • This integration is not official and not affiliated with Rointe.
  • The Firebase API key in use is public (from Rointe’s own app) and not tied to your account.
  • Tokens are managed securely by Home Assistant; your password is not stored.

🛠️ Roadmap

  • Enhanced HVAC modes (AUTO, HEAT_COOL)
  • Preset modes (Comfort, Eco)
  • Comprehensive error handling
  • Device information display
  • Improved configuration flow
  • Add support for scheduling (edit/view Rointe weekly programs)
  • Add service calls for advanced features (eco, anti-frost, etc.)
  • Improve device model discovery (power, nominal wattage, etc.)

🧪 For Developers

If you're developing or testing this integration:

  1. Clone the repository

  2. Set up local testing environment:

    • Use Docker: docker run -d --name ha-test -p 8123:8123 -v /path/to/config:/config ghcr.io/home-assistant/home-assistant:stable
    • Copy custom_components/rointe to your HA's custom_components directory
    • Restart Home Assistant and configure the integration
  3. Testing checklist:

    • Configuration flow works with valid credentials
    • All HVAC modes function correctly
    • Temperature setting works within valid ranges
    • WebSocket updates work in real-time
    • Error handling works for network issues

🙏 Credits

  • Reverse-engineering of Rointe Nexa web app & API by community members.
  • Built with ❤️ for Home Assistant users.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages