Quelltext der Seite 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:==
# [https://fablabwinti.ch/wp-content/uploads/ttn/lorix-programming-tool-1.0.6-64bit-Setup.exe LORIX Programmiertool] (für Windows) herunterladen und installieren.
# Firmware v1.3.3 für 256kB Version herunterladen ([https://fablabwinti.ch/wp-content/uploads/ttn/lorix-os-1.3.3+605df84_lorix-one-256.wimg lorix-os-1.3.3+605df84_lorix-one-256.wimg]).
# Programmiertool starten. 
# Firmware auswählen.
# Gateway über ein USB-Kabel mit dem PC verbinden.
# Gateway Stromversorgung über Ethernet/PoE verbinden.
# 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. 
# Der Gateway sollte nun vom Programmiertool erkannt worden sein. Nun den button '''Program''' klicken und abwarten, bis der Update fertig ist.
# Gateway rebooten durch Strom trennen und wieder verbinden.

== COM-Port des Gateways ermitteln:==
# Auf das Windows Startmenü klicken und damit anfangen '''geräte-manager''' einzutippen. 
# Sobald der Geräte-Manager im Suchfenster angezeigt wird, diesen anklicken.
# Im Geräte-Manager den Eintrag '''Anschlüsse (COM & LPT)''' durch klicken auf das '''>''' Symbol öffnen.
# 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, [https://the.earth.li/~sgtatham/putty/latest/w64/putty-64bit-0.76-installer.msi Putty] herunterladen und installieren.<br>
'''Putty''' starten, Verbindung auf Typ '''Serial''' umstellen, bei '''Serial line''' den ermittelten '''COMxx''' eingeben, '''Speed''' auf '''115200''' einstellen und dann '''Open''' klicken.<br>
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.<br>
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:==
[[Datei:LORIX One Web Interface.jpg|750px|thumb|right|LORIX MANAGER]] 
Öffne den Web-Browser und gib die ermittlete Gateway IP ins Adressfeld ein.<br>
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):
<br>
* 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.
<br>
<br>
[[Datei:Lorix-one-lora-settings-bs-lns.png|500px|thumb|right|LoRaWAN Netzwerk Server]]
<br>
<br>
* 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 [https://fablabwinti.ch/wp-content/uploads/ttn/ca.pem Root-Server-Zertifikat] herunterladen.
* Auf das Eingabefeld '''Server authentication certificate''' klicken und das heruntergeladene Zertifikat hochladen.
<br>
<br>
<br>
* 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.
<br>
<br>
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.
<br>
<br>
<br>
== 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.
<br>
<br>