Migration unserer LoRa Gateways auf TTN Stack v3

Unsere LORIX One Gateways verwenden bisher den TTN Stack v2. Dieser wird am 1.12.2021 abgeschaltet. Darum müssen die Gateways auf den TTN Stack v3 migriert werden. Da man für die Migration sowieso an den Gateway muss, kann bei dieser Gelegenheit auch gleich ein Firmware Update eingespielt werden.

Anleitung für den Firmware Update:

1. LORIX Programmiertool (für Windows) herunterladen und installieren.
2. Firmware v1.3.3 für 256kB Version herunterladen (lorix-os-1.3.3+605df84_lorix-one-256.wimg).
3. Programmiertool starten.
4. Firmware auswählen.
5. Gateway über ein USB-Kabel mit dem PC verbinden.
6. Gateway Stromversorgung über Ethernet/PoE verbinden.
7. Reset-Taste im Abstand von max. einer Sekunde zwei mal kurz (<1s) und ein mal lang (>3s) drücken. kurz-kurz-lang. Die blaue LED sollte nach dem langen Klick einmal aufblinken. Der Gateway befindet sich nun im Programmiermodus.
8. Der Gateway sollte nun vom Programmiertool erkannt worden sein. Nun den button Program klicken und abwarten, bis der Update fertig ist.
9. Gateway rebooten durch Strom trennen und wieder verbinden.

COM-Port des Gateways ermitteln:

1. Auf das Windows Startmenü klicken und damit anfangen geräte-manager einzutippen.
2. Sobald der Geräte-Manager im Suchfenster angezeigt wird, diesen anklicken.
3. Im Geräte-Manager den Eintrag Anschlüsse (COM & LPT) durch klicken auf das > Symbol öffnen.
4. Es sollte ein Anschluss namens Teensy USB Serial (COMxx) angezeigt werden. Der benötigt COM-Port steht in der Klammer.

Gateway vorbereiten:

Falls noch kein SSH Terminal vorhanden ist, Putty herunterladen und installieren.
Putty starten, Verbindung auf Typ Serial umstellen, bei Serial line den ermittelten COMxx eingeben, Speed auf 115200 einstellen und dann Open klicken.
Nun sollte ein Terminalfenster öffnen, in dem man mit "LORIX OS ..." und einem login Prompt begrüst wird. Der default User ist admin und das default Passwort ist lorix4u.

 > admin (+ENTER)
 > lorix4u (+ENTER)

Nun muss das Passwort auf den im Slack Channel der TTN-Fachgruppe mitgeteilten Wert geändert werden:

 > passwd (+ENTER) 
 > Current password: lorix4u (+ENTER)
 > New password: das Passwort aus dem Fachgruppen-Channel (+ENTER)
 > Retype new password: nochmal das selbe Passwort (+ENTER)

Falls das Gateway bisher noch nicht mit eurem Netwerk verbunden war, schliesst es jetzt an.
Nun braucht ihr die IP-Adresse des Gatways:

 > ifconfig

Unter eth0 wird nach inet addr: die entsprechende IP-Adresse angezeigt.

Weiter mit dem Web-Browser:

LORIX MANAGER

Öffne den Web-Browser und gib die ermittlete Gateway IP ins Adressfeld ein.
Es erscheint der Login-Screen der Gateway Web-Oberfläche.

 > Username: admin
 > Passwort: wie vorher geändert

Nach dem Login erscheint die Web-Oberfläche des Gateways (siehe rechts):

• Nun oben rechts auf den blauen CONFIGURE Button klicken und 4dBi Gain auswählen.
• Links im Menü System / Regional settings öffnen.
• Unter Timezone Zurich auswählen und unten rechts auf Save klicken.
• Links im Menü LoRa / Forwarder öffnen.
• Rechts oben den blauen Bleistift-Button anklicken.
• Im Forwarder Dropdown LoRa Basic Station auswählen und Apply klicken.

LoRaWAN Netzwerk Server

• Weiter unten bei LoRaWAN Network Server die Checkbox rechts einschalten:
• Bei Address: eu1.cloud.thethings.network und bei Port: 8887 eingeben.
• Die Checkbox Secured TLS connection aktivieren.
• Use certificate file auswählen.
• Das folgende Root-Server-Zertifikat herunterladen.
• Auf das Eingabefeld Server authentication certificate klicken und das heruntergeladene Zertifikat hochladen.

• Die Checkbox Client authentication einschalten.
• Use token auswählen.
• Im Feld Authentication token den passenden API-Key aus dem fg-ttn Channel eingeben.
• Weiter unten auf Save klicken.
• Dann noch weiter oben auf den grünen Start Button klicken und den Start des Forwarders abwarten.

Um ganz sicher zu sein, dass der Gateway sich mit dem TTN Netzwerk verbinden kann, könnt ihr den Logs Bereich aufklappen und die Einträge durchsuchen. Wenn ihr einen Eintrag "[TCE:VERB] Connected to MUXS." findet, funktioniert alles korrekt.

Firmware auf den letzten Stand bringen:

• Geht im linken Menü auf System / Update und klickt beim verfügbaren Update auf Download.
• Wenn der Download abgeschlossen ist, könnt ihr auf Install klicken.
• Sobald die Installation beendet und der Gateway neu gestartet ist, wird der Schritt 3 Verify and persist angezeigt.
• Wenn beide Punkte grün angezeigt werden, d.h. Networking: globally connected und LoRa Basic Station: running, war der Update erfolgreicht und ihr könnt mit Persist bestätigen.
• Falls etwas nicht in Ordnung ist, klickt ihr auf Rollback.
• Danach wird zwar Could not commit the update angezeigt, aber das ist ein bekannter Fehler.
• Lädt die Seite einfach neu (F5), dann sollte Your system is up to date angezeigt werden.

> Damit ist die Konfiguration abgeschlosen.