VxBus
Device Driver Developer's Guide, 6.9
iv
3 Device Driver Fundamentals ..................................................................... 13
3.1 Introduction ...................................................................................................................... 13
3.2 Driver Classes ................................................................................................................. 14
3.2.1 General Classes .................................................................................................. 14
Serial Drivers .................................................................................................... 14
Storage Drivers ................................................................................................. 14
Network Interface Drivers .............................................................................. 15
Non-Volatile RAM Drivers ............................................................................. 15
Timer Drivers .................................................................................................... 16
DMA Controller Drivers ................................................................................. 16
Bus Controller Drivers ..................................................................................... 16
USB Drivers ....................................................................................................... 17
Interrupt Controller Drivers ........................................................................... 17
Multifunction Drivers ...................................................................................... 17
Remote Processing Element Drivers ............................................................. 18
Console Drivers ................................................................................................ 18
Resource Drivers .............................................................................................. 19
3.2.2 Other Classes .................................................................................................... 19
3.3 Driver Organization ....................................................................................................... 19
3.3.1 File Location ...................................................................................................... 20
Wind River Drivers ........................................................................................... 20
Third-Party Drivers .......................................................................................... 20
3.3.2 Sample Driver Files: wrsample ....................................................................... 20
3.3.3 Required Files ................................................................................................... 21
Driver Source File ............................................................................................. 21
Component Description File ........................................................................... 23
Driver Configuration Stub Files ..................................................................... 28
README File .................................................................................................... 30
Device Driver Makefiles .................................................................................. 31
3.4 VxBus Driver Methods .................................................................................................. 32
3.4.1 Representing Driver Methods in the Documentation ................................ 32
3.4.2 Parts of a Driver Method ................................................................................. 33
3.4.3 Calling Driver Methods ................................................................................... 33
3.4.4 Advertising Driver Methods .......................................................................... 34
3.4.5 Driver Method Limitations ............................................................................. 35
3.5 Driver Run-time Life Cycle .......................................................................................... 36
3.5.1 Driver Initialization Sequence ........................................................................ 36
Making Assumptions About Initialization Order ....................................... 36
Early in the Boot Process ................................................................................. 37
sysHwInit( ), PLB, and Hardware Discovery ............................................... 37
Driver Registration ........................................................................................... 38
Driver Initialization Phase 1 ........................................................................... 38
Kernel Startup ................................................................................................... 38