please dont rip this site
    
    
    
    
    
    
                  +-----------------------------------------+
                  |                                         |
                  |  *************************************  |
                  |  * The IBM-PC COMMUNICATIONS library *  |
                  |  *************************************  |
                  |                                         |
                  +-----------------------------------------+
    
    
    
    
    
                     An interrupt driven serial I/O lobrary
                        for Stand-Alone 8086 applicatons
                                 using MICRO-C.
    
    
    
    
    
                       Copyright 1990-2000 Dave Dunfield
                              All rights reserved.
    DK86 COMMUNICATIONS LIBRARY                                      Page: 1


    1. IBM-PC COMMUNICATIONS Library
    
          The  MICRO-C  WINDOWING  LIBRARY  is  a  set  of  functions  which
       implement serial I/O with an 8250 type UART device,  such as is  used
       on most PC serial cards.
    
          The routines support  interrupt  driven  reception,  and  XON/XOFF
       software flow control,  as well as setting and monitoring the  RS-232
       control signals.
    
          To install  these  function  into  the  8086  library,  place  the
       COMM.ASM and COMM.H files in the library subdirectory  (usually  \MC\LIB86),  and
       issue the following commands:
    
                    slib i=tiny  a=comm
                    slib i=small a=comm
    
       1.1 Function Definitions
    
             The  following  functions   are   available   in   the   IBM-PC
          communications library:
    CCLOSE                                                           CCLOSE
    
    
    
    PROTOTYPE:
    
        Cclose()
    
    
    ARGUMENTS:
    
        None
    
    
    RETURN VALUE:
    
        None
    
    
    DESCRIPTION:
    
             This function closes the communications port previously  opened
          using "Copen". The system interrupt vectors and all other hooks to
          the comm port are restored.
    
             This function must be called before any program  using  "Copen"
          terminates,  otherwise the communications port will be left in  an
          indeterminate state.  If  this  is  not  done,  there  will  be  a
          possibility of system crash if an interrupt is received  from  the
          port after the program has terminated.
    
    
    EXAMPLES:
    
        Cclose();       /* Close comm port */
        exit(0);        /* And terminate */
    CGETC                                                             CGETC
    
    
    
    PROTOTYPE:
    
        int Cgetc()
    
    
    ARGUMENTS:
    
        None
    
    
    RETURN VALUE:
    
        Character read from the communications port
    
    
    DESCRIPTION:
    
             This function reads a single character from the  communications
          port previously opened with "Copen". If no character is available,
          "Cgetc" will wait for one.
    
    
    EXAMPLES:
    
        /* Get a string from the comm port */
        while((c = cgetc()) != '\r')
            *ptr++ = c;
        *ptr = 0;
    COPEN                                                             COPEN
    
    
    
    PROTOTYPE:
    
        int Copen(int port, int speed, int mode, int modem)
    
    
    ARGUMENTS:
    
        port    - Comm port to use (1, 2, 3 or 4)
        speed   - Baudrate divisor to set
        mode    - Communications parameters to set
        modem   - Modem control lines to set
    
    RETURN VALUE:
    
        0       - Successful open
        !0      - Requested comm port is not available
    
    
    DESCRIPTION:
    
             The "Copen"  function opens a serial communications port on the
          IBM PC for  access.  An  independant  interrupt  handler  and  I/O
          drivers  are  installed,  which  allow  high  speed  full   duplex
          operation of the serial port with optional XON/XOFF  flow  control
          of both receive and transmit streams.
    
             Only one serial port may be accessed  at  a  time  using  these
          functions,  If  "Copen"  is  called  more  than  once,   it   will
          automatically close the last port before opening the new one.
    
             The meaning of the "speed",  "mode",  and "modem" parameters if
          documented in the "comm.h" header file.
    
             An external "char" variable "Cflags"  may be accessed to enable
          or disable transparency of the serial channel.  When "transparent"
          is selected,  XON/XOFF flow control is disabled,  and all data  is
          sent and received with no changes.  When operating in  this  mode,
          you must insure that "Cgetc"  is called frequently enough that the
          256 byte internal receive buffer will not overflow.
    
             Since  "Cflags"  is used by the interrupt handler,  you  should
          disable and enable interrupts around any accesses to it.
    
    
    
    EXAMPLES:
    
        #include comm.h     /* Get comm port defintions */
    
        extern char Cflags;
    
        /*
         * Program to read & echo characters on the serial port
         * in transparent mode. (Until ESCAPE char is received)
         */
        main()
        {
            char c;
    
            if(Copen(1, _2400, PAR_NO|DATA_8|STOP_1, SET_RTS|SET_DTR))
                abort("Cannot access COM1");
    
            disable();                  /* Disable interrupts */
            Cflags |= TRANSPARENT;      /* Set transparency */
            enable();                   /* Re-enable interrupts */
    
            while((c = Cgetc()) != 0x1B)    /* Do until ESCAPE */
                Cputc(c);
    
            Cclose();                   /* Close the serial port */
        }
    CPUTC                                                             CPUTC
    
    
    
    PROTOTYPE:
    
        Cputc(char c)
    
    
    ARGUMENTS:
    
        c       - Character to write to communciation port
    
    
    RETURN VALUE:
    
        None
    
    
    DESCRIPTION:
    
             The  "Cputc"  function  writes  the  given  character  to   the
          communcinations port previously opened by "Copen".
    
    
    EXAMPLES:
    
        while(*ptr)         /* Write a string to comm port */
            Cputc(*ptr++);
    CSIGNALS                                                       CSIGNALS
    
    
    
    PROTOTYPE:
    
        int Csignals()
    
    
    ARGUMENTS:
    
        None
    
    
    RETURN VALUE:
    
        The modem input signals read from the open comm port
    
    
    DESCRIPTION:
    
             This function reads the modem input signals (DSR,  CD,  RI etc)
          from the serial communication port previously opened  by  "Copen",
          and returns them as an integer value.
    
             The meaning of the individual bits in  the  value  returned  by
          "Csignals" is documented in the "comm.h" header file.
    
    
    EXAMPLES:
    
        if(!(Csignals() & DSR)) {
            Cclose();
            abort("Modem not ready"); }
    CTESTC                                                           CTESTC
    
    
    
    PROTOTYPE:
    
        int Ctestc()
    
    
    ARGUMENTS:
    
        None
    
    
    RETURN VALUE:
    
        0-255   - Character read from comm port
        -1      - No character available
    
    
    DESCRIPTION:
    
             This function tests for a  character  from  the  communications
          port previously opened with "Copen", and returns that character if
          one if found. If no character is available, "Ctestc" returns -1.
    
    
    EXAMPLES:
    
        if((c = Ctestc()) == -1) {
            Cclose();
            abort("No character available"); }



                          DK86 COMMUNICATIONS LIBRARY

                               TABLE OF CONTENTS


                                                                         Page

     1. IBM-PC COMMUNICATIONS Library                                       1

        1.1 Function Definitions                                            1

