Kernel Functions for Drivers csxParseCISTPLCONFIG(9F)
NAME
csxParseCISTPLCONFIG - parse Configuration tuple
SYNOPSIS
#include
int32t csxParseCISTPLCONFIG(clienthandlet ch, tuplet *tu,
cistplconfigt *cc);
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).
cc Pointer to a cistplconfigt structure which contains
the parsed CISTPLCONFIG tuple information upon return
from this function.
DESCRIPTION
This function parses the Configuration tuple, CISTPLCONFIG,
into a form usable by PC Card drivers. The CISTPLCONFIG
tuple is used to describe the general characteristics of
16-bit PC Cards containing I/O devices or using custom
interfaces. It may also describe PC Cards, including Memory
Only cards, which exceed nominal power supply specifica-
tions, or which need descriptions of their power require-
ments or other information.
STRUCTURE MEMBERS
The structure members of cistplconfigt are:
uint32t present; /* register present flags */
uint32t nr; /* number of config registers found */
uint32t hr; /* highest config register index found */
uint32t regs[CISTPLCONFIGMAXCONFIGREGS]; /* reg offsets */
uint32t base; /* base offset of config registers */
uint32t last; /* last config index */
SunOS 5.11 Last change: 20 Dec 1996 1
Kernel Functions for Drivers csxParseCISTPLCONFIG(9F)
The fields are defined as follows:
present This field indicates which configuration regis-
ters are present on the PC Card.
CONFIGOPTIONREGPRESENT Configuration
Option Register
present
CONFIGSTATUSREGPRESENT Configuration
Status Register
present
CONFIGPINREPLREGPRESENT Pin Replacement
Register present
CONFIGCOPYREGPRESENT Copy Register
present
CONFIGEXSTATREGPRESENT Extended Status
Register present
CONFIGIOBASE0REGPRESENT IO Base 0 Register
present
CONFIGIOBASE1REGPRESENT IO Base 1 Register
present
CONFIGIOBASE2REGPRESENT IO Base2 Register
present
CONFIGIOBASE3REGPRESENT IO Base3 Register
present
CONFIGIOLIMITREGPRESENT IO Limit Register
present
nr This field specifies the number of configuration
registers that are present on the PC Card.
SunOS 5.11 Last change: 20 Dec 1996 2
Kernel Functions for Drivers csxParseCISTPLCONFIG(9F)
hr This field specifies the highest configuration
register number that is present on the PC Card.
regs This array contains the offset from the start of
Attribute Memory space for each configuration
register that is present on the PC Card. If a
configuration register is not present on the PC
Card, the value in the corresponding entry in the
regs array is undefined.
base This field contains the offset from the start of
Attribute Memory space to the base of the PC Card
configuration register space.
last This field contains the value of the last valid
configuration index for this PC Card.
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),
csxParseCISTPLCFTABLENTRY(9F), csxRegisterClient(9F),
csxValidateCIS(9F), tuple(9S)
SunOS 5.11 Last change: 20 Dec 1996 3
Kernel Functions for Drivers csxParseCISTPLCONFIG(9F)
PC Card 95 Standard, PCMCIA/JEIDA
NOTES
PC Card drivers should not attempt to use configurations
beyond the "last" member in the cistplconfigt structure.
SunOS 5.11 Last change: 20 Dec 1996 4
|
