Skip to content

README.md

Latest commit

 

History

History
119 lines (94 loc) · 4.12 KB

README.md

File metadata and controls

119 lines (94 loc) · 4.12 KB

hb x vav

homebridge-otodo-vav

npm version npm downloads License verified-by-homebridge

A Homebridge plugin to integrate OTO Do VAV thermostats into HomeKit

📝 Description

This plugin allows you to connect your OTO Do VAV thermostat to HomeKit via Homebridge.
You will be able to view and control the thermostat from the Apple Home app and use Siri voice commands.

✨ Features

  • Exposes your OTO Do VAV thermostat as a native Apple Home accessory.
  • Read and control:
    • Current temperature
    • Target temperature
    • Heating/Cooling mode (if your device supports it)
  • Automatic state synchronization between HomeKit and your device.
  • Lightweight and easy to configure.
  • Compatible with Homebridge v1 and v2.

🔧✨ Optional Feature: Mode Sliders

The plugin can optionally create a Mode Slider accessory for each thermostat. This slider allows you to change the Otodo/VAV mode by selecting one of six predefined positions.

Available modes

Slider Position WorkingMode Mode Name (Otodo) Description
0% 0 Auto Follows weekly schedule
20% 1 Confort Comfort temperature
40% 2 -1°C Comfort –1°C
60% 3 -2°C Comfort –2°C
80% 4 Eco Energy saving mode
100% 5 Antigel Frost protection

The slider automatically snaps to the closest valid value.

Enable or disable Mode Sliders

You can control whether these mode sliders appear in HomeKit using the following configuration option:

"displayModeSliders": true
  • "displayModeSliders": true → Each thermostat gets a “Mode” slider accessory
  • "displayModeSliders": false → Mode sliders are removed and hidden

Thermostat accessories continue to work normally either way.

📦 Installation

Install globally using npm on your Homebridge server:

sudo npm install -g homebridge-otodo-vav

⚙️ Configuration

Add a new platform entry in your config.json:

{
  "platforms": [
    {
      "platform": "otodo-vav",
      "name": "My OTO Do Thermostat",
      "host": "192.168.1.100",
      "pollInterval": 60
    }
  ]
}

Options

Key Type Required Description
platform string ✅ Must be "otodo-vav"
name string ✅ Display name in HomeKit
host string ✅ Device IP / hostname
pollInterval number ❌ Polling interval in seconds (default: 60)

🚀 Usage

  1. Install plugin
  2. Add configuration to config.json
  3. Restart Homebridge
  4. The thermostat appears in the Apple Home app
  5. Control it using:
    • Home app
    • Siri voice commands
    • Automations and scenes

🧑‍💻 Development

git clone https://github.com/Surfysamy/homebridge-otodo-vav.git
cd homebridge-otodo-vav
npm install
npm run build
npm link
homebridge -D

❤️ Contributing

Contributions are welcome !

  • Open an issue for bugs or feature requests
  • Submit pull requests for improvements
  • Star the repository if you like the plugin ⭐
⚡