Table of Contents

Title and Copyright Pages

About This Book
Audience
New and Changed Features
Scope of the Book
Organization
Related Documentation
Reader's Comments
Conventions

1    Review of Device Driver Concepts
1.1    Gathering Information
1.2    Designing a Device Driver
1.3    Allocating Data Structures
1.4    Writing Portable Device Drivers
1.5    Reviewing the Device Driver Kits Delivery Process
1.6    Identifying the Method for Registering Device Interrupt Handlers
1.7    VMEbus Porting Information

2    VMEbus Architectures
2.1    VMEbus Hardware Architecture
2.1.1    Address Spaces
2.1.2    Data Sizes
2.1.3    Byte Ordering
2.1.4    Interrupt Vectors
2.1.5    Interrupt Priorities
2.2    VMEbus Software Architecture
2.2.1    VMEbus Address Space
2.2.2    Direct Memory Access Support
2.2.2.1    VMEbus-to-Host DMA
2.2.2.2    VMEbus Device-to-Device DMA
2.2.2.3    Rules for Performing DMA on Multiple VMEbus Adapters
2.2.3    I/O Access
2.2.4    Writes to the Hardware Device Register

3    Structure of a VMEbus Device Driver
3.1    Include Files Section
3.2    Configure Section
3.3    Autoconfiguration Support Section
3.3.1    Setting Up a probe Interface
3.3.2    Setting Up the slave Interface
3.3.3    Setting Up a Controller attach Interface
3.3.4    Setting Up a Controller unattach Interface

4    Data Structures That VMEbus Device Drivers Use
4.1    The controller Structure Members Specific to the VMEbus
4.2    The driver Structure Members Specific to the VMEbus
4.3    The VBA_Option VMEbus Configuration Structure
4.3.1    Example: dmaex Driver Configuration
4.3.2    Example: vb Driver Configuration

5    Kernel Interfaces That VMEbus Device Drivers Use
5.1    Allocating Resources for Direct Memory Access Data Transfers
5.2    Unloading System Direct Memory Access Resources
5.3    Obtaining the VMEbus Address
5.4    Reading and Writing Data from a Device Register
5.5    Using Events to Synchronize Driver Actions
5.5.1    Initializing an Event
5.5.2    Clearing an Event
5.5.3    Waiting For an Event
5.5.4    Posting an Event
5.5.5    Terminating an Event
5.6    Passing Mechanism for the busphys_to_iohandle Interface.

6    VMEbus Device Driver Example
6.1    Device Register Header File dmaexreg.h
6.2    Include Files Section
6.3    Declarations Section
6.4    Configure Section
6.4.1    Providing Declarations Required for Configuration
6.4.2    Implementing the dmaex_configure Interface
6.4.2.1    Implementing register_configuration
6.4.2.2    Implementing register_major_number
6.4.2.3    Implementing callback_register_configuration
6.4.2.4    Implementing callback_register_major_number
6.5    Autoconfiguration Support Section
6.5.1    Implementing the dmaex_probe Interface
6.5.2    Implementing the dmaex_cattach Interface
6.5.3    Implementing the dmaex_ctlr_unattach Interface
6.6    Open and Close Device Section
6.6.1    Implementing the dmaex_open Interface
6.6.2    Implementing the dmaex_close Interface
6.7    Memory Map (mmap) Section
6.8    Driver-Specific ioctl Section
6.8.1    Implementing a dmaex_setup_blk_mode Interface
6.8.2    Implementing the dmaex_ioctl Interface
6.8.2.1    Implementing SET_MMAP_MODE
6.8.2.2    Implementing GET_MMAP_MODE
6.8.2.3    Implementing SET_STRATEGY_XFER_MODE
6.8.2.4    Implementing GET_STRATEGY_XFER_MODE
6.8.2.5    Implementing SETUP_VME_FOR_MMAP_PIO
6.8.2.6    Implementing GET_VME_INFO_FOR_MMAP_PIO
6.8.2.7    Implementing UNMAP_VME_FOR_MMAP_PIO
6.8.2.8    Implementing SET_STRATEGY_INFO_BLK_DMA
6.8.2.9    Implementing GET_STRATEGY_INFO_BLK_DMA
6.8.2.10    Implementing CLR_STRATEGY_INFO_BLK_DMA
6.8.2.11    Implementing SETUP_VME_FOR_STRATEGY_PIO
6.8.2.12    Implementing GET_VME_INFO_FOR_STRATEGY_PIO
6.8.2.13    Implementing UNMAP_VME_FOR_STRATEGY_PIO
6.8.2.14    Implementing MAP_SYS_MEM_TO_VME
6.8.2.15    Implementing GET_SYS_MEM_INFO
6.8.2.16    Implementing UNMAP_SYS_MEM_TO_VME
6.8.2.17    Implementing SETUP_DMA_BLK_WRT
6.8.2.18    Implementing GET_DMA_BLK_WRT
6.8.2.19    Implementing DO_DMA_BLK_WRT
6.8.2.20    Implementing CLR_DMA_BLK_WRT
6.8.2.21    Implementing SETUP_DMA_BLK_RD
6.8.2.22    Implementing GET_DMA_BLK_RD
6.8.2.23    Implementing DO_DMA_BLK_RD
6.8.2.24    Implementing CLR_DMA_BLK_RD
6.8.2.25    Implementing SET_INT_HANDLER
6.8.2.26    Implementing CLR_INT_HANDLER
6.8.2.27    Implementing VME_POST_IRQ
6.8.2.28    Implementing VME_CLR_IRQ
6.9    Read and Write Device Section
6.9.1    Implementing the dmaex_read Interface
6.9.2    Implementing the dmaex_write Interface
6.9.3    Implementing the dmaex_minphys Interface
6.10    Strategy Section
6.10.1    Implementing PIO Transfer Mode
6.10.2    Implementing Device DMA Transfer Mode
6.10.3    Implementing Block DMA Transfer Mode
6.11    Interrupt Sections

7    Using VMEbus Device Drivers

A    VMEbus-Specific Reference Information
A.1    Conventions for Reference Pages
A.1.1    Conventions for Header File
A.1.2    Conventions for Kernel Interfaces
A.1.3    Conventions for Data Structures
A.1.4    Conventions for Device Driver Interfaces
A.2    Header File

vbareg.h