# Dokumentation

https://gluon.readthedocs.io/en/v2017.1.x/

Gluon Version auf der die Freifunk Radevormwald Firmware basiert:

* 2017.1.x - Gluon 2017.1.4

# Download der Firmware

* http://firmware.freifunk-radevormwald.de/

# Firmware selber bauen

1. Vorbereitung:

  1.1 Abhängigkeiten installieren

       sudo apt-get install git subversion build-essential gawk unzip libncurses5-dev zlib1g-dev libssl-de

  1.2 Gluon repo clonen

       git clone https://github.com/freifunk-gluon/gluon.git gluon-rdv -b v2017.1.x
       
  1.3 Gwünschtes Tag setzen
       
       git branch -a 
       git checkout v2017.1.4
       
  1.4 Freifunk Radevormwald Site clonen

       cd gluon-rdv
       git clone https://github.com/freifunk-radevormwald/ffrade-site.git site -b master

2. Firmware bauen

  2.1 Build vorbereiten

       make update

  
  2.2 Anzahl CPU Kerne X ermitteln
  
       X=$(expr $(nproc) + 1)
    
  2.3 Build durchführen für die in RAdevormwald gänigen Geräte
  
       X=$(expr $(nproc) + 1) && make -j$X GLUON_TARGET=ar71xx-generic GLUON_BRANCH=stable && make -j$X GLUON_TARGET=ar71xx-tiny GLUON_BRANCH=stable && make -j$X GLUON_TARGET=mpc85xx-generic GLUON_BRANCH=stable
       
            
       ## Mögliche Targets

       - ar71xx-generic     (für standard Geräte)
       - ar71xx-tiny        (für Geräte mit nur 4 MB Flash)
       - ar71xx-mikrotik
       - ar71xx-nand
       - mpc85xx-generic    (für tp-link-tl-wdr4900-v1 Geräte)
       - x86-64
       - x86-generic
       - x86-kvm_guest
       - x86-xen_domu
       - brcm2708-bcm2708
       - brcm2708-bcm2709
       - ramips-mt7621
       - ramips-rt305x
       - sunxi
       - mvebu
       
  2.4 Wenn das Kompilieren fehlschlägt
  
       make -j1 V=s GLUON_TARGET=ar71xx-generic GLUON_BRANCH=stable
       
3. Rebuild

  3.1 Updaten

       cd site
       git pull
       cd ..
       git pull
       make update

  3.2 Build Verzeichnis säubern

       make clean GLUON_TARGET=ar71xx-generic

4. Firmware signieren

  4.1 Manifestdatei erstellen
  
      make manifest GLUON_BRANCH=stable
      
  4.2 Manifestdatei signieren
  
      .contrib/sign.sh /home/stefan/secret-steneu-ff-sig.key /home/stefan/gluon-rdv/output/images/sysupgrade/stable.manifest