ZCOM C I/F Library Routines

ZCONFIG (3X)

Response Data data.termret.zaddr

This is the terminal ZLU which has been successfully created or modified. For actions ZcDSC_CREATE_LTT_PTT and ZcDSC_CREATE_LTT_ON_PTT, it is the newly created terminal ZLU with the correct checksum.

 

data.termret.error

 

This is the returned terminal configuration error:

 

0 - No error (successful)

 

< 0 - ZCOM error code

 

> 0 - zcntl() firmware status code

NOTES

1. For port configuration, it is possible to change only one byte of the

 

32-bit configuration word, by using an appropriate value in action. In

 

this case, the other bytes remain unaffected. Besides, actions 1-5

 

correspond to the functions supported by zport(3X), except that zport

 

(3X) does not allow remote port configuration.

 

2. The following is the zpconf_type data structure definition (from

 

<zcom/zcomsys.h>) used in port configuration. This structure allows

 

the cnfg data to be referenced by individual bit fields

 

(zpconf_type.bits.<field>), by individual configuration bytes

 

(zpconf_type.pconfig[<bytenum>]), or by its entire 32-bit value

 

(zpconf_type.pcval).

/*-- Port Configuration format --*/

typedef union {

 

struct {

 

unsigned int ecode

: 2;

unsigned int sync

: 2;

unsigned int mode

: 2;

unsigned int parity

: 2;

unsigned int xclock

: 2;

unsigned int sclock

: 2;

unsigned int baud

: 4;

unsigned int pmode

: 2;

unsigned int pmode2

: 2;

unsigned int baud2

: 4;

unsigned int spare

: 8;

} bits;

 

struct {

 

unsigned int ecode

: 2;

unsigned int frmode

: 4;

unsigned int set0_1

: 4;

unsigned int sclk

: 2;

/* Encoding modes */ /* Sync mode select */ /* Operating mode */ /* Parity select */ /* Clock multiplier */ /* Clock source */

/* Baud rate value */

/* Port mode select - original */

/* Port mode select - extended */ /* Extended baud rate value */ /* Reserved, must be 0 */

/* Encoding modes */ /* Framing mode */

/* Reserved, must be 0 */ /* Clock source */

Chapter 4

223