homebridge-smartcielo's Introduction

NodeJs interface for smartcielo remote AC control API (MRCOOL)

by Nicholas Robinson

Smartcielo (MRCOOL) plug-in for Homebridge using node-smartcielo.

Integrate your MRCOOL AC into your HomeKit system.

Forked from: https://github.com/X1ZOR/homebridge-dummy-thermostat

With inspiration from: https://github.com/chrisjshull/homebridge-nest

Installation

Install homebridge using: npm install -g homebridge
Install this plug-in using: npm install -g homebridge-smartcielo
Update your configuration file. See example config.json snippet below.

Configuration

Configuration sample (edit ~/.homebridge/config.json):

"accessories": [
     {
       "accessory": "SmartCieloThermostat",
       "name": "SmartCielo",
       "username": "<SMARTCIELO_USERNAME>",
       "password": "<SMARTCIELO_PASSWORD>",
       "ip": "<PUBLIC_IP_ADDRESS>",
     }
]

Structure

Key	Description
`accessory`	Must be `SmartCielo`
`name`	Name to appear in the Home app
`username`	smartcielo.com username
`password`	smartcielo.com password
`ip`	public ip address where ac resides
`temperatureDisplayUnits` (optional)	Whether you want °C (`0`) or °F (`1`) as your units (`1` is default)
`model` (optional)	Appears under "Model" for your accessory in the Home app
`manufacturer` (optional)	Appears under "Manufacturer" for your accessory in the Home app

Things to try with Siri

Hey Siri, set the temperature to 72 degrees. (in heat-only or cool-only mode)
Hey Siri, set the temperature range to between 65 and 70 degrees. (in auto mode, for systems that can heat and cool)
Hey Siri, set the thermostat to cool. (try heat, cool, auto, or off)
Hey Siri, turn on the air conditioning.
Hey Siri, what's the temperature at home?
Hey Siri, what's the temperature in the Basement? (get the temperature from a Nest Temperature Sensor)