UEFI 2.0 驱动编写指南

5星 · 超过95%的资源需积分: 12 168 浏览量更新于2024-07-29 收藏 2.86MB PDF 举报

"UEFI2.0 Driver Writer's Guide 是一本针对UEFI 2.0驱动程序开发者的指导文档，由UEFI联盟于2007年4月10日发布，版本号为0.95。该文档在编写过程中得到了Hewlett-Packard公司的大力支持，他们基于其在EFI驱动开发、集成、验证和测试方面的经验，对内容做出了重大贡献。此外，Emulex和QLogic等公司的工程师也提供了输入和建议。文档明确指出，此规范‘按原样’提供，不包含任何明示或暗示的保证，包括但不限于对于商品性、非侵权、适用于特定目的的任何保证。英特尔公司在此明确否认所有责任，包括任何知识产权侵权的责任。" UEFI（统一可扩展固件接口）是一种现代BIOS的替代方案，它旨在提供更高效、更安全和更易扩展的系统启动和驱动程序加载机制。UEFI 2.0是该标准的一个版本，相比早期版本，它可能包含了更多的改进和功能增强。 UEFI驱动程序是操作系统与硬件之间的重要桥梁，它们负责初始化和管理硬件设备，使得操作系统能够正确识别和使用这些硬件。编写UEFI驱动程序的开发者需要了解UEFI的编程模型、固件接口以及相关的开发工具和调试技术。该指南可能会涵盖以下几个关键知识点： 1. **UEFI编程模型**：包括UEFI应用、驱动程序和服务，以及如何使用UEFI运行时服务和系统管理接口（SMM）。 2. **UEFI Boot Services**：这些服务在系统启动期间提供，如设备初始化、事件处理、内存分配等，对于驱动开发至关重要。 3. **PE/COFF格式**：UEFI驱动通常使用PE/COFF（Portable Executable/Code Object Format）格式，这是Windows系统中常见的可执行文件格式，但UEFI有其特定的扩展。 4. **UEFI表单界面**：UEFI支持图形化的用户交互，允许通过表单和控件配置系统设置。 5. **Driver Model**：UEFI 2.0可能包含了新的或改进的驱动模型，如EFI Driver Execution Environment (DXE)和Legacy Boot Support。 6. **Driver Signing**：为了确保系统的安全，UEFI要求驱动程序进行签名，以验证其来源和完整性。 7. **Debugging**：UEFI驱动的调试工具和方法，包括使用UEFI调试端口、EDK II Debugger等。 8. **Example Code**：文档可能包含示例代码，帮助开发者理解如何实现各种驱动功能。 9. **Integration and Testing**：整合驱动到UEFI环境的步骤，以及如何进行验证测试。开发者在遵循此指南编写UEFI驱动时，需要遵循UEFI规范，以确保驱动程序能够在不同UEFI实现的平台上正常工作。同时，由于文档明确指出不提供任何知识产权保证，开发者在实际操作时还需要注意可能涉及的法律问题，如确保代码的原创性或获取必要的授权。

Driver Writer’s Guide for UEFI 2.0 Draft for Review

xvi 2007.04.10 Version 0.95

Example 19. Goto Expressions .........................................................................73

Example 20. Protocol C File .............................................................................76

Example 21. Protocol Include File .....................................................................77

Example 22. GUID Include File.........................................................................78

Example 23. GUID C File.................................................................................78

Example 24. Including a Protocol or a GUID.......................................................79

Example 25. Driver Include File Template...........................................................83

Example 26. Driver Implementation Template.....................................................85

Example 27. Protocol Implementation Template ..................................................86

Example 28. Initializing the UEFI driver Library ...................................................87

Example 29. Allocate and Free Pool ...................................................................91

Example 30. Allocate and Free Pages .................................................................92

Example 31. Allocate and Free Buffer.................................................................93

Example 32. Allocate and Copy Buffer................................................................93

Example 33. Install Driver Protocols ..................................................................95

