Title: Programaci¢n del TFPCX

From: EA7CVR@EA7PW.EAJ.ESP.EU
To  : RPJUEG@EA

{GPBBS 0.99 / Mensaje #5 de EA7CVR (Luis Ram¢n) a las 16:08 del 15-Ene-96}

                          ÚÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
                          ³³ Interrupciones TFPC ³³ (v.2.0)
                          ÀÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÙ
Hola a todos:
Despu‚s de mucho indagar en el manual del TFPCX (en perfecto alem n) he
conseguido toda la informaci¢n necesaria para trabajar con estos programas:

¨ QUE SON LOS PROGRAMAS 'TFPC' ?
Los programas residentes TFPCR y TFPCX son unas utilidades muy interesantes,
que tienen como misi¢n emular a una TNC2 con EPROM TheFirmware (compatible con
WA8DED). Mientras el TFPCR emula dicha EPROM con TNCs en modo KISS, el TFPCX
se acomoda a los m¢dem HDLC (como pueden ser el BAYCOM, el DIGICOM, etc...).

Para comunicarse con estos programas se utilizan interrupciones por software.
El TFPCR se sit£a normalmente en la n£mero $FE (254 en decimal), mientras el
TFPCX lo hace en la $FD (253 decimal), aunque son configurables y pueden
aparecer en cualquier otra interrupci¢n.

Recientemente ha aparecido el TFX (para m¢dems BAYCOM) que se comporta igual
que el TFPCR (tanto en servicios ofrecidos como en interrupci¢n por defecto).
Tambi‚n existe el TFKISS (para TNCs en modo KISS) que incluye muchos servi-
cios que eran exclusivos del TFPCX.

Tambi‚n decir que la versi¢n 2.10 del TFPCX ya soporta TNCs en modo KISS...

DETECCION DE UN PROGRAMA 'TFPC'
La detecci¢n es muy sencilla. Los programas TFPC pueden situarse entre las
interrupciones $30 (48) y $FF (255), pero... ¨ c¢mo sabemos en qu‚
interrupci¢n est  instalado ?. La respuesta es la siguiente: Todos los
programas TFPC tienen la firma N5NX en el offset 3 de la direcci¢n marcada
por su vector de interrupci¢n.
No pongas esa cara de no enterarte de nada... es muy f cil....

UN EJEMPLO:
Imaginemos que la interrupci¢n $FE (254) apunta a la direcci¢n $07B3:$0814,
debemos mirar los 4 caracteres que hay entre $07B3:$0817 y $07B3:$081B. Si
esos caracteres coinciden con N5NX, ­ ya hemos localizado al TFPC !

Este proceso tendr¡a que repetirse desde la interrupci¢n $30 (48) a la $FF
(255). Si no se encuentra ning£n TFPC en ese rango, podemos decir que no
se encuentra el TFPC...

Para asegurarnos podemos llamar a la interrupci¢n con AX=0000. Si devuelve
AX=$FFFF entonces es segura la presencia de un programa TFPC.

SERVICIOS OFRECIDOS POR LA INTERRUPCION
Esta es la parte m s interesante. Son 6 servicios, de los cu les 2 son
exclusivos del TFPCX/TFKISS:
-------------------------------------------------------------
AH = 0    Comprueba si est  instalado el TFPC

Devuelve: AX = $FFFF si est  instalado
-------------------------------------------------------------
AH = 1    Comprueba si hay alg£n car cter disponible para ser
          recibido desde el TFPC.

Devuelve: AX = 0    No hay ning£n car cter preparado
          AX = 1    Hay al menos un car cter listo
-------------------------------------------------------------
AH = 2    Recibe un car cter

Devuelve: AL = C¢digo ASCII del car cter recibido
-------------------------------------------------------------
AH = 3    Env¡a un car cter al TFPC

Par metro:AL = C¢digo ASCII del car cter a enviar
-------------------------------------------------------------
SOLO TFKISS 3.0 / TFPCX 2.00 y superior
AH = FB   Informaci¢n de los puertos y canales disponibles

Devuelve: AL = N£mero de puertos
          AH = N£mero de canales
-------------------------------------------------------------
SOLO TFKISS 3.0 / TFPCX 1.10 y superior
AH = FE   Da versi¢n del TFPCX/TFKISS

Devuelve: AH = Versi¢n principal
               En realidad, la versi¢n principal se obtiene del
               resto de la divisi¢n de AH entre 16 (AH mod 16),
               ya que algunos TFPC (por ejemplo el TFKISS) se
               identifican usando los 4 bits superiores (AH div 16).
               Posibles valores de (AH div 16):
               E (14 en decimal): TFKISS
               F (15 en decimal): TFPCR original de DL1MEN
               0 (0 en decimal) : TFPCX Version 2.0 o superior

          AL = Versi¢n secundaria

          Esquem ticamente, la funci¢n devuelve esta informaci¢n:
          AX: Bits: 15 14 13 12    11 10 09 08    07 06 05 04 03 02 01 00
                    Tipo de TFPC   Versi¢n ppal.  Subversion (0..99 decimal)

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

Esto es todo respecto a la forma de comunicaci¢n entre el TFPCX y el
ordenador. La forma de usar el TFPCX es igual que la de una TNC2 con EPROM
WA8DED, aunque eso ser  tema de otro mensaje.

Espero que os sea de utilidad.

73's de Luis Ram¢n.... Packet : EA7CVR @EA7PW.EAJ.ESP.EU
                       FidoNet: Luis Ramon Lopez @ 2:345/302.16