Les Variables des Modules

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)
Exemples : Lecture du pourcentage de luminosité de la lampe du séjour

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)

Power Meter
Alarm Panel
Alarm Partition