Quelltext der Seite Z21 mobile/de

<languages/>
<br/>
{{Vorlage:Navigationsleiste Zentrale}}

[[Datei:Z21_logo.png|120px|right|link=Z21_mobile]]

== Beschreibung ==

Implementierung des UDP Protokoll von [http://www.z21.eu ROCO/Fleischmann Z21 LAN] für den [https://www.arduino.cc/en/pmwiki.php?n=Main/ArduinoEthernetShield Arduino mit Ethernet Shield (Chipsatz W5100)]. Es ist damit möglich die Modelleisenbahn mit einem Smartphone, Tablet oder Computer über WLAN/Netzwerk zu steuern. <br>
Anders als bei der [http://www.z21.eu/ Z21 von ROCO] ist es möglich mehr als zehn Smartphones, Computer und Tablets zu nutzen!
  Die Software würde auch mit einem Arduino ENC28J60 Ethernet Shield und der <br>[http://sourceforge.net/projects/pgahtow/files/Arduino%20%28v1.0%29%20libaries/UIPEthernet.zip UIPLibrary] getestet, aber diese Library kann nicht mit mehreren IP's kommunizieren, <br>wodurch keine Z21 mobile Steuerung möglich ist! <br>Bitte verwenden sie <u>nur</u> das Ethernet Shield <br>mit dem W5100 Chipsatz, welches für 4,80€ bei zum Beispiel: <br>[http://www.aliexpress.com/af/Arduino-ethernet-shield-w5100.html AliExpress] bestellt werden kann (Lieferzeit: ca. 5 Wochen).

'''Z21 LAN Protokoll:'''
:*[http://pgahtow.sourceforge.net/wordpress/wp-content/uploads/2017/06/Z21_LAN_Protokoll_V1.07.pdf Z21 LAN Protokoll Spezifikation V1.07]

== Arduino Z21 mobile Anschlussmöglichkeiten ==


=== <u>[[Special:MyLanguage/Zentrale | Arduino Z21 DCC Zentrale (Multitalent)]] </u> ===

[[File:Z21_Zentrale_wiring.jpg|thumb|Anschlüsse der Z21 DCC Zentrale]]
Die Arduino Z21 DCC Zentrale mit LAN, WLAN, Booster, S88N, XpressNet und LocoNet kann sehr flexibel auf den jeweiligen Einsatzbereich angepasst werden. Mit dieser ist es möglich zum Beispiel einen Adapter herzustellen um XpressNet Geräte am LocoNet anzuschließen ([[Special:MyLanguage/Z21_Arduino_Zentrale_(Atmega328p)#Arduino_UNO_XpressNet-LocoNet_Adapter|LocoNet to XpressNet Adapter]]). <br> Die Software, Hardware und Beschreibung zur Zentrale finden sie --> [[Special:MyLanguage/Zentrale|hier]]
<br />


=== <u>Z21 - LocoNet-Adapter</u> ===

[[File:Z21-LocoNet_wiring.jpg|thumb|Anschluss am LocoNet über Intellibox]]
"Z21 mobile" als LocoNet-Slave wie ein [[Special:MyLanguage/FredI |FRED]] oder DAISY Handregler nutzen: <br> 
Die App kann auch für den Betrieb an einer Intellibox genutzt werden. Aufgabe des Loconet Adapters ist es, die vom WLAN-Router empfangenen Signale, auf die Loconet-Schnittstelle der Intellibox zu übertragen.
Nachdem die Zentrale der Lok einen Slot zugeordnet hat, kann über die App die Lok angefragt werden. Der Adapter  schreibt  dann direkt in diesen Slot die Steuerdaten der APP. Der im Adapter eingesetzte Arduino UNO (ATmega328p) hat ausreichend Speicher für 120 LocoNet Slots und zusätzlich 30 IP-Adressspeicher.

In der Softwareversion 2 wurde zusätzlich ein XpressNet Master Interface integriert. Es können so auch XpressNet-Geräte Steuerbefehle auf dem LocoNet erzeugen (z.B. für den Anschluss von LokMaus2/MultiMaus an eine Intellibox).

'''Hardware:'''
Zur Verbindung mit dem [[Special:MyLanguage/Loconet | LocoNet-Protokoll]], wird die auch dort beschriebene Hardware benötigt.

'''Schaltplan:'''
:*[http://sourceforge.net/projects/pgahtow/files/Loconet/Arduino_Buffer/LN_Buffer_schematic.png LocoNet schematic]
:*[http://sourceforge.net/projects/pgahtow/files/Z21_mobile/DCC_Zentrale/Zentrale_for_ROCO_Booster_10761.png XpressNet schematic]

'''Software:'''

 <u>Hinweis:</u> Bitte die neuere Software der [[Special:MyLanguage/Zentrale|Arduino DCC Zentrale]],
 mit deaktiviertem LocoNet Slotserver (Client-Modus) verwendet werden.

Die Software ist mit der [http://pgahtow.de/?open=arduinoIDE Arduino IDE] geschrieben.
:*[http://sourceforge.net/projects/pgahtow/files/Z21_mobile/LocoNet/Z21_LocoNet_DIRECT_SLOT_v2.ino Arduino LocoNet DirectSlot Sketch Version 2 mit XpressNet Download]
:*[http://sourceforge.net/projects/pgahtow/files/Z21_mobile/LocoNet/Z21_LocoNet_DIRECT_SLOT_v1.ino Arduino LocoNet DirectSlot Sketch Version 1 Download]

'''Library:'''
:* [[Special:MyLanguage/Loconet#Download|Arduino LocoNet Library]]
:* [[Special:MyLanguage/XpressNet#XpressNet_Master|Arduino XpressNet Master Library]] - notwendig für Softwareversion 2 mit XpressNet!
<!--
:* [http://sourceforge.net/projects/pgahtow/files/Arduino%20%28v1.0%29%20libaries/UIPEthernet.zip Arduino UIPEthernet Library Download] <br>'''INFO:''' Keine Funktion bei Zugriffen von mehr als 1ner IP-Adresse! Bitte Standard Arduino Library und Ethernet Shield mit W5100 Chipsatz verwenden.-->
<br />


=== <u>Z21 - Slave am XpressNet</u> ===

[[File:XBus_Slave_wiring.gif|thumb|Anschluss am XpressNet über Roco Booster 10671, 10764 oder 10810]]
Mit einer LokMaus2 oder Multimaus als Master. Vergleichbare Steuerungen gibt es bereits von [http://www.digital-plus.de/pdf/b_23151_d.pdf Lenz], diese nutzt aber eine kostenpflichtige iOS APP. 

'''Hardware:'''
Zur Verbindung mit dem [[Special:MyLanguage/XpressNet | XpressNet-Protokoll]], wird die auch dort beschriebene Hardware benötigt. Die Netzwerkverbindung wird über ein W5100 Ethernet Shield hergestellt.

'''Software:'''
Die Software ist mit der [http://pgahtow.de/?open=arduinoIDE Arduino IDE] geschrieben.
 <u>Hinweis:</u> Bitte die Software der [[Special:MyLanguage/Zentrale|Arduino Z21 DCC Zentrale]],
 verwenden. Das XpressNet Interface erkennt automatisch den Slave Mode.
:*[https://sourceforge.net/projects/pgahtow/files/Z21_mobile/XpressNet_Slave/XpressNet_Z21_Ethernet_v2.1.ino Arduino XpressNet Version 2.1 Sketch Download] (mit S88 und DHCP)
:*[https://sourceforge.net/projects/pgahtow/files/Z21_mobile/XpressNet_Slave/XpressNet_Z21_Ethernet_v1.ino Arduino XpressNet Version 1 Sketch Download]

:* [https://github.com/schabauerj/Roco_Z21_Arduino alternative Implementierung meiner Software durch Johannes Schabauer]

'''Library:'''
:* [[Special:MyLanguage/XpressNet#XpressNet_Client|Arduino XpressNet Client Library]]
<br />

== ROCO Wartungstool ==

Für die Z21 gibt es eine [http://www.z21.eu/Downloads Wartungssoftware (Z21 Maintenance)]. Mit dieser können Loks vom PC gesteuert werden oder die IP-Adresse der Z21 geändert werden. <br>
'''Beachte:''' <span style="color: red;">Dieses Tool wird derzeit noch nicht von der Arduino Z21 Implementierung unterstützt!</span>

:* [http://sourceforge.net/projects/pgahtow/files/Z21_mobile/Z21_Maintenance_V1.10.zip Z21 Maintenance V1.10] - Tool
:* [http://sourceforge.net/projects/pgahtow/files/Z21_mobile/Z21%20Maintenance%20V1.10%20-%20Manual.pdf Z21 Maintenance V1.05] - Anleitung

== Z21 Anwendungen ==


=== Z21 mobile - APP für Android und iOS (Gratis) ===

:*[https://play.google.com/store/apps/details?id=vivid.planet.roco&hl=de „Z21 mobile“ Android-APP auf Google Play]
:*[https://itunes.apple.com/de/app/z21-mobile/id533805539?mt=8 „Z21 mobile“ für iPhone und iPod touch im App Store von iTunes]
:*[https://itunes.apple.com/de/app/z21-mobile-hd/id535465008?mt=8 „Z21 mobile HD“ für das iPad im App Store von iTunes]
:*[https://play.google.com/store/apps/details?id=hu.digitools.digitrains&hl=de "DigiTrains" Android-APP auf Google Play]

=== Z21 PC - kompatible Steuersoftware ===

:* [http://www.berros.eu/de/itrain/ iTrain ab V3.0]
:* [http://wiki.rocrail.net/doku.php Rocrail ab Rev. 4635]
:* [http://www.freiwald.com/seiten/traincontroller.htm TrainController ab V8.0 B4]
:* [http://home.planet.nl/~helde862/ModellStw/modellstw.htm ModellStellwerk ab V8.20]
:* [http://jmri.sourceforge.net/help/en/html/apps/DecoderPro/ JMRI DecoderPro ab V3.11]
:* [http://www.freiwald.com/seiten/trainprogrammer.htm TrainProgrammer ab V8.0 D1]


== Arduino Z21 Library ==

Die Software ist für die [http://pgahtow.de/?open=arduinoIDE Arduino IDE] geschrieben. Die Arduino Z21 Library ist in C++ geschrieben und kann mit verschiedenen Arduino's verwendet werden. Zur vereinfachten Kommunikation wurde eine Library erstellt, welche die Kommunikation mit dem Z21 LAN Protokoll realisiert. Die Library selbst stellt dabei keine Netzwerkkommunikation (LAN oder WLAN) her, sie dient lediglich dazu um die Empfangenen oder zu sendenden Daten zu Dekodieren bzw. zu Kodieren. 


=== Download ===

:*[http://sourceforge.net/projects/pgahtow/files/Arduino%20%28v1.0%29%20libaries/z21.zip Z21 LAN Protokoll Library v1.9 (19.06.17) Download] - Arduino Z21 LAN Protokoll Library

=== Dokumentation ===

<u>'''Änderungen:'''</u>
Version 1.5
* CV Rückmeldung bei der Programmierung
* Befehl für Ack Erkennung ergänzt
Version 1.3
* Anpassung LAN_LOCONET_DETECTOR
* Fehlerbeseitigung bei der LAN Prüfsumme
* Anpassung LAN_LOCONET_DISPATCH
* Anpassung POM Nachrichten (POM read byte)


====<u>'''Konfiguration'''</u>====

{| class="wikitable"| border="1" cellspacing="2" cellpadding="2"
!colspan="2" style="background-color: #ffffcc" |z21.h
|-
|Anzahl der Clients die gleichzeitig aktiv sind
|#define z21clientMAX 30
|-
|Anzahl (in 2 Sekunden Schritten) bis Deaktivierung eines Clients
|#define z21ActTimeIP 20<br> 2s * 20 = 40 Sekunden
|}
<br>


====<u>'''Anwendung und Funktionen'''</u>====

{| class="wikitable"| border="1" cellspacing="2" cellpadding="2"
|-
|#include <z21.h>
|Einbinden der Library
|-
|z21Class z21;
|Erzeugen der Klasse
|-
!style="background-color: #ffffcc" |void setup()
|-
|z21.setPower(csNormal);
|Setzten des Gleisspannungszustand
|-
!style="background-color: #ffffcc" |void loop()
|-
|}
<br>
{| class="wikitable"| border="1" cellspacing="2" cellpadding="2"
!colspan="2" style="background-color: #ffffcc" |other public functions
|-
|void receive(uint8_t client, uint8_t *packet);
|
|-
|void setPower(byte state);
|
|-
|byte getPower();
|
|-
|unsigned long getz21BcFlag (byte flag);
|
|-
!style="background-color: #ffffcc" |LocoNet
|-
|void setLNDetector(byte *data, byte DataLen);
|
|-
|void setLNMessage(byte *data, byte DataLen, byte bcType, bool TX);
|
|-
!style="background-color: #ffffcc" |Basic Accessory (Zubehör Befehle)
|-
|void setTrntInfo(uint16_t Adr, bool State);
|
|-
!style="background-color: #ffffcc" |Lokomotiven
|-
|void setLocoStateFull (int Adr, byte steps, byte speed, byte F0, byte F1, byte F2, byte F3, bool bc);
|
|-
!style="background-color: #ffffcc" |S88
|-
|void setS88Data(byte *data);
|
|}
<br>
{| class="wikitable"| border="1" cellspacing="2" cellpadding="2"
!colspan="2" style="background-color: #ffffcc" | C++ call back functions
|-
|void notifyz21EthSend(uint8_t client, uint8_t *data)
|
|-
|void notifyz21RailPower(uint8_t State)
|
|-
!style="background-color: #ffffcc" |LocoNet
|-
|void notifyz21LNdetector(uint8_t typ, uint16_t Adr)
|
|-
|uint8_t notifyz21LNdispatch(uint8_t Adr2, uint8_t Adr)
|
|-
|void notifyz21LNSendPacket(uint8_t *data, uint8_t length)
|
|-
!style="background-color: #ffffcc" |CV Programmierung
|-
|void notifyz21CVREAD(uint8_t cvAdrMSB, uint8_t cvAdrLSB)
|
|-
|uint8_t notifyz21CVWRITE(uint8_t cvAdrMSB, uint8_t cvAdrLSB, uint8_t value)
|
|-
|void notifyz21CVPOMWRITEBYTE(uint16_t Adr, uint16_t cvAdr, uint8_t value)
|
|-
|void notifyz21CVPOMREADBYTE(uint16_t Adr, uint16_t cvAdr)
|

|-
!style="background-color: #ffffcc" |Basic Accessory (Zubehör Befehle)
|-
|uint8_t notifyz21AccessoryInfo(uint16_t Adr)
|
|-
|void notifyz21Accessory(uint16_t Adr, bool state, bool active)
|
|-
!style="background-color: #ffffcc" |Lokomotiven
|-
|void notifyz21getLocoState(uint16_t Adr, bool bc)
|
|-
|void notifyz21LocoFkt(uint16_t Adr, uint8_t type, uint8_t fkt)
|
|-
|void notifyz21LocoSpeed(uint16_t Adr, uint8_t speed, uint8_t steps)
|
|-
!style="background-color: #ffffcc" |S88
|-
|void notifyz21S88Data()
|
|}