Keyboard Protocol
CLAVIER INTELLIGENT
1. Introduction
2. Documents de r‚f‚rence
3. Clavier
4. Souris
4.1. Positionnement relatif
4.2. Positionnement absolu
4.3. Mode d‚placement curseur
5. Manettes de jeu
5.1. Compte-rendu d'‚v‚nement manette de jeu
5.2. Interrogation de manette de jeu
5.3. Surveillance manette de jeu
5.4. Surveillance bouton de feu
5.5. Mode clavier des manettes de jeu
6. Horloge calendrier
7. Demandes d'‚tat
8. Mise sous tension
9. Jeu des commandes clavier
9.1. Reset
9.2. Mode de prise en compte des boutons de souris
9.3. Fixe le mode de positionnement relatif de la souris
9.4. Fixe le mode de positionnement absolu de la souris
9.5. Fixe la souris en mode clavier
9.6. Fixe le seuil de d‚placement souris
9.7. Fixe l'‚chelle de la souris
9.8. Mode demande de la position absolue de la souris
9.9. D‚finit la position de la souris
9.10. Fixe l'origine verticale en bas
9.11. Fixe l'origine verticale en haut
9.12. Reprise
9.13. D‚sactivation de la souris
9.14. Pause
9.15. Fixe le mode ‚v‚nement manette de jeu
9.16. Fixe le mode demande manette de jeu
9.17. Demande d'‚tat manette de jeu
9.18. Surveillance manette de jeu
9.19. Surveillance du bouton de feu
9.20. Fixe la manette de jeu en mode clavier
9.21. D‚sactivation des manettes de jeu
9.22. Mise … jour de l'horloge-calendrier
9.23. Demande de la date et de l'heure
9.24. Chargement de donn‚es en m‚moire
9.25. Lecture de donn‚es en m‚moire
9.26. Ex‚cution de routine contr“leur
9.27. Demandes d'‚tat
10. Appendice A : Codes de scrutation clavier
PROTOCOLE DU CLAVIER INTELLIGENT
(Mise … jour : 26/02/85)
1. Introduction
Le clavier intelligent (IKBD) d'Atari Corp. est un contr“leur
clavier d'usage commun suffisamment flexible pour ˆtre utilis‚
avec un grand nombre de produits sans modifications. Le clavier,
avec son contr“leur, fournit des points de connexion convenables
pour une souris et des manettes de jeu. Le processeur clavier
comporte ‚galement une horloge avec gestion de la date d'une
pr‚cision d'une seconde.
Le clavier intelligent a ‚t‚ con‡u comme suffisamment g‚n‚ral
pour pouvoir servir dans un grand nombre de nouveaux produits
informatiques. Des ajustements quant au nombre de touches du
clavier, la r‚solution de la souris, etc. peuvent ˆtre effectu‚s.
Le clavier intelligent communique avec le processeur maŒtre
par une liaison s‚rie bi-directionnelle … haute vitesse. Il peut
fonctionner dans plusieurs modes afin de rendre possibles diverses
utilisations du clavier, des manettes de jeu ou de la souris. Un
usage restreint du contr“leur est ‚galement autoris‚ pour des
applications dans lesquelles un mode de communication
unidirectionnel est utile, ceci par une gestion soigneuse des
modes par d‚faut.
2. Documents de r‚f‚rence
Atari Corp. RBP/GHU/SD Keyboard Schematic (14/09/84)
Atari Corp. RBP/GHU/SD Keyboard Layout (non pagin‚, non dat‚)
3. Clavier
Le clavier retourne toujours les codes d'appui et de
relƒchement de touche, chaque fois qu'une touche est press‚e ou
relƒch‚e. Les codes d'appui de touche d‚butent … 1 et sont d‚finis
dans l'appendice A en fin de chapitre. A titre d'exemple, la
position de la touche ISO dans la table des codes de touches
press‚es existera mˆme si aucune touche ne correspond … cette
position sur un clavier particulier. Le code de relƒchement de
touche peut ˆtre obtenu en effectuant un OU logique entre 0x80 et
le code d'appui de la touche (bit 7 positionn‚ … 1).
Les codes sp‚cifiques 0xF6 … 0xFF sont r‚serv‚s pour les
fonctions suivantes :
OxF6 compte-rendu d'‚tat
0xF7 position absolue de la souris
0xF8-0xFB position relative de la souris
(bit 0 … 1 si bouton droit appuy‚
bit 1 … 1 si bouton gauche appuy‚)
0xFC heure et date
0xFD descripteur d'‚tat manettes de jeu
0xFE ‚v‚nement manette de jeu 0
0xFF ‚v‚nement manette de jeu 1
Les deux touches 'Shift' retournent des codes d'appui
diff‚rents. Il en va de mˆme pour les touches 'Enter' et 'Return'.
4. Souris
Le port souris doit ˆtre capable de contr“ler une souris avec
une r‚solution d'environ 200 comptes (d‚placements ou cliquages)
par pouce (NDT: soit 80 positions par centimŠtres environ). La
souris doit ˆtre scrut‚e suffisament souvent pour autoriser le
suivi de d‚placements … une vitesse allant jusqu'… 10 pouces par
seconde (NDT: soit environ 25 cm/s).
Le clavier intelligent peut rendre compte des actions sur la
souris selon trois modes distincts. Il peut rendre compte de la
position relative (… la pr‚c‚dente), de la position absolue de la
souris dans un systŠme de coordonn‚es convenu, ou convertir les
d‚placements de la souris en codes clavier curseur ‚quivalents.
Les boutons de la souris peuvent ˆtre trait‚s comme partie
int‚grante de la souris ou comme des touches de clavier
suppl‚mentaires.
4.1. Positionnement relatif
En mode positionnement relatif, le clavier retournera un
descripteur de position de la souris lorsqu'un ‚v‚nement souris se
produira. Constitue un ‚v‚nement souris tout appui ou tout
relƒchement de bouton, ou tout d‚placement d‚passant dans l'un des
axes de coordonn‚es un seuil donn‚. En l'absence de seuil, tout
bit de r‚solution provoque un envoi vers le processeur maŒtre.
On notera que le clavier intelligent peut retourner une
position relative de la souris avec un incr‚ment horizontal ou
vertical significativement plus ‚lev‚ que le seuil. Cela arrivera
lorsqu'aucun compte-rendu de positionnement relatif de la souris
n'aura ‚t‚ renvoy‚ : a) parce que le clavier a ‚t‚ inhib‚ (les
‚v‚nements seront stock‚s jusqu'… ce que la communication avec le
clavier reprenne) b) parce qu'un ‚v‚nement est en train d'ˆtre
transmis.
Le descripteur de positionnement relatif de la souris est un
bloc constitu‚ de trois octets (peu importe le mode clavier):
%1111 10xx drapeau de positionnement relatif
||
| ---------- ‚tat du bouton droit
----------- ‚tat du bouton gauche
deltaX d‚calage horizontal sign‚
deltaY d‚calage vertical sign‚
On notera que la valeur des bits d'‚tat des boutons doit ˆtre
valide mˆme si le MODE D'ACTIVATION SOURIS a ‚t‚ positionn‚ pour
que les boutons soient consid‚r‚s comme partie int‚grante du
clavier.
Si le d‚calage cumul‚ des d‚placements horizontaux ou
verticaux de la souris d‚borde le domaine +127 … -128, le compte-
rendu de positionnement relatif est effectu‚ sur plusieurs blocs
descriptifs successifs.
On notera que le signe du d‚calage vertical deltaY est
fonction de l'origine verticale choisie.
4.2. Positionnement absolu
Le clavier intelligent a la possibilit‚ de rendre compte de
la position de la souris en coordonn‚es absolues. Des commandes
existent pour r‚initialiser la position de la souris, d‚finir les
‚chelles horizontale et verticale, et demander la position
courante de la souris.
4.3. Mode d‚placement curseur
Le clavier intelligent peut convertir les actions sur la
souris en ‚quivalences clavier. Le nombre d'appuis de touche
correspondant … une action peut ˆtre sp‚cifi‚ diff‚remment pour
chaque axe. Le clavier intelligent fournit des informations sur
les actions souris selon la plus haute r‚solution valable et
g‚nŠre simplement une paire d'‚v‚nements appui de touche pour
chaque multiple du facteur d'‚chelle.
Ce mode de fonctionnement provoque l'envoi du code de
relƒchement de touche imm‚diatement aprŠs le code d'appui de
touche. Les appuis de bouton de la souris provoquent ‚galement
l'envoi de codes d'appui et de relƒchement de touche correspondant
… ceux qui leur sont normalement assign‚s dans la table des codes
clavier (soit 0x74 pour le bouton droit et 0x75 pour le gauche).
5. Manettes de jeu
5.1. Compte-rendu d'‚v‚nement manette de jeu
Dans ce mode, le clavier intelligent g‚nŠre un bloc
descripteur chaque fois que la position de la manette de jeu a
chang‚e (c'est-…-dire pour chaque ouverture ou fermeture d'un
interrupteur ou contact de la manette de jeu).
Le bloc descripteur d'un ‚v‚nement manette de jeu est
constitu‚ de deux octets:
%1111 111x d‚signe un ‚v‚nement manette de jeu
|
--------- manette de jeu 0 ou 1
%x000 yyyy
| ||||
| ------------ position de la manette
----------------- ‚tat du bouton de feu
5.2. Interrogation de manette de jeu
L'‚tat courant des ports manette de jeu peut ˆtre interrog‚ …
n'importe quel moment dans ce mode en envoyant une commande
d'"interrogation manette de jeu" vers le circuit clavier.
La r‚ponse du clavier intelligent … cette interrogation prend
la forme d'un bloc de trois octets ayant le sens suivant :
0xFD en-tˆte de r‚ponse manette de jeu
%x000 yyyy manette de jeu 0
%x000 yyyy manette de jeu 1
o— x correspond … l'‚tat du bouton de feu et yyyy … la
position de la manette.
5.3. Surveillance manette de jeu
Ce mode permet de consacrer presque toute l'activit‚ du
circuit clavier au compte-rendu des ‚tats successifs des manettes
de jeu selon une cadence d‚finie par l'utilisateur. Le clavier
reste dans ce mode jusqu'… une commande de reset ou une commande
le placant dans un autre mode. Dans ce mode, la commande PAUSE ne
stoppe pas seulement les communications entre le clavier et le
processeur mais ‚galement la scrutation des manettes de jeu (les
informations ne sont pas empil‚es).
5.4. Surveillance Bouton de feu
Ce mode permet de d‚dier le circuit clavier au seul contr“le
du bouton de feu de la manette de jeu. Dans ce mode, l'‚tat du
bouton de feu est test‚ … la fr‚quence maximale autoris‚e par la
vitesse de transmission s‚rie. Les donn‚es sont compact‚es sur
huit bits pour envoi au processeur maŒtre. Le circuit clavier
reste dans ce mode jusqu'… une commande de reset ou une commande
de changement de mode. Dans ce mode la commande PAUSE ne stoppe
pas seulement l'envoi des informations du clavier vers le
processeur mais arrˆte aussi temporairement la scrutation du
bouton de mise … feu (les informations ne sont pas empil‚es).
5.5. Mode Clavier des manettes de jeu
Le circuit clavier peut ˆtre command‚ pour que les actions
sur les manettes de jeu soient converties en ‚quivalents clavier
(touches curseur).
Les ‚v‚nements manette de jeu produisent un code d'appui de
touche imm‚diatement suivi d'un code de relƒchement, de la mˆme
fa‡on que pour les ‚v‚nements souris. Les boutons de feu des
manettes de jeu ont ‚galement leur ‚quivalents clavier, codes
juste sup‚rieurs … ceux de la matrice clavier (soit 0x74 pour la
manette 0 et 0x75 pour la manette 1).
6. Horloge calendrier
Le clavier intelligent contr“le ‚galement une horloge
calendrier pour le systŠme. Des commandes sont disponibles pour
remettre … jour et interroger cette horloge calendrier. La mise …
jour est garantie pour une pr‚cision de une seconde.
7. Demandes d'‚tat
L'‚tat courant du clavier, les modes actifs et les paramŠtres
peuvent ˆtre obtenus par des commandes de demande d'‚tat
correspondant … des commandes du clavier intelligent.
8. Mise sous tension
Le contr“leur clavier effectue un auto-test simple … la mise
sous tension afin de d‚tecter des erreurs majeures (somme de
contr“le des m‚moires mortes et test des m‚moires vives) et divers
problŠmes comme des touches coinc‚es. Toute touche appuy‚e lors de
la mise sous tension est consid‚r‚e comme coinc‚e et son code de
relƒchement est renvoy‚ (ce qui, en l'absence de code d'appui le
pr‚c‚dant, est consid‚r‚ comme une erreur clavier). Si l'auto-
test du contr“leur s'est d‚roul‚ sans erreur, le code 0xF0 est
renvoy‚. (La premiŠre version du clavier intelligent ‚tait la
version 0xF0, les suivantes auront les num‚ros 0xF1, etc.)
Les options par d‚faut du clavier sont les suivantes :
1) Compte-rendu du positionnement de la souris en mode relatif
avec un incr‚ment d'une unit‚ pour chaque axe.
2) Origine verticale Y=0 correspondant au haut de l'‚cran.
3) Mode compte-rendu d'‚v‚nement pour les manettes de jeu.
4) Deux boutons pris en compte pour la souris.
AprŠs toute commande manette de jeu, le circuit clavier
considŠre que les manettes de jeu sont connect‚es aux ports 0 et 1
des manettes de jeu. Toute commande souris (sauf la DESACTIVATION
DE SOURIS) entraŒne la scrutation du port 0 comme ‚tant le port
reli‚ … la souris et les deux boutons d‚pendant de celle-ci. Si
une commande de d‚sactivation de la souris est re‡ue alors que le
port 0 est logiquement li‚ … une souris, le bouton est alors
assign‚ … la manette 1.
9. Jeu des commandes clavier
Cette partie comprend la liste des commandes qui peuvent ˆtre
envoy‚es au clavier intelligent. Les codes de commande (comme
0x00) qui ne sont pas d‚velopp‚s ici ne provoquent aucune
op‚ration (ils peuvent ˆtre assimil‚s … des NOP).
9.1. RESET
Ox80
0x01
REMARQUE: La commande RESET est la seule commande clavier qui
comprenne deux octets en dehors des paramŠtres. Tout octet suivant
0x80, autre que 0x01, sera ignor‚ (et provoquera la non prise en
compte de la commande 0x80).
Un reset du circuit clavier peut ‚galement ˆtre provoqu‚ en
envoyant un break durant au moins 200ms vers le circuit clavier.
L'envoi d'une commande reset amŠne la remise des paramŠtres
clavier … leurs valeurs par d‚faut (voir 8. Mise sous tension). Il
n'affecte pas l'horloge calendrier.
Une commande de RESET provoque l'auto-test du circuit
clavier. Si ce test est positif, le clavier envoie le code 0xF0
dans un d‚lai de 300ms aprŠs la r‚ception de la commande RESET (ou
… la fin du break s'il s'agit d'un reset mat‚riel). Le clavier
teste ensuite la matrice clavier pour d‚celer d'‚ventuelles
touches coinc‚es. Toute touche consid‚r‚e comme coinc‚e provoque
l'envoi du code break (relƒchement) correspondant … cette touche
(un code de relƒchement survenant sans avoir ‚t‚ pr‚c‚d‚ par un
code d'appui de touche doit ˆtre consid‚r‚ comme une erreur au
niveau de la matrice clavier).
Notes du traducteur : De par son architecture mat‚rielle, l'unit‚
centrale du ST est reli‚e au clavier intelligent via le processeur
multifonctions MC68901 et un ACIA MC6850. C'est ce dernier circuit
qui assure les communications s‚rie entre le MC68000 et le 6801
responsable du clavier. Il en d‚coule que toute commande vers le
circuit clavier suppose que l'ACIA est actif et correctement
programm‚.
A titre d'information, voici l'ensemble des commandes de
reset de circuit ACIA et clavier envoy‚es lors du boot du systŠme
par le systŠme d'exploitation :
move.b #$3,$FFFC00 * reset ACIA MC6850
move.b #$96,$FFFC00 * division horloge/16, 8 bits
* sans parit‚, 1 bit stop,etc.
move.l #_commande,-(sp) * ptr commande reset et modes
move.w #3,-(a7) * 4 octets … envoyer
bsr _Ikbdws * fonction $19 du trap 14
_commande dc.b $80,$01,$12,$1A * reset, d‚sactive souris et
* manettes de jeu
9.2. FIXE LE MODE DE PRISE EN COMPTE DES BOUTONS DE SOURIS
0x07
%0000 0mss mode de prise en compte
||| (m est suppos‚ … 1 en mode code CLAVIER
||| de la souris)
------------ 0wx l'appui ou le relƒchement de
|| bouton provoque un compte-rendu
|| de position souris (wx n'est
|| significatif que si la souris
|| est en positionnement absolu)
| --- 1 -> la pression du bouton pro-
| voque un compte-rendu de
| la position absolue
---- 1 -> le relƒchement du bouton
provoque un compte-rendu de
la position absolue
100 : les boutons de la souris sont
consid‚r‚s comme des touches.
Cette commande d‚finit la fa‡on d'agir des boutons de la
souris, plus pr‚cis‚ment la fa‡on dont ils seront pris en compte.
Le mode de traitement par d‚faut des boutons de la souris est
%00000000, c'est-…-dire que les boutons sont consid‚r‚s comme
partie int‚grante de la souris.
9.3. FIXE LE MODE DE POSITIONNEMENT RELATIF DE LA SOURIS
0x08
Place la souris en mode relatif (mode PAR DEFAUT), c'est …
dire que chaque d‚placement de la souris provoque l'envoi d'un
descripteur comprenant les d‚calages horizontaux et verticaux
relatifs … la pr‚c‚dente position. Les blocs descripteurs de
positionnement sont g‚n‚r‚s de fa‡on asynchrone par le clavier
intelligent lorsqu'un d‚placement selon l'un des axes d‚passe le
seuil minimal fix‚ (voir 9.6. SEUIL DECALAGE SOURIS). Selon le
mode fix‚ par la commande pr‚c‚dente, des descripteurs de position
peuvent ‚galement ˆtre envoy‚s lorsqu'un des boutons de la souris
est press‚ ou relƒch‚. Dans les autres cas, les boutons de la
souris sont consid‚r‚s comme des touches clavier.
9.4. FIXE LE MODE DE POSITIONNEMENT ABSOLU DE LA SOURIS
0x09
Xsup position horizontale maximale (en unit‚s de
Xinf d‚placement) cod‚e sur deux octets
Ysup position verticale maximale (en unit‚s de
Yinf d‚placement) cod‚e sur deux octets
Les d‚placements de souris seront d‚crits en positionnement
absolu. Les coordonn‚es horizontale et verticale sont conserv‚es
au reset.
Dans ce mode, les valeurs des coordonn‚es conserv‚es ne
doivent pas sortir de l'intervalle 0 - grand nombre positif d‚fini
par la commande. Un d‚placement jusqu'… une coordonn‚e n‚gative
sera ignor‚. La commande fixe la valeur positive maximale qui peut
ˆtre atteinte. Toute valeur sup‚rieure est ignor‚e.
9.5. FIXE LA SOURIS EN MODE CLAVIER
0x0A
Xdelta distance en unit‚s horizontales provoquant
l'envoi du code {LEFT} ou du code {RIGHT}
Ydelta distance en unit‚s verticales provoquant
l'envoi du code {UP} ou du code {DOWN}
Place la souris en mode clavier … la place du mode position
relative ou position absolue. AprŠs chaque d‚placement de souris
exc‚dant le seuil horizontal ou vertical fix‚ par cette commande,
le circuit clavier envoie l'‚quivalent d'un appui de touche
curseur du clavier, puis le code de relƒchement de touche. A noter
que cette commande n'est pas affect‚e par l'origine des
d‚placements souris.
9.6. FIXE LE SEUIL DE DEPLACEMENT SOURIS
0x0B
Xseuil seuil horizontal en unit‚s de d‚placement
Yseuil seuil vertical en unit‚s de d‚placement
Cette commande fixe le seuil … partir duquel un d‚placement
de la souris sur l'axe horizontal ou vertical provoquera l'envoi
par le circuit clavier d'un descripteur de position souris. On
notera qu'elle n'affecte pas la r‚solution des donn‚es renvoy‚es
au processeur. Cette commande est UNIQUEMENT valide en mode de
positionnement relatif de la souris. Les seuils horizontaux et
verticaux sont fix‚s … 1 par d‚faut lors du RESET (ou … la mise
sous tension).
NDT : Une unit‚ de d‚placement de la souris correspond
environ … 0,2 mm, cela se traduit au bureau GEM par un d‚placement
d'un pixel.
9.7. FIXE L'ECHELLE DE LA SOURIS
0x0C
X‚chelle nombre d'unit‚s de d‚placement par X interne
Y‚chelle nombre d'unit‚s de d‚placement par Y interne
Cette commande d‚finit le facteur r‚ducteur … appliquer aux
d‚placements horizontaux et verticaux. Elle est valide UNIQUEMENT
en mode de positionnement absolu de la souris. Dans ce mode, un
nombre d‚termin‚ d'unit‚s de d‚placement horizontal ou vertical
doit survenir pour qu'un d‚calage interne de une unit‚ soit
enregistr‚e par le contr“leur clavier.
Il est important de relever que cette commande ne fonctionne
qu'en mode de positionnement absolu mˆme si l'on a command‚ au
clavier de rendre compte des appuis ou des relƒchements de boutons
de la souris (voir commande 0x07, Ý9.2.).
9.8. DEMANDE DE LA POSITION ABSOLUE DE LA SOURIS
0x0D
Cette commande renvoie :
OxF7 en-tˆte de descripteur de position absolue
0000 xxxx
||||
||| ----- bouton droit press‚ depuis derniŠre demande
|| ------ bouton droit relƒch‚ depuis derniŠre demande
| ------- bouton gauche press‚ depuis derniŠre demande
-------- bouton gauche relƒch‚ depuis derniŠre demande
Xsup
Xinf coordonn‚e horizontale sur deux octets
Ysup
Yinf coordonn‚e verticale sur deux octets
La commande de demande de la position absolue de la souris
est UNIQUEMENT valide en mode de positionnement absolu de la
souris, peu importe le mode de traitement des boutons fix‚ par une
commande 0x07 (voir Ý9.2.).
9.9. DEFINIT LA POSITION DE LA SOURIS
0X0E
0X00 octet de remplissage
Xsup
Xinf position horizontale absolue de la souris
Ysup
Yinf position verticale absolue de la souris
Cette commande permet au programmeur de fixer la position
absolue de la souris, horizontale et verticale.
9.10. FIXE L'ORIGINE VERTICALE EN BAS
0x0F
Cette commande fixe l'origine de l'axe des ordonn‚es en bas
du systŠme de coordonn‚es logiques utilis‚ par le circuit clavier,
tant en mode de positionnement absolu que relatif. Dans ce mode,
le d‚placement de la souris vers l'utilisateur se traduit par un
d‚calage n‚gatif et un d‚placement dans le sens oppos‚ par un
d‚calage positif.
9.11. FIXE L'ORIGINE VERTICALE EN HAUT
0x10
Cette commande fixe l'origine de l'axe des ordonn‚es en haut
du systŠme de coordonn‚es logiques utilis‚ par le circuit clavier,
tant en mode de positionnement absolu que relatif. Dans ce mode,
le d‚placement de la souris vers l'utilisateur se traduit par un
d‚calage positif et un d‚placement dans le sens oppos‚ par un
d‚calage n‚gatif. Ce mode est le mode PAR DEFAUT au reset ou … la
mise sous tension du systŠme.
9.12. REPRISE
Reprend l'envoi des donn‚es du circuit clavier vers le
processeur. Etant donn‚ que toute commande re‡ue par le circuit
clavier alors qu'il se trouve en mode PAUSE constitue un ordre de
REPRISE implicite, cette commande peut ˆtre consid‚r‚e comme
inutile. Si le clavier n'est pas en mode PAUSE, cette commande est
tout bonnement ignor‚e.
9.13. DESACTIVATION DE LA SOURIS
0x12
Plus aucun compte-rendu d'‚v‚nement souris n'est envoy‚ par
le circuit clavier au processeur (et la scrutation peut ˆtre
inactive). Toute commande d'entr‚e dans un mode souris valide
provoque la reprise des envois de descripteurs de position souris.
(Les commandes d'entr‚e dans un mode valides sont : FIXE LE
POSITIONNEMENT RELATIF DE LA SOURIS, FIXE LE POSITIONNEMENT ABSOLU
DE LA SOURIS et FIXE LA SOURIS EN MODE CLAVIER).
N.B.: Si les boutons de la souris ont ‚t‚ d‚finis comme
devant ˆtre trait‚s comme des touches clavier, cette commande
les AFFECTE ‚galement (c'est-…-dire qu'ils deviennent inactifs).
9.14. PAUSE
0x13
Stoppe l'envoi de donn‚es du clavier vers le processeur
jusqu'… ce qu'une autre commande soit envoy‚e au clavier.
L'activit‚ du clavier est toujours scrut‚e et les codes de
scrutation de mˆme que les codes ASCII sont empil‚s (jusqu'au
maximum support‚ par le microcontr“leur, c'est-…-dire 8 octets)
afin d'ˆtre envoy‚s au processeur lorsque celui-ci demandera la
reprise des envois. Si l'on se trouve en mode EVENEMENT MANETTE DE
JEU, les ‚v‚nements manette sont ‚galement empil‚s.
Les actions sur la souris sont prises en compte tant que l'on
se trouve en mode PAUSE. Si le clavier est en mode POSITIONNEMENT
RELATIF de la souris, les ‚v‚nements souris sont cumul‚s en
fonction des seuils de d‚calage maxima, afin de produire le
minimum de blocs descripteurs possibles (les seuils de d‚calage
maxima s'‚tendent de -128 … +127 unit‚s de d‚placement). L'appui
ou le relƒchement d'un bouton de la souris amŠne tout ‚v‚nement
cumul‚ … ˆtre stock‚ dans un bloc descripteur, si l'on se trouve
en mode de POSITIONNEMENT RELATIF de la souris.
Etant donn‚ que le tampon de stockage d'‚v‚nements du circuit
clavier n'est que de 8 octets, il est recommand‚ d'user de ce mode
avec discernement, les communications entre le clavier et le
processeur ne devant pas ˆtre fig‚es plus de quelques
millisecondes si l'on ne d‚sire pas perdre d'‚v‚nement.
Les communications sont stopp‚es seulement aprŠs l'envoi en
cours, si un envoi est en cours. Le mode PAUSE ne d‚butera qu'une
fois le bloc descripteur compl‚tement envoy‚.
Lorsque le circuit clavier se trouve en mode SURVEILLANCE DE
MANETTE ou SURVEILLANCE DE BOUTON DE FEU, la commande PAUSE stoppe
‚galement ce mode de compte-rendu permanent, c'est-…-dire que les
‚v‚nements ne sont plus empil‚s pour transmission.
9.15. FIXE LE MODE EVENEMENT MANETTE DE JEU
0x14
Entre en mode compte-rendu d'‚v‚nement manette de jeu. Il
s'agit du mode PAR DEFAUT. Chaque ouverture ou fermeture de
contact d'une manette de jeu provoque l'envoi d'un descripteur
d'‚v‚nement manette de jeu.
9.16. FIXE LE MODE DEMANDE MANETTE DE JEU
0x15
D‚sactive le mode EVENEMENT MANETTE DE JEU. Le processeur
doit envoyer au circuit une commande de DEMANDE D'ETAT MANETTE DE
JEU pour connaŒtre l'‚tat d'une manette.
9.17. DEMANDE D'ETAT MANETTE DE JEU
0x16
Renvoie un enregistrement d‚crivant l'‚tat courant des
manettes de jeu. Cette commande est valide que l'on se trouve en
mode EVENEMENT MANETTE DE JEU ou en mode DEMANDE MANETTE DE JEU.
9.18. SURVEILLANCE MANETTE DE JEU
0x17
vitesse temps d'‚chantillonnage en centiŠmes de seconde
Blocs retourn‚s (blocs de 2 octets retourn‚s
aussi longtemps que l'on est dans ce mode) :
%0000 00xy
||
| --- Bouton de feu Manette 0
---- Bouton de feu Manette 1
%nnnn mmmm
|||| ||||
|||| ------ ‚tat de la Manette 0
----------- ‚tat de la Manette 1
Dans ce mode, le clavier intelligent ne fait que trois
choses: a) communiquer sur la ligne s‚rie, b) mettre … jour
l'horloge-calendrier, c) surveiller les manettes de jeu. Le taux
plac‚ en paramŠtre d‚finit la fr‚quence d'‚chantillonnage.
N.B. : Le programmeur ne peut pas fixer cette fr‚quence … un
taux sup‚rieur … ce que permet la vitesse de communication s‚rie
pour l'envoi de blocs de deux octets (NDT: la fr‚quence minimale
d'un centiŠme de seconde est admise par le circuit clavier!).
9.19. SURVEILLANCE DU BOUTON DE FEU
0x18
Valeur retourn‚e: (tant que l'on est dans ce mode)
%bbbb bbbb ‚tat du bouton de feu de la manette
1. (huit informations par octet, le
premier ‚chantillonnage ‚tant donn‚
dans le bit fort (bit 7))
Dans ce mode, le clavier intelligent ne fait que trois
choses: a) communiquer sur la ligne s‚rie, b) mettre … jour
l'horloge-calendrier, c) surveiller le bouton de feu de la
manette 1. Le bouton de feu est scrut‚ … une fr‚quence telle que 8
‚chantillonnages sont effectu‚s pour un octet envoy‚ (c'est-…-dire
que la vitesse de scrutation est de 8/10ø de la vitesse de
transmission [NDT: soit une vitesse de scrutation de 6340
interrogations par secondes]). L'intervalle d'‚chantillonnage
reste aussi constant que possible.
9.20. FIXE LA MANETTE DE JEU EN MODE CLAVIER
0x19
RX temps (en diziŠmes de seconde) n‚cessaire pour
produire un d‚calage horizontal
RY temps (en diziŠmes de seconde) n‚cessaire pour
produire un d‚calage vertical
TX temps (en diziŠmes de seconde) de fermeture du
contact avant relƒchement produisant un d‚calage
horizontal du curseur
TY temps (en diziŠmes de seconde) de fermeture du
contact avant relƒchement produisant un d‚calage
vertical du curseur
VX temps (en diziŠmes de seconde) de fermeture du
contact aprŠs relƒchement produisant un d‚calage
horizontal du curseur
VY temps (en diziŠmes de seconde) de fermeture du
contact aprŠs relƒchement produisant un d‚calage
vertical du curseur
Dans ce mode, la manette de jeu 0 est scrut‚e et trait‚e
comme s'il s'agissait des touches curseur. A la fermeture de
contact, un code d'appui et de relƒchement de touche curseur est
g‚n‚r‚. Puis aprŠs un d‚lai (RX ou RY selon le cas), ces codes
sont renvoy‚s selon une fr‚quence d‚finie par TX et TY. AprŠs
r‚ouverture de contact, des codes curseur sont g‚n‚r‚s selon une
fr‚quence d‚finie par VX et VY. Ceci autorise une gestion de la
manette avec auto-r‚p‚tition.
On notera qu'en pla‡ant RX et/ou RY … 0, il est possible de
d‚sactiver cette auto-r‚p‚tition. Les valeurs de TX et TY n'ont
plus de sens et la g‚n‚ration de codes s'effectue via VX et VY).
9.21. DESACTIVATION DES MANETTES DE JEU
0x1A
D‚sactive la g‚n‚ration d'‚v‚nements manettes de jeu (la
scrutation des manettes peut ˆtre d‚sactiv‚e). Toute entr‚e dans
un mode de fonctionnement manettes de jeu provoque la reprise des
compte-rendus d'‚v‚nements manette de jeu (les modes de
fonctionnement manette sont MODE EVENEMENT MANETTE DE JEU, MODE
DEMANDE MANETTE, SURVEILLANCE MANETTE DE JEU, SURVEILLANCE BOUTON
DE FEU ET MANETTES EN MODE CLAVIER).
9.22. MISE A JOUR DE L'HORLOGE-CALENDRIER
0x1B
AA ann‚e (deux derniers chiffres significatifs)
MM mois
JJ jour
hh heure
mm minute
ss seconde
Toutes les donn‚es concernant la date et l'heure doivent ˆtre
envoy‚es vers le clavier au format BCD (binaire cod‚ d‚cimal).
Tout chiffre qui ne rentre pas dans le format BCD ne sera pas
pris en compte et ne provoquera pas de modification du champ
correspondant de la date ou de l'heure. Cela permet de ne modifier
que quelques-unes des caract‚ristiques de la date ou de l'heure.
9.23. DEMANDE DE LA DATE ET DE L'HEURE
0x1C
Valeurs retourn‚es :
0xFC en-tˆte d'‚v‚nement date et heure
AA ann‚e (2 chiffres inf‚rieurs)
MM mois
JJ jour
hh heure
mm minute
ss seconde
Toutes les donn‚es relatives … la date et l'heure sont
retourn‚es au format BCD (binaire cod‚ d‚cimal).
9.24. CHARGEMENT DE DONNEES EN MEMOIRE
0x20
adr_sup adresse de la m‚moire vive du contr“leur
adr_inf o— charger les donn‚es
nombre nombre d'octets … charger (0 … 128)
{donn‚es}
Cette commande permet au processeur de placer des valeurs
arbitraires dans la m‚moire vive du contr“leur. L'intervalle de
temps s‚parant l'envoi de chaque donn‚e doit ˆtre d'au minimum 20
millisecondes.
9.25. LECTURE DE DONNEES EN MEMOIRE
0x21
adr_sup adresse de la m‚moire du contr“leur …
adr_inf partir de laquelle lire les donn‚es.
Valeurs retourn‚es :
0xF6 en-tˆte d'‚tat
0x20 code d'accŠs m‚moire
donn‚e 6 octets de donn‚es lus en
donn‚e m‚moire … partir de l'adresse
donn‚e envoy‚e en paramŠtre
donn‚e
donn‚e
donn‚e
Cette commande permet au processeur de lire le contenu des
m‚moires du contr“leur. Elle permet de lire aussi bien le contenu
de la m‚moire morte que de la m‚moire vive.
9.26. EXECUTION DE ROUTINE CONTROLEUR
0x22
adr_sup adresse de la routine en m‚moire morte du
adr_inf contr“leur que l'on d‚sire faire ex‚cuter.
Cette commande permet au processeur d'ordonner l'ex‚cution
d'un sous-programme r‚sident dans la m‚moire morte du contr“leur
clavier.
N.D.T.: Les fonctions 0x20 et 0x22 sont d'un usage p‚rilleux car
elles n‚cessitent une bonne connaissance de la topographie m‚moire
du 6301, contr“leur clavier. Des informations sur le contenu de
cette m‚moire et les registres de travail du 6301 peuvent ˆtre
obtenus dans l'ouvrage "Au coeur de l'Atari ST" (cf. bibliographie
en annexe).
9.27. DEMANDES D'ETAT
Les commandes de demande d'‚tat sont constitu‚es de l'octet
de commande de positionnement dans cet ‚tat avec le bit 7 plac‚ …
1 (OU logique avec 0x80). Exemple :
0x88 (ou 0x89 ou 0x8A) demande de mode souris
Valeurs retourn‚es :
0xF6 en-tˆte de r‚ponse d'‚tat
mode 0x08 si RELATIF
0x09 si ABSOLU
0x0A si CLAVIER
param1 0 si mode RELATIF
Xsup si mode ABSOLU
Xdelta si mode CLAVIER
param2 0 si mode RELATIF
Xinf si mode ABSOLU
Ydelta si mode CLAVIER
param3 0 si mode RELATIF
Ysup si mode ABSOLU
0 si mode CLAVIER
param4 0 si mode RELATIF
Yinf si mode ABSOLU
0 si mode CLAVIER
0 bourrage
0
Les commandes de DEMANDE D'ETAT interrogent le clavier sur le
mode courant ou les paramŠtres associ‚s … un mode donn‚. Tous les
compte-rendus d'‚tat sont format‚s dans des blocs de 8 octets. Les
r‚ponses … des demandes d'‚tat sont fournies de telle sorte
qu'elles puissent ˆtre stock‚es (aprŠs r‚ception de l'octet $F6
d'en-tˆte de r‚ponse ‚tat) et renvoy‚es par la suite sous forme de
commandes de positionnement d'‚tat par le processeur afin de
restaurer un ‚tat donn‚. Les octets nuls de remplissage seront
alors trait‚s comme des commandes inop‚rantes par le circuit
clavier.
N.D.T.: Pour traiter les r‚ponses … une demande d'‚tat, il est
n‚cessaire de d‚tourner le vecteur r‚ponse d'‚tat, dont on obtient
l'emplacement par Kbdvbase (Trap 14, fonction $22), en ajoutant $C
… l'adresse de retour de cette fonction (voir bios ‚tendu).
En pla‡ant sa propre routine dans ce vecteur, on re‡oit dans
A0 l'adresse de d‚part du bloc d'octets r‚ponse de la demande
d'‚tat et dans A1 l'adresse de fin plus un de cette r‚ponse.
D'une fa‡on g‚n‚rale, toutes les r‚ponses du clavier passent
par l'un des vecteurs point‚s indirectement par Kbdvbase et
n‚cessitent donc un traitement particulier par des routines
utilisateur.
Les commandes valides de DEMANDE D'ETAT sont les suivantes:
0x87 mode d'action des boutons de la souris
0x88 mode de positionnement de la souris
0x89 (plus pr‚cis‚ment mode de traitement des
0x8A d‚placements de la souris par le circuit clavier)
0x8B seuil de d‚calage de la souris
0x8C ‚chelle de d‚calage de la souris (en ABSOLU)
0x8F demande du type d'origine verticale de la souris
0x90 (renvoie 0x0F si en bas, 0x10 si en haut)
0x92 activit‚ de la souris (r‚ponse : 0x00 si active,
0x12 si inactive)
0x94 demande du mode manette de jeu
0x95
0x99
0x9A activit‚ des manettes de jeu (r‚ponse : 0x00 si
actives, 0x1A si d‚sactiv‚es)
Il est de la responsabilit‚ du programmeur de n'avoir qu'une
r‚ponse … une demande en mˆme temps (autrement dit, il faut
traiter la r‚ponse … une demande avant d'en faire une seconde, les
r‚ponses n'‚tant pas empil‚es).
Les commandes de DEMANDE D'ETAT ne sont pas prises en compte
si le clavier intelligent se trouve en mode SURVEILLANCE MANETTE
DE JEU ou en mode SURVEILLANCE BOUTON DE FEU.
10. Appendice A -- Codes de scrutation clavier
Les codes de scrutation clavier retourn‚ par le clavier ont
‚t‚ choisi afin de simplifier la mise en oeuvre du GEM.
N.D.T.: Le traducteur s'est permis de fournir les codes clavier
correspondant … la matrice de clavier fran‡aise en sus des codes
correspondant … la matrice de clavier anglaise.
Valeur hexa. Clavier anglais Clavier fran‡ais
00 (inutilis‚e) (inutilis‚e)
01 Esc Esc
02 1 1
03 2 2
04 3 3
05 4 4
06 5 5
07 6 6
08 7 7
09 8 8
0A 9 9
0B 0 0
0C - )
0D == -
0E Backspace Backspace
0F Tab Tab
10 Q A
11 W Z
12 E E
13 R R
14 T T
15 Y Y
16 U U
17 I I
18 O O
19 P P
1A [ [
1B ] ]
1C Return Return
1D Control Control
1E A Q
1F S S
20 D D
21 F F
22 G G
23 H H
24 J J
25 K K
26 L L
27 ; M
28 ' —
29 ` `
2A Shift (gauche) Shift (gauche)
2B \ \
2C Z W
2D X X
2E C C
2F V V
30 B B
31 N N
32 M ,
33 , ;
34 . :
35 / =
36 Shift (droit) Shift (droit)
37 (inutilis‚e) (inutilis‚e)
38 Alternate Alternate
39 Barre d'espacement Barre d'espacement
3A CapsLock CapsLock
3B F1 F1
3C F2 F2
3D F3 F3
3E F4 F4
3F F5 F5
40 F6 F6
41 F7 F7
42 F8 F8
43 F9 F9
44 F10 F10
45 (inutilis‚e) (inutilis‚e)
46 (inutilis‚e) (inutilis‚e)
47 Home Home
48 FlŠche vers le haut FlŠche vers le haut
49 (inutilis‚e) (inutilis‚e)
4A Pav‚ num‚rique - Pav‚ num‚rique -
4B FlŠche vers la gauche FlŠche vers la gauche
4C (inutilis‚e) (inutilis‚e)
4D FlŠche vers la droite FlŠche vers la droite
4E Pav‚ num‚rique + Pav‚ num‚rique +
4F (inutilis‚e) (inutilis‚e)
50 FlŠche vers le bas FlŠche vers le bas
51 (inutilis‚e) (inutilis‚e)
52 Insert Insert
53 Delete Delete
54 (inutilis‚e) (inutilis‚e)
55 (inutilis‚e) (inutilis‚e)
56 (inutilis‚e) (inutilis‚e)
57 (inutilis‚e) (inutilis‚e)
58 (inutilis‚e) (inutilis‚e)
59 (inutilis‚e) (inutilis‚e)
5A (inutilis‚e) (inutilis‚e)
5B (inutilis‚e) (inutilis‚e)
5C (inutilis‚e) (inutilis‚e)
5D (inutilis‚e) (inutilis‚e)
5E (inutilis‚e) (inutilis‚e)
5F (inutilis‚e) (inutilis‚e)
60 touche ISO (inutilis‚e) <
61 Undo Undo
62 Help Help
63 Pav‚ num‚rique ( Pav‚ num‚rique (
64 Pav‚ num‚rique ) Pav‚ num‚rique )
65 Pav‚ num‚rique / Pav‚ num‚rique /
66 Pav‚ num‚rique * Pav‚ num‚rique *
67 Pav‚ num‚rique 7 Pav‚ num‚rique 7
68 Pav‚ num‚rique 8 Pav‚ num‚rique 8
69 Pav‚ num‚rique 9 Pav‚ num‚rique 9
6A Pav‚ num‚rique 4 Pav‚ num‚rique 4
6B Pav‚ num‚rique 5 Pav‚ num‚rique 5
6C Pav‚ num‚rique 6 Pav‚ num‚rique 6
6D Pav‚ num‚rique 1 Pav‚ num‚rique 1
6E Pav‚ num‚rique 2 Pav‚ num‚rique 2
6F Pav‚ num‚rique 3 Pav‚ num‚rique 3
70 Pav‚ num‚rique 0 Pav‚ num‚rique 0
71 Pav‚ num‚rique . Pav‚ num‚rique .
72 Pav‚ num‚rique Enter Pav‚ num‚rique Enter
N.D.T. : Rappelons que les codes hexad‚cimaux 0x74 et 0x75 sont
utilis‚s par le contr“leur clavier pour la simulation des appuis
de boutons de feu des manettes de jeu.
Back to Programming