Skip to content

HomeKit Glossary of Terms

Raoul edited this page Jun 29, 2017 · 2 revisions

This page serves to explain some of the HomeKit terminology to the uninitiated.

Bridge

A bridge is a network component that allows access to and from a set of accessories from and to homekit. For this project, homebridge is the only bridge, as in homekit topology bridges must not be bridged, and cannot be cascaded. So homebridge connects our non-homekit-enabled accessories to the homekit world through plugins. A bridge can bridge up to 99 accessories.

Plugin

A homebridge Plugin is a set of code that publishes Accessories and/or a Platform. Plugins are written specifically to interact with third party devices that have their own unique APIs but are not natively HomeKit compatible.

Platform

A Platform represents a set of Accessories. For example, the Nest Platform provides homebridge access to all the Nest Accessories (Nest Thermostats & Nest Smoke Detectors) installed in a home. By configuring the Nest platform in homebridge, all the Nest Accessories will be made available.

Accessory

An Accessory is a hardware device that can be controlled or can provide information. A garage door opener, light, door lock, thermostat, television, etc are all examples of individual accessories. Accessories can have multiple services (99 max), so the garage door opener box might have e.g.: the garage door opener service, a lightbulb service (built in ceiling light), a battery service (if it runs on batteries and needs to show the charging state), etc.

Service

A service is a prime homekit functionality, such as a lightbulb. Each service can have multiple characteristics, such as On, Brightness and others for lightbulbs.
Siri uses the service's name for reference, not the accessory name!

Characteristic

A Characteristic is an attribute or property of a service, such as temperature, on/off state, color, etc.

Room

A Room is a collection of (physical) accessories. The purpose of grouping Accessories into a room is so that you can control them all at once. Suppose your Living Room has three light Accessories in it:

  1. Wall Sconces
  2. End Table Lamps
  3. Recessed lights

On their own, you have to tell Siri to turn each indivdual light off... e.g. "Siri, turn the Wall Sconces off", "Siri turn the End Table Lamps off" and so on.

However if you add all three of these Accessories to a Room called "Living Room", you can then control all of them with a single command: "Siri turn the Living Room off"

Zone

A "Zone" is a collection of rooms.

Example Zone: Upstairs which contains rooms Guest Bedroom, Guest Bathroom, Bonus Room, Kids Room
In this setup, you can tell Siri to switch off all lights upstairs.

Scene

A scene is a collection of accessories and their desired states. You could create a scene called "Movie Time" which sets the living room lights to 33% brightness, TV to ON & Stereo to ON.

Another scene example could be "Leaving Home" which sets every Accessory to "Off".

Trigger

"Triggers set scenes at specific times, when you get to locations or when a characteristic is in a specific state. -Apple" In other words, a trigger is a set of user definable conditions and/or events which must be met which results in the automatic execution of a Scene.

Example: Every time you come home from work, you have a routine of turning on specific lights in your house. However, the exact time in which you come home varies some and you really only perform this routine in the winter when the sun is set before you get home from work.

A location based trigger with time conditions could be setup to automate this task. Create a scene called "welcome home" which has the desired set of the lights with their "on" levels set, then create a location trigger with condition of "after sunset".

You can’t perform that action at this time.