homebridge-homeconnect

Installation using Command Line

1. Install this plugin using: npm install -g homebridge-homeconnect
2. Edit config.json and add the HomeConnect platform (see example below).
3. Run (or restart) Homebridge.
4. The Homebridge log output will include an authorisation URL. Copy the listed URL into a web browser, login to your Home Connect account, and approve access.

Example config.json

{
    "platforms":
    [{
        "platform":     "HomeConnect",
        "clientid":     "0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF"
    }]
}

The clientid should be set to the Client ID obtained from the Home Connect Developer Program for the created Device Flow application.

• CoffeeMaker:

  • Switch on/off, start/stop programs with preset options, and turn cup warmer on/off.
  • Control child lock.
  • Monitor door, program time remaining, remote control, and general operation status.
  • Automation triggers for bean container empty, water tank empty, drip tray full, milk requires cooling, and for when cleaning/descaling is needed.

• CookProcessor:

  • Switch on/off.
  • Monitor program time remaining and general operation status.
  • Automation triggers for finished and aborted.

• Hob:

  • Control alarm clock, child lock, and integrated ventilation.
  • Monitor power, remote control, and general operation status.
  • Automation triggers for finished, alarm clock finished, preheat finished, and short/long press favourite actions.

• Hood:

  • Switch on/off.
  • Switch fan on/off, set fan speed/intensive levels, select boost mode, and select manual/auto mode.
  • Switch functional light on/off, change brightness, and select colour temperature.
  • Switch ambient light on/off, change brightness, and select colour.
  • Monitor remote control and general operation status.
  • Automation triggers for finished, grease filter nearly saturated, grease filter saturated, and short/long press favourite actions.

• Microwave:

  • Switch on/off and start/stop programs with preset options.
  • Open or partly open the door.
  • Control child lock.
  • Monitor door, programs, program time remaining, remote control, and general operation status.
  • Automation triggers for finished, and aborted.

• Oven:

  • Switch on/off and start/stop programs with preset options.
  • Open or partly open the door.
  • Set sabbath mode.
  • Control alarm clock and child lock.
  • Monitor door, programs, program time remaining, remote control, and general operation status.
  • Automation triggers for finished, aborted, alarm clock finished, fast preheat finished, and regular preheat finished.

• WarmingDrawer:

  • Switch on/off and start/stop programs with preset options.
  • Control child lock.
  • Monitor remote control and general operation status.

• CleaningRobot:

  • Switch on/off and start/stop programs with preset options.
  • Monitor battery level, battery charging, dock, and general operation status.
  • Automation triggers for finished, aborted, dust box full/missing, stuck, lost, and lifted.

• Dishwasher:

  • Switch on/off and start/stop programs with preset options.
  • Switch ambient light on/off, change brightness, and select colour.
  • Control child lock.
  • Monitor door, program time remaining, remote control, and general operation status.
  • Automation triggers for finished, aborted, salt supply low/empty, rinse aid supply low/empty, and machine care and/or filter cleaning recommended.

• Dryer:

  • Start/stop programs with preset options.
  • Control child lock.
  • Monitor power, door, program time remaining, remote control, and general operation status.
  • Automation triggers for finished, aborted, and drying finished.

• Washer:

  • Start/stop programs with preset options.
  • Control child lock.
  • Monitor power, door, program time remaining, remote control, and general operation status.
  • Automation triggers for finished, aborted, i-Dos 1 fill level low, and i-Dos 2 fill level low.

• WasherDryer:

  • Start/stop programs with preset options.
  • Control child lock.
  • Monitor power, door, program time remaining, remote control, and general operation status.
  • Automation triggers for finished, aborted, i-Dos 1 fill level low, i-Dos 2 fill level low, and drying finished.

• AirConditioner:

  • Switch on/off.
  • Select auto/cool/heat/off mode, set setpoint temperature, switch fan on/off, set fan speed, and select fan manual/auto mode.

• Freezer / FridgeFreezer / Refrigerator:

  • Set freezer/refrigerator super, eco, sabbath, refrigerator vacation, refrigerator fresh, and ice dispenser modes.
  • Switch interior/exterior light on/off and change brightness.
  • Open the door.
  • Control child lock.
  • Monitor power and door.
  • Automation triggers for freezer/refrigerator door and freezer temperature alarms.

• WineCooler:

  • Set sabbath mode.
  • Control child lock.
  • Monitor power and door.

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.