OpenDCC Dokumentation: Trainprogrammer, DMXcomposer und tp2csv

    Die Erweiterung von TrainProgrammer erfolgt über zwei Programme:
  • Die Simulation: DMXcomposer
  • Das Verbindungsglied: tp2csv.dll

    • Wenn in Trainprogrammer bei einer CV 'Dialogerweiterung' als Eingabeparameter angegeben ist, dann wird tp2csv.dll (das ist der eingetragene Name der Dialogerweiterung) aufgerufen. Dieses Programm kontrolliert an seinen zugewiesen Inputfile, ob aus der Simulation neue Daten verfügbar sind (durch periodes Abprüfen) und übergibt die Daten dann TrainProgrammer.

DMXcomposer

    DMXcomposer.exe legt seine Daten per default im Verzeichnis %APPDATA%\Wilhelm_Kurz\DMXcomposer ab. %APPDATA% ist der von Windows vorgebene Pfad zu den Anwendungsdaten und zeigt normalerweise auf c:\Dokumente und Einstellungen\USER\Anwendungsdaten . Wird ein individueller Pfad angegeben (z.B. per command line oder per .ini), so legt DMXcomposer die Daten dort ab. Wenn eine relative Pfadangabe verwendet wird, erfolgt die Ablage relativ zu diesem Ordner.

    Das Programm kann auch über die Kommandozeile parametrisiert werden. Mit -? wird eine MessageBox angezeigt (s. unten). Mit -i kann ein anderes ini-File angegeben werden. Hinweis: Die Parameter müssen nicht verändert, die Angabe erfolgt hier nur zur Dokumentation.

    Aufrufparameter von DMXcomposer.exe
    -a HardwareStartAddress
    -c MaxChannels
    -d MinDeviation
    -e InitialNumberOfChannels
    -f HardwareFile
    -i IniFile
    -l ESIZE_DMXCTRL
    -m ImportFile
    -o ESIZE_DMXMACRO
    -p MaxPoints
    -q MaxSceneryPoints
    -s Separator
    -t ESIZE_MACROLIST

tp2csv.dll

    TP2csv.dll ist eine einfache Erweiterung, welche aus TrainProgrammer in eine komma-separierte Liste (CSV) Daten exportiert oder importiert. In einer solchen Liste steht in jeder Zeile ein Paar aus CV-Adresse und CV-Daten, durch Komma getrennt. Damit kann dann TrainProgrammer quasi mit jeder beliebigen Datenquelle zusammengekoppelt werden.
    DMXcomposer ist eine mögliche solche Quelle, man kann solche CV Listen aber auch z.B. aus Excel schreiben. tp2csv.dll kann über die Eingabezeile des TrainProgrammer parametrisiert werden. Die Parameterzeile darf bis 255 Zeichen lang sein. -? öffnet einen Dialog mit Hinweisen (s. unten), mit -i kann man ein anderes ini-File angeben. Alle Pfadangaben, sofern sie keinen Laufwerksbuchstaben enthalten, sind relativ zum Anwendungsverzeichnis C:\Dokumente und Einstellungen\USER\Anwendungsdaten\Wilhelm_Kurz\TP2CSV zu verstehen. (Hinweis: dieses Verzeichnis Anwendungsdaten ist normalerweise unsichtbar.)
    Mit -f ..\DMXcomposer\HwData.csv kann man z.B. das Exportfile von DMXcomposer auswählen.
    Aufrufparameter von tp2csv.dll
    -i Ini file
    -f Import file
    -x Export file
    -p Poll period [s]
    -a Export start address
    -r Export address range
    -s Export separator
    -? This help text