Dies ist die Beschreibung wie man selber die Firmware baut und ist eher etwas für geübte Leute.

===== Voraussetzungen =====
Die Bielefelder Freifunk-Software besteht aus einer OpenWRT Installation mit Zusatzmodulen.\\
Unsere Konfiguration befindet sich [[https://github.com/freifunk-bielefeld/firmware|hier]].
Um selber die Firmware zu bauen, wird ein GNU/Linux-System wie z.B. Debian/Ubuntu/Arch/Gentoo benötigt.

Unter Debian oder Ubuntu müssen noch folgende Programme installiert werden (hier mittels apt-get über die Kommandozeile):
  sudo apt-get install git subversion g++ libncurses5-dev gawk zlib1g-dev build-essential
 
Falls noch Pakete fehlen sollten, kann [[http://wiki.openwrt.org/doc/howto/buildroot.exigence|hier]] nachgeschaut werden, welche das sind.

===== Erster Bauprozess =====
Für das Bauen der Firmware muss nun folgendes auf der Kommandozeile eingegeben werden:

  git clone git://git.openwrt.org/12.09/openwrt.git
  cd openwrt
  
  git clone https://github.com/freifunk-bielefeld/firmware.git
  cp -rf firmware/{files,package,feeds.conf.default,.config} .
  git am --whitespace=nowarn firmware/patches/*.patch
  rm -rf firmware
  
  ./scripts/feeds update -a
  ./scripts/feeds install -a
  
  make defconfig
  make menuconfig

In dem folgenden Menu muss nun das "Target System" und "Target Profile" ausgewählt werden:


Z.B. für den [[http://wiki.openwrt.org/toh/tp-link/tl-wr841nd|TL-WR841ND]]:
  # Target System => <*> Atheros AR7xxx/AR9xxx
  # Target Profile => <*> TP-LINK TL-WR841ND

Z.B. für  den [[http://wiki.openwrt.org/toh/d-link/dir-300|DIR-300]]:
  # Target System => <*> AR231x/AR5312
  # Target Profile => <*> Default

Für andere Router kann der Chipsatz ("Target System") im [[http://wiki.openwrt.org/toh/start|OpenWrt Wiki]] nachgeschaut werden.

Zu guter Letzt wird die Firmware erzeugt:
  make

Die fertige Firmware liegt nun im Ordner bin/<Chipsatz>/ und sollte im Namen die Modellbezeichnung des Routers, das zu verwendete Dateisystem ("squashfs") enthalten und  auf "factory.bin" enden.
Bei einem Update muss die Datei genommen werden die auf "sysupgrade.bin" endet. \\

Eine Anleitung zum Flashen des Routers http://openwrt.org konsultieren
oder mit uns Kontakt aufnehmen (siehe unten auf der Hauptseite).

===== Update & erneutes Bauen =====
Um erneute Kompiliervorgänge zu beschleunigen reicht es oft aus nur die Dateien zu aktualisieren. Dafür müssen folgende Befehle ausgeführt werden:

  cd openwrt
  git pull
  ./scripts/feeds update -a
  ./scripts/feeds install -a
  
  rm -rf files
  rm -rf package/{freifunk-bielefeld,autoupdater,next-node,simple-tc,fastd,libuecc}
  
  git clone git://github.com/freifunk-bielefeld/firmware.git
  cp -rf firmware/* .
  
  make defconfig
  make
 
===== Bei Fehlern =====
==== Fehlerhaftes Image ====
Sollte das neue System nicht mehr über das Web-Frontend aktualisierbar sein, so kann der [[http://wiki.openwrt.orgde/doc/howto/generic.failsafe/|OpenWrt Failsafe-Modus]] verwendet werden um den Router wiederzubeleben. 

Mit einem TL-WR841N funktioniert das wie folgt:\\
1. Gerät neustarten und dabei den reset-Knopf im Sekundentakt drücken bis eine Status-LED schnell blinkt. Der Router ist nun im Failsafe-Modus.\\
2. Da kein DHCP aktiv ist, muss dem Computer von dem aus der Flash-Vorgang vorgenommen werden soll selbst eine IP-Adresse gegeben werden z.B. mit:
  
  sudo ifconfig  192.168.1.2 eth0 up

3. Um das funktionstüchtige Image auf den Router zu übertragen, wird auf dem Computer ein Webserver geöffnet:
  
  cd /home/path/to/firmware-dir
  python2 -m SimpleHTTPServer   # oder mit Version 3 von Python: python -m http.server 8000
 
4. Der Router hat im Failsafe-Modus die IP 192.168.1.1 und kann per Telnet angesprochen werden. 

  telnet 192.168.1.1

5. Nun sind folgende Befehle notwendig um das Root-Dateisystem zu mounten und wegen mangelndem Flash-Speicher nach /tmp (liegt im RAM) zu wechseln:

  mount_root
  cd /tmp

Dann kann das Image auf den Router geladen und geflasht werden.

  wget 192.168.1.2:8000/name.der.firmware.bin
  sysupgrade -n name.der.firmware.bin