
                      **********************************

                                  AHP v2.2

                        (c) 1992-1995  Doucet Stéphane

                             Tous droits réservés

                      **********************************


   Le programme est un Freeware. Il est librement distribuable et peut être
mis sur les serveurs  ou les disquettes DP.  N'hésitez pas à le copier pour
des amis et à le faire connaître.  Sentez vous libre de l'utiliser, mais  A
VOS PROPRES RISQUES,  car je ne pourrais pas être tenu responsable des dom-
mages que ce programme pourrait causer à votre système  ou à votre machine.

Introduction
~~~~~~~~~~~~
   AHP permet de transférer des données provenant du calculateur scientifi-
que HP 48 (S,SX,G ou GX) vers notre cher Amiga et inversement.  Il est éga-
lement possible de récupérer des programmes ou des données ayant été trans-
férés sur un PC. Et oui, on peut maintenant jouer dans la cours des grands.
Enfin "grand" si l'on veut. On peut aussi convertir des images IFF en objet
graphique reconnu par la HP48 et inversement.

   Pour l'utiliser, il faut avoir au minimum le Kickstart 2.04 (v37) et les
fichiers suivant:
      locale.library (Seulement pour les possesseurs du Workbench 2.1+)
      diskfont.library
      reqtools.library (v38+)	(© Nico François)
      xprkermit.library
      xprxmodem.library
      serial.device

   AHP a été testé avec succès  sur un A2000 (KickStart 2.04, 68030), A1200
d'origine, A4000/030 et A4000/040.

   Il peut être lancé à partir du WorkBench ou du CLI.  Pour le lancement à
partir du CLI, il n'est pas utile d'utiliser la commande 'RUN' ou une autre
commande similaire, car il se lance directement en tâche de fond.

Distribution
~~~~~~~~~~~~
   AHP doit être distribué avec:

    AHP (dir)
        AHP
        AHP.info
        ReConvert
        ReConvert.info
	Install
        Install.info
    Libs
        reqtools.library	(© Nico François)
        xprkermit.library
        xprxmodem.library

    ProgHP (dir)
        Arkanoid
        Boulder
        P.4
        PacMan
        XYModem
        GreyScale

    AHP.Doc
    AHP.Guide
    CableHP.IFF

L'utilisation
~~~~~~~~~~~~~
   Lors des transferts,  il est préférable  de lancer en premier l'appareil
faisant la fonction de récepteur.

   Il n'est plus  nécessaire  à partir de la version 2.0,  de procéder  aux
conversions des fichiers lorsqu'il proviennent du monde PC  ou lorsque vous
écrivez vos programme sur directement sur votre Amiga. Pour ceux qui utili-
saient les versions  antérieures à la 2.0,  ils devront utiliser le fichier
Reconvert (v1.0+) pour redonner à leurs données le format normal.
   Il est maintenant possible  d'utiliser  deux protocoles différents  pour
les transferts  (Kermit ou XModem).  Pour ce servir de l'un  ou de l'autre,
il suffit juste de placer le gadget de protocole sur la position désirée.

      SetUp en mode kermit pour la HP 48 S(X)
         IR/wire:        wire
         ASCII/binary:   binary
         baud:           9600
         parity:         none 0
         checksum type:  3
         translate code: 1

   Seul l'option 'IR/wire' du SetUp  ne doit pas être modifié  et resté sur
wire. Pour plus d'informations consultez le manuel de la HP 48. Pour les HP
48 G(X) il faut faire les mêmes réglages.

   Pour le protocole XModem, seul les HP48 G(X) l'ont en standard, pour les
utilisateurs des HP48 S(X),  ils devront transférer  le fichier XModem pour
pour pouvoir utiliser ce protocole (cf. XModem.doc pour son utilisation).

   Il est fourni avec des classiques de la HP 48.  Ces programmes ayant été
