homebridge-rotex-control

Homebridge plugin for ROTEX/Daikin HPSU heat pumps using the RoCon G1 gateway via the daikin-control.com cloud API.

Control your ROTEX HPSU Compact heat pump directly from Apple HomeKit — including Siri voice commands!

Features

| HomeKit Accessory | Description | |---|---| | 🌡️ HeaterCooler | Main thermostat — switch between Heating, Cooling, Summer (Auto), and Standby | | 💧 DHW Tank Sensor | Current domestic hot water (ACS) temperature | | 🌤️ Outside Temp Sensor | Outdoor temperature reading | | 🔥 Boiler Temp Sensor | Flow/boiler temperature | | ⚡ DHW Boost Switch | One-time hot water heatup (cEINMAL_WW_AKTIV) — perfect for solar excess automation! |

Compatible Hardware

• ROTEX HPSU Compact (308, 508, 516 H/C)
• Daikin Altherma (with RoCon G1 gateway)
• Any system connected via daikin-control.com cloud portal

Note: This plugin uses the daikin-control.com API (used by the official DAIKIN Control app). It does NOT use the newer ONECTA API which requires a BRP069A78 gateway.

Installation

Via Homebridge UI (Recommended)

Search for homebridge-rotex-control in the Homebridge UI plugin search.

Via CLI

npm install -g homebridge-rotex-control

Configuration

Via Homebridge UI

The plugin provides a config UI form. Simply fill in your credentials.

Manual Configuration

Add the following to your Homebridge config.json:

{
  "platforms": [
    {
      "platform": "RotexControl",
      "name": "ROTEX HPSU",
      "username": "your_daikin_control_username",
      "password": "your_daikin_control_password",
      "heatingCircuitId": 16443,
      "pollingInterval": 60
    }
  ]
}

Configuration Options

| Option | Required | Default | Description | |---|---|---|---| | platform | ✅ | — | Must be "RotexControl" | | name | ✅ | "ROTEX HPSU" | Display name in HomeKit | | username | ✅ | — | Your daikin-control.com username | | password | ✅ | — | Your daikin-control.com password | | heatingCircuitId | ❌ | 16443 | Heating circuit ID from the API | | pollingInterval | ❌ | 60 | Status polling interval in seconds (30–600) |

Finding Your Heating Circuit ID

1. Log into daikin-control.com
2. Open your browser's Developer Tools (F12) → Network tab
3. Navigate to your installation
4. Look for API calls to /mobile/heatingcircuit/XXXXX — the number is your ID

For most single-installation setups, the default 16443 should work.

Operation Modes

The HeaterCooler accessory maps ROTEX modes to HomeKit states:

| HomeKit State | ROTEX Mode | API Value | Description | |---|---|---|---| | Off | Standby | 1 | System standby | | Heat | Heating | 3 | Active heating + DHW | | Cool | Cooling | 17 | Active cooling | | Auto | Summer | 5 | DHW only (summer mode) |

Solar Excess Automation

The DHW Boost Switch is perfect for automating hot water heating with solar excess:

With HomeKit Automations

Create a HomeKit automation that turns on the DHW Boost switch when your solar inverter reports excess power.

With Node-RED / n8n

Use the Homebridge API or directly call the ROTEX API to activate one-time heatup when solar production exceeds consumption.

Example: Siri Commands

• "Hey Siri, turn on DHW Boost" → Activates one-time hot water heating
• "Hey Siri, set ROTEX to heating" → Switches to heating mode
• "Hey Siri, what's the outside temperature?" → Reads outdoor sensor

Development

# Clone the repo
git clone https://github.com/trama2000/homebridge-rotex-control.git
cd homebridge-rotex-control

# Install dependencies
npm install

# Build
npm run build

# Link for local testing
npm link

API Reference

This plugin communicates with the ROTEX cloud API:

• Base URL: https://api.rotex-control.com
• Auth: Session-based (POST /login)
• Heating Circuit: GET/PUT /mobile/heatingcircuit/{id}
• Parameters: Operation mode, temperatures, one-time heatup activation

Troubleshooting

| Issue | Solution | |---|---| | Login fails | Verify credentials at daikin-control.com | | No data | Check that your gateway (RoCon G1) is online and connected | | Wrong circuit ID | Use Developer Tools to find the correct ID (see above) | | Slow updates | Reduce pollingInterval (minimum 30 seconds) |

License

Apache-2.0

Credits

Developed by reverse-engineering the ROTEX/Daikin Control API for the RoCon G1 gateway.

Special thanks to the Homebridge community.