WinDriver™ PCI/ISA User's Manual Jungo Connectivity Ltd. Version 12.5.0 WinDriver™ PCI/ISA User's Manual Copyright © 2017 Jungo Connectivity Ltd. All Rights Reserved Information in this document is subject to change without notice. The software described in this document is furnished under a license agreement. The software may be used, copied or distributed only in accordance with that agreement. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or any means, electronically or mechanically, including photocopying and recording for any purpose without the written permission of Jungo Connectivity Ltd. Brand and product names mentioned in this document are trademarks of their respective owners and are used here only for identification purposes. © 2017 Jungo Connectivity Ltd. ii CONFIDENTIAL Table of Contents 1. WinDriver Overview .................................................................................................................. 1 1.1. Introduction to WinDriver ............................................................................................... 1 1.2. Background ...................................................................................................................... 2 1.2.1. The Challenge ....................................................................................................... 2 1.2.2. The WinDriver Solution ....................................................................................... 2 1.3. How Fast Can WinDriver Go? ........................................................................................ 3 1.4. Conclusion ....................................................................................................................... 3 1.5. WinDriver Benefits .......................................................................................................... 3 1.6. WinDriver Architecture ................................................................................................... 5 1.7. What Platforms Does WinDriver Support? ..................................................................... 6 1.8. Limitations of the Different Evaluation Versions ........................................................... 6 1.9. How Do I Develop My Driver with WinDriver? ............................................................ 7 1.9.1. On Windows and Linux ....................................................................................... 7 1.9.2. On Windows CE ................................................................................................... 7 1.10. What Does the WinDriver Toolkit Include? ................................................................. 8 1.10.1. WinDriver Modules ............................................................................................ 8 1.10.2. Utilities ................................................................................................................ 9 1.10.3. Samples and Enhanced-Support Chipset APIs ................................................... 9 1.10.3.1. Enhanced Chipset Support ....................................................................... 9 1.11. Can I Distribute the Driver Created with WinDriver? ................................................ 10 2. Understanding Device Drivers ................................................................................................. 11 2.1. Device Driver Overview ................................................................................................ 11 2.2. Classification of Drivers According to Functionality ................................................... 11 2.2.1. Monolithic Drivers .............................................................................................. 11 2.2.2. Layered Drivers .................................................................................................. 12 2.2.3. Miniport Drivers ................................................................................................. 13 2.3. Classification of Drivers According to Operating Systems .......................................... 14 2.3.1. WDM Drivers ..................................................................................................... 14 2.3.2. Unix Device Drivers ........................................................................................... 15 2.3.3. Linux Device Drivers ......................................................................................... 15 2.4. The Entry Point of the Driver ....................................................................................... 15 2.5. Associating the Hardware with the Driver .................................................................... 16 2.6. Communicating with Drivers ........................................................................................ 16 3. Installing WinDriver ................................................................................................................. 17 3.1. System Requirements .................................................................................................... 17 3.1.1. Windows System Requirements ......................................................................... 17 3.1.2. Windows CE System Requirements ................................................................... 18 3.1.3. Linux System Requirements ............................................................................... 19 3.2. WinDriver Installation Process ...................................................................................... 19 3.2.1. Windows WinDriver Installation Instructions .................................................... 19 3.2.2. Windows CE WinDriver Installation Instructions .............................................. 20 3.2.2.1. Installing WinDriver CE when Building New CE-Based Platforms ........ 20 3.2.2.2. Installing WinDriver CE when Developing Applications for Windows CE Computers ....................................................................................................... 22 3.2.2.3. Windows CE Installation Note ................................................................ 23 3.2.3. Linux WinDriver Installation Instructions .......................................................... 23 © 2017 Jungo Connectivity Ltd. iii CONFIDENTIAL Table of Contents 3.2.3.1. Preparing the System for Installation ...................................................... 23 3.2.3.2. Installation ................................................................................................ 24 3.2.3.3. Restricting Hardware Access on Linux ................................................... 26 3.3. Upgrading Your Installation .......................................................................................... 26 3.4. Checking Your Installation ............................................................................................ 27 3.4.1. Windows and Linux Installation Check ............................................................. 27 3.4.2. Windows CE Installation Check ........................................................................ 27 3.5. Uninstalling WinDriver ................................................................................................. 28 3.5.1. Windows WinDriver Uninstall Instructions ....................................................... 28 3.5.2. Linux WinDriver Uninstall Instructions ............................................................. 30 4. Using DriverWizard .................................................................................................................. 31 4.1. An Overview .................................................................................................................. 31 4.2. DriverWizard Walkthrough ........................................................................................... 32 4.2.1. Automatic Code Generation ............................................................................... 39 4.2.1.1. Generating the Code ................................................................................ 39 4.2.1.2. The Generated PCI/ISA C Code ............................................................. 39 4.2.2. Compiling the Generated Code .......................................................................... 40 4.2.2.1. Windows and Windows CE Compilation ................................................ 40 4.2.2.2. Linux Compilation ................................................................................... 41 5. Developing a Driver ................................................................................................................. 42 5.1. Using DriverWizard to Build a Device Driver ............................................................. 42 5.2. Writing the Device Driver Without DriverWizard ........................................................ 43 5.2.1. Include the Required WinDriver Files ............................................................... 43 5.2.2. Write Your Code ................................................................................................ 44 5.2.3. Configure and Build Your Code ........................................................................ 45 5.3. Developing Your Driver on Windows CE Platforms .................................................... 45 6. Debugging Drivers .................................................................................................................... 46 6.1. User-Mode