Intro(D3hpci)

Intro -- introduction to kernel functions for hot plug controller drivers

Synopsis

   #include <sys/types.h>
   #include <sys/hpci.h>
   #include <sys/hpci_bios.h>
   #include <sys/ddi.h>

Description

This section documents the Hot Plug Controller Interface functions that are used to implement hot plug controller drivers. Drivers that use these functions must include the following line in their Master(DSP/4dsp) files:

   $interface hpci 1

Usage

A hot plug controller driver controls the hot plug bus. In the PCI case, the hot plug controller driver controls slots on a PCI bus. A hot plug controller driver should be capable of controlling multiple hotplug buses.

These functions can be grouped as follows:

common hot plug controller driver functions:

hpci_attach(D3hpci)
hpci_confupdate(D3hpci)
hpci_detach(D3hpci)
hpci_postevent(D3hpci)

PCI configuration space access functions:

These functions are based on those documented in the PCI BIOS Specification, Revision 2.1, with the addition of rm_key_t hpci argument that represents the resource manager key for the instance of the hot plug bus controller. These functions are used for hot plug controller drivers only; standard DDI functions handle access to PCI config space for all other types of drivers.

pci_find_class_code(D3hpci)
pci_find_pci_device(D3hpci)
pci_generate_special_cycle(D3hpci)
pci_get_irq_routing_options(D3hpci)
pci_read(D3hpci)
pci_set_hw_interrupt(D3hpci)
pci_write(D3hpci)

References

Section D2hpci manual pages in Section D2hpci manual pages
Section D4hpci manual pages in Section D4hpci manual pages

``Hotplug devices'' in HDK Technical Reference
``PCI'' in HDK Technical Reference

PCI Special Interest Group, PCI BIOS Specification, Revision 2.1, August 26, 1994.