= OpenWrt bauen und installieren

---- dataentry asm22workshop ----
Titel          : OpenWrt bauen und installieren
Workshopleiter : Hauke
Wann           : Sonntag, 12:00-15:00
Wo             : Sprachschule 1
Dauer          : 2-3 Std
----


== Beschreibung
In diesem Workshop wollen wir OpenWrt bauen und die Konfiguration an unsere Anforderungen anpassen.
Im nächsten Schritt soll das von uns gebaute OpenWrt auf richtiger Hardware (Router / SBC / Switch) installiert werden. Hierfür können die Teilnehmer selber Hardware mitbringen oder Hauke stelle passende Geräte bereit.
Um Probleme in diesem Workshop und auch später besser Debuggen zu können soll eine UART / Serielle Konsole an dem Board angeschlossen werden.
Alle die eine UART an ihrem board anlöten möchten können 1 Stunde vor dem eigentliche Workshop in das Labor kommen wo wir die UART zusammen anlöten.

== Teilnahmevoraussetzungen
Basis Kenntnisse der Linux Konsole 

== Mitbringen
* Laptop 
* Linux System (entweder direkt auf dem Laptop oder als VM, Windows-Subsystem für Linux eher nicht, aarch64 ist ok)

== Material / Unkosten
* Eurer Router/SBC/Switch
** Wenn ihr OpenWrt in diesem Workshop auf eurem Gerät installieren wollt, schickt mir bitte vorher eine mail mit den genauen Namen des Routers damit ich gucken kann ob das einfach machbar ist
** Für den Workshop wollen wir einen UART/Serial Adapter verwenden, der muss meistens angelötet werden. Damit ist die Garantie erloschen.
** Ich bringe selber Hardware mit ihr könnt eines meiner Geräte verwenden
* 3,3V UART/Serial Adapter (Ich habe welche dabei, ihr könnt die ausleihen oder für 2€/Stück kaufen)

== Teilnehmer
Max. 8 (hängt von der Raumgröße ab)

^ Nummer  ^ Wer       ^
| 1       | B4ckBOne  |
| 2       | SebTM     |
| 3       | Avanti    |
| 4       | Rob       |
| 5       | DaN       |
| 6       |           |
| 7       |           |
| 8       |           |

== Extrawünsche an ASM Team ;-)
Ich hätte gerne einen Raum mit Tischen und einer Steckdose pro Teilnehmer. (Haben wir genug Mehrfachsteckdosen?)
Ich bräuchte das Labor mit Lötkolben für ca 1 Stunde vor dem eigentlichen Workshop um UART Anschlüsse an Router zu löten.

Es wäre sehr hilfreich, wenn mir jemand helfen könnte die Teilnehmern beim anlöten von UARTs zu unterstützen. Wenn du Interesse hast kontaktiere mich bitte.


== Folien

Hier sind die Folien: https://www.hauke-m.de/files/.muccc-2022/slides.pdf

== Commands

Git clone:
<code>
git clone git://git.openwrt.org/openwrt/openwrt.git
git checkout master
</code>

Abhängigkeiten
<code>
apt update
apt install build-essential gawk gcc-multilib flex git gettext libncurses5-dev libssl-dev python3-distutils zlib1g-dev
</code>
https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem

tftp boot im U-Boot
<code>
tftpboot ${loadaddr} 192.168.1.70:openwrt/targets/lantiq/xrx200/openwrt-lantiq-xrx200-tplink_tdw8970-initramfs-kernel.bin ; bootm ${loadaddr}
</code>


Screen
<code>
screen /dev/ttyUSB0 115200
</code>

tftp server
options aus /etc/default/atftpd
<code>
OPTIONS="--tftpd-timeout 300 --retry-timeout 5 --mcast-port 1758 --mcast-addr 239.239.239.0-255 --mcast-ttl 1 --maxthread 100 --verbose=5 /srv/tftp"
</code>


Add LuCI
<code>
./scripts/feeds install update
./scripts/feeds install luci-ssl
make menuconfig
</code>