README.md 2.65 KB
Newer Older
Hamza Dely's avatar
Hamza Dely committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54
Package OpenWrt pour le Crans
=============================

Ce dépôt contient l'ensemble des fichiers de configuration du Crans à
inclure dans les images OpenWrt déployées sur les bornes Wi-Fi.

Prérequis
---------

- Git
- Un dépôt OpenWrt, par exemple [https://github.com/openwrt/openwrt.git](https://github.com/openwrt/openwrt.git)(Miroir du dépôt OpenWrt)

Installation
------------

Pour installer le package, il suffit de le cloner dans le dossier `package`
de votre dépôt OpenWrt:


    $ git clone https://gitlab.crans.org/nounous/openwrt-crans-package.git crans


Certaines dépendances doivent être satisfaites pour que le paquet soit intégré
à l'image. On installe donc tous les paquets possibles depuis les dépôts feeds:


    $ ./scripts/feeds update
    $ ./scripts/feeds install -a


Reste à choisir les options de compilation __sans oublier de sélectionner le
paquet Crans -> Crans configuration__, puis à compiler l'image :


    $ make menuconfig   # Ne pas oublier le paquet Crans ici
    $ make -j9


Ajout d'un fichier de configuration
-----------------------------------

1.  Ajout d'un fichier `network.<modèle de borne>`

L'ajout d'un fichier de configuration réseau pour une borne est nécéssaire
lorsque celle-ci utilise une autre interface réseau que `eth0`, ou bien si elle
dispose d'un switch. (Concernant les switches, [https://wiki.openwrt.org/doc/uci/network/switch](la doc sur OpenWrt.org))

Une fois le fichier placé dans `files/etc/config/`, il faut modifier le
Makefile de façon à ce que ce fichier soit pris à la place du fichier par
défaut lors de la compilation. Cela se fait en rajoutant un test au début
de ce dernier:


        ...
55 56 57 58 59 60
        ifeq ($(CONFIG_TARGET_<option correspondante dans le .config>),y)
            MODEL +="<modèle de borne>"
        endif
        ifndef MODEL
            MODEL:="default"
        endif
Hamza Dely's avatar
Hamza Dely committed
61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83

2.  Ajout d'un dossier

Pour ajouter un dossier, il faut écrire dans la section `Package/crans/install`
l'instruction

    $(INSTALL_DIR) $(1)/<chemin absolu de la destination finale>

3.  Ajout d'un fichier de configuration

Pour ajouter un fichier de configuration, il faut:
    - Mettre le fichier au bon endroit dans le files/
    - Ajouter dans la section `Package/crans/install` l'instruction

    $(INSTALL_DATA) files/<emplacement du fichier dans le package> $(1)/<chemin absolu de la destination finale>

4.  Ajout d'un script/binaire

Pour ajouter un exécutable, il faut:
    - Le mettre au bon endroit dans le files/
    - Ajouter dans la section `Package/crans/install` l'instruction

    $(INSTALL_BIN) files/<emplacement du fichier dans le package> $(1)/<chemin absolu de la destination finale>