This page is part of archived documentation for openHAB 2.5. Go to the current stable version
# MiOS Actions v1
This bundle exposes openHAB Rule extensions to be used with the MiOS Binding (1.x).
It exposes the ability to do the following things in the MiOS HA Controller from within openHAB rules]:
- Device Actions - Asynchronously invoke MiOS Device Actions involving 0, 1 or more parameters.
- Scenes Invocation - Asynchronously invoke MiOS Scenes
The MiOS Action bundle relies upon the MiOS Binding (1.x) being installed and configured. Once these are done, you're ready to use the rule extensions this bundle provides.
sendMiosAction(Item item, String action)- requests the parameterless Device Action, specified through
action, be invoked on the MiOS Device bound to
sendMiosAction(Item item, String action, List<<String,Object>> params)- as above, but for parameterized Device Actions.
sendMiosScene(Item scene)- requests the scene associated with the
sceneparameter be invoked on the MiOS Unit.
action argument of the
sendMiosAction action is a string of the form:
where ServiceURN, ServiceAlias and ServiceAction have the same form as described in MiOS Binding (1.x) commands.
You can use the MiOS
invoke URL to discover the Actions, and Action-parameters, your particular MiOS device supports:
The available ServiceAction's are described in the MiOS Luup UPnP Variables and Actions (opens new window) documentation.
- Invoking a Device Action and calling a Scene to turn off the AV.
rule "Test action rules Off" when Time cron "0 45 23 * * ?" then sendMiosAction(FamilyMainLightsId, "Dimmer/SetLoadLevelTarget", newArrayList('newLoadlevelTarget' -> 0)) sendMiosScene(SceneGoodNight) end
- Invoking a Sonos Device on MiOS to say something
rule "Test action say" when Item HallGarageDoorZoneTripped changed to OPEN then sendMiosAction(OfficeSonosId, "Sonos/Say", newArrayList('Text' -> 'Warning! Garage door opened', 'Volume' -> 50)) end
- Disarm your Alarm Panel (Paradox, GE, Ademco/Vista, DSC, etc)
rule "Test action Disarm" when ... then sendMiosAction(EVL3VistaPartition1ArmMode, 'Alarm/RequestArmMode', newArrayList('State' -> 'Disarmed', PINCode' -> 1234) end