1csx_Parse_CISTPL_FUNCE(9F)Kernel Functions for Driverscsx_Parse_CISTPL_FUNCE(9F)
2
6 csx_Parse_CISTPL_FUNCE - parse Function Extension tuple
7
9 #include <sys/pccard.h>
10 int32_t csx_Parse_CISTPL_FUNCE(client_handle_t ch, tuple_t *tu,
14 cistpl_funce_t *cf,
15 uint32_t fid);
16
19 Solaris DDI Specific (Solaris DDI)
20
22 ch Client handle returned from csx_RegisterClient(9F).
23 tu Pointer to a tuple_t structure (see tuple(9S)) returned by a
26 call to csx_GetFirstTuple(9F) or csx_GetNextTuple(9F).
27 cf Pointer to a cistpl_funce_t structure which contains the parsed
30 CISTPL_FUNCE tuple information upon return from this function.
31 fid The function ID code to which this CISTPL_FUNCE tuple refers.
34 See csx_Parse_CISTPL_FUNCID(9F).
35
38 This function parses the Function Extension tuple, CISTPL_FUNCE, into a
39 form usable by PC Card drivers.
40 The CISTPL_FUNCE tuple is used to describe information about a specific
43 PCCard function. The information provided is determined by the Function
44 Identification tuple, CISTPL_FUNCID, that is being extended. Each func‐
45 tion has a defined set of extension tuples.
46
48 The structure members of cistpl_funce_t are:
49 uint32_t function; /* type of extended data */
51 uint32_t subfunction;
52 union {
53 struct serial {
54 uint32_t ua; /* UART in use */
55 uint32_t uc; /* UART capabilities */
56 } serial;
57 struct modem {
58 uint32_t fc; /* supported flow control methods */
59 uint32_t cb; /* size of DCE command buffer */
60 uint32_t eb; /* size of DCE to DCE buffer */
61 uint32_t tb; /* size of DTE to DCE buffer */
62 } modem;
63 struct data_modem {
64 uint32_t ud; /* highest data rate */
65 uint32_t ms; /* modulation standards */
66 uint32_t em; /* err correct proto and
67 /* non-CCITT modulation */
68 uint32_t dc; /* data compression protocols */
69 uint32_t cm; /* command protocols */
70 uint32_t ex; /* escape mechanisms */
71 uint32_t dy; /* standardized data encryption */
72 uint32_t ef; /* miscellaneous end user features */
73 uint32_t ncd; /* number of country codes */
74 uchar_t cd[16]; /* CCITT country code */
75 } data_modem;
76 struct fax {
77 uint32_t uf; /* highest data rate in DTE/UART */
78 uint32_t fm; /* CCITT modulation standards */
79 uint32_t fy; /* standardized data encryption */
80 uint32_t fs; /* feature selection */
81 uint32_t ncf; /* number of country codes */
82 uchar_t cf[16]; /* CCITT country codes */
83 } fax;
84 struct voice {
85 uint32_t uv; /* highest data rate */
86 uint32_t nsr;
87 uint32_t sr[16]; /* voice sampling rates (*100) */
88 uint32_t nss;
89 uint32_t ss[16]; /* voice sample sizes (*10) */
90 uint32_t nsc;
91 uint32_t sc[16]; /* voice compression methods */
92 } voice;
93 struct lan {
94 uint32_t tech; /* network technology */
95 uint32_t speed; /* media bit or baud rate */
96 uint32_t media; /* network media supported */
97 uint32_t con; /* open/closed connector standard */
98 uint32_t id_sz; /* length of lan station id */
99 uchar_t id[16]; /* station ID */
100 } lan;
101 } data;
102 The fields are defined as follows:
106 function This field identifies the type of extended information
108 provided about a function by the CISTPL_FUNCE tuple.
109 This field is defined as follows:
110 TPLFE_SUB_SERIAL Serial port interface
112 TPLFE_SUB_MODEM_COMMON Common modem interface
115 TPLFE_SUB_MODEM_DATA Data modem services
118 TPLFE_SUB_MODEM_FAX Fax modem services
121 TPLFE_SUB_VOICE Voice services
124 TPLFE_CAP_MODEM_DATA Capabilities of the data modem
127 interface
128 TPLFE_CAP_MODEM_FAX Capabilities of the fax modem
131 interface
132 TPLFE_CAP_MODEM_VOICE Capabilities of the voice
135 modem interface
136 TPLFE_CAP_SERIAL_DATA Serial port interface for data
139 modem services
140 TPLFE_CAP_SERIAL_FAX Serial port interface for fax
143 modem services
144 TPLFE_CAP_SERIAL_VOICE Serial port interface for
147 voice modem services
148 subfunction This is for identifying a sub-category of services pro‐
152 vided by a function in the CISTPL_FUNCE tuple. The
153 numeric value of the code is in the range of 1 to 15.
154 ua This is the serial port UART identification and is
157 defined as follows:
158 TPLFE_UA_8250 Intel 8250
160 TPLFE_UA_16450 NS 16450
163 TPLFE_UA_16550 NS 16550
166 uc This identifies the serial port UART capabilities and is
170 defined as follows:
171 TPLFE_UC_PARITY_SPACE Space parity supported
173 TPLFE_UC_PARITY_MARK Mark parity supported
176 TPLFE_UC_PARITY_ODD Odd parity supported
179 TPLFE_UC_PARITY_EVEN Even parity supported
182 TPLFE_UC_CS5 5 bit characters supported
185 TPLFE_UC_CS6 6 bit characters supported
188 TPLFE_UC_CS7 7 bit characters supported
191 TPLFE_UC_CS8 8 bit characters supported
194 TPLFE_UC_STOP_1 1 stop bit supported
197 TPLFE_UC_STOP_15 1.5 stop bits supported
200 TPLFE_UC_STOP_2 2 stop bits supported
203 fc This identifies the modem flow control methods and is
207 defined as follows:
208 TPLFE_FC_TX_XONOFF Transmit XON/XOFF
210 TPLFE_FC_RX_XONOFF Receiver XON/XOFF
213 TPLFE_FC_TX_HW Transmit hardware flow control
216 (CTS)
217 TPLFE_FC_RX_HW Receiver hardware flow control
220 (RTS)
221 TPLFE_FC_TRANS Transparent flow control
224 ms This identifies the modem modulation standards and
227 is defined as follows:
228 TPLFE_MS_BELL103 300bps
231 TPLFE_MS_V21 300bps (V.21)
234 TPLFE_MS_V23 600/1200bps (V.23)
237 TPLFE_MS_V22AB 1200bps (V.22A V.22B)
240 TPLFE_MS_BELL212 2400bps (US Bell 212
243 TPLFE_MS_V22BIS 2400bps (V.22bis)
246 TPLFE_MS_V26 2400bps leased line (V.26)
249 TPLFE_MS_V26BIS 2400bps (V.26bis)
252 TPLFE_MS_V27BIS 4800/2400bps leased line (V.27bis)
255 TPLFE_MS_V29 9600/7200/4800 leased line (V.29)
258 TPLFE_MS_V32 Up to 9600bps (V.32)
261 TPLFE_MS_V32BIS Up to 14400bps (V.32bis)
264 TPLFE_MS_VFAST Up to 28800 V.FAST
267 em This identifies modem error correction/detection proto‐
271 cols and is defined as follows:
272 TPLFE_EM_MNP MNP levels 2-4
274 TPLFE_EM_V42 CCITT LAPM (V.42)
277 dc This identifies modem data compression protocols and is
281 defined as follows:
282 TPLFE_DC_V42BI CCITT compression V.42
284 TPLFE_DC_MNP5 MNP compression (uses MNP 2, 3 or 4)
287 cm This identifies modem command protocols and is defined
291 as follows:
292 TPLFE_CM_AT1 ANSI/EIA/TIA 602 "Action" commands
294 TPLFE_CM_AT2 ANSI/EIA/TIA 602 "ACE/DCE IF Params"
297 TPLFE_CM_AT3 ANSI/EIA/TIA 602 "Ace Parameters"
300 TPLFE_CM_MNP_AT MNP specification AT commands
303 TPLFE_CM_V25BIS V.25bis calling commands
306 TPLFE_CM_V25A V.25bis test procedures
309 TPLFE_CM_DMCL DMCL command mode
312 ex This identifies the modem escape mechanism and is
316 defined as follows:
317 TPLFE_EX_BREAK BREAK support standardized
319 TPLFE_EX_PLUS +++ returns to command mode
322 TPLFE_EX_UD User defined escape character
325 dy This identifies modem standardized data encryption and
329 is a reserved field for future use and must be set to 0.
330 ef This identifies modem miscellaneous features and is
333 defined as follows:
334 TPLFE_EF_CALLERID Caller ID is supported
336 fm This identifies fax modulation standards and is defined
340 as follows:
341 TPLFE_FM_V21C2 300bps (V.21-C2)
343 TPLFE_FM_V27TER 4800/2400bps (V.27ter)
346 TPLFE_FM_V29 9600/7200/4800 leased line (V.29)
349 TPLFE_FM_V17 14.4K/12K/9600/7200bps (V.17)
352 TPLFE_FM_V33 4.4K/12K/9600/7200 leased line (V.33)
355 fs This identifies the fax feature selection and is defined
359 as follows:
360 TPLFE_FS_T3 Group 2 (T.3) service class
362 TPLFE_FS_T4 Group 3 (T.4) service class
365 TPLFE_FS_T6 Group 4 (T.6) service class
368 TPLFE_FS_ECM Error Correction Mode
371 TPLFE_FS_VOICEREQ Voice requests allowed
374 TPLFE_FS_POLLING Polling support
377 TPLFE_FS_FTP File transfer support
380 TPLFE_FS_PASSWORD Password support
383 tech This identifies the LAN technology type and is defined
387 as follows:
388 TPLFE_LAN_TECH_ARCNET Arcnet
390 TPLFE_LAN_TECH_ETHERNET Ethernet
393 TPLFE_LAN_TECH_TOKENRING Token Ring
396 TPLFE_LAN_TECH_LOCALTALK Local Talk
399 TPLFE_LAN_TECH_FDDI FDDI/CDDI
402 TPLFE_LAN_TECH_ATM ATM
405 TPLFE_LAN_TECH_WIRELESS Wireless
408 media This identifies the LAN media type and is defined as
412 follows:
413 TPLFE_LAN_MEDIA_INHERENT Generic interface
415 TPLFE_LAN_MEDIA_UTP Unshielded twisted pair
418 TPLFE_LAN_MEDIA_STP Shielded twisted pair
421 TPLFE_LAN_MEDIA_THIN_COAX Thin coax
424 TPLFE_LAN_MEDIA_THICK_COAX Thick coax
427 TPLFE_LAN_MEDIA_FIBER Fiber
430 TPLFE_LAN_MEDIA_SSR_902 Spread spectrum radio
433 902-928 MHz
434 TPLFE_LAN_MEDIA_SSR_2_4 Spread spectrum radio 2.4
437 GHz
438 TPLFE_LAN_MEDIA_SSR_5_4 Spread spectrum radio 5.4
441 GHz
442 TPLFE_LAN_MEDIA_DIFFUSE_IR Diffuse infra red
445 TPLFE_LAN_MEDIA_PTP_IR Point to point infra red
448
452 CS_SUCCESS Successful operation.
453 CS_BAD_HANDLE Client handle is invalid.
456 CS_UNKNOWN_TUPLE Parser does not know how to parse tuple.
459 CS_NO_CARD No PC Card in socket.
462 CS_NO_CIS No Card Information Structure (CIS) on PC
465 Card.
466 CS_UNSUPPORTED_FUNCTION No PCMCIA hardware installed.
469
472 This function may be called from user or kernel context.
473
475 csx_GetFirstTuple(9F), csx_GetTupleData(9F), csx_Parse_CISTPL_FUN‐
476 CID(9F), csx_RegisterClient(9F), csx_ValidateCIS(9F), tuple(9S)
477 PC Card 95 Standard, PCMCIA/JEIDA
480SunOS 5.11 20 Dec 1996 csx_Parse_CISTPL_FUNCE(9F)