config(D2pccard)

config -- initialize a loadable kernel module

Syntax

See config(D2) for syntax and general usage information about this entry point routine.

Usage

PC Card client-enabled drivers code the following subfunctions to the config( ) entry point routine:

CFG_ADD

Call the cm_getval(D3) function to determine if the BRDBUSTYPE parameter documented on the cm_params(D5) manual page is set to CM_BUS_PCCARD.
Call the cm_getval(D3) function to query the resource manager database about the IOADDR, MEMADDR, and IRQ that are used by this card.
Call the GetConfigurationInfo(D3pccard) service to get information about the socket and the card such as manufacturer, function code, and IRQ attributes.
Call the GetFirstTuple(D3pccard) and GetTupleData(D3pccard) services to examine the tuples in the CISinfo(D4pccard) CIS (Card Information Structure) for get more specific data.
Call the RequestWindow(D3pccard) service to request a portion of system memory. ( ) Call the MapMemPage(D3pccard) service to associate a memory area on the card with the system memory obtained with RequestWindow( ).
Call the RequestDMA(D3pccard), RequestIO(D3pccard), and/or RequestIRQ(D3pccard) services as needed.
Call the RequestConfiguration(D3pccard) service to configure the card and socket according to memory allocated and system resources granted.
Call the cm_intr_attach(D3) function to attach interrupts for the configured cards.

CFG_VERIFY

See _verify(D2pccard) for information.

CFG_SUSPEND

Put the specified card in suspend mode by turning off some power to the hardware.

CFG_REMOVE

Call the ReleaseConfiguration(D3pccard) service. For a 16-bit card, this returns the card to a simple memory-only interface and configuration 0; for a 32-bit CardBus card, I/O access is disabled.
Call the ReleaseDMA(D3pccard), ReleaseIO(D3pccard), and/or ReleaseIRQ(D3pccard) service to free system resources.
Call the DeregisterClient(D3pccard) function to deregister the driver.
Call the cm_intr_detach(D3) function to detach interrupts for the cards.
If no other clien-enabled device driver expresses interest in the slot, CardServices( ) shuts down the slot's power.
Call the DeregisterClient(D3pccard) function to deregister the client-enabled driver.

Version applicability

pccard: 2 with ddi: 8

Differences between versions

For Release 7.1, the DDI 8 interface for PC Card client-enabled drivers has not been fully tested and implemented. Specifically, the CFG_SUSPEND, CFG_RESUME, and CFG_MODIFY subfunctions are disabled for Release 7.1.G

This page provides as much as we know about the implementation but the information may change.

SVR5 and SCO OpenServer 5 compatibility

SCO OpenServer 5 PC Card devices implement the config( ) information in their init(D2pccard) entry point routines.

References

config(D2), config(D2mdi), config(D2sdi), init(D2pccard), _verify(D2pccard)