P9PROGRAMACIÓN 'MADE IN AMIGA'
    LOS 'DEVICES' o DISPOSITIVOS
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

              por DÐ.P8



P>1.- INTRODUCCIÓN
    ############P8

  A  la  hora de programar cualquier
ordenador  Amiga,  los programadores
novatos nos encontramos con términos
tan   "extraños"   como   biblioteca
('library'),  recurso  ('resource'),
dispositivo  ('device'), y, gestor o
manejador  ('handler').    En  estas
líneas  veremos en una primera apro-
ximación  los  dispositivos o 'devi-
ces'  que  nos  permiten  acceder al
hardware  y al resto del software de
nuestro equipo de una manera siempre
muy  similar  y que además funcionan
como  tareas  ('tasks')  separadas o
relativamente    independientes   de
nuestro programa.



P>2.- DISPOSITIVOS DISPONIBLES
    ########################P8

  Conforme  han  surgido  diferentes
versiones   de   KickStart   se  han
añadido  innovaciones, pero  me temo
que  no tengo documentación sobre la
versión 2.04/3.X a la que recurrir y
sólo puedo hacer referencia a que se
ha  añadido  el  CardDisk  para  los
modelos  con conector PCMCIA, o sea,
A600/A1200.   Por  lo tanto me limi-
taré  a disertar aburridamente sobre
lo  que sí tengo documentado, o sea,
el KickStart 2.0, que dispone de los
siguientes dispositivos:

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

 -P<AudioP8
  Canales de sonido

 -P<ClipBoardP8
  Manejo del dispositivo 'Libreta de
 apuntes  o  recortes'  para cortar,
 copiar y pegar entre aplicaciones o
 incluso  dentro  de  un  mismo pro-
 grama.   Los  datos  ahora FORZOSA-
 MENTE  deben  estar  en formato IFF
 (¡como siempre ha debido de ser!).
 -P<ConsoleP8
  Consola (?).

 -P<GamePortP8
  Puertos  de  juegos (ratón, raque-
 tas,  lapiz óptico, bola  o 'track-
 ball',  palanca de control o 'joy',
 etc).

 -P<InputP8
  Interface  de  gestión  global  de
 entradas (teclado y los puertos  de
 juegos).

 -P<KeyBoardP8
  Teclado.

 -P<NarratorP8
  Sintetizador  de  voz (por cierto,
 ¿porqué  ningún  juego  COMERCIAL o
 demo  lo  usa?,  ¿quizás  es porque
 suena  mejor el sonido digitalizado
 o quizás  por no estar implementado
 en ROM?).

 -P<ParallelP8
  Puerto paralelo CENTRONICS

 -P<PrinterP8
  Impresora

 -P<SCSIP8
  Interface SCSI (e ¡¿IDE?!)

 -P<SerialP8
  Puerto serie RS232C

 -P<TimerP8
  Temporizador/cronómetro

 -P<TrackDiskP8
  Unidades de discos flexibles.

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


P>3.- RITUAL BÁSICO
    #############P8

  Aunque   cada   dispositivo  tiene
ciertas   'características'  en   la
gestión  que  lo  diferencian de los
demás,  siempre  se  sigue  el mismo
procedimiento   inicial  para  poder
disponer de él:

1.-  Se crea un  puerto con  la fun-
    ción  P<CreateMsgPort()P8, salvo que
    quiera  que su programa o rutina
    trabaje   también   en   equipos
    pre2.0  en cuyo caso tendrá  que
    usar  en su lugar la instrucción
    CreatePort().