été réalisé sur la gamme HP 48 S(X),  il est possible que certain ne tourne
pas avec les HP 48 G(X). Alors attention aux pertes de données. Il est pré-
férable de sauvegarder tous les programmes en mémoire avant.

   1) La transmission
      ~~~~~~~~~~~~~~~
      - Sélectionnez le mode Transmission.

      - Sélectionnez le fichier à transmettre  à l'aide  du gadget d'ouver-
   ture du sélecteur de fichiers ou en tapant directement le chemin dans le
   gadget source.

      - Lancez la HP 48 en réception.

      - Cliquez sur le gadget Ok.

      - Si tout va bien le fichier se transmet.

      - Pour arrêter un transfert, appuyez sur le gadget interrompre.

      - Pour transférer  plusieurs fichiers,  il faut appuyer sur la touche
   SHIFT  et sélectionnez les fichiers  à transférer dans le FileRequester.
   Si plusieurs  fichiers  ont été choisi,  seul le chemin apparaît dans le
   gadget source et l'indicateur de sélection multiple est actif (+ []).

   2) La réception
      ~~~~~~~~~~~~
      - Sélectionnez le mode Réception.

      - Sélectionnez le répertoire de destination  à l'aide du gadget d'ou-
      verture du sélecteur de fichiers  ou en tapant directement  le chemin
      dans le gadget destination.

      - Cliquez sur le gadget Ok.

      - Lancez la HP 48 en transmission.

      - Si tout va bien le fichier se transmet.

      - Pour arrêter un transfert, appuyez sur le gadget interrompre.

      - Pour la réception, il est possible de transférer plusieurs fichiers
   en utilisant sur la HP 48 les { } (ex. : { Nom1 Nom2 Nom3 ... }).

   3) Transfert de données spéciales
      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      - Il est possible de transférer des données  n'étant pas des program-
   mes de la  HP48.  Comme des fichiers IFF, des textes ASCII tapé directe-
   ment sur Amiga, ...

      - Si vous voulez écrire des programmes pour la HP sur votre Amiga, il
   faut insérer  l'entête suivant sinon la HP  ne le reconnaîtra pas  comme
   étant un programme.

      Entête: %%HP: T(1)A(D)F(.);
              « Programme
                ...
                ...
              »

      T() : Type de conversion (0 aucune, 1 caractère 10 en 13 et 10, ...)
      A() : Mode d'angle (D degrés, R radians, G grades)
      F() : séparateur décimal (. ou ,)

   4) Les Outils
      ~~~~~~~~~~
      - Il y a deux types de conversions:

         - la conversion d'une image IFF en un GROB  (objet graphique de la
           HP48).

         - la conversion d'un GROB en une image IFF.

      - Pour réaliser ces conversions, il suffit de choisir dans le menu le
   type de conversion  désiré,  puis un fichier.  Le fichier  converti sera
   sauvegarder dans le volume ou répertoire indiqué dans les préférences.


      - Il est possible d'afficher les GROB directement à partir de l'Amiga
   grâce à la fonction 'Voir GROB...'.

   5) Les préférences
      ~~~~~~~~~~~~~~~
      - Affichage
         Par défaut, AHP s'ouvre dans l'écran du Workbench, mais il est pos-
      sible de l'ouvrir dans un autre écran à condition que ce soit un écran
      publique.  Pour cela,  il faut choisir 'Ecran Publique' et indiquer le
      nom désiré. Si on le désire, on peut ouvrir sont propre écran publique
      pour AHP  en sélectionnant 'Ecran 'custom'' puis le mode d'écran.  Cet
      écran publique porte le nom de 'AHP'. On peut également choisir la
      fonte que devra utiliser AHP et sa Palette uniquement lorsque qu'on
      l'ouvre dans un Ecran 'custom'.

      - Conversions
         Ici  on règle les options  que l'on désire pour les conversions  en
      GROB et en IFF.

         - En GROB
            - Il existe deux modes de conversions (Binaire ou ASCII).
            - Le mode Binaire sauvegarde les données dans un fichier compor-
         tant l'extension .gro près à être transféré vers la HP48.
            - Le mode ASCII  sauvegarde les données  sous forme de Data avec
         l'extension  '.s'  afin de les utiliser avec le programme HPAsm  de
         Christophe Vallée qui est un assembleur saturn pour les HP48 et28.

            - L'option 'Tous les plans'  converti tous les plans  de l'image
         en les plaçant  les uns à la suite des autres.  Si cette option est
         désactivé il ne converti que les p premiers plans indiqués à côté.
            - L'option '1 Plan par GROB'  permet de séparer chaque plan dans
         un  objet graphique  différent  au lieu qu'ils  soient tous dans le
         même.
            - Les  options  'Tous les plans'  et  '1 Plan par GROB'  ne sont
         utilisés qu'en mode Binaire.
            - Le gadget  'Sortie',  permet d'indiquer le volume ou le réper-
         toire dans lequel sera sauvegardé le fichier GROB.

         - En IFF
            - Pour la conversion en IFF, il n'y a pas d'options. Il prend un
         fichier contenant un seul GROB et le converti en un fichier IFF non
         compacté comportant le même nombre de plans que le GROB.
            - Le gadget  'Sortie',  permet d'indiquer le volume ou le réper-
         toire dans lequel sera sauvegardé le fichier IFF.

      - Options
        Ce sont les options des deux protocoles que l'on règle ici.

        Pour le protocole Kermit, il y a:
        - Convertir le nom
           Si ce gadget est activé les noms des fichiers transférés seront
           convertis en majuscule pour la HP48 et en minuscule pour l'Amiga.
           Sinon les noms restent inchangés  (Attention,  lors de transferts
           de l'Amiga vers la HP48 le nom comporte aussi le chemin lorsqu'il
           n'y a pas de conversions).
        - Vérification
           Correspond  au  type  de  la  somme  de contrôle utilisé lors des
           transferts. Seul les valeurs 1, 2 et 3 peuvent être utilisées.
        - Essais
           C'est le nombre de tentatives d'envoi d'un paquet.
        - Timeout
           Correspond à la durée entre deux tentatives d'envoi.

        Pour le protocole XModem, il y a:
           - Blocs 1K
             Si ce gadget est activé la taille des paquets est de 1Ko,
             sinon elle est de 128 octets.
           - CRC
             Permet d'activer l'option CRC.

      - Sauver
         - Sauvegarde les préférences  indiquées au dessus  avec en plus le
      protocole, le mode de transfert,  la vitesse,  le répertoire de sorti
      pour la réception dans 'S:AHP.Prefs'

Le Câble de transmission
~~~~~~~~~~~~~~~~~~~~~~~~

   1) Le connecteur sur la HP48SX

      -----------------------------------------
      |          Connecteur    Diodes IR      |
      |           o o o o        O  O         |
      |           1 2 3 4                     |
      -----------------------------------------

      1 : Masse mécanique
      2 : Broche de transmission des données
      3 : Broche de réception des données
      4 : Masse logique

   2) Le connecteur sur l'Amiga

       1   2   3   4   5   6   7   8   9   10  11  12  13
      |o   o   o   o   o   o   o   o   o   o   o   o   o |
       \ o   o   o   o   o   o   o   o   o   o   o   o  /
        14  15  16  17  18  19  20  21  22  23  24  25

   3) Connections

                HP                   AMIGA

                 1 ------------------- 1
                 2 ------------------- 3
                 3 ------------------- 2
                 4 ------------------- 7


   4) La HP 48 possède une interface de transmission série asynchrone,  une
      interface UART (Universel Asynchronous Receiver Transmitter), qui lui
      permet  de  communiquer avec toutes les machines possédant une inter-
      face série RS232.

      Les valeurs des tensions aux différentes broches :
         -Sur la broche  transmission,  la tension est de  +/- 3.0 V  selon
          l'état (1 ou 0).La tolérance est 2.5%.
         -Sur la broche de réception, la HP perçoit un état 0 si la tension
          est comprise entre +1.0 V et +15.0 V ;  elle perçoit un état 1 si
          la tension est comprise entre -15.0 V et +0.3 V.
          Malgré la grande marge que l'on a pour ces tensions les variations
          entre chaque bit doit être inférieur à 2.5%.
      L'impédance  sur  la  broche  de  réception  doit être  comprise entre
      5.0 kOhms et 7.0 kOhms avec une tolérance de 2.5%.

   5) Pour plus de renseignements concernant la réalisation du câble, suivre
      les explications se trouvant dans le fichier CableHP.IFF.
      La réalisation de la prise pour la HP 48, peut être faite en utilisant
      d'autres matériaux.  Mais il faut quand même faire attention aux cours
      circuits  lors  du  soudage  ou à  de mauvais branchement qui pourrait
      détériorer l'Amiga (Oh! non) ou la HP 48.
      Pour ceux qui n'ont pas l'habitude  de ce genre de réalisation  faites
      le  vous  faire  par  une  personne qui s'y connaît si vous n'avez pas
      confiance.
      Je vous ai prévenu  du danger  qui existe,  c'est pourquoi  je décline
      toute responsabilité quand à la mauvaise réalisation du montage, et ne
      serai  en aucun  cas  tenu  pour responsable  de tout dégât  survenu à
      l'Amiga ou à la HP 48 suite à cette mauvaise réalisation.

Pour me joindre, et m'encourager:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   N'hésitez  pas à me contacter  pour me donner vos commentaires ou sugges-
tions sur AHP.

                   Doucet Stéphane
                   25, rue du stade
                   45250 Ousson sur Loire
                   France

Remerciement à
~~~~~~~~~~~~~~
- Nico Francois: Pour sa merveilleuse bibliothèque ReqTools.
- Vallée Christophe: Pour m'avoir fourni la documentation pour l'utilisation
  des bibliothèques XPR et pour son logiciel HPAsm.
- Peronnet Cyril: Pour m'avoir permis de le tester avec la HP 48 G.
- Rochet Cédric: Pour m'avoir donné envie d'acheter cette merveilleuse
                 calculatrice.
- Et quand même un grand merci à l'Amiga sans qui tout ceci n'aurait pas pu
  ce faire.
