65 KiB
65 KiB
AccessoryInformation (3E)
Required Identification Information. For each Accessory in a HomeSpan device this must be included as the first Service.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| Identify | 14 | bool | PW | 0 | 1 |
| the Home App set this to RUN_ID when it wants the device to run its identification routine |
| FirmwareRevision | 52 | string | PR+EV | - | - | must be in form x[.y[.z]] - informational only | |
| Manufacturer | 20 | string | PR | - | - | any string - informational only | |
| Model | 21 | string | PR | - | - | any string - informational only | |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| SerialNumber | 30 | string | PR | - | - | ||
| HardwareRevision | 53 | string | PR | - | - | must be in form x[.y[.z]] - informational only |
AirPurifier (BB)
Defines a basic Air Purifier with an optional fan. Optional Linked Services: FilterMaintenance, AirQualitySensor, Fan, and Slat
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| Active | B0 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if the Service is active/on |
| CurrentAirPurifierState | A9 | uint8 | PR+EV | 0 | 2 |
| indicates current state of air purification |
| TargetAirPurifierState | A8 | uint8 | PW+PR+EV | 0 | 1 |
| |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| RotationSpeed | 29 | float | PR+PW+EV | 0 | 100 | ||
| SwingMode | B6 | uint8 | PR+EV+PW | 0 | 1 |
| |
| LockPhysicalControls | A7 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if local control lock is enabled |
AirQualitySensor (8D)
Defines an Air Quality Sensor.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| AirQuality | 95 | uint8 | PR+EV | 0 | 5 |
| a subjective description |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| OzoneDensity | C3 | float | PR+EV | 0 | 1000 | measured in micrograms/m3 | |
| NitrogenDioxideDensity | C4 | float | PR+EV | 0 | 1000 | measured in micrograms/m3 | |
| SulphurDioxideDensity | C5 | float | PR+EV | 0 | 1000 | ||
| PM25Density | C6 | float | PR+EV | 0 | 1000 | 2.5-micron particulate density, measured in micrograms/m3 | |
| PM10Density | C7 | float | PR+EV | 0 | 1000 | 10-micron particulate density, measured in micrograms/m3 | |
| VOCDensity | C8 | float | PR+EV | 0 | 1000 | ||
| StatusActive | 75 | bool | PR+EV | 0 | 1 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
|
BatteryService (96)
Defines a standalone Battery Service.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| BatteryLevel | 68 | uint8 | PR+EV | 0 | 100 | measured as a percentage | |
| ChargingState | 8F | uint8 | PR+EV | 0 | 2 |
| indicates state of battery charging |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
| |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing |
CarbonDioxideSensor (97)
Defines a Carbon Dioxide Sensor.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| CarbonDioxideDetected | 92 | uint8 | PR+EV | 0 | 1 |
| indicates if abnormal level is detected |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| StatusActive | 75 | bool | PR+EV | 0 | 1 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
| |
| CarbonDioxideLevel | 93 | float | PR+EV | 0 | 100000 | measured on parts per million (ppm) | |
| CarbonDioxidePeakLevel | 94 | float | PR+EV | 0 | 100000 | measured in parts per million (ppm) |
CarbonMonoxideSensor (7F)
Defines a Carbon Monoxide Sensor.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| CarbonMonoxideDetected | 69 | uint8 | PR+EV | 0 | 1 |
| indicates if abnormal level is detected |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| StatusActive | 75 | bool | PR+EV | 0 | 1 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
| |
| CarbonMonoxideLevel | 90 | float | PR+EV | 0 | 100 | measured in parts per million (ppm) | |
| CarbonMonoxidePeakLevel | 91 | float | PR+EV | 0 | 100 | measured in parts per million (ppm) |
ContactSensor (80)
Defines a Contact Sensor.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| ContactSensorState | 6A | uint8 | PR+EV | 0 | 1 |
| indictates if contact is detected (i.e. closed) |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| StatusActive | 75 | bool | PR+EV | 0 | 1 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
|
Door (81)
Defines a motorized Door.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| CurrentPosition | 6D | uint8 | PR+EV | 0 | 100 | current position (as a percentage) from fully closed (0) to full open (100) | |
| TargetPosition | 7C | uint8 | PW+PR+EV | 0 | 100 | ||
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| ObstructionDetected | 24 | bool | PR+EV | 0 | 1 |
| indicates if obstruction is detected |
Doorbell (121)
Defines a Doorbell. Can be used on a standalone basis or in conjunction with a LockMechanism Service.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| ProgrammableSwitchEvent | 73 | uint8 | PR+EV+NV | 0 | 2 |
| |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing |
Fan (B7)
Defines a Fan. Can be used in conjunction with a LightBulb Service to create a Lighted Ceiling Fan.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| Active | B0 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if the Service is active/on |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| CurrentFanState | AF | uint8 | PR+EV | 0 | 2 |
| indicates current state of a fan |
| TargetFanState | BF | uint8 | PW+PR+EV | 0 | 1 |
| |
| RotationDirection | 28 | int | PR+PW+EV | 0 | 1 |
| |
| RotationSpeed | 29 | float | PR+PW+EV | 0 | 100 | ||
| SwingMode | B6 | uint8 | PR+EV+PW | 0 | 1 |
| |
| LockPhysicalControls | A7 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if local control lock is enabled |
Faucet (D7)
Defines the master control for a multi-Valve appliance. Linked Services: Valve (at least one required), and HeaterCooler (optional).
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| Active | B0 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if the Service is active/on |
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing |
FilterMaintenance (BA)
Defines a Filter Maintainence check.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| FilterChangeIndication | AC | uint8 | PR+EV | 0 | 1 |
| indicates state of filter |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| FilterLifeLevel | AB | float | PR+EV | 0 | 100 | measures as a percentage of remaining life | |
| ResetFilterIndication | AD | uint8 | PW | 1 | 1 |
GarageDoorOpener (41)
Defines a motorized Garage Door Opener.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| CurrentDoorState | E | uint8 | PR+EV | 0 | 4 |
| indicates current state of a door |
| TargetDoorState | 32 | uint8 | PW+PR+EV | 0 | 1 |
| |
| ObstructionDetected | 24 | bool | PR+EV | 0 | 1 |
| indicates if obstruction is detected |
| LockCurrentState | 1D | uint8 | PR+EV | 0 | 3 |
| indictates state of a lock |
| LockTargetState | 1E | uint8 | PW+PR+EV | 0 | 1 |
| indicates desired state of lock |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| Version | 37 | string | PR | - | - |
HeaterCooler (BC)
Defines a standalone Heater, Cooler, or combined Heater/Cooler. Can be used with a separate Fan Service and/or Slat Service to extend functionality.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| Active | B0 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if the Service is active/on |
| CurrentTemperature | 11 | float | PR+EV | 0 | 100 | current temperature measured in Celsius | |
| CurrentHeaterCoolerState | B1 | uint8 | PR+EV | 0 | 3 |
| indicates whether appliance is currently heating, cooling, idle, or off |
| TargetHeaterCoolerState | B2 | uint8 | PW+PR+EV | 0 | 2 |
| |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| RotationSpeed | 29 | float | PR+PW+EV | 0 | 100 | ||
| TemperatureDisplayUnits | 36 | uint8 | PW+PR+EV | 0 | 1 |
| |
| SwingMode | B6 | uint8 | PR+EV+PW | 0 | 1 |
| |
| CoolingThresholdTemperature | D | float | PR+PW+EV | 10 | 35 | cooling turns on when temperature (in Celsius) rises above this threshold | |
| HeatingThresholdTemperature | 12 | float | PR+PW+EV | 0 | 25 | heating turns on when temperature (in Celsius) falls below this threshold | |
| LockPhysicalControls | A7 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if local control lock is enabled |
HumidifierDehumidifier (BD)
Defines a Humidifer, Dehumidifier, or combined Humidifer/Dehumidifier. Can be used with a separate Fan Service and/or Slat Service to extend functionality.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| Active | B0 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if the Service is active/on |
| CurrentRelativeHumidity | 10 | float | PR+EV | 0 | 100 | current humidity measured as a percentage | |
| CurrentHumidifierDehumidifierState | B3 | uint8 | PR+EV | 0 | 3 |
| indicates current state of humidifier/dehumidifer |
| TargetHumidifierDehumidifierState | B4 | uint8 | PW+PR+EV | 0 | 2 |
| |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| RelativeHumidityDehumidifierThreshold | C9 | float | PR+PW+EV | 0 | 100 | ||
| RelativeHumidityHumidifierThreshold | CA | float | PR+PW+EV | 0 | 100 | ||
| RotationSpeed | 29 | float | PR+PW+EV | 0 | 100 | ||
| SwingMode | B6 | uint8 | PR+EV+PW | 0 | 1 |
| |
| WaterLevel | B5 | float | PR+EV | 0 | 100 | ||
| LockPhysicalControls | A7 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if local control lock is enabled |
HumiditySensor (82)
Defines a Humidity Sensor.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| CurrentRelativeHumidity | 10 | float | PR+EV | 0 | 100 | current humidity measured as a percentage | |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| StatusActive | 75 | bool | PR+EV | 0 | 1 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
|
InputSource (D9)
Defines an Input Source for a TV. Use only as a Linked Service for the Television Service.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| ConfiguredName | E3 | string | PW+PR+EV | - | - | ||
| IsConfigured | D6 | uint8 | PR+EV | 0 | 1 |
| indicates if a predefined Service has been configured |
| Identifier | E6 | uint32 | PR | 0 | 255 | ||
| CurrentVisibilityState | 135 | uint8 | PR+EV | 0 | 1 | ||
| TargetVisibilityState | 134 | uint8 | PW+PR+EV | 0 | 1 |
IrrigationSystem (CF)
Defines an Irrigation System. Linked Services: Valve Service (at least one required).
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| Active | B0 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if the Service is active/on |
| ProgramMode | D1 | uint8 | PR+EV | 0 | 2 |
| |
| InUse | D2 | uint8 | PR+EV | 0 | 1 |
| if Service is set to active, this indictes whether it is currently in use |
| RemainingDuration | D4 | uint32 | PR+EV | 0 | 3600 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
|
LeakSensor (83)
Defines a Leak Sensor.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| LeakDetected | 70 | uint8 | PR+EV | 0 | 1 |
| indictates if a leak is detected |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| StatusActive | 75 | bool | PR+EV | 0 | 1 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
|
LightBulb (43)
Defines any type of Light.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| On | 25 | bool | PR+PW+EV | 0 | 1 |
| indicates if the Service is active/on |
| Brightness | 8 | int | PR+PW+EV | 0 | 100 | measured as a percentage | |
| Hue | 13 | float | PR+PW+EV | 0 | 360 | color (in degrees) from red (0) to green (120) to blue (240) and back to red (360) | |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| Saturation | 2F | float | PR+PW+EV | 0 | 100 | ||
| ColorTemperature | CE | uint32 | PR+PW+EV | 140 | 500 | measured in inverse megaKelvin (= 1,000,000 / Kelvin) |
LightSensor (84)
Defines a Light Sensor.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| CurrentAmbientLightLevel | 6B | float | PR+EV | 0.0001 | 100000 | measured in Lux (lumens/m2 | |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| StatusActive | 75 | bool | PR+EV | 0 | 1 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
|
LockMechanism (45)
Defines an electronic Lock.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| LockCurrentState | 1D | uint8 | PR+EV | 0 | 3 |
| indictates state of a lock |
| LockTargetState | 1E | uint8 | PW+PR+EV | 0 | 1 |
| indicates desired state of lock |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| Mute | 11A | bool | PW+PR+EV | 0 | 1 |
| not used |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| Volume | 119 | uint8 | PW+PR+EV | 0 | 100 |
MotionSensor (85)
Defines a Motion Sensor.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| MotionDetected | 22 | bool | PR+EV | 0 | 1 |
| indicates if motion is detected |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| StatusActive | 75 | bool | PR+EV | 0 | 1 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
|
OccupancySensor (86)
Defines and Occupancy Sensor.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| OccupancyDetected | 71 | uint8 | PR+EV | 0 | 1 |
| indicates if occupanccy is detected |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| StatusActive | 75 | bool | PR+EV | 0 | 1 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
|
Outlet (47)
Defines an controllable Outlet used to power any light or appliance.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| On | 25 | bool | PR+PW+EV | 0 | 1 |
| indicates if the Service is active/on |
| OutletInUse | 26 | bool | PR+EV | 0 | 1 |
| indicates if an appliance or light is plugged into the outlet, regardless of whether on or off |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing |
SecuritySystem (7E)
Defines a Security System.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| SecuritySystemCurrentState | 66 | uint8 | PR+EV | 0 | 4 |
| |
| SecuritySystemTargetState | 67 | uint8 | PW+PR+EV | 0 | 3 |
| |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| SecuritySystemAlarmType | 8E | uint8 | PR+EV | 0 | 1 |
| |
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| ServiceLabelNamespace | CD | uint8 | PR | 0 | 1 |
|
Slat (B9)
Defines a motorized ventilation Slat(s).
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| CurrentSlatState | AA | uint8 | PR+EV | 0 | 2 |
| indicates current state of slats |
| SlatType | C0 | uint8 | PR | 0 | 1 |
| |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| SwingMode | B6 | uint8 | PR+EV+PW | 0 | 1 |
| |
| CurrentTiltAngle | C1 | int | PR+EV | -90 | 90 | angle (in degrees) of slats from fully up or left (-90) to fully open (0) to fully down or right (90) | |
| TargetTiltAngle | C2 | int | PW+PR+EV | -90 | 90 |
SmokeSensor (87)
Defines a Smoke Sensor.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| SmokeDetected | 76 | uint8 | PR+EV | 0 | 1 |
| |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| StatusActive | 75 | bool | PR+EV | 0 | 1 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
| |
| Mute | 11A | bool | PW+PR+EV | 0 | 1 |
| not used |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| Volume | 119 | uint8 | PW+PR+EV | 0 | 100 |
StatelessProgrammableSwitch (89)
Defines a "Stateless" Programmable Switch that can be used to trigger actions in the Home App.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| ProgrammableSwitchEvent | 73 | uint8 | PR+EV+NV | 0 | 2 |
| |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing |
Switch (49)
Defines a generic Switch.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| On | 25 | bool | PR+PW+EV | 0 | 1 |
| indicates if the Service is active/on |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing |
Television (D8)
Defines a TV. Optional Linked Services: InputSource and TelevisionSpeaker.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| Active | B0 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if the Service is active/on |
| ConfiguredName | E3 | string | PW+PR+EV | - | - | ||
| ActiveIdentifier | E7 | uint32 | PW+PR+EV | 0 | 255 | the Identifier of the current Input Source | |
| RemoteKey | E1 | uint8 | PW | 0 | 16 | ||
| PowerModeSelection | DF | uint8 | PW | 0 | 1 |
TelevisionSpeaker (113)
Defines a Television Speaker that can be controlled via the Remote Control widget on an iPhone. Use only as a Linked Service for the Television Service.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| VolumeControlType | E9 | uint8 | PR+EV | 0 | 3 | ||
| VolumeSelector | EA | uint8 | PW | 0 | 1 |
TemperatureSensor (8A)
Defines a Temperature Sensor.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| CurrentTemperature | 11 | float | PR+EV | 0 | 100 | current temperature measured in Celsius | |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| StatusActive | 75 | bool | PR+EV | 0 | 1 | ||
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| StatusTampered | 7A | uint8 | PR+EV | 0 | 1 |
| |
| StatusLowBattery | 79 | uint8 | PR+EV | 0 | 1 |
|
Thermostat (4A)
Defines a Thermostat used to control a furnace, air conditioner, or both.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| CurrentHeatingCoolingState | F | uint8 | PR+EV | 0 | 2 |
| indicates whether appliance is currently heating, cooling, or just idle |
| TargetHeatingCoolingState | 33 | uint8 | PW+PR+EV | 0 | 3 |
| |
| CurrentTemperature | 11 | float | PR+EV | 0 | 100 | current temperature measured in Celsius | |
| TargetTemperature | 35 | float | PW+PR+EV | 10 | 38 | ||
| TemperatureDisplayUnits | 36 | uint8 | PW+PR+EV | 0 | 1 |
| |
| CoolingThresholdTemperature | D | float | PR+PW+EV | 10 | 35 | cooling turns on when temperature (in Celsius) rises above this threshold | |
| CurrentRelativeHumidity | 10 | float | PR+EV | 0 | 100 | current humidity measured as a percentage | |
| HeatingThresholdTemperature | 12 | float | PR+PW+EV | 0 | 25 | heating turns on when temperature (in Celsius) falls below this threshold | |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| TargetRelativeHumidity | 34 | float | PW+PR+EV | 0 | 100 |
Valve (D0)
Defines an electronic Valve. Can be used standalone or as a Linked Service in conjunction with the Faucet and IrrigationSystem Services.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| Active | B0 | uint8 | PW+PR+EV | 0 | 1 |
| indicates if the Service is active/on |
| InUse | D2 | uint8 | PR+EV | 0 | 1 |
| if Service is set to active, this indictes whether it is currently in use |
| ValveType | D5 | uint8 | PR+EV | 0 | 3 | ||
| SetDuration | D3 | uint32 | PW+PR+EV | 0 | 3600 | ||
| RemainingDuration | D4 | uint32 | PR+EV | 0 | 3600 | ||
| IsConfigured | D6 | uint8 | PR+EV | 0 | 1 |
| indicates if a predefined Service has been configured |
| StatusFault | 77 | uint8 | PR+EV | 0 | 1 |
| |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing |
Window (8B)
Defines a motorized Window.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| CurrentPosition | 6D | uint8 | PR+EV | 0 | 100 | current position (as a percentage) from fully closed (0) to full open (100) | |
| TargetPosition | 7C | uint8 | PW+PR+EV | 0 | 100 | ||
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| ObstructionDetected | 24 | bool | PR+EV | 0 | 1 |
| indicates if obstruction is detected |
WindowCovering (8C)
Defines a motorized Window Shade, Screen, Awning, etc.
| Characteristic | UUID | Format | Perms | Min | Max | Constants | Notes |
|---|---|---|---|---|---|---|---|
| TargetPosition | 7C | uint8 | PW+PR+EV | 0 | 100 | ||
| CurrentPosition | 6D | uint8 | PR+EV | 0 | 100 | current position (as a percentage) from fully closed (0) to full open (100) | |
| Name | 23 | string | PR | - | - | default name of a Service used only during initial pairing | |
| CurrentHorizontalTiltAngle | 6C | int | PR+EV | -90 | 90 | current angle (in degrees) of slats from fully up (-90) to fully open (0) to fully down (90) | |
| TargetHorizontalTiltAngle | 7B | int | PW+PR+EV | -90 | 90 | ||
| CurrentVerticalTiltAngle | 6E | int | PR+EV | -90 | 90 | current angle (in degrees) of slats from fully left (-90) to fully open (0) to fully right (90) | |
| TargetVerticalTiltAngle | 7D | int | PW+PR+EV | -90 | 90 | ||
| ObstructionDetected | 24 | bool | PR+EV | 0 | 1 |
| indicates if obstruction is detected |