Revisión del 05:45 27 nov 2008

Ultima hora

Gracias a un par de compañeras vuestras se ha localizado un DosBox con la posibilidad de usar el puerto paralelo.
Por ahora las pocas pruebas que hemos hecho han sido satisfactorias por lo que os puede venir bien para poder trabajar en casa.
Yo le he probado con el programa PARAL.ASM y con el programa de prueba TESTUWIRE.EXE y en ambos casos ha funcionado.
Os dejo el programa en la zona de descargas, dentro del archivo hay un "Readme" con instrucciones.

Listados clase

Listado 1a
Listado 2a

Bugs

• En el driver hay un error. Solo devuelve 128 posiciones de memoria. En la zona de descargas podeis encontrar una version que corrige el error (EEPROM.COM) y pronto estará en la web. (Por cierto el uninstall tampoco funciona por ahora)

Práctica 2

Página Oficial

Pasos para realizar la práctica

• Empezar por la estructura básica del driver. Que se instale y que responda a la función STATUS, EESISE.
• Añadir la comunicación con el puerto paralelo. Añadir al driver el poder apagar y encender el LED. (Usar un programa aparte o la propia práctica 1 para activarlo y/o desactivarlo).
• Leerse la documentación de la memoria EE_WIRE (activación, función de inicio, lectura, escritura... cronogramas)
• Implementar la lectura / escritura en la memoria. Usar temporización pasiva (un bucle)
• Estudiarse el RTC
• Añadir la temporización con el RTC y quitar la pasiva.

La práctica se probará usando el programa realizado en la prática 1, por eso todos aquellos a los que les falte alguna funcionalidad la tendrán que añadir

Programas de ayuda

• Esqueleto de driver (instalar, parser,...). A completar con las funciones de acceso a la memoria por parte del alumno
• RTC (ejemplo del RTC). Usarlo para integrarlo en el driver, para ello completar el código con la teoría del RTC.
• Paral (ejemplo de uso del puerto paralelo). Usar el acceso para realizar el driver pedido.
• DosBox con acceso al puerto paralelo.

Los programas anteriores se encuentran en la zona de descargas de esta página.

Práctica 1

Ayudas

• En la zona de descargas teneis un programa que se llama TEST.ASM que permite probar el driver. Para ello crea un fichero que se llama MEM2.BIN, lo rellena de datos y luego comprueba que se leen bien. Además los representa en ASCII en la pantalla.
• Os he dejado el archivo libreria.zip que contiene un ejemplo de libreria y makefile avanzado.

Resumen Objetivos Entrega

• Realización del programa Lector/Editor Hexadecimal
• Creación de librerias (teclado)
• Uso de los servicios de la BIOS y del DOS
• Detectar la correcta instalación de un driver en memoria
• Compilación usando Makefiles

Consejos Práctica 1

Pasos para la programación del Editor

1. Hacer la estructura del programa partiendo en uno de los ejemplos de la práctica 0
2. Comprobar que existe el driver: Tabla INT, 0CAFEH y STATUS
3. Leer toda la memoria y dejar los valores en un ARRAY en el programa principal.
4. Pinta esos datos en pantalla de forma ordenada: Necesaria función conversion de binario a representación hexadecimal en ASCII
5. Funciones de teclado (Por ejemplo usando Libreria) e implementación del cursor.
6. Meter inteligencia al cursor, de forma que sepa en que byte está en cada momento.
7. Meter funcionalidad de edición de valores.
8. Añadir resto de funciones. Scroll, CTRL-G, ...

Conviene usar Makefile desde el principio.

Librerías

Una librería mantiene una estructura muy parecida a la de un programa, pero con algunas características especiales:
1. Es un archivo fuente .ASM que generalmente sólo lleva la definición del segmento de código, ya que comparte pila y segmento de datos con el programa principal que llama a las funciones de la misma.
2. Las funciones que queramos exportar o hacer visibles se declaran como PUBLIC en el archivo fuente de la librería.
3. Los programas que quieran llamar a esas funciones las tendrán que declarar como EXTERN
4. Una librería se compila con el TASM primero y una vez obtenido el .OBJ se encapsula en un fichero .LIB mediante el comando TLIB.

