Kernel Functions for Drivers csxParseCISTPLFUNCE(9F)
NAME
csxParseCISTPLFUNCE - parse Function Extension tuple
SYNOPSIS
#include
int32t csxParseCISTPLFUNCE(clienthandlet ch, tuplet *tu,
cistplfuncet *cf,
uint32t fid);
INTERFACE LEVEL
Solaris DI Specific (Solaris DI)
PARAMETERS
ch Client handle returned from csxRegisterClient(9F).
tu Pointer to a tuplet structure (see tuple(9S))
returned by a call to csxGetFirstTuple(9F) or
csxGetNextTuple(9F).
cf Pointer to a cistplfuncet structure which contains
the parsed CISTPLFUNCE tuple information upon return
from this function.
fid The function ID code to which this CISTPLFUNCE tuple
refers. See csxParseCISTPLFUNCID(9F).
DESCRIPTION
This function parses the Function Extension tuple,
CISTPLFUNCE, into a form usable by PC Card drivers.
The CISTPLFUNCE tuple is used to describe information about
a specific PCard function. The information provided is
determined by the Function Identification tuple,
CISTPLFUNCID, that is being extended. Each function has a
defined set of extension tuples.
STRUCTURE MEMBERS
The structure members of cistplfuncet are:
uint32t function; /* type of extended data */
uint32t subfunction;
union {
struct serial {
SunOS 5.11 Last change: 20 Dec 1996 1
Kernel Functions for Drivers csxParseCISTPLFUNCE(9F)
uint32t ua; /* UART in use */
uint32t uc; /* UART capabilities */
} serial;
struct modem {
uint32t fc; /* supported flow control methods */
uint32t cb; /* size of DCE command buffer */
uint32t eb; /* size of DCE to DCE buffer */
uint32t tb; /* size of DTE to DCE buffer */
} modem;
struct datamodem {
uint32t ud; /* highest data rate */
uint32t ms; /* modulation standards */
uint32t em; /* err correct proto and
/* non-CIT modulation */
uint32t dc; /* data compression protocols */
uint32t cm; /* command protocols */
uint32t ex; /* escape mechanisms */
uint32t dy; /* standardized data encryption */
uint32t ef; /* miscellaneous end user features */
uint32t ncd; /* number of country codes */
uchart cd[16]; /* CIT country code */
} datamodem;
struct fax {
uint32t uf; /* highest data rate in DTE/UART */
uint32t fm; /* CIT modulation standards */
uint32t fy; /* standardized data encryption */
uint32t fs; /* feature selection */
uint32t ncf; /* number of country codes */
uchart cf[16]; /* CIT country codes */
} fax;
struct voice {
uint32t uv; /* highest data rate */
uint32t nsr;
uint32t sr[16]; /* voice sampling rates (*100) */
uint32t nss;
uint32t ss[16]; /* voice sample sizes (*10) */
uint32t nsc;
uint32t sc[16]; /* voice compression methods */
} voice;
struct lan {
uint32t tech; /* network technology */
uint32t speed; /* media bit or baud rate */
uint32t media; /* network media supported */
uint32t con; /* open/closed connector standard */
uint32t idsz; /* length of lan station id */
uchart id[16]; /* station ID */
} lan;
} data;
SunOS 5.11 Last change: 20 Dec 1996 2
Kernel Functions for Drivers csxParseCISTPLFUNCE(9F)
The fields are defined as follows:
function This field identifies the type of extended
information provided about a function by the
CISTPLFUNCE tuple. This field is defined as
follows:
TPLFESUBSERIAL Serial port inter-
face
TPLFESUBMODEMCOMON Common modem inter-
face
TPLFESUBMODEMDATA Data modem services
TPLFESUBMODEMFAX Fax modem services
TPLFESUBVOICE Voice services
TPLFECAPMODEMDATA Capabilities of the
data modem inter-
face
TPLFECAPMODEMFAX Capabilities of the
fax modem interface
TPLFECAPMODEMVOICE Capabilities of the
voice modem inter-
face
TPLFECAPSERIALDATA Serial port inter-
face for data modem
services
TPLFECAPSERIALFAX Serial port inter-
face for fax modem
services
TPLFECAPSERIALVOICE Serial port inter-
face for voice
modem services
SunOS 5.11 Last change: 20 Dec 1996 3
Kernel Functions for Drivers csxParseCISTPLFUNCE(9F)
subfunction This is for identifying a sub-category of
services provided by a function in the
CISTPLFUNCE tuple. The numeric value of the
code is in the range of 1 to 15.
ua This is the serial port UART identification
and is defined as follows:
TPLFEUA8250 Intel 8250
TPLFEUA16450 NS 16450
TPLFEUA16550 NS 16550
uc This identifies the serial port UART capabil-
ities and is defined as follows:
TPLFEUCPARITYSPACE Space parity sup-
ported
TPLFEUCPARITYMARK Mark parity sup-
ported
TPLFEUCPARITYOD Odd parity supported
TPLFEUCPARITYEVEN Even parity sup-
ported
TPLFEUCS5 5 bit characters
supported
TPLFEUCS6 6 bit characters
supported
TPLFEUCS7 7 bit characters
supported
TPLFEUCS8 8 bit characters
supported
SunOS 5.11 Last change: 20 Dec 1996 4
Kernel Functions for Drivers csxParseCISTPLFUNCE(9F)
TPLFEUCSTOP1 1 stop bit supported
TPLFEUCSTOP15 1.5 stop bits sup-
ported
TPLFEUCSTOP2 2 stop bits sup-
ported
fc This identifies the modem flow control
methods and is defined as follows:
TPLFEFCTXONOF Transmit XON/XOF
TPLFEFCRXONOF Receiver XON/XOF
TPLFEFCTXHW Transmit hardware flow
control (CTS)
TPLFEFCRXHW Receiver hardware flow
control (RTS)
TPLFEFCTRANS Transparent flow con-
trol
ms This identifies the modem modulation
standards and is defined as follows:
TPLFEMSBEL103 300bps
TPLFEMSV21 300bps (V.21)
TPLFEMSV23 600/1200bps (V.23)
TPLFEMSV22AB 1200bps (V.22A V.22B)
TPLFEMSBEL212 2400bps (US Bell 212
SunOS 5.11 Last change: 20 Dec 1996 5
Kernel Functions for Drivers csxParseCISTPLFUNCE(9F)
TPLFEMSV22BIS 2400bps (V.22bis)
TPLFEMSV26 2400bps leased line
(V.26)
TPLFEMSV26BIS 2400bps (V.26bis)
TPLFEMSV27BIS 4800/2400bps leased line
(V.27bis)
TPLFEMSV29 9600/7200/4800 leased
line (V.29)
TPLFEMSV32 Up to 9600bps (V.32)
TPLFEMSV32BIS Up to 14400bps (V.32bis)
TPLFEMSVFAST Up to 28800 V.FAST
em This identifies modem error
correction/detection protocols and is defined
as follows:
TPLFEMNP MNP levels 2-4
TPLFEMV42 CIT LAPM (V.42)
dc This identifies modem data compression proto-
cols and is defined as follows:
TPLFEDCV42BI CIT compression V.42
TPLFEDCMNP5 MNP compression (uses MNP
2, 3 or 4)
cm This identifies modem command protocols and
is defined as follows:
SunOS 5.11 Last change: 20 Dec 1996 6
Kernel Functions for Drivers csxParseCISTPLFUNCE(9F)
TPLFECMAT1 ANSI/EIA/TIA 602 "Action"
commands
TPLFECMAT2 ANSI/EIA/TIA 602 "ACE/DCE
IF Params"
TPLFECMAT3 ANSI/EIA/TIA 602 "Ace
Parameters"
TPLFECMNPAT MNP specification AT com-
mands
TPLFECMV25BIS V.25bis calling commands
TPLFECMV25A V.25bis test procedures
TPLFECMDMCL DMCL command mode
ex This identifies the modem escape mechanism
and is defined as follows:
TPLFEXBREAK BREAK support standardized
TPLFEXPLUS ] returns to command mode
TPLFEXUD User defined escape charac-
ter
dy This identifies modem standardized data
encryption and is a reserved field for future
use and must be set to 0.
ef This identifies modem miscellaneous features
and is defined as follows:
TPLFEFCALERID Caller ID is supported
SunOS 5.11 Last change: 20 Dec 1996 7
Kernel Functions for Drivers csxParseCISTPLFUNCE(9F)
fm This identifies fax modulation standards and
is defined as follows:
TPLFEFMV21C2 300bps (V.21-C2)
TPLFEFMV27TER 4800/2400bps (V.27ter)
TPLFEFMV29 9600/7200/4800 leased line
(V.29)
TPLFEFMV17 14.4K/12K/9600/7200bps
(V.17)
TPLFEFMV33 4.4K/12K/9600/7200 leased
line (V.33)
fs This identifies the fax feature selection and
is defined as follows:
TPLFEFST3 Group 2 (T.3) service
class
TPLFEFST4 Group 3 (T.4) service
class
TPLFEFST6 Group 4 (T.6) service
class
TPLFEFSECM Error Correction Mode
TPLFEFSVOICEREQ Voice requests allowed
TPLFEFSPOLING Polling support
TPLFEFSFTP File transfer support
TPLFEFSPASWORD Password support
SunOS 5.11 Last change: 20 Dec 1996 8
Kernel Functions for Drivers csxParseCISTPLFUNCE(9F)
tech This identifies the LAN technology type and
is defined as follows:
TPLFELANTECHARCNET Arcnet
TPLFELANTECHETHERNET Ethernet
TPLFELANTECHTOKENRING Token Ring
TPLFELANTECHLOCALTALK Local Talk
TPLFELANTECHFDI FDI/CDI
TPLFELANTECHATM ATM
TPLFELANTECHWIRELES Wireless
media This identifies the LAN media type and is
defined as follows:
TPLFELANMEDIAINHERENT Generic inter-
face
TPLFELANMEDIAUTP Unshielded
twisted pair
TPLFELANMEDIASTP Shielded
twisted pair
TPLFELANMEDIATHINCOAX Thin coax
TPLFELANMEDIATHICKCOAX Thick coax
TPLFELANMEDIAFIBER Fiber
TPLFELANMEDIASR902 Spread spectrum
radio 902-928
MHz
SunOS 5.11 Last change: 20 Dec 1996 9
Kernel Functions for Drivers csxParseCISTPLFUNCE(9F)
TPLFELANMEDIASR24 Spread spectrum
radio 2.4 GHz
TPLFELANMEDIASR54 Spread spectrum
radio 5.4 GHz
TPLFELANMEDIADIFUSEIR Diffuse infra
red
TPLFELANMEDIAPTPIR Point to point
infra red
RETURN VALUES
CSUCES Successful operation.
CSBADHANDLE Client handle is invalid.
CSUNKNOWNTUPLE Parser does not know how to parse
tuple.
CSNOCARD No PC Card in socket.
CSNOCIS No Card Information Structure
(CIS) on PC Card.
CSUNSUPORTEDFUNCTION No PCMCIA hardware installed.
CONTEXT
This function may be called from user or kernel context.
SEE ALSO
csxGetFirstTuple(9F), csxGetTupleData(9F),
csxParseCISTPLFUNCID(9F), csxRegisterClient(9F),
csxValidateCIS(9F), tuple(9S)
PC Card 95 Standard, PCMCIA/JEIDA
SunOS 5.11 Last change: 20 Dec 1996 10
|
