Les «variables» d’un module vous informent de l’état actuel, par exemple : allumé ou éteint, quelle température, etc ….
Les variables sont définies par un nom et un service ID (UPnP forum).
Vous pouvez utiliser cette paire : service ID/ nom de la variable, pour obtenir l’état d’un module en utilisant la fonction luup.variable_get, tel que documenté dans Luup_Lua_extensions.
Vous pouvez également voir la valeur actuelle des variables d’un module en allant dans la page de configuration de Vera, cliquez sur ‘Modules’ (Devices), cliquez sur dans la barre du nom du module, puis cliquez sur l’onglet «Avancé».
Le nom de chaque variable pour ce module est représenté avec sa valeur actuelle, et si vous déplacez votre souris au-dessus du nom de la variable, vous faite apparaitre le service ID correspondant dans une fenêtre popup.
dans cet exemple :
CurrentTemperature/urn:upnp-org:serviceId:TemperatureSensor1
les Principales Variables Utilisateur :
Dimmable Light (Gradateur)
Catégorie | 2 | ||
Service Id | urn: upnp-org: ServiceId: Dimming1 | ||
Variable | LoadLevelStatus | Si l’appareil est éteint (voir Switch), cette valeur indique le dernier niveau connu dim,. La valeur est un nombre de 0 à 100 qui indique un pourcentage de brillance | |
Action | SetLoadLevelTarget | Argument newLoadLevelTarget | 0 à 100 (Integer) |
local DM_SI = « urn:upnp-org:serviceId:Dimming1 »
local EC_ACT_SJ = 35
local LuminositeSejour = luup.variable_get(DM_SI, « LoadLevelTarget », EC_ACT_SJ)
mettre la luminosité de la lampe du séjour à 50%
luup.call_action(DM_SI, « SetLoadLevelTarget », {newLoadlevelTarget=50}, EC_ACT_SJ)
Switch (Interrupteur)
Catégorie | 3 | ||
Service Id | urn: upnp-org: serviceId: SwitchPower1 | ||
Variable | Status | Etat du Module : 0 (Off) ou 1 (On) | |
Action | SetTarget | Argument NewTargetValue |
0 ou 1 (Integer) |
Exemples : Lecture de l’état d’un module Actionneur pilotant un Radiateur Electrique
local VS_SI = « urn:upnp-org:serviceId:SwitchPower1 »
local CH_ACT_BRI = 25
local EtatRadiateur = luup.variable_get(VS_SI, « Status », CH_ACT_BRI)
Mettre le même radiateur en chauffe :
luup.call_action(VS_SI, « setTarget », {newTargetValue=1}, CH_ACT_BRI)
Security Sensor
Catégorie | 4 | ||
Service Id | urn:micasaverde-com:serviceId:SecuritySensor | ||
Variable | Armed Tripped LastTripped |
Armé 0 (non) ou 1 (oui) Actionné 0 ou 1 Date de la derniere action Tripped |
|
Action | SetArmed | Argument newArmedValue(Integer) |
0 ou 1 (Integer) |
Exemples : Lire l »état de la fenêtre d’une chambre (fermée ou ouverte)
local SEC_CAP_BRI = 12 — capteur d’ouverture
local SS_SI = « urn:micasaverde-com:serviceId:SecuritySensor1 »
local varOuvF = luup.variable_get(SS_SI, « Tripped », SEC_CAP_BRI)
Armer un capteur de fenêtre
luup.call_action(SS_SI, « SetArmed », { newArmedValue=1}, SEC_CAP_BRI)
HVACArguments:NewModeTarget(String)NewMode(String)
Catégorie | 5 | ||
Service Id | urn: upnp-org: ServiceId: HVAC_UserOperatingMode1 |
||
Variable | ModeStatus | Mode de fonctionnement Actuel | |
Action |
SetModeTarget SetMode |
Arguments: NewModeTarget(String) NewMode(String) |
NewMode(String)NewModeTarget: One of Off, CoolOn, HeatOn, or AutoChangeOverNewMode: One of ContinuousOn or Auto, mode désiré pour la Ventilation |
Service Id | urn: upnp-org: ServiceId: TemperatureSetpoint1_Heat | ||
Variable | CurrentSetpoint | Valeur Consigne Chaud | |
Action | SetCurrentSetpoint | NewCurrentSetpoint(Integer) | NewCurrentSetpoint: An integer value between 0 and 100 spécifie le point de consigne chaud |
Service Id | urn: upnp-org: ServiceId: TemperatureSetpoint1_Cool | ||
Variable | CurrentSetpoint | Valeur Consigne Froid | |
Action | SetCurrentSetpoint | NewCurrentSetpoint(Integer) | NewCurrentSetpoint: An integer value between 0 and 100 spécifie le point de consigne froid |
Service Id | urn: upnp-org: ServiceId: TemperatureSensor1 | ||
Variable | CurrentTemperature | Température Ambiante actuelle (°C) | |
Action |
Exemples :
Camera
Lock
Window Covering
Remote Control
Ir Transmitter
Humidity Sensor (Capteur d’Humidité)
Catégorie | 16 | ||
Service Id | urn:micasaverde-com:serviceId:HumiditySensor1 | ||
Variable | CurrentLevel | Indique le taux d’humidité actuel (entier de 0 à 100) | |
Action |
Exemple : Lire le taux d’Humidité du capteur ST814 de la chambre Brigitte
local BRI_CAP_ST814 = 12
local HS_SI = « urn:micasaverde-com:serviceId:HumiditySensor1 »
local HS_TEMP = « CurrentLevel »
local curHumidity = luup.variable_get(HS_SI, HS_TEMP, BRI_CAP_ST814)
Temperature Sensor (Capteur de Température)
Catégorie | 17 | ||
Service Id | urn:upnp-org:serviceId: TemperatureSensor1 | ||
Variable | CurrentTemperature | Indique la température actuelle (entier) | |
Action |
Exemples : Lire la Température du capteur ST814 de la chambre Brigitte
local BRI_CAP_ST814 = 12
local TS_SI = « urn:upnp-org:serviceId:TemperatureSensor1 »
local TS_TEMP = « CurrentTemperature »
local curTemp = luup.variable_get(TS_SI, TS_TEMP, BRI_CAP_ST814)
Sensor Light (Capteur de Luminosité)
Catégorie | 18 | ||
Service Id | « urn:micasaverde-com:serviceId:LightSensor1 » | ||
Variable | CurrentLevel | Indique le % de lumière (entier) | |
Action |
Exemples : Lire le % de luminosité extérieure
local EXT_CAP_CAB = 19
local LS_SI = « »urn:micasaverde-com:serviceId:LightSensor1 »
local LS_TEMP = « CurrentLevel »
local curLum = luup.variable_get(LS_SI, LS_TEMP, EXT_CAP_CAB)