andRoc Einführung & Installieren

Inhalt → andRoc

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

Der androidbasierte, drahtlose Client für Rocrail und ESU Mobile Control II

Dies ist eine Zugabe exklusiv für Unterstützer des Projekts, die über einen gültigen Unterstützungs-Schlüssel (support key) 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:
  • Lokbildern
  • Lokbilder-Zwischenspeicher um Start zu verkürzen.
  • 28 Funktionen in 2 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
  • Text und Bilder
  • Bauwerke
  • Block-Einfahrseite
  • Nur SpDrS60-Symbole → Siehe Externe Symbole für Alternativen.
• 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
• ESU Mobile Control 2 Unterstützung ¹⁾

• 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.)
• andRoc-Version: 517+: Minimale Android-Version 2.3 'GINGERBREAD'
• 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.

Android-Derivate, wie CyanogenMod, werden NICHT unterstützt.

andRoc kann mit allen Zentralen auch auf der MC2 verwendet werden.
Ab Revision 535 wird die folgende Hardware unterstützt:

• Der Fahrregler synchronisiert in beiden Richtungen; Hardware- and Software-Fahrregler.
• Der STOP-Taster: Siehe Gleisspannung AUS für Not-Halt
• Die LED: Rot=Gleisspannung AUS, Grün=Gleisspannung EIN
• Alle vier Tasten können diesen Funktionen zugewiesen werden:
  • Fahr-Stufe +
  • Fahr-Stufe -
  • Lok anhalten
  • Not-Halt
  • Fahrtrichtung ändern
  • Vorwärts
  • Rückwärts
  • Gleisspannung EIN/AUS
  • Nächster Fahrregler (Siehe Langer Klick auf F1-F6)
  • Vorheriger Fahrregler (Siehe Langer Klick auf F1-F6)
  • Funktion F0…F28
  • Wenn die Gleisplan-Ansicht aktiv ist, aktiviert der Taster rechts oben den Fahrregler
• Entwickler-Seite (en)

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

Diese Methode wird bevorzugt; Man wird über Updates informiert und das Melden von Fehlern wird unterstützt.

1. In Google Play nach andRoc oder Rocrail suchen.
2. Schaltfläche “Installieren” anklicken.
3. Betriebsbereit.

• https://launchpad.net/rocrail/+download

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

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.

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.
Zu finden ist die aktuelle IP-Adresse des Ziel-Rocrail-Servers u.a. im Dialog “Hilfe/Info” des Rocview-Clients.

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

Um Schreibrechte zu erhalten muss hier der "Zugriffscode" und "Teil-Zugriffscode" 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.
Voreinstellung ist 300 x 380 Gerät-Einheiten. Kann durch Einstellen von Fahrregler Höhe/Breite (Throttle width/height) geändert werden.
Diese Option nicht bei kleinen Geräten verwenden.

Nur die benötigten Lokbilder werden geladen, um die Kommunikation beim Start zu verringern.

Sortiert die Lok-Liste nach Adressen anstelle der Kennungen.

Der blaue Pfeil kennzeichnet die Lok-Platzierung.

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.

1. I, II, II, IV, V, VI

Alle in den Lok-Definitionen gefundenen Namen von Gesellschaften werden als Kategorien gelistet.
Wenn Loks oder Wagen keine Angaben zur Gesellschaft haben, werden sie der “Keine”-Liste zugefügt.

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.
Beginnend mit Version 439 wird diese Option ignoriert, falls der Fahrregler eine Mehrfachtraktion steuert, um eine Überlastung der Zentrale zu vermeiden.

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"/>

Wenn Ping aktiviert ist, sendet andRoc alle 2,5 Sekunden ein Ping zur mit dem Fahrregler gesteuerten Lok.
Wenn der Ping nicht innerhalb von 5 Sekunden kommt, betrachtet der Rocrail-Server die andRoc-Verbindung als unterbrochen und stoppt die Lok unmittelbar, um Unfälle zu verhindern.

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.

Startet/Stoppt des automatische Fahren der ausgewählten Lok bei aktiviertem Automatikmodus.

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

Die erste Zeile unter dem Lokbild zeigt die Kennung und in Klammern den Automatik-Modus.
Wenn die ausgewählte Lok in einem Block ist oder von einem zu einem anderen fährt, wird das auch in dieser Zeile angezeigt.
Wenn der Automatik-Modus idle oder wait ist, wird der Hintergrung rot. Anderenfalls ist er grün.

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.

Kehrt die logische Lok-Platzierung um.
Ein langer Klick tauscht die Block-Einfahrseite. (448+)

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 Lokbildes ö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 Lokbilder 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.

Den Absturz im Rocrail-andRoc-Forum mit folgenden Information melden:

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.

• Leere Schaltflächen?
• Unbrauchbares Layout?

Dies versuchen: Switch To The Stock Android Interface. (en)