>Wongck at 15:19, 12 October 2011

2011-10-12T15:19:23Z

← Older revision		Revision as of 11:19, 12 October 2011
Line 606:		Line 606:
	</pre>		</pre>
	Back to [[ASM_Tutorial]]		Back to [[ASM_Tutorial]]
	[[Category:~~Programming~~]]		[[Category: ASSEMBLEUR 68000 sur ATARI ST Part 2]]

>Silver Surfer: Added category

2009-05-02T20:43:17Z

Added category

← Older revision		Revision as of 16:43, 2 May 2009
Line 606:		Line 606:
	</pre>		</pre>
	Back to [[ASM_Tutorial]]		Back to [[ASM_Tutorial]]
			[[Category:Programming]]

>Zorro 2 at 15:05, 9 October 2006

2006-10-09T15:05:18Z

New page

<pre>

--------------------
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 ----------

</pre>
Back to [[ASM_Tutorial]]

Pl2 BIOS.DOC - Revision history

>Wongck at 15:19, 12 October 2011

>Silver Surfer: Added category

>Zorro 2 at 15:05, 9 October 2006