andRoc Einführung & Installieren

Inhalt → andRoc

• Einführung & Installation | Mit andRoc getestete Geräte (engl.)
  • Externe Symbole

Die drahtlose Rocrail Steuerung für Android Geräte

Dies ist eine Zugabe exklusiv für Unterstützer des Projekts, die über einen gültigen Spenden-Schlüssel verfügen

Android Market QR-Code

andRoc ist ein Bonbon für diejenigen, die einen gültigen Spendenschlüssel auf dem Server installiert haben:

• Spenden-Schlüssel

andRoc läuft 5 Minuten nach Verbindungsaufbau mit dem Rocrail-Server ohne einen Spenden-Schlüssel. Nach diesen 5 Minuten wird andRoc ohne Warnung beendet.

• Funktioniert mit allen durch Rocrail unterstützen Zentralen
• Alle verfügbaren Rocrail-Server anzeigen. (Android 1.6+)
• Lok/Wagen-Steuerung mit:
  • Lok-Bildern
  • Lok-Bilder-Zwischenspeicher um Start zu verkürzen.
  • 28 Funktionen in 5 Gruppen und Licht
  • Freigabe und Start
  • Not-Halt
  • Mehrfachtraktionen verwalten
  • Zugkategorien
• Lok-Einstellungen:
  • Vmin, Vmid und Vmax
  • Hauptgleisprogrammierung (PoM)
  • Dispatchen von LocoNet-Handreglern
• Steuerungen:
  • Automatikbetrieb
  • Fahrstraßen
  • Aktionen
  • Weichen
  • Ausgänge
  • System
• Zubehörfeld
• Systemmonitor
• Layout:
  • Liste mit allen Ebenen
  • Blockstatusfarbe
  • Interaktiv
  • Schiebebühne
  • Drehscheibe, Schiebebühne
  • Aufstell-Block
  • Modulansicht
  • zoomfähig
  • Wählbare Hintergrundfarbe
  • Zeigt aktive Fahrstraßen und Belegung
• Benutzer-Schnittstelle ist übersetzt; abhängig von der Sprache, die für das Gerät ausgewählt wurde.
• Zeigt die Geräte-Kennung in Rocview als Regler-Kennung
• Gast-Lok-Einstellungen

• http://bazaar.launchpad.net/~rocrail-project/rocrail/androc/changes

• Eine aktuelle Rocrail-Installation.
• Ein gültiger Spendenschlüssel auf dem Rocrail-Server. (Das ist ein Bonbon für Leute, die das Projekt unterstützen.)
• Android 1.6+ basierendes Wlan fähiges Gerät. (Android 1.5 kann auch ohne R2RNet-Unterstützung verwendet werden.)
• WLAN (WiFi)
• Bevorzugt werden Kleine Bilder; Bilder normaler Größe werden auf eine Höhe von 50 Pixeln herunterskaliert.
• Verbindung zum client port des Rocrail-Servers.

• https://play.google.com/store/apps/details?id=net.rocrail.androc

Diese Methode sollte bevorzugt angewendet werden; man wird automatisch über Updates informiert und das Melden von Abstürzen wird unterstützt.

1. Suche nach andRoc ² oder Rocrail im Market¹
2. Installations-Button betätigen.
3. Fertig.

²)Sollte die App auf dem Android Gerät nicht angezeigt werden, bitte hier melden.

Für Tester und Entwickler.

1. Download des aktuellsten Snapshots von andRoc-revxxx.apk mit dem Android Webbrowser. → snapshots.rocrail.net
2. Auswählen zum Installieren der Datei andRoc-revxxx.apk.¹
3. Fertig.

¹)
Die App wird nicht installiert, wenn bereits ein Snapshot oder Market release von andRoc auf dem Android Gerät verfügbar ist.
Es wird ein Fehler angezeigt, da die Versionen eine unterschiedliche Signatur besitzen. In diesem Fall zuerst die alte Version deinstallieren.

Zum Testen von andRoc ohne eigenem Gleisplan, kann ein Demo-Gleisplan verwendet werden, der mit folgenden Einstellungen benutzt und erreicht werden kann:

Dies ist ein kleiner Gleisplan, der verbunden ist mit einer virtuellen Zentrale und über 20 vordefinierten Lokomotiven mit kleinen Bildern.