2.-  Se  crea  una  'petición E/S°¹'
    (conocido  también como 'request
    I/O') por ejemplo con la función
    P<CreateIORequest()P8 o, para compa-
    tibilidad con KickStart 1.X, con
    CreateExtIO().

3.-  Se 'abre'  el  dispositivo  con
    P<OpenDevice()P8,  comprobando si el
    sistema nos ha podido complacer.

4.- SE USA.

5.-  Cuando hayamos  acabado, usando
    P<CheckIO()P8  se  comprueba P>siP8 que-
    da  alguna  petición   E/S  pen-
    diente, anulándola con P<AbortIO()P8
    y obtenido el visto bueno, libe-
    ramos con  P<CloseDevice()P8 el dis-
    positivo.

6.- Se  borra  la  petición E/S  con
    P<DeleteIORequest()P8,  o  si usamos
    CreateExtIO()  inicialmente para
    crearlo,  empleamos  ahora  para
    borrarlo DeleteExtIO().

7.- Se  borra el puerto  de mensajes
    con P<DeleteMsgPort()P8, o si usamos
    para  crearlo  CreatePort()  con
    DeletePort().





P>4.- EJEMPLO EN 'C'
    ##############P8

  Como  ejemplo  vamos  a acceder al
dispositivo   de  síntesis  de  voz,
usando  alguna de las nuevas presta-
ciones  del  KickStart  2.0 (que por
cierto  mejoran notablemente la pro-
nunciación), pero escribiendo direc-
tamente  los  fonemas  a pronunciar,
por lo que NO emplearemos la función
Translate()  que  proporciona la bi-
blioteca 'translator.library'.

B<P0------------------------------------
  Por problemas de legilibilidad del
listado,  éste  se  encuentra  en un
fichero llamado 'EjemploVoz.c' junto
con el ejecutable obtenido.         
------------------------------------B0P8

  He  de señalar, tal como se indica
en el listado, que para sacarle todo
el partido a este dispositivo u otro
cualquiera,  consulte  el  manual de
referencia  de  C= y los ficheros .h
(vea  su  compilador  de  C), en los
cuales se  definen  constantes nece-
sarias y los campos que componen ca-
da estructura.



P>5.- USO: FUNCIONES°²
    ##############P8

  Disponiendo  del  dispositivo para
su  empleo, nos encontramos  con las
siguientes  funciones  Exec  para su
manejo:
  -P<DoIO()P8:   usa  como  argumento un
puntero a una estructura IORequest y
bloquea  nuestra  aplicación o tarea
hasta que se haya ejecutado (función
síncrona).   Gracias a ello no tene-
mos  que supervisar el proceso, pero
si se colgase o  bloquease, lo mismo
le pasaría a nuestra aplicación.

  -P<SendIO()P8:  usa el mismo  argumen-
to,  pero  NO  bloquea nuestra apli-
cación  pues  se  limita a iniciarla
devolviéndonos   inmediatamente   el
control  y  siendo tarea nuestra su-
pervisarla  (función  asíncrona) con
CheckIO(),   AbortIO()  y  WaitIO().
Hay que señalar que algunos disposi-
tivos   'passsan'  olimpicamente  de
SendIO()  y  no devuelven el control
hasta terminar.
  -P<BeginIO()P8:  se usa para controlar
la bandera ('flag') "quick I/O".  Si
se   activa   antes   de  enviar  la
petición  se solicita al dispositivo
que  ataje para acabar antes.  Si la
petición   puede   terminarse  inme-
diatamente  la  bandera  'IO  quick'
sigue activada, en caso contrario se
desactivaría.   No se puede usar con
SendIO(), pero sí con DoIO().

  -P<AbortIO()P8:   aborta  una petición
E/S tanto si se está ejecutando como
si  está  en la cola de peticiones a
la  espera  de  ser  procesada.  Usa
como argumento el mismo que DoIO().

  -P<WaitIO()P8:  espera a que una peti-
ción E/S termine, utilizando el mis-
mo argumento que DoIO().  Se utiliza
en  combinación con la función ante-
rior.

  Aquí tenemos un ejemplo de la com-
binación  de estas últimas funciones
para cancelar peticiones  pendientes
antes de cerrar el dispositivo:

P; [...]
if(!(CheckIO(a))) AbortIO(a);
WaitIO(a);
CloseDevice(struct IORequest *)a);
 [...]P8

 donde P;aP8  es la petición E/S enviada
al  dispositivo que no sabemos si ha
sido  terminada o no.   P<Recuerde que
sólo se puede abortar peticiones que
se hayan enviado al dispositivoP8.

P>6.- USO: COMANDOS
    #############P8

  Los   comandos  Exec  generalmente
soportados por todos  los dispositi-
vos son:

  P<CMD_CLEAR, CMD_FLUSH, CMD_INVALID,
  CMD_READ,  CMD_RESET, CMD_START,
  CMD_STOP,  CMD_WRITE, CMD_UPDATE.P8

  Su  significado  y  empleo variará
según  el dispositivo que quiera ma-
nejar,  además  de  que  cada dispo-
sitivo P<puedeP8 reconocer mandatos adi-
cionales.



             P=THE END / KONIEK / FINEP8

NOTAS

°1  Por si  hay algún  despitado por
ahí   E/S  significa  Entrada/Salida
(Input/Output).

°²  Mientras  las  funciones usen la
'petición E/S'  (DoIO, SendIO, ...),
ésta no se puede modificar. Para mo-
dificarla cree otra petición o abor-
te la actual:  ello  dependerá de lo
que quiera conseguir.




   P9por D. Domínguez para FANZINEP8
            (1/7-NOV-94)








          P<Amiga ... único.P8







Para    cualquier   corrección   del
artículo,   nuevos   ejemplos  o  un
desarrollo    más    profundo    ...
P;escribid un artículo para FANZINEP8.