First commit 20/04/1996

This commit is contained in:
2021-09-08 21:36:37 +02:00
commit 8c5bf38666
8 changed files with 743 additions and 0 deletions

384
SOFT_DOC.TXT Normal file
View File

@ -0,0 +1,384 @@
8i8o Documentaci<63>n
del Software
Indice
1 <20> Que software incluye el kit ?
2 Descripci<63>n de comandos.
3 Primeros pasos.
4 Creaci<63>n de un programa ejemplo DEMO.C
5 Preguntas y Respuestas.
6 Puntos de consulta directa.
NOTA:
Todas las referencias que se hagan aqui a la programaci<63>n
seran basadas en el lenguaje C, ya que para otros lenguajes
las librerias a utilizar seran las mismas, asi como los
nombre y operaciones internas de las funciones.
-------------------------------------------------------------------------------
<20> Que software incluye el kit ?
Disco 1: [CONTENIDO]
soft_doc.txt Documentaci<63>n del software ( texto MS-DOS ).
hard_doc.txt Documentaci<63>n del hardware ( texto MS-DOS ).
softhard.hlp D. Software y Hardware ( Formato WinHELP ).
InfoMund.gif Imagen del logotipo de InfoMundo
8i8o_pb .gif Imagen del circuito prototipo 8i8o_pb
conexion.txt Ideas de conexiones frecuentes.
catalogo.txt Lista de productos ofrecidos por InfoMundo.
lib_tc\prn_cnt?.lib Librerias en C, para Tiny, Medium, Compact, Large y Huge .
prn_cnt .h Cabeceras para las librerias.
demo .c Demo completo de una utilizaci<63>n global.
demo .exe Programa demo.c compilado
kit .c Programa ejemplo.
lib_cp\prn_cnt .lib Librerias para Clipper.
prn_cnt .h Cabeceras de las librerias.
io .prj Fuente en clipper ( para escribir y leer ).
lib_vb\prn_cnt .vbx Librerias en Visual Basic ( ver 3.0 >> ).
puertos .dll .DLL para el control de los puertos en VB.
control .bas Demostraci<63>n de las librerias para VB.
infomund\infomund.hlp Archivo en formato winHELP, que habla de IM
-------------------------------------------------------------------------------
Descripci<63>n de comandos.
<EFBFBD>> Init_all <20>> Register
<EFBFBD>> Reset_all
<EFBFBD>> Lee_Salidas <20>> Lee_Salida
<EFBFBD>> Escribe_Salidas <20>> Escribe_Salida
<EFBFBD>> Lee_Entradas <20>> Lee_Entrada
/**************************************************************************\
| |
| Esta rutina debe ser llamada al iniciar el programa que use las librerias. |
| |
| Es la encargada de poner a cero todas la salidas, al principio y al salir. |
| |
| |
| Parametros de Entrada: ( ninguno ) |
| Parametros de Salida: |
| OK Todo ha ido bien. |
| ERROR_EN_ATEXIT Error registrando funci<63>n |
| FUNCION_YA_REGISTRADA No es la 1<> vez |
| |
\**************************************************************************/
<EFBFBD>> int Init_all(void);
/**************************************************************************\
| |
| WARNING: |
| El uso de la siguiente funci<63>n esta indicada solo para usuarios |
| experimentados, se debe usar en lugar de la funci<63>n anterior. |
| |
| Parametros de Entrada: |
| ( LEER/ESCRIBIR ) // L/E los registros del fich|
| ( %s ) // _ero %s |
| |
| Parametros de Salida: |
| 1 Ok! OK |
| -1 Fallo desconocido FALLO_DESCONOCIDO |
| -2 Archivo no existe NO_ARCHIVO |
| -3 Error archivo no valido ARCHIVO_INCORRECTO |
| |
\**************************************************************************/
<EFBFBD>> int Register( char leer_escribir, char *file );
/**************************************************************************\
| |
| Resetea todas las salidas y las pone a cero. |
| |
\**************************************************************************/
<EFBFBD>> void Reset_all(void);
/**************************************************************************\
| |
| Obtiene el estado de las salidas ( On/Off ), de la ampliacion AMPL. |
| |
| Parametros de Entrada: |
| ampl Ampliaci<63>n donde debemos mirar |
| estados Puntero a estructura con los estados |
| |
| Parametros de Salida: |
| char 1Byte con los estados |
| |
| NOTA: si &estados es NULL, solo se devolvera el char de salida. |
\**************************************************************************/
<EFBFBD>> unsigned char Lee_Salidas( char ampl, ESTADOS *estados );
/**************************************************************************\
| |
| Obtiene el estado de una salida ( On/Off ), cualquiera. |
| |
| Parametros de Entrada: |
| salida ( Si 1 ampl. 0 a 7 ) |
| ( Si 10 ampl. 0 a 80 ) |
| |
| Parametros de Salida: |
| char 1Byte con el estado |
| |
\**************************************************************************/
<EFBFBD>> unsigned char Lee_Salida( char salida );
/**************************************************************************\
| |
| Escribe la variable 'estados' ( On/Off ), en la ampliacion AMPL. |
| |
| Parametros de Entrada: |
| ampl Ampliaci<63>n donde debemos mirar |
| estados Puntero a estructura con los estados |
| estadosb Byte con los estados |
| |
| Parametros de Salida: |
| char 1Byte con los estados |
| |
| NOTA: si &estados es NULL, se utilizar<61> el char con los estados. |
\**************************************************************************/
<EFBFBD>> unsigned char Escribe_Salidas( char ampl, ESTADOS *estados, char estadosb );
/**************************************************************************\
| |
| Parametros de Entrada: |
| salida ( Si 1 ampl. 0 a 3 ) |
| ( Si 10 ampl. 0 a 80 ) |
| estado ( ON / OFF ) |
| |
| Parametros de Salida: |
| char 1Byte con el estado |
| |
\**************************************************************************/
<EFBFBD>> unsigned char Escribe_Salida( char salida, char estado );
/**************************************************************************\
| |
| Lee las entradas y la almacena en la variable estados. |
| |
| Parametros de Entrada: |
| ampl Ampliaci<63>n donde debemos mirar |
| estados Puntero a estructura con los estados |
| |
| Parametros de Salida: |
| char 1Byte con los estados |
| |
| NOTA: si &estados es NULL, solo se devolvera el char de salida. |
\**************************************************************************/
<EFBFBD>> unsigned char Lee_Entradas( char ampl, ESTADOS *estados );
/**************************************************************************\
| |
| Lee una entrada cualquiera. |
| |
| Parametros de Entrada: |
| entrada ( Si 1 ampl. 0 a 7 ) |
| ( Si 10 ampl. 0 a 80 ) |
| |
| Parametros de Salida: |
| char 1Byte con el estado |
| |
\**************************************************************************/
<EFBFBD>> unsigned char Lee_Entrada( char entrada );
-------------------------------------------------------------------------------
Primeros pasos.
En esta secci<63>n describiremos los principios b<>sicos para utilizar
nuestro Software.
Junto con el programa tenemos que crear un proyecto en el que se
incluyan nuestro programa y la libreria correspondiente al modelo
de memoria que estemos utilizando.
En primer lugar antes de empezar a realizar operaciones con el 8i8o
deberemos indicar en que puerto se encuentra, cargando la variable
<20>> Lpt_usado = [1:Ltp1, 2:Lpt2, 3:Lpt3]
acto seguido debemos resetear todas las salidas:
<20>> #include "prn_cnt"
<20>> void main( void )
<20>> {
<20>> Lpt_usado = 1;
<20>> reset_all();
<20>> }
la funcion reset_all, puede ser sustituida por 'Register', esta
ultima esta indicada cuando se ha salido voluntariamente de su
programa y quiere guardar en un archivo el estado de las salidas,
de modo que al volver a entrar todo siga igual, sin ninguna
alteraci<63>n. ( Para que al salir del programa no se reseteen las
salidas, basta con no llamar a la funcion reset_all ).
para escribir en el '8i8o' podemos utilizar una de las dos
funciones disponibles:
'Escribe_Salida' o 'Escribe_Salidas' la diferencia
reside en que a la primera le indicamos la salida f<>sica y el
estado ON, OFF. La segunda sirve para poner en el estado que deseemos
la ampliaci<63>n, es decir, seleccionar el estado de los 8 bit's de golpe.
<20>> #include <stdio.h>
<20>> #include "prn_cnt"
<20>> void main( void )
<20>> {
<20>> int salida, estado;
<20>> Lpt_usado = 1;
<20>> reset_all();
<20>> do{
<20>> printf( "\n Introduzca Salida y Estado [1:ON, 0:OFF] " );
<20>> printf( "\n estado > 1 Termina el Programa. " );
<20>> scanf ( "%d %d", &salida, &estado );
<20>> Escribe_Salida( salida, estado );
<20>> }while( estado<=1 );
<20>> }
las funciones destinadas a la lectura se usan de igual forma que
las anteriores para la escritura, existiendo igualmente dos funciones
para leer una salida determinada o leer una ampliaci<63>n de golpe,
se<73>alar que las entras al '8i8o' pueden funcionar directamente como
buses de datos digitales y no solo anal<61>gicos.
<20>> #include <conio.h>
<20>> #include "prn_cnt"
<20>> void main( void )
<20>> {
<20>> unsigned char estados;
<20>> Lpt_usado = 1;
<20>> reset_all();
<20>> cprintf( "\n Pulse una tecla para acabar " );
<20>> cprintf( "\n 1 entrada de datos ON " );
<20>> cprintf( "\n 0 entrada de datos OFF " );
<20>> do{
<20>> gotoxy( 10, 15 );
<20>> estados = Lee_Salidas( 1, NULL );
printf( "\n%d %d %d %d %d %d %d %d", ( estado & 0x80 ) != 0,
( estado & 0x40 ) != 0,
( estado & 0x20 ) != 0,
( estado & 0x10 ) != 0,
( estado & 0x08 ) != 0,
( estado & 0x04 ) != 0,
( estado & 0x02 ) != 0,
( estado & 0x01 ) != 0 );
<20>> }while( !kbhit() );
<20>> }
Como puedes ver, la programaci<63>n de nuestro dispositivo es tan
sencilla como decir donde y que queremos hacer. El limite esta
en tu imaginaci<63>n y conocimientos.
-------------------------------------------------------------------------------
Creaci<63>n de un programa ejemplo DEMO.C
Vea fichero DEMO.C
Puntos importantes:
-Realiza una lectura continua del bus de entrada
-Controla la 1<> ampliaci<63>n del 8i8o
-Al entrar comprueba que no se hubiera entrado
antes, recordando el estado de las salidas, register,
si al salir, todas las salidas estan a cero, se
elimina el archivo register, para que al volver a
entrar se reseteen las salidas.
-------------------------------------------------------------------------------
Preguntas y Respuestas
Bien, de momento ninguno de nuestros clientes nos han planteado ninguna
respuesta, y esperamos que siga siendo asi, ya que eso es se<73>al de la
buena documentaci<63>n incluida y el sencillo manejo del '8i8o'.
De todas formas si tiene alguna pregunta, no dude en realizarnosla.
Aprovecho para realizar unas cuantas:
<20> Que complementos tengo para mi '8i8o' ?
Para saber que complementos, puede adquirir para su '8i8o' solo tiene
que editar el fichero CATALOGO.TXT.
<20> Quien es la asociaci<63>n InfoMundo ?
Abre el fichero infomund.hlp, y enterate de quienes somos, que hacemos,
y por que no, unete a nosotros, colaborando en proyectos y debates.
-------------------------------------------------------------------------------
Puntos de consulta directa.
Puedes dirigirte a nosotros via e-mail:
infomundo@arrakis.es
guill@galileo.fie.us.es
por tel<65>fono:
a los propios Creadores del 8i8o :
Francisco Lopez [hardware] -------> 568 xx xx
Francisco Millan [hardware] -------> 568 xx xx
Jos<6F> David Guill<6C>n [software] -------> 561 xx xx
Josue [software] -------> 568 xx xx
a nuestra BBS:
8 nodos : xX XXx xX
-------------------------------------------------------------------------------
F I N
-------------------------------------------------------------------------------
eof file.