Flashing

EigenNet e' un firmware per reti comunitarie basato su OpenWrt, per soddisfare le esigenze di tante comunita' viene sviluppato in diversi branch di cui i principali sono:

* master - ramo di sviluppo instabile, attualmente usa batman-adv per la costruzione della rete mesh a layer 2.

* pisa - branch adatto alle esigenze della comunita' di Pisa, e' basato su commit stabili di master.

* roma - ramo sviluppato da arkanet per la comunita' di Roma basato su master ma usa OLSRd per il routing a layer 3.

Compilare il firmware

Il codice è disponibile su gitorious.org, un sito di hosting per progetti opensource. Per ottenerlo si deve usare git.

WARNING: Questa guida è stata testata solo su antenne Ubiquiti

Ottenere il codice

Scegliere la release di OpenWrt da usare, raccomandiamo di usare Attitude Adjustement (12,04).

Vengono descritti i passi anche per antenne che usano driver madwifi anche se si tratta di antenne abbastanza vecchie e le antenne acquistate recentemente (circa dopo il 2012) avranno quasi di sicuro una scheda wireless che usa ath9k.

• Scaricare il sorgente di OpenWrt seguendo [le istruzioni su questa pagina]

Configurazione

• Aggiungere il feed dei sorgenti di eigenNet ( sostituire "CartellaOpenWRT" e "NomeBranch" con i nomi veri ). Questo serve per avere i pacchetti sviluppati appositamente per la rete.

  ''Dopo aver digitato git clone.....''
  cd CartellaOpenWRT
  cp feeds.conf.default feeds.conf
  echo 'src-git zzzeigennet git://gitorious.org/eigennet/packages.git;NomeBranch' >> feeds.conf
  scripts/feeds update -a
  scripts/feeds install -a
  

• Scegliere le proprie impostazioni di compilazione (i pacchetti di eigenNet si trovano sotto il menu' "Administration" )

  make menuconfig

  Questo comando aprirà un'interfaccia semi-grafica che permette di configurare l'immagine per l'antenna. La selezione è fatta usando lo spazio (nei campi dove possibile (M) indica la compilazione come modulo, ciò comporta che il componente è dinamicamente caricato all'occorrenza mentre (*)Indica che il componente è sempre disponibile.

  • Per prima cosa bisogna scegliere l'architettura: Per farlo bisogna entrare nella prima voce di menu se non siete sicuri dell'architettura ed avete comprato l'antenna da entro il 2012 potete tranquillamente selezionare

     (X) Atheros AR7xxx/AR9xxx

    Altrimenti per antenne più anziane selezionate

     (X) Atheros AR231x/AR5312

  • Nella sezione eigennet si possono scegliere diversi tool, sia grafici che WebUI (interfaccia web) per la gestione della rete, dai test di banda ai puntamenti.

     Location:
    -> Administration
    --> eigennet
    

    Qui avrete diverse scelte con le relative descrizioni:

    <*> eigennet-autoconf.................................... Auto Config Package
    --- eigennet-bwtest............................... Bandwidth Measurement Tool
    <*> eigennet-bwtest-webui........... Bandwidth Measurement Tool Web Interface
    < > eigennet-firewall....................................... Layer 2 Firewall
    < > eigennet-gw4server.................................. IPv4 Gateway Checker
    < > eigennet-httpinfo.......................... Export info via HTTP protocol
    < > eigennet-pointing................................. Antenna Pointing Tools
    < > eigennet-pointing-webui............. Antenna pointing tools Web Interface
    <*> eigennet-reghack.............................. Regulatory domain unlocker
    

    Il pacchetto fondamentale è eigennet-autoconf che farà la magia di configurare l'antenna. Il resto è opzionale e dipende dal caso specifico

  • Per avere i test di banda si deve abilitare nella sezione

     
    ->Base System
    -->Bysybox
    --->Networking Utilities
    ---->nc 
    ----->[*]   Netcat server options (-l)
    

    Che serve per avere la flag -l (listen) su netcat

• Una volta finito di configurare bisogna uscire premendo il tasto <Esc> fino a risalire tutti i menu ed arrivare al dialogo

  Do you wish to save your new OpenWrt configuration?

• Salvare

Compilare

Per compilare il firmware si può passare al comando

make 

Anche l'opzione -j <numero di core fisici +1> per parallelizzare la compilazione e velocizzarla.

Flashing

Prendere l'immagine che ci serve dentro la cartella bin

cd CartellaOpenWRT/bin/

• In caso di driver ath9k

cd ar71xx

• In caso di driver madwifi

cd atheros

L'immagine da usare dipende dal modello dell'antenna, tipicamente sarà un'antenna di Ubiquiti, [qui] la tabella delle antenne coi relativi articoli, in ogni articolo è scritta l'immagine da usare.

Nel caso di primo flashing allora bisognerà usare l'immagine con la dicitura factory altrimenti andrà scelta quella con la dicitura sysupgrade.

A seconda del metodo scelto per il flashing si dovrà procedere in diversi modi:

• Metodo TFTP
• Metodo SSH
• Metodo WebUI (solo per factory)