HomeSpan/docs/Categories.md

1.4 KiB

HomeSpan Accessory Categories

Every HomeSpan device must be assigned a HomeKit Accessory Category. HomeSpan implements these categories as C++ Classes with names that exactly match the spelling and capitalization specified by Apple in Section 13 of HAP-R2, but without any spaces. HomeSpan Accessory Categories are defined in HomeSpan's Category namespace. For example, HomeSpan defines the Garage Door Openers Category (HAP Category 4) as Category::GarageDoorOpeners, which could be used when initializing HomeSpan as follows:

homeSpan.begin(Category::GarageDoorOpeners,"Acme Garage Door Lifts");

The table below provides a list of all HomeSpan Categories.

Note that the HomeKit primarily uses the Accessory Category of a device for determining the icon to show in the Home App when a device is being paired. Apart from this purely cosmetic function, the Category assigned to a device does not in any way limit which Services or Characteristics can be implemented on that device.

HomeSpan Categories

  • AirConditioners *
  • AirPurifiers *
  • Bridges *
  • Dehumidifiers *
  • Doors *
  • Fans *
  • Faucets *
  • Lighting *
  • Locks *
  • GarageDoorOpeners *
  • Heaters *
  • Humidifiers *
  • IPCameras *
  • Other *
  • Outlets *
  • ProgrammableSwitches *
  • SecuritySystems *
  • Sensors *
  • ShowerSystems *
  • Sprinklers *
  • Switches *
  • Thermostats *
  • VideoDoorbells *
  • Windows *
  • WindowCoverings *