Commit 8d38eb12 authored by Hamza Dely's avatar Hamza Dely
Browse files

Ajout d'un README

parent 3e404d84
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:
...
else ($(CONFIG_TARGET_<option correspondante dans le .config>),y)
NETWORKFILE:="network.<modèle de borne>"
else
NETWORKFILE:="network"
...
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>
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment