Einführung

Der Lichtsteuerungsclient sorgt dafür, Schaltwünsche von Benutzern in Lichtzustände umzusetzen. Technisch: DMX- oder Benutzerinput zu Relaisoutput.

Features

DMX/RDM Ein- und Ausgang
Batteriegestützte Realtime Clock
1024KB I²C EEPROM
32 Ausgänge
16 Eingänge
RS232

Kaskadierung

Entgegen des ursprünglichen Plans besitzt der aktuelle Lichtsteuerungsclient nur noch einen Ein/Ausgang, der im Halbduplexmodus genutzt wird. Kaskadierung wird über RS485-Hubs gelöst.

Relais schalten und Verkabeln

Am Relais liegt +24V an und wird nach GND durch den Relaistreiber durchgeschalten. Der maximale Strom pro Port beträgt 500mA.

Die Versorgungsspannung der Relais sollte von den Klemmen X1 und X2 abgegriffen werden, da diese jeweils mit einer 200mA Polyfuse gesichert sind. Somit ist gewährleistet, daß der Relaistreiber nicht beschädigt wird.

Reichen 500mA nicht aus, so darf man laut ULN2803-Datenblatt mehrere Ausgänge parallel schalten, dies wurde aber bisher nicht getestet.

Die Ausgänge besitzen keine Freilaufdioden. Der Relaistreiber besitzt Dioden, allerdings sollte man Relais verwenden, die eine Freilaufdiode eingebaut haben.

Schaltzustände

Schaltzustände können über DMX mittels RDM erfragt werden. Inwiefern das Probleme mit existierendem DMX-Equipment gibt, ist bisher unklar; laut Wikipedia soll dies aber keine Probleme verursachen.

EEPROM Memory Map (Atmega64, 2K)

Adresse	Länge (Bytes)	Inhalt
0x0000	1	Signatur 1 von DMXSerial2
0x0001	1	Signatur 2 von DMXSerial2
0x0002	2	DMX-Startaddresse
0x0004	32	Gerätebezeichnung
0x0024	6	Geräte-UID
0x002A	2006	Reserviert für bitlash-Funktionen

EEPROM Memory Map (I2C, 1MB)

Adresse	Länge (Bytes)	Inhalt
0x00000	1024	Namen der Ausgänge (32x32 Zeichen)
0x00400	512	Namen der Eingänge (16x32 Zeichen)
0x00600	16	Modus der Eingänge
0x00610	32	Private-Flag für die Ausgänge
0xF000	4096	Backup des Arduino-EEPROMS

Firmware

Die Firmware ist generisch gehalten, sodaß die selbe Firmware für Haupt- und Nebenraum eingesetzt werden kann. Die Konfigurationsdaten werden im EEPROM vorgehalten.

Auf der Lichtsteuerung kommt deshalb bitlash zum Einsatz, welches rudimentäres Scripting ermöglicht. Folgende Funktionen stehen zur Verfügung und können zum Beispiel über die serielle Schnittstelle oder vom PI aus ausgeführt werden:

setDeviceName

setDeviceName("description");

Setzt den Namen der Lichtsteuerung. Maximal 32 Zeichen ASCII. Wird im EEPROM abgespeichert. Kann über RDM gesetzt und abgefragt werden (DEVICE_LABEL). Beispiel:

setDeviceName("Lichtsteuerung Hauptraum");

getDeviceName

getDeviceName();

Liefert den Namen der Lichtsteuerung. Beispiel:

print getDeviceName();
> Lichtsteuerung Hauptraum

getDMXStartAddress

getDMXStartAddress();

Liefert die konfigurierte DMX Startaddresse zurück. Kann über RDM gesetzt und abgefragt werden (DMX_START_ADDRESS). Beispiel:

print getDMXStartAddress();
> 32

setDMXStartAddress

Obsolet; DMX-Startaddresse wird nur über RDM gesetzt.

getRDMUID

getRDMUID();

Liefert die RDM UID zurück. Beispiel:

print getRDMUID();
> 1f13:abde1000

setOutputName

setOutputName(number, "Description");

Gibt dem Ausgang mit number eine Beschreibung, maximal 32 Zeichen, nur ASCII. Wird im EEPROM abgespeichert. Die Beschreibung kann über RDM abgefragt werden. Beispiel:

setOutputName(1, "Lichtkreis 1 (Lager)");

getOutputName

getOutputName(number);

Liefert den Namen eines Ausgangs zurück. Beispiel:

print getOutputName(1);
> Lichtkreis 1 (Lager)

