Copyright (C) Magna Carta Software, Inc. 1990-1991. All Rights Reserved.
01-08-92
C COMMUNICATIONS TOOLKIT
VERSION 1.1
Information in this file supercedes information in the manual in
cases where there is conflict.
CONTENTS
1) HOW TO UNPACK THE SOURCE FILES
2) LIBRARIES INCLUDED
3) CHANGES FROM PRIOR VERSIONS
4) MICROSOFT C v6.0x AND QUICK C v2.5
5) MULTI-PORT BOARD DRIVERS
6) ERRATA
7) PRODUCT HISTORY
8) SYNCHRONOUS COMMUNICATIONS AND Z-80 SIO SUPPORT
9) WATCOM C 7.0
10) PROTECTED MODE VERSION
11) MICROSOFT WINDOWS 3.0 VERSION
1) HOW TO UNPACK THE SOURCE FILES
The files on each disk are packed with a program called LHA.
LHARC is Copyright (C) by Haruyasu Yoshizaki, 1989. The
complete manual for LHA is included in the file LHAMAN.LZH.
To unpack the files, copy them to your hard disk along with LHARC.EXE
and type:
LHA x <archivename>
for example, to unpack the headers, type:
LHA x CCTHDR
In the event that you do not have a hard disk, load a ram disk (such as
VDISK.SYS) and uncompress the files on it. Then copy the files onto a
floppy disk.
2) LIBRARIES INCLUDED
The following libraries are included on the distribution disks, Space
constraints prevent us including more. See below for information on how
to obtain other libraries.
The letter 'x' is a wild card (any letter/digit may substitute)
Compressed Name Uncompressed Names Explanation
--------------- ------------------ -----------
CCTB20.LZH COMB20L.LIB BC++ v2.0x large model library
CCTM51.LZH CCTM51L.LIB MSC5.1 large model library
CCTM60.LZH CCTM60L.LIB MSC6.00A large model library
(compiled with /Oaegiltz /Gr)
CCTP20.LZH CCTP20L.LIB Power C v2.0.x large model library
CCTQ25.LZH CCTQ25L.LIB QC v2.5x large model library
(compiled with /Oaegiltz /Gr)
CCTT20.LZH COMT20L.LIB TC v2.0x large model library
CCTTP10.LZH COMTP10L.LIB TC++ v1.0x large model library
CCTW80.LZH CCTW80L.LIB Watcom C v8.0 large model library
CCTW85.LZH CCTW85L.LIB Watcom C v8.5 large model library
We include pre-compiled libraries for the large memory model. There are
three ways to obtain the libraries for another memory model:
a) you can create a library using the supplied MAKE files. The three
assembly language files can be assembled with MASM v5.1 or TURBO
ASSEMBLER v2.0+. If you do not have either assembler, use the
precompiled .OBJ files in CCTOBJ.LZH on the SOURCE disk.
b) Order the disks from us by mail. Request "the complete library disks
for C Communications Toolkit". There is a $20.00 charge ($25US if
outside USA).
The available libraries on the Complete Library Disks as of today
are:
Borland Turbo C v2.0 (S,M,C,L)
Borland Turbo C++ v1.0 (S,M,C,L)
Borland C++ v2.0 (S,M,C,L)
Microsoft C v5.1/QC v2.0x (S,M,C,L)
Microsoft C v6.00A, Quick C v2.5x (S,M,C,L)
Power C v2.0.x (S,M,L)
Watcom C v7.0, v8.0, v8.5 (S,M,C,L)
(where 'S' denotes small memory model, etc.):
3) CHANGES FROM PRIOR VERSIONS
Aside from changes in features, there are a few changes in syntax in
this version of CCT from prior versions.
a) init_port() is renamed u8250_init(). The parameter syntax is the
same.
b) fsend() includes a new parameter to set the size of the file transfer
buffer. See CCT09.C or CCT10.C for usage;
c) It is no longer necessary to call deinit_port() at the end of your
program. This is done automatically. You may still call deinit_port()
earlier if your application has completed all the communications you
wish to do.
d) init_kermit() is renamed k_init(). It is no longer necessary to call
it before Kermit file transfers. This is done automatically, and sets
the Kermit parameters to the Kermit defaults. You may call k_init()
prior to calling fsend() if you wish to modify the defaults.
e) inkey() now returns 0 when no key is ready. It previously returned EOF;
f) isamodem() is now named modem_type() (for naming consistency);
f) It is no longer necessary to call modem_assign() to assign a modem to
a port. This is done automatically. Your FIRST "modem_" call must be one of
modem_type(), modem_init(), modem_dial(), modem_hangup(), modem_reset().
g) All functions are now prototyped with FCALL_. FCALL_ is defined as
nothing by default. Microsoft C v6.0x and QC v2.5x users may wish to
change this (see Microsoft-specific details below).
4) MICROSOFT C v6.0x AND QUICK C v2.5
Microsoft Optimizing C v6.0A (MSC 6.0A) and Quick C v2.5+ support the
passing of parameters to functions through registers, but the methods
that they use are not compatible. If you use MSC 6.00a or Quick C v2.5,
use the /Gr option to ensure the linker recognizes the CCT symbols. If
you cannot use the /Gr option (because you are linking to libraries for
which you do not have the source) add the following to the compiler
command line:
/DFCALL_=_fastcall
5) MULTI-PORT BOARD DRIVERS
The following multi-port boards are supported in CCT. For updates to
these drivers, and support for additional boards, check our BBS in the
CCT Source Code File Area:
Arnet Multiport (optionally with Plus4 option);
AST: CC-832 Async Cluster Adapater;
Commtech Research: FASTCOMM4;
DigiBoard: COM/4i, COM/8i;
Star Gate Technologies: ACL
If you are using a multi-port board that is not currently supported in
CCT, we are willing to add support under an exchange system if the board
has a sufficient market. The system works as follows. You send us the
board. We write the drivers within 30 days and return the drivers and
board to you. We retain the right to use the drivers in CCT in the
future and you get the drivers you need.
If you are interested in this exchange system:
a) Call first, to check that we plan to support the board you are
using and have sufficient development resources to perform the work;
b) Insure the board when you ship it and request recorded delivery.
We take responsibility for the board from the time it arrives here
and until it leaves. The return shipment will be insured.
c) You pay shipping, handling, and insurance, both ways.
6) ERRATA
1) The functions fsend() and freceive() indicate that the file
transfer buffer length is type DWORD (unsigned long). It is in fact
"unsigned int". This is a change from earliar versions and was done for
compatibility reasons. We expect that most programmers will move to
32-bit compilers in the next two years, in which case the maximum length
of file transfer buffers will be 4Gb (rather than 64k).
7) PRODUCT HISTORY
A chronological update history to CCT is available in the file HISTORY.CCT.
8) SYNCHRONOUS COMMUNICATIONS AND Z-80 SIO SUPPORT
The Z-80 asynchronous and synchronous routines in CCT support the AST
CC-232 card. This is an OEM version of the CC-432 3270 emulation card
sold by AST as part of their SNA and 5151 connectivity packages.
We have a small number of these boards for sale. They have:
* Support for asynchronous or synchronous communications;
* Two independent channels;
* Support for IRQ2-IRQ7;
* Support for several IO addresses.
* Support for all the features of the Z-80 SIO;
* Complete with the cable.
* Configurable for a variety of clocking options in synchronous
modes;
In all, these are some of the most flexible serial cards we have
encountered. They make an excellent choice as development boards for
synchronous software and as PC-to-mainframe connectivity cards.
These boards are second-hand. We have tested them but they come with no
warranty. We bought them for development and replaced the USARTS with
the high-speed version of the Z-80 SIO so that they work in the AT buss
as well as the XT buss. The manual is $15 direct from AST. We are
selling the cards for $150.00US (plus shipping). Call us if you are
interested.
9) WATCOM C 7.0
If you are using Watcom C v7.0, your command line
should have the following option:
-dVERSION70
10) PROTECTED MODE VERSION
C COMMUNICATIONS TOOLKIT/EXTENDED DOS (CCT/ED) is available effective
February 1, 1992. This product contains all of the features of CCT, and
supports all the real mode compilers that the base version of CCT
supports. However, it also supports operation in protected mode under a
supported DOS extender. We support both 286 and 386 (32-bit) DOS
extenders. At the present time, the supported compilers and extenders
are:
"I" means that the extender is supplied with the compiler;
'x' means any number (e.g. MSC v6.00x);
Compiler DOS Extender
-------- ------------
BORLAND C++ v2.0 Phar Lap 286|DOS Extender
INTEL C CODE BUILDER 386/486 v1.0x Intel (I)
METAWARE HIGH C 386/486 v2.31 Phar Lap 386|DOS Extender
MICROSOFT C v6.0x Phar Lap 286|DOS Extender
WATCOM C/386 v8.5 Rational Systems (I)
Intel
Phar Lap 386|DOS Extender
C COMMUNICATIONS TOOLKIT/ED is $299.95. Upgrades for existing CCT users
are $99.95 (plus $5 s&h in US, $10US outside US. Call for express
rates).
11) MICROSOFT WINDOWS 3.0 VERSION
We are presently working on a version of CCT for Microsoft Windows v3.0.
No release date has been announced as yet. All registered users of
CCT and CCT/ED will receive a mailing with a special upgrade offer
price.
==========================================================================
Please address all comments and questions about this software to:
Magna Carta Software, Inc.
Voice: (214) 226-6909
FAX: (214) 226-0386 (CAS compatible -- binary file transfer OK)
BBS: (214) 226-8088 (2400 8N1)