Example 34. Install I/O Protocols ......................................................................96

Example 35. Install Tag GUID...........................................................................97

Example 36. Locate All Handles.........................................................................98

Example 37. Locate Block I/O Protocol Handles ...................................................99

Example 38. Locate Decompress Protocol ......................................................... 100

Example 39. Open Protocol BY_DRIVER........................................................... 102

Example 40. Open Protocol by TEST_PROTOCOL............................................... 103

Example 41. Open Protocol by GET_PROTOCOL ................................................ 104

Example 42. Open Protocol BY_CHILD_CONTROLLER ........................................ 105

Example 43. Open Protocol Information .......................................................... 106

Example 44. Global Lock ............................................................................... 107

Example 45. Exit Boot Services Event ............................................................. 108

Example 46. Set Virtual Address Map Event ..................................................... 109

Example 47. Wait for Event ........................................................................... 111

Example 48. Wait for a One-Shot Timer Event.................................................. 112

Example 49. Reinstall Protocol Interface.......................................................... 114

Example 50. Locate Device Path..................................................................... 115

Example 51. Connect and Disconnect Controller ............................................... 116

Example 52. Disconnect Controller ................................................................. 117

Example 53. Reading and Writing Fixed-Size UEFI variables ............................... 119

Example 54. Reading and Writing Variable-Sized UEFI variables.......................... 120

Example 55. Install Configuration Table........................................................... 121

Example 56. Computing 32-bit CRC Values ...................................................... 122

Example 57. Validating 32-bit CRC Values ....................................................... 122

Example 58. Stall Loop ................................................................................. 128

Example 59. Stall Service.............................................................................. 129

Example 60. Starting a Periodic Timer............................................................. 131

Example 61. Arming a One-Shot Timer ........................................................... 132

Example 62. Stopping a Timer ....................................................................... 133

Example 63. Time and Date Services .............................................................. 133

Example 64. PCI Bus Walk Example................................................................. 148

Example 65. Generic Entry Point ..................................................................... 176

PRELIMINARY

Draft for Review Contents

Version 0.95 4/10/2007 xvii

Example 66. Driver Library Functions............................................................... 177

Example 67. Simple UEFI Driver Model Driver Entry Point ................................... 178

Example 68. Complex UEFI Driver Model Driver Entry Point................................. 179

Example 69. Multiple Driver Binding Protocols ................................................... 182

Example 70. Add the Unload Feature ............................................................... 185

Example 71. Unload Function.......................................................................... 187

Example 72. Adding the Exit Boot Services Feature............................................ 189

Example 73. Add the Unload and Exit Boot Services Event Feature....................... 191

Example 74. Initializing Driver Entry Point ........................................................ 191

Example 75. Service Driver Entry Point – Image Handle ..................................... 192

Example 76. Service Driver Entry Point – New Handle ........................................ 193

Example 77. Single PCI Root Bridge Driver Entry Point ....................................... 196

Example 78. Multiple PCI Root Bridge Driver Entry Point ..................................... 199

Example 79. Runtime Driver Entry Point........................................................... 202

Example 80. Runtime Driver Entry Point with Unload Feature .............................. 204

Example 81. Containing Record Macro Definitions .............................................. 206

Example 82. Private Context Data Structure Template........................................ 211

Example 83. Simple Private Context Data Structure ........................................... 211

Example 84. Complex Private Context Data Structure......................................... 212

Example 85. Allocation of a Private Context Data Structure ................................. 213

Example 86. Library Allocation of Private Context Data Structure ......................... 213

Example 87. Disk I/O Allocation of Private Context Data Structure ....................... 214

Example 88. Freeing a Private Context Data Structure........................................ 215

Example 89. Disk I/O Freeing of a Private Context Data Structure........................ 216

Example 90. Retrieving the Private Context Data Structure ................................. 217

Example 91. Retrieving the Disk I/O Private Context Data Structure..................... 217

Example 92. Driver Binding Protocol Declaration................................................ 220

Example 93. Driver Binding Protocol Template .................................................. 221

