Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Items: Fix mention of tag name and temperature tag example #2315

Merged
merged 2 commits into from
Jun 30, 2024
Merged

Items: Fix mention of tag name and temperature tag example #2315

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
57d604d
Fix mention of tag name
jlaur Jun 20, 2024
278e44c
Fix temperature tag example
jlaur Jun 23, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions configuration/items.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ Switch Kitchen_Light "Kitchen Light" {channel="mqtt:topic:..." }
String Bedroom_Sonos_CurrentTitle "Title [%s]" (gBedRoom) {channel="sonos:..."}
Number:Power Bathroom_WashingMachine_Power "Power [%.0f W]" <energy> (gPower) {channel="homematic:..."}

Number:Temperature Livingroom_Temperature "Temperature [%.1f °C]" <temperature> (gTemperature, gLivingroom) ["TargetTemperature"] {knx="1/0/15+0/0/15"}
Number:Temperature Livingroom_Temperature "Temperature [%.1f °C]" <temperature> (gTemperature, gLivingroom) ["Setpoint", "Temperature"] {knx="1/0/15+0/0/15"}
```

The last example above defines an Item with the following fields:
Expand All @@ -77,7 +77,7 @@ The last example above defines an Item with the following fields:
- Item [state formatted](#state-presentation) to display temperature in Celsius to one-tenth of a degree - for example, "21.5 °C"
- Item [icon](#icons) with the name `temperature`
- Item belongs to [groups](#groups) `gTemperature` and `gLivingroom` (definition not shown in the example)
- Item is [tagged](#tags) as a thermostat with the ability to set a target temperature ("TargetTemperature")
- Item is [tagged](#tags) as a thermostat with the ability to set a target temperature ("Setpoint", "Temperature")
- Item is [bound to](/addons/#binding) the openHAB Binding `knx` with binding specific settings ("1/0/15+0/0/15")

The remainder of this article provides additional information regarding Item definition fields.
Expand Down Expand Up @@ -554,11 +554,12 @@ The last Group counts all members of it matching the given regular expression, h

Tags added to an Item definition allow a user to characterize the specific nature of the Item beyond its basic Item type.
Tags can then be used by add-ons to interact with Items in context-sensitive ways.
Tags are used by the [Semantic Model]({{base}}/tutorial/model.html). The `"Light"` example below maps the item to the Semantic Model.
Tags are used by the [Semantic Model]({{base}}/tutorial/model.html).
The `"Light"` example below maps the item to the Semantic Model.

Example:
A Light in a typical home setup can be represented by a Switch, a Dimmer or a Color Item.
To be able to interact with the light device via a natural voice command, for example, the fact that the Item is a light can be established by adding the "Lighting" tag as shown below.
To be able to interact with the light device via a natural voice command, for example, the fact that the Item is a light can be established by adding the "Light" tag as shown below.

```java
Switch Livingroom_Light "Livingroom Ceiling Light" ["Light"]
Expand Down
Loading