homebridge-ambiclimate-platform-unified's Introduction

Homebridge Ambi Climate Platform

Inspired by homebridge-ambiclimate. This plugin supports these features for Ambi Climate devices:

Show current temperature
Show current relative humidity
Show current fan state (High, Med, Low as percentage of rotation speed)
Turn on and off - for comfortable mode
Comfortable mode feedbacks

Installation

After Homebridge has been installed:

sudo npm i -g homebridge-ambiclimate-platform@latest

You need to register an OAuth client in the Ambi Dev Portal by following the steps on the Quick Start page. Client ID and client Secret of that OAuth client are required, in order to use this plugin.

Config

Simple config example:

{
    "bridge": {
    ...
    },
    "accessories": [
    ...
    ],
    "platforms": [{
        "platform": "AmbiClimatePlatform",
        "clientId": "00000000-1111-2222-3333-444444444444",
        "clientSecret": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
        "username": "[email protected]",
        "password": "password_here",
        "showFeedbacks": true,
        "accessories": [{
            "roomName": "Living Room",
            "locationName": "Taipei"
        }]
    }
    ]
}

Options

Attributes	Required	Usage	Default	Options
clientId	YES	OAuth client Id
clientSecret	YES	OAuth client secret
username	YES	Your Ambi Climate account username
password	YES	Your Ambi Climate account password
showFeedbacks		Show feedback options as switches. (Too Hot, Too Warm, Bit Warm, Comfortable, Bit Cold, Too Cold and Freezing)	false	true/false
heaterCoolerMode		Add device as heater cooler (air condition). Notice: This would set Ambi Climate to temperature mode instead of comfort mode. Also, due to limitations of Ambi Climate APIs (which doesn't allow set to heat/cool mode manually), the status it shows may be different from your settings.	false	true/false
accessories.roomName	YES	Device room name, must match the name within the Ambi Climate App
accessories.locationName	YES	Device location name, must match the name within the Ambi Climate App

Recommend Projects