Kernel DMXC3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(4 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Manual Header
{{Manual Header
| Type = DMXC3 Main-Software
| Type = DMXC3 Main-Software
| Version = 3.3.0}}
| Version = 3.3.1}}




Der {{Manual Windowcaption|Kernel}} von DMXControl 3 der Teil der Software, welcher für die eigentliche Berechnung aller Effekte verantwortlich ist und die Kommunikation mit den angeschlossenen Interfaces übernimmt.
Der {{Manual Windowcaption|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 {{Manual Windowcaption|Kernel}} ist als Konsolenanwendung<ref>Ausführliche Beschreibung und Funktionsweise einer Konsolenanwendung: https://de.wikipedia.org/wiki/Konsolenanwendung</ref> konzipiert und besitzt daher keine klassische Bedienoberfläche.


{{Bild_mit_Unterschrift|DMXC3_Manual Kernel_Window_after_start.png|1|Kernel von DMXControl 3 nach dem Start.|800px}}
{{Bild_mit_Unterschrift|DMXC3_Manual Kernel_Window_after_start.png|1|Kernel von DMXControl 3 nach dem Start.|800px}}
Zeile 11: Zeile 11:
Der {{Manual Windowcaption|Kernel}} ist für die eigentliche Berechnung aller Effekte verantwortlich und kommuniziert mit den angeschlossenen Interfaces.
Der {{Manual Windowcaption|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 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 über den Befehl {{Manual MenuText|Hilfe (Help)|Zeige Kernel (Show Kernel)}} anzeigen lassen. Beendet man die Bedienoberfläche, wird der Kernel ebenfalls heruntergefahren.
In der Regel arbeitet der Kernel für den Anwender nicht sichtbar im Hintergrund, wenn die {{Manual Windowcaption|[[GUI DMXC3|Bedienoberfläche (GUI)]]}}, der {{Manual Windowcaption|[[Umbra DMXC3|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 {{Manual MenuText|Kernel verstecken (Hide Kernel)}} betätigt. Beendet man die Bedienoberfläche, wird der Kernel ebenfalls heruntergefahren.
{{Manual Box | de | Hint | 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 getätigten Änderungen am Projekt gehen verloren.}}
{{Manual Box | de | Hint | 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 =
= Wichtige Merkmale =
Auch wenn das Fenster des Kernels die Möglichkeit bietet, dieses über den Beenden-Button zu schließen, wird von einem Gebrauch dieses Buttons grundsätzlich abgeraten. Der Kernel durchläuft für das Beenden verschiedene Prozesse, um beispielsweise die aktiven {{Manual Windowcaption|[[Cuelist DMXC3|Szenenlisten (Cuelists)]]}} zu beenden oder die DMX-Ausgabe abzuschalten und die Kommunikation mit den DMX-Interfaces zu beenden.
Der {{Manual Windowcaption|Kernel}} arbeitet als Konsolenanwendung, welche sowohl beim Starten auch beim Beenden verschiedene Prozesse durchläuft. Beim Beenden ist dies beispielsweise das Beenden der aktiven {{Manual Windowcaption|[[Cuelist DMXC3|Szenenlisten (Cuelists)]]}} und es wird die DMX-Ausgabe abgeschaltet und die Kommunikation mit den DMX-Interfaces beendet.
{{Manual Box | de | Hint | Um den Kernel ordnungsgemäß herunterzufahren und zu beenden, gibt man den Befehl <code>shutdown</code> als Kommando ein.}}
{{Manual Box | de | Hint | Um den Kernel ordnungsgemäß herunterzufahren und zu beenden, gibt man den Befehl <code>quit</code> oder <code>shutdown</code> als Kommando ein.}}


= Bedienelemente =
= Bedienelemente =
Der {{Manual Windowcaption|Kernel}} ist als Konsolenfenster konzipiert und verfügt deswegen über keine grafischen Bedienelemente. Die Steuerung des Kernels funktioniert daher ausschließlich über Kommandozeilenparameter.
Der {{Manual Windowcaption|Kernel}} ist als Konsolenanwendung konzipiert und verfügt deswegen über keine grafischen Bedienelemente. Die Steuerung des Kernels funktioniert daher ausschließlich über Kommandozeilenparameter.


== Komandozeilenparameter ==  
== 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.
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.


Zeile 48: Zeile 48:
| <code>width {Zeichenzahl}</code> || Legt die Breite der Konsole fest (Anzahl der Zeichen).
| <code>width {Zeichenzahl}</code> || Legt die Breite der Konsole fest (Anzahl der Zeichen).
|-
|-
| <code>load "{Dateipfad}"</code> || Lädt ein Projekt.
| <code>load "{PROJEKT-ID}#{VERSION}"</code> || Lädt ein Projekt.
|-
|-
| <code>save "{Dateipfad}"</code> || Sichert das aktuelle Projekt. || <code>'''save''' "C:\Users\Public\Documents\Mein Projekt.zip"</code>
| <code>save</code> || Sichert das aktuelle Projekt. || <code>'''save'''</code>
|-
|-
| <code>dmxout {DMX-Kanal, Wert}+</code> || Setzt DMX-Out-Werte.
| <code>dmxout {DMX-Kanal, Wert}+</code> || Setzt DMX-Out-Werte.
Zeile 86: Zeile 86:


= Nutzung =
= Nutzung =
== Aufgaben des Kernels ==
Bei der Nutzung von DMXControl 3 übernimmt der {{Manual Windowcaption|Kernel}} unter anderem folgende Aufgaben:
* Der Kernel rechnet die Werte für verschiedene Gerätefunktionen unter Berücksichtigung der Informationen aus den {{Manual Windowcaption|[[DDF DMXC3|DDFs]]}} in klassische DMX-Werte um, die in {{Manual Windowcaption|[[Cuelist DMXC3|Szenen (Cues)]]}} gespeichert sind und die über die zugehörigen {{Manual Windowcaption|[[Cuelist DMXC3|Szenenlisten]]}} ausgegeben werden sollen.
* Er übernimmt die Kommunikation mit den eingerichteten und aktivierten {{Manual Windowcaption|[[DMX-Interfaces DMXC3|DMX-Interfaces]]}} inklusive der Übermittlung der jeweiligen DMX-Werte.
* Im Kernel werden alle im {{Manual Windowcaption|[[Systemkonfiguration DMXC3|Arbeitsverzeichnis]]}} von DMXControl 3 abgelegten Projektdateien verwaltet.
* Der Kernel berechnet sämtliche Aktionen, die in einem Verbindungsset des {{Manual Windowcaption|[[Input Assignment DMXC3|Eingangszuweisung (Input Assignment)]]}} verknüpft wurden.
== Netzwerkkommunikation ==
== Netzwerkkommunikation ==
Damit der getrennte Betrieb von {{Manual Windowcaption|[[GUI DMXC3|Bedienoberfläche]]}} und {{Manual Windowcaption|Kernel}} auf unterschiedlichen PCs funktioniert, sind folgende Voraussetzungen zu erfüllen:
Damit der getrennte Betrieb von {{Manual Windowcaption|[[GUI DMXC3|Bedienoberfläche]]}}, {{Manual Windowcaption|[[Umbra DMXC3|Umbra]]}} und {{Manual Windowcaption|Kernel}} auf unterschiedlichen PCs funktioniert, sind folgende Voraussetzungen zu erfüllen:
* Die Komponenten des DMXC3-Netzwerks müssen allesamt den PC erreichen können, auf dem der Umbra läuft. Dies kann mittels des Pings geprüft werden, gerade wenn ein komplexeres Setup aufgebaut werden soll.
* 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 Komponenten im DMX3-Netzwerk aufgebaut werden kann, müssen in der Firewall die unten stehenden Ports<ref>Liste der standardisierten Netzwerk-Ports (englisch): https://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers</ref> freigegeben in der Firewall werden. Üblicherweise fragt die Firewall dies beim ersten Start ab und trägt diese dann automatisch ein.
* Damit die Kommunikation zwischen den Programmteilen im DMX3-Netzwerk aufgebaut werden kann, müssen in der Firewall die unten stehenden Ports<ref>Liste der standardisierten Netzwerk-Ports (englisch): https://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers</ref> 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 {{Manual Windowcaption|[[Network ID DMXC3|Netzwerk-ID (Network ID)]]}} hinterlegt sein. Fallen diese unterschiedlich aus, findet kein (automatischer) Verbindungsaufbau statt.


{| class="wikitable"
{| class="wikitable"
Zeile 137: Zeile 145:
|-
|-
| <code>ApplicationConfig.xml</code> || Beinhaltet die allgemeinen Programmeinstellungen von DMXControl 3. || || {{Nein}}
| <code>ApplicationConfig.xml</code> || Beinhaltet die allgemeinen Programmeinstellungen von DMXControl 3. || || {{Nein}}
<!--|-
| <code>DefaultProject.zip</code> || Lädt ein eigenes Standard-Projekt. || Das Standard-Projekt (Default Project) kann sowohl eine grundlegende Konfiguration zum Beispiel im Bereich Softdesk und Input Assignment enthalten, als auch eine vollständige Show umfassen. || {{Ja}}-->
|-
|-
| <code>DMXInterfaceConfig.xml</code> || Speichert die Einstellungen der eingebundenen DMX-Interfaces ab. || || {{Nein}}
| <code>DMXInterfaceConfig.xml</code> || Speichert die Einstellungen der eingebundenen DMX-Interfaces ab. || || {{Nein}}
Zeile 159: Zeile 165:
[[Kategorie: GUI en DMXC3]]
[[Kategorie: GUI en DMXC3]]
</noinclude>
</noinclude>
[[en: Kernel_DMXC3]]

Aktuelle Version vom 8. Januar 2026, 09:28 Uhr

Books.png Artikel beschreibt
DMXControl 3.3.1
Stand: 08.01.2026
Kernel DMXC3
Inhaltsverzeichnis

A

B

C

D

E

F

G

H

K

L

M

N

O

P

R

S

T

U


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.
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.

Wichtiger Hinweis 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.

Wichtiger Hinweis 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.
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.


Wichtiger Hinweis 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

DMXC3 Icon V-Collection redo.png 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.

DMXC3 Icon V-Collection redo.png 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.

Wichtiger Hinweis 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 Nein
DMXInterfaceConfig.xml Speichert die Einstellungen der eingebundenen DMX-Interfaces ab. Nein Nein
GoboCorrelations_GPU.csv Sichert das Ergebnis der Gobo-Korrelation. Nein Nein
KernelPluginConfig.xml Speichert den Status von Plugins. Nein Nein
SavedAttachables.xml In dieser Datei sind alle Effekte aus dem Reiter Gespeicherte Effekte (Saved Effects) ablegt. Nein Nein
Statistics.xml Diese Datei zeichnet die Laufzeit der letzten 100 Sitzungen sowie die Summe der ausgegebenen DMX-Werte auf. Nein Nein

Links und Referenzen

Weiterführende Informationen

  1. Ausführliche Beschreibung und Funktionsweise einer Konsolenanwendung: https://de.wikipedia.org/wiki/Konsolenanwendung
  2. Liste der standardisierten Netzwerk-Ports (englisch): https://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers