Skip to content

Commit e9202e2

Browse files
jimtngstefan-hoehn
jimtng
and
stefan-hoehn
authored
Thing XML: Update system state channel types (#2490)
Signed-off-by: Jimmy Tanagra <[email protected]> Co-authored-by: stefan-hoehn <[email protected]>
1 parent 7b513dc commit e9202e2

File tree

1 file changed

+28
-27
lines changed

1 file changed

+28
-27
lines changed

‎developers/bindings/thing-xml.md‎

Lines changed: 28 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -144,33 +144,34 @@ The following XML snippet shows a system channel type definition and thing type
144144

145145
There exist system-wide channel types that are available by default and which should be used whenever possible:
146146

147-
| Channel Type ID | Reference typeId | Item Type | Category | Tags | Description |
148-
|-----------------------|------------------------------|--------------------------|------------------|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
149-
| signal-strength | system.signal-strength | Number | QualityOfService | Measurement, Level | Represents signal strength of a device as a Number with values 0, 1, 2, 3 or 4; 0 being worst strength and 4 being best strength. |
150-
| low-battery | system.low-battery | Switch | LowBattery | Alarm, LowBattery | Represents a low battery warning with possible values on (low battery) and off (battery ok). |
151-
| battery-level | system.battery-level | Number | Battery | Measurement, Energy | Represents the battery level as a percentage (0-100%). Bindings for things supporting battery level in a different format (e.g. 4 levels) should convert to a percentage to provide a consistent battery level reading. |
152-
| power | system.power | Switch | Switch | Switch, Power | Turn a device on/off. |
153-
| brightness | system.brightness | Dimmer | Light | Control, Brightness | Brightness of a bulb (0-100%). |
154-
| color | system.color | Color | ColorLight | Control, Color | Color of a bulb. |
155-
| color-temperature | system.color-temperature | Dimmer | ColorLight | Control, ColorTemperature | Color temperature of a bulb (0-100%). 0% should be the coldest setting (highest Kelvin value), 100 the warmest. |
156-
| color-temperature-abs | system.color-temperature-abs | Number | ColorLight | Control, ColorTemperature | Color temperature of a bulb in Kelvin (1000K-10000K). |
157-
| location | system.location | Location | - | Measurement, GeoLocation | Location in lat.,lon.,height coordinates. |
158-
| motion | system.motion | Switch | Motion | Status, Presence | Motion detected by the device (ON if motion is detected). |
159-
| mute | system.mute | Switch | SoundVolume | Switch, SoundVolume | Turn on/off the volume of a device. |
160-
| volume | system.volume | Dimmer | SoundVolume | Control, SoundVolume | Change the sound volume of a device (0-100%). |
161-
| media-control | system.media-control | Player | MediaControl | Control | Control for a media player. |
162-
| media-title | system.media-title | String | - | Status | Title of a (played) media file. |
163-
| media-artist | system.media-artist | String | - | Status | Artist of a (played) media file. |
164-
| outdoor-temperature | system.outdoor-temperature | Number:Temperature | Temperature | Measurement, Temperature | Current outdoor temperature. |
165-
| indoor-temperature | system.indoor-temperature | Number:Temperature | Temperature | Measurement, Temperature | Current indoor temperature. |
166-
| wind-direction | system.wind-direction | Number:Angle | Wind | Measurement, Wind | Wind direction in degrees (0-360°). |
167-
| wind-speed | system.wind-speed | Number:Speed | Wind | Measurement, Wind | Wind speed |
168-
| atmospheric-humidity | system.atmospheric-humidity | Number:Dimensionless | Humidity | Measurement, Humidity | Atmospheric humidity in percent. |
169-
| barometric-pressure | system.barometric-pressure | Number:Pressure | Pressure | Measurement, Pressure | Barometric pressure |
170-
| electric-current | system.electric-current | Number:ElectricCurrent | Energy | Measurement, Current | Electric current |
171-
| electric-power | system.electric-power | Number:Power | Energy | Measurement, Power | Electric power |
172-
| electric-voltage | system.electric-voltage | Number:ElectricPotential | Energy | Measurement, Voltage | Electric voltage |
173-
| electrical-energy | system.electric-energy | Number:Energy | Energy | Measurement, Energy | Electrical energy |
147+
| Channel Type ID | Reference typeId | Item Type | Category | Tags | Description |
148+
|-----------------------|------------------------------|--------------------------|------------------|-----------------------------|--------------------------------------------------------------------------------|
149+
| location | system.location | Location | - | Measurement, GeoLocation | Location in lat./lon./height coordinates |
150+
| uv-index | system.uv-index | Number | - | Measurement, Ultraviolet | Current UV index |
151+
| media-artist | system.media-artist | String | - | Status, Info | Artist of a (played) media file |
152+
| media-title | system.media-title | String | - | Status, Info | Title of a (played) media file |
153+
| battery-level | system.battery-level | Number | Battery | Measurement, Energy | Battery level as a percentage (0-100%) |
154+
| color | system.color | Color | ColorLight | Control, Color | Controls the color of the light |
155+
| color-temperature | system.color-temperature | Dimmer | ColorLight | Control, ColorTemperature | Controls the color temperature of the light from 0 (cold) to 100 (warm) |
156+
| color-temperature-abs | system.color-temperature-abs | Number:Temperature | ColorLight | Control, ColorTemperature | Controls the color temperature of the light in Kelvin |
157+
| electric-current | system.electric-current | Number:ElectricCurrent | Energy | Measurement, Current | Current electric current |
158+
| electric-voltage | system.electric-voltage | Number:ElectricPotential | Energy | Measurement, Voltage | Current electric voltage |
159+
| electric-energy | system.electric-energy | Number:Energy | Energy | Measurement, Energy | Current electric energy |
160+
| electric-power | system.electric-power | Number:Power | Energy | Measurement, Power | Current electric power |
161+
| atmospheric-humidity | system.atmospheric-humidity | Number:Dimensionless | Humidity | Measurement, Humidity | Current atmospheric relative humidity |
162+
| brightness | system.brightness | Dimmer | Light | Control, Brightness | Controls the brightness and switches the light on and off |
163+
| low-battery | system.low-battery | Switch | LowBattery | Alarm, LowBattery | Low battery warning with possible values on (low battery) and off (battery ok) |
164+
| media-control | system.media-control | Player | MediaControl | Control, MediaControl | |
165+
| motion | system.motion | Switch | Motion | Status, Presence | Motion detected by the device |
166+
| barometric-pressure | system.barometric-pressure | Number:Pressure | Pressure | Measurement, Pressure | Current barometric pressure |
167+
| signal-strength | system.signal-strength | Number | QualityOfService | Measurement, SignalStrength | Signal strength as with values 0 (worst), 1, 2, 3 or 4 (best) |
168+
| volume | system.volume | Dimmer | SoundVolume | Control, SoundVolume | Change the sound volume of a device |
169+
| mute | system.mute | Switch | SoundVolume_Mute | Switch, SoundVolume | Mute audio of the device |
170+
| power | system.power | Switch | Switch | Switch, Power | Device is operable when channel has state ON |
171+
| indoor-temperature | system.indoor-temperature | Number:Temperature | Temperature | Measurement, Temperature | Current indoor temperature |
172+
| outdoor-temperature | system.outdoor-temperature | Number:Temperature | Temperature | Measurement, Temperature | Current outdoor temperature |
173+
| wind-direction | system.wind-direction | Number:Angle | Wind | Measurement, Wind | Current wind direction expressed as an angle |
174+
| wind-speed | system.wind-speed | Number:Speed | Wind | Measurement, Wind | Current wind speed |
174175

175176
The `advanced` property indicates whether this channel is a basic or a more specific functionality of the thing.
176177
If `advanced` is set to `true` a user interface may hide this channel by default.

0 commit comments

Comments
 (0)