Example 94. UNDI Driver Binding Supported..................................................... 222

Example 95. AtapiPassThru Driver Binding Start ................................................ 223

Example 96. AtapiExtPassThru Driver Binding Stop ............................................ 224

Example 97. Driver Name Template................................................................. 230

Example 98. Device Driver with Static Controller Names ..................................... 233

Example 99. Private Context Data Structure with a Dynamic Controller Name Table 234

Example 100. Adding a Controller Name to a Dynamic Controller Name Table........ 235

Example 101. Freeing a Dynamic Controller Name Table..................................... 235

Example 102. Device Driver with Dynamic Controller Names ............................... 237

Example 103. Bus Driver with Static Controller and Child Names ......................... 240

Example 104. Bus Driver with Dynamic Child Names.......................................... 243

Example 105. Driver Configuration Protocol Template......................................... 247

Example 106. Retrieving the Private Context Data Structure ............................... 249

Example 107. Validating Options in SetOptions() ............................................... 251

Example 108. Retrieving the Private Context Data Structure ............................... 254

Example 109. Driver Diagnostics Protocol Template ........................................... 256

Example 110. Private Context for a Bus Specific Driver Override Protocol .............. 260

Example 111. GetDriver() Function of a Bus Specific Driver Override Protocol ........ 261

Example 112. AddDriver() Worker Function ...................................................... 262

PRELIMINARY

Driver Writer’s Guide for UEFI 2.0 Draft for Review

xviii 2007.04.10 Version 0.95

Example 113. Bus Specific Driver Override Protocol Constructor .......................... 263

Example 114. Supported() Service with Partial PCI Configuration Header .............. 270

Example 115. Supported() Service with Entire PCI Configuration Header............... 272

Example 116. Start() and Stop() for a 64-Bit DMA Capable PCI Controller ............. 273

Example 117. Start() and Stop() for a 32-Bit DMA Capable PCI Controller ............. 274

Example 118. Completing a Memory Write Transaction....................................... 279

Example 119. Accessing ISA Resources on a PCI Controller ................................. 280

Example 120. Locate PCI Handles with Matching Bus Number.............................. 282

Example 121. Map() Function ......................................................................... 284

Example 122. Completing a Bus Master Write Operation ..................................... 285

Example 123. Bus Master Read Operation......................................................... 289

Example 124. Bus Master Write Operation ........................................................ 293

Example 125. Setting up a Bus Master Common Buffer Operation ........................ 296

Example 126. Tearing Down a Bus Master Common Buffer Operation ................... 296

Example 127. Supported() Service for USB Host Controller Driver ........................ 302

Example 128. Turning off USB Legacy Support .................................................. 303

Example 129. Implementing the USB2 Host Controller Protocol ........................... 306

Example 130. Supported() Service of USB Device Driver..................................... 313

Example 131. Implementing a USB CBI Mass Storage Device Driver..................... 313

Example 132. Initiating an Asynchronous Interrupt Transfer in a USB Mouse Driver 314

Example 133. Completing an Asynchronous Interrupt Transfer ............................ 317

Example 134. Retrieving Pointer Movement ...................................................... 317

Example 135. SCSI Pass Thru Mode Structure on Single-Channel SCSI Adapter ..... 327

Example 136. SCSI Pass Thru Mode Structure on Multichannel SCSI Adapter......... 327

Example 137. SCSI Pass Thru Mode Structures on RAID SCSI Adapter.................. 327

Example 138. Ext SCSI Pass Thru Protocol Template.......................................... 330

Example 139. Building Device Path for ATAPI Device .......................................... 332

Example 140. Sample Non-blocking Ext SCSI Pass Thru Protocol Implementation... 335

Example 141. Blocking and Non-blocking Modes ................................................ 338

Example 142. SCSI Channel Enumeration......................................................... 340

Example 143. Start() with NII protocol version 3.1 ............................................ 348

Example 144. Reset() on ATAPI device............................................................. 362

