Hi rpwong and JustinG,
thank you very much for taking time to answer me.
I want to modify my suggestion about the getting started tutorial.
IMHO the introductional explainings becomes easier to understand if the text starts with describing an everyday example with common words and then explains in OpenHAB this is called “…” and this is called “…”. This order starts with the well known and then couples it to the words that are used in a specific way inside openHAB.
There are good reasons to use common words like “thing”, “item”, “channel” for that. Though as the meaning inside OpenHAB is very specific and partially different than the everyday meaning IMHO it is a good idea to take time and textual effort to explain this.
I want to give an example:
Imagine a room inside your house with a double-switch mounted into the wall for switching on/off two different lightbulbs.
Imagine a TV-remote-control with all its keys to switch on/off, change the TV-program, change volume etc.
In OpenHAB such objects like the double-switch, the TV-remote, a single switch etc. are called “things”
Now let’s take a closer look at the “thing” double-switch:
The double-switch is able to
- switch on/off lightbulb “A”
- switch on/off lightbulb “B”
Lightbulb “A” and lightbulb “B” can be switched on/off separately and indipendend from each other.
This means the double-switch has two functions.
The same principles apply to the “thing” TV-remote-control.
The “thing” TV-remote-control has a lot of buttons where each button has a different function to
- increase / decrease volume
- increase / decrease brightness of the screen
- change between different TV-programs
etc.
The double-switch is able to switch on/off lightbulb “A” and lightbulb “B” independent from each other. In OpenHAB the capability to switch on/off is called a “channel”.
This means the one “thing” double-switch has two “channels”
A wall mounted switch on its own without additional objects is useless. The double-switch is part of a system that has more elements than just the double-switch. There are wires coming from the electrical cabinet which are connected to the double-switch and there are some more wires one end connected to the double-switch the other end connected to the socket of the lamp that holds the lightbulb.
: break :
I think this example illustrates the underlying pattern:
Start with the everyday example and then use the everyday term to explain the OpenHAB term
At this point I’m unsure how to proceed with the explanation.
I’m unsure what the term “item” means.
is it:
-
the graphical representation of the switch on a openHAB-webpage?
-
the graphical representation of the lightbulb on a openHAB-webpage?
-
the lightbulb as the real physical object and the graphical representation of the lightbulb on a openHAB-webpage?
-
something different?
Beeing unsure at this point the other OpenHAB-terms “binding” and “link” remain nebulous for me.
So I would appreciate it very much if you could answer the question above and write an explanation similar to the given example.
best regards Stefan