andRoc verwendet die Gerätesprache wenn verfügbar. Standard ist Englisch.
Folgende Sprachen werden unterstützt

• Englisch
• Niederländisch
• Deutsch
• Italienisch → Übersetzer benötigt.
• Französisch → Übersetzer benötigt.

Bitte im Forum benachrichtigen, wenn Übersetzungen falsch sind.

Hinzufügen oder Änderungen an den Übersetzungen bei LaunchPad:
https://translations.launchpad.net/rocrail/androc/+pots/androc

Bei Launchpad melden: https://bugs.launchpad.net/rocrail/androc

Die Navigation zwischen den Aktionen erfolgt über das Menü.
Eine Berührung des Lokbildes führt nacheinander durch die Menüs Fahrregler, Lok und Loksetup.

Die ursprünglichen Werte sind für das Rocrail-Demo-Layout, rocrail.dyndns.org:8051, die eine Internetverbindung des Androidgerätes benötigt.
Nach Verbindung mit dem Rocrail-Server zeigt ein Dialog den Ladevorgang des Planes.
Die letzte host:port-Kombination wird für die nächste Sitzung gespeichert.

Der Plan-Titel des Rocrail-Servers, der sich über R2RNet angemeldet hat.

Die IP-Adresse oder der Computername des Ziel-Rocrail-Servers.

Der Client-Port des Rocrail-Servers. Standard 8051.

Um Schreibrechte zu erhalten muss hier der Kontrollcode aus der Rocrail.ini eingetragen werden.

Eine Liste der letzten Rocrail-Server-Verbindungen.

Diese Option benötigt einen Neustart von andRoc, um aktiv zu werden.
Diese Option ist mit Vorsicht zu benutzen, weil sie viel Prozessorleistung von kleinen Geräten benötigt, was ein Blockieren der Benutzeroberfläche zur Folge haben kann.
Für den normalen Gebrauch ausgeschaltet lassen.

Verhindert, dass das Gerät, in den Energiesparmodus wechselt.

Schaltet direkt zur Modulansicht, wenn der geladene Plan ein modularer ist.

Option für große Bildschirme, um den Regler-Dialog klein zu halten.

Nur die benötigten Lok-Bilder werden geladen, um die Kommunikation beim Start zu verringern.

Sortiert die Lok-Liste nach Adressen anstelle der Kennungen.

(331+)
Diese Liste unterteilt alle Loks in 5 Kategorien:

1. Dampfloks
2. Dieselloks
3. E-Loks
4. Pendelzug: Unabhängig vom Zugtyp wenn die Lok als Pendelzug definiert ist.
5. Spezial: Reinigungszug oder Postverteiler.

Verwendet “Gleisspannung AUS” anstelle von “Nothalt”

Schaltet Fahrregler-Geschwindigkeits-Abgleich ein. Abschalten, um bei langsamem Netzwerk das Springen des Schiebereglers zu vermeiden.

Aktiviert die Zoom-Funktion im Gleisplan.

Option für Dekoder mit 127/128 Fahrstufen, um die Schieber-Auflösung 1:1 einzustellen.

Verwendet Schaltflächen anstelle des Schiebereglers. Auto-Wiederholung nach 1 Sekunde.

Wenn nicht alle Fahrstufen genutzt werden, wird dieser Wert für Erhöhen und Verringern der Geschwindigkeit verwendet.

Die Liste mit den letzten Rocrail-Server-Verbindungen löschen.

Wenn ein Rocrail-Server R2RNet aktiviert hat, sendet er die Client-Verbindungs-Informationen durch multi casting zu den andRoc-Clients.

andRoc:  <netreq req="clientconn"/>
Rocrail: <netrsp host="192.168.100.37" port="8051" rsp="clientconn" plan="Plan-F"/>

Fügt per Adresse eine Gast-Lok hinzu.
Die neue Gast-Lok erscheint in der Lok-Kategorie "Special".

Menü	Gast-Lok-Dialog

Standardeinstellung ist DCC und 128 Geschwindigkeitsstufen, wenn nur die Adresse gesetzt wird. In diesem Fall ist die Lok-Kennung gleich der Adresse.

