=============================================================================
                 ##    ##    ##    ##           ######      ######   
                 ##     ##  ##     ##          ##    ##    ##
                 ##      ####      ##          ##    ##    ##  ####
           ##    ##       ##       ##          ##    ##    ##    ##
            ######        ##       ########     ######      ######
=============================================================================
                         V O U S     P R E S E N T E 

               L E S    J Y L O G ' S    H P R O M    F I L E S 

           ---------------------------------------------------------
			     16 septembre 1993


CE FICHIER EST A LIRE ABSOLUMENT AVANT DE CONSULTER
 LES FICHIERS JYLOG'S HPROM FILES !!




Q U ' E S T   C E   Q U E   C ' E S T  ?
========================================
C'est un ensemble de fichiers contenant des informations sur la ROM du
calculateur HP 48, mais aussi des informations sur les concepts de 
programmation utiliss par les applications de la HP, des listes de centaines
de points d'entre en ROM (external), une description de la RAM reserve
etc ...
Beaucoup de ces fichiers sont complementaires des livres paru  ce jour pour 
les programmeurs HP 48:
 LES SECRETS DE LA HP 48 tome  1 et 2  de J.M. Ferrard  edition D3I diffusion
 VOYAGE AU CENTRE DE LA HP 48 de P. Courbis & S. Lalande  edition ANGKOR
 
Il est vivement conseill de posseder ces livres, en particulier
LES SECRETS DE LA HP 48 de maniere  comprendre et  profiter pleinement des 
fichiers HPROM et  ne pas etre 'perdu'. En effet, il y a beaucoup de
references  ce livre. 
Et tout les fichiers JYLOG'S HPROM FILES sont complementaires des uns et des
autres. Mais, etant donn la complexite de la machine, la taille de la rom,
de la forte demande de la part des programmeurs et du manque de temps
pour ma part, ces fichiers sont incomplets. Cependant, j'ai prevu de mettre
regulierement ces fichiers  jour. Ils seront donc completer au fur et 
mesure de mes recherches, mais aussi des votres ! En effet, si vous decouvrez
des choses nouvelles, signalez le moi et je rajouterai vos decouvertes
dans ces fichiers.

P O U R Q U O I ?
=================
Tout d'abord, ces fichiers constituent une source d'information non negli-
geable pour les programmeurs car la plupart de celles qui constituent ces 
fichiers ne sont pas dans les livres LES SECRETS... et VOYAGE...
Ensuite, beaucoup de programmeurs qui ont trouv des choses inedites les
gardent pour eux. Peut etre par egoisme ou pour devenir 'celebre' en sortant 
des programmes 'mieux que les autres' qui beneficie de ces trouvailles, ou
bien par manque de communication dans le petit monde de la HP.
Aussi ai-je decide, tout en faisant des recherches pour moi meme pour faire
justement de belles applications HP, de faire partager aux autres les
resultats de ces recherches, pour eviter  beaucoup d'entre vous, utilisateurs
et programmeurs, de repartir chacun  0, en se constituant chacun de son
cot sa liste d'external alors que d'autres comme moi ont deja etablit
en parti cette liste.
Ces fichiers evitent donc ces travaux, et permet  un debutant d'etre
rapidement operationnel pour nous faire decouvrir ses talents de
programmeurs.


L I S T E   D E S   F I C H I E R S
===================================
voici la liste des fichiers ecrits par moi et faisant donc partie des
JYLOG'S HPROM FILES.

JYLOG.TXT	vous etes en train de le lire.
ZONERAM.TXT	une description de la ram rserve (beaucoup plus complete
		que dans VOYAGE AU CENTRE DE LA HP48)
GUIDERPL.TXT	comment faire une veritable application HP avec: description
		des temporary environnements, gestion des variables locales,
		description de la gestion des erreurs; fonctionnement de la
		boucle parametrable, etc...
DESROM1.TXT	desassemblage de la rom de 00000  00E27: interruptions et
		routines diverses. Il sera suivit de DESROM2, DESROM3 ...
ROM48_??.TXT	ensemble de fichier contenant une liste de points d'entre de
		la rom. Ils sont organiss comme suit: ROM48_00.TXT, ROM48_10.TXT...
		les deux derniers chiffres representent le debut de l'adresse 
		partir desquelles la liste commence. dans ces exemples:
		liste des externals de 00000  0FFFF et 10000  1FFFF.
RPLPROLG.TXT	explique comment le rpl fonctionne au niveau asm

bien sur, cette liste s'agrandira au cours du temps...


