Kernel Functions for Drivers csxModifyConfiguration(9F)
NAME
csxModifyConfiguration - modify socket and PC Card Confi-
guration Register
SYNOPSIS
#include
int32t csxModifyConfiguration(clienthandlet ch, modifyconfigt *mc);
INTERFACE LEVEL
Solaris DI Specific (Solaris DI)
PARAMETERS
ch Client handle returned from csxRegisterClient(9F).
mc Pointer to a modifyconfigt structure.
DESCRIPTION
This function allows a socket and PC Card configuration to
be modified. This function can only modify a configuration
requested via csxRequestConfiguration(9F).
STRUCTURE MEMBERS
The structure members of modifyconfigt are:
uint32t Socket; /* socket number */
uint32t Attributes; /* attributes to modify */
uint32t Vpp1; /* Vpp1 value */
uint32t Vpp2; /* Vpp2 value */
The fields are defined as follows:
Socket Not used in Solaris, but for portability with
other Card Services implementations, it
should be set to the logical socket number.
Attributes This field is bit-mapped. The following bits
are defined:
CONFENABLEIRQSTERING Enable IRQ steer-
ing. Set to con-
nect the PC Card
IREQ line to a
previously
SunOS 5.11 Last change: 19 Jul 1996 1
Kernel Functions for Drivers csxModifyConfiguration(9F)
selected system
interrupt.
CONFIRQCHANGEVALID IRQ change valid.
Set to request
the IRQ steering
enable to be
changed.
CONFVP1CHANGEVALID Vpp1 change
valid. These bits
are set to
request a change
to the
corresponding
voltage level for
the PC Card.
CONFVP2CHANGEVALID Vpp2 change
valid. These bits
are set to
request a change
to the
corresponding
voltage level for
the PC Card.
CONFVSOVERIDE Override VS pins.
For Low Voltage
keyed cards, must
be set if a
client desires to
apply a voltage
inappropriate for
this card to any
pin. After card
insertion and
prior to the
first
csxRequestConfiguration(9F)
call for this
client, the vol-
tage levels
applied to the
card will be
those specified
by the Card
Interface
SunOS 5.11 Last change: 19 Jul 1996 2
Kernel Functions for Drivers csxModifyConfiguration(9F)
Specification.
(See WARNINGS.)
Vpp1, Vpp2 Represent voltages expressed in tenths of a
volt. Values from 0 to 25.5 volts may be set.
To be valid, the exact voltage must be avail-
able from the system. To be compliant with
the PC Card 95 Standard, PCMCIA/JEIDA, sys-
tems must always support 5.0 volts for both
Vcc and Vpp. (See WARNINGS.)
RETURN VALUES
CSUCES Successful operation.
CSBADHANDLE Client handle is invalid or
csxRequestConfiguration(9F) not
done.
CSBADSOCKET Error getting/setting socket
hardware parameters.
CSBADVP Requested Vpp is not available
on socket.
CSNOCARD No PC Card in socket.
CSUNSUPORTEDFUNCTION No PCMCIA hardware installed.
CONTEXT
This function may be called from user or kernel context.
SEE ALSO
csxRegisterClient(9F), csxReleaseConfiguration(9F),
csxReleaseIO(9F), csxReleaseIRQ(9F),
csxRequestConfiguration(9F), csxRequestIO(9F),
csxRequestIRQ(9F)
PC Card 95 Standard, PCMCIA/JEIDA
WARNINGS
1. CONFVSOVERIDE is provided for clients that have a
need to override the information provided in the
SunOS 5.11 Last change: 19 Jul 1996 3
Kernel Functions for Drivers csxModifyConfiguration(9F)
CIS. The client must exercise caution when setting
this as it overrides any voltage level protection
provided by Card Services.
2. Using csxModifyConfiguration() to set Vpp to 0
volts may result in the loss of a PC Card's state.
Any client setting Vpp to 0 volts is responsible
for insuring that the PC Card's state is restored
when power is re-applied to the card.
NOTES
Mapped IO addresses can only be changed by first releasing
the current configuration and IO resources with
csxReleaseConfiguration(9F) and csxReleaseIO(9F), request-
ing new IO resources and a new configuration with
csxRequestIO(9F), followed by csxRequestConfiguration(9F).
IRQ priority can only be changed by first releasing the
current configuration and IRQ resources with
csxReleaseConfiguration(9F) and csxReleaseIRQ(9F),
requesting new IRQ resources and a new configuration with
csxRequestIRQ(9F), followed by
csxRequestConfiguration(9F).
Vcc can not be changed using csxModifyConfiguration(). Vcc
may be changed by first invoking
csxReleaseConfiguration(9F), followed by
csxRequestConfiguration(9F) with a new Vcc value.
SunOS 5.11 Last change: 19 Jul 1996 4
|
