Luup Variables
(→Dimmable Light: Table-ize the display of variables) |
(→Examples) |
||
(3 intermediate revisions by one user not shown) | |||
Line 2: | Line 2: | ||
The "Variables" for a device tell you it's current state, such as if it's on or off, what temperature it has, and so on. Variables are given a name and a service ID, which is defined by the UPnP forum. You can use this service ID/variable name pair to get the state of a device in the Luup engine by using the function luup.variable_get, as documented in [[Luup_Lua_extensions]]. You can also see the current value of a device's variables by going into Vera's setup page, click 'Devices', click + next to the device, then click 'Advanced'. The name of every variable for the device is shown along with the current value, and if you move your mouse over the variable name, you will the corresponding service ID in a popup window. | The "Variables" for a device tell you it's current state, such as if it's on or off, what temperature it has, and so on. Variables are given a name and a service ID, which is defined by the UPnP forum. You can use this service ID/variable name pair to get the state of a device in the Luup engine by using the function luup.variable_get, as documented in [[Luup_Lua_extensions]]. You can also see the current value of a device's variables by going into Vera's setup page, click 'Devices', click + next to the device, then click 'Advanced'. The name of every variable for the device is shown along with the current value, and if you move your mouse over the variable name, you will the corresponding service ID in a popup window. | ||
− | |||
− | ===Device category | + | =On/Off Switch= |
+ | |||
+ | ==Device category== | ||
Device Category 3, | Device Category 3, | ||
UPnP device id: ''urn:schemas-upnp-org:device:BinaryLight:1'' | UPnP device id: ''urn:schemas-upnp-org:device:BinaryLight:1'' | ||
− | + | ==Variables== | |
{| width="85%" cellpadding="10%" cellspacing="0" border="1" | {| width="85%" cellpadding="10%" cellspacing="0" border="1" | ||
|+ | |+ | ||
− | ! align="left"|Service!! align="left"|Variable!! align="left"|Description | + | ! align="left" width="30%"|Service!! align="left"|Variable!! align="left"|Description |
|- | |- | ||
|''urn:upnp-org:serviceId:SwitchPower1''||''Status''||If the device is on, the value is ''1'', otherwise it's ''0''. | |''urn:upnp-org:serviceId:SwitchPower1''||''Status''||If the device is on, the value is ''1'', otherwise it's ''0''. | ||
|} | |} | ||
− | + | ==Examples== | |
* Getting whether the Switch/Light is on or off | * Getting whether the Switch/Light is on or off | ||
<source lang="lua"> | <source lang="lua"> | ||
Line 23: | Line 24: | ||
-- Switch is on | -- Switch is on | ||
... | ... | ||
− | end if | + | end -- if |
</source> | </source> | ||
Line 31: | Line 32: | ||
</source> | </source> | ||
− | + | =Dimmable Light= | |
− | + | ==Device category== | |
Device category 2, | Device category 2, | ||
UPnP device id: ''urn:schemas-upnp-org:device:DimmableLight:1'' | UPnP device id: ''urn:schemas-upnp-org:device:DimmableLight:1'' | ||
− | + | ==Variables== | |
Dimmable lights contain the same variable of an On/Off Switch to indicate the current on/off value, and, if it's on, ''LoadLevelStatus'' indicates the dim level. | Dimmable lights contain the same variable of an On/Off Switch to indicate the current on/off value, and, if it's on, ''LoadLevelStatus'' indicates the dim level. | ||
{| width="85%" cellpadding="10%" cellspacing="0" border="1" | {| width="85%" cellpadding="10%" cellspacing="0" border="1" | ||
|+ | |+ | ||
− | ! align="left"|Service!! align="left"|Variable!! align="left"|Description | + | ! align="left" width="30%"|Service!! align="left"|Variable!! align="left"|Description |
|- | |- | ||
|''urn:upnp-org:serviceId:Dimming1''||''LoadLevelStatus''||If the device is off (see On/Off switch) this value indicates the last known dim level, if it's on, this value is the actual dim level. The value is a number from ''0-100'' indicating a percentage of brightness. | |''urn:upnp-org:serviceId:Dimming1''||''LoadLevelStatus''||If the device is off (see On/Off switch) this value indicates the last known dim level, if it's on, this value is the actual dim level. The value is a number from ''0-100'' indicating a percentage of brightness. | ||
|} | |} | ||
− | + | ==Examples== | |
* Getting the current light/load level | * Getting the current light/load level | ||
<source lang="lua"> | <source lang="lua"> | ||
Line 58: | Line 59: | ||
</source> | </source> | ||
− | |||
− | ===Device category | + | =Thermostat= |
+ | |||
+ | ==Device category== | ||
Device category 5, | Device category 5, | ||
UPnP device id: ''urn:schemas-upnp-org:device:HVAC_ZoneThermostat:1'' | UPnP device id: ''urn:schemas-upnp-org:device:HVAC_ZoneThermostat:1'' | ||
− | + | ==Variables== | |
{| width="85%" cellpadding="10%" cellspacing="0" border="1" | {| width="85%" cellpadding="10%" cellspacing="0" border="1" | ||
|+ | |+ | ||
− | ! align="left"|Service!! align="left"|Variable!! align="left"|Description | + | ! align="left" width="30%"|Service!! align="left"|Variable!! align="left"|Description |
|- | |- | ||
|''urn:upnp-org:serviceId:HVAC_UserOperatingMode1''||''ModeStatus''||This indicates the current operating mode and will be one of the following basic values: | |''urn:upnp-org:serviceId:HVAC_UserOperatingMode1''||''ModeStatus''||This indicates the current operating mode and will be one of the following basic values: | ||
Line 93: | Line 95: | ||
|} | |} | ||
− | + | ==Examples== | |
* Getting the current temperature | * Getting the current temperature | ||
<source lang="lua"> | <source lang="lua"> | ||
Line 99: | Line 101: | ||
</source> | </source> | ||
− | + | ||
+ | =Other Devices or Services= | ||
You can find other variables by looking at code. For example, looking at the code for the LUUP Weather plugin, we can see where the "serviceID" for Current Conditions is ''urn:micasaverde-com:serviceId:Weather1'' (taken from the XML file): | You can find other variables by looking at code. For example, looking at the code for the LUUP Weather plugin, we can see where the "serviceID" for Current Conditions is ''urn:micasaverde-com:serviceId:Weather1'' (taken from the XML file): | ||
<source lang="lua"> | <source lang="lua"> | ||
− | -- Store the current Condition (eg. " | + | -- Store the current Condition (eg. "rain") |
− | luup.variable_set("urn:upnp-micasaverde-com:serviceId:Weather1", " | + | luup.variable_set("urn:upnp-micasaverde-com:serviceId:Weather1", "ConditionGroup", |
condition, PARENT_DEVICE) | condition, PARENT_DEVICE) | ||
</source> | </source> | ||
− | From this we can get the Current Weather | + | From this we can get the Current Weather ConditionGroup using<br> |
− | Service: ''urn:upnp-micasaverde-com:serviceId:Weather1'' Variable name: '' | + | Service: ''urn:upnp-micasaverde-com:serviceId:Weather1'' Variable name: ''ConditionGroup'' |
All we have to add is the device ID that Vera creates. In my case #''37'' | All we have to add is the device ID that Vera creates. In my case #''37'' | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Latest revision as of 21:09, 28 May 2015
The "Variables" for a device tell you it's current state, such as if it's on or off, what temperature it has, and so on. Variables are given a name and a service ID, which is defined by the UPnP forum. You can use this service ID/variable name pair to get the state of a device in the Luup engine by using the function luup.variable_get, as documented in Luup_Lua_extensions. You can also see the current value of a device's variables by going into Vera's setup page, click 'Devices', click + next to the device, then click 'Advanced'. The name of every variable for the device is shown along with the current value, and if you move your mouse over the variable name, you will the corresponding service ID in a popup window.
Contents |
[edit] On/Off Switch
[edit] Device category
Device Category 3, UPnP device id: urn:schemas-upnp-org:device:BinaryLight:1
[edit] Variables
Service | Variable | Description |
---|---|---|
urn:upnp-org:serviceId:SwitchPower1 | Status | If the device is on, the value is 1, otherwise it's 0. |
[edit] Examples
- Getting whether the Switch/Light is on or off
local switchOnOff = luup.variable_get("urn:upnp-org:serviceId:SwitchPower1", "Status", 37) if (switchOnOff == "1") then -- Switch is on ... end -- if
- Request that the Switch be turned on. This will, eventually, set the variable after the device has responded to the request
luup.call_action("urn:upnp-org:serviceId:SwitchPower1", "SetTarget", {newTargetValue = "1"}, 37)
[edit] Dimmable Light
[edit] Device category
Device category 2, UPnP device id: urn:schemas-upnp-org:device:DimmableLight:1
[edit] Variables
Dimmable lights contain the same variable of an On/Off Switch to indicate the current on/off value, and, if it's on, LoadLevelStatus indicates the dim level.
Service | Variable | Description |
---|---|---|
urn:upnp-org:serviceId:Dimming1 | LoadLevelStatus | If the device is off (see On/Off switch) this value indicates the last known dim level, if it's on, this value is the actual dim level. The value is a number from 0-100 indicating a percentage of brightness. |
[edit] Examples
- Getting the current light/load level
local lightLevel = luup.variable_get("urn:upnp-org:serviceId:Dimming1", "LoadLevelStatus", 37)
- Request that the Dimmer be set to 50% light/load level. This will, eventually, set the variable after the device has responded to the request
luup.call_action("urn:upnp-org:serviceId:Dimming1", "SetLoadLevelTarget", {newLoadlevelTarget = "50"}, 19)
[edit] Thermostat
[edit] Device category
Device category 5, UPnP device id: urn:schemas-upnp-org:device:HVAC_ZoneThermostat:1
[edit] Variables
Service | Variable | Description |
---|---|---|
urn:upnp-org:serviceId:HVAC_UserOperatingMode1 | ModeStatus | This indicates the current operating mode and will be one of the following basic values:
In addition to the basic modes, some thermostats may also support the following modes:
|
urn:upnp-org:serviceId:TemperatureSetpoint1_Heat | CurrentSetpoint | This indicates the current heat set point. |
urn:upnp-org:serviceId:TemperatureSetpoint1_Cool | CurrentSetpoint | This indicatea the current cool set point. |
urn:upnp-org:serviceId:TemperatureSensor1 | CurrentTemperature | This indicates the current ambient temperature. |
[edit] Examples
- Getting the current temperature
local outsideTemp = luup.variable_get("urn:upnp-org:serviceId:TemperatureSensor1", "CurrentTemperature", 5)
[edit] Other Devices or Services
You can find other variables by looking at code. For example, looking at the code for the LUUP Weather plugin, we can see where the "serviceID" for Current Conditions is urn:micasaverde-com:serviceId:Weather1 (taken from the XML file):
-- Store the current Condition (eg. "rain") luup.variable_set("urn:upnp-micasaverde-com:serviceId:Weather1", "ConditionGroup", condition, PARENT_DEVICE)
From this we can get the Current Weather ConditionGroup using
Service: urn:upnp-micasaverde-com:serviceId:Weather1 Variable name: ConditionGroup
All we have to add is the device ID that Vera creates. In my case #37