source: tt-tools/LisezMoi.txt

Last change on this file was 7, checked in by guillaume, 16 years ago

Correction documentation

File size: 3.2 KB
Line 
1
2tt-tools, des outils pour le TwinTact
3=====================================
4
5Intro:
6Ce package regroupe le nécessaire pour compiler des outils OpenSource pour le
7TwinTact.
8
9Public concerné:
10A priori des développeurs ou hackers désirant utiliser des fonctions standards
11d'un système linux sur leur Twintact
12Si vous ne savez pas ce qu'est un shell et comment l'utilisez cet outil n'est
13pas pour vous. Mais rien ne vous empêche de demander des outils qui vous
14sembleraient utiles pour votre TwinTact. Pour ça, commencez par faire un tour sur
15http://www.opentwin.org, ensuite pour nous contacter, faites le par la liste de
16diffusion ou encore sur IRC (voir le site) ou encore sur http://source.pkg.fr
17
18Pré-requis pour compiler :
19un environnement unix... sous windows, l'environnement cygwin pourrait faire
20l'affaire, mais je ne l'ai pas testé et surtout il faudrait peut-être recompiler
21le toolchain... avis aux amateurs
22Remarque: ce package a été développé et testé sur une distribution Fedora 8
23
24Licence: voir les licences des packages utilisés
25
26Installation pour recompiler:
27 1. Créer un dossier quelconque, y mettre l'archive tt-tools-X.X.tar.gz
28    et y ouvrir un shell
29 2. Décompressez l'archive depuis ce dossier avec:
30    $ tar xzf tt-tools-X.X.tar.gz
31    où X.X est le numéro de la version du package de tt-tools
32
33Cross-compilation:
34 1. Commencez par faire la procédure d'installation
35 2. Lancez le script 'telecharge.sh' avec
36    $ ./telecharge.sh
37    pour télécharger directement le package à utiliser, notamment busybox,
38    dropbear & le toolchain. Le script vérifie aussi l'empreinte SHA1 des
39    package
40    Remarque: vous pouvez télécharger manuellement les packages et les mettre
41    dans un sous-dossier archives
42 3. Lancez le script 'dossiers-de-cross-compilation.sh' pour préparer
43    l'environnement de cross-compilation à partir des archives disponibles:
44    $ ./dossiers-de-cross-compilation.sh
45 4. Enfin, exécutez './compile-YYYYYYY.sh' où YYYYYYY correspond à l'outil que
46    vous voulez recompiler
47
48Installation sur le TwinTact:
49 1. Utiliser le package tt-tools-X.Y-on-tt.tar.gz ou le générer avec le
50    script generer-archive.sh
51 2. Télécharger l'archive sur le TwinTact dans le dossier /usr/share
52 3. Décompresser l'archive depuis ce dossier
53 4. Exécuter le script /usr/share/bin/maj-tt-tools.sh:
54    * busybox et dropbear sont installés
55    * une clé privée pour le service dropbear est éventuellement générée
56
57Contribuer:
58 1. Vous pouvez modifier ensuite les sources dans les dossiers utilisés
59 2. Recompilez en utilisant les scripts ci-dessus ou encore manuellement:
60    $ source environnement-de-cross-compilation.sh
61    et lancez vous même les commandes adéquates de compilation en vous inspirant
62    éventuellement de celle disponibles dans les scripts compile-YYYYYYY.sh
63 3. Une fois que vos modifs sont testées utilisez les scripts 'creer-patchs.sh et
64    generer-archive.sh pour nous soumettre vos modifications sur la liste de
65    diffusion par exemple ou dans un ticket sur http://source.pkg.fr
66 4. Si vous avez besoin d'un coup de pouce essayez le canal IRC (voir le site
67    http://www.opentwin.org)
68 5. N'oubliez pas de jeter un oeil au ChangeLog
69
70Merci d'être arrivé jusqu'ici ;-)
71
Note: See TracBrowser for help on using the repository browser.