Veamos un ejemplo de librería (archivo teclado.asm):

;==================================
;=      Ejemplo de libreria       =
;==================================

;DEFINICION DEL SEGMENTO DE CODIGO
TECLADOLIB SEGMENT BYTE PUBLIC 'CODE' ASSUME CS:TECLADOLIB

; Funcion que mira si hay tecla pulsada
; Es equivalente a kbhit();
; devuelve en AL 0 si no hay tecla
; devuelve en AL 1 si hay tecla
IsKey PROC FAR
	MOV  AH,0BH
	MOV  AL,0H
	INT  21H
	RET
IsKey ENDP


; Funcion que devuelve la tecla pulsada en AL
; Accede al buffer del teclado y devuelve la tecla pulsada
; Si se pulsa una tecla extendida se devuelve 0x00, y luego 
; habra que volver a llamar a la funcion para saber cual ha 
; sido la tecla pulsada
ReadKey PROC FAR
	PUSH DX
	MOV  AH,06H
	MOV  DL,0FFH
	INT  21H
	POP  DX
	RET
ReadKey ENDP


; Funcion que espera a que se pulse una tecla
; momento en la que la devuelve en AL
GetKey PROC FAR
	CALL IsKey
	CMP  AL,0
	JE   GetKey

	CALL ReadKey
	RET
GetKey ENDP

TECLADOLIB ENDS
		PUBLIC  GetKey
		END

Vemos que se trata de un archivo teclado.asm que tiene una declaración de un solo segmento (el de código). En ese segmento lo único que encontramos son procedimientos (funciones) y no hay programa principal, ni procedimiento principal. En la etiqueta END no se indica por donde se empieza a ejecutar ese código, de hecho, nunca se ejecutará ya que no llegará a ser un programa .EXE.
Podemos poner todos los procemientos que queramos o que sean necesarios, en el ejemplo hay tres:

• IsKey
• ReadKey
• GetKey

Pero de los tres sólo será visible desde el exterior el GetKey dado que es el único que se ha hecho público con la directiva PUBLIC. Por lo tanto, los procedimientos que queramos que sean públicos tendrán que estar listados abajo con la etiqueta PUBLIC delante.

Lo siguiente es ver como se compila un fichero fuente de librería. Los pasos son los siguientes:

• tasm /zi teclado.asm para generar el fichero teclado.obj (suponiendo que el archivo que contiene la libreria se llame teclado.asm)
• tlib teclado.lib -+teclado.obj para generar el fichero teclado.lib que es la librería encapsulada. El -+ indica re-emplazo, es decir, si dentro del archivo teclado.lib ya existe una función GetKey procede a su reemplazo por la nueva versión. En caso de que no exista la añade directamente.
• Una vez que se tiene el archivo teclado.lib se podrá compilar cualquier programa que use funciones de la librería con el comando: tlink /v program.obj teclado.lib

Veamos ahora un programa que usa esa librería (archivo program.asm)

;/---------------------------------------------/
;/ Practicas de ETC-II                    UAM  /
;/ Andres Prieto-Moreno           21-oct-2008  /
;/ ETC-II                                      /
;/                                             /
;/---------------------------------------------/

extrn GetKey:far
	
; SEGMENTO DE DATOS
datosg SEGMENT
	TEXTO	DB 	"Pulse una tecla para salir",13,10,'$'
datosg ENDS

; SEGMENTO DE PILA

stacksg SEGMENT STACK "STACK"
	DB 400H DUP (0)
stacksg ends


; CODIGO DEL PROGRAMA

codesg  SEGMENT
    assume  cs:codesg, DS:datosg, SS:stacksg


;=======================
;= Programa princpal   =                   
;=======================

program  proc far
	; Configuracion inicial de los registros
	MOV  AX,datosg
	MOV  DS,AX

	MOV  AX,stacksg
	MOV  SS,AX
	
	MOV  SP,0400H;

	; imprime mensaje
	MOV DX, OFFSET TEXTO	
	MOV AH,9
	INT 21H
	
        ; espera a que se pulse una tecla
	CALL GetKey


fin:    ; devuelve el control al DOS
    MOV  AX, 4C00H
    INT  21H

