Drivers that support ISA and another bus type

If a DDI driver supports a device that can run on both an ISA and another bus type (such as PCI), you will need to take the following steps:

1. The driver code must have the following:

   • Include a CFG_VERIFY subfunction to the config(D2) entry point routine to support the ISA card(s).

   • Be sure that the cm_intr_attach(D3) function is called once for each board instance.

   • The driver can determine the configured bus type by querying the CM_BRDBUSTYPE parameter (see cm_params(D5)) and looking for CM_BUS_ISA, CM_BUS_PCI, and so forth.

2. Set up the DSP files (see ``DSP (Driver Software Package)'') as follows:

   • List both ISA and PCI (or other bus type) in the Drvmap(DSP/4dsp) file.

   • Create a System(DSP/4dsp) file that has a single entry for PCI (all values set to 0 except for IPL and ``ITYPE'') and one entry for each ISA board that defines all the correct hardware parameters. correct (default) values for the ISA card.

     NOTE: OLD DOC SAID: No System file entry is required for the PCI card in this case.

   • ISA and PCI cards for MDI drivers have separate bcfg(DSP/4dsp) files for each bus type or even for each ISA card. Each bcfg file specifies the correct values for that card, or can be set up with CUSTOM= entries to query the user for the configuration information.

3. In the driver's postinstall script, do the following:

   • Run idinstall -N to install the DSP files.

   • Run idresadd -n to create the resource manager entries as non-default.

   • Run dcu -S (or, for MDI network drivers, the netcfg command) to load the modname for the PCI entries.

     NOTE: OLD DOC SAID: If both types of cards are configured on the same system, only the resource manager entry for the PCI device is created automatically. You will have to use the DCU (or, for MDI network drivers, the netcfg command)

     If only one ISA card is configured or no card is configured, a single resource manager entry is created with the BRDBUSTYPE parameter set to ISA. If one or more PCI cards are configured, a resource manager entry is created for each card with the BRDBUSTYPE parameter set to PCI.

     If multiple ISA cards are configured or if the ISA card does not use the default settings that are listed in the System file, run dcu -S (or netcfg) to add the entries for additional cards or to change the values for the card that does not use the default settings.

The dpt sample driver provided in the HDK's hbasamp package supports both ISA and PCI controllers and illustrates how to handle this situation.

The tok sample driver provided in the HDK's ndsample package supports both ISA and MCA controllers and illustrates how to handle this situation. Similar coding and DSP files would be used for a driver that supports both ISA and PCI.