Pl2 BIOS.DOC/fr

From Atari Wiki
Revision as of 20:43, 2 May 2009 by Admin (talk | contribs) (Added category)
Jump to navigation Jump to search

                          --------------------
                             CHAPITRE NR° 6
     
                            LES FONCTIONS DU

                           BIOS et de l'XBIOS

                          -------------------- 




                      *** LES FONCTIONS DU BIOS ***
                      -----------------------------

- Toutes les remarques pr‚c‚dentes conscernant les fonctions du GEMDOS 
  sont encore valables pour les fonctions du BIOS:
  
  .Initialisation indispensable (SETBLOCK)
  .Mode de transmission des paramètres par le pile système.
  .Retour de certaines valeurs dans certains registres.
  
  Le nr° de TRAP qui correspond aux fonctions du BIOS est: TRAP #13


- Je vais maintenant enum‚rer et commenter les fonctions du BIOS qui sont
  utiles ou int‚ressantes.(tout comme pour les fonctions du GEMDOS...)





$04 (RWABS),MOT=unit‚ de disquette,MOT=nr°secteur d‚but,MOT=nombre de sec-
---         teurs à lire ou à ‚crire,L-M=adresse d'un tampon,MOT=mode

RWABS permet d'‚crire ou lire des secteurs sur disquette.

Les paramètres à passer sont:

1°:Le nr° de l'unit‚ de disquette conscern‚e:
   0=Drive A,1=Drive B,2=Disque dur
2°:Le nr° du secteur ou RWABS doit d‚buter l'op‚ration
3°:Le nombre de secteurs à lire ou à ‚crire
4°:L'adresse du tampon de donn‚es à lire ou à ‚crire selon le cas.
   La taille d'un secteur est de 512 octets.
