Kernel Functions for Drivers csx_Parse_CISTPL_FUNCE(9F)
NAME
csx_Parse_CISTPL_FUNCE - parse Function Extension tuple
SYNOPSIS
#include
int32_t csx_Parse_CISTPL_FUNCE(client_handle_t ch, tuple_t *tu,
cistpl_funce_t *cf,
uint32_t fid);
INTERFACE LEVEL
Solaris DDI Specific (Solaris DDI)PARAMETERS
ch Client handle returned from csx_RegisterClient(9F).
tu Pointer to a tuple_t structure (see tuple(9S))
returned by a call to csx_GetFirstTuple(9F) or
csx_GetNextTuple(9F).
cf Pointer to a cistpl_funce_t structure which contains
the parsed CISTPL_FUNCE tuple information upon return
from this function.fid The function ID code to which this CISTPL_FUNCE tuple
refers. See csx_Parse_CISTPL_FUNCID(9F).
DESCRIPTION
This function parses the Function Extension tuple,CISTPL_FUNCE, into a form usable by PC Card drivers.
The CISTPL_FUNCE tuple is used to describe information about
a specific PCCard function. The information provided is determined by the Function Identification tuple,CISTPL_FUNCID, that is being extended. Each function has a
defined set of extension tuples. STRUCTURE MEMBERSThe structure members of cistpl_funce_t are:
uint32_t function; /* type of extended data */
uint32_t subfunction;
union { struct serial {SunOS 5.11 Last change: 20 Dec 1996 1
Kernel Functions for Drivers csx_Parse_CISTPL_FUNCE(9F)
uint32_t ua; /* UART in use */
uint32_t uc; /* UART capabilities */
} serial; struct modem {uint32_t fc; /* supported flow control methods */
uint32_t cb; /* size of DCE command buffer */
uint32_t eb; /* size of DCE to DCE buffer */
uint32_t tb; /* size of DTE to DCE buffer */
} modem;struct data_modem {
uint32_t ud; /* highest data rate */
uint32_t ms; /* modulation standards */
uint32_t em; /* err correct proto and
/* non-CCITT modulation */
uint32_t dc; /* data compression protocols */
uint32_t cm; /* command protocols */
uint32_t ex; /* escape mechanisms */
uint32_t dy; /* standardized data encryption */
uint32_t ef; /* miscellaneous end user features */
uint32_t ncd; /* number of country codes */
uchar_t cd[16]; /* CCITT country code */
} data_modem;
struct fax {uint32_t uf; /* highest data rate in DTE/UART */
uint32_t fm; /* CCITT modulation standards */
uint32_t fy; /* standardized data encryption */
uint32_t fs; /* feature selection */
uint32_t ncf; /* number of country codes */
uchar_t cf[16]; /* CCITT country codes */
} fax; struct voice {uint32_t uv; /* highest data rate */
uint32_t nsr;
uint32_t sr[16]; /* voice sampling rates (*100) */
uint32_t nss;
uint32_t ss[16]; /* voice sample sizes (*10) */
uint32_t nsc;
uint32_t sc[16]; /* voice compression methods */
} voice; struct lan {uint32_t tech; /* network technology */
uint32_t speed; /* media bit or baud rate */
uint32_t media; /* network media supported */
uint32_t con; /* open/closed connector standard */
uint32_t id_sz; /* length of lan station id */
uchar_t id[16]; /* station ID */
} lan; } data;SunOS 5.11 Last change: 20 Dec 1996 2
Kernel Functions for Drivers csx_Parse_CISTPL_FUNCE(9F)
The fields are defined as follows: function This field identifies the type of extended information provided about a function by theCISTPL_FUNCE tuple. This field is defined as
follows:TPLFE_SUB_SERIAL Serial port inter-
faceTPLFE_SUB_MODEM_COMMON Common modem inter-
faceTPLFE_SUB_MODEM_DATA Data modem services
TPLFE_SUB_MODEM_FAX Fax modem services
TPLFE_SUB_VOICE Voice services
TPLFE_CAP_MODEM_DATA Capabilities of the
data modem inter-
faceTPLFE_CAP_MODEM_FAX Capabilities of the
fax modem interfaceTPLFE_CAP_MODEM_VOICE Capabilities of the
voice modem inter-
faceTPLFE_CAP_SERIAL_DATA Serial port inter-
face for data modem servicesTPLFE_CAP_SERIAL_FAX Serial port inter-
face for fax modem servicesTPLFE_CAP_SERIAL_VOICE Serial port inter-
face for voice modem servicesSunOS 5.11 Last change: 20 Dec 1996 3
Kernel Functions for Drivers csx_Parse_CISTPL_FUNCE(9F)
subfunction This is for identifying a sub-category of
services provided by a function in theCISTPL_FUNCE 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:TPLFE_UA_8250 Intel 8250
TPLFE_UA_16450 NS 16450
TPLFE_UA_16550 NS 16550
uc This identifies the serial port UART capabil-
ities and is defined as follows:TPLFE_UC_PARITY_SPACE Space parity sup-
portedTPLFE_UC_PARITY_MARK Mark parity sup-
portedTPLFE_UC_PARITY_ODD Odd parity supported
TPLFE_UC_PARITY_EVEN Even parity sup-
portedTPLFE_UC_CS5 5 bit characters
supportedTPLFE_UC_CS6 6 bit characters
supportedTPLFE_UC_CS7 7 bit characters
supportedTPLFE_UC_CS8 8 bit characters
supportedSunOS 5.11 Last change: 20 Dec 1996 4
Kernel Functions for Drivers csx_Parse_CISTPL_FUNCE(9F)
TPLFE_UC_STOP_1 1 stop bit supported
TPLFE_UC_STOP_15 1.5 stop bits sup-
portedTPLFE_UC_STOP_2 2 stop bits sup-
ported fc This identifies the modem flow control methods and is defined as follows:TPLFE_FC_TX_XONOFF Transmit XON/XOFF
TPLFE_FC_RX_XONOFF Receiver XON/XOFF
TPLFE_FC_TX_HW Transmit hardware flow
control (CTS)TPLFE_FC_RX_HW Receiver hardware flow
control (RTS)TPLFE_FC_TRANS Transparent flow con-
trol ms This identifies the modem modulation standards and is defined as follows:TPLFE_MS_BELL103 300bps
TPLFE_MS_V21 300bps (V.21)
TPLFE_MS_V23 600/1200bps (V.23)
TPLFE_MS_V22AB 1200bps (V.22A V.22B)
TPLFE_MS_BELL212 2400bps (US Bell 212
SunOS 5.11 Last change: 20 Dec 1996 5
Kernel Functions for Drivers csx_Parse_CISTPL_FUNCE(9F)
TPLFE_MS_V22BIS 2400bps (V.22bis)
TPLFE_MS_V26 2400bps leased line
(V.26)TPLFE_MS_V26BIS 2400bps (V.26bis)
TPLFE_MS_V27BIS 4800/2400bps leased line
(V.27bis)TPLFE_MS_V29 9600/7200/4800 leased
line (V.29)TPLFE_MS_V32 Up to 9600bps (V.32)
TPLFE_MS_V32BIS Up to 14400bps (V.32bis)
TPLFE_MS_VFAST Up to 28800 V.FAST
em This identifies modem error correction/detection protocols and is defined as follows:TPLFE_EM_MNP MNP levels 2-4
TPLFE_EM_V42 CCITT LAPM (V.42)
dc This identifies modem data compression proto-
cols and is defined as follows:TPLFE_DC_V42BI CCITT compression V.42
TPLFE_DC_MNP5 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 csx_Parse_CISTPL_FUNCE(9F)
TPLFE_CM_AT1 ANSI/EIA/TIA 602 "Action"
commandsTPLFE_CM_AT2 ANSI/EIA/TIA 602 "ACE/DCE
IF Params"TPLFE_CM_AT3 ANSI/EIA/TIA 602 "Ace
Parameters"TPLFE_CM_MNP_AT MNP specification AT com-
mandsTPLFE_CM_V25BIS V.25bis calling commands
TPLFE_CM_V25A V.25bis test procedures
TPLFE_CM_DMCL DMCL command mode
ex This identifies the modem escape mechanism and is defined as follows:TPLFE_EX_BREAK BREAK support standardized
TPLFE_EX_PLUS +++ returns to command mode
TPLFE_EX_UD 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:TPLFE_EF_CALLERID Caller ID is supported
SunOS 5.11 Last change: 20 Dec 1996 7
Kernel Functions for Drivers csx_Parse_CISTPL_FUNCE(9F)
fm This identifies fax modulation standards and is defined as follows:TPLFE_FM_V21C2 300bps (V.21-C2)
TPLFE_FM_V27TER 4800/2400bps (V.27ter)
TPLFE_FM_V29 9600/7200/4800 leased line
(V.29)TPLFE_FM_V17 14.4K/12K/9600/7200bps
(V.17)TPLFE_FM_V33 4.4K/12K/9600/7200 leased
line (V.33) fs This identifies the fax feature selection and is defined as follows:TPLFE_FS_T3 Group 2 (T.3) service
classTPLFE_FS_T4 Group 3 (T.4) service
classTPLFE_FS_T6 Group 4 (T.6) service
classTPLFE_FS_ECM Error Correction Mode
TPLFE_FS_VOICEREQ Voice requests allowed
TPLFE_FS_POLLING Polling support
TPLFE_FS_FTP File transfer support
TPLFE_FS_PASSWORD Password support
SunOS 5.11 Last change: 20 Dec 1996 8
Kernel Functions for Drivers csx_Parse_CISTPL_FUNCE(9F)
tech This identifies the LAN technology type and is defined as follows:TPLFE_LAN_TECH_ARCNET Arcnet
TPLFE_LAN_TECH_ETHERNET Ethernet
TPLFE_LAN_TECH_TOKENRING Token Ring
TPLFE_LAN_TECH_LOCALTALK Local Talk
TPLFE_LAN_TECH_FDDI FDDI/CDDI
TPLFE_LAN_TECH_ATM ATM
TPLFE_LAN_TECH_WIRELESS Wireless
media This identifies the LAN media type and is defined as follows:TPLFE_LAN_MEDIA_INHERENT Generic inter-
faceTPLFE_LAN_MEDIA_UTP Unshielded
twisted pairTPLFE_LAN_MEDIA_STP Shielded
twisted pairTPLFE_LAN_MEDIA_THIN_COAX Thin coax
TPLFE_LAN_MEDIA_THICK_COAX Thick coax
TPLFE_LAN_MEDIA_FIBER Fiber
TPLFE_LAN_MEDIA_SSR_902 Spread spectrum
radio 902-928
MHzSunOS 5.11 Last change: 20 Dec 1996 9
Kernel Functions for Drivers csx_Parse_CISTPL_FUNCE(9F)
TPLFE_LAN_MEDIA_SSR_2_4 Spread spectrum
radio 2.4 GHzTPLFE_LAN_MEDIA_SSR_5_4 Spread spectrum
radio 5.4 GHzTPLFE_LAN_MEDIA_DIFFUSE_IR Diffuse infra
redTPLFE_LAN_MEDIA_PTP_IR Point to point
infra redRETURN VALUES
CS_SUCCESS Successful operation.
CS_BAD_HANDLE Client handle is invalid.
CS_UNKNOWN_TUPLE Parser does not know how to parse
tuple.CS_NO_CARD No PC Card in socket.
CS_NO_CIS No Card Information Structure
(CIS) on PC Card.CS_UNSUPPORTED_FUNCTION No PCMCIA hardware installed.
CONTEXT
This function may be called from user or kernel context.SEE ALSO
csx_GetFirstTuple(9F), csx_GetTupleData(9F),
csx_Parse_CISTPL_FUNCID(9F), csx_RegisterClient(9F),
csx_ValidateCIS(9F), tuple(9S)
PC Card 95 Standard, PCMCIA/JEIDA
SunOS 5.11 Last change: 20 Dec 1996 10