Hinweis: Für alle Eigenschaften, außer Adresse, ist ein Rocrail-Server mit Revision 4559+ erforderlich.

Starten der Lok bei aktiviertem Automatikmodus.

Der Button ist deaktiviert, wenn der Automatikmodus nicht aktiviert ist.

Eine Lok vom Fahrregler freigeben.
Ohne eine Lok vom Fahrregler freizugeben ist es nicht möglich, sie über einen anderen Fahrregler oder Client zu steuern. Dieses Verhalten kann über Lokübernahme unterbinden beeinflusst werden.
Ein langer Klick sendet ein Power-aus-Kommando.

Funktionsgruppe Auswahlbutton. Es gibt vier Gruppe je sechs Funktionstasten.
Ein langer Klick sendet eine Notbremsung.

Schaltet die Funktionen 1 - 6 an/aus.
Ein langer Klick wählt Fahrregler 1-6 aus.

Schaltet die Lokomotivlichter an/aus.
Ein langer Klick schaltet die Lok zur Verwendung mit einem Fred frei.

Hält die Lok an.
Bei stehender Lok wird die Fahrtrichtung geändert.
Zeigt die aktuelle Geschwindigkeit an.
Ein langer Klick schaltet die Verwaltung von Mehrfachtraktionen ein. (Version 356+)

Geschwindigkeitsbefehle werden erst gesendet, wenn der Geschwindigkeitsunterschied 5 Stufen beträgt oder bei Bewegungsende.
Die Differenz wurde eingeführt, um die Anzahl der Befehle durch Änderung des Schiebereglers zu verringern.

Starten der Lok bei aktiviertem Automatikmodus..
Der gewählte Fahrplan wird als Ziel verwendet, sofern gesetzt.
Bei langem Klick wird der gewählte Block als Ziel gesetzt. (Fehler behoben in 405)

Legt fest, ob der Start einen normalen oder halbautomatischen Betrieb startet.

Setzt die Lok in den gewählten Block.

Ändert die Platzierung.

Anzeigen, hinzufügen und entfernen von Mitgliederen in Mehrfachtraktionen:

Fahrregler	Mehrfachtraktionen verwalten	Mehrfachtraktions-Anzeige	Lok-Steuerung	Mitglied zeigt Hauptlok

Wird durch langes Anklicken der Fahrtrichtungs-Schaltfläche aktiviert.
Ein langer Klick auf die Fahrrichtungs-Schaltfläche schaltet zur Hauptlok um, wenn die ausgewählte Lok auch ein Mitglied ist.
Auswählen einer Lok aus der Listen-Anzeige öffnet die Lok-Aktivität, die zum Tausch der Platzierung verwendet werden kann.

Einstellen der Geschwindgkeit in allen Betriebsarten einschließlich Automatikbetrieb.

Programmieren auf dem Hauptgleis. PoM
Lesen der Haupt-CV-Werte benötigt bidirektionale Kommunikation.

Freigabe der Lok für einen anderen Fahrregler.
Diese Funktion ist nur verfügbar, wenn in den Rocrail-Eigenschaften unter Automatik die Option 'Lokübernahme unterbinden' aktiviert ist.
Erst nachdem eine Lok vom Handregler freigegeben worden ist, kann diese mit einem anderen Handregler gesteuert werden.

Zum Testen von Zubehör.
Insbesondere nützlich, um ein neues Layout mit Rocrail zu erstellen.

Das Adressierungsschema kann über die Buttons ausgewählt werden.:

• M → Module
• F → Flat
• P → Port

Für weitere informationen zur Adressierung: addressing-de

Auswahl einer Startadresse über Nummernfeld möglich oder diese vier Buttons am unteren Rand.

Bei Power down wird ein Hinweis angezeigt. Die Systemaktivitäten werden sichtbar, wenn der Benachrichtigungsbutton berührt wird.

Systemvorgänge und CS-Nachrichten werden unter dem Button dieser Anzeige angezeigt.
Die maximale Listenlänge beträgt 100 Einträge, die ältesten Einträge werden von der Liste entfernt.

Startet alle Züge im Automatikbetrieb.

Auswahl einer Fahrstraße sendet einen Aktivierungsbefehl an den Rocrail-Server.
Hauptsächlich zum Testen verwendet.