program  endp

codesg  ends
	end     program
		

Lo importante es que este código usa la función GetKey que pertenece a una librería externa. Por eso al principio del todo se ha indicado con la directiva extrn GetKey:far. Por lo demás el programa es como cualquier otro.
La forma de compilar, considerando que la librería ya exista, sería:
>tasm /zi program.asm
>tlink /v program.obj teclado.lib
En caso de que no exista la libreria habría que crearla con los pasos anteriores. Cualquier cambio en el código de la librería nos obliga a recompilar la librería y el programa principal. Por eso la utilización de Makefiles nos puede ahorrar mucho tiempo.

Fichero Makefile

La herramienta make nos permite simplicar la compilación de un programa, al permitir definir en un fichero una serie de reglas o pasos, para que a partir de una serie de archivos fuente se obtenga el fichero o ficheros ejecutables del proyecto.
Dichas reglas se escribirán en un fichero llamado Makefile que será llamado por defecto al ejecutar el comando make
Un ejemplo sencillo de Makefile es el siguiente:

test.exe: test.obj
	tlink /v test.obj

test.obj: test.asm
	tasm /zi test.asm


clean:
	del *.obj 
	del test.exe

Se lee de la siguiente forma. Para generar el programa ejecutable test.exe necesitamos el fichero objeto test.obj y para ello se ejecuta el comando tlink /v test.obj.
En caso de que no exista el test.obj se buscará por el fichero la regla para construirlo. En este caso aparece más abajo y se interpreta: Para generar el test.obj se parte del test.asm y crea mediante el comando tasm /zi test.asm.
Por último tenemos una opción para borrar los pasos intermedios de la compilación y el resultado. Esto es útil cuando nos queremos asegurar que el proceso empiece desde el principio y que no use ningún .obj anterior. Se invoca haciendo:
>make clean

Veamos ahora otro ejemplo un poco más avanzado.

# Ejemplo de fichero Makefile avanzado

program.exe: program.obj teclado.lib
  TLINK /V  program.obj teclado.lib

.asm.obj: 
  TASM /ZI $<

.obj.lib:
   TLIB $&.lib -+$<

clean:
    del *.obj
    del *.map
    del *.exe
    del *.lib

Se lee de la misma forma que el anterior, pero ahora considera que hay una librería. Para generar el programa program.exe se necesitan los ficheros program.obj y la librería teclado.lib. El comando para generar el ejecutable es tlink /v program.obj teclado.lib
El cambio viene ahora, en lugar de establecer reglas específicas para cada archivo, ponemos una global .asm.obj: que se traduce: Para generar cualquier ASM se parte de un OBJ y se ejuta el comando: TASM /ZI $< donde $< me indica el nombre del archivo .ASM que estamos intentanto pasar a .OBJ
La siguiente línea es igual, nos viene a decir que para generar una librería se parte del .obj y que el comando produce un archivo .lib con el nombre que estemos tratando en ese momento.

Lo bueno de este Makefile, es que al estar parametrizado, con definir las dependencias del programa principal nos bastará, ya que la herramienta Make sabrá como generar cada una de ellas y sin haber necesitado especificarlas.

Descarga de archivos

DosBox con acceso al puerto paralelo

• DosBox.zip archivo ZIP que contiene el DosBox/paralelo
  

Programas apoyo práctica 1

• eeprom.com archivo ZIP que contiene el nuevo driver
  
• Test.asm Comprobación de driver y funciones de conversión a HEX-ASCII
  
• Makefile.simple makefile simple
  
• Makefile.avanzado makefile avanzado
  
• libreria.zip Ejemplo creación y uso de librerías
  
• Teclado.asm Fuentes de libreria con funciones del teclado
  

Programas apoyo práctica 2

• DRVMIO.ASM Esqueleto de driver para la INT61H
  
• Makefile Ejemplo para compilar un programa .COM con depuración.
• Rtc Ejemplo de programa que configura y usa el RTC.
• Paralelo Hace parpadear el LED de la mochila hardware (bit D3)

Enlaces

• Web Oficial de la asignatura
• Documentación de otros años
• Universo digital del PC