HSL 2.0-Framework  1.9
Beschreibung des Frameworks
Öffentliche Methoden | Private Methoden | Aufstellung aller Elemente
hsl20_2.hsl20_2.BaseModule Klassenreferenz

Basis-Klasse für einen HSL 2.0-Baustein. Mehr ...

Öffentliche Methoden

def __init__ (self, homeserver_context, module_context)
 Konstruktur, muss im Konstruktor der vererbten Klasse aufgerufen werden. Mehr ...
 
def on_input_value (self, index, value)
 Wird jedes Mal aufgerufen, wenn ein Wert auf einem Eingang des Baustein eintrifft. Mehr ...
 
def on_init (self)
 Wird einmalig aufgerufen, wenn der Baustein initialisiert wird. Mehr ...
 

Private Methoden

def _get_module_id (self)
 Liefert die Laufzeit-ID des Moduls zurück. Mehr ...
 
def _get_module_class_id (self)
 Liefert die fünfstellige Baustein-ID (zum Beispiel '10001') zurück. Mehr ...
 
def _get_framework (self)
 Liefert ein Objekt vom Typ hsl20_2.Framework zurück. Mehr ...
 
def _get_logger (self, logType, param)
 Liefert ein Objekt vom Type hsl20_2.Logger zruück. Mehr ...
 
def _get_input_value (self, index)
 Liefert den Wert, der zum Zeitpunkt des Aufrufs am Eingang
index anliegt, zurück. Mehr ...
 
def _set_output_value (self, index, value)
 Setzt einen Wert auf einen Ausgang. Mehr ...
 
def _can_set_output (self)
 Zeigt an, ob ein Wert auf einen Ausgang gesetzt werden kann. Mehr ...
 
def _get_remanent (self, index)
 Liefert den Wert der remanenten Variable zurück. Mehr ...
 
def _set_remanent (self, index, value)
 Beschreibt eine remanente Variable. Mehr ...
 

Ausführliche Beschreibung

Basis-Klasse für einen HSL 2.0-Baustein.

Ein HSL 2.0-Baustein muss diese Klasse durch Vererbung als Basis haben. Der Generator erzeugt die notwendigen Code-Segmente: Ein Beispiel für die Umsetzung des Bausteins Sperre liegt bei: 10701_hsl20_2_BaseModule_03.py

Änderungen V1.9:
Beispiel als Script beigelegt, anstatt den Code hier anzuzeigen
Änderungen V1.9:
Namespace 'hsl20_1' umbenannt in 'hsl20_2'

Beschreibung der Konstruktoren und Destruktoren

def hsl20_2.hsl20_2.BaseModule.__init__ (   self,
  homeserver_context,
  module_context 
)

Konstruktur, muss im Konstruktor der vererbten Klasse aufgerufen werden.

Parameter
homeserver_contextobject
Verweis auf die HomeServer-Objektstruktur.
module_contextstring
Schlüssel des Modulkontexts. Der Schlüssel legt fest, in welchem Kontext der Baustein läuft.

Dokumentation der Elementfunktionen

def hsl20_2.hsl20_2.BaseModule._can_set_output (   self)
private

Zeigt an, ob ein Wert auf einen Ausgang gesetzt werden kann.

Liefert False falls vorerst kein weiterer Wert geschrieben werden kann.

Rückgabe
bool Ein Ausgang kann gesetzt werden
def hsl20_2.hsl20_2.BaseModule._get_framework (   self)
private

Liefert ein Objekt vom Typ hsl20_2.Framework zurück.

Rückgabe
hsl20_2.hsl20_2.Framework
Eine Instanz auf das HSL 2.0-Framework
def hsl20_2.hsl20_2.BaseModule._get_input_value (   self,
  index 
)
private

Liefert den Wert, der zum Zeitpunkt des Aufrufs am Eingang
index anliegt, zurück.

Der am Eingang anliegende Wert kann sich während des Ablaufs der Bausteinlogik ändern.

Parameter
indexint
Index des Eingangs.
Rückgabe
float/str
Wert des Eingangs. Der Typ des Rückgabewerts hängt von der Definition des Eingangs ab.
def hsl20_2.hsl20_2.BaseModule._get_logger (   self,
  logType,
  param 
)
private

Liefert ein Objekt vom Type hsl20_2.Logger zruück.

Zu beachten
Diese Methode wird durch den vom Generator erzeugten Code aufgerufen. Ein erneutes Aufrufen dieser Methode liefert (unabängig von den Parametern) das bereits erzeugte Logger-Objekt zurück.
Parameter
logTypeint
Logging-Handler (z.B. hsl20_2.LOGGING_SYSLOG)
paramtuple
Parameter zum verwendeten Logging-Handler
Rückgabe
hsl20_2.hsl20_2.Logger
Logger-Objekt
def hsl20_2.hsl20_2.BaseModule._get_module_class_id (   self)
private

Liefert die fünfstellige Baustein-ID (zum Beispiel '10001') zurück.

Rückgabe
string
Baustein-ID
Änderungen V1.9:
Methode set_reference(self, hsl_module) entfernt.
def hsl20_2.hsl20_2.BaseModule._get_module_id (   self)
private

Liefert die Laufzeit-ID des Moduls zurück.

Die ID ist nur während der Laufzeit des Geräts gültig.

Rückgabe
int
ID des Moduls
def hsl20_2.hsl20_2.BaseModule._get_remanent (   self,
  index 
)
private

Liefert den Wert der remanenten Variable zurück.

Siehe auch Remanentspeicher

Parameter
indexint
Index der remanten Variable
Rückgabe
float/str
Wert der remanenten Variable
def hsl20_2.hsl20_2.BaseModule._set_output_value (   self,
  index,
  value 
)
private

Setzt einen Wert auf einen Ausgang.

Parameter
indexint
Index des Ausgangs, der beschrieben werden soll.
valuefloat/str
Wert, der auf den Ausgang geschrieben wird. Der Datentyp ist abhängig davon, ob der Ausgang als numerisch oder alphanumerisch definiert wurde.
def hsl20_2.hsl20_2.BaseModule._set_remanent (   self,
  index,
  value 
)
private

Beschreibt eine remanente Variable.

Warnung
Der Remanentspeicher wird im HomeServer nur alle 15 Minuten persistiert.

Siehe auch Remanentspeicher

Parameter
indexint
Index der remanenten Variable
valuefloat/str
Wert der remanenten Variable (maximale Größe: 30.000 Byte).
def hsl20_2.hsl20_2.BaseModule.on_init (   self)

Wird einmalig aufgerufen, wenn der Baustein initialisiert wird.

Diese Methode kann implementiert (überschrieben) werden, wenn ein Baustein erstellt wird.

def hsl20_2.hsl20_2.BaseModule.on_input_value (   self,
  index,
  value 
)

Wird jedes Mal aufgerufen, wenn ein Wert auf einem Eingang des Baustein eintrifft.

Die Methode wird für jedes Eintreffen eines Wertes an einem Eingang genau einmal aufgerufen.

Diese Methode muss implementiert (überschrieben) werden, wenn ein Baustein erstellt wird.

Parameter
indexint
Index des Eingangs.
valuefloat/str
Wert, der auf dem Eingang eingetroffen ist. Der Datentyp ist abhängig davon, ob der Eingang als numerisch oder alphanumerisch definiert wurde.

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei: