Für das Projekt "Arduino weltweit steuern" wird ein Server benötigt, der als UDP Paket Relay funktioniert. Das Script wurde in Python programmiert und ist somit ohne Einschränkungen in der Regel mit allen Betriebssystemen kompatibel. Auf dieser Seite gibt es die Dokumentation zur Serversoftware.

Die Voraussetzungen

Damit das UDP Relay gestartet werden kann, wird die Installation von Python benötigt. Sollte das Relay öffentlich erreichbar sein, wird ein öffentlicher Server benötigt. Alternativ kann dieser Server auch Zuhause mit entsprechenden Portforwarding und einem dynamischen IP-Updater (DynDNS, NO-IP...) auf einem Raspberry betrieben werden. Das Script wurde unter Python3 getestet.

Wie das Relay funktioniert

Das Relay wird je nach Betriebssystem meistens über einen entsprechenden Befehl gestartet. Dadurch wird ein Socket auf den Port 9999 gestartet. Die Software wechselt anschließend in eine Schleife und wartet auf ein "Keep-Alive" vom Controller. Sobald sich dieser meldet und sich als "Arduino" ausgibt, ist dem Server der offene Port und die öffentliche IP-Adresse vom Controller bekannt. Ab sofort werden alle gültigen Befehle an diese IP-Adresse weitergeleitet. Sollte sich der Controller noch nicht beim Server gemeldet haben und es kommen trotzdem bereits Steuerbefehle vom Client, so sendet der Server eine entsprechende Fehlermeldung an den Client zurück. Wichtig ist, dass sich nach dem Programmstart zuerst immer der Controller beim Server melden muss, damit Steuerbefehle vom Client über den Server zum Controller gesendet werden können.

Hat sich der Controller beim Server angemeldet, so kann ab sofort über den Client jederzeit ein Steuerbefehl empfangen und weitergeleitet werden. Da aus dem Internet auch sehr viel "Müll" am Server ankommt, müssen die UDP Pakete entsprechend gefiltert werden. Unter "Müll" versteht man in diesem Fall UDP-Pakete, die von einem anderen System an den Server gesendet werden, aber eigentlich nicht dafür bestimmt sind (z. B. VoIP Anfragen usw.). Um eine Weiterleitung von falschen UDP-Paketen an den Controller zu verhindern, prüft die Software alle ankommenden Steuerbefehle. Sobald ein Befehl "CMD:" enthält, wird er an den Controller weitergeleitet. Umgekehrt erkennt der Server ein Datenpaket vom Controller, da sich dieser mit seinen Namen (Arduino) meldet. Kommt vom Controller ein Paket, wird es an die Adresse vom zuletzt verbundenen Client gesendet. Es können daher Steuerbefehle von beliebig vielen Clients gesendet werden, aber nur der Client, der zuletzt etwas zum Server gesendet hat, bekommt die Antwort.

Download Python Server (ZIP)

Code Beschreibung

In diesem Absatz sind die einzelnen Befehlszeilen beschrieben:

1: Import die Socket Bibliothek von Python
3: Aktiviert den Server auf allen Netzwerken
4: Definiert den Port, auf dem UDP Datenpakete empfangen werden
5: Der Name, mit dem sich der Mikrocontroller als dieser Identifiziert (Arduino)
7,13,14: Startet den Socket Server
8-12: Reservierung von Variablen, die vom Code automatisch beschrieben werden
15: Ausgabe -> Server wurde gestartet
17-52: Dieser Teil des Programmes läuft durchgehend in einer Schleife
19: Wenn der Server ein UDP-Paket empfängt, werden daraus die Nutzdaten und Informationen zu IP und Port übergeben 1024 = maximale Paketgröße
20: Ausgabe -> Inhalt des Datenpaketes und Absender IP, Port
21: Empfangene Nutzdaten (Steuerbefehle) werden in einen Buffer geladen
22: Der empfange Befehlssatz wird durch ";" aufgetrennt und in ein Array (data) zerlegt
23: Die Anzahl der Elemente im Array (data) werden ermittelt. | Bsp: ;Controllername;Steuerbefehl; = 4 Elemente (0;1;2;3)
24: Wenn das Array "data" vier Elemente enthält, wird der Code bis einschließlich Zeile 34 ausgeführt. (Trifft nur zu, wenn der Controller ein Paket sendet)
25,26: Deklariert Controllername und Controllerbefehl aus dem Array (data)
27: Prüft, ob das Datenpaket vom Arduino kommt (Vergleich mit Zeile 5)
28, 29: Identifiziert den Controller und speichert seine Adresse. An diese Adresse werden alle vom Client empfangenen Steuerbefehle gesendet
32: Leitet die Rückantwort vom Arduino nach einem Steuerbefehl an den Client weiter
34: Bestätigt dem Controller den Erhalt vom empfangenen Datenpaket
35: Führt die folgenden Befehle nur aus, wenn sich der Arduino zuvor bereits verbunden hat
36: Führt die folgenden Befehle nur aus, wenn das Array nur ein Element enthält (Ist nur der Fall, wenn ein Befehl vom Client kommt)
37: Führt die folgenden Befehle nur aus, wenn im Datenpaket "CMD:" vorkommt (Bsp: CMD:LED=1 -> wird verarbeitet, LED=1 -> wird abgelehnt)
40: Sendet empfangenen Steuerbefehl vom Client an den Controller weiter
41: Informiert den Client über die Weiterleitung vom Datenpaket zum Controller
42,43: Identifiziert den Client und speichert seine Adresse. An diese Adresse werden alle vom Controller empfangenen Datenpakete weitergeleitet
44-47: Fehlerfall: Wenn der Steuerbefehl vom Client nicht "CMD:" enthält
50-52: Fehlerfall: Wenn ein Steuerbefehl an den Server gesendet wird, aber der Controller noch nicht verbunden ist