FB_DALIV2GetSettingsSingleDevice

FB_DALIV2GetSettingsSingleDevice 1:

Im Gegensatz zum Funktionsbaustein FB_DALIV2GetSettings liest der Funktionsbaustein FB_DALIV2GetSettingsSingleDevice die Variablen (MIN LEVEL, MAX LEVEL, FADE TIME, ...) von nur einem bestimmten Gerät aus und speichert diese in einer Struktur vom Typ ST_DALIV2DeviceSettings.

Durch eine positive Flanke an dem Eingang bStart wird der Funktionsbaustein gestartet und der Ausgang bBusy geht auf TRUE. Anschließend werden nacheinander die Einstellungen des Vorschaltgerätes ausgelesen und in die betreffenden Variablen der Struktur geschrieben. Tritt während des Auslesevorganges ein Lesefehler bei einem Gerät auf, so wird das Element nErrors der jeweiligen Struktur gesetzt, ohne dass jedoch der FunktionsFunktionsbaustein an sich in Störung geht. In der folgenden Tabelle wird aufgelistet, welches Bit in der Variablen nErrors gesetzt wird, wenn beim Auslesen einer Variablen aus einem Vorschaltgerät ein Fehler aufgetreten ist:

Bit

Fehler

0

Bei dem Versuch das Vorschaltgerät zu suchen, ist ein Fehler aufgetreten.

1

Fehler beim Auslesen der Variable ACTUAL DIM LEVEL.

2

Fehler beim Auslesen der Variable POWER ON LEVEL.

3

Fehler beim Auslesen der Variable SYSTEM FAILURE LEVEL.

4

Fehler beim Auslesen der Variable MIN LEVEL.

5

Fehler beim Auslesen der Variable MAX LEVEL.

6

Fehler beim Auslesen der Variable FADE RATE.

7

Fehler beim Auslesen der Variable FADE TIME.

8

Fehler beim Auslesen der Variable RANDOM ADDRESS.

9

Fehler beim Auslesen der Variablen GROUP 0-7 und GROUP 8-15.

10

Fehler beim Auslesen der Variablen SCENE 0 bis SCENE 15.

11

Fehler beim Auslesen der Variable STATUS INFORMATION.

12

Fehler beim Auslesen der Variable VERSION NUMBER.

13

Fehler beim Auslesen der Variable DEVICE TYPE.

14

Fehler beim Auslesen der Variable PHYSICAL MIN LEVEL.

Nach Abarbeitung des Funktionsbausteins wechselt der Ausgang bBusy von TRUE nach FALSE.

FB_DALIV2GetSettingsSingleDevice 2: Eingänge

VAR_INPUT
  bStart           : BOOL;
  bCancel          : BOOL;
  nAddr            : BYTE;
  eCommandPriority : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;
  nOptions         : DWORD;
END_VAR

Name

Typ

Beschreibung

bStart

BOOL

Über eine positive Flanke an diesem Eingang wird der Funktionsbaustein aktiviert.

bCancel

BOOL

Über eine positive Flanke an diesem Eingang wird der Baustein deaktiviert und somit das Auslesen der Variablen abgebrochen.

nAddr

BYTE

Die Adresse des Gerätes, dessen Werte gelesen werden sollen.

eCommandPriority

E_DALIV2CommandPriority

Priorität (hoch, mittel oder niedrig), mit der der Befehl von der Library abgearbeitet wird.

nOptions

DWORD

Optionen für das Auslesen der Variablen (siehe Tabelle). Die einzelnen Konstanten müssen miteinander ODER-verknüpft werden.

Konstante

Beschreibung

DALIV2_OPTION_ACTUAL_DIM_LEVEL

Die Variable ACTUAL DIM LEVEL wird ausgelesen.

DALIV2_OPTION_POWER_ON_LEVEL

Die Variable POWER ON LEVEL wird ausgelesen.

DALIV2_OPTION_SYSTEM_FAILURE_LEVEL

Die Variable SYSTEM FAILURE LEVEL wird ausgelesen.

DALIV2_OPTION_MIN_LEVEL

Die Variable MIN LEVEL wird ausgelesen.

DALIV2_OPTION_MAX_LEVEL

Die Variable MAX LEVEL wird ausgelesen.

DALIV2_OPTION_FADE_RATE_FADE_TIME

Die Variablen FADE RATE und FADE TIME werden ausgelesen.

DALIV2_OPTION_RANDOM_ADDRESS

Die Variable RANDOM ADDRESS wird ausgelesen.

DALIV2_OPTION_GROUPS

Die Variablen GROUP 0-7 und GROUP 8-15 werden ausgelesen.

DALIV2_OPTION_SCENE_LEVELS

Die Variablen SCENE 0 bis SCENE 15 werden ausgelesen.

DALIV2_OPTION_STATUS_INFORMATION

Die Variable STATUS INFORMATION wird ausgelesen.

DALIV2_OPTION_VERSION_NUMBER

Die Variable VERSION NUMBER wird ausgelesen.

DALIV2_OPTION_DEVICE_TYPE

Die Variable DEVICE TYPE wird ausgelesen.

DALIV2_OPTION_PHYSICAL_MIN_LEVEL

Die Variable PHYSICAL MIN LEVEL wird ausgelesen.

DALIV2_OPTION_DONT_CLEAR_DEVICE_SETTINGS

Vor dem Lesen wird die Variable stDALIDeviceSettings nicht gelöscht.

DALIV2_OPTION_ALL

Alle Variablen werden ausgelesen.

FB_DALIV2GetSettingsSingleDevice 3: Ein-/Ausgänge

VAR_IN_OUT
  stCommandBuffer      : ST_DALIV2CommandBuffer;
  stDALIDeviceSettings : ST_DALIV2DeviceSettings;
END_VAR

Name

Typ

Beschreibung

stCommandBuffer

ST_DALIV2CommandBuffer

Verweis auf die interne Struktur zur Kommunikation mit FB_KL6811Communication (KL6811) oder FB_KL6821Communication (KL6821).

stDALIDeviceSettings

ST_DALIV2DeviceSettings

Verweis auf eine Struktur In dieser Variablen werden die Einstellungen vom DALI-Vorschaltgerät abgelegt.

FB_DALIV2GetSettingsSingleDevice 4: Ausgänge

VAR_OUTPUT
  bBusy    : BOOL;
  bError   : BOOL;
  nErrorId : UDINT;
END_VAR

Name

Typ

Beschreibung

bBusy

BOOL

Bei der Aktivierung des Funktionsbausteins wird der Ausgang gesetzt und bleibt so lange aktiv, bis der Befehl abgearbeitet wurde.

bError

BOOL

Dieser Ausgang wird auf TRUE geschaltet, wenn bei der Ausführung eines Befehls ein Fehler aufgetreten ist. Der befehlsspezifische Fehlercode ist in nErrorId enthalten. Wird durch das Ausführen eines Befehls an den Eingängen auf FALSE zurückgesetzt.

nErrorId

UDINT

Enthält den befehlsspezifischen Fehlercode des zuletzt ausgeführten Befehls. Wird durch das Ausführen eines Befehls an den Eingängen auf 0 zurückgesetzt (siehe Fehlercodes).

Voraussetzungen

Entwicklungsumgebung

Einzubindende SPS-Bibliothek

TwinCAT ab v3.1.4020.14

Tc2_DALI ab v3.4.3.0