Add installation guide for erx + mi4a #3
No reviewers
jkimmel
Labels
No Milestone
No Assignees
3 Participants
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: freifunk-franken/docs#3
Loading…
Reference in New Issue
No description provided.
Delete Branch "fbl/docs:devices"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Mir gefällt das schon alles ganz gut. Überlege aber auch mal in Zusammenhang mit #5, ob man noch andere Änderungen generell sinnvoll sind.
@ -0,0 +3,4 @@bookCollapseSection: truedate: 2022-12-01T17:25:00+01:00---Eine Kurzbeschreibung für das Kapitel wäre noch nett, damit etwas zum anzeigen da ist, wenn #4 gefixt ist.
Und zwar welcher Inhalt? Ich hab mich da schwer getan, weil eigentlich jedes Gerät da die gleiche Beschreibung hätte: "Besonderheiten bei der Installation auf <Gerät>"
Das ganze Hardwarekapitel war gemeint. Nicht die einzelnen Geräte.
Und mir ist aufgefallen, dass
HardwareunterFirmwareeinzusortieren vielleicht gar nicht so schlau ist. Vielleicht istHardwarebesser auf oberster Ebene anzusiedeln.#8
@ -0,0 +1,84 @@---title: "Ubiquiti ER-X / EP-R6"fehlt ER-X-SFP?
Wegreduziert, damit der Menüpunkt nicht zu lang wird.
Gefährlich... Denkt an die unbedarften. Das wird zu Rückfragen führen, wo denn jetzt der SFP ist
Also ich hätte es wirklich gerne mit drin. Wenn es nicht gut aussieht müssen wir ans CSS.
Ich hab da keine starke Meinung zu dem Thema. Ich traue der Community eigentlich schon zu, die Besonderheiten für den "ER-X-SFP" unter "ER-X" zu finden. Ich habs mit rein genommen.
@ -0,0 +17,4 @@Der mit einem aktualisierten Bootloader hinzu gekommene TFTP-Modus per Reset-Button erwartet ein signiertes Image und funktioniert daher nicht.{{< /hint >}}{{< tabs >}}Ich bin noch nicht vollständig überzeugt, dass Tabs hier das richtige sind. Sie verhindern, dass man die Seite durchsuchen kann. Und all zu viel Platz spart es in diesem Fall auch nicht.
Außerdem sieht man nicht mehr den Link zum initramfs, wenn man auf "Per TFTP" wechselt
Es blendet halt den Weg aus, den 95% der Nutzer sowieso nicht nutzen werden. Fand ich daher ganz praktisch.
Also ich bin einfach jemand, der einfach auch mal gerne über Sachen "stolpert" und dadurch lernt. Wenn wir alles ausblenden geht so etwas nicht. Und dass
Ctrl-Fnicht geht stinkt mir auch etwas. So gigantisch lange ist die Seite halt auch nicht, dass man da jetzt unbedingt an jedem Eck sparen müsste.Das mit den Tabs würde ich wirklich nur für äquivalente Sachen in verschiedener Form nehmen. Beispielsweise die selbe config für irgend etwas, aber in unterschiedlichen Formaten (z.B.
.ymlvs..toml)Ich hab es allerdings gerade mal angeschaut und ich glaube, da müssen wir einfach nochmal ans CSS und etwas mit Abständen und Schriftgrößen spielen. Ich gebe dir recht, insofern ist es für den Moment vielleicht übersichtlicher, langfristig möchte ich das aber umbauen.
Das Ziel und das Ergebnis sind identisch, daher passt das für mich eigentlich genau in das Konzept der Tabs.
Ich bin hier eigentlich schon sehr der Meinung dass die Seiten sowohl inhaltlich als auch optisch so kurz wie möglich sein sollten. Alles andere schreckt ab.
Und bei den Seiten der Gerätebesonderheiten ist das besonders wichtig, denn die sind essentieller Bestandteil der Erstinstallation.
Ggf. können wir dazu noch mal ein Issue auf machen. Das Umstellen zwischen Tabs und etwas ähnlichem äquivalentem geht ja schnell.
@ -0,0 +34,4 @@- Image hochladen und installieren{{< / tab >}}{{< tab "Per TFTP" >}}Es fehlt eine bemerkung die Datei herunterzuladen und umzubenennen, bzw. heißt die heruntergeladene Datei halt nicht
initramfs-kernel.bin@ -0,0 +36,4 @@{{< tab "Per TFTP" >}}- Über serielle Konsole anschließen- Während dem Booten die Option 1 auswählenEin schnipsel von der seriellen Konsole wäre natürlich auch hübsch.
Ist sehr lang, bietet aber nur wenig Mehrwert. Da TFTP eh nur für "advanced" User gedacht ist, habe ich das weggelassen. Ich habe jetzt aber auf das OpenWrt Wiki gelinkt, wo ein Schnipsel ist.
Tatsächlich wäre ein sauberer Soll-Zustand von der Konsole nicht verkehrt, gerde für Leute die das erste mal dran hocken, als Bestätigung, dass alles so ist wie es soll.
Evtl einen Dump in ein Tab, das kostet wenig Platz und ist schnell drin.
Dazu noch Datum / FW-Version als Kommentar in der ersten Zeile
@ -0,0 +37,4 @@{{< tab "Per TFTP" >}}- Über serielle Konsole anschließen- Während dem Booten die Option 1 auswählen- OpenWrt <code>initramfs-kernel.bin</code> übertragen<code>tag durch markdown ersetzenWeil
tftpauch immer wieder ein Schmerzpunkt ist, wäre es denke ich noch schlau noch einmal explizit zu sagen, welches Gerät der Server, welches der Client ist.Bei mir funktionierte Beispielsweise
in.tftpdaus demtftp-hpaPaket (voidlinux) bisher immer am besten.Wie man das auf anderen Distributionen oder Windows weiß ich nicht. Wenn es da zu viele Möglichkeiten gibt, sollten wir zumindest eine extra Seite zu TFTP Server starten erstellen.
TFTP Server soll auf jeden Fall eine eigene Seite bekommen.
Oder verlinkt hier eine vernünftige Anleitung von dritten, die potentiell lange erhalten bleibt. Reicht IMHO.
@ -0,0 +42,4 @@{{< / tabs >}}### Freifunk Firmware installierenMit dem nun installierten OpenWrt kann die Freifunk-Firmware über SSH geflasht werden.Ich lade das
initramfsmeistens ins Ram und installiere es eben nicht. Weiß nicht, ob man hier präziser sein muss, oder nicht.Per Web-UI wird es tatsächlich installiert. Ich habe das aber angepasst.
Falls ihr den Weg übern RAM nehmt, bitte die Anmerkung hinzufügen, dass der Router durch einen Neustart im OpenWRT wieder zurück auf Stock geht.
Ja ist eigentlich logisch, aber manchmal schaltet bei solchen Anleitungen das denken aus und der User arbeitet nur noch stumpf Schritte ab.
@ -0,0 +49,4 @@{{< /hint >}}- Über den Port `eth1` in OpenWrt einloggen- **IP-Konfiguration:** DHCPIP-Konfiguration vom Router oder Benutzer?
@ -0,0 +69,4 @@{{< /hint >}}## Ports für Layer3 KonfigurationBei dem Abschnitt bin ich mir noch nicht ganz sicher, was er kommunizieren soll.
Bemerkung:
Das OpenWRT Wiki hat an mehreren stellen die lan0:u Syntax gelistet. Ich kann aber im netifd dazu nichts finden. Gibt also scheinbar wirklich nur :*, :t, oder beides zusammen (was auch immer das bedeutet).
Wie die DSA Ports heißen, die man in die Gateway Konfiguration rein schreibt.
@ -0,0 +10,4 @@Es sind verschiedene Versionen des '''Xiaomi Mi 4A Gigabit''' im Umlauf, von denen sich aktuell einige nicht mit OpenWrt / Freifunk betreiben lassen.Geräte die ab September 2021 gefertigt wurden sind mit einem anderen SPI Flash ausgestattet, der aktuell nicht vom Linux Kernel unterstützt wird. Eine Firmwareaktualisierung dafür ist bereits [in Arbeit](https://git.freifunk-franken.de/freifunk-franken/firmware/pulls/268), diese Geräte werden bald nutzbar sein.Ich glaube hier muss noch einmal jemand nachsehen, der die Kommaregeln kennt :)
Ich denke so ists korrekt:
Ne, richtig ist glaube ich:
Spielt aber auch keine Rolle, die Info ist sowieso obsolet. Ich habe die aktuelle Fassung aus dem Wiki übernommen.
@ -0,0 +104,4 @@sysupgrade -n /tmp/fff-firmware.bin```## Ports für Layer3 KonfigurationBei dem Abschnitt bin ich mir noch nicht ganz sicher, was er kommunizieren soll.
Bemerkung:
Das OpenWRT Wiki hat an mehreren stellen die
lan0:uSyntax gelistet. Ich kann aber im netifd dazu nichts finden. Gibt also scheinbar wirklich nur:*,:t, oder beides zusammen (was auch immer das bedeutet).@ -0,0 +110,4 @@- `lan2:*` bzw. `lan2:t`## Links- [OpenWRT Wiki (Gigabit)](https://openwrt.org/toh/xiaomi/xiaomi_mi_router_4a_gigabit_edition)Der Link führt bei mir ins Leere.
dd25425d2ato6436e3012dÄnderungen:
6436e3012dto1cb6822d82Änderungen:
@ -0,0 +49,4 @@- Stok auslesen: Im Web UI einloggen. Die URL in der Adresszeile beinhaltet etwas wie `stok#3700b146c87e45fea51170f87f47d34c`### Exploit ausnutzenHierfür kann auch der [Anleitung des OpenWRTInvasion Explits](https://github.com/acecilia/OpenWRTInvasion) gefolgt werden.Tippfehler: Anleitung des OpenWRTInvasion Exploits
@ -0,0 +10,4 @@Es sind verschiedene Versionen des '''Xiaomi Mi 4A Gigabit''' im Umlauf, von denen sich aktuell einige nicht mit OpenWrt / Freifunk betreiben lassen.Geräte die ab September 2021 gefertigt wurden sind mit einem anderen SPI Flash ausgestattet. Diese werden erst ab Firmwareversion 20221201 unterstützt. Ältere Firmwares führen zu einer Bootloop und dürfen daher nicht installiert werden.Schau nochmal auf die Kommasetzung: "Geräte , die ... gefertigt wurden , sind ...
Bitte noch auf aktuellen master rebasen.
1cb6822d82tof99fe536b5Änderungen:
Danke!
jkimmel referenced this pull request2023-01-23 00:56:22 +01:00
@ -0,0 +8,4 @@{{< hint danger >}}**Achtung!**Es sind verschiedene Versionen des '''Xiaomi Mi 4A Gigabit''' im Umlauf, von denen sich aktuell einige nicht mit OpenWrt / Freifunk betreiben lassen.Mein Vorschlag:
"von denen sich einige aktuell noch nicht"
Ist IMHO flüssiger
@ -0,0 +10,4 @@Es sind verschiedene Versionen des '''Xiaomi Mi 4A Gigabit''' im Umlauf, von denen sich aktuell einige nicht mit OpenWrt / Freifunk betreiben lassen.Geräte, die ab September 2021 gefertigt wurden, sind mit einem anderen SPI Flash ausgestattet. Diese werden erst ab Firmwareversion 20221201 unterstützt. Ältere Firmwares führen zu einer Bootloop und dürfen daher nicht installiert werden.Wenn ihr ganz motiviert seid, verlinkt zu Begriffen wie zB "SPI Flash" eine Wikipediaseite oder eine andere Quelle, die grundlegend erklärt um was es geht. "DSA" ist ein schönes Beispiel. Wo ich das zum ersten mal googelte habe ich alles Mögliche gefunden. Ohne die ausgeschriebene Form gab es zu viele Treffer für die Abkürzung.
Alternativ wäre ein globaler Glossar gut, ufert aber auch schnell aus.
Vorschlag alternative Formulierung
". Ältere Firmwareversion führen"
Issue Anleitung DSA: #11
@ -0,0 +12,4 @@Geräte, die ab September 2021 gefertigt wurden, sind mit einem anderen SPI Flash ausgestattet. Diese werden erst ab Firmwareversion 20221201 unterstützt. Ältere Firmwares führen zu einer Bootloop und dürfen daher nicht installiert werden.Geräte mit Stock-Firmware 2.30.20 sind eine neue Hardware-Revision ("v2", "Xiaomi Router AC1200"). Diese lassen sich aktuell nicht mit OpenWrt / Freifunk betreiben.Erkennt man das lediglich an der FW-Version oder gibts Indikatoren auf die man bereits beim Kauf achten kann?
Ist das ("v2", "Xiaomi Router AC1200") im WebUi während der Inbetriebnahme ersichtlich oder muss man da in spezielle Menüs, CLI?
Weiß keiner so genau, denn bisher hatte niemand so ein Teil in der Hand.
Die Infos stammen aus dem OpenWrt Forum, woraus sich aber teilweise nicht ganz klar ableiten lässt, was gemeint ist.
Selbst wenn man beim Kauf darauf achten könnte: Kauft weiter, ich brauche so ein Ding.
@ -0,0 +17,4 @@## InstallationZum Überschreiben der Herstellerfirmware ist ein Exploit des Web-UI nötig: https://github.com/acecilia/OpenWRTInvasionVorschlag alternative Formulierung
"Um OpenWRT zu installieren ist ein Exploit"
oder
"Um OpenWRT zu flashen ist ein Exploit"
@ -0,0 +28,4 @@Für den Mi Router 4A 100m (nicht Gigabit) ist eine ältere Herstellerfirmware nötig, da OpenWrt nicht mit dem Partitionslayout der neueren kompatibel ist.{{< /hint >}}{{< details "Herstellerfirmware downgraden" >}}Diesen Punkt explizieter mit dem Hint darüber verknüpfen um klar zu machen, dass sich das immer noch ausschließlich auf 100m bezieht
@ -0,0 +43,4 @@- Router mit dem Internet verbinden (wichtig, da beim Installationsvorgang zusätzliche Daten vom Router aus dem Internet geladen werden müssen!)- entweder über den WAN-Port- oder per WiFi Client (Modus "WiFi Access Point", hier ändert sich allerdings die IP Adresse des Web-UI!)Ohne es zu wissen was dort steht, "Modus "WiFi Access Point"" klingt irgendwie falsch.
Ich hab aber auch keinen mehr auf Stock.
Ne, ist richtig.
@ -0,0 +48,4 @@- Mit **192.168.31.1** verbinden und Setup-Assistenten durchlaufen- Stok auslesen: Im Web UI einloggen. Die URL in der Adresszeile beinhaltet etwas wie `stok#3700b146c87e45fea51170f87f47d34c`### Exploit ausnutzen"Exploit ausnutzen" ist sicher richtig, die Formulierung klingt aber leicht abschreckend, als würde man was etwas bößes, verbotenes Hacken. -> Negative Konjunktion bei fachlich unbedarften
Evtl: "OpenWRTInvasion ausführen"
@ -0,0 +76,4 @@cd /tmpwget -O firmware.bin <firmware-url>```- Prüfsumme berechnen:Evtl irgendwo beschreiben warum und mit was man die Prüfsumme vergleichen muss und darauf verlinken.
Stört zwar bissle den Lesefluss, ist aber gutes Hintergrundwissen für Einsteiger.
Und als Hintergrundwissen darf es IMHO auf ner anderen Seite stehen
@ -0,0 +85,4 @@mtd -e OS1 -r write firmware.bin OS1```Theoretisch kann hier auch direkt die Freifunk Firmware heruntergeladen und geflasht werden.Kann man nicht, es gibt keine factory Version
Gibt es auch beim OpenWrt nicht, braucht man auch gar nicht. In dem sysupgrade-Image ist hier genau das drin was später in der Firmwarepartition steht, plus einige Metadaten am Ende, die aber nicht stören.
Steht übrigens auch oben: "OpenWrt sysupgrade Image" ;-)
@ -0,0 +100,4 @@scp -O ~/Downloads/fff-firmware.bin root@192.168.1.1:/tmp/ssh root@192.168.1.1# Wichtig: -n nicht vergessen!In ein < hint> packen?
oder wie in Zeile 97 in ** **?
Ich weiß nicht wie das am Ende aussieht, ist aber wichtig und sollte hervorgehoben werden
Ist schwer abzubilden, weil das ja im Code steht. Ich würde es dort auch nicht heraus Trennen. Wer das ganze Ding kopiert, kopiert es richtig. Wer die Befehle einzeln nachvollzieht ließt denke ich auch die Kommentare.
@ -0,0 +90,4 @@### Freifunk Firmware flashen- Über LAN-Port in OpenWrt einloggen- **IP:** 192.168.1.1- **User:** rootund kein Passwort
Genau, deswegen steht keins dabei. Es gibt auch nirgends eine Passwortabfrage iirc.
@ -0,0 +10,4 @@### OpenWrt installieren{{< hint info >}}Für den EP-R6 muss ein ausreichend aktuellen OpenWrt verwendet werden, damit die Installation per Web-UI funktioniert."muss ein ausreichend aktuelle
ns OpenWrt" Puh, das sieht man ja mega schlecht die Formatierung. Das n ist falsch, ich wünsche mir ein sWelche Minimalversion?
Den Rechtschreibfehler habe ich verstanden, da hast du auch Recht.
Den Rest dieses Kommentars verstehe ich nicht.
Wenn ihr wisst, ab welcher OpenWRT das funktioniert, schreibt am besten die Version mit hin, sonst fragt sich der Unbedarfte, was ausreichend bedeutet.
Oder umformulieren, dass man die neuste nehmen soll, da der eben etwas zickig ist.
-> Klare Botschaft, kein Interpretationsspielraum
@ -0,0 +13,4 @@Für den EP-R6 muss ein ausreichend aktuellen OpenWrt verwendet werden, damit die Installation per Web-UI funktioniert.{{< /hint >}}{{< hint info >}}Die Installation per TFTP funktioniert nur, wenn der TFTP-Modus über die serielle Konsole aktiviert wird.Ich finds unten beim Mi 4a schön, wie ihr schlicht sagt, welche Option im Bootloader nötig ist, damit TFTP geht
@ -0,0 +14,4 @@{{< /hint >}}{{< hint info >}}Die Installation per TFTP funktioniert nur, wenn der TFTP-Modus über die serielle Konsole aktiviert wird.Der mit einem aktualisierten Bootloader hinzu gekommene TFTP-Modus per Reset-Button erwartet ein signiertes Image und funktioniert daher nicht.hat aber dafür folgende Vorteile, warum man ihn dennoch haben will: ...
@ -0,0 +18,4 @@{{< /hint >}}{{< tabs >}}{{< tab "Per Web-UI" >}}Vorschlag alternative Formulierung:
"Für die Installation über das Hersteller Web-UI ist ein spezielles initramfs Image verwendet werden.
Dieses, sowie Informationen zur verwendeten OpenWrt-Version und Konfigurationf findet ihr hier: https://fw.sgstbr.de/tools/edgerouter-x/"
@ -0,0 +20,4 @@{{< tabs >}}{{< tab "Per Web-UI" >}}Für die Installation über das Hersteller Web-UI kann ein spezielles initramfs Image verwendet werden.Leider fehlt dieses Image in den OpenWrt Downloads, da die Standardkonfiguration zu groß ist.Eigentlich eine unnötige Info, da wir normal immer nur auf dev.fff verweisen
Keine unnötige Information, da dieses Image bei uns ebenfalls nicht heraus fällt. Unsere Konfiguration dürfte noch größer sein.
Der beste Weg wäre in diesem Fall eigentlich erst mal OpenWrt zu installieren und dann Freifunk, aber das geht eben genau aus diesem Grund auch nicht. Damit sich keiner fragt, warum man das bei OpenWrt vergeblich sucht, stehts da.
@ -0,0 +89,4 @@### Freifunk Firmware flashen- Über LAN-Port in OpenWrt einloggen- **IP:** 192.168.1.1Analog zum ER-X Guide Zeile 30 DHCP erwähnen
@ -0,0 +27,4 @@- Web UI öffnen und einloggen- **Port:** `eth0`- **IP-Konfiguration:** statisch, `192.168.1.2/24`Würde ich weglassen. Keine spezifische IP notwendig und so viel Wissen sollte wirklich vorhanden sein.
In dem Fall das "statisch" in Zeile 31 schieben und auf "Kein DHCP" umbenennen
@ -0,0 +29,4 @@- **Port:** `eth0`- **IP-Konfiguration:** statisch, `192.168.1.2/24`- **IP des Routers:** `192.168.1.1`- **User:** ubntSiehe Mi 4A Zeile 70 -> Am besten auf eine Darstellungsvariante für Logindaten einigen und durchgängig nutzen
@ -0,0 +31,4 @@- **IP des Routers:** `192.168.1.1`- **User:** ubnt- **Passwort:** ubnt- Image hochladen und installierenBeim Mi4a habt ihr den Pfad zum Upload angegeben
@ -0,0 +40,4 @@- [EdgeRouter X](https://downloads.openwrt.org/releases/22.03.2/targets/ramips/mt7621/openwrt-22.03.2-ramips-mt7621-ubnt_edgerouter-x-initramfs-kernel.bin)- [Edgerouter X SFP / EdgePoint R6](https://downloads.openwrt.org/releases/22.03.2/targets/ramips/mt7621/openwrt-22.03.2-ramips-mt7621-ubnt_edgerouter-x-sfp-initramfs-kernel.bin)Das heruntergeladene Image booten (vgl. [OpenWrt Wiki](https://openwrt.org/inbox/toh/ubiquiti/ubiquiti_edgerouter_x_er-x_ka#serial_installation_with_tftp)):Das heruntergeladene Image booten, siehe [OpenWrt Wiki]
Ich habe mich für "vgl" entschieden, weil das nur eine Referenz ist. Zur Step-by-Step Installation aber eigentlich nicht nötig, da der Vorgang ja in den Unterpunkten beschrieben wird.
@ -0,0 +41,4 @@- [Edgerouter X SFP / EdgePoint R6](https://downloads.openwrt.org/releases/22.03.2/targets/ramips/mt7621/openwrt-22.03.2-ramips-mt7621-ubnt_edgerouter-x-sfp-initramfs-kernel.bin)Das heruntergeladene Image booten (vgl. [OpenWrt Wiki](https://openwrt.org/inbox/toh/ubiquiti/ubiquiti_edgerouter_x_er-x_ka#serial_installation_with_tftp)):- Über serielle Konsole anschließen ([pinout](https://openwrt.org/toh/ubiquiti/edgerouter_x_er-x_ka#serial))"Serielle Konsole anschließen"
oder
"Über serielle Konsole verbinden"
@ -0,0 +34,4 @@- Image hochladen und installieren{{< / tab >}}{{< tab "Per TFTP" >}}Ich hatte damals zu beginn das Problem einen passenden USB Adapter zu finden.
Obwohl ich nachgefragt habe, hab ich beim ersten Anlauf einen inkompatiblen gekauft.
Für jemanden ohne Vorwissen in dem Bereich sind das alles Bömische Dörfer.
-> Hinweiß auf nötige Kriterien / relevante Schlagworte / Link zu einem geeigneten Adapter (könnte evtl schwierig werden bei den kurzen Lebenszeiten der Chinadinger)
Dafür sollten wir eine extra Anleitung anlegen, da das ganze nicht Gerätespezifisch ist, oder aufs OpenWrt Wiki verweisen.
Für den ER-X ist das aber zum Glück gar nicht erforderlich. Deshalb ist die Installation per TFTP ja auch in einem extra Tab, was by-default ausgeblendet ist.
@ -0,0 +43,4 @@Das heruntergeladene Image booten (vgl. [OpenWrt Wiki](https://openwrt.org/inbox/toh/ubiquiti/ubiquiti_edgerouter_x_er-x_ka#serial_installation_with_tftp)):- Über serielle Konsole anschließen ([pinout](https://openwrt.org/toh/ubiquiti/edgerouter_x_er-x_ka#serial))- Während dem Booten die Option 1 auswählen- Das heruntergeladene `-initramfs-kernel.bin` per TFTP bereitstellen:"per TFTP übertragen"
@ -0,0 +45,4 @@- Während dem Booten die Option 1 auswählen- Das heruntergeladene `-initramfs-kernel.bin` per TFTP bereitstellen:```shmkdir tftpverwendetes Packet erwähnen (ja, klingt trivial, kann aber helfen)
@ -0,0 +52,4 @@```- Image per TFTP über eth0 booten (den Anweisungen des Bootloaders folgen)Es ist nun ein OpenWrt gebootet, mit dem nun die Freifunk Firmware installiert werden kann.Aus dem nun gebooteten OpenWRT könnt ihr jetzt die Freifunk Firmware installieren
Für solche Passagen empfehle ich fertige Textbausteine, bzw. maximal viel copy und paste aus einer "Master" Anleitung.
-> Durchgängige Formulierung für leichteres Wiedererkennen innerhalb der einzelnen Geräteanleitungen
Ja, eine extra seite für TFTP ist definitiv nötig, hatte nur bis jetzt noch kein Issue: #10
Textbausteine sind eventuell auch noch eine gute Ergänzung für #5
@ -0,0 +57,4 @@{{< / tabs >}}### Freifunk Firmware installierenMit dem nun laufenden OpenWrt kann die Freifunk-Firmware über SSH geflasht werden.Entweder diese Zeile oder Zeile 55 löschen. Ist doppelt gemoppelt
Wieder ein schönes Beispiel für unterschiedliche Formulierungen für die gleiche Information
@ -0,0 +59,4 @@### Freifunk Firmware installierenMit dem nun laufenden OpenWrt kann die Freifunk-Firmware über SSH geflasht werden.{{< hint info >}}Vergleiche Absatz mit Mi 4a Anleitung
@ -0,0 +63,4 @@OpenWrt verwendet eine andere Portkonfiguration, daher muss jetzt auf den Port `eth1` gewechselt werden.{{< /hint >}}- Über den Port `eth1` in OpenWrt einloggenVergleiche Absatz mit Mi 4a Anleitung
@ -0,0 +72,4 @@scp -O ~/Downloads/fff-firmware.bin root@192.168.1.1:/tmp/ssh root@192.168.1.1# Wichtig: -n nicht vergessen!Siehe meinen Kommentar im Mi 4a Guide Zeile 183
@ -0,0 +104,4 @@sysupgrade -n /tmp/fff-firmware.bin```## Ports für Layer3 KonfigurationPortbelegung bei node erwähenen Analog zum ER-X Guide
@ -0,0 +109,4 @@- `lan1:*` bzw. `lan1:t`- `lan2:*` bzw. `lan2:t`## LinksEvtl generell zusätzlich die OpenWRT Installationsanleitung verlinken für Hintergrundinfos
@ -0,0 +92,4 @@- `eth3:*` bzw. `eth3:t`- `eth4:*` bzw. `eth4:t`- Nur für ERX-SFP und EP-R6Nur für ERX-SFP und EP-R6 (SFP Port)
@ -0,0 +75,4 @@# Wichtig: -n nicht vergessen!sysupgrade -n /tmp/fff-firmware.bin```Irgendwo muss der Zugriff via fdff::1 rein + Nutzung der Client Ports.
Durchgängig wäre in den einzelnen Guides, aber es bläht diese halt wieder auf.
Wenn man es kurz und knackig bekommt, packt es in die Guides, wenn ihr es ausführlich wollt, verlinkt es.
@ -0,0 +77,4 @@```{{< hint info >}}Die Portbelegung des Routers ändert sich abermals, dieses mal auf den von Freifunk gewohnten Standard:Anmerkung zum Absatz sowie 87ff:
Auch hier wäre eine Einheitliche formulierung schön, die man in allen Guides identisch wiederfindet.
Das hilft allgemein wie schon erwähnt sehr, dass man die Infos mit der Zeit schnell wiederfindet, da Position sowie Suchbegriff irgendwann im Hirn abgespeichert werden
@ -0,0 +79,4 @@{{< hint info >}}Die Portbelegung des Routers ändert sich abermals, dieses mal auf den von Freifunk gewohnten Standard:- **eth0:** WAN- **eth1, eth2:** BATMAN (falls node-Firmware)Evtl etwas kleinkarriert, aber was ist bei nicht node-Firmware?
-> Auf wie IQ wollt ihr rücksicht nehmen und wo liegt eure Schwelle für logisches Mitdenken
@ -0,0 +33,4 @@- Mit gedrückter Reset-Taste Strom verbinden und warten bis die LED orange blinkt- DHCP Server bereitstellen, mit einem der beiden LAN-Port verbinden- Auf dem Default-Gateway einen TFTP Server starten, Firmware als `test.bin` ablegen- Beispiel für TFTP unter Linux:Mein Windows Favorit: "tftpd64"
https://pjo2.github.io/tftpd64/
Simpel, AFAIK weit verbreitet und es gibt Guides
@ -0,0 +32,4 @@- Ältere Herstellerfirmware herunterladen: [bigota.miwifi.com](https://bigota.miwifi.com/xiaoqiang/rom/r4ac/miwifi_r4ac_firmware_e9eec_2.18.58.bin)- Mit gedrückter Reset-Taste Strom verbinden und warten bis die LED orange blinkt- DHCP Server bereitstellen, mit einem der beiden LAN-Port verbinden- Auf dem Default-Gateway einen TFTP Server starten, Firmware als `test.bin` ablegenWieder einmal, einheitliche Textbausteine verwenden, siehe TFTP Block beim ER-X
Ich hab gerade auf docs.fff nach der aktuellen Version dieser Guides gesucht, aber ist ja noch nicht online.
Vorschlag:
Kennzeichnet solche Seiten, die noch in Arbeit sind mit einen "Draft", "Entwurf", etc. und veröffentlicht diese direkt.
Am besten noch per CI nach jedem merge.
Das hilft Leuten wie mir, die nur etwas im Browser mithelfen wollen ohne das komplette Entwicklungssetup zu installieren.
(zB Formatierungen "in echt" anzusehen, generell grafische Kommentare abzugeben, oder einfach den reinen Fließtext zu lesen)
Ist online, weil schon gemerged ("Zusammengeführt"). Aktuell zu finden unter Firmware -> Hardware: https://docs.freifunk-franken.de/firmware/hardware/ubiquiti-edgerouter-x/
"Entwicklungssetup": hugo installieren, in das Verzeichnis gehen,
hugo server. Seite im Browser angucken.Ob man Draft-Seiten mit vertretbarem Aufwand umsetzen könnte muss lemmi sagen.
Mir fällt dazu einfach keine gute Lösung ein, solange wir https://woodpecker-ci.org/ nutzen und die Pipeline im selben Repository1 beschreiben.
Man müsste die Pipeline eigentlich getrennt vom Inhalt verwalten, dann gäbe es vielleicht die Möglichkeit alles zu bauen und irgendwo hin zu veröffentlichen. Im aktuellen Zustand kann man es aus Sicherheitsgründen nicht bedingungslos immer rendern.
Für https://git.freifunk-franken.de/freifunk-franken/firmware haben wir den Kompromiss gewählt, dass man einzelne Änderungen manuell zum Bauen freischalten kann, aber die Funktion würde hier leider nicht viel bringen, weil du ja schnelles Feedback willst und nicht erst darauf warten willst, dass jemand auf ein ein Knöpfchen drückt.
Auf Seiten, die weniger intensiv spezielle Features vom Theme benutzen, bekommt man aber auch einfach eine gute Vorschau von Gitea geliefert.
In PRs kann man die Ansicht mit View File wechseln:
Wenn du so am herumklicken bist, kannst du den View Rendered Button benutzen:
Wenn du eine Seite zum editieren offen hast, dann gibt es ebenfalls ein Preview tab:
Man müsste mal testen, ob man den selben Webhook in einem anderen Repository verwendern kann. Also
woodpecker.ymlin einem separaten Repository verwalten, den Webhook aber (zusätzlich) in einem anderen Repository eintragen. ↩︎