file: /Techref/com/dunfield/ftp/embedpc/comm_doc.htm, 8KB, , updated: 2000/5/5 11:00, local time: 2024/10/13 00:25,
TOP NEW HELP FIND: 
35.171.164.77:LOG IN
©2024 PLEASE DON'T RIP! THIS SITE CLOSES OCT 28, 2024 SO LONG AND THANKS FOR ALL THE FISH!

 ©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?
Please DO link to this page! Digg it! / MAKE!

<A HREF="http://piclist.com/techref/com/dunfield/ftp/embedpc/comm_doc.htm"> The IBM-PC COMMUNICATIONS library</A>

After you find an appropriate page, you are invited to your to this massmind site! (posts will be visible only to you before review) Just type a nice message (short messages are blocked as spam) in the box and press the Post button. (HTML welcomed, but not the <A tag: Instead, use the link box to link to another page. A tutorial is available Members can login to post directly, become page editors, and be credited for their posts.


Link? Put it here: 
if you want a response, please enter your email address: 
Attn spammers: All posts are reviewed before being made visible to anyone other than the poster.
Did you find what you needed?

  PICList 2024 contributors:
o List host: MIT, Site host massmind.org, Top posters @none found
- Page Editors: James Newton, David Cary, and YOU!
* Roman Black of Black Robotics donates from sales of Linistep stepper controller kits.
* Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters.
* Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated!
* Contributors: Richard Seriani, Sr.
 

Welcome to piclist.com!

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

  .