HOWTO: Add PCMCIA Support to a Windows NT Device Driver |
Q170084
The information in this article applies to:
- Microsoft Win32 Device Driver Kit (DDK) for Windows NT, versions 3.51, 4.0
SUMMARY
PCMCIA support under Windows NT is in the form of basic PC Card enabling. Such PCMCIA features as dynamic configuration and hot-plugging are unsupported. Basically, a developer writes an ISA device driver and ensures that the PC Card is configured correctly (either via the CIS tuple information or the registry overrides described below). The ISA driver checks the registry to see if the card is configured and gets the resources from the resource list created by Pcmcia.sys. The ISA driver is also responsible for claiming the card resources via IoReportResourceUsage or a similar mechanism.
For additional information about how to mask specific IRQs to PCMCIA devices as well as detailed information about the InterruptMask value of the PCMCIA registry key that controls IRQ masking, please see the following articles in the Microsoft Knowledge Base:
Q168303 Masking IRQs for PCMCIA Devices
MORE INFORMATION
For Pcmcia.sys to recognize the card, there must first be an entry in the PCMCIA database. This database is stored in the Windows NT registry. In the following discussion, note that HKLM indicates HKEY_LOCAL_MACHINE and CCS indicates CurrentControlSet.
WARNING: Modifying the registry can cause the system to become unstable and may cause the system to become unusable (requiring a reinstallation). Do not modify the registry unless you understand the implications of any changes you are making.
Note that the Pcmcia.sys driver shipped with Windows NT 4 does not support PCCards with a DMA (direct memory access) interface. Also, there are no registry overrides that can be used to configure these DMA-capable PCCards.
Add PC Card Information to the PCMCIA Database
Under HKLM\SYSTEM\CCS\Services\Pcmcia\DataBase add a key for Manufacturer ID. This information is in the Level 1 Version/Product Information Tuple. The Manufacturer ID is the first ASCII string after the Minor Version Number. For example:
HKLM\SYSTEM\CCS\Services\Pcmcia\DataBase\XYZ Corp
Under Manufacturer ID, add a key for the Device ID. The Device ID is the second ASCII string (just after the Manufacturer ID). For Example:
HKLM\SYSTEM\CCS\Services\Pcmcia\DataBase\XYZ Corp\XYZ device
For PCMCIA.SYS to configure the PC Card, you must specify the name of a driver under the Device ID key. Add this as a value under the Device ID key:
Driver : REG_SZ : Xyz
Note that the value of the driver specified here does not need to match the "real" driver's name. For example, the driver that actually controls a card may be Abc.sys and have a service key name "Abc", but the driver name specified in the PCMCIA database is "Xyz". In this case, the driver Abc.sys would look for the resource information under "Xyz" in the Hardware key (described below).
Finding the PC Card Resources
After adding the PCMCIA database information and rebooting, the Pcmcia.sys driver attempts to configure the card according to the CIS tuple data. If the tuple data is successfully parsed and the PC Card configured, PCMCIA creates a resource list under the following key:
HKLM\HARDWARE\DESCRIPTION\System\PCMCIA PCCARDS
There should be a value under this key of the name specified in the PCMCIA database entry for this particular card. For the example presented thus far, the PCMCIA database described driver "Xyz". So, under the PCMCIA PCCARDS key should be a value similar to the following:
Xyz : REG_FULL_RESOURCE_DESCRIPTOR : ...
If the ISA driver for the PC Card finds this value, then the PC Card is configured and ready to go. The resource descriptor layout is described in the Windows NT DDK. The ISA driver should parse this resource list to get the information and map the I/O and memory spaces as required, as well as configure the interrupt.
If the resource list is found in the dynamic HARDWARE key, then the card is configured and usable. If the resource list is not there, then the card is not in the socket, or an override is required to make Pcmcia.sys configure the card.
There may be more than one resource list value under this key, so make sure to check that the value name matches the driver name specified in the PCMCIA database.Using Registry Overrides for PCMCIA Cards
For PCMCIA overrides to be processed, they must specify either an interrupt or I/O port address (or both). If the card does not use either, then you will have to select a dummy I/O port address to force the override to be accepted.
Create a new driver key in the Services key. The name for this key should match the key specified in the PCMCIA database for this specific PCCARD, with a single digit ("1" through "9") appended to it. For example:
HKLM\SYSTEM\CCS\Services\Xyz1
Under the new driver key, add a Parameters key. For example:
HKLM\SYSTEM\CCS\Services\Xyz1\Parameters
Under the Parameters key, the following value is required. If it is not present or set to zero, the PCMCIA driver will not use this configuration and will search for another configuration in the registry. Pcmcia.sys will stop searching for configurations as soon as it finds a valid override. This is why you cannot use more than one PC Card with a specific Manufacturer ID and Device ID.
Pcmcia : DWORD : 1
Under the Parameters key, add the optional keywords as needed. Examples include:
AttributeMemorySize : DWORD : 0x1000 InterruptNumber : DWORD : 0xf IoBaseAddress : DWORD : 0x170 IoBaseAddress_1 : DWORD : 0x376 IoLength : DWORD : 0x8 IoLength_1 : DWORD : 0x2
Possible override values under:
HKLM\SYSTEM\CCS\Services\Pcmcia\DataBase\XYZ Corp\XYZ device Value Name Data Type Description ------------------------- --------- ------------------------------- CcrBase REG_DWORD Configuration register base PortWidth16 REG_DWORD 1=16 bit accesses to I/O space Driver REG_SZ Driver name CardMemorySize REG_DWORD [0] Card memory length CardMemorySize_1 REG_DWORD [1] Card memory length AttributeMemorySize REG_DWORD [0] Attribute memory length AttributeMemorySize_1 REG_DWORD [1] Attribute memory length
Possible override values for:
HKLM\SYSTEM\CCS\Services\Xyz1\Parameters Value Name Data Type Description ------------------------- --------- ------------------------------- Pcmcia REG_DWORD 1=enable this configuration InterruptNumber REG_DWORD Interrupt value IoBaseAddress REG_DWORD [0] I/O port base address IoLength REG_DWORD [0] I/O port length IoBaseAddress_1 REG_DWORD [1] I/O port base address IoLength_1 REG_DWORD [1] I/O port length MemoryMappedBaseAddress REG_DWORD [0] Host base memory MemoryMappedSize REG_DWORD [0] Host base memory length PCCARDMemoryWindowOffset REG_DWORD [0] Card base (host base offset) Address_16 REG_DWORD 1=16-bit memory access MemoryMappedBaseAddress_1 REG_DWORD [1] Host base memory MemoryMappedSize_1 REG_DWORD [1] Host base memory length PCCARDMemoryWindowOffset_1 REG_DWORD [1] Card base (host base offset) Address1_16 REG_DWORD 1=16-bit memory access MemoryMappedBaseAddress_2 REG_DWORD [2] Host base memory MemoryMappedSize_2 REG_DWORD [2] Host base memory length PCCARDMemoryWindowOffset_2 REG_DWORD [2] Card base (host base offset) Address2_16 REG_DWORD 1=16-bit memory access MemoryMappedBaseAddress_3 REG_DWORD [3] Host base memory MemoryMappedSize_3 REG_DWORD [3] Host base memory length PCCARDMemoryWindowOffset_3 REG_DWORD [3] Card base (host base offset) Address3_16 REG_DWORD 1=16-bit memory access PCCARDAttributeMemoryAddress REG_DWORD [0] Attribute memory PCCARDAttributeMemorySize REG_DWORD [0] Attribute memory length PCCARDAttributeMemoryOffset REG_DWORD [0] Attribute memory offset AttributeMemory_16 REG_DWORD 1=16-bit memory access PCCARDAttributeMemoryAddress_1 REG_DWORD [1] Attribute memory PCCARDAttributeMemorySize_1 REG_DWORD [1] Attribute memory length PCCARDAttributeMemoryOffset_1 REG_DWORD [1] Attribute memory offset AttributeMemory1_16 REG_DWORD 1=16-bit memory access ModemFunction REG_DWORD 1=multifunction modem device PCCARDReadyInterrupt REG_DWORD * Not implemented *
Additional query words:
Keywords : kbDDK kbOSWinNT351 kbOSWinNT400
Issue type : kbhowto
Technology : kbAudDeveloper kbWinDDKSearch kbWin32sSearch kbWin32DDKSearch kbWin32DDKNT351 kbWin32DDKNT400 kbWin32DDKNTSearch
Last Reviewed: April 5, 1999 |
