04.06.2013 Views

Dynamic C function reference

Dynamic C function reference

Dynamic C function reference

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

AASC.LIB<br />

The Abstract Application-level Serial Communication (AASC) libraries<br />

allow the programmer to create buffered character streams (CHANNELs)<br />

that perform input/output on serial ports in the communication devices.<br />

One principal library, AASC.LIB, contains all of the application level<br />

<strong>function</strong>s required for these tasks. The AASC libraries’ <strong>function</strong> descriptions<br />

make use of the following<br />

typedef struct _Channel * CHANNEL;<br />

which, along with the _Channel structure itself, is defined in AASC.LIB.<br />

The high-level routines handle the bookkeeping for the connections<br />

between the low-level circular buffer and hardware driver libraries. This<br />

allows the same programming framework to use any applicable hardware.<br />

• CHANNEL aascOpen(int Type, char CRTS,<br />

long Param, void(*BRqFnc)())<br />

If successful, initializes a serial device and returns the communication<br />

channel pointer required for all subsequent access to the serial device.<br />

If unsuccessful, returns NULL.<br />

Type is the type of communication device to open: DEV_Z0 (ASCI0,<br />

“Z0”), DEV_Z1 (ASCI1, “Z1”), DEV_UART (XP8700), DEV_ZNET (RS-<br />

485 “zNet” network), DEV_STDIO (<strong>Dynamic</strong> C STDIO window),<br />

DEV_SCC (Z85C30 SCC port A), DEV_SIO or DEV_SIOA (Z84C90<br />

KIO’s SIO port A).<br />

CRTS specifies whether CTS/RTS handshaking should be used:<br />

nonzero means yes, zero means no.<br />

Param specifies all of the other communication options. Z-World has<br />

defined the following macros.<br />

Number of Data Bits Number of Stop Bits Number of Parity Bits<br />

ASCI_PARAM_7D ASCI_PARAM_1STOP ASCI_PARAM_NOPARITY<br />

ASCI_PARAM_8D ASCI_PARAM_2STOP ASCI_PARAM_OPARITY<br />

ASCI_PARAM_EPARITY<br />

SCC_7DATA SCC_1STOP SCC_NOPARITY<br />

SCC_8DATA SCC_2STOP SCC_OPARITY<br />

SCC_EPARITY<br />

!<br />

46 s AASC Libraries<br />

These macros apply to port Z0 of the Z180 or to the Serial<br />

Communication Controller. Refer to the <strong>Dynamic</strong> C driver<br />

descriptions or on-line help for additional macros.<br />

<strong>Dynamic</strong> C 32 v. 6.x

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!