Message ID | 20190126183032.25786-7-ffml@duering-andreas.de |
---|---|
State | Accepted |
Headers | show |
diff --git a/README.md b/README.md index 1301c8c..1421377 100644 --- a/README.md +++ b/README.md @@ -9,20 +9,20 @@ Weitere Informationen gibt es auf <https://freifunk.net/> und auf <https://wiki. # Firmware selbst kompilieren ## Benutzung des Buildscripts -### Prerequisites -* `apt-get install zlib1g-dev lua5.2 build-essential unzip libncurses-dev gawk git subversion realpath libssl-dev` (Sicherlich müssen noch mehr Abhängigkeiten Installiert werden, diese Liste wird sich hoffentlich nach und nach Füllen. Ein erster Ansatzpunkt sind die Abhängigkeiten von OpenWrt selbst) +### Voraussetzungen +* `apt-get install zlib1g-dev lua5.2 build-essential unzip libncurses-dev gawk git subversion realpath libssl-dev` (Sicherlich müssen noch mehr Abhängigkeiten installiert werden, diese Liste wird sich hoffentlich nach und nach füllen. Ein erster Ansatzpunkt sind die Abhängigkeiten von OpenWrt selbst) * `git clone https://github.com/FreifunkFranken/firmware.git` * `cd firmware` ### Erste Schritte -Je nach dem, für welche Hardware die Firmware gebaut werden soll muss das BSP gewählt werden: +Je nachdem, für welche Hardware die Firmware gebaut werden soll, muss das BSP gewählt werden: * `./buildscript selectbsp bsp/board_ar71xx.bsp` * Um die vorhandenen BSPs zu sehen, kann `./buildscript selectbsp help` ausgeführt werden. ## Was ist ein BSP? Ein BSP (Board-Support-Package) beschreibt, was zu tun ist, damit ein Firmware Image für eine spezielle Hardware gebaut werden kann. -Typischerweise ist eine folgene Ordner-Struktur vorhanden: +Typischerweise ist eine Ordner-Struktur wie folgt vorhanden: * .config * root_file_system/ * etc/ @@ -34,7 +34,7 @@ Typischerweise ist eine folgene Ordner-Struktur vorhanden: * crontabs/ * root -Die Daten des BSP werden nie alleine verwendet. Zu erst werden immer die Daten aus dem "default"-BSP zum Ziel kopiert, erst danach werden die Daten des eigentlichen BSPs dazu kopiert. Durch diesen Effekt kann ein BSP die "default" Daten überschreiben. +Die Daten des BSP werden nie alleine verwendet. Zuerst werden immer die Daten aus dem "default"-BSP zum Ziel kopiert, erst danach werden die Daten des eigentlichen BSPs dazu kopiert. Durch diesen Effekt kann ein BSP die "default" Daten überschreiben. ## Die Verwendung des Buildscripts Die BSP-Datei wird durch das Buildscript automatisch als dot-Script geladen, somit stehen dort alle Funktionen zur Verfügung. @@ -43,15 +43,15 @@ Das Buildscript generiert ein dynamisches sed-Script. Dies geschieht, damit die ### `./buildscript prepare` * Sourcen werden in einen separaten src-Folder geladen, sofern diese nicht schon da sind. Zu den Sourcen zählen folgende Komponenten: * OpenWrt - * Sämtliche Packages (ggfs werden Patches angewandt) + * Sämtliche Packages (ggf. werden Patches angewandt) -* Ein ggfs altes Target wird gelöscht +* Ein ggf. altes Target wird gelöscht * OpenWrt wird ins Target exportiert (kopiert) * Eine OpenWrt Feed-Config wird mit dem lokalen Source Verzeichnis als Quelle angelegt * Die Feeds werden geladen * Spezielle Auswahl an Paketen wird geladen * Patches werden angewandt -* board_prepare() aus dem BSP wird aufgerufen (wird. z.B. fur Patches für eine bestimmte HW verwendet) +* board_prepare() aus dem BSP wird aufgerufen (wird. z.B. für Patches für eine bestimmte Hardware verwendet) ### `./buildscript config openwrt` Um das Arbeiten mit den .config-Datien von OpenWrt zu vereinfachen, bietet das Buildscript die Möglichkeit das `menuconfig` von OpenWrt aufzurufen. Nachdem man die gewünschten Einstellungen vorgenommen hat, hat man die Möglichkeit, die frisch editierte Konfiguration in das BSP zu übernehmen. @@ -126,7 +126,7 @@ reboot ``` ### Einstellungen testen und ins BSP übernehmen -Wenn jetzt die Ports immer noch alle korrekt funktionieren kann man die datei auf den eigenen PC kopieren: +Wenn jetzt die Ports immer noch alle korrekt funktionieren kann man die Datei auf den eigenen PC kopieren: ``` scp root@[ipv6ll%scope]:/etc/network.tl-wr1043nd-v2 /path/to/git/firmware/bsp/wr1043nd/root_file_system/etc/network.tl-wr1043nd-v2 ```
Reviewed-by: Adrian Schmutzler <freifunk@adrianschmutzler.de> Auch hier habe ich wieder selbst noch was gefunden, was ich noch gleich mit ändern würde. Siehe unten. Schön, dass sich auch mal jemand Zeit für Ordnung nimmt. > -----Original Message----- > From: franken-dev [mailto:franken-dev-bounces@freifunk.net] On Behalf > Of Andreas Düring > Sent: Samstag, 26. Januar 2019 19:31 > To: franken-dev@freifunk.net > Subject: [PATCH v2 6/7] Apply grammar and spell fixes > > From: Andreas Düring <gh@duering-andreas.de> > > Signed-off-by: Andreas Düring <gh@duering-andreas.de> > --- > v2: Neu dazugekommen, nicht vorhanden in v1. > --- > README.md | 18 +++++++++--------- > 1 file changed, 9 insertions(+), 9 deletions(-) > > diff --git a/README.md b/README.md > index 1301c8c..1421377 100644 > --- a/README.md > +++ b/README.md > @@ -9,20 +9,20 @@ Weitere Informationen gibt es auf > <https://freifunk.net/> und auf <https://wiki. > # Firmware selbst kompilieren > > ## Benutzung des Buildscripts > -### Prerequisites > -* `apt-get install zlib1g-dev lua5.2 build-essential unzip libncurses-dev gawk > git subversion realpath libssl-dev` (Sicherlich müssen noch mehr > Abhängigkeiten Installiert werden, diese Liste wird sich hoffentlich nach und > nach Füllen. Ein erster Ansatzpunkt sind die Abhängigkeiten von OpenWrt > selbst) > +### Voraussetzungen > +* `apt-get install zlib1g-dev lua5.2 build-essential unzip > +libncurses-dev gawk git subversion realpath libssl-dev` (Sicherlich > +müssen noch mehr Abhängigkeiten installiert werden, diese Liste wird > +sich hoffentlich nach und nach füllen. Ein erster Ansatzpunkt sind die > +Abhängigkeiten von OpenWrt selbst) > * `git clone https://github.com/FreifunkFranken/firmware.git` > * `cd firmware` > > ### Erste Schritte > -Je nach dem, für welche Hardware die Firmware gebaut werden soll muss > das BSP gewählt werden: > +Je nachdem, für welche Hardware die Firmware gebaut werden soll, muss > das BSP gewählt werden: > > * `./buildscript selectbsp bsp/board_ar71xx.bsp` > * Um die vorhandenen BSPs zu sehen, kann `./buildscript selectbsp help` > ausgeführt werden. > > ## Was ist ein BSP? > Ein BSP (Board-Support-Package) beschreibt, was zu tun ist, damit ein > Firmware Image für eine spezielle Hardware gebaut werden kann. > -Typischerweise ist eine folgene Ordner-Struktur vorhanden: > +Typischerweise ist eine Ordner-Struktur wie folgt vorhanden: > * .config > * root_file_system/ > * etc/ > @@ -34,7 +34,7 @@ Typischerweise ist eine folgene Ordner-Struktur > vorhanden: > * crontabs/ > * root > > -Die Daten des BSP werden nie alleine verwendet. Zu erst werden immer die > Daten aus dem "default"-BSP zum Ziel kopiert, erst danach werden die Daten > des eigentlichen BSPs dazu kopiert. Durch diesen Effekt kann ein BSP die > "default" Daten überschreiben. > +Die Daten des BSP werden nie alleine verwendet. Zuerst werden immer die > Daten aus dem "default"-BSP zum Ziel kopiert, erst danach werden die Daten > des eigentlichen BSPs dazu kopiert. Durch diesen Effekt kann ein BSP die > "default" Daten überschreiben. > > ## Die Verwendung des Buildscripts > Die BSP-Datei wird durch das Buildscript automatisch als dot-Script geladen, > somit stehen dort alle Funktionen zur Verfügung. > @@ -43,15 +43,15 @@ Das Buildscript generiert ein dynamisches sed-Script. > Dies geschieht, damit die ### `./buildscript prepare` > * Sourcen werden in einen separaten src-Folder geladen, sofern diese nicht > schon da sind. Zu den Sourcen zählen folgende Komponenten: > * OpenWrt > - * Sämtliche Packages (ggfs werden Patches angewandt) > + * Sämtliche Packages (ggf. werden Patches angewandt) > > -* Ein ggfs altes Target wird gelöscht > +* Ein ggf. altes Target wird gelöscht > * OpenWrt wird ins Target exportiert (kopiert) > * Eine OpenWrt Feed-Config wird mit dem lokalen Source Verzeichnis als > Quelle angelegt > * Die Feeds werden geladen > * Spezielle Auswahl an Paketen wird geladen > * Patches werden angewandt > -* board_prepare() aus dem BSP wird aufgerufen (wird. z.B. fur Patches für > eine bestimmte HW verwendet) > +* board_prepare() aus dem BSP wird aufgerufen (wird. z.B. für Patches > +für eine bestimmte Hardware verwendet) Nach "wird" muss der Punkt weg. > > ### `./buildscript config openwrt` > Um das Arbeiten mit den .config-Datien von OpenWrt zu vereinfachen, > bietet das Buildscript die Möglichkeit das `menuconfig` von OpenWrt > aufzurufen. Nachdem man die gewünschten Einstellungen vorgenommen > hat, hat man die Möglichkeit, die frisch editierte Konfiguration in das BSP zu > übernehmen. > @@ -126,7 +126,7 @@ reboot > ``` > > ### Einstellungen testen und ins BSP übernehmen -Wenn jetzt die Ports > immer noch alle korrekt funktionieren kann man die datei auf den eigenen > PC kopieren: > +Wenn jetzt die Ports immer noch alle korrekt funktionieren kann man die > Datei auf den eigenen PC kopieren: > ``` > scp root@[ipv6ll%scope]:/etc/network.tl-wr1043nd-v2 > /path/to/git/firmware/bsp/wr1043nd/root_file_system/etc/network.tl- > wr1043nd-v2 > ``` > -- > 2.11.0