[[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://celinuxforum.org/pubwiki/moin.cgi/FlashRecoveryUtility 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 ==
La nouvelle 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. Le mode d'écriture de la NAND n'a pas encore était validé et les informations relatives à l'écriture viendront en temps utile. 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.

== 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.tar.gz?format=raw tt-loader v0.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 l'écriture dans la NAND
 * Valider le chargement d'un noyau linux

== Support ==
Essayez sur le canal IRC [http://www.opentwin.org OpenTwin] ou la mailing list: http://opentwin.org/Projet/MailingList ou contactez [http://www.pkg.fr PKG.fr]