1.1 Overview

Introduction to the PCI Bus Binding

1

1.1 Overview

The UDI PCI Bus Binding specifies the usage details for the UDI Physical I/O Specification that are specific to the PCI Bus. This chapter defines general requirements for use of the UDI PCI Bus Binding Specification. The next chapter defines the specifics of the UDI PCI Bus Binding.

1.2 General Requirements

Certain basic rules apply to all UDI PCI drivers (for both bus bridges and adapters that use the PCI bus). In order to be UDI-compliant, such a driver must follow all of these rules. UDI PCI drivers must also follow the rules specified in the UDI Physical I/O Specification and the UDI Core Specification. Rules specific to PCI drivers are listed here.

Before including any UDI header files, the driver must define the preprocessor symbol, UDI_PCI_VERSION, to indicate the version of the UDI PCI Bus Binding Specification to which it conforms. For this version of the specification, UDI_PCI_VERSION must be set to 0x101:
#define UDI_PCI_VERSION 0x101
 
Each device driver source file must include the file "udi_pci.h" after it includes "udi.h" and "udi_physio.h", as follows:
#include <udi.h>
 
#include <udi_physio.h>
 
#include <udi_pci.h>
 
These header file contains environment-specific definitions of standard UDI structures and types, as well as all function prototypes and other definitions needed to use the core, physical I/O, and PCI bus UDI interfaces and services. Additional include files may be needed for other non-core services and metalanguages as defined in other UDI Specifications.

To maintain portability across UDI supportive platforms, device driver writers shall not assume any knowledge of the contents of these header files with respect to implementation-dependent aspects of the UDI interfaces (such as the definition of handles or abstract types). Similarly, drivers shall not access any functions or objects external to the driver except those defined in the UDI Specifications to which they conform.

1.3 Normative References

The UDI PCI Bus Binding Specification references the non-UDI standards listed below. These standards contain provisions that, through reference in this document, constitute provisions of the UDI PCI Bus Binding Specification.

PCI Local Bus Specification.