Auswahl einer Aktion sendet einen unbedingten Aktivierungsbefehl an den Rocrail-Server.
Wird hauptsächlich zum Testen verwendet.

Informationen über Copyright,, Lizenz, Version, Fahrregler-ID etc. werden in dieser Anzeige aufgelistet.

Liste aller verfügbaren ZLevels.
Das Beispiel zeigt alle Modulnamen eines Modulplanes.
Die Liste wird _nicht_ erscheinen, wenn nur ein ZLevel für das aktuelle Layout definiert ist.
Der erste Eintrag in der Liste ist die “modview”-Visualisierung, falls der Plan ein Modullayout ist.

Eine einzige Berührung eines Objektes sendet für die meisten Typen ein Flip Kommando an den Rocrail-Server.
Block, Schiebebühnen und Drehscheiben senden einen Open oder Close-Befehl.

Ein langer Klick und Loslassen an einer freien Stelle aktiviert das Zoom-Werkzeug.

Eine einzelne Berührung eines Blockes sendet einen Open oder Close-Befehl.
Langes Drücken eines Blockes öffnet eine neue Ansicht, um ihn zu steuern.

Anklicken der Lok öffnet die Lok-Liste. Auswahl einer Lok aus der Liste setzt die Lok in diesen Block.
Ein langer Klick öffnet die Lok-Steuerung.
Auch das Berühren des Lok-Bildes öffnet die Lok-Aktivität.

Sperrt oder entsperrt einen Block. Die LED signalisiert, falls der Block entsperrt ist.

Die BiDi Identität einer Lok im Automatikmodus wird akzeptiert.
Siehe: Identität akzeptieren

Eine einzelne Berührung der Schiebebühne sendet einen Open oder Close-Befehl.
Langes Drücken der Schiebebühne öffnet eine neue Ansicht zur Steuerung.

Sperrt oder entsperrt die Schiebebühne für Züge.

Bewegt die Schiebebühne zum nächsten Gleis.

Bewegt die Schiebebühne zum vorherigen Gleis.

Bewegt die Schiebebühne zum angegebenen Gleis.

Eine einzelne Berührung der Drehscheibe sendet einen Open oder Close-Befehl.
Langes Drücken der Drehscheibe öffnet eine neue Ansicht zur Steuerung..

Sperrt oder entsperrt die Drehscheibe für Züge.

Bewegt die Drehscheibe zum nächsten Gleis.

Bewegt die Drehscheibe zum vorherigen Gleis.

Bewegt die Drehscheibe zum angegebenen Gleis.

Bei der Darstellung von Kreuzungen vom Typ Kreuzung darf in den Weicheneigenschaften die Option 'Rechteckig' nicht ausgewählt sein.

Überprüfung des Plan's auf XML konforme Formatierung, z.B. mit: "XmlSpy".
Oder den W3C-Service nutzen: http://validator.w3.org/#validate_by_upload
Rocrail und Rocview benutzen den Rocs parser, welcher nicht so streng wie der von Java ist.

Die Lok-Bilder und Funktions-Symbole sind lokal auf der SD-Karte gespeichert. (”/sdcard/androc/”)
Sie müssen manuell gelöscht werden, wenn neue Versionen vom Rocrail-Server angeboten werden.

Bild-Namen sind unter Android groß-/klein-schreibungs-sensitiv.

Jedes Programm hat potentielle Probleme. Zur ihrer Lösung ist es eine große Hilfe, wenn der Absturz mit “Google facility” berichtet wird, dass nach jedem Absturz automatisch erscheint. Dieser Bericht enthält exakte Informationen über den Absturz und macht es dem Entwickler sehr leicht eine Fehlerbeseitigung vorzunehmen und zu veröffentlichen.

Wenn das verwendete Mobil-Gerät “Google Play” nicht bietet, kann der Absturz auch im Rocrail-andRoc-Forum und mit folgenden Information gemeldet werden:

1. andRoc-Version.
2. Rocrail-Version.
3. Eine Schritt-für-Schritt-Beschreibung, wie der Absturz reproduziert werden kann.
4. Beifügen der “plan.xml” des Servers, mit dem andRoc verbunden wurde.
5. Geräte-Marke und Typ.