Updated external content (Jenkins build 62)
openHAB Build Server
parent
713d3edb0c
commit
002d08e6dd
File diff suppressed because one or more lines are too long
|
|
@ -56,10 +56,12 @@ Additionally lights, window coverings (blinds) and thermostats are supported:
|
|||
| Thermostat | ZHAThermostat | `thermostat` |
|
||||
| Warning Device (Siren) | Warning device | `warningdevice` |
|
||||
|
||||
Currently only light-groups are supported via the thing-type `lightgroup`.
|
||||
|
||||
## Discovery
|
||||
|
||||
deCONZ software instances are discovered automatically in the same subnet.
|
||||
Sensors, switches, lights and blinds are discovered as soon as a `deconz` bridge thing comes online.
|
||||
Sensors, switches, groups, lights and blinds are discovered as soon as a `deconz` bridge thing comes online.
|
||||
If your device is not discovered, please check the DEBUG log for unknown devices and report your findings.
|
||||
|
||||
## Thing Configuration
|
||||
|
|
@ -95,13 +97,11 @@ Due to limitations in the API of deCONZ, the `lastSeen` channel (available some
|
|||
Allowed values are all positive integers, the unit is minutes.
|
||||
The default-value is `0`, which means "no polling at all".
|
||||
|
||||
|
||||
`dimmablelight`, `extendedcolorlight`, `colorlight` and `colortemperaturelight` have an additional optional parameter `transitiontime`.
|
||||
The transition time is the time to move between two states and is configured in seconds.
|
||||
The resolution provided is 1/10s.
|
||||
If no value is provided, the default value of the device is used.
|
||||
|
||||
|
||||
### Textual Thing Configuration - Retrieving an API Key
|
||||
|
||||
If you use the textual configuration, the thing file without an API key will look like this, for example:
|
||||
|
|
@ -168,18 +168,23 @@ The `last_seen` channel is added when it is available AND the `lastSeenPolling`
|
|||
|
||||
Other devices support
|
||||
|
||||
| Channel Type ID | Item Type | Access Mode | Description | Thing types |
|
||||
|-------------------|--------------------------|:-----------:|---------------------------------------|-----------------------------------------------|
|
||||
| brightness | Dimmer | R/W | Brightness of the light | `dimmablelight`, `colortemperaturelight` |
|
||||
| switch | Switch | R/W | State of a ON/OFF device | `onofflight` |
|
||||
| color | Color | R/W | Color of an multi-color light | `colorlight`, `extendedcolorlight` |
|
||||
| color_temperature | Number | R/W | Color temperature in kelvin. The value range is determined by each individual light | `colortemperaturelight`, `extendedcolorlight` |
|
||||
| position | Rollershutter | R/W | Position of the blind | `windowcovering` |
|
||||
| heatsetpoint | Number:Temperature | R/W | Target Temperature in °C | `thermostat` |
|
||||
| valve | Number:Dimensionless | R | Valve position in % | `thermostat` |
|
||||
| mode | String | R/W | Mode: "auto", "heat" and "off" | `thermostat` |
|
||||
| offset | Number | R | Temperature offset for sensor | `thermostat` |
|
||||
| alert | Switch | R/W | Turn alerts on/off | `warningdevice` |
|
||||
| Channel Type ID | Item Type | Access Mode | Description | Thing types |
|
||||
|-------------------|--------------------------|:-----------:|---------------------------------------|-------------------------------------------------|
|
||||
| brightness | Dimmer | R/W | Brightness of the light | `dimmablelight`, `colortemperaturelight` |
|
||||
| switch | Switch | R/W | State of a ON/OFF device | `onofflight` |
|
||||
| color | Color | R/W | Color of an multi-color light | `colorlight`, `extendedcolorlight`, `lightgroup`|
|
||||
| color_temperature | Number | R/W | Color temperature in kelvin. The value range is determined by each individual light | `colortemperaturelight`, `extendedcolorlight`, `lightgroup` |
|
||||
| position | Rollershutter | R/W | Position of the blind | `windowcovering` |
|
||||
| heatsetpoint | Number:Temperature | R/W | Target Temperature in °C | `thermostat` |
|
||||
| valve | Number:Dimensionless | R | Valve position in % | `thermostat` |
|
||||
| mode | String | R/W | Mode: "auto", "heat" and "off" | `thermostat` |
|
||||
| offset | Number | R | Temperature offset for sensor | `thermostat` |
|
||||
| alert | Switch | R/W | Turn alerts on/off | `warningdevice`, `lightgroup` |
|
||||
| all_on | Switch | R | All lights in group are on | `lightgroup` |
|
||||
| any_on | Switch | R | Any light in group is on | `lightgroup` |
|
||||
|
||||
**NOTE:** For groups `color` and `color_temperature` are used for sending commands to the group.
|
||||
Their state represents the last command send to the group, not necessarily the actual state of the group.
|
||||
|
||||
### Trigger Channels
|
||||
|
||||
|
|
@ -221,6 +226,7 @@ Bridge deconz:deconz:homeserver [ host="192.168.0.10", apikey="ABCDEFGHIJ" ] {
|
|||
waterleakagesensor basement-water-leakage "Basement Water Leakage" [ id="7" ]
|
||||
alarmsensor basement-alarm "Basement Alarm Sensor" [ id="8", lastSeenPolling=5 ]
|
||||
dimmablelight livingroom-ceiling "Livingroom Ceiling" [ id="1" ]
|
||||
lightgroup livingroom "Livingroom" [ id="1" ]
|
||||
}
|
||||
```
|
||||
|
||||
|
|
@ -235,6 +241,7 @@ Contact Livingroom_Window "Window Livingroom [%s]"
|
|||
Switch Basement_Water_Leakage "Basement Water Leakage [%s]" { channel="deconz:waterleakagesensor:homeserver:basement-water-leakage:waterleakage" }
|
||||
Switch Basement_Alarm "Basement Alarm Triggered [%s]" { channel="deconz:alarmsensor:homeserver:basement-alarm:alarm" }
|
||||
Dimmer Livingroom_Ceiling "Livingroom Ceiling [%d]" <light> { channel="deconz:dimmablelight:homeserver:livingroom-ceiling:brightness" }
|
||||
Color Livingroom "Livingroom Light Control"
|
||||
```
|
||||
|
||||
### Events
|
||||
|
|
|
|||
|
|
@ -661,25 +661,24 @@ Again, refer to the [Insteon Terminal](https://github.com/pfrommerd/insteon-term
|
|||
This is an example of what to put into your .items file:
|
||||
|
||||
```
|
||||
Number thermostatCoolPoint "cool point [%.1f °F]" { channel="insteon:device:home:AABBCC:coolSetPoint" }
|
||||
Number thermostatHeatPoint "heat point [%.1f °F]" { channel="insteon:device:home:AABBCC:heatSetPoint" }
|
||||
Number thermostatSystemMode "system mode [%d]" { channel="insteon:device:home:AABBCC:systemMode" }
|
||||
Number thermostatFanMode "fan mode [%d]" { channel="insteon:device:home:AABBCC:fanMode" }
|
||||
Number thermostatIsHeating "is heating [%d]" { channel="insteon:device:home:AABBCC:isHeating"}
|
||||
Number thermostatIsCooling "is cooling [%d]" { channel="insteon:device:home:AABBCC:isCooling" }
|
||||
Number thermostatTempFahren "temperature [%.1f °F]" { channel="insteon:device:home:AABBCC:tempFahrenheit" }
|
||||
Number thermostatTempCelsius "temperature [%.1f °C]" { channel="insteon:device:home:AABBCC:tempCelsius" }
|
||||
Number thermostatHumidity "humidity [%.0f %%]" { channel="insteon:device:home:AABBCC:humidity" }
|
||||
Number thermostatCoolPoint "cool point [%.1f °F]" { channel="insteon:device:home:AABBCC:coolSetPoint" }
|
||||
Number thermostatHeatPoint "heat point [%.1f °F]" { channel="insteon:device:home:AABBCC:heatSetPoint" }
|
||||
Number thermostatSystemMode "system mode [%d]" { channel="insteon:device:home:AABBCC:systemMode" }
|
||||
Number thermostatFanMode "fan mode [%d]" { channel="insteon:device:home:AABBCC:fanMode" }
|
||||
Number thermostatIsHeating "is heating [%d]" { channel="insteon:device:home:AABBCC:isHeating"}
|
||||
Number thermostatIsCooling "is cooling [%d]" { channel="insteon:device:home:AABBCC:isCooling" }
|
||||
Number:Temperature thermostatTemperature "temperature [%.1f %unit%]" { channel="insteon:device:home:AABBCC:temperature" }
|
||||
Number thermostatHumidity "humidity [%.0f %%]" { channel="insteon:device:home:AABBCC:humidity" }
|
||||
```
|
||||
|
||||
Add this as well for some more exotic features:
|
||||
|
||||
```
|
||||
Number thermostatACDelay "A/C delay [%d min]" { channel="insteon:device:home:AABBCC:acDelay" }
|
||||
Number thermostatBacklight "backlight [%d sec]" { channel="insteon:device:home:AABBCC:backlightDuration" }
|
||||
Number thermostatStage1 "A/C stage 1 time [%d min]" { channel="insteon:device:home:AABBCC:stage1Duration" }
|
||||
Number thermostatHumidityHigh "humidity high [%d %%]" { channel="insteon:device:home:AABBCC:humidityHigh" }
|
||||
Number thermostatHumidityLow "humidity low [%d %%]" { channel="insteon:device:home:AABBCC:humidityLow" }
|
||||
Number thermostatACDelay "A/C delay [%d min]" { channel="insteon:device:home:AABBCC:acDelay" }
|
||||
Number thermostatBacklight "backlight [%d sec]" { channel="insteon:device:home:AABBCC:backlightDuration" }
|
||||
Number thermostatStage1 "A/C stage 1 time [%d min]" { channel="insteon:device:home:AABBCC:stage1Duration" }
|
||||
Number thermostatHumidityHigh "humidity high [%d %%]" { channel="insteon:device:home:AABBCC:humidityHigh" }
|
||||
Number thermostatHumidityLow "humidity low [%d %%]" { channel="insteon:device:home:AABBCC:humidityLow" }
|
||||
```
|
||||
|
||||
**Sitemap**
|
||||
|
|
@ -687,8 +686,7 @@ Add this as well for some more exotic features:
|
|||
For the thermostat to display in the GUI, add this to the sitemap file:
|
||||
|
||||
```
|
||||
Text item=thermostatTempCelsius icon="temperature"
|
||||
Text item=thermostatTempFahren icon="temperature"
|
||||
Text item=thermostatTemperature icon="temperature"
|
||||
Text item=thermostatHumidity
|
||||
Setpoint item=thermostatCoolPoint icon="temperature" minValue=63 maxValue=90 step=1
|
||||
Setpoint item=thermostatHeatPoint icon="temperature" minValue=50 maxValue=80 step=1
|
||||
|
|
|
|||
|
|
@ -0,0 +1,54 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<thing:thing-descriptions bindingId="deconz"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xmlns:thing="https://openhab.org/schemas/thing-description/v1.0.0"
|
||||
xsi:schemaLocation="https://openhab.org/schemas/thing-description/v1.0.0 https://openhab.org/schemas/thing-description-1.0.0.xsd">
|
||||
|
||||
<thing-type id="lightgroup">
|
||||
<supported-bridge-type-refs>
|
||||
<bridge-type-ref id="deconz"/>
|
||||
</supported-bridge-type-refs>
|
||||
<label>Light Group</label>
|
||||
<channels>
|
||||
<channel typeId="all_on" id="all_on"/>
|
||||
<channel typeId="any_on" id="any_on"/>
|
||||
<channel typeId="alert" id="alert"/>
|
||||
<channel typeId="color" id="color"/>
|
||||
<channel typeId="ct" id="color_temperature"/>
|
||||
</channels>
|
||||
|
||||
<representation-property>uid</representation-property>
|
||||
|
||||
<config-description-ref uri="thing-type:deconz:sensor"/>
|
||||
</thing-type>
|
||||
|
||||
<channel-type id="alert">
|
||||
<item-type>Switch</item-type>
|
||||
<label>Alert</label>
|
||||
</channel-type>
|
||||
|
||||
<channel-type id="all_on">
|
||||
<item-type>Switch</item-type>
|
||||
<label>All On</label>
|
||||
<description>"On" if all lights in this group are "On", otherwise "Off".</description>
|
||||
<state readOnly="true"/>
|
||||
</channel-type>
|
||||
|
||||
<channel-type id="any_on">
|
||||
<item-type>Switch</item-type>
|
||||
<label>Any On</label>
|
||||
<description>"On" if any light in this group is "On", otherwise "Off".</description>
|
||||
</channel-type>
|
||||
|
||||
<channel-type id="color">
|
||||
<item-type>Color</item-type>
|
||||
<label>Color</label>
|
||||
</channel-type>
|
||||
|
||||
<channel-type id="ct">
|
||||
<item-type>Number</item-type>
|
||||
<label>Color Temperature</label>
|
||||
<state pattern="%d K" min="15" max="100000" step="100"/>
|
||||
</channel-type>
|
||||
|
||||
</thing:thing-descriptions>
|
||||
|
|
@ -132,7 +132,7 @@
|
|||
<channel-type id="ct">
|
||||
<item-type>Number</item-type>
|
||||
<label>Color Temperature</label>
|
||||
<state pattern="%d" min="15" max="100000" step="100"/>
|
||||
<state pattern="%d K" min="15" max="100000" step="100"/>
|
||||
</channel-type>
|
||||
|
||||
<channel-type id="alert">
|
||||
|
|
|
|||
Loading…
Reference in New Issue