Firmware selber bauen: Unterschied zwischen den Versionen

Aus Freifunk Dresden - Anwender-Wiki
Zur Navigation springen Zur Suche springen
(update ubuntu dependencies)
 
(28 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
−
Die Firmware kann entweder unter [http://download.freifunk-dresden.de/ | Download] fertig kompiliert herrunter geladen werden<br/>
+
[[Category:Dokumentation]][[Category:Firmware]]
−
oder man kann sich diese selber bauen.<br/>
+
Die Firmware kann entweder unter [http://download.freifunk-dresden.de/ Download] fertig kompiliert herruntergeladen werden oder man kann sich diese selber bauen.
  
−
Ein Knoten, welcher aus diesen Repository gebaut wird, taucht dann als 'Alternativer' Knoten in der Hotspot Liste auf.
+
Ein Knoten, welcher aus diesem Repository gebaut wird, taucht dann als 'Alternativer' Knoten in der Hotspot-Liste auf.
 
Werden keine weiteren Anpassungen gemacht, erfüllt dieser die [[Knoten Spezifikation]].
 
Werden keine weiteren Anpassungen gemacht, erfüllt dieser die [[Knoten Spezifikation]].
  
−
Bei Anpassungen, müssen diese Spezifikationen aber weiterhin sichergestellt sein !<br>Falls das nicht möglich ist, bitte kontaktiert Freifunk Dresden dies bezüglich. Dann können wir sehen in wie weit davon abgewichen werden kann.
+
Bei Anpassungen müssen diese Spezifikationen aber weiterhin sichergestellt sein! Falls das nicht möglich ist, bitte kontaktiert Freifunk Dresden diesbezüglich. Dann können wir sehen, inwieweit davon abgewichen werden kann.
  
 
Hinter dieser Spezifikation stecken verschiedene Ideen, um anderen Leuten eine bestimmte Funktionalität zu garantieren.
 
Hinter dieser Spezifikation stecken verschiedene Ideen, um anderen Leuten eine bestimmte Funktionalität zu garantieren.
  
 
= Quellcode =
 
= Quellcode =
−
== Github ==
 
−
Github enthält einen relativen stabilen Softwarestand. Jede freigegebene Software erhält einen Tag.
 
  
−
  https://github.com/Freifunk-Dresden/firmware-freifunk-dresden
+
== Haupt Git-Repository ==
 +
Das Haupt Repository ist öffentlich (schreibgeschützt) enthält immer jede Änderung.
 +
Der Hauptserver implementiert dazu einen Linux-Container.
 +
  HTTPS: https://gitlab.freifunk-dresden.de/firmware-developer/firmware.git
 +
SSH: ssh://git@git.freifunk-dresden.de:2201/~/firmware.git
  
−
== Internes Git-Repository ==
+
== Github ==
−
Das interne Repository steht nur dem Entwicklerteam zur Verfügung und enthält immer jede Änderung. Dieses Repository wird regelmässig auf einem externem RAID5 gesichtert. Es liegt dabei aber selbst auf einem RAID 1.
+
Github enthält einen relativen stabilen Softwarestand,wird aber nur in größeren Abständen synchronisiert.<br/>
−
 
+
https://github.com/Freifunk-Dresden/firmware-freifunk-dresden
−
Der Hauptserver implementiert dazu einen Linux-Container. Der Zugang dazu ist privat.
 
−
ssh://git@git.freifunk-dresden.de:2201/~/firmware.git
 
  
 
== Firmware Bauen ==
 
== Firmware Bauen ==
  
 
=== Entwicklungsumgebung ===
 
=== Entwicklungsumgebung ===
−
Die Entwicklungsumgebung ist ein Linux. Die Firmware wurde bisher immer auf einem Ubuntu System entwickelt.<br>
+
Die Entwicklungsumgebung ist ein Linux. Die Firmware wurde bisher immer auf einem Ubuntu-System entwickelt. Bei Nutzung anderer Linux-Distributionen müssen evt. weitere Softwarepakete installiert werden, die hier nicht aufgeführt sind.
−
Bei Nutzung andere Linux Distributionen müssen evt weitere Softwarepakete installiert werden, die hier nicht aufgeführt sind.
 
  
−
'''System:''' mind. Ubuntu 16.04/18.04 64bit (z. B.: Ubuntu-Mate)
+
[[Datei:Firmbuspei.JPG|200px|thumb|right|]]
 +
'''System:''' mind. Ubuntu 20.04 64bit auch in VM möglich. 
 +
'''Es empfiehlt sich:'''
 +
* unbedingt die Verwendung einer SSD
 +
* mindestens 8GB RAM (besser 16GB)
 +
* soviel Kerne wie möglich
 +
* für einen kompletten Build Version (8.1.4 ca. 100GB) (8.1.7 ca. 165GB) freien Platz auf dem Massenspeicher (12/2022)
 +
* geschätzte Dauer mit 16 Kernen Ryzen 9 9590X + M2.SSD = 2 Stunden (12/2022)
 +
 +
'''Benötigte Softwarepakete'''
 +
https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem
  
−
'''Benötigte Softwarepakete'''
+
* Aktualisieren der Paketliste und bereits installierter Pakete:
 +
  apt-get update && apt-get full-upgrade -y
 +
 
 +
* Falls notwendig (z.B. in Dockercontainern oder auf Serverinstallationen, wo es fehlt).<br/> ''DEBIAN_FRONTEND'' ist notwendig wenn Timezone Pakete installiert und konfiguriert werden sollen. Diese erfordern normalerweise eine Nutzerinteraktion, was aber beim Installieren in Docker-Containern nicht möglich ist.
 +
  DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends tzdata
 +
 
 +
* Installieren der notwendigen Pakete
 +
<pre>
 +
# Ubuntu bis Version 22.04 (bei 24.04 hat Ubuntu noch mehr Zeug eingeschränkt,
 +
# so dass wichtige Pakete nicht mehr verfügbar sind)
 +
apt-get install -y nodejs git build-essential devscripts debhelper \
 +
                dh-systemd python python3 python3-distutils dh-python libssl-dev libncurses5-dev unzip \
 +
                gawk zlib1g-dev subversion gcc-multilib flex gettext curl \
 +
                wget time rsync jq \
 +
                python3-pip python3-pypathlib python-pathlib2 python-scandir \
 +
                automake autoconf m4
 +
#-----------------------------------------------------------------------------------------------------------
 +
# Debian 12 (empfohlen)
 +
apt-get install nodejs git build-essential devscripts debhelper python3 python3-distutils \
 +
                libssl-dev libncurses5-dev unzip gawk zlib1g-dev subversion \
 +
gcc-multilib flex gettext curl wget time rsync jq tmux
  
−
  apt-get install unzip wget time rsync jq gawk gettext
+
  # installiere python2 (nur wenn Openwrt 18 images gebaut werden sollen)
−
apt-get install git subversion build-essential flex python
+
  echo "deb http://archive.debian.org/debian/ stretch contrib main non-free" > /etc/apt/sources.list.d/debian-archive.list
−
apt-get install libssl-dev libncurses5-dev zlib1g-dev zlib1g-dev gcc-multilib
+
  apt update
 +
  apt install python2
 +
</pre>
  
−
=== Firmware Checkout ===
+
=== Firmware-Checkout ===
  
−
Um die Firmware auf den eigenen Rechner zu bringen wird das Kommando ''git'' verwendet. Wechsel dazu im Usermodus auf dem Entwicklungsrechner (wo die Firmware gebaut werden soll) in ein Verzeichnis, in welchem ''git'' das eigentliche  
+
Um die Firmware auf den eigenen Rechner zu bringen, wird das Kommando ''git'' verwendet. Wechsel dazu <span style="color: red"> im '''Usermodus''' (Nicht ROOT!)</span> auf dem Entwicklungsrechner (wo die Firmware gebaut werden soll) in ein Verzeichnis, in welchem ''git'' das eigentliche Firmware-Verzeichnis anlegen soll.
−
Firmware Verzeichnis anlegt.
 
  
−
  git clone https://github.com/ddmesh/firmware-freifunk-dresden.git
+
  git clone https://gitlab.freifunk-dresden.de/firmware-developer/firmware.git
−
  cd firmware-freifunk-dresden
+
  cd firmware
  
 
=== Firmware konfigurieren ===
 
=== Firmware konfigurieren ===
−
Die Firmware kann für verschieden Plattformen (Chipsets) gebaut werden.<br>
+
Die Firmware kann für verschieden Plattformen (Chipsets) gebaut werden. Alle aktuell unterstützten Plattformen/Geräte sind in <code>build.targets</code> definiert. Abhängig von der gewählten Plattform werden entweder gleich alle Router-Firmware-Varianten gebaut oder es muss jedes einzelne Geräte angegeben werden.
−
Alle aktuell unterstützten Plattformen/Geräte sind in <code>build.targets</code> definiert.<br>
 
−
Abhängig von der gewählten Plattform, werden entweder gleich alle Router-Firmware-Varianten gebaut oder
 
−
es MUSS jedes einzelne Geräte angegeben werden.
 
  
−
Dabei gibt es für jede dieser Zeilen ein eigenes Config-File im Verzeichnis ''lede-configs''.
+
Dabei gibt es für jede dieser Zeilen ein eigenes Config-File im Verzeichnis ''openwrt-configs''. Für mehr Informationen dazu siehe die Kommentare in diesem File.
−
Für mehr Informationen dazu siehe die Kommentare in diesem File.
 
  
 +
=== Firmware bauen ===
  
−
=== Firmware bauen ===
 
 
Das Bauen übernimmt dann das Script <code> build.sh</code>.
 
Das Bauen übernimmt dann das Script <code> build.sh</code>.
  
−
./build.sh all
+
<pre style="font-size: 10px;">
 +
$ ./build.sh  
 +
Version: 13
 +
usage: build.sh list | search <string> | clean | feed-revisions | (target | all | failed [menuconfig ] [rerun] [ <make params ...> ])
 +
list            - lists all available targets
 +
list-targets    - lists only target names for usage in IDE
 +
search          - search specific router (target)
 +
clean            - cleans buildroot/bin and buildroot/build_dir (keeps toolchains)
 +
feed-revisions  - returns the git HEAD revision hash for current date (now).
 +
                    The revisions then could be set in build.json
 +
target          - target to build (can have regex)
 +
          that are defined by build.json. use 'list' for supported targets.
 +
          'all'                  - builds all targets
 +
          'failed'                - builds only previously failed or not built targets
 +
          'ramips.*'              - builds all ramips targets only
 +
          'ramips.rt305x.generic' - builds exact this target
 +
          '^rt30.*'              - builds all that start with 'rt30'
 +
          'ramips.mt7621.generic ar71xx.tiny.lowmem' - space or pipe separates targets
 +
          'ramips.mt7621.generic | ar71xx.tiny.lowmem'
  
−
Alle Parameter dahinter werden an den make Prozess weiter geleitet.
+
menuconfig      - displays configuration menu
−
"list" zeigt die verfügbaren pfade an, ohne parameter erscheint die hilfe.
+
rerun            - enables a second compilation with make option 'V=s'
−
~/firmware-freifunk-dresden$ ./build.sh list
+
                    If first make failes a second make is tried with this option
−
  ar71xx.tiny                                        
+
make params      - all paramerters that follows are passed to make command
−
  ar71xx.generic                          
+
</pre>
−
  x86.generic                            
+
''list'' liefert Informationen über die aktuell möglichen Targets. Verschiede Targets können dabei
−
  ramips.mt7621.ubiquiti-edgerouter-x     
+
aber mit verschiedenen Versionen von openwrt, feeds, files gebaut werden. Das hängt davon ab, wie die
−
  ipq40xx.generic
+
Unterstützung durch openwrt noch gegeben ist.
 +
<pre style="font-size: 10px;">
 +
~/firmware$ ./build.sh list
 +
build locally.
 +
----------------------------------+------------+---------+----------+---------+---------+---------+------------------------------
 +
  Name                            | Openwrt    | Openwrt | Openwrt | Feeds  | Files  | Patches | Build date
 +
                                  | Revision  | Variant | Selector |        |        |        |
 +
----------------------------------+------------+---------+----------+---------+---------+---------+------------------------------
 +
+ ar71xx.generic.lowmem          | 5625f5bc3  | lowmem  | 18.06    | 18.06  | 18.06  | 18.06  | So 4. Dez 17:42:41 CET 2022
 +
+ ar71xx.tiny.lowmem              | 5625f5bc3  | lowmem  | 18.06    | 18.06  | 18.06  | 18.06  | So 4. Dez 17:44:57 CET 2022
 +
+ ath79.generic                  | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:01:39 CET 2022
 +
+ ath79.generic.gl-mifi          | 42a15ca37 |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:05:15 CET 2022
 +
+ ath79.nand                      | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:08:09 CET 2022
 +
+ ath79.small                    | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:10:54 CET 2022
 +
+ ath79.small.smallbuffers        | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:13:15 CET 2022
 +
+ ipq40xx.generic                | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:21:49 CET 2022
 +
+ ipq40xx.generic.fritz-tffs-nand | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:24:20 CET 2022
 +
+ lantiq-xrx200.generic          | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:26:56 CET 2022
 +
+ lantiq-xrx200.small            | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:29:11 CET 2022
 +
+ lantiq-xway.generic            | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:31:40 CET 2022
 +
+ lantiq-xway.small              | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:33:55 CET 2022
 +
+ mediatek.mt7622.generic         | 677e3c18f  |        | 22.03    | 22.03  | 22.03  | 22.03  | So 4. Dez 18:44:09 CET 2022
 +
+ mpc85xx.p1020                  | 42a15ca37 |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:51:56 CET 2022
 +
+ ramips.mt7620.generic           | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 18:59:40 CET 2022
 +
+ ramips.mt7620.small            | 42a15ca37 |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 19:01:56 CET 2022
 +
+ ramips.mt7621.generic          | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 19:04:45 CET 2022
 +
- ramips.mt7621.generic.22        | 677e3c18f  |        | 22.03    | 22.03  | 22.03  | 22.03  | So 4. Dez 19:06:55 CET 2022
 +
+ ramips.mt7621.offloader        | 42a15ca37 |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 19:09:12 CET 2022
 +
+ ramips.mt76x8.generic           | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 19:11:28 CET 2022
 +
+ ramips.rt305x.tiny.lowmem      | 5625f5bc3  | lowmem  | 18.06    | 18.06  | 18.06  | 18.06  | So 4. Dez 19:17:38 CET 2022
 +
+ sunxi.cortexa7.offloader        | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 19:21:08 CET 2022
 +
+ x86.64.offloader                | 42a15ca37  |        | 21.02    | 21.02  | 21.02  | 21.02  | So 4. Dez 19:36:46 CET 2022
 +
----------------------------------+------------+---------+----------+---------+---------+---------+------------------------------
 +
</pre>
  
 
=== Neue Plattformen hinzufügen ===
 
=== Neue Plattformen hinzufügen ===
 +
 +
Das Hinzufügen neuer Targets ist etwas komplex.
 +
Wenn ein Router hinzugefügt werden soll, für den es ein Target bereits existiert, so sollte das '''generic''' target genutzt werden. <br>
 +
Beispiel (sobald der Befehl ausgeführt wird, werden evtl. bereits erstellte Targets gelöscht):
 +
 +
./build.sh ar71xx.generic menuconfig
 +
 +
Nun wird die Konfiguration von openwrt angezeigt, in der ein neuer Router hinzugefügt werden kann. Alles andere bleibt unverändert. Nach dem Speichern und beenden, wird das entsprechende Config-File in openwrt-config/.../ automatisch angepasst.<br>
 +
Gebaut wird dann mit
 +
 +
./build.sh ar71xx.generic
 +
 +
Muss eine neue Plattform angelegt werden, so erfolgt diese in mehreren Schritten:<br/>
 +
* Anlegen eines neuen Eintrages in ''build.json'' .Meist wird generic verwendet, nur bei speziellen Anpassungen kann hier ein anderer Name spezifiziert werden. Dieses dient dazu verschiedene Openwrt-Buildumgebungen nebeneinander zu halten, die unterschiedliche Patches beinhalten.<br/>Hat man zwei Router mit speziellen nachträglichen Anpassungen (via patches), so können diese sich gegenseitig stören und Funktionalitäten unkontrolliert beeinflussen. Damit das nicht passiert, können für eine Plattform diese Build-Umgebungen getrennt werden.
 +
* Aufruf des Buildsystems mit 'menuconfig'
 +
./build.sh platform.generic menuconfig
 +
Unterhalb des Konfigurationsverzeichnisses ''openwrt-config'' gibt es für jede unterstützte Openwrt Version ein eigenes Verzeichnis (18.06, 19.04, 21.04).<br/>
 +
Hier liegt bereits eine ''default'' configuration, die beim Aufruf von ''build.sh'' automatisch als Vorlage dient, so dass mit dem Konfigurationsmenu nur noch die Freifunk Dresden spezifischen Dinge gewählt werden müssen.

Aktuelle Version vom 10. September 2024, 21:46 Uhr

Die Firmware kann entweder unter Download fertig kompiliert herruntergeladen werden oder man kann sich diese selber bauen.

Ein Knoten, welcher aus diesem Repository gebaut wird, taucht dann als 'Alternativer' Knoten in der Hotspot-Liste auf. Werden keine weiteren Anpassungen gemacht, erfüllt dieser die Knoten Spezifikation.

Bei Anpassungen müssen diese Spezifikationen aber weiterhin sichergestellt sein! Falls das nicht möglich ist, bitte kontaktiert Freifunk Dresden diesbezüglich. Dann können wir sehen, inwieweit davon abgewichen werden kann.

Hinter dieser Spezifikation stecken verschiedene Ideen, um anderen Leuten eine bestimmte Funktionalität zu garantieren.

Quellcode

Haupt Git-Repository

Das Haupt Repository ist öffentlich (schreibgeschützt) enthält immer jede Änderung. Der Hauptserver implementiert dazu einen Linux-Container. 

HTTPS: https://gitlab.freifunk-dresden.de/firmware-developer/firmware.git
SSH: ssh://git@git.freifunk-dresden.de:2201/~/firmware.git

Github

Github enthält einen relativen stabilen Softwarestand,wird aber nur in größeren Abständen synchronisiert.
https://github.com/Freifunk-Dresden/firmware-freifunk-dresden

Firmware Bauen

Entwicklungsumgebung

Die Entwicklungsumgebung ist ein Linux. Die Firmware wurde bisher immer auf einem Ubuntu-System entwickelt. Bei Nutzung anderer Linux-Distributionen müssen evt. weitere Softwarepakete installiert werden, die hier nicht aufgeführt sind.

Firmbuspei.JPG

System: mind. Ubuntu 20.04 64bit auch in VM möglich. 

Es empfiehlt sich: 
* unbedingt die Verwendung einer SSD
* mindestens 8GB RAM (besser 16GB) 
* soviel Kerne wie möglich
* für einen kompletten Build Version (8.1.4 ca. 100GB) (8.1.7 ca. 165GB) freien Platz auf dem Massenspeicher (12/2022) 
* geschätzte Dauer mit 16 Kernen Ryzen 9 9590X + M2.SSD = 2 Stunden (12/2022)

Benötigte Softwarepakete https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem

  • Aktualisieren der Paketliste und bereits installierter Pakete:
  apt-get update && apt-get full-upgrade -y
  • Falls notwendig (z.B. in Dockercontainern oder auf Serverinstallationen, wo es fehlt).
    DEBIAN_FRONTEND ist notwendig wenn Timezone Pakete installiert und konfiguriert werden sollen. Diese erfordern normalerweise eine Nutzerinteraktion, was aber beim Installieren in Docker-Containern nicht möglich ist.
  DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends tzdata
  • Installieren der notwendigen Pakete
 # Ubuntu bis Version 22.04 (bei 24.04 hat Ubuntu noch mehr Zeug eingeschränkt, 
 # so dass wichtige Pakete nicht mehr verfügbar sind)
 apt-get install -y nodejs git build-essential devscripts debhelper \
                dh-systemd python python3 python3-distutils dh-python libssl-dev libncurses5-dev unzip \
                gawk zlib1g-dev subversion gcc-multilib flex gettext curl \
                wget time rsync jq \
                python3-pip python3-pypathlib python-pathlib2 python-scandir \
                automake autoconf m4
 #-----------------------------------------------------------------------------------------------------------
 # Debian 12 (empfohlen)
 apt-get install nodejs git build-essential devscripts debhelper python3 python3-distutils \
                libssl-dev libncurses5-dev unzip gawk zlib1g-dev subversion \
		gcc-multilib flex gettext curl wget time rsync jq tmux

 # installiere python2 (nur wenn Openwrt 18 images gebaut werden sollen)
  echo "deb http://archive.debian.org/debian/ stretch contrib main non-free" > /etc/apt/sources.list.d/debian-archive.list
  apt update
  apt install python2

Firmware-Checkout

Um die Firmware auf den eigenen Rechner zu bringen, wird das Kommando git verwendet. Wechsel dazu im Usermodus (Nicht ROOT!) auf dem Entwicklungsrechner (wo die Firmware gebaut werden soll) in ein Verzeichnis, in welchem git das eigentliche Firmware-Verzeichnis anlegen soll. 

git clone https://gitlab.freifunk-dresden.de/firmware-developer/firmware.git
cd firmware

Firmware konfigurieren

Die Firmware kann für verschieden Plattformen (Chipsets) gebaut werden. Alle aktuell unterstützten Plattformen/Geräte sind in build.targets definiert. Abhängig von der gewählten Plattform werden entweder gleich alle Router-Firmware-Varianten gebaut oder es muss jedes einzelne Geräte angegeben werden.

Dabei gibt es für jede dieser Zeilen ein eigenes Config-File im Verzeichnis openwrt-configs. Für mehr Informationen dazu siehe die Kommentare in diesem File.

Firmware bauen

Das Bauen übernimmt dann das Script build.sh. 

$ ./build.sh 
Version: 13
usage: build.sh list | search <string> | clean | feed-revisions | (target | all | failed [menuconfig ] [rerun] [ <make params ...> ])
 list             - lists all available targets
 list-targets     - lists only target names for usage in IDE
 search           - search specific router (target)
 clean            - cleans buildroot/bin and buildroot/build_dir (keeps toolchains)
 feed-revisions   - returns the git HEAD revision hash for current date (now).
                    The revisions then could be set in build.json
 target           - target to build (can have regex)
          that are defined by build.json. use 'list' for supported targets.
          'all'                   - builds all targets
          'failed'                - builds only previously failed or not built targets
          'ramips.*'              - builds all ramips targets only
          'ramips.rt305x.generic' - builds exact this target
          '^rt30.*'               - builds all that start with 'rt30'
          'ramips.mt7621.generic ar71xx.tiny.lowmem' - space or pipe separates targets
          'ramips.mt7621.generic | ar71xx.tiny.lowmem' 

 menuconfig       - displays configuration menu
 rerun            - enables a second compilation with make option 'V=s'
                    If first make failes a second make is tried with this option
 make params      - all paramerters that follows are passed to make command

list liefert Informationen über die aktuell möglichen Targets. Verschiede Targets können dabei aber mit verschiedenen Versionen von openwrt, feeds, files gebaut werden. Das hängt davon ab, wie die Unterstützung durch openwrt noch gegeben ist. 

~/firmware$ ./build.sh list
build locally.
----------------------------------+------------+---------+----------+---------+---------+---------+------------------------------
  Name                            | Openwrt    | Openwrt | Openwrt  | Feeds   | Files   | Patches | Build date
                                  | Revision   | Variant | Selector |         |         |         |
----------------------------------+------------+---------+----------+---------+---------+---------+------------------------------
+ ar71xx.generic.lowmem           | 5625f5bc3  | lowmem  | 18.06    | 18.06   | 18.06   | 18.06   | So 4. Dez 17:42:41 CET 2022
+ ar71xx.tiny.lowmem              | 5625f5bc3  | lowmem  | 18.06    | 18.06   | 18.06   | 18.06   | So 4. Dez 17:44:57 CET 2022
+ ath79.generic                   | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:01:39 CET 2022
+ ath79.generic.gl-mifi           | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:05:15 CET 2022
+ ath79.nand                      | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:08:09 CET 2022
+ ath79.small                     | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:10:54 CET 2022
+ ath79.small.smallbuffers        | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:13:15 CET 2022
+ ipq40xx.generic                 | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:21:49 CET 2022
+ ipq40xx.generic.fritz-tffs-nand | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:24:20 CET 2022
+ lantiq-xrx200.generic           | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:26:56 CET 2022
+ lantiq-xrx200.small             | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:29:11 CET 2022
+ lantiq-xway.generic             | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:31:40 CET 2022
+ lantiq-xway.small               | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:33:55 CET 2022
+ mediatek.mt7622.generic         | 677e3c18f  |         | 22.03    | 22.03   | 22.03   | 22.03   | So 4. Dez 18:44:09 CET 2022
+ mpc85xx.p1020                   | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:51:56 CET 2022
+ ramips.mt7620.generic           | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 18:59:40 CET 2022
+ ramips.mt7620.small             | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 19:01:56 CET 2022
+ ramips.mt7621.generic           | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 19:04:45 CET 2022
- ramips.mt7621.generic.22        | 677e3c18f  |         | 22.03    | 22.03   | 22.03   | 22.03   | So 4. Dez 19:06:55 CET 2022
+ ramips.mt7621.offloader         | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 19:09:12 CET 2022
+ ramips.mt76x8.generic           | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 19:11:28 CET 2022
+ ramips.rt305x.tiny.lowmem       | 5625f5bc3  | lowmem  | 18.06    | 18.06   | 18.06   | 18.06   | So 4. Dez 19:17:38 CET 2022
+ sunxi.cortexa7.offloader        | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 19:21:08 CET 2022
+ x86.64.offloader                | 42a15ca37  |         | 21.02    | 21.02   | 21.02   | 21.02   | So 4. Dez 19:36:46 CET 2022
----------------------------------+------------+---------+----------+---------+---------+---------+------------------------------

Neue Plattformen hinzufügen

Das Hinzufügen neuer Targets ist etwas komplex. Wenn ein Router hinzugefügt werden soll, für den es ein Target bereits existiert, so sollte das generic target genutzt werden.
Beispiel (sobald der Befehl ausgeführt wird, werden evtl. bereits erstellte Targets gelöscht): 

./build.sh ar71xx.generic menuconfig

Nun wird die Konfiguration von openwrt angezeigt, in der ein neuer Router hinzugefügt werden kann. Alles andere bleibt unverändert. Nach dem Speichern und beenden, wird das entsprechende Config-File in openwrt-config/.../ automatisch angepasst.
Gebaut wird dann mit 

./build.sh ar71xx.generic

Muss eine neue Plattform angelegt werden, so erfolgt diese in mehreren Schritten:

  • Anlegen eines neuen Eintrages in build.json .Meist wird generic verwendet, nur bei speziellen Anpassungen kann hier ein anderer Name spezifiziert werden. Dieses dient dazu verschiedene Openwrt-Buildumgebungen nebeneinander zu halten, die unterschiedliche Patches beinhalten.
    Hat man zwei Router mit speziellen nachträglichen Anpassungen (via patches), so können diese sich gegenseitig stören und Funktionalitäten unkontrolliert beeinflussen. Damit das nicht passiert, können für eine Plattform diese Build-Umgebungen getrennt werden.
  • Aufruf des Buildsystems mit 'menuconfig'
./build.sh platform.generic menuconfig

Unterhalb des Konfigurationsverzeichnisses openwrt-config gibt es für jede unterstützte Openwrt Version ein eigenes Verzeichnis (18.06, 19.04, 21.04).
Hier liegt bereits eine default configuration, die beim Aufruf von build.sh automatisch als Vorlage dient, so dass mit dem Konfigurationsmenu nur noch die Freifunk Dresden spezifischen Dinge gewählt werden müssen.

Abgerufen von „https://wiki.freifunk-dresden.de/index.php?title=Firmware_selber_bauen&oldid=6903“