5°:Le mode d'action de RWABS:
   0=lecture des secteurs
   1=‚criture des secteurs
   2=lecture (ne tient pas compte d'un changement de disquette lors de 
     l'op‚ration)
   3=‚criture (ne tient pas compte d'un changement de disquette lors de
     l'op‚ration)

RWABS retourne dans d0 une valeur nulle si tout est OK, ou un code 
d'erreur n‚gatif dont la valeur peut ètre:

 -1=plantage
 -2=lecteur non prêt
 -3=ordre inconnu
 -4=erreur CRC  
 -5=ordre incorrect 
 -6=piste non trouv‚e
 -7=bootsector endommag‚
 -8=secteur non trouv‚
-10=erreur d'‚criture
-11=erreur de lecture
-13=disquette prot‚g‚e en ‚criture
-14=disquette chang‚e pendant la lecture ou l'‚criture
-15=p‚riph‚rique inconnu
-16=v‚rification d'un secteur mal ‚crit
-17=pas de disquette
  
          MOVE      #0,-(SP)       ;DRIVE A
          MOVE      #0,-(SP)       ;d‚but au secteur 0 
          MOVE      #10,-(SP)      ;10 secteurs
          PEA       tampon         ;adresse des donn‚es
          MOVE      #1,-(SP)       ;‚criture
          MOVE      #4,-(SP)
          TRAP      #13
          ADDA.L    #14,SP

          DATA

tampon    DS.B      5120     ; les donn‚es à ‚crire sur les 10 secteurs
                             ; 10 secteurs=512*10 octets 


$05 (SETEXEC),L-M=valeur du nouveau vecteur,MOT=nr° du vecteur à changer
---
SETEXEC permet de changer la valeur d'un vecteur d'exeption.
(J'expliquerais en d‚tail dans un chapitre sur les VECTEURS D'EXEPTION)

     PEA       nouveau        ;nouvelle adresse
     MOVE      #10,-(SP)      ;10=instruction ill‚gale
     MOVE      #5,-(SP)
     TRAP      #13
     ADDA.L    #8,SP

$09 (MEDIACH),MOT=nr° du drive
---
MEDIACH permet de savoir si une disquette a ‚t‚ sortie ou introduite dans
le lecteur de disquette dont on sp‚cifie le nr°. (0=Drive A,1=Drive B...)
Cette fonction marche seulement si la disquette n'est PAS prot‚g‚e en 
‚criture...

D0 retourne avec:

0 si la disquette a ‚t‚ maintenue. 
1 si la disquette a des chances d'avoir ‚t‚ chang‚e (incertain).
2 si la disquette a ‚t‚ chang‚e.  
 
MEDIACH oppère un test depuis le d‚but de l'execution du programme et à
intervalles r‚guliers.
(Regardez la lumi‚re du LED rouge du lecteur de disquette clignoter très
faiblement à intervalles r‚guliers quand le lecteur est au repos...)
 
CHANGED   MACRO     $\1       ;MACRO à 1 paramètre (MEDIACH)
          MOVE      \1,-(SP)  ;\1=nr° du drive à tester
          MOVE      #9,-(SP)
          TRAP      #13
          ADDQ.L    #4,SP     ;retour dans d0
          ENDM

     Exemple d'utilisation:

          CHANGED   #1        ;la disquette du drive A a-t-elle ‚t‚ 
                              ;chang‚e?


$0A (DRVMAP),pas de paramètre
---
Cette fonction retourne dans d0 les diff‚rents lecteurs de disquettes
connect‚s.
Le bit nr°X de d0 est actif quand le drive nr°X est disponible.
(0=Drive A,1=Drive B...)

NBD  MACRO
     MOVE      #$A,-(SP)
     TRAP      #13
     ADDQ.L    #2,SP
     ENDM

     Exemple d'utilisation:

     NDB

si d0.B retourne %00001001,les lecteurs A et D sont disponibles.
(On peut tester les bits de d0 avec BTST #X par exp. pour savoir si un
lecteur X est disponible...)


$0B (GETSHIFT),MOT=-1
---
GETSHIFT permet d'obtenir l'‚tat de certaines touches qui peuvent pas 
être d‚tect‚es par les autres fonctions d'attente de touche.

Il faut passer à GETSHIFT un mot=-1 par l'interm‚diaire de la pile 
système pour obtenir dans d0.B un octet dont les bits ont la signi-
fication suivante: 
  
nr° du bit: Signification 

0         :Shift de droite
1         :Shift de gauche
2         :Control
3         :Alternate
4         :Caps Lock
5         :Clr/Home (ou touche droite de la souris)
6         :Insert   (ou touche gauche de la souris)

Si le bit est actif,la touche correspondante est activ‚e.

GETSHIFT  MACRO     $\1       ;MACRO a 1 paramètre
          MOVE      \1,-(SP)  ;\1=-1 pour l'‚tat des touches
          MOVE      #$B,-(SP)
          TRAP      #13
          ADDQ.L    #4,SP
          ENDM

     Exemple d'utilisation:

test      GETSHIFT
          BTST      #2,D0     ;a-t-on enfonc‚ la touche Control ?
          BEQ       test      ;si Bit=0:Z=1=non=retest




                    *** LES FONCTIONS DU XBIOS ***
                    ------------------------------     

- Toutes les remarques pr‚c‚dentes conscernant les fonctions du BIOS 
  sont encore valables pour les fonctions du XBIOS:
  
  .Initialisation indispensable (SETBLOCK)
  .Mode de transmission des paramètres par le pile système.
  .Retour de certaines valeurs dans certains registres.
  
  Le nr° de TRAP qui correspond aux fonctions du BIOS est: TRAP #14


- Je vais maintenant enum‚rer et commenter les fonctions du XBIOS qui 
  sont utiles ou int‚ressantes.(tout comme pour les fonctions du BIOS...)


$02 (PHYSBASE),pas de paramètre
---
PHYSBASE donne dans a0 le d‚but de la m‚moire RAM ‚cran physique.

PHYSBASE  MACRO
          MOVE      #2,-(SP)
          TRAP      #14
          ADDQ.L    #2,SP
          ENDM

$03 (LOGBASE),pas de paramètre
---
LOGBASE donne dans a0 le d‚but de la m‚moire RAM ‚cran logique.

LOGBASE   MACRO
          MOVE      #3,-(SP)
          TRAP      #14
          ADDQ.L    #2,SP
          ENDM

Pour les fonctions PHYSBASE et LOGBASE, je vous donnerais tous les d‚tails
d'utilisation et de fonctionnement dans un programme exemple qui se sert
de ces 2 fonctions.


$04 (GETREZ),pas de paramètre
---
GETREZ permet d'obtenir dans d0 la r‚solution actuelle de l'‚cran.

0=Basse r‚solution (320*200 pixels en 16 couleurs)
1=Moyenne r‚solution (640*200 pixels en 4 couleurs)
2=Haute r‚solution (640*400 pixels en monochrome)

GETREZ    MACRO
          MOVE      #4,-(SP)
          TRAP      #14
          ADDQ.L    #2,SP
          ENDM

  
$05 (SETSCREEN),MOT=r‚solution,L-M=physbase,L-M=logbase
---
SETSCREEN permet de modifier la r‚solution de l'‚cran,l'adresse de la 
physbase et l'adresse de la logbase.
Si un de ces paramètre ne doit pas ètre modifi‚, il faut passer le 
paramètre -1 à la fonction.

SETSCREEN      MACRO     $\1,$\2,$\3    ;MACRO à 3 paramètres
               MOVE      \1,-(SP)       ;\1=REZ
               MOVE      \2,-(SP)       ;\2=PHYSBASE
               MOVE      \3,-(SP)       ;\3=LOGBASE
               MOVE      #5,-(SP)
               TRAP      #14
               ADDA.L    #12,SP
               ENDM

     Exemple d'utilisation:

     SETSCREEN  #1,#-1,#-1

     On passe en moyenne r‚solution.

ATTENTION, passer en r‚solution inf‚rieure (par exp. de Moyenne r‚solution
en Basse r‚solution) ne permet que de disposer du nombre maximum de coul-
eurs du mode d'appel.(dans notre exp.,4 couleurs en Basse r‚solution...)
  

$06 (SETPALETTE),L-M=adresse de la nouvelle palette
---
SETPALETTE permet de changer les couleurs de la palette actuelle avec les
couleurs qui se trouvent à l'adresse point‚e par l'adresse paramètre.
Les valeurs qui d‚finissent les diff‚rentes couleurs doivent ètres des 
MOTS et il doit y en avoir 16.
Le 1° mot d‚finit la couleur 0,le 2° mot la couleur 1 etc..

PALETTE   MACRO     $\1       ;MACRO à 1 paramètre
          PEA       \1        ;\1=adresse de la nouvelle palette.
          MOVE      #$6,-(SP)
          TRAP      #14
          ADDQ.L    #6,SP
          ENDM

     Exemple d'utilisation:

          PALETTE   couleurs

          DATA

couleurs  DC.W      $000,$077,$070,$700,$234,$123,$700,$444
          DC.W      $444,$000,$777,$700,$070,$007,$050,$777

NB:Pour d‚finir aisement une couleur on utilise le mode h‚xad‚cimal:
-- Le chiffre des centaines repr‚sente la quantit‚ de Rouge (de 0 à 7)
   Le chiffre des dixaines repr‚sente la quantit‚ de Vert (de 0 à 7)
   Le chiffre des unit‚s repr‚sente la quantit‚ de Bleu (de 0 à 7)

Ainsi: $000=couleur noire
       $777=couleur blanche
       $700=couleur Rouge vif 
       $070=couleur Vert clair ...



$07 (SETCOLOR),MOT=nouvelle couleur,MOT=nr° de la couleur (0 à 15) à
---            changer.

SETCOLOR permet de ne changer qu'une couleur dont on fournit le nr° (de 0
à 15).
Il faut d'abord fournir à SETCOLOR la valeur que devra prendra la couleur
à changer.

COLOR     MACRO     $\1,$\2   ;MACRO à 2 paramètres.
          MOVE      \1,-(SP)  ;\1=valeur à prendre
          MOVE      \2,-(SP)  ;\2=nr° de la couleur à changer
          MOVE      #7,-(SP)
          TRAP      #14
          ADDQ.L    #6,SP
          ENDM

     Exemple d'utilisation:

     COLOR     #$777,#1

La couleur nr°1 sera blanche ($777)

$08 (FLOPRD),MOT=nombre de secteurs (1 à 9),MOT=face,MOT=nr° piste (0-79 
---          ou 0-40),MOT=nr° du 1° secteur à lire (1-9),MOT=Drive,MOT=0,
             L-M=adresse du tampon pour d‚poser les donn‚es.

FLOPRD permet de lire des secteurs sur disquette et d‚pose les donn‚es 
lues dans un tampon.

Les paramètres à passer sont:

1°:Le nombre de secteurs à lire à la suite dans une piste (de 1 à 9)
2°:La face du disk conscern‚e (0=face A,1=face B pour les doubles faces)
3°:Le nr° de la piste à lire (0 à 79 ou 0 à 40 suivant le formatage)
4°:Le nr° du 1° secteur à lire (de 1 à 9)
5°:Le nr° du Drive conscern‚ (1=A,2=B...)
6°:Un mot=0
7°:L'adresse d'un tampon ou les donn‚es seront d‚pos‚es, d'une taille de
   (512 octets )*( le nombre de secteurs lus )
   Le tampon doit ètre situ‚ à une adresse PAIRE.

D0 retourne avec une valeur nulle si tout est OK ou avec les codes 
d'erreur n‚gatifs de RWABS.

Pour obtenir quelquechose de valable il faudra bien sur là aussi mettre
cette fonction dans une boucle et faire varier les paramètres qui doivent
être chang‚s (nr° secteur...)
          


$0A (FLOPFMT),MOT=VIRGIN,L-M=$87654321,MOT=INTERLEAVE,MOT=face,MOT=nr° de
---           la piste,MOT=nombre de secteurs par piste,MOT=nr° Drive,MOT=
              0,L-M=adresse d'un tampon d'au moins 8 KO

FLOPFMT permet de formater une disquette, il suffit de passer les para-
mètres suivants à la fonction:

1°:Le VIRGIN (c'est la valeur qui sera ‚crite au cours du formatage)
   normalement,ce MOT=$E5E5
2°:Un L-M=$87654321 
3°:L'INTERLEAVE qui d‚termine l'ordre dans lequel les secteurs sont ‚crits
   Normalement ce MOT=1
4°:La face de la disquette à formater (0 ou ‚ventuellement 1 pour les D.F)
5°:Le nr° de la piste à formater (0 à 79)
6°:Le nombre de secteurs par piste (normalement 9)
7°:Le nr° du Drive conscern‚ (0=A,1=B...)
8°:Un MOT=0
9°:L'adresse d'un tampon d'au moins 8 KO pour un formatage avec 9 secteurs
   par piste...
   Le tampon doit être situ‚ à une adresse PAIRE.

D0 revient avec la valeur 0 si tout est OK ou avec un code d'erreur
n‚gatif.


$11 (RANDOM),pas de paramètre
---
RANDOM donne un nombre al‚atoir dans d0.L.
Les Bits 24 à 31 seront toujours nuls dans d0.

RANDOM    MACRO
          MOVE      #$11,-(SP)
          TRAP      #14
          ADDQ.L    #2,SP
          ENDM

NB:Pour Obtenir un nombre al‚atoire compris entre 2 valeurs, on peut par
-- exemple appeller RANDOM et faire un ' AND.L  #max,d0 ' puis un 'ADD.L 
   #min,d0 ' si (max+min) est la valeur maximale et min la valeur mini-
   male voulue. 
   Le nombre ainsi obtenu sera <=(max+min) et sera >=min.

   C'est bien plus rapide que de faire plusieurs tests,plusieurs appels à
   la fonction RANDOM et des branchements conditionnels...


$14 (SCRDMP),pas de paramètre
---
SCRDMP permet de faire une HARDCOPY de l'‚cran actuel sur imprimante.

NB:Ceci s'obtient aussi en pressant [Alternate]+[Help] ...
--

HARDCOPY  MACRO
          MOVE      #$14,-(SP)
          TRAP      #14
          ADDQ.L    #2,SP
          ENDM


$16 (SETTIME),L-M=heure et date 
---
SETTIME permet de modifier l'heure ET la date de l'horloge du bureau GEM.

Le L-M paramètre a la configuration suivante:

bits  0- 4:secondes/2
bits  5-10:minutes
bits 11-15:heures
bits 16-20:jour
bits 21-24:moi
bits 25-31:(ann‚e-1980)

SETTIME   MACRO     $\1       ;MACRO à 1 paramètre
          MOVE.L    \1,-(SP)  ;\1=heure+date
          MOVE      #$16,-(SP)
          TRAP      #14
          ADDQ.L    #6,SP
          ENDM

     Exemple d'utilisation:

          SETTIME   #%00010000001000010001000000100001

bits  0- 4:%00001*2=2 secondes
bits  5-10:%000001=1 minutes  
bits 11-15:%00010=2 heures
bits 16-20:%00001=1 jour
bits 21-24:%0001=janvier
bits 25-31:%0001000=8+1980=1988


$17 (GETTIME),pas de paramètre
---
GETTIME retourne dans d0.L l'heure et la date selon le format pr‚c‚dent.

GETTIME   MACRO
          MOVE      #$17,-(SP)
          TRAP      #14
          ADDQ.L    #2,SP
          ENDM


$1A (JDSINT),MOT=nr° de l'interruption
---
JDSINT permet de bloquer l'interruption du MFP 68901 dont on indique
le nr°.

Nous utiliserons cette fonction dans le chapitre conscernant les 
interruptions.


$1F (XBTIMER),L-M=adresse de la routine,MOT=registre DATA,MOT=registre 
---           CONTROL,MOT=timer (A=0,B=1,C=2,D=3)

XBTIMER permet d'installer un programme sous interruption dans le TIMER 
dont on a indiqu‚ le nr°.
Il suffit de passer les valeurs des registres DATA et CONTROL ainsi que
l'adresse du programme à la fonction.

Nous utiliserons XBTIMER quand nous parlerons des programmes sous inter-
ruption,patience...


$20 (DOSOUND),L-M=adresse des donn‚es
---
DOSOUND permet de jouer un son dont les donn‚es qui le d‚finissent sont
point‚e par l'adresse pass‚e en paramètre dans le pile système.

La meilleur manière d'utiliser DOSOUND est de cr‚er ses sons avec PRO
SOUND DESIGNER (Edit‚ par TRIANGLE SOFTWARE):
Il possède un ‚diteur qui sauve les sons cr‚es dans un fichier utilisa-
ble en assembleur (donn‚es DC.B).
Pour illustrer les capacit‚s de DOSOUND, vous trouverez un programme
nomm‚ SON.PRG (listing=SON.L) sur la disquette.


$23 (KEY RATE),MOT=r‚p‚tition,MOT=retard
---
KEY RATE permet de controler la r‚p‚tition des touches du clavier, le
paramètre 'r‚p‚tition' indique le temps qui s'‚coule entre 2 r‚p‚titions
de la touche, le paramètre 'retard' indique  le temps qui s'‚coule avant
la mise en route de la r‚p‚tition.
Les paramètre 'r‚p‚tition' et 'retard' sont exprim‚s sous forme de
multiples de 20 ms.

Si un des 2 paramètres vaut -1, il n'est pas modifi‚ et d0 retourne les
valeurs actuelles du retard et de la r‚p‚tition sous cette forme:

Octet de poids faible de d0.W=r‚p‚tition
Octet de poids fort de d0.W=retard

KEYRATE   MACRO     $\1,$\2   ;MACRO à 2 paramètres
          MOVE      \1,-(SP)  ;\1=r‚p‚tition
          MOVE      \2,-(SP)  ;\2=retard
          MOVE      #$23,-(SP)
          TRAP      #14
          ADDQ.L    #6,SP
          ENDM


$25 (VSYNC),pas de paramètre
---
VSYNC permet de synchroniser certaines ‚ditions graphiques en attendant
la prochaine interruption de trame.
VSYNC diminue le clignotement de l'‚cran dans certains cas o— la gestion
de l'‚cran est très charg‚e...


VSYNC     MACRO
          MOVE      #$25,-(SP)
          TRAP      #14
          ADDQ.L    #2,SP
          ENDM

$26 (SUPEXEC),L-M=adresse de la routine à executer en mode SUPERviseur
---
SUPEXEC permet l'execution d'une routine en mode superviseur, il suffit
de passer l'adresse de cette routine à SUPEXEC et de terminer la routine
par RTS.

     Exemple:

     PEA       ici       ;SUPEXEC 'ici'
     MOVE      #$26,-(SP)
     TRAP      #14
     ADDQ.L    #6,SP
     TERM              ;appel de la macro TERM du gemdos

ici  ANDI.W    #%1111111,SR   ;necessite le MODE SUPERVISEUR
     RTS




                              -----------------

Voilà pour ce qui est des fonctions du BIOS et de l'XBIOS, maintenant je
vous conseille très fortement de bien regarder le fichier MACROS.L qui 
contient les diff‚rentes macros que nous avons cr‚‚ au cours de ces deux
derniers chapitres.
Au besoin, notez vous sur une fiche le nom des diff‚rentes MACROS et
leur utilit‚.

Quand vous vous sentirez prêts plongez dans les exercices, creusez vous
bien la tête pour chaque ‚xo., passez-y un jour ou deux s'il le faut,
ce n'est que par un travail individuel que vous pourrez progresser.

Ces exercices ne comportent pas de difficult‚s pour ceux qui connaissent
bien les instructions du 68000 et qui ont bien compris comment utiliser
les fonctions du GEMDOS,BIOS,XBIOS...
Utilisez le plus possible les MACROS que nous avons cr‚es, elle ne sont
pas là pour rien...

Si vous êtes sur que votre listing est juste et que malgr‚ tout il plante,
vous ne pourrez que vous en prendre à vous même.
Il suffit d'une minuscule petite erreur (qui passe souvent inaper‡ue),
comme mettre un L-M à la place d'un MOT ou faire une erreur dans les
modes d'adressage pour qu'un listing apparement correct plante à l'‚xecu-
tion. (Bien que l'assembleur ne vous indique pas qu'il y a une erreur, il
est incapable de d‚couvrir ces erreurs là: il ne d‚tecte que les erreurs
grossières et les erreurs de syntaxe.) 

Il faudra alors aller à la chasse au BUG et ce n'est que si vous rentrez
bredouille, après 10 heures d'intense concentration que la correction du
listing vous sera vraiment utile.

Sachez bien qu'il n'y a pas plus minutieux et plus m‚ticuleux qu'un bon
programmeur en assembleur:il ne laissera par le moindre octet trainer
dans son listing, et il est souvent plus fier de la perfection de son
listing que du r‚sultat...

 BONNE CHANCE ...



  PIECHOCKI Laurent
  8,impasse Bellevue                        exercices dans:EXOS_2.DOC  
  57980 TENTELING                                          ----------


 



Back to ASM_Tutorial