====== BiDiB-Wizard ====== {{:wizard:bidibwizard_guipic.jpg?direct |}}Der BiDiB-Wizard ist ein Programm zur Anzeige und Konfiguration der angeschlossenen Baugruppen (Knoten) in der BiDiB-Bus-Struktur, sowie zum einfachen Steuern von Loks mittels integriertem Fahrpult oder z.B. WLAN-Maus oder Z21-App. Der BiDiB-Wizard ist ein Java-Programm und dadurch unter Windows, Linux und MacOS lauffähig. Er setzt eine installierte Java Installation (aktuelle Java 17 Runtime, siehe Link unten) voraus. ---- ===== System Anforderungen ===== **BiDiB-Wizard mit Version 1.13** * Java (mindestens 1.8, besser Java 11 oder 17), Unter MacOS mindestens Java 11, besser Java 17 * getestet mit Linux (x86 und ARM), Win10, MacOS **BiDiB-Wizard mit Version ab 2.0** * Java (mindestens Java 11), besser Java 17 * getestet mit Linux (x86 und ARM), Win10, MacOS ===== Download ===== ==== Wizard 2.0 ==== Der **Wizard 2.0.20** kann von hier heruntergeladen werden: [[https://www.fichtelbahn.de/files/wizard-fw/bidibwizard-installer-2.0.21.jar|BiDiB-Wizard-2.0.21 Installation]] \\ Für die Installation unter MacOSX steht ein DMG zur Verfügung: [[https://www.fichtelbahn.de/files/wizard-fw/BiDiB-Wizard-2.0.21-6523.dmg|BiDiB-Wizard-2.0.21 DMG]] Beim Download auf dem Mac wird das "Quarantine"-Flag gesetzt und der BiDiB-Wizard aus dem DMG kann nicht gestartet werden.\\ \\ Deshalb muss das "Quarantine"-Flag entfernt werden. Dazu ein Terminal-Fenster öffnen im Verzeichnis wo das DMG heruntergeladen wurde und den folgenden Befehl ausführen: sudo xattr -r -d com.apple.quarantine BiDiB-Wizard-2.0.18-6377.dmg Man kann auch das Terminal-Fenster öffnen, den Befehl ''sudo xattr -r -d com.apple.quarantine '' eingeben (Leerzeichen am Ende beachten) und das DMG aus dem Finder ins Terminal-Fenster ziehen. Anschliessend mit ''Enter'' den Befehl ausführen. ==== Wizard 1.13 (Legacy) ==== Die aktuelle Version vom BiDiB-Wizard 1.13 ist der **Wizard-1.13.22** vom 14.12.2023. Diese Version ist veraltet und sollte nicht mehr eingesetzt werden. \\ Der BiDiB-Wizard kann von hier heruntergeladen werden: [[https://www.fichtelbahn.de/files/wizard-fw/bidibwizard-installer-1.13.22.jar|Wizard-1.13.22 Installation]] \\ Für die Installation unter MacOSX steht ein DMG zur Verfügung: [[https://www.fichtelbahn.de/files/wizard-fw/BiDiB-Wizard-1.13.22-4619.dmg|Wizard-1.13.22 DMG]] Die Weiterentwicklung wird im BiDiB-Wizard 2 fortgesetzt. \\ \\ Anwender welche die neue Baugruppe **ReadyServoTurn** benutzen, bitte den Wizard 2 installieren. Bitte für den aktuellen BiDiB-Wizard die Java Version 11 oder 17 verwenden. \\ Links siehe nachfolgend. **Empfohlene Java-Implementierung:** \\ Link zum Java-Download: [[https://bell-sw.com/pages/downloads/#/java-17-lts%20/%20current|Bellsoft Liberica]] Direkter Link zum Download des Installer für Windows **64-bit**: [[https://download.bell-sw.com/java/17.0.9+11/bellsoft-jre17.0.9+11-windows-amd64.msi|Bellsoft Liberica JRE17 (17.0.9)]]\\ Direkter Link zum Download des Installer für Windows **32-bit**: [[https://download.bell-sw.com/java/17.0.9+11/bellsoft-jre17.0.9+11-windows-i586.msi|Bellsoft Liberica JRE17 (17.0.9)]] ==== Automatische Anzeige USB Port ==== Der BiDiB-Wizard bringt Unterstützung für mehrere //Serielle Port Treiber// mit. Je nach Betriebssytem kann der eine oder andere Treiber Vorteile haben. Diese //Seriellen Port Treiber// benötigen alle einen korrekt installierten nativen Treiber (z.B. FTDI). Alle Treiber die zur Auswahl stehen werden komplett mitgeliefert, d.h. es muss keine separate Installation erfolgen. Unter **Windows 10 64-bit muss eine 64-bit JVM installiert** und verwendet werden. :!: Falls keine COM-Ports angezeigt werden oder das Fenster mit dem COM-Port nicht erscheint müssen vermutlich die "Visual C++ Redistributable für Visual Studio" installiert werden (Google nach: "vcredist_x64.exe 2013" oder https://support.microsoft.com/de-de/help/4032938/update-for-visual-c-2013-redistributable-package). Die **deutsche Version für Windows 10 64-bit** kann [[https://www.fichtelbahn.de/files/wizard-fw/vcredist/vcredist_x64-deu-2013.exe|auch von hier]] heruntergeladen werden. Die **deutsche Version für Windows 10 32-bit** kann [[https://www.fichtelbahn.de/files/wizard-fw/vcredist/vcredist_x86-deu-2013.exe|auch von hier]] heruntergeladen werden. Unter **Windows 10 64-bit** muss sowohl die 64-bit Version wie auch die 32-bit Version der "Visual C++ Redistributable für Visual Studio" installiert werden ([[https://support.native-instruments.com/hc/de/articles/209571689-Windows-Fehlermeldung-MSVCP120-dll-fehlt-Windows-|Quelle]]). Siehe auch [[wizard#usb_hot-plug|USB hotplug]]. ==== Migration BiDiB-Wizard 1.12 auf 1.13 ==== :!: Der Wizard 1.12 verwendet standardmässig ein anderes Format für den Knoten-Export und Import. Man kann das in den Einstellungen > Experimentelle Eigenschaften > Java-Serialisierung für Knotenexport verwenden auf das alte Format umschalten. Anschliessend den Wizard neu starten. Bitte neue Knoten-Export nur noch mit dem neuen Format (*.nodex) erstellen! Die Unterstützung für das alte Format wird in einem nächsten Release komplett entfernt. :!: Im Wizard-1.9 wurde das **Datenformat der Bezeichnungen für Ports, Makros und Accessories geändert**! Aus diesem Grund werden die alten Bezeichnungen beim 1. Zugriff mit einer 1.9-er Version automatisch in das neue Format migriert. Die alten Dateien mit den Bezeichnungen werden nicht gelöscht und sind immer noch vorhanden für Versionen < 1.9. Anpassungen der Bezeichnungen in der 1.9-er Version sind aber beim Wizard-1.8 nicht sichtbar, ebenso sind Anpassungen der Bezeichnungen in der 1.8-er anschließend in der 1.9-Version nicht sichtbar wenn die Migration schon durchgelaufen ist! Um die **Migration erneut ausführen** zu lassen muss die Datei mit den entsprechenden Bezeichnungen gelöscht werden (Wizard beenden!), z.B. **LightPortLabels.labels** für Lichtports. Die Dateien liegen im Home-Verzeichnis des Benutzer unter dem Verzeichnis //.BiDiBWizard//, z.B. C:\Users\\.BiDiBWizard Wichtig ist die Datei mit der Endung **.labels** zu löschen und nicht die gleich lautende Datei mit dem Namen LightPortLabels aber ohne Extension. In diesem Fall sind alle bisher geänderten Bezeichnungen mit dem Wizard-1.9 verloren! Falls Bedarf besteht beide Bezeichnungen weiterhin zu behalten, bitte bei mir (andreas.kuhtz@gmail.com) melden bevor die Dateien gelöscht werden. :!: Ab Build 2320 wurde das Format für das lokale Speichern der Bezeichnungen (Labels) angepasst. Beim ersten Start erfolgt automatisch eine Migration in das neue Format. Die Dateien des neuen Format liegen unter //.bidib/labels// und haben das Namensformat //.xml//. Während der Migration erscheint der folgende Dialog, falls die Bezeichnungen nicht im Standard-Verzeichnis gefunden wurden. {{ :wizard:wizard-migration-dialog.png |}} ===== Entwicklungsstand ===== ** Download Entwicklungsstand ** Der aktuelle Entwicklungsstand (Update: 25.01.2023, Build 4613, master) vom //​BiDiB-Wizard-1.13//​ kann hier heruntergeladen werden [[https://www.fichtelbahn.de/files/wizard-fw/dev/bidibwizard-installer-1.13-20230125.195916-256.jar]] DMG Image: [[https://www.fichtelbahn.de/files/wizard-fw/dev/BiDiB-Wizard-1.13-SNAPSHOT-4613.dmg|BiDiB-Wizard-1.13-SNAPSHOT-4613]] * Ab Build 3016: Die zusätzliche Komponente BiDiB-Wizard-Spy unter Windows muss nicht installiert werden! ---- ===== Installation ===== Die Installation des BiDiB-Wizard erfolgt über ein "executable-Jar" welches im Normalfall unter Windows per Doppelklick gestartet werden kann, wenn eine //Java 8-Runtime// (oder neuer) installiert ist. Sollte die Verknüpfung für Jar-Files durch ein anderes Tool verändert worden sein (z.B. 7-zip), hilft folgendes Kommando auf dem Command-Prompt: ''java -jar bidibwizard-installer-1.x.jar'' Hinweis: Der Name //bidibwizard-installer-1.x.jar// muss dem tatsächlichen Namen des Installer-jar angepasst werden. Falls mehrere Versionen des BiDiB-Wizard parallel installiert werden sollen, kann während der Installation der Pfad und der Menü-Name angepasst werden. In den nachfolgenden Abbildungen wurde der Standardwert //BiDiB-Wizard// jeweils in //BiDiB-Wizard-1.6.0// geändert. {{:wizard:bidib-wizard-installer-installationpath.png?300|}} {{:wizard:bidib-wizard-installer-menue.png?300|}} Nach der Installation kann der BiDiB-Wizard über das Menü gestartet werden. Bevor erstmalig eine Verbindung zum Master erstellt werden kann, muss der verwendete Port über **Bearbeiten > Einstellungen** ausgewählt werden (USB-Verbindung zum GBMboost muss eingesteckt sein). Anschließend kann die Verbindung über **Datei > Verbinden** oder über den Connect-Button hergestellt werden. Sobald die Verbindung zum Master steht, werden alle Knoten gelesen und in einer Baumstruktur dargestellt. ==== Sprache ändern ==== Die Sprache des Wizard kann wie folgt geändert werden: * Unter Windows: Im Installations-Verzeichnis vom Wizard gibt es die Datei BiDiB-Wizard.l4j.ini. * Unter Linux: Es gibt ein bash-Script welches den Wizard startet. \\ Der folgende Parameter bestimmt die Sprache: '' -Duser.language=de '' Wenn man für ''-Duser.language=en'' angibt wird der Wizard in Englisch gestartet. ==== Installation auf Raspi 3 ==== Auf dem Raspberry Pi funktioniert die Installation über Doppelklick nicht. Um den Wizard zu installieren muss ein Terminalfenster in dem Verzeichnis geöffnet werden wo das Installer-Jar liegt. {{ :wizard:step01.png |}} Mit dem Befehl ''ls'' kann man die Dateien im Verzeichnis anzeigen lassen. Um die installierte Java-Version anzuzeigen, kann der Befehl ''java -version'' verwendet werden. Aktuell wird eine Java 8 Version benötigt. Ob das Terminal-Fenster im richtigen Verzeichnis geöffnet wurde, lässt sich mit dem Befehl ''pwd'' ermitteln, welcher das aktuelle Verzeichnis ausgibt. Um in ein anderes Verzeichnis zu wechseln kann der Befehl ''cd '' verwendet werden, also z.B. ''cd Downloads'' um ins Unterverzeichnis //Downloads// zu wechseln. {{ :wizard:step02.png |}} Mit dem Befehl ''java -jar bidibwizard-installer-1.9-20180311.084611-1233.jar'' kann der Installer für den Wizard gestartet werden. Der Name der Datei ''bidibwizard-installer-1.9-....jar'' im Beispiel muss an den richtigen angepasst werden. {{ :wizard:step03.png |}} ==== Update Java auf Raspi ==== Grundsätzlich sollte der Wizard mit jeder Java 8 Installation laufen. Falls ein Update auf eine aktuelle Java Version notwendig ist, kann ich diesen [[https://linoxide.com/debian/install-java-8-debian-gnulinux-9-stretch/|Blog]] empfehlen. Dort wird der Update der Java-Version auf dem Raspi beschrieben. Ich habe den Abschnitt "Installing Oracle Java" verwendet um meinen Raspi zu aktualisieren. ---- ==== DMX-Modeler ==== Zur Anleitung für den DMX-Modeler für die OneDMX gehts hier: [[wizard:DMXModeler|DMX Modeler]] ---- ===== Versionsübersicht ===== ==== Version 2.0 ==== Aktuelle Version * Unterstützung für ReadyServoTurn * Verbindung über FTDI-Treiber ==== Version 1.13 ==== Aktuelle Version vom BiDiB-Wizard 1. Die Weiterentwicklung wird im BiDiB-Wizard 2 fortgesetzt. * Altes Dateiformat für Import/Export der Knoten entfernt * Unterstützung für Multi-Cell-Mode der RF-Basis ===== Probleme und Fehler ===== Um Probleme und Fehler analysieren zu können werden meistens Logfiles benötigt, in welchen der BiDiB-Wizard während der Ausführung den Ablauf und Fehlermeldungen mit mehr Informationen protokolliert als auf der Benutzeroberfläche ausgegeben wird. Diese Dateien werden bei jedem Start überschrieben, weshalb es im Fehlerfall wichtig ist die Dateien zu kopieren bevor der BiDiB-Wizard erneut gestartet wird. ==== Logdateien ==== Die Logfiles BiDiBWizard.log und BiDiBWizard-RXTX.log liegen standardmäßig unter //C:\Users\\AppData\Local\Temp// (Siehe auch unter Menü //Bearbeiten > Einstellungen ... > Verzeichnis für Protokoll-Dateien//). Ab BiDiB-Wizard-1.7 können die 2 Logfiles auch über das Menü //Hilfe > Logdateien sammeln// in ein Verzeichnis freier Wahl kopiert werden. In den Einstellungen steht der Pfad zu den Protokolldateien (log-files). Unter Linux liegen diese standarmäßig unter ///tmp//. {{ :wizard:bidib-wizard-preferences-linux.png |}} {{ :wizard:wizard-preferences-windows.png |}} Ab dem Wizard Build 2841 gibt es zudem die Möglichkeit, das Logfile nicht mehr beim Start überschreiben zu lassen. Dadurch kann man im Fehlerfall die Daten nachträglich noch sammeln lassen. {{ :wizard:wizard-preferences-logfileappend.png |}} ==== Logdateien sammeln ==== Der Dialog zum Sammeln der Logdateien wird über das Menü **//Hilfe > Logdateien sammeln//** geöffnet. {{ :wizard:wizard-menu-help-collect-logfiles.png |}} Mit dem nachfolgenden Dialog kann das Ziel festgelegt werden, an welchen die Logdateien (BiDiBWizard.log und BiDiBWizard-RXTX.log) kopiert werden: {{ :wizard:bidib-wizard-logfiles-saveunder-linux.png |}} {{ :wizard:wizard-collect-logfiles.png |}} Anschließend befinden sich die Logdateien im ausgewählten Verzeichnis und können z.B. im Forum angehängt werden. Hinweis: Um Platz zu sparen bitte die Logdateien nach Möglichkeit in eine Zip-Datei verpacken bevor sie ins Forum gestellt werden. ---- ===== Verbindung einrichten ===== Um eine Verbindung auf den GBMBoost herzustellen, muss die serielle Schnittstelle (COM) ausgewählt werden. Unter Windows werden die verfügbaren Schnittstellen in der obersten Combobox angezeigt. Unter Linux muss der Symlink (z.B. /dev/ttyUSB0) im Eingabefeld Symlink eingegeben werden. {{ :wizard:wizard-preferences-1.13.13.png |}} Neben der Auswahl der Schnittstelle kann der verwendete Treiber für den Seriellen Port ausgewählt werden. Hier stehen "RXTX", "SCM" und "SPSW" zur Verfügung. Standardmässig wird RXTX verwendet. ==== SCM ==== Der "SCM"-Treiber sollte für folgende OS funktionieren: * Windows (32- und 64-bit) * Linux (32- und 64-bit, embedded) * MacOSX (32- und 64-bit) Unter Linux sind bisher folgende Probleme bekannt: * SCM kann nicht geladen werden weil //libudev.so.0// nicht vorhanden ist: Dieses Problem kann durch Einrichten eines Link (Adminrechte notwendig) behoben werden: ''ln -s /lib/x86_64-linux-gnu/libudev.so.1 /lib/x86_64-linux-gnu/libudev.so.0'' Quelle: http://askubuntu.com/questions/288821/how-do-i-resolve-a-cannot-open-shared-object-file-libudev-so-0-error 8-) Falls ein Anwender ein Problem mit SCM findet bitte im Forum melden. Danke! ==== Verbindung herstellen ==== Nach dem Speichern der Konfiguration kann die Verbindung zum GBMboost über den Toolbar-Button mit dem Stecker oder das Menü aufgebaut werden. Bei erfolgreichem Verbindungsaufbau wird der Master (hier GBMBoost) angezeigt und das CD-Icon (connected) in der Statuszeile wird rot dargestellt. {{ :wizard:wizard-connected.png |}} Falls der COM-Port nicht verfügbar ist, wird folgende Fehlermeldung angezeigt: {{ :wizard:wizard-no-comport.png |}} Falls der serielle Bootloader am GBMboost aktiviert ist (Jumper J3 geschlossen und Button gedrückt beim Start), wird folgende Fehlermeldung angezeigt: {{ :wizard:wizard-serial-bootloader-active.png |}} ==== USB Hot-plug ==== Ab Version 1.9 wird der USB-Controller überwacht. Sobald ein USB-gerät mit COM-Port eingesteckt wird, prüft der Wizard ob eine COM-Schnittstelle zugeordnet ist. Falls dies der Fall ist erscheint ein Hinweisdialog. Durch Klick auf das (kleine) Icon wird der Port als selektierter Port in den Settings eingetragen. {{ :wizard:wizard-select-usb-comport.png |}} Ab Build 2507 wird anschliessend automatisch die Verbindung zum Interface aufgebaut. :!: Falls das Fenster nicht erscheint müssen vermutlich die "Visual C++ Redistributable für Visual Studio" (Google nach: "vcredist_x64.exe 2013" oder https://support.microsoft.com/de-de/help/4032938/update-for-visual-c-2013-redistributable-package, Achtung: Für Windows passende 64-bit oder 32-bit Version downloaden) installiert werden. Die **deutsche Version für Windows 10 64-bit** kann [[http://www.fichtelbahn.de/files/wizard-fw/vcredist/vcredist_x64-deu-2013.exe|auch von hier]] heruntergeladen werden. Die **deutsche Version für Windows 10 32-bit** kann [[http://www.fichtelbahn.de/files/wizard-fw/vcredist/vcredist_x86-deu-2013.exe|auch von hier]] heruntergeladen werden. ---- ===== Command Line Argumente ===== Ab Build 2860 können folgende Command Line Argumente mitgegeben werden: * ''-autoconnect=true | false'' : Automatisches Verbinden zum Interface mit den Werten aus den Preferences * ''-startupmode=normal | iconified'' : //iconified// -> Die Wizard-Applikation wird minimiert gestartet (Windows: nur Button in Taskbar sichtbar) ---- ===== DEBUG-Mode ===== Wenn der GBMboost im DEBUG Mode gestartet wird, weil der Jumper0 oder das CV1 gsetzt ist, wird nach dem Programmstart folgende Meldung angezeigt. {{ :wizard:wizard-debug-interface-active.png |}} ---- ===== RXTXComm.jar in Java Extensions-Verzeichnis ===== Falls sich ein RXTXComm.jar im Java Extensions-Verzeichnis befindet, so führt dies u.U. zu Problemen beim Betrieb des Wizard. Wenn ein solches Problem erkannt wird folgender Fehlerdialog angezeigt: {{wizard:wizard-load-rxtx-failed.png}} In diesem Fall muss die RXTXComm.jar aus dem angezeigten Verzeichnis entfernt werden damit der Wizard korrekt arbeitet. ---- ===== Simulations-Modus ===== Der BiDiB-Wizard kann für Offline-Test in einem Simulations-Modus betrieben werden. Bei dieser Betriebsart werden Knoten simuliert und es erfolgt kein Zugriff auf das Interface des GBMboost. :!: Wenn der Simulations-Modus aktiv ist wird in der Toolbar ein "Werkzeugkasten" angezeigt und die Verbindungsanzeige in der Statusbar ist ausgegraut und mit dem Hinweis "Simulation" versehen. {{:wizard:wizard-simulation-mode.png|}} ----- ===== Knoten-Baum ===== Im Knoten-Baum werden die Knoten am BiDiB-Bus angezeigt. Jeder Knoten wird normalerweise mit einem grünen Kreis dargestellt. Knoten die Subknoten haben können werden mit einem zusätzlichen //+//-Zeichen dargestellt. Falls sich ein Knoten im Identifizierungs-Modus befindet, wird die Farbe des Kreis auf rot geändert. Der Identifizierungs-Modus kann entweder über das Kontext-Menü //Identifizieren// oder durch Drücken des Identifizierungs-Taster auf dem Knoten aktiviert/deaktiviert werden. {{ :wizard:wizard-node-ident-error.png |}} Das Knoten-Symbol mit einem Ausrufezeichen auf rotem Hintergrund wird angezeigt, falls ein Fehler vom Knoten geliefert wird. Wenn der Mauszeiger über das Symbol gefahren wird erscheint die Fehlermeldung als Tooltip. Über das Kontextmenü kann der Fehler quittiert werden. Falls durch eine Konfigurationsanpassung ein Knoten-Neustart erforderlich wird, erscheint das Knoten-Symbol wie nachfolgend dargestellt. {{ :wizard:wizard-node-restart-requested.png |}} Über das Kontext-Menü kann der Neustart ausgelöst werden. ==== Anzeige Knotenname ==== Wenn man dem Knoten einen Namen gibt, wird diese Information lokal gespeichert (\.bidib\labels) sowie auf den Knoten übertragen. Der Speicherplatz auf dem Knoten ist limitiert (i.A. 16-24 Zeichen) während lokal keine Begrenzung besteht. Wird eine Name eingegeben der länger ist als das was auf dem Knoten gespeichert werden kann, dann wird der Teil der zu lang ist im Wizard Knotenbaum blau dargestellt statt schwarz. Falls auf dem Knoten und lokal kein Name gespeichert ist, wird die UniqueID des Knoten im Knotenbaum blau dargestellt. ----- ==== Aufgaben-Liste ==== Ab Wizard 2.0.5 wird eine Aufgaben-Liste angezeigt, wenn ein Knoten z.B. Standard-Bezeichnungen hat, welche übernommen werden sollten. Die Aufgaben-Liste kann auch über das entsprechende Icon in der Toolbar geöffnet werden. {{ :wizard:taskliste.png | }} Durch Klick auf das Schraubenschlüssel-Icon in der Spalte Aktion wird ein Dialog mit der Aufgabe angezeigt. Ausgeführte Aufgaben werden automatisch aus der Aufgaben-Liste entfernt. Um einen Eintrag manuell zu löschen, wird das "X"-Icon verwendet. {{ :wizard:workitem-delete.png | }} ===== Features ändern ===== Um Features auf einem Knoten zu ändern, muss der Knoten selektiert sein. Dann über das Kontextmenü auf dem Knoten den Menüpunkt **Features ...** anwählen. Im Dialog werden anschliessend alle Features des Knoten angezeigt. {{ :wizard:wizard_featureschange_1.png |}} In der Spalte Wert kann der aktuelle Wert geändert werden. Durch Klick auf **Speichern** werden die angepassten Werte auf den Knoten übertragen. {{ :wizard:wizard_featureschange_2.png |}} ----- ===== Booster und Command Station ===== Ab Version 1.9 können der Booster und die CommandStation getrennt eingeschaltet werden. Nach dem Abschalten der Booster (z.B. über den Booster-Off-Button in der Toolbar) können die Booster über den Booster-Button //EIN// wieder einzeln eingeschaltet werden. Da aber die CommandStation (DCC-Generator) ebenfalls gestoppt wurde, schaltet sich der Booster nicht ein, weil das DCC-Signal fehlt. Durch Klick auf den Command Station Button //GO (mit Watchdog)// wird die Command Station gestartet und dadurch auch der Booster (wenn das Feature gesetzt ist). {{ :wizard:wizard-boostercs-on.png |}} ===== Booster Toolbar ===== Ab Version 1.10 ist die Booster-Toolbar erweitert um das Einschalten von der Zentrale und allen Boostern zu ermöglichen. {{ :wizard:step_00.png |}} * Wahlweise den Start der Zentrale mit oder ohne Watchdog wählen. * Wenn nur die Booster eingeschaltet werden sollen muss der //Weiter// Button gewählt werden. * Wenn die Booster und die //Zentrale// eingeschaltet werden sollen, muss der //Weiter Booster & Zentrale// Button gewählt werden. {{ :wizard:step_02a.png |}} Anschliessend werden in der Booster-Tabelle die Zustände der Zentrale und Booster automatisch aktualisiert. {{ :wizard:step_03a.png |}} ----- ===== Firmware Update ===== Über das Kontextmenü des Knoten kann der Firmware-Update-Dialog geöffnet werden, sofern der Knoten dieses Feature unterstützt. {{ :wizard:wizard-fw-update-menu.png |}} Im //Update firmware//-Dialog wird das Zip-File mit der Firmware für den Knoten ausgewählt. Anschliessend werden die verfügbaren Firmware-Pakete in einem Baum dargestellt. Falls im Firmware-Zip neue CV-Definitionen vorhanden sind, wird der folgende Dialog angezeigt. {{ :wizard:wizard-import-cv-definitionen.png |}} Aus den Paketen im Baum muss 1 Paket ausgewählt werden, welches anschliessend durch Klick auf den Button //Start// auf den Knoten übertragen wird. {{ :wizard:wizard-fw-update.jpg |}} Wenn der Firmware-Update beendet ist, wird der Dialog durch Klick auf //Schliessen// beendet und der Knoten wird neu gestartet. :!: Falls ein Knoten nach dem Update nicht mehr reagiert, muss die Baugruppe mit folgenden Schritten mit dem Bootloader gestartet werden: * Abstecken, Ausschalten. * ID-Taste drücken und halten. * Einschalten, jetzt erst loslassen. * Anstecken. * Die Baugruppe meldet sich als Bootloader. Jetzt kann man Firmware-Update machen. ===== Firmware Repository ===== Ab Wizard 2 ist der Zugriff auf das zentrale Firmware Repository eingebaut. Damit wird es möglich, die aktuell veröffentlichten Firmware-Updates vom Internet zu laden. Dazu muss in den ''Einstellungen'' > ''Firmware Repo'' die Option ''Remote-Repo Abfrage aktiviert'' selektiert werden. Wenn die Option ''Neue Firmware im Knotenbaum anzeigen'' aktiviert ist, werden neu verfügbare Firmware-Updates für den entsprechenden Knoten im Knotenbaum angezeigt. {{ :wizard:firmwareupdate:firmware-repo-settings.png?600 |}} Über den ''Firmware-Repo'' Button in der Toolbar kann die Firmware-Repo Ansicht geöffnet werden. {{ :wizard:firmwareupdate:firmware-repo-toolbar.png |}} Wenn die Firmware-Repo Ansicht geöffnet wird, erfolgt ein Zugriff auf das zentrale Firmware Repository und ein Abgleich mit den lokal vorhandenen Daten. Die Checkbox ''Nur neue Update im Online-Repo anzeigen'' erlaubt, nur neue oder geänderte Firmware-Updates anzuzeigen, die bisher noch nicht heruntergeladen wurden. Durch Klick auf den Download-Button werden alle selektierten (Checkbox in der ersten Spalte) Firmware-Updates heruntergeladen und lokal gespeichert. Um alle angezeigten Firmware-Updates für den Download zu selektieren, kann die Checkbox im Tabellenkopf verwendet werden. {{ :wizard:firmwareupdate:firmware-repo-download.png |}} Beim nächsten Verbinden mit dem BiDiB-System werden verfügbare Firmware-Updates bei den Knoten durch ein kleines Icon angezeigt. ==== Firmware Update über Repository ==== Nach dem Start des BiDiB-Wizard wird das zentrale Firmware-Repository auf neue Firmware geprüft. Falls neue Firmware gefunden wurde, wird dies nach dem Erstellen der Verbindung durch ein entsprechendes Icon im Knotenbaum angezeigt. Wenn der Knoten selektiert ist, wird der Update-Button im Info-Reiter aktiviert. {{ :wizard:firmwareupdate:firmware-update-open-dialog.png?800 |}} Beim Klick auf diesen Button wird der ''Firmware aktualisieren''-Dialog mit der bereits ausgewählten neuen Firmware angezeigt. Sollte die Firmware noch nicht im lokalen Repository vorhanden sein, erfolgt vor dem Download die folgende Abfrage: {{ :wizard:firmwareupdate:firmware-download-accept-dialog.png?600 |}} Bevor der Dialog für den Firmware-Update geöffnet wird erfolgt die Abfrage, ob der Knoten gesichert wurde. Diese Option kann durch den Anwender dauerhaft unterdrückt werden. {{ :wizard:firmwareupdate:firmware-update-backup-question.png?800 |}} Anschliessend wird der Firmware-Update Dialog geöffnet und das neue Firmware-Archiv ist bereits selektiert. Soll eine andere Firmware-Version geladen werden, kann diese aus der Combobox ''Repository'' ausgewählt werden oder das Firmware-Archiv direkt über den ''Auswählen''-Button bei Datei ausgewählt werden. Nach Auswahl des gewünschten Firmware-Paket wird der ''Start''-Button aktiviert und der Download kann gestartet werden. {{ :wizard:firmwareupdate:firmware-update-dialog.png?400 |}} ==== Download ==== Ab BiDiB-Wizard 2.0.6 wird angezeigt, wenn neue Firmware im zentralen Firmware Repository gefunden wurde. {{ :wizard:firmwareupdate:firmware-tasklist-00.png?400 |}} Durch Klick auf das Icon //Schraubenschlüssel// wird der Dialog angezeigt, über welchen der Download gestartet wird. {{ :wizard:firmwareupdate:firmware-tasklist-01.png?400 |}} {{ :wizard:firmwareupdate:firmware-tasklist-02.png?600 |}} Nach erfolgreichem Download der Firmware verschwindet der Eintrag in der Aufgabenliste und die Aufgabenliste kann geschlossen werden. ===== RX/TX-Log-Anzeige ===== Ab Version 1.7 gibt es einen integrierten Logviewer um den Meldungsverkehr zwischen dem BiDiB-Wizard und dem GBMBoost anzuzeigen. Über das Menü //Hilfe > RX/TX Log-Anzeige öffnen ...// kann das Fenster geöffnet werden. {{:wizard:wizard-rxtx-logviewer.png|}} ----- ===== Booster Tabelle ===== Ab Version 1.7 gibt es die Booster Tabelle welche den Zustand der Booster im BiDiB-System anzeigt. Über das Menü //Fenster > Booster Tabelle// kann das Fenster geöffnet werden. Die Booster Tabelle wird standardmässig nach dem Start eingeblendet. Dieses Verhalten kann über das Menü //Bearbeiten > Einstellungen > Checkbox "Booster-Tabelle standardmässig anzeigen"// deaktiviert werden. {{:wizard:wizard-boostertable.png|}} ----- ===== Lok / Car steuern ===== Einzelne Loks oder Cars können über die //Loksteuerung// gesteuert werden, welche über das Kontextmenü auf dem Zentralen-Knoten (Command Station) geöffnet werden kann. Bei Steuerung von Cars muss die BiDiB-RF-Basis ausgewählt werden und dort über das Kontextmenü der Dialog geöffnet werden. Nach der Eingabe der DCC-Adresse und der Auswahl der Fahrstufen kann die Geschwindigkeit über den Slider eingestellt werden. Eine zurückgemeldete Geschwindigkeit (Speed-Meldung vom Dekoder) wird unterhalb des Slider angezeigt. {{ :wizard:wizard-loco-dialog.png |}} Falls ein Dekoder einen Wert für "Behälter 1" mit der DYN_STATE-Meldung zurückliefert, wird dieser Wert in der Balkenanzeige am rechten Rand angezeigt. Ab **Wizard-1.11 Build 3473**: \\ Der Geschwindigkeitsregler unterstützt folgende Tasten-Aktionen wenn er selektiert ist: * ''%%Leertaste, Space%%'': Stop * ''%%Cursor-rechts/links%%'': Fahrstufe erhöhen/reduzieren * ''%%PageUp/PageDown%%'': Fahrstufe in grösseren Schritten erhöhen/reduzieren * ''%%Pos1/Ende%%'': max. Fahrstufe ===== DCC-Accessory-Decoder ===== Der BiDiB-Wizard bietet ab Version 1.7 Unterstützung für das Schalten von DCC-Accessory-Decodern (Schaltdecoder, z.B. OpenDecoder2) oder der Kehrschleifenmoduls des GBM16T an. {{wizard:wizard_open_dcc_accessory_controller.png?230 }} {{ wizard:wizard_dcc_accessory_controller.png }} :!: Die Adresse welche mit der Multimaus geschaltet wird ist um +1 verschoben zur Adresse, welche mit dem Wizard benutzt wird, z.B. Wizard/Monitor: 200 --> Multimaus 201 ----- ===== Der CV-Programmierer ===== Mit Hilfe es BiDiB-Wizard kann man über das Programmiergleis am GBMboost die DCC-Decoder auslesen und editieren. Eine ausführliche Erklärung zu dem Programmiergleis und dessen Warnhinweise finden Sie unter dem [[gbm:programmiergleis_gbm|Thema "GBM - Programmiergleis"]]. :!: Falls ein IF2 benutzt wird kann nur die Programmierung über Hauptgleis (POM) verwendet werden. Siehe dazu [[wizard#cv-programmierer_fuer_pom|POM]]. Klicken Sie auf den GBMboost Master in der Knotenliste und öffnen Sie mit einem rechtsklick den CV-Programmer für Lokdecoder (PT). {{ :wizard:gbmboost_proggleis_01.jpg?500 |}} Mit Hilfe eines Warnhinweises werden Sie darauf aufmerksam gemacht, dass mit dem GBMboost Master nur die programmierende Lok verbunden sein solle. Alle weiteren DCC-Decoder, müssen abgesteckt bzw. entfernt werden. Das betrifft auch die verbundenen BiDiB-Knoten die über den BiDiBus mit dem GBMboost in Verbindung stehen. Das kann durch das abstecken des Buskabels vom GBMboost Master erfolgen. Über das Programmiergleis werden bei nicht entfernten Loks bzw. Baugruppen, auch dessen CV-Werte verstellt. **Die Programmiergleis-Funktion kann hier nicht unterscheiden!** {{ :wizard:gbmboost_proggleis_02.jpg |}} ---- {{ :wizard:gbmboost_proggleis_04.jpg?300|}} Nach dem Bestätigen und entfernen der anderen Decoder und Baugruppen, öffnet sich das Tool für die Programmiergleis-Funktion. Im Fenster „Adresse“ kann man die Decoder Adresse „kurz“ und „lang“ von dem Decoder auslesen bzw. editieren und zurückschreiben. Beim Lesen wird automatisch erkannt ob es sich um eine kurze oder lange Adresse handelt. Bei dem aufgeführten Beispiel wurde von dem Decoder der Defaultwert 3 ausgelesen und auf den neuen Wert 10 geändert. **Ab jetzt reagiert die Lokomotive auf die Adresse 10.** Der erfolgreiche Lese bzw. Schreibvorgang wird durch einen grünen Hacken (Prog_Okay) angezeigt. ---- {{:wizard:gbmboost_proggleis_05.jpg?300 |}} Ein schnelles editieren der wichtigsten Railcom-Einstellungen eines Lokdecoders ermöglicht das Fenster „Railcom“. Für den Anwender sind hier die Einstellungen des CV28 benutzerfreundlich aufgelistet. Mit setzten der Kästchen kann man die einzelnen Railcom-Channels 1 und 2 aktivieren bzw. deaktivieren. Die Auswahl Railcom+ ist eine Zusatzoption für Railcom-Plus kompatible Lokdecoder. Weitere Informationen zu dem Thema RailCom® finden Sie im Wiki unter dem [[railcom|Thema "RailCom®"]]. ---- Im Fenster **„Direkt“** besteht die Möglichkeit das Lesen und Schreiben aller möglichen CVs des DCC-Decoders. Dafür verwenden Sie als Hilfe die CV-Liste Ihres Decoders und editieren das betroffene CV. Das Tool ermöglich die Byte und Bit Schreibweise und ist somit kompatible zu den unterschiedlichen CV-Beschreibungen der jeweiligen DCC-Decoder. :!: Um einen CV-Wert zu lesen oder schreiben, muss die CV-Nummer eingegeben werden. Anschliessend wird der //Lesen//-Button freigeschaltet. Sobald ein Wert im Eingabefeld CV-Wert eingegeben wird oder die Checkboxen geklickt werden, wird auch der //Schreiben//-Button freigeschaltet. Falls ein ungültiger Wert eingegeben wird, erscheint ein Fehler-Marker (kleines Icon mit weissem Kreuz auf rotem Grund). Der Grund des Fehlers wird als Tooltip beim Positionieren des Mauszeiger über diesem Fehler-Marker dargestellt. {{ :wizard:gbmboost_proggleis_07.jpg?600 |}} Im BiDiB-Wizard können gleichzeitig mehrere Fenster geöffnet werden. In der Abbildung ist das Fenster **CV-Programmer** und das Fenster **Loksteuerung** geöffnet. Diese doppelte Anzeige ermöglicht das Editieren eines CV-Wertes und das gleichzeitige Testen diese Änderung über die Loksteuerung. ===== Belegtmelder ===== {{ :wizard:wizard-qos.png |}} Im Bild oben ist der Decoder 3 im Prüfstand angeschlossen, darum kommt immer 1=0 (also keine fehlerhaften Pakete) aber es kann dort auch ein anderer Wert kommen wenn man auf der Anlage fährt. In den Belegtmeldern wird: * in der ersten Zeile ist der Inhalt der Confidence-Meldung angezeigt. * in der 2. Zeile wird die Lokadresse, Aufgleisrichtung (<< oder >>) und die Geschwindigkeit angezeigt. * in der 3. Zeile wird QOS (MSG_BM_DYN_STATE --> 1: Signalqualität) angezeigt wenn der Decoder es unterstützt. Die DynStatus-Daten (Verschmutzung) werden jetzt in der gleichen Zeile wie die Adresse, Aufgleisrichtung und Geschwindigkeit dargestellt. Von der Höhe her sollten auch 4 Decoderdaten passen. {{ :wizard:wizard-feedbackpanel.png |}} In den Belegtmeldern wird folgendes angezeigt: * in der ersten Zeile ist der Inhalt der Confidence-Meldung (valid, freeze, signal). * in der 2. Zeile wird die Lokadresse, Aufgleisrichtung (<< oder >>) und die Geschwindigkeit, dahinter die QOS (MSG_BM_DYN_STATE --> 1: Signalqualität) falls der Decoder diese Information liefert. * in der ersten Zeile ist der Inhalt der Confidence-Meldung (VOID, FREEZE, NOSIGNAL). Ab **Wizard-1.11 Build 3473**: \\ In den Belegtmeldern kann über das Kontextmenü der Lok-Dialog und der POM-Editor geöffnet werden. Dabei wird die erste Lokadresse als Defaultwert verwendet. {{ :wizard:feedback-open-loco-control.jpg |}} ---- ===== CV-Programmierer für POM ===== Mit dem CV-Programmierer für POM können Lok-Decoder über POM-Befehle (Programming-On-Main, Hauptgleisprogrammierung) gelesen oder beschrieben werden, sofern der Decoder dies unterstützt. Um den CV-Programmierer für POM zu öffnen, muss der Knoten mit der DCC-Zentrale (IF2, GBMboost Master) selektiert werden, und über das Kontextmenü "CV-Programmer für DCC-Dekoder (POM)" ausgewählt werden. Alternativ kann dieser Dialog auch über das Kontextmenü auf dem belegten Rückmelder geöffnet werden. ==== Adresse ändern ==== Um die Lok-Adresse zu ändern muss die Adresse der Lok im Feld Lok-Adresse eingegeben werden. Dann sollte zuerst versucht werden die Adresse zu lesen. Eine erfolgreich gelesene Adresse wird im Feld Adresse angezeigt. === Schreiben der neuen Adresse === Eine neue Adresse wird durch Eingabe der neuen Adresse im Feld //Adresse// und anschliessendem Klick auf den //Schreiben//-Button über POM in den Decoder geschrieben. Die Anwort des Dekoder wird entweder nicht gesendet oder erfolgt evtl. auf die neue Adresse. Dies führt zu einem Timeout im Wizard. Der Wizard erkennt dies und versucht den Lok-Decoder auf der neuen Adresse anzusprechen, allerdings nur falls die //kurze Adresse// verändert wurde. Ist dies erfolgreich, wird die neue Adresse als Lok-Adresse eingetragen. Diese automatische Anpassung muss der Anwender durch klicken des //Bestätigen//-Button akzeptieren um weitere Schreib- oder Lese-Aktionen ausführen zu können. Nach dem Bestätigen wird der Button wieder unsichtbar. {{ wizard:wizard-pom-change-short-address.png }} ==== POM auf DCC-Schaltdekoder (DCC Accessory Decoder) ==== Um einen DCC-Schaltdekoder per POM zu programmieren muss der Address-Typ auf //Accessory// gestellt werden. {{ :wizard:wizard-pom-dialog-addresstype.png |}} :!: Um einen DCC-Schaltdekoder mit POM zu programmieren muss die Firmware des GBM16T erweitert werden. Deshalb muss diese Funktion in den Wizard-Einstellungen durch die PowerUser Checkbox freigeschalten werden. ===== Servo einstellen ===== ==== Justierwerte einstellen ==== {{:wizard:wizard-servos.png|}} Modellbauservo haben oft eine Stellbereich von 180 Grad (der rote Bereich in der Abbildung oben). Dieser Bereich ist der maximale Bereich der mit der LC angesteuert werden kann. Dabei ist der Justierwert unten = 0 und der Justierwert oben = 250. Über den Slider in der Spalte //Zielwert in %// kann man den Bereich abfahren (0% ist jetzt 0 und 100% ist jetzt 250). Der Zielwert 50% ist in diesem Fall bei der absoluten Position 127 (250 - 0 / 2, die grün gestrichelte Linie). Wenn man den gesammten Stellbereich einschränken will, dann muss man zuerst die beiden Justierwerte ermitteln zwischen denen der Servo sich bewegen darf. Wenn man den unteren Justierwert auf 35 setzt, dann ist der untere Anschlag neu bei der blauen Linie. Neu ist also 0% bei dem Wert 35, darunter kommt man nicht mehr. Der Servo kann also nur noch zwischen 35 (entspricht 0%) und 250 (entspricht 100%) bewegt werden. Der Zielwert 50% ist neu bei der absoluten Position 107 (250 - 35 / 2). Wird jetzt noch der obere Justierwert auf den Wert 178 gestellt, dann bewegt sich der Servo nur noch zwischen den absoluten Positionen 35 und 178 (d.h. 100% ist neu bei 178). Der Zielwert 50% ist neu bei der absoluten Position 71 (178 - 35 / 2, die blau gestrichelte Linie). ==== Servoposition einstellen ==== Um die Servo-Position einzustellen, können neben der Maus auch die Tasten ''Cursor-links'' und ''Cursor-rechts'' verwendet werden. Um direkt an den unteren oder oberen Wert zu fahren, können die Tasten ''Page-Down'' und ''Page-Up'' verwendet werden. Ein entsprechender Tooltip als Hilfe wird über der Spalten-Bezeichnung angezeigt. {{:wizard:wizard-servo-move-slider-with-keys.png}} ---- ===== Portumschaltung ===== Auf der Baugruppe ''LED-IO-24'' kann jeder einzelne der 24 Ports von LED Ausgang auf Eingang umgeschaltet werden. Auf der Baugruppe ''OneControl'' können die GPIO-Ports zwischen Eingang und Schaltport umgeschaltet werden. Die Umschaltung erfolgt mit Hilfe der BiDiB-Tools z.B. BiDiB-Wizard. ==== LED Ausgang -> Eingang ==== Wenn der Port aktuell als LED Ausgang aktiv ist im BiDiB Wizard auf den Reiter Eingang wechseln und beim gewünschten Port rechts klicken. Im Popup Menü auf "Port umschalten" klicken und die Umschaltung bestätigen. {{ :led_io_24:ledio24_wizard_port1.png }} Ein auf Eingang umgestellter Port kann zusätzlich über die CV 171 - 173 von Eingang auf Belegtmelder umgestellt werden. ==== Eingang -> LED Ausgang ==== Wenn der Port aktuell als Eingang aktiv ist im BiDiB Wizard auf den Reiter Lichtausgänge wechseln und beim gewünschten Port rechts klicken. Im Popup Menü auf "Port umschalten" klicken und die Umschaltung bestätigen. {{ :led_io_24:ledio24_wizard_port2.png |}} ----- ===== Makro erstellen ===== Um ein Makro zu erstellen muss der Knoten selektiert sein. Der Name des Makro kann durch Doppelklick in der Makroliste oder über das Kontextmenü geändert werden. Wenn ein Makro selektiert ist, werden im rechten Teil des Fensters die Schritte angezeigt. Mit Hilfe des Kontextmenü können Schritte eingefügt oder gelöscht werden. Die nachfolgende Abbildung zeigt den Makroeditor: {{:wizard:wizard-macropanel-buttons.png |}} Ein Makro muss auf den Knoten übertragen werden, bevor es genutzt werden kann. Jetzt kann man es testen und erproben. Erst nach permanenter Speicherung ist es dauerhaft auf dem Knoten abgelegt und steht beim Neustart zur Verfügung. In der Makroliste wird der aktuelle Status der Speicherung pro Makro angezeigt. {{ :wizard:wizard-macro-states.png |}} Ab Build 3116 gibt es einen neuen initialen Makrostatus. Im Wizard werden die Makros erst vom Knoten gelesen, wenn ein Makro bearbeitet wird, indem es in der Makroliste selektiert wird. Um unterscheiden zu können ob ein Makro schon vom Knoten gelesen wurde, wird dieser initiale Status angezeigt. :!: Ein Makro welches nicht permanent gespeichert ist, geht beim Unterbruch der Versorgungsspannung verloren! Weitere ausführliche Informationen zu Makros und Accessories findet man auch unter: * [[grundlage_makro|Was sind Makros und Accessories?]] * [[advanced_macro_de|Mehr zu Makro und Accessory]] ---- ==== Auf Eingangswert warten ==== Die LightControl und OneControl bietet die Möglichkeit in einem Makro den Zustand eines Eingangs abzufragen und falls der Eingang den angegeben Zustand (0 oder 1) nicht hat, so lange zu warten bis der Eingang den Zustand erreicht oder das Makro gestopped wird. Die nachfolgende Abbildung zeigt die Konfguration um das Makro im Schritt 2 so lange anzuhalten bis der Input_0 den Wert 0 hat. {{:wizard:queryinput.png|}} ---- ==== Kritischer Abschnitt ==== Die Makroengine bietet die Möglichkeit das Abbrechen/Stoppen eines Makro von aussen zu unterbinden, falls eine Schrittfolge nicht unterbrochen werden darf. {{ :wizard:macro_criticalsection.png |}} * Anfang / BIDIB_MSYS_BEGIN_CRITCAL: Eine Stopanforderung an dieses Makro wird nicht beachtet. * Ende / BIDIB_MSYS_END_CRITCAL: Eine Stopanforderung an dieses Makro wird wieder beachtet. D.h. nach BEGIN_CRITCAL macht das Makro sein Ding fertig bis zum Schritt END_CRITICAL. Basta. ==== Accessory Notify ==== Die Makroengine bietet die Möglickeit, das erfolgreiche Ende der Auführung eines Accessory an das Steuerungs-Programm zu melden bevor das Accessory durchgelaufen ist. Normalerweise wird die "Accessory fertig durchgelaufen"-Meldung immer nach dem Ende der Ausführung des Accessory gesendet. Dies dient dazu den kritischen Vorgang der Accessory-Ausführung überwachen zu können. Falls nämlich ein Fehler auftritt wird der Fehler zurückgemeldet und nicht ok. Diese "Ende"-Mitteilung wird pro Ausführung eines Accessory genau 1x gesendet. Falls man erreichen will, dass diese Benachrichtigung schon vor dem eigentlichen Ende der Ausführung des Accessory an das Steuerungs-Programm gesendet wird (weil z.B. alle kritischen Schaltvorgänge schon durchgeführt sind), dann kann man den Befehl "Accessory notify" verwenden. Wenn man das "Accessory notify" mehr als 1x im Makro drin hat, dann hat es keine Auswirkung mehr nachdem das 1. "Accessory notify" gesendet wurde, denn der "Befehl" wird nicht mehr gesendet. Dazu wird unter Port Typ der "Accessory notify" ausgewählt. In der Spalte Aktion kann bestimmt werden, ob die Meldung gesendet wird, wenn der selektierte Port **zum Zeitpunkt der Abarbeitung dieses Schritt** den Wert = 0 oder Wert = 1 hat. ==== Flag abfragen ==== Mit dem Makroschritt ''Flag abfragen'' wird die Ausführung eines Makro anhand eines gesetzten oder nicht gesetzten Flag pausiert. D.h. wenn die Bedingung nicht erfüllt ist, wartet das Makro in diesem Schritt solange, bis die Bedingung erfüllt ist. Der Makroschritt ''Flag abfragen 1'' pausiert das Makro solange, bis das Flag gesetzt ist. Der Makroschritt ''Flag abfragen 0'' pausiert das Makro solange, bis das Flag nicht (mehr) gesetzt ist. ---- ==== Starten per externem Eingang ==== Die LightControl und OneControl bieten die Möglichkeit Makros von einem Eingang (Input) starten zu lassen. Dabei wird die Nummer des Eingang auf die Nummer des Makro gemappt, also Eingang 1 startet Makro 1, usw. Dazu muss auf dem Knoten das Feature //FEATURE_CTRL_MAC_START_MAN// aktiviert sein. IM Wizard erfolgt dies über das Kontext-Menü auf dem Knoten. {{ :wizard:wizard-macro-start-from-input.png |}} ---- ===== Accessory ausführen ===== Bei der Ausführung eines Accessory wird der Ausführung-Status angezeigt. Solange das Accessory ausgeführt wird, wird eine Uhr als Symbol angezeigt: {{ :wizard:wizard-accessoryexecution-pending.png |}} Wenn das Accessory erfolgreich beendet wurde (ohne Fehler), dann wird dies durch ein grünes Häckchen signalisiert: {{ :wizard:wizard-accessoryexecution-success.png |}} Fehler bei der Ausführung eines Accessory werden mit einem //Fehler-Icon// dargestellt. Im Tooltip des //Fehler-Icon// werden genauere Informationen über den Grund des Fehlers dargestellt. {{ :wizard:wizard-execution-state-error.png! }} ==== Initialer Status ==== Über die Auswahl des //Initialen Status// kann der Aspekt eines Accessory aussgewählt werden, der nach dem Start der Baugruppe eingestellt wird. Wenn ein Aspekt gewählt wird, dann wird dieser Aspekt nach jedem Start ausgeführt. Wenn ''Unverändert'' gewählt wird, so wird kein Aspekt ausgeführt. Wenn ''Wiederherstellen'' als Initialer Status gewählt wird, dann holt die Firmware statt des fixen Begriffes den letzten vom PC übermittelten Begriff und stellt diesen Begriff beim Start der Baugruppe wieder ein.\\ Dies bedingt, dass ein Accessory zumindest 1x geschaltet wurde. ---- ===== CV-Werte anpassen ===== CV-Werte der Knoten lassen sich über das Tab //CV-Defintionen// einstellen. Hinweis: In der Abbildung sind in der Spalte Wert nur Fragezeichen drin weil die Abbildung im Demo-Modus erstellt wurde. Nach dem Laden der CV stehen dort die richtigen Werte drin. {{:wizard:change-node-cv-values.png|}} Zuerst müssen die aktuellen CV-Werte über die Buttons zum Lesen und Schreiben der CV-Werte vom Knoten in der Toolbar geladen werden. {{ :wizard:wizard-1.9.cv-schreiben.png |}} Falls bei einer CV weitere Informationen als Hilfetext hinterlegt sind, werden diese als Tooltip dargestellt. {{:wizard:wizard-cvdef-help.png|}} Um CV-Werte anzupassen sind folgende Schritte notwendig: * Aktuelle CVs über den Button in der Toolbar vom Knoten laden. * CV auswählen * CV-Wert anpassen * geänderten CV-Wert speichern (Merken). Es können auch mehrere Werte verändert und gespeichert werden, bevor die Übertragung auf den Knoten erfolgt. * geänderte CV-Werte auf den Knoten übertragen :!: In einigen Fällen werden geänderte CV-Werte erst nach einem Neustart des Knoten übernommen. Für Bit-Werte kann ebenfalls mehr Information als Hilfetext hinterlegt werden, welche als Tooltip bei den Checkboxen angezeigt wird. ==== Benutzerdefinierte CV-Dateien ==== :!: Der BiDiB-Wizard liefert aktuelle CV-Definitionen mit. Es besteht aber auch die Möglichkeit eigene oder **angepasste CV-Definitionen** zu verwenden. Dabei werden folgende Verzeichnisse durchsucht: - \data\BiDiBNodeVendorData (z.B. C:\Users\admin\.bidib\data\BiDiBNodeVendorData) - \data\BiDiBNodeVendorData (z.B. C:\Program Files\BiDiB-Wizard-1.9-SNAPSHOT\data\BiDiBNodeVendorData) - Interne Suche in Programm-Archiven Sobald eine passende CV-Definition gefunden wurde, wird diese verwendet und die Suche in den weiteren Verzeichnissen abgebrochen. Der Wizard zeigt den Pfad zur verwendeten Template-Datei im Tooltip auf dem Textfeld XML-File an. {{ :wizard:wizard-cvdef-path.png |}} Der Wizard zeigt einen Warnungs-Marker an, wenn eine benutzer-definierte CV-Definition verwendet wird. Im Tooltip auf dem Warnungs-Marker wird der Pfad zum XML-File angezeigt. {{ :wizard:cv-definition-user-defined-marker.png |}} ----- === Import von benutzerdefinierten CV-Definitionen === Der Wizard erlaubt den Import von benutzerdefinierten CV-Definitionen über einen Button im UI. {{ :wizard:bidibcv-vendor-import.jpg |}} === Erstellen von benutzerdefinierten CV-Definitionen === Der Wizard erlaubt das Erstellen von benutzerdefinierten CV-Definitionen über einen Button im UI. Dabei wird die interne CV-Definitionen des Wizard in das Benutzer-Verzeichnis kopiert, damit sie dort angepasst werden kann. {{:wizard:wizard-create-userdefined-cvdef.png}} ===== Kehrschleifen / Reverser Editor ===== Beim Klick auf die CV von Reverser Mode, Reverser On/Off/Prio wird der Editor für die Kehrschleife angezeigt. {{ :wizard:wizard-reverser-editor.png |}} -------- ===== Loksteuerung skripten ===== Der Wizard bietet die Möglichkeit die Loksteuerung mit einem einfachen Skript zu automatisieren. Dazu kann in der Loksteuerung ein Skript ausgewählt werden. Ein Demo-Skript liegt im Installationsverzeichnis unter //data/script//. {{ :wizard:wizard-loco-script.png }} Die Kommandos für das Skripting der Loksteuerung sind [[tools:scripting-loco|hier]] beschrieben. ---- ===== Export Knoten ====== Der Knoten-Export wird über das Kontextmenü des ausgewählten Knotens gestartet: ''Exportieren ...'' Beim Exportieren eines Knotens ist es wichtig, dass geänderte CV-Werte auch exportiert werden. Dazu müssen die 3 Checkboxen wie im nachfolgenden Bild aktiviert sein. {{ : wizard:Wizard-export-node.png }} :!: Der Wizard 1.13 unterstützt nur noch das neue Datei-Format für den Knoten-Export und Import. Dieses Format wurde notwendig, um neuere JDK Versionen zu untersützen. :!: Der Wizard 1.12 verwendet standardmässig ein neueres Format für den Knoten-Export und Import. Um Export-Dateien im alten Format einlesen zu können, muss in den ''Einstellungen > Experimentelle Eigenschaften > Java-Serialisierung für Knotenexport verwenden'' auf das alte Format umgeschaltet werden. Anschliessend den Wizard neu starten. Für neue Knoten-Exporte bitte das neue Format verwenden!! ===== Import Knoten ===== Nach einem Update kann die alte Konfiguration wieder in den Knoten geladen werden. Dabei werden auch Makros und Accessories restored. Vorsicht: ein Import überschreibt auch Servoeinstellungen, dadurch kann ein Servo unbeabsichtigt weit umlaufen. Es daher empfohlen, beim Import die Servos abzustecken und erst nach Überprüfung der Einstellungen die Servos wieder anzustecken. === Import OneControl === :!: OneControl: Die GPIO der OneControl werden durch Anpassungen der CV als Eingang oder Ausgang konfiguriert. Wenn ein GPIO-Port umkonfiguriert wird, dann muss ein Reset (Zurücksetzen) der OneControl durchgeführt werden, bevor die neue Port-Konfiguration aktiviert wird. Falls dies nicht erfolgt, können Makros nicht importiert werden, welche die angepasste Konfiguration erwarten. Wenn z.B. ein GPIO-Port auf Eingang (Input) konfiguriert ist, das Makro diesen Port aber als Ausgang erwartet, dann schlägt der Import dieses Marko fehl. Aus diesem Grund müssen beim Importieren der OneControl mit veränderten GPIO-Ports aus der Node-Sicherung zuerst nur die CV importiert werden, anschliessend ein //Zurücksetzen// ausgeführt werden und in einem weiteren Schritt nachdem sich die OneControl neu angemeldet hat können die restlichen Einstellungen wiederhergestellt werden. Ab Wizard-1.9 Build 2293 wird ein Dialog angezeigt, welcher auf das Thema aufmerksam macht. Wird der Import zum 1. Mal aufgerufen, kann der Dialog mit //Ja// bestätigt werden, um die entsprechenden Einstellungen vorzunehmen. {{ :wizard:wizard-import-nodewithgpio.png |}} Auswahl der Sicherung mit den selektierten Checkboxen. {{ :wizard:wizard-import-onecontrol-teil1-1.png |}} Wenn GPIO noch nicht korrekt konfiguriert sind kommt eine Fehlermeldung, welche in diesem Fall ignoriert werden kann. {{ :wizard:wizard-import-onecontrol-teil1-2.png |}} Wie oben beschrieben im ersten Schritt nur die CVs importieren: {{ : wizard:wizard-import-onecontrol-first-select.png }} === Knoten neu starten === Anschliessend muss der Knoten neu gestartet werden. Dazu muss über das Kontextmenü ein **//Neustart//** (//Reset//) auf der OneControl ausführt werden. Nachdem die OneControl wieder am Bus ist, in einem zweiten Schritt den Rest der Konfiguration in die OneControl importieren. Dazu die gleiche Auswahl der Sicherung mit allen selektierten Checkboxen ausser den CV verwenden. {{ :wizard:wizard-import-onecontrol-teil2-1.png |}} {{ : wizard:wizard-import-onecontrol-second-select.png }} -------- ===== Debug Interface ===== Ab dem Wizard-1.9 ist ein direkter Zugriff auf die Debug-Schnittstelle möglich statt hterm zu benutzen. Dazu müssen die Schnittstelle und die Baudrate aus den entsprechenden Comboboxen ausgewählt werden. {{ :wizard:wizard-debug-interface.png |}} Anschliessend wird der Port über 'Verbinden' geöffnet. Durch Eingabe von '?' wird in den meisten Fällen eine Information des Knotens angezeigt. Für die Übertragung einer Firmware-Datei muss 'f' oder 'e' in das Testfeld 'Senden' eingegeben und gesendet werden. Anschliessend muss die Datei ausgewählt und dann durch Klick auf 'Senden' gesendet werden. ==== Update vom GBM16T mit dem BiDiB-Wizard ==== :!: Für das Update des GBM16T wird ein FTDI-Kabel (3.3V) benötigt, welches auf den Debug-Port gesteckt werden muss. Siehe auch [[update_ftdi|Logging über FTDI-Kabel]]. Tools > Entwickler-Tools > Debug Interface * **Während dem Einschalten den Ident-Schalter gedrückt halten**. * Mit Baudrate **19200** verbinden und im Textfeld Senden das **?** eingeben > **Senden** (geht auch mit Enter). * Ausgabe im Logfenster: **Trackproc_Bootloader V0.01** zeigt an, dass der Bootloader aktiv ist. * Eingabe von **f** und Senden --> Bootloader quittiert mit einem "." und erwartet jetzt ein Flash-File. * Auswahl von gbm16t_2.04.04.hex aus denm ZIP-File über **Auswählen bei Datei**, anschliessend **Senden** bei Datei --> Bootloader quittiert mit vielen "." * Eingabe von **e** und Senden --> Bootloader quittiert mit einem "." und erwartet jetzt ein Eeprom-File. * Auswahl von gbm16t_2.04.04.eep aus denm ZIP-File über **Auswählen bei Datei**, anschliessend **Senden** bei Datei --> Bootloader quittiert mit vielen "." * Abschliessend Verbindung trennen und Spannung entfernen, damit der GBM16T neu bootet. **Einfacherer Weg: Reset des GBM16T mit Jumper** {{ :wizard:jumper-reset-gbm16t.png |}} * FTDI-Kabel am GBM16T and PC einstecken, Debug-Interface verbinden mit **19200**, * Jumper stecken (alle LEDs auf dem GBM16T werden dunkel ...), * Knopf gedrückt halten, * Jumper ziehen und dann Knopf loslassen müsste in den BL mode führen. * Ausgabe im Logfenster beim Loslassen des Knopf: **Trackproc_Bootloader V0.01** zeigt an, dass der Bootloader aktiv ist. 8-o Falls der GBM16T nach dem Update einen Nightrider auf POW, BiDiB und den anderen 2 LEDs hat, kann normalerweise der Ident-Taster gedrückt werden um den Kalibrierungsmodus zu verlassen. Dieser Hinweis per Nightrider deutet darauf hin, dass der GBM16T in den Kalibrierungsmodus gewechselt hat. ==== Update vom GBMboost Master mit dem BiDiB-Wizard ==== {{:wizard:firmwareupdate:gbmboost-jumper-bootloader.png?400|}} * **Jumper** **J54 Position J3** setzen! (siehe markierter Jumper im Bild oben) * Während dem Einschalten den **Ident-Schalter gedrückt** halten.\\ **Achtung**: Anstecken des USB-Kabel startet den GBMboost schon ... * Nur die LED **PW** leuchtet ... {{:wizard:firmwareupdate:gbmboost-run-in-bootloader.png?400|}} * Wizard starten und über Tools > Entwickler-Tools > Debug Interface das Debug Interface öffnen. * Mit Baudrate **19200** verbinden und im Textfeld Senden das **?** eingeben > **Senden** (geht auch mit Enter). * Ausgabe im Logfenster: **GBMboost-Bootloader V0.02.01** zeigt an, dass der Bootloader aktiv ist. * Eingabe von **f** und Senden --> Bootloader quittiert mit einem "." und erwartet jetzt ein Flash-File. * Auswahl von gbmboost_master_2.02.07.000.hex aus denm ZIP-File über **Auswählen bei Datei**, anschliessend **Senden** bei Datei --> Bootloader quittiert mit vielen "." * Eingabe von **e** und Senden --> Bootloader quittiert mit einem "." und erwartet jetzt ein Eeprom-File. * Auswahl von gbmboost_master_2.02.07.001.hex aus denm ZIP-File über **Auswählen bei Datei**, anschliessend **Senden** bei Datei --> Bootloader quittiert mit vielen "." * Abschliessend Verbindung trennen und Spannung und Jumper entfernen, bevor der GBMboost Master neu bootet. {{ :wizard:2016-03-26_12-59-17.png |}} {{ :wizard:2016-03-26_12-57-45.png |}} ==== Update vom GBMboost Master mit hterm ==== Die Vorbereitung des GBMboost Master sind wie im vorherigen Abschnitt. * Hterm starten und nach Auswahl des Port und der Baudrate 19200 mit Connect verbinden. * Nach der Eingabe des '?' und Enter zum Senden antwortet der Bootloader mit dem Text "GBMboost-Bootloader". {{:wizard:firmwareupdate:hterm-bootloader-gbmboost.png?|}}