LES DOSSIERS DU GAULOIS

(16/03/98) - Utilisation de POSE (ex-COPILOT):

(ancienne version, traduction/résumé à partir de la doc anglaise)
Copilot est un programme qui emule le Palmpilot sur Mac et Pc (Windows95 ou NT, mais il ne fonctionne pas avec win3.1 même si Win32s est installé, une version OS/2 est également existante). En plus d'avoir les programmes spécifiques pilot comme l'agenda, l'annuaire, la liste de choses à faire et le mémo, vous pouvez y installer et tester des programmes depuis votre machine de bureau sans les installer sur le Pilot, (pratique pour les test et le développement). Le 'Copilot' est équipé d'un débuger pour les mises au points. Pour fonctionner Copilot à besoin du programme stocké en ROM de votre pilot, ce programme étant dévelloppé par 3com, il ne peut être diffusé sur le web pour des raisons évidentes de licence. (voir manuel utilisateur Palmpilot) d'ailleurs l'utilisation détournée de cette rom est une infraction en elle-même.

  1. Installation de Copilot et récupération de la rom: (1) Aprés avoir décompacté tous les fichiers contenus dans l'archive, (2) il faut installer le programme 'getrom.prc' sur votre pilot si c'est un 512ko de rom (pilot 1000 ou pilot 5000) ou alors 'getrom2.prc' si c'est un 1mo de rom (pilot perso, pilot pro ou pilot avec extension 1mo) avec la hotsync. (3) Fermer le programme de hotsync ainsi que tout ce qui n'est pas utile de laisser en mémoire du PC, moins il y aura de programmes en arrière plan, moins il y aurra de pertubation lors du transfert des 512ko ou 1mo  de rom par paquet de 4ko !!!. Le programme GETROMx.exe est 'hyper instable' (il m'a fallu 8 essais avant d'aboutir!) (4) Lancer sur le Pc une session DOS sous Windows, puis le programme 'getrom.exe' ou  'getrom2.exe' selon l'installation que vous venez de faire sur votre pilot avec pour seul paramêtre le port ou est branché le cradle. (si c'est pas claire voir le tableau de récap.). (5) coté pilot, lancer le programme getrom ou getrom2 et cliquer sur 'start' => le transfert doit s'effectuer, il y aura à l'ecran PC un compteur qui va de 1/256 à  256/256 (ou 1/128 à 128/128 pour Os 1.x). (6) Une fois le transfert terminé un fichier nommé 'pilot.rom' ou 'pilot2.rom' est créé sur votre disque dur, (si 'pilot2.rom' le renommé en 'pilot.rom'), le copier dans le même repertoire que copilot si besoin,  et enfin lancer copilot !! ouf !!!.
    modéle de pilot

    installer sur Pilot

    Lancer sur PC (cradle sur com1)

    Lancer sur PC (cradle sur com2)

    Pilot 1000 / 5000 (Os 1.x)

    getrom.prc

    getrom com1

    getrom com2

    Pilot Perso / Pro ou étendu (Os 2.x)

    getrom2.prc

    getrom2 com1

    getrom2 com2

  2. Utilisation de pose / copilot:

    Aprés le lancement de l'emulateur,
    appuyez sur F10 pour voir apparaitre le menu copilot:
    - cliquez sur 'properties'

    - renseigner les paramètres:
    - réglez la taille de la RAM que vous voulez avoir,
    - charger les programmes pilot avec F10 - load app >.

  3. Pour disposer sur copilot de vos infos stockées dans le pilot (mémo, todo, agenda, dépenses, ...) il faut disposer de 2 ports série différents:
    (com1 ou 3) et (com2 ou 4) pour ceux qui l'ignorent com1 et 3 c'est la même chose, pareil pour com2 et com4. Donc j'abrége: relier le com1 au com2 du pc avec un cable nul-modem style 'lap-link'. lancer Hotsync du desktop pc et hotsync du copilot, la mise à jour se fait normalement aprés avoir renseigné le nom utilisateur coté copilot.

  4. Utilisation du débugger: pas de commentaire, je ne l'ai jamais utilisé, si des volontaires se manifestent, j'intégrerai l'article.

  5. Observations: L'affichage d'image avec tiny-view ou view, plante souvent copilot. La ram virtuelle de copilot est réglable de 128 ko à 8mo, pour la sauvegarde des programmes pilot ainsi que les documents aprés extinction du programme, un fichier pilotxxxx.ram est créé sur le disque dur. - Si vous avez des questions particulières sur copilot, je tacherai d'y répondre ici.

  6. Où trouver POSE / Copilot ?:
    - PC/ Version 1.0 bêta 9 du 11 juin 97 écrite par Greg Hewgill. - Cette version supporte le rétro-éclairage ainsi que la rom 2.0 - http://www.hewgill.com/pilot/index.html "

    - PC/ Version 1.0 bêta 16h du 19 juillet 97, écrite par Heath Hunnicutt, Cette version supporte les niveaux de gris ainsi que la rom 2.0 (avec un message d'erreur au début) http://ofb.net/~heath/pilot/copilot/ " (Mail de Jérôme TREDEZ tredez@mail.dotcom.fr. dans la mail-list infini)

    - PC/MAC Versions de 3com, ces versions évolue selon la fonction recherchée (il y en a plusieurs) et plus besoin de disposer d'un Palm pour le tester, car au 3eme paragraphe on vous précise que la rom est téléchargeable aussi depuis le site de 3com alors voilà les 2 adresses:
    l'émulateur: http://www.palmos.com/dev/tech/tools/emulator/

    - Unix and X11 xcopilot by Ivan Curtis (http://www.isaac.cs.berkeley.edu/pilot) , with enhancements by Ian Goldberg.  An updated version is available from a Cuspy Solutions site.http://xcopilot.cuspy.com

    - Macintosh (PowerMac only), Copilot by IllumeSoft http://members.aol.com/illumesoft/copilot.html. This version is the basis for the Macintosh version of the Palm OS Emulator. http://www.emulation.net/palm/index.html
    - Macintosh Zilot by Michel Pollet http://w3.teaser.fr/~mpollet/Zilot.

    - OS/2 Copilot/2 by Siegfried Hanisch http://stud1.tuwien.ac.at/~e8925811/copilot2.html.

    - Windows CE PilotCE by Panutat Tejasen ("Jimmy"), a port that will let you carry two handhelds in one. http://www.jimmy.com/Beta/PilotCE/index.html

    - Changez le look de votre copilot. http://chunkymunky.com/tin_omen/palmskins.html

  7. Comment se procurer une ROM ?
    - telecharger celle contenue dans votre palm avec le programme getrom
    ( Attention avec l'emulateur POSE: " FlashPro modifie (formate ?) la flash si bien que le calcul d'un checksum dessus est différent, provoquant le rejet de cette ROM par l'émulateur. Posefix est prévu pour résoudre ce pb." http://perso.wanadoo.fr/pierre.touzeau/download/posefix.exe Contribution : Pierre TOUZEAU )
    - vous inscrire comme developer sur le site de Palm, imprimer les documents disponibles sur le site, remplir et poster le tout au US, compter plusieurs semaine.
    - Chez handspring     Les outils chez HandSpring (dont la rom)
    http://www.handspring.com/developers/sw_source_code.jhtml
    - Trouver un possésseur de Palm pour lui demander sa rom (si vous n'en possédez pas encore).

A quoi peut bien servir Copilot ?:
- Pour tester des programmes depuis sa machine de bureau (PC ou MAC...) aprés un téléchargement et avant de le synchronisé sur le Palm.
- Pour tester des programmes lors de l'écriture de ceux-ci (pour les devellopeurs)
- Pour tester le Palm avant de l'acheter ...(version OS3.0 libre d'accés)
- Sûrement pour d'autres choses encore mais j'ai oublié...

(24/10/2000) Comment récuperer la Rom de mon Visor par Didier CLERC ( didier-clerc@isuisse.com http://www.isuisse.com/didier-clerc ):
" Hello, Je me suis demandé comment transférerla ROM de mon Visor deluxe avec son cradle USB. J'ai trouvé une réponse en anglais: http://discussion.visorcentral.com/vcforum/showthread.php?threadid=4884 Je l'ai traduite et complétée (pour la rendre AMHA plus compréhensible). Ma traduction (v.o. en bas de message):
Ce n'est probablement pas pour faire quelque chose de mauvais. Mais s'il fait, souvenez vous alors que je vous ai averti.
Premièrement fermez HotSync. C'est probablement aussi une bonne idée de rendre inopérant n'importe quel hacks que vous faites tourner.
Télécharger et installer le Handspring SDK. (En tout cas le débugger, il faut créer le chemin "Handspring\PalmTools\bin\", où vous mettrez Palm-Debugger.exe, et "Handspring\PalmTools\bin\Device" , où sera stocker la ROM).
Lancer PalmDebugger "Handspring\PalmTools\bin\palm-debugger.exe" Dans le menu de Connexions, choisissez USB.
Asseoir le visor dans le cradle. Ecrire sur la zone d'écriture du vizor: "le symbole du raccourci" tap tap 1 (en d'autres termes le symbole Raccourci (Sorte de Ruban comme pour le logo contre le sida), deux points pour en faire un, et un 1) Un curseur carré clignotera en haut à gauche. Ceci met le visor en mode de debug, à travers duquel il peut communiquer avec le debugger.
Maintenant, dans la fenêtre du "Debugger" du Palm-Debugger, tapez: save "visor.rom" 10c00000 200000 (Et pressez Enter)
Un compteur de pourcentage devrait apparaître - quand il atteindra 100%, il devrait imprimer ça: #2097152 bytes saved from address $10C00000 to file "visor.rom" (#2097152 octets sauvegardés de l'adresse $10C00000 au fichier "visor.rom")
Si vous arrivez à ce point, vous aurez sauvegardé maintenant la ROM du visors dans un fichier dans le dossier "Handspring\PalmTools\bin\Device\".
Mais attendez, le visor est toujours en mode de debugage et bouffe vos piles si vous n'en sortez pas. Donc exécutez simplement un "soft reset" ou plus simplement, tapez dans le débugger "reset" et presser "enter" dans la fenêtre de débugage.

la version originale en ANGLAIS: This isn't likely to do anything bad :-) But if it does, then remember I warned you. HotSync first. Probably also a good idea to disable any hacks you have running. Download and install the Handspring SDK. Launch PalmDebugger "Handspring\PalmTools\bin\palm-debugger.exe" In the Connections menu select USB. Sit the visor in the cradle. Launch memopad - and write Shortcut - dot - dot - 1 (In other words the shortcut symbol, two dots to make a period, and a 1) This puts the visor into debug mode, through which it can communicate with the debugger. Now, in Palm-Debugger's "Debugger" window type the following. (and press enter) save "visor.rom" 10c00000 200000 A percentage counter should appear - when this reaches 100 it should print the following. #2097152 bytes saved from address $10C00000 to file "visor.rom" If you get this far you have now saved the visors rom to a file on your computer. Look for it in "Handspring\PalmTools\bin\Device\" to find it. But wait, the visor is still in debug mode and likely to kill your batteries if you dont get it out. So simply perform a soft reset or even simpler, type "reset" and press enter in the debugger window. Launch POSE and begin to develop some cool visor apps.

Avec mes meilleures salutations "  Didier CLERC didier-clerc@isuisse.com  http://www.isuisse.com/didier-clerc

(24/10/2000) Comment récuperer la Rom de mon Visor par Fabrice <fhamelin@nordnet.fr>
Voici le résultat de mes investigations : CA MARCHE !!! - La procédure est "relativement" simple... mais doit être suivie EXACTEMENT telle qu'elle est décrite (sinon, des messages d'erreur apparaîtront - en plus des messages d'erreurs que je qualifierais de "normaux..." - et empêcheront le transfert de la ROM). - Tout d'abord, téléchargez le fichier Palm-Debugger.exe sur le site Handspring (592Ko) (si vous n'avez pas déjà installé les GNU Tools du même site) donc, allez sur la page http://www.handspring.com/developers/sw_dev.jhtml et ... Eh merde... Y sont plus là?... Bon, ce lien fonctionne toujours ce matin, si vous ne voulez pas des 20Mo des GNU-Tools : http://www.handspring.com/developers/Devkit2/Palm-Debugger.exe Cette version est compatible avec Windows 2000 (contrairement à la version livrée avec les GNU Tools 1.1 - Mais je vois qu'ils ont mis à dispo les GNU Tools 2.0... et c'est certainement la raison...)
- Copiez cet exe dans le répertoire "C:\Handspring\PalmTools\bin\" (Attention, il semble que le nom de ce répertoire soit important - mais c'est surtout si vous avez installé ces fameux GNU-Tools)
- Créez un répertoire "C:\Handspring\PalmTools\bin\Device\" (c'est le répertoire où se trouvera la ROM à la fin de la procédure)
- Faites une HotSync pour sauvegarder vos données (au cas où, on n'est jamais assez prudent). Eventuellement, faites un backup.
- Désactivez tous les Hacks (au cas où, idem...)
- Exécutez Palm-Debugger.exe, et dans le menu 'Connection', choisissez 'USB'
- Posez le Visor dans le Cradle
- Lancez n'importe quelle application dans laquelle vous pouvez saisir du texte (Bloc-notes, ou icône Loupe (Chercher))
- Dans la zone Graffiti, tapez le caractère 'Raccourci', obtenu en réalisant un 'L' minuscule (pas le 'L' minuscule de graffiti, mais un 'L' minuscule comme vous l'écririez sur une feuille de papier - une vraie - en réalisant une boucle, et vous obtenez à l'écran un caractère qui part du coin inférieur gauche pour se terminer dans le coin inférieur droit en faisant une belle boucle)
- Tapez un point (en tapant 2 fois dans la zone Graffiti)
- Tapez le chiffre 1
- A ce moment, votre Visor passe en mode Debug et peut converser avec Palm-Debugger (il fait un long bip et un point clignote dans le coin supérieur gauche de l'écran du Visor - Si votre Visor continue à biper, c'est que la communication ne se fait pas entre le Debugger et le Cradle (vérifiez que vous avez bien choisi USB dans les menus du Palm-Debugger, et au besoin, tapez la commande 'att' dans la fenêtre 'Debugger' de Palm-Debugger).
- Dans la fenêtre 'Debugger' de Palm-Debugger, "il se peut" qu'un message d'erreur apparaisse ("normal" celui-là, si on peut dire, car il n'affecte en rien la descente de la ROM - En plus, la doc du Débugger semble indiquer qu'on "devrait" avoir ce genre de message...) :
Welcome to the PalmOS Debugger!
Built: Dec 18 1998, 15:50:23, Target 6, Rev 3
===============================================================
EXCEPTION ID = $F4
'PrvHandleEvent'
+$062C 1000F2F2 *MOVEQ.L #$01,D0
- Mais tout ça n'est pas bien grave, le Visor est quand même en mode Debug, et c'est bien ça le plus important (donc pas d'inquiétude - Si c'est une exception $10, même combat, c'est pas grave - Si c'est un autre message qui apparaît, là, je ne sais pas, faut voir si la suite marche ou pas... - petite remarque : après avoir tapé 'reset' dans la fenêtre 'Debugger', mon exception $F4 s'est transformée en $10 ... Décidément, les voies de l'informatique sont impénétrables)
- Dans la fenêtre 'Debugger' de Palm-Debugger, tapez la commande suivante :
  save "visor.rom" 10c00000 200000
- Un pourcentage doit apparaître, indiquant le transfert de la ROM du Visor sur le PC
- Arrivé à 100%, vous devriez voir le message suivant apparaître : #2097152 bytes saved from address $10C00000 to file "visor.rom"
- Arrivé à ce point, prenez votre visor, retournez le (sans arrière pensée), et rentrez lui un objet long et dur (mais pas trop, faut pas lui faire du mal) dans son petit trou (j'ai dit sans arrière pensée, voyons...) - bref, faites-lui subir un petit reset bien sympa, juste histoire de le sortir de son mode Debug, et surtout pour qu'il arrête de vous pomper (...) vos piles...
- Dans le répertoire "C:\Handspring\PalmTools\bin\Device\", vous trouverez votre fichier ROM de 2Mo. Attention, ce n'est pas parce que vous avez un Visor Deluxe que vous devez avoir un fichier de 8Mo. La ROM fait bien 2Mo, et la RAM en fait bien 8. Mais on veut bien la ROM, n'est-ce pas ? J'ai passé un certain temps à merder pour arriver à ce résultat. Mais le jeu en valait bien la chandelle... Si vous avez des questions sur la procédure, n'hésitez pas à les poser. Je me suis fortement inspiré de la discussion sur un autre forum :

http://discussion.visorcentral.com/vcforum/showthread.php?threadid=4884