openhab-core/bundles/org.openhab.core.test.magic
Henning Treu 3c8e3efa93 Extend ChannelType by command options (#540)
This addresses https://github.com/eclipse/smarthome/issues/5099 by adding a command description with command options along with the state description.
Command options will give a hint to UIs about the specific commands a channel provides. Command options could be rendered as a drop down and also represent the current state or rendered as push buttons to simply send a command to the ThingHandler.
The infrstructure basically copies the StateDescription infrastructure with CommandDescriptionProviders and an `DynamicCommandDescriptionProvider` interface for bindings to hook in and provide dynamic command options.

Signed-off-by: Henning Treu <henning.treu@googlemail.com>
2019-02-12 13:41:01 +00:00
..
.settings remove project specific JDT settings (#481) 2019-01-29 10:24:39 +01:00
cfg mavenize openHAB and integrate mavenized ESH repository (#467) 2019-01-28 13:07:31 +01:00
src/main Extend ChannelType by command options (#540) 2019-02-12 13:41:01 +00:00
web mavenize openHAB and integrate mavenized ESH repository (#467) 2019-01-28 13:07:31 +01:00
.classpath mavenize openHAB and integrate mavenized ESH repository (#467) 2019-01-28 13:07:31 +01:00
.project mavenize openHAB and integrate mavenized ESH repository (#467) 2019-01-28 13:07:31 +01:00
NOTICE mavenize openHAB and integrate mavenized ESH repository (#467) 2019-01-28 13:07:31 +01:00
pom.xml mavenize openHAB and integrate mavenized ESH repository (#467) 2019-01-28 13:07:31 +01:00
README.md mavenize openHAB and integrate mavenized ESH repository (#467) 2019-01-28 13:07:31 +01:00

Magic Bundle

The Magic Bundle is a virtual device bundle which provides different Things, Channels and supporting functionality for easy UI testing.

Future plans:

  • Simulate communication errors
  • Provide REST API to update thing status from outside
  • Provide REST API to temporarily create new Channels/Things

Provided Things

  • Magic Light - On/Off
  • Magic Light - Dimmable
  • Magic Light - Color
  • Magic Sensor - Door/Window Contact
  • Magic Location
  • Magic Configurable Thing
  • Magic Thermostat
  • Magic Delayed Online Thing - goes online after some time
  • Magic Firmware Updatable Thing - can be firmware updated, depending on the model

Discovery

The Things provided by this bundle do not require discovery but can all be set up manually using PaperUI.

Bundle Configuration

Right now Magic has no specific configuration. This may change when Future plans are implemented.

Thing Configuration

The provided Things need no parameters right now.

Channels

Available channels:

  • switch - the on/off toggle maps to a Switch item.
  • brightness - the brightness value maps to a Dimmer item.
  • color - the color maps to a Color item.
  • alert - the alert function of the color light.
  • contact - the contact of the door/window contact.
  • location - the location of the magic location.
  • temperature - the temperature of the magic thermostat.
  • number - the delay in seconds for the delayed thing to go online.

Full Example

*.things:

magic:onoff-light:mylight "Bright or Dark"
magic:dimmable-light:greys "Shades of light"
magic:color-light:rainbow "Rainbow"

*.items:

Switch Light1 "On/Off Light" { channel="magic:onoff-light:mylight:switch" }
Dimmer Light2 "Shades of light" { channel="magic:dimmable-light:greys:brightness" }
Color Rainbow "Rainbow" { channel="magic:color-light:rainbow:color" }