Example 145. light reset of terminal driver ....................................................... 365

Example 146. Full reset of Terminal driver........................................................ 366

Example 147. CopyMem() and SetMem() Speed Optimizations ............................ 374

Example 148. Uses a loop to write to the frame buffer 8 bits at a time.................. 375

Example 149. Uses a loop to write to the frame buffer 32 bits at a time. ............... 375

Example 150. Does not use a loop and writes 8 bits at a time to frame buffer........ 375

Example 151. Does not use a loop and writes 32 bits at a time to frame buffer. ..... 376

Example 152. Speed Optimizations Using PCI I/O FIFO Operations....................... 377

Example 153. Scrolling the screen through a loop.............................................. 378

Example 154. Scrolling the screen without a loop .............................................. 378

Example 155. reading PCI configuration with a loop 8 bits at a time ..................... 379

Example 156. reading PCI configuration without a loop 8 bits at a time................. 379

Example 157. reading PCI configuration without a loop 32 bits at a time ............... 379

Example 158. Writing 1MB frame buffer with a loop 8 bits at a time ..................... 380

Example 159. Writing a 1MB frame buffer with a single call................................. 380

PRELIMINARY

Draft for Review Contents

Version 0.95 4/10/2007 xix

Example 160. Polling for 1 second through a loop .............................................. 381

Example 161. Polling for 1 second using polling function..................................... 381

Example 162 Producing both NII versions......................................................... 383

Example 163 Searching for newer and then older versions of a protocol................ 384

Example 164. Pointer-Cast Alignment Fault....................................................... 386

Example 165. Corrected Pointer-Cast Alignment Fault ........................................ 386

Example 166. Packed Structure Alignment Fault ............................................... 386

Example 167. Corrected Packed Structure Alignment Fault.................................. 387

Example 168. EFI Device Path Node Alignment Fault .......................................... 388

Example 169. Corrected EFI Device Path Node Alignment Fault............................ 388

Example 170. Accessing a 64-Bit BAR in a PCI Configuration Header .................... 389

Example 171. Assignment Operation Warnings.................................................. 390

Example 172. Comparison Operation Warnings ................................................. 391

Example 173. Casting Pointer Examples ........................................................... 393

Example 174. Negative Number Example ......................................................... 394

Example 175. Casting OUT Function Parameters................................................ 395

Example 176. Array Subscripts Example........................................................... 396

Example 177. Piecemeal Structure Allocation .................................................... 396

Example 178. Size of EBC Data Types.............................................................. 402

Example 179 Code that will fail in EBC ............................................................. 403

Example 180. Case Statements....................................................................... 403

Example 181. Stronger Type Checking ............................................................. 404

Example 182. Macro with data type ................................................................. 406

Example 183. Disk I/O Driver Files .................................................................. 407

Example 184. EBC Driver with Instruction set architecture-Specific Files ............... 408

Example 185 Disk I/O Driver Make.inf File ........................................................ 410

Example 186. EBC Driver Make.inf................................................................... 412

Example 187. Adding an UEFI driver to a Makefile ............................................. 416

Example 188. POST Code Examples................................................................. 431

Example 189. VGA Display Examples ............................................................... 432

Example 190. EFIROM Tool Examples .............................................................. 438

PRELIMINARY

剩余518页未读，继续阅读

p133_3322

粉丝: 1
资源: 7

UEFI 2.0 驱动编写指南

uefi 2.0 spec

Driver Writer’s Guide For UEFI 2.0

UEFI 2.0 Driver Writer’s Guide

Intel Driver Writer’s Guide For UEFI 2.0

UEFI Driver_Writer_Guide_V1.0.1_120308.pdf

Driver Writer’s Guide for UEFI 2.3.1

EFI 1.10 Driver Writer’s Guide

UEFI 2.0驱动开发指南

2020-UEFI docs packages-all.7z

edk2-UefiDriverWritersGuide:EDK II驱动程序编写者指南，用于UEFI驱动程序的开发

最新资源