M O D E   D ' E M P L O I
=========================
Comme les fichiers HPROM FILES seront mis a jour regulierment, j'ai alors
numerot le fichier JYLOG.TXT, qui indique le nombre de mise  jour.
Comme tout les fichiers HPROM FILES sont censes etre ensemble dans un
repertoire d'une disquette ou disque dur , d'un PC, ST ou serveur minitel,
je n'ai pas donner de numero de mises  jour aux autres fichiers.
ainsi, si vous voyez les fichiers HPROM FILES avec le fichier JYLOG2.TXT,
ceux ci font parti alors de la deuxieme mise  jour (3eme edition quoi..).
Cela permet  quelqu'un qui veut les telecharger  partir d'un serveur, de savoir
si il est en presence d'une mise  jour, de fichiers qui sont plus recents
que ceux qu'il peut posseder deja.

pour gagner du temps, j'ai souvent utiliser des abreviations, surtout dans
les listings de points d'entres. voici donc la legende de ces fichiers.

adr		adresse
arg		arguments
attn		veut dire attention.
a.s.		pour voir la signification de l'adr, voir la suivante
bx		bit x (x= 0,1,2 ou 3)
bool		booleen: true ou false
carry		retenue: indique aussi que retenue=1 different de nocarry
		ou retenue=0
dpilret		on enleve une adresse  pilret
fichier complet: le fichier en question est complet: il n'y aura plus de mise 
 		 jour, sauf si decouverte d'une erreur dans les explications..
niv1		designe obj niveau 1 de la pile rpn (niv2 le deuxieme etc ...)
pilret		pile des retours (sorte de pile servant  memoriser des adr de retours)
pilret1		designe la premiere adr de pilret (pilret2 la deuxieme etc...)
p0,p1,p2 	port 0,1,2
rm		indique les registres qui sont modifis par la routine
		les registres A B C D sont note: nom_registre.champ
		ainsi C.A designe C champ A
rtn:		indication sur les arguments retourns par une routine asm
rtnrpl		instructions de retours au rpl: A=DAT0 A  D0=D0+5 PC=(A)
secret1		livre LES SECRETS DE LA HP48 tome 1
secret2		idem tome 2
sp		sous-programme: appele par un gosub ou gosbvl et se terminant
		normalement par un rtn
		si il n'y a pas SP, la routine est  appel par govlng ou goto etc..
?		pas eu le temps de le dessassemble mais en rapport avec
		d'autre adr ou alors je ne connais que la taille de l'info qui
		se trouve  l'adresse concern
??		obscurit totale sur ce qui ce trouve  l'adresse concern
n:objet		designe objet du niveau n


saut de ligne entre 2 descriptions d'adresses:	les programmes de ces adresses
ne se suivent pas (il peut arriver qu'il n'y ait pas de saut de ligne , mais
que les prog de ces adresses ne se suivent pas, surtout dans les listings d'external
provenant du livre LES SECRETS..)

un # devant une adr: point d'entre (external) ou autre objet
rien devant une adresse: accessible directement par asm
@1  =@2 : a l'adresse @1 est ecrit @2

La notation est la notation PC, 1-16. c'est  dire que les bits
des registres sont nots de 1 pour le bit de poid faible jusqu'
16 pour le bit de poid fort. idem pour les numero des quartets des registres
et les drapeaux ST sont aussi note de 1  16

C O N T A C T
=============

Pour me contacter, pour me critiquer, pour corriger d'eventuelles erreurs de
comprehension de ma part, faire part de vos decouverte et completer les fichiers,
me feliciter (ba vi c'est pas interdit !), ou encore si vous voulez des precisions
des explications au cas vous avez rien, mais absolument rien pig,
vous vous connecter sur les serveurs minitel
 RTC ONE (48 70 10 29 sur PARIS),
 3615 RTEL (ou 3614 RTEL2 pour les habitus de ce serveur),
et vous ecrivez ce que vous voulez dans ma BAL (boites Aux Lettres), 
qui a pour nom magic JYLOG.


R E M E R C I E M E N T
=======================
Toutes mes recherches n'auraient t possible sans des utilitaires fonctionnant
sur hp 48. je remercie donc S. Lajevardi (HPeed) pour sa library ASM TOOLS V1.2,
C. Bourgeois (BOUHP) pour sa version crack de ASMFLASH, son editeur
STRING WRITER 2.1, et son viewer STRING VIEWER, et R. duchesne (HPReg) & M.vogel
(DEYLONE) pour leur P.C.T. 5.0.
Enfin, je me remercie (ah ah!!!) pour mon programme SYS-BASE 2.1 permettant de
retrouver tres rapidement un external dans un livre comme LES SECRETS DE LA HP 48.
