Der Kernel von DMXControl 3 ist der Programmteil der Software, welcher für die eigentliche Berechnung aller Effekte verantwortlich ist und die Kommunikation mit den angeschlossenen Interfaces übernimmt. Der Kernel ist als Konsolenanwendung[1] konzipiert und besitzt daher keine klassische Bedienoberfläche.
|
| Abbildung 1: Kernel von DMXControl 3 nach dem Start. |
Überblick
Der Kernel ist für die eigentliche Berechnung aller Effekte verantwortlich und kommuniziert mit den angeschlossenen Interfaces.
In der Regel arbeitet der Kernel für den Anwender nicht sichtbar im Hintergrund, wenn die Bedienoberfläche (GUI), der Umbra und der Kernel wie bei der Nutzung von DMXControl 3 auf einem PC größtenteils üblich, gemeinsam gestartet wurden. Man kann sich den Kernel aber auf Wunsch mit Hilfe des Launcher anzeigen lassen, wenn man dort den Umschalter für « Kernel verstecken (Hide Kernel) » betätigt. Beendet man die Bedienoberfläche, wird der Kernel ebenfalls heruntergefahren.
|
Der Kernel darf zu keinen Zeitpunkt beendet werden, wenn eine Show läuft. Beendet man den Kernel vorzeitig, werden keine DMX-Werte mehr ausgegeben und alle bis dahin ungesicherten Änderungen am Projekt gehen verloren. |
Wichtige Merkmale
Der Kernel arbeitet als Konsolenanwendung, welche sowohl beim Starten auch beim Beenden verschiedene Prozesse durchläuft. Beim Beenden ist dies beispielsweise das Beenden der aktiven Szenenlisten (Cuelists) und es wird die DMX-Ausgabe abgeschaltet und die Kommunikation mit den DMX-Interfaces beendet.
|
|
Um den Kernel ordnungsgemäß herunterzufahren und zu beenden, gibt man den Befehl quit oder shutdown als Kommando ein.
|
Bedienelemente
Der Kernel ist als Konsolenanwendung konzipiert und verfügt deswegen über keine grafischen Bedienelemente. Die Steuerung des Kernels funktioniert daher ausschließlich über Kommandozeilenparameter.
Kommandozeilenparameter
Der Kernel kann über folgende Kommandozeilenbefehle um genauere Informationen angesprochen werden, um mehr über den Status des Kernels zu erfahren. Auch sind einfache Tests möglich. Eine deutsche Übersetzung bzw. deutsche Kommandozeilenparameter gibt es hier nicht.
|
| Abbildung 2: Kommandozeilenparameter des Kernels. |
| Befehl | Beschreibung | Beispiel |
|---|---|---|
| Gruppe 1: Hauptmenü | ||
shutdown oder Strg + C |
Beendet den Kernel. | |
status |
Zeigt Statusinformationen an. | |
menu |
Zugang zum Kontrollmenü. | |
clear |
Leert die Konsole. | |
notification {message} |
Sendet eine Benachrichtigung {message} an alle Clients. |
notification Bitte das Projekt sichern!
|
notify {sessionNames} {message} |
Sendet eine Benachrichtigung {message} an ausgewählte Clients {sessionNames}. |
notify LICHT-PC1 Bitte das Projekt sichern!
|
mixerdump |
Speichert die aktuellen Informationen des Mixers in eine Protokolldatei (Log file). | |
width {Zeichenzahl} |
Legt die Breite der Konsole fest (Anzahl der Zeichen). | |
load "{PROJEKT-ID}#{VERSION}" |
Lädt ein Projekt. | |
save |
Sichert das aktuelle Projekt. | save
|
dmxout {DMX-Kanal, Wert}+ |
Setzt DMX-Out-Werte. | |
dmxin {DMX-Kanal, Wert}+ |
Setzt DMX-In-Werte. | |
help |
Hilfemenü aufrufen (auch über ? erreichbar).
| |
| Gruppe 2: Menü | ||
1 |
Menü zur Steuerung von DMX-Kanälen. | |
2 |
Menü zur Steuerung der RDM-Funktionen. | |
3 |
Informationen zur DMX-Ausgabe (DMX-Output). | |
4 |
Informationen zum Lastmanagement (Electricity). | |
5 |
Informationen zum Bereich Eingänge zuweisen (Input Assignment). | |
6 |
Allgemeine Monitoring-Informationen. | |
7 |
Informationen zu den verfügbaren Plugins in DMXControl 3. | |
8 |
Informationen zum Property Value Mixer. | |
9 |
Informationen zu den aktuellen Verbindungen (Sessions). | |
10 |
||
11 |
Informationen zu den aktiven Managern und Services. | |
|
|
Enthält ein eingegebener Pfad Leerzeichen, so sind die Anführungszeichen zwingend notwendig. |
Nutzung
Aufgaben des Kernels
Bei der Nutzung von DMXControl 3 übernimmt der Kernel unter anderem folgende Aufgaben:
- Der Kernel rechnet die Werte für verschiedene Gerätefunktionen unter Berücksichtigung der Informationen aus den DDFs in klassische DMX-Werte um, die in Szenen (Cues) gespeichert sind und die über die zugehörigen Szenenlisten ausgegeben werden sollen.
- Er übernimmt die Kommunikation mit den eingerichteten und aktivierten DMX-Interfaces inklusive der Übermittlung der jeweiligen DMX-Werte.
- Im Kernel werden alle im Arbeitsverzeichnis von DMXControl 3 abgelegten Projektdateien verwaltet.
- Der Kernel berechnet sämtliche Aktionen, die in einem Verbindungsset des Eingangszuweisung (Input Assignment) verknüpft wurden.
Netzwerkkommunikation
Damit der getrennte Betrieb von Bedienoberfläche, Umbra und Kernel auf unterschiedlichen PCs funktioniert, sind folgende Voraussetzungen zu erfüllen:
- Die Programmteile des DMXC3-Netzwerks müssen allesamt den PC erreichen können, auf dem der Umbra läuft. Dies kann mittels des Ping-Tests geprüft werden, gerade wenn ein komplexeres Setup aufgebaut werden soll.
- Damit die Kommunikation zwischen den Programmteilen im DMX3-Netzwerk aufgebaut werden kann, müssen in der Firewall die unten stehenden Ports[2] freigegeben in der Firewall werden. Üblicherweise fragt die Firewall dies beim ersten Start ab und trägt diese dann automatisch ein.
- Es muss bei allen Programmteilen die gleiche Netzwerk-ID (Network ID) hinterlegt sein. Fallen diese unterschiedlich aus, findet kein (automatischer) Verbindungsaufbau statt.
| Port | TCP | UDP | Beschreibung |
|---|---|---|---|
| 17474 | Inoffiziell | DMXControl 3 Network Discovery | |
| 17475 | Inoffiziell | DMXControl 3 Network Broker | |
Weitere Informationen zum Arbeiten mit DMXControl 3 auf mehreren PCs sind im Artikel Netzwerk-Konzept beschrieben.
Startparameter
Startparameter gibt man in der Regel einer Verknüpfung mit, um eine Anwendung zu starten. Um dem Kernel einen Startparameter zu übergeben, legt man eine neue Verknüpfung zur Anwendung und passt in den Eigenschaften das Feld für das Ziel an. Standardmäßig steht in diesem Feld nur der vollständige Pfad zur Anwendung, wie zum Beispiel:
"C:\Program Files (x86)\DMXControl Projects\DMXControl 3.3.0\Kernel\Lumos.exe"
Wichtig hierbei ist, dass der gesamte Pfad in Anführungszeichen gesetzt ist. Die zugelassenen Startparameter hängt dann sukzessive hinter dem Pfad zur Anwendung an, wobei dem Schlüsselwort immer zwei Minus-Zeichen vorangestellt ist. Um daher beispielsweise beim Start des Kernels direkt ein bestimmtes Projekt zu laden, sieht der vollständige Eintrag wie folgt aus:
"C:\Program Files (x86)\DMXControl Projects\DMXControl 3.3.0\Kernel\Lumos.exe" --load "{PROJEKT-ID}#{VERSION}""
Hinter dem Schlüsselwort --load folgt in Anführungszeichen die interne ID des Projekts. Auf Wunsch wird dieses noch um die Version des Projekt ergänzt, wobei der Versionsnummer ein # voranzustellen ist. Die Angabe des Namens des Projekt ist nicht möglich.
Weitere Hinweise zur Einrichtung eines automatischen Starts von DMXControl 3 verbunden mit dem direkten Laden eines bestimmten Projekts sind im Artikel zum Systemkonfiguration aufgeführt.
|
|
Die Projekt "{PROJEKT-ID"} ist aktuell nur im Konfigurations-Verzeichnis des Kernels zu finden, wo die Projekte zentral abgelegt und verwaltet werden. |
Es sind pro Verknüpfung beliebig viele Startparameter zulässig, welche in der nachfolgenden Tabelle aufgeführt sind.
| Parameter | Beschreibung | Beispiel |
|---|---|---|
--hidden |
Der Kernel wird versteckt im Hintergrund ausgeführt und ist nicht in der Taskleiste sichtbar. | |
--nonetwork |
Die Netzwerkfunktionalität bleibt deaktiviert, wodurch später in der GUI der Eintrag « Connection » in der Menüleiste des Hauptfensters nicht angezeigt wird. Der nonetwork-Modus kann dann genutzt werden, wenn Kernel und GUI auf dem selben PC arbeiten. | |
--load |
Durch das Angeben der ID eines Projekt und ggf. auch einer Versionsnummer wird der Kernel mit dem Start direkt ein bestimmtes Projekt laden. | --load "{PROJEKT-ID}#{VERSION}"
|
Konfigurations-Verzeichnis
Im Windows Explorer existiert nach dem erstmaligen Start des Kernels ein Verzeichnis, in dem verschiedene Einstellungen abgelegt werden. Standardmäßig befindet sich das Verzeichnis unter "C:\Users\{BENUTZERNAME}\AppData\Roaming\DMXControl Projects e.V\DMXControl\Kernel\Config", wobei "{BENUTZERNAME}" durch den Namen des aktuellen Benutzers des PCs zu ersetzen ist. Alternativ kann man das Verzeichnis auch über "%AppData%\Roaming\DMXControl Projects e.V.\Kernel\Config" erreichen.
| Datei | Beschreibung | Beispiel | Optional |
|---|---|---|---|
ApplicationConfig.xml |
Beinhaltet die allgemeinen Programmeinstellungen von DMXControl 3. |  Nein
| |
DMXInterfaceConfig.xml |
Speichert die Einstellungen der eingebundenen DMX-Interfaces ab. | Nein
| |
GoboCorrelations_GPU.csv |
Sichert das Ergebnis der Gobo-Korrelation. | Nein
| |
KernelPluginConfig.xml |
Speichert den Status von Plugins. | Nein
| |
SavedAttachables.xml |
In dieser Datei sind alle Effekte aus dem Reiter Gespeicherte Effekte (Saved Effects) ablegt. | Nein
| |
Statistics.xml |
Diese Datei zeichnet die Laufzeit der letzten 100 Sitzungen sowie die Summe der ausgegebenen DMX-Werte auf. | Nein
|
Links und Referenzen
Weiterführende Informationen
- ↑ Ausführliche Beschreibung und Funktionsweise einer Konsolenanwendung: https://de.wikipedia.org/wiki/Konsolenanwendung
- ↑ Liste der standardisierten Netzwerk-Ports (englisch): https://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers