5.0 KiB
5.0 KiB
HomeSpan Services
The following tables list the HomeKit Services and Characteristics supported by HomeSpan. In general, HomeSpan implements all HomeKit Services described in Apple's HomeKit Accessory Protocol Specification (HAP) Release R2, except for those that involve video or audio streaming, Apple TV, or advanced lock management (i.e. all HAP Services except those that require Characteristics with a TLV8 data type).
Service List
| Service | Required Characteristics | Optional Characteristics |
|---|---|---|
| AccessoryInformation | FirmwareRevision Identity Manufacturer Model Name SerialNumber |
HardwareRevision |
| AirPurifier | Active CurrentAirPurifierState TargetAirPurifierState |
Name RotationSpeed SwingMode LockPhysicalControls |
| AirQualitySensor | AirQuality | Name OzoneDensity NitrogenDioxideDensity SulphurDioxideDensity PM25Density PM10Density VOCDensity StatusActive StatusFault StatusTampered StatusLowBattery |
| BatteryService | BatteryLevel ChargingState StatusLowBattery |
Name |
| CarbonDioxideSensor | CarbonDioxideDetected | Name StatusActive StatusFault StatusTampered StatusLowBattery CarbonDioxideLevel CarbonDioxidePeakLevel |
| CarbonMonoxideSensor | CarbonMonoxideDetected | Name StatusActive StatusFault StatusTampered StatusLowBattery CarbonMonoxideLevel CarbonMonoxidePeakLevel |
| ContactSensor | ContactSensorState | Name StatusActive StatusFault StatusTampered StatusLowBattery |
| Door | CurrentPosition | TargetPosition PositionState |
| Doorbell | ProgrammableSwitchEvent | Name Volume Brightness |
| Fan | Active | Name CurrentFanState TargetFanState RotationDirection RotationSpeed SwingMode LockPhysicalControls |
| Faucet | Active | StatusFault Name |
| FilterMaintenance | FilterChangeIndication | Name FilterLifeLevel ResetFilterIndication |
| GarageDoorOpener | CurrentDoorState TargetDoorState ObstructionDetected |
LockCurrentState LockTargetState Name |
| HAPProtocolInformation | Version | |
| HeaterCooler | Active CurrentTemperature CurrentHeaterCoolerState TargetHeaterCoolerState |
Name RotationSpeed TemperatureDisplayUnits SwingMode CoolingThresholdTemperature HeatingThresholdTemperature LockPhysicalControls |
| HumidifierDehumidifier | Active CurrentRelativeHumidity CurrentHumidifierDehumidifierState TargetHumidifierDehumidifierState |
Name RelativeHumidityDehumidifierThreshold RelativeHumidityHumidifierThreshold RotationSpeed SwingMode WaterLevel LockPhysicalControls |
| HumiditySensor | CurrentRelativeHumidity | Name StatusActive StatusFault StatusTampered StatusLowBattery |
| IrrigationSystem | Active ProgramMode InUse |
RemainingDuration Name StatusFault |
| LeakSensor | LeakDetected | Name StatusActive StatusFault StatusTampered StatusLowBattery |
| LightBulb | On | Brightness Hue Name Saturation ColorTemperature |
| LightSensor | CurrentAmbientLightLevel | Name StatusActive StatusFault StatusTampered StatusLowBattery |
| LockMechanism | LockCurrentState LockTargetState |
Name |
| Microphone | Mute | Name Volume |
| MotionSensor | MotionDetected | Name StatusActive StatusFault StatusTampered StatusLowBattery |
| OccupancySensor | OccupancyDetected | Name StatusActive StatusFault StatusTampered StatusLowBattery |
| Outlet | On OutletInUse |
Name |
| SecuritySystem | SecuritySystemCurrentState SecuritySystemTargetState |
Name SecuritySystemAlarmType StatusFault StatusTampered |
| ServiceLabel | ServiceLabelNamespace | |
| Slat | CurrentSlatState SlatType |
Name SwingMode CurrentTiltAngle TargetTiltAngle |
| SmokeSensor | SmokeDetected | Name StatusActive StatusFault StatusTampered StatusLowBattery |
| Speaker | Mute | Name Volume |
| StatelessProgrammableSwitch | ProgrammableSwitchEvent | Name ServiceLabelIndex |
| Switch | On | Name |
| TemperatureSensor | CurrentTemperature | Name StatusActive StatusFault StatusTampered StatusLowBattery |
| Thermostat | CurrentHeatingCoolingState TargetHeatingCoolingState CurrentTemperature TargetTemperature TemperatureDisplayUnits |
CoolingThresholdTemperature CurrentRelativeHumidity HeatingThresholdTemperature Name TargetRelativeHumidity |
| Valve | Active InUse ValveType |
SetDuration RemainingDuration IsConfigured ServiceLabelIndex StatusFault Name |
| Window | CurrentPosition TargetPosition PositionState |
Name HoldPosition ObstructionDetected |
| WindowCovering | CurrentPosition TargetPosition PositionState |
Name HoldPosition CurrentHorizontalTiltAngle TargetHorizontalTiltAngle CurrentVerticalTiltAngle TargetVerticalTiltAngle ObstructionDetected |