setOutputState

setOutputState(number, state);

Setzt den Ausgang number auf den Zustand 0 (aus) oder 1 (an). Beispiel:

setOutputState(10, 1);

getOutputState

getOutputState(number);

Gibt den Zustand des Ausgangs number zurück.

Beispiel:

print getOutputState(10);
> 1

toggleOutputState

toggleOutputState(number);

Toggelt den Zustand des Ausgangs number.

Beispiel:

toggleOutputState(1);
print getOutputState(1);
> 1
toggleOutputState(1);
print getOutputState(1);
> 0

setInputName

setInputName(number, "Description");

Gibt dem Eingang mit number eine Beschreibung, maximal 32 Zeichen, nur ASCII. Wird im EEPROM abgespeichert. Beispiel:

setInputName(1, "Lichtschalter Tuer Lager");

setPrivateFlag

setPrivateFlag(port,private)

Setzt das "private" flag für einen Ausgang. "private" bedeutet, daß der Port nicht für den Endbenutzer sichtbar sein soll - dies ist für Ports nützlich, die eine Sonderfunktion haben, z.b. ein Warnsignal, welches vor einem Shutdown des Nebenraumes warnt.

Beispiel:

setPrivateFlag(1,1);

Dies setzt den Ausgang 1 auf "private".

getInputName

getInputName(number);

Gibt den Namen des Eingangs zurück. Beispiel:

print getInputName(1);
> Lichtschalter Tuer Lager

setInputMode

setInputMode(number, mode);

Setzt den Modus des Eingangs. Wird im EEPROM abgespeichert. Folgende Modis sind definiert:

MODE_TOGGLE: Wechselschalter
MODE_MOMENTARY: Taster

Beispiel:

setInputMode(1, "MODE_MOMENTARY");

getInputMode

getInputMode(number);

Liefert den Modus des Eingangs.

Beispiel:

print getInputMode(1);
> MODE_MOMENTARY

listOutputs

listOutputs();

Gibt alle Ausgänge inklusive der Namen auf dem Terminal zurück. Beispiel:

listOutputs();
> #1: Lichtkreis 1 (Lager)
> #2: Lichtkreis 2 (Lager)
> #3: Lichtkreis 3 (Lager)
> ...
> #32: Nicht belegt

listInputs

listInputs();

Gibt alle Ausgänge inklusive der Namen und des Modus auf dem Terminal zurück. Beispiel:

listInputs();
> #1: Lichtschalter Tuer (Lager) [MODE_TOGGLE]
> #2: Lichtschalter Tuer (Beamer) [MODE_TOGGLE]
> #3: Lichtschalter Tuer (Tafel) [MODE_TOGGLE]
> #4: Lichtschalter Tuer (Kueche) [MODE_TOGGLE]
> ...
> #16: Nicht belegt [MODE_TOGGLE]

anyOutputOn

anyOutputOn (number[,number,...]);

Gibt zurück, ob ein Eingang in der Range eingeschalten ist. Beispiel:

anyOutputOn(1,2,3,4,5,6);
> 0

onInputOn, onInputOff

function onInputNOff {}
function onInputNOn {}
function onInputN {}

onInputN wird aufgerufen, wenn sich der logische Zustand des Eingangs ändert. Bei einem Taster ist dies analog zu einem kurzen Tasterdruck. N wird dabei durch den entsprechenden Eingang ersetzt.

onInputNOff wird aufgerufen, wenn sich der logische Zustand des Eingangs auf 0 ändert. onInputNOn wird aufgerufen, wenn sich der logische Zustand des Eingangs auf 1 ändert.

Beispiel: Prüft, ob einer der Lichtkreise der Tafel an ist. Wenn ja, schalte alle Lichtkreise der Tafel aus. Wenn nein, schalte alle Lichtkreise der Tafel an.

function onInput1 { z=anyOutputOn(5,6,7,11,12,13); setOutputState(5, !z); setOutputState(6, !z);
setOutputState(7, !z); setOutputState(11, !z); setOutputState(12, !z); setOutputState(13, !z);}

Kurzform:

function onInput1 { z=aoo(5,6,7,11,12,13); sos(5, !z); sos(6, !z);sos(7, !z); sos(11, !z); sos(12, !z); sos(13, !z);}

Tests des Prototypboards

Status	Titel	Beschreibung	Bearbeiter	Letzte Änderung
	Relais-Ausgänge
	DS1307 RTC
	24FC1024 I²C EEPROM
	Eingänge
	DMX IN
	DMX OUT