[[TracNav(WikiStart)]]

= [wiki:Projets/tt-loader tt-loader] =
[wiki:Projets/tt-loader tt-loader] est essentiellement un outil linux pour charger un programme dans le Twintact avant que le système installé soit chargé.[[BR]]
Cet outil est destiné essentiellement aux utilisateurs et développeurs avancés qui désirent tester le chargement d'un système d'exploitation dans le Twintact.[[BR]]
Cet outil a été adapté depuis l'outil [http://elinux.org/Flash_Recovery_Utility omapfl] et devrait pouvoir être utilisé avec tout système à base de processeur OMAP.[[BR]]
Si vous êtes intéressé pour porter cet outil sur un autre système à base OMAP que le TwinTact, n'hésitez pas à me contacter directement.[[BR]]
[[BR]]

== Nouvelle version 0.2.2 ==
Petite mise à jour de la version 0.2.1:
 * essentiellement apport d'un interaction facilité dans l'utilisation de la commande en mode manuel. Le programme côté PC va attendre 30 secondes pour que vous branchiez votre TwinTact.
 * Mise à jour mineure de la détection d'erreur USB
 * Ajout d'un modèle "start-kernel.txt" utilisé pour booter un noyau linux (voir un exemple d'utilisation sur [http://opentwin.org/wiki/Compilation_du_noyau le wiki OpenTwin])

== Version 0.2.1 ==
Petite mise à jour de la version 0.2:
 * Correction d'un bogue empêchant la compilation sur certaines distributions. Merci à freedomsound pour l'avoir reporté.
 * Ajout de documentations sommaires sur le format des commandes utilisables, ainsi que sur l'utilisation du programme "FlashWriteNAND.bin":
   * [browser:/tt-loader/CMD-SYNTAX CMD-SYNTAX] pour la syntaxe des commandes
   * [browser:/tt-loader/FlashWriteNAND.txt FlashWriteNAND.txt] pour l'utilisation de "FlashWriteNAND.bin"

== Version 0.2 ==
Cette version ajoute un certain nombre de commandes mais surtout elle supporte l'utilisation d'un programme qui s'appelle "FlashWriteNAND.bin"... Ce nom est trés évocateur et pour cause, il permet de lire et écrire la mémoire NAND du Twintact. Le package source contient un fichier de commande permettant seulement de faire un backup complet de la NAND du téléphone. Veuillez consulter la page [wiki:tt-loader/FlashWriteNAND FlashWriteNAND] pour les détails.

== Le principe ==
 * L'appareil doit être éteint et ne pas être en mode charge
 * Lorsqu'on insère le câble USB dans le téléphone, l'alimentation de la prise USB déclenche une phase de boot du système
 * Le téléphone s'annonce sur le port USB avant de booter tout système installé dans le téléphone
 * tt-loader détecte l'annonce du téléphone, se connecte au téléphone et transmet le petit programme ''2nd.bin''
 * le petit programme est directement exécuté depuis la SRAM du téléphone et prends la main sur le téléphone en stoppant la phase de boot
 * le petit programme commence à communiquer avec tt-loader
 * finalement tt-loader lit un fichier de commandes et transmet des instructions lus au petit programme, voici une liste de commande utilisable:
   * indiquer une adresse de base
   * indiquer un fichier à télécharger dans la mémoire du téléphone
   * demander de faire un appel à un programme
   * donner la main à un programme
   * demander de renvoyer le contenu d'une portion de la mémoire
   * écrire un mot à une adresse donnée
   * lire un mot à ue adresse donnée
   * lancer un noyau linux chargé depuis l'hôte
   * changer l'adresse de la pile
   * dumper dans un fichier le contenu d'une portion de la mémoire
   * vérifier le crc32 d'une portion de la mémoire

== Qu'est-ce qu'on peut faire d'intéressant avec [wiki:Projets/tt-loader tt-loader] ? ==

 1. '''La base:'''
    * démarrer le TwinTact avec le système installé à l'insertion du câble USB
    * pourquoi ? Juste pour voir que tt-loader fonctionne correctement[[BR]]

 2. '''Booter le noyau linux avec une autre ligne de commande du noyau:'''
    * seulement pour ceux qui savent ce qu'ils font...
    * C'est possible en téléchargeant le programme u-boot récupéré depuis le téléphone et modifié sur son PC
    * Il faut utiliser un éditeur hexadécimal et trouver dans le fichier la définition '''bootarqu=...'''. Il faut éviter de modifier le retour-chariot... La place est trés limitée.

 3. '''Faire un backup complet du TwinTact'''

 4. '''Ecrire un firmware dans la NAND du TwinTact''', que ce soit un backup ou un firmware personnalisé

== Téléchargements ==
 * Les sources sont accessibles depuis le dépôt SVN ou sinon prenez l'archive [/browser/tt-loader/tt-loader-0.2.2.tar.gz?format=raw tt-loader v0.2.2] qui contient déjà le petit programme ''2nd.bin'' précompilé pour le téléphone.

== Installation ==
 * lire impérativement le [browser:/tt-loader/README README] en anglais
 * vous devrez compiler le programme pour votre ordinateur

== Utilisation ==
 * n'utilisez pas tt-loader si vous ne savez pas ce que vous faites, sachez que vous annulez la garantie de votre téléphone dans ce cas
 * n'hésitez pas à utiliser le script udev des [wiki:Projets/tt-tools tt-tools] pour simplifiez l'exécution de tt-loader

== Reste à faire ==
 * Valider le chargement d'un noyau linux quelconque

== Support ==
Faites un don et contactez [http://www.pkg.fr PKG.fr] ;)