Kernel Functions for Drivers csxParseCISTPLDEVICE(9F)
NAME
csxParseCISTPLDEVICE, csxParseCISTPLDEVICEA,
csxParseCISTPLDEVICEOC, csxParseCISTPLDEVICEOA -
parse Device Information tuples
SYNOPSIS
#include
int32t csxParseCISTPLDEVICE(clienthandlet ch, tuplet *tu,
cistpldevicet *cd);
int32t csxParseCISTPLDEVICEA(clienthandlet ch, tuplet *tu,
cistpldevicet *cd);
int32t csxParseCISTPLDEVICEOC(clienthandlet ch, tuplet *tu,
cistpldevicet *cd);
int32t csxParseCISTPLDEVICEOA(clienthandlet ch, tuplet *tu,
cistpldevicet *cd);
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).
cd Pointer to a cistpldevicet structure which contains
the parsed CISTPLDEVICE, CISTPLDEVICEA,
CISTPLDEVICEOC, or CISTPLDEVICEOA tuple informa-
tion upon return from these functions, respectively.
DESCRIPTION
csxParseCISTPLDEVICE() and csxParseCISTPLDEVICEA()
parse the 5 volt Device Information tuples, CISTPLDEVICE
and CISTPLDEVICEA, respectively, into a form usable by PC
Card drivers.
SunOS 5.11 Last change: 20 Dec 1996 1
Kernel Functions for Drivers csxParseCISTPLDEVICE(9F)
csxParseCISTPLDEVICEOC() and
csxParseCISTPLDEVICEOA() parse the Other Condition Dev-
ice Information tuples, CISTPLDEVICEOC and
CISTPLDEVICEOA, respectively, into a form usable by PC
Card drivers.
The CISTPLDEVICE and CISTPLDEVICEA tuples are used to
describe the card's device information, such as device
speed, device size, device type, and address space layout
information for Common Memory or Attribute Memory space,
respectively.
The CISTPLDEVICEOC and CISTPLDEVICEOA tuples are used to
describe the information about the card's device under a set
of operating conditions for Common Memory or Attribute
Memory space, respectively.
STRUCTURE MEMBERS
The structure members of cistpldevicet are:
uint32t numdevices; /* number of devices found */
cistpldevicenodet devnode[CISTPLDEVICEMAXDEVICES];
The structure members of cistpldevicenodet are:
uint32t flags; /* flags specific to this device */
uint32t speed; /* device speed in device
/* speed code format */
uint32t nSspeed; /* device speed in nS */
uint32t type; /* device type */
uint32t size; /* device size */
uint32t sizeinbytes; /* device size in bytes */
The fields are defined as follows:
flags This field indicates whether or not the device is
writable, and describes a Vcc voltage at which the
PC Card can be operated.
CISTPLDEVICEWPS Write Protect Switch bit is
set
Bits which are applicable only for CISTPLDEVICEOC
and CISTPLDEVICEOA are:
SunOS 5.11 Last change: 20 Dec 1996 2
Kernel Functions for Drivers csxParseCISTPLDEVICE(9F)
CISTPLDEVICEOCMWAIT Use MWAIT
CISTPLDEVICEOCVccMASK Mask for Vcc value
CISTPLDEVICEOCVcc5 5.0 volt operation
CISTPLDEVICEOCVcc33 3.3 volt operation
CISTPLDEVICEOCVccX X.X volt operation
CISTPLDEVICEOCVccY Y.Y volt operation
speed The device speed value described in the
device speed code unit. If this field is
set to CISTPLDEVICESPEDSIZEIGNORE,
then the speed information will be ignored.
nSspeed The device speed value described in
nanosecond units.
size The device size value described in the dev-
ice size code unit. If this field is set to
CISTPLDEVICESPEDSIZEIGNORE, then the
size information will be ignored.
sizeinbytes The device size value described in byte
units.
type This is the device type code field which is
defined as follows:
CISTPLDEVICEDTYPENUL
No device
CISTPLDEVICEDTYPEROM
Masked ROM
SunOS 5.11 Last change: 20 Dec 1996 3
Kernel Functions for Drivers csxParseCISTPLDEVICE(9F)
CISTPLDEVICEDTYPEOTPROM
One Time Programmable ROM
CISTPLDEVICEDTYPEPROM
UV EPROM
CISTPLDEVICEDTYPEPROM
EPROM
CISTPLDEVICEDTYPEFLASH
FLASH
CISTPLDEVICEDTYPESRAM
Static RAM
CISTPLDEVICEDTYPEDRAM
Dynamic RAM
CISTPLDEVICEDTYPEFUNCSPEC
Function-specific memory address range
CISTPLDEVICEDTYPEXTEND
Extended type follows
RETURN VALUES
CSUCES Successful operation.
CSBADHANDLE Client handle is invalid.
CSUNKNOWNTUPLE Parser does not know how to parse
tuple.
SunOS 5.11 Last change: 20 Dec 1996 4
Kernel Functions for Drivers csxParseCISTPLDEVICE(9F)
CSNOCARD No PC Card in socket.
CSNOCIS No Card Information Structure
(CIS) on PC Card.
CSUNSUPORTEDFUNCTION No PCMCIA hardware installed.
CONTEXT
These functions may be called from user or kernel context.
SEE ALSO
csxGetFirstTuple(9F), csxGetTupleData(9F),
csxParseCISTPLJEDEC(9F), csxRegisterClient(9F),
csxValidateCIS(9F), tuple(9S)
PC Card 95 Standard, PCMCIA/JEIDA
SunOS 5.11 Last change: 20 Dec 1996 5
|
