home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 11 / 11.iso / n / n002 / 1.ddi / READ.ME < prev    next >
Encoding:
Text File  |  1991-07-05  |  6.9 KB  |  185 lines
  1. ------------------------------------------------------------------------------
  2. |          Essential Communications Library (ECL) Ver. 4.0                   |
  3. ------------------------------------------------------------------------------
  4.  
  5. To install the product, simply put the ECL disk #1 in the A: drive and type :
  6.  
  7.     A:INSTALL 
  8.  
  9. The installation process is menu driven so it will be self explanatory and 
  10. easy to use.  The install program will not build a directory for you.
  11.  
  12. The contents of the disks are as follows :
  13.  
  14.              DISK 1                        
  15.   ---------------------------------        
  16.   READ.ME - This is it!                    
  17.   INSTALL.EXE - Installation program.      
  18.   PKUNZIP.EXE - Unzipping utility
  19.   ECLSRCC.ZIP - All ECL "C" source code
  20.   XCOMMS.ZIP - XCOMMS.exe zipped
  21.   TECLM.ZIP - TURBO C Bundled Medium Library
  22.  
  23.              DISK 2
  24.   ---------------------------------
  25.   MECLS.ZIP - MicroSoft Bundled Small Library
  26.   MECLSTSR.ZIP - MicroSoft Unbundled Small Library
  27.   MECLL.ZIP - MicroSoft Bundled Large Library
  28.   MECLLTSR.ZIP - MicroSoft Unbundled Large Library
  29.   MECLMTSR.ZIP - MicroSoft Unbundled Medium Library
  30.  
  31.              DISK 3                    
  32.   ---------------------------------    
  33.   TECLS.ZIP - TURBO C Bundled Small Library
  34.   TECLSTSR.ZIP - TURBO C Unbundled Small Library
  35.   TECLL.ZIP - TURBO C Bundled Large Library
  36.   TECLLTSR.ZIP - TURBO C Unbundled Large Library
  37.   TECLMTSR.ZIP - TURBO C Unbundled Medium Library
  38.  
  39.              DISK 4
  40.   ---------------------------------
  41.   DEMOS.ZIP - Demo programs
  42.   ECLHEAD.ZIP - ECL headder files.
  43.   MECLM.ZIP - MicroSoft Bundled Medium Library
  44.   ECLSRCA.ZIP - All ECL *.asm and *.inc source code
  45.  
  46. ------------------------------------------------------------------------------
  47. |                     ECL COMPACT MEMORY MODEL                                |
  48. ------------------------------------------------------------------------------
  49. The Small, Medium and Large Memory Model libraries are included on these
  50. disks.  If you require the Compact memory model, you can download it
  51. form our BBS (201-762-0339; 8 Data,  1 Stop, No Parity) or we can send
  52. it to you via the mail.
  53.  
  54. ------------------------------------------------------------------------------
  55. |                     CORRECTIONS TO THE MANUAL                              |
  56. ------------------------------------------------------------------------------
  57. * ADDED FUNCTIONS :
  58.  
  59.  NAME
  60.          xc_t16550 - Test for existance of NS16550A UART.  The function always
  61.                      disables the FIFO's if they are present.
  62.  SYNOPSIS
  63.              int xc_t16550(
  64.                  int port_number) /* Communications port */
  65.  DESCRIPTION
  66.      Test for existance of NS16550A UART.  The function always disables the 
  67.      UART's FIFOs if they are present.  The function set_16550() can also be
  68.      used to detect the presence of the NS16550A UART.
  69.  
  70.  RETURNS
  71.      0 : NS16550A not present
  72.      1 : NS16550A present
  73.   
  74.  NOTES
  75.      None
  76.   
  77.  EXAMPLE
  78. #include <stdio.h>
  79. #include <stdlib.h>
  80. #include <conio.h>
  81. #include "eclproto.h"
  82. #include "xc.h"
  83.  
  84. void main(int argc, char *argv[])
  85. {
  86.     int i;
  87.     int port;
  88.  
  89.     if (argc != 2) {
  90.         printf("\n16550_t [port]\n");
  91.         return;
  92.     }
  93.     port = atoi(argv[1]);
  94.     xc_entr(8);
  95.     /* if COM3-use share logic, if COM4-use share2 logic */
  96.     if (port==2)  {  /* configure COM2 to look like COM3 */
  97.         setport(0X2F8,1,3,COM3,0);
  98.         printf("\nCOM2 is configured to look like COM3\n-Hit any key\n");
  99.         getch();
  100.     }
  101.     if (port==3)  { /* configure COM2 to look like COM4 */
  102.         setport(0X3F8,1,4,COM1,0);
  103.         setport(0X2F8,1,3,COM4,1);
  104.         printf("\nCOM2 is configured to look like COM4\n-Hit any key\n");
  105.         getch();
  106.     }
  107.  
  108.    i = xc_t16550(port);
  109.     printf("\nstat = %d, %0X\n",i,i);
  110.     xc_exit();
  111. }
  112.  
  113. ------------------------------------------------------------------------------
  114. |          PROGRAMMING CHANGES FROM VERSION 3.0 ECL                          |
  115. ------------------------------------------------------------------------------
  116.   NONE
  117.  
  118. ------------------------------------------------------------------------------
  119. |                               RECOMPILING                                  |
  120. ------------------------------------------------------------------------------
  121.  
  122. If you plan to alter any code, follow the below format for recompilation.
  123.  
  124.             Microsoft Recompilation           Turbo C   Recompilation 
  125.            -------------------------         -------------------------
  126. Small     : cl /c /Zl /Gs file               Small   : tcc -c file             
  127. Medium    : cl /c /Zl /Gs /AM file           Medium  : tcc -c -mm file         
  128. Large     : cl /c /Zl /Gs /AL file           Large   : tcc -c -ml file  
  129. Compact   : cl /c /Zl /Gs /AC file           Compact : tcc -c -mc file  
  130.  
  131. ------------------------------------------------------------------------------
  132. |                     ASSEMBLER MODIFICATIONS                                |
  133. ------------------------------------------------------------------------------
  134.         If you modify the assembler code, you need to know a few
  135.         things.  These are in the manual but the summary version
  136.         is as follows.  
  137.     
  138.         First, the ASM files need an include file called ECLMACRO.INC.
  139.  
  140.         Second, when assembling any module, you must define the
  141.         memory model with a /D switch (/DSMALL or /DLARGE etc. for
  142.         MicroSoft and Turbo.
  143.  
  144.         Third, when assembling XCOMMS, you must also use /D to
  145.         determine wheteher or not you are building a new XCOMMS.EXE
  146.         or XCOMMS.OBJ for the bundled library.  No /D defaults to
  147.         the XCOMMS.EXE and /DBUNDLD will build an XCOMMS.OBJ.
  148.  
  149.         Fourth, always use the /MX switch.
  150.  
  151.         Fifth, to build a new eclsubx.obj:
  152.           for SMALL and COMPACT memory model :
  153.             masm /MX /DNUMBER=digipcxx /DSMALLMODEL eclsubx.asm
  154.           for LARGE and MEDIUM memory model :
  155.             masm /MX /DNUMBER=digipcxx /DLARGEMODEL eclsubx.asm
  156.  
  157. TSR / BUNDLED LIBRARY DIFFERENCES:
  158.         Obviously, most of the libraries are identical in content.
  159.         The differences are as follows:
  160.             The TSR library (Unbundled) contains the following ASM files:
  161.             XC_FASTR.ASM    XC_UPEND.ASM    I86.ASM
  162.             The TSR library (Unbundled) also contains all of the C files 
  163.             except:    XCBUNDLD.C    
  164.  
  165.             The BUNDLED library contains the following ASM files:
  166.             XCOMMS.ASM        XCINTF.ASM       I86.ASM
  167.             XC_FASTR.ASM    XC_UPEND.ASM     ECLSUBX.ASM
  168.             The BUNDLED library also contains all of the C  files except:
  169.                XCTSR.C            
  170.  
  171. Creation of XCOMMS.EXE :
  172.         1. Assemble XCOMMS.ASM, XC_TSR.ASM, and THE_END.ASM
  173.            without the /DBUNDLD option.
  174.             MASM /DSMALL /MX XCOMMS.ASM
  175.             MASM /DSMALL /MX XC_TSR.ASM
  176.             MASM /DSMALL /MX THE_END.ASM
  177.         2. Link XCOMMS.OBJ with XC_TSR.OBJ AND THE_END.OBJ
  178.            to generate XCOMMS.EXE
  179.             LINK XCOMMS+XC_TSR+THE_END;
  180.         3. The warning message "no stack segment" is normal
  181.            and does not indicate a failure in creation of
  182.            XCOMMS.EXE
  183.             
  184. /*************************** read.me end ************************************/
  185.