Fibaro HomeCenter Guide Teil 6: Parameter von Z-Wave Modulen

Häufig verweisen wir in Artikeln oder im Forum auf die Parameter von Modulen und empfehlen diese zu ändern, beziehungsweise anzupassen. Dies wirft vereinzelt wahrscheinlich mehr Fragen auf, als das es jemandem weiterhilft. In diesem Artikel erhaltet Ihr jetzt weitere Informationen zu diesem Thema.

Jedes Z-Wave Modul besitzt sogenannte Parameter, welche bestimmte Optionen beinhalten. Diese können über ein Z-Wave Gateway verändert werden, so dass sich das Modul dann möglicherweise anders verhält (Ohne ein entsprechendes Gateway kann dies nicht durchgeführt werden). Ein gutes Beispiel für so eine Veränderung sind die Parameter beim Fibaro MotionSensor in Bezug auf die Übermittlung der Werte für die Helligkeit und die Temperatur. Darüber hat Chris bereits vor etwas längerer Zeit einen Artikel "Fibaro Motion Eye – Empfindlichkeit der Helligkeit einstellen (LUX)" veröffentlicht, welcher aber immer noch zu 100% zutreffend (möglicherweise gibt es bei Fibaro MotionSensor GEN5 Änderungen an der Bezeichnung und Nummerierung der Parameter) ist.

Parameter beim Fibaro HomeCenter

Für viele Z-Wave Module hat Fibaro sogenannte Parametervorlagen in der Firmware hinterlegt. Dadurch werden die jeweiligen Z-Wave Parameter visualisiert dargestellt. Sollte dies nicht der Fall sein, dann müssen die Parameter manuell gesetzt werden. Diese befinden sich meistens/in der Regel/immer in den Manuals zu den jeweiligen Modulen. Eine solche Auflistung findet Ihr zum Beispiel bei dem kürzlich vorgestellten Z-Wave Thermostat mit FLiRS-Technologie. Hier könnt Ihr erkennen, dass die Parameter nichts anderes sind, als bestimmte Zahlenwerte, welche in der jeweiligen Firmware des Moduls eine bestimmte Funktion übernimmt. Bei dem Fibaro HomeCenter 2 würden die Einstellungen des erwähnten Thermostates folgendermaßen dargestellt:

Manuell gesetzte Parameter

Wie Ihr an diesem Screenshot erkennen könnt, besteht jeder Parameter immer aus drei Angaben: Number (Nummer), Data Type (Datentyp) und Desired value (Gewünschter Wert). Die Nummer steht in diesem Fall für die Optionen-Nummer, welche verändert werden soll. Der Datentyp (entspricht der Größe des Parameters) wird von dem Modul vorgegeben und der gewünschte Wert ist der Inhalt dieser Option, also wie die Einstellung der bestimmten Option erfolgen soll.

Sofern in der Firmware des HC2 eine Parametervorlage hinterlegt ist, wird dieses auch grundsätzlich verwendet. Wenn dies nicht gewünscht ist, dann könnt Ihr folgende Option deaktivieren:

Use template for parameters

[alert variation="alert-info" dismiss="dismiss"]WICHTIG: Oftmals wird die Vorlage der Parameter gleichgesetzt mit dem Template von Modulen, welche bei Fibaro für die eindeutige Erkennung der Z-Wave Funktion benötigt wird. Dies ist aber nicht der Fall: Es gibt zum Einen die Templates und zum Anderen die Parametervorlage. Beides sind unterschiedliche Configs und müssen beide von Fibaro einzeln in der Firmware gepflegt werden. Es kann also auch Module geben, welche zwar ein Template, jedoch keine Parametervorlage besitzen. Für solche Module wird seitens Fibaro auch mit hoher Wahrscheinlichkeit keine Parametervorlage erstellt. Dann muss man in den "sauren Apfel" beißen und sich diese manuell anlegen.[/alert]

Änderungen an den Parametern müssen an das Modul über Z-Wave übertragen werden. Bei Modulen, welche mit Strom betrieben werden und welche die FLiRS-Funkionalität besitzen, werden diese Änderungen just-in-Time an die Module übergeben. Batteriebetriebene Module müssen erst aufgeweckt werden, damit diese neue Einstellungen annehmen können.

Parameter über LUA ändern

Mit dem Fibaro HomeCenter 2 können die Parameter auch über eine LUA-Szene verändert werden. (Mit dem Fibaro HCL funktioniert dies nicht!) Dazu könnt Ihr folgenden LUA-Code nutzen:

--[[
%% properties
%% globals
--]] 

local ID = 137
local parameter = 37
local size = 2
local value = 771
    
function changeParameter(deviceid,set_parameter,set_size,set_value)
  local http = net.HTTPClient()
  http:request("http://127.0.0.1:11111/api/devices/"..deviceid, {
    options = {
    method = 'PUT',
    headers = {},
    data = '{"properties":{"parameters":[{"id":'..set_parameter..',"size":'..set_size..',"value":'..set_value..'}}]}',
    timeout = 10000
  },
  success = function(response)
            local result = response.data;
            if response.status == 200 or response.status == 201 then
              fibaro:debug('Status: ' ..response.status.. ' - Parameter geändert')
            else
              fibaro:debug('Error: ' ..response.status.. ' - Zugriff verweigert')
            end
            end,
  error = function(err)
          fibaro:debug('[ERROR] ' .. err)
          end
  })
end

changeParameter(ID,parameter,size,value)

--[[

%% properties

%% globals

--]]

local ID = 137

local parameter = 37

local size = 2

local value = 771

function changeParameter(deviceid,set_parameter,set_size,set_value)

local http = net.HTTPClient()

http:request("http://127.0.0.1:11111/api/devices/"..deviceid, {

options = {

method = 'PUT',

headers = {},

data = '{"properties":{"parameters":[{"id":'..set_parameter..',"size":'..set_size..',"value":'..set_value..'}}]}',

timeout = 10000

success = function(response)

local result = response.data;

if response.status == 200 or response.status == 201 then

fibaro:debug('Status: ' ..response.status.. ' - Parameter geändert')

else

fibaro:debug('Error: ' ..response.status.. ' - Zugriff verweigert')

end

end,

error = function(err)

fibaro:debug('[ERROR] ' .. err)

end

})

end

changeParameter(ID,parameter,size,value)

Hier müssen noch die lokalen Variablen angepasst werden:

local ID = 137 -- ID des Moduls, bei dem der Parameter geändert werden soll
local parameter = 37 -- Parameter, welcher geändet werden soll
local size = 2 -- Größe des Parameter
local value = 771 -- Inhalt, welcher beim Parameter gesetzt werden soll

local ID = 137 -- ID des Moduls, bei dem der Parameter geändert werden soll

local parameter = 37 -- Parameter, welcher geändet werden soll

local size = 2 -- Größe des Parameter

local value = 771 -- Inhalt, welcher beim Parameter gesetzt werden soll

Wie dieses Skript eingerichtet werden muss, haben wir bereits in dem ausführlichen Artikel "Kleine LUA Scripte Teil 8: Parameter von Modulen per Szene ändern" beschrieben, weshalb wir an dieser Stelle nicht mehr ausführlich auf die Konfiguration eingehen werden.

Alle Guides findet Ihr hier: