Intel® Platform Controller Hub EG20T General Purpose Input Output (GPIO) Driver for Windows* Programmer’s Guide February 2011 Order Number: 324257-002US INFORMATIONLegal Lines and Disclaimers IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL’S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. UNLESS OTHERWISE AGREED IN WRITING BY INTEL, THE INTEL PRODUCTS ARE NOT DESIGNED NOR INTENDED FOR ANY APPLICATION IN WHICH THE FAILURE OF THE INTEL PRODUCT COULD CREATE A SITUATION WHERE PERSONAL INJURY OR DEATH MAY OCCUR. Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked “reserved” or “undefined.” Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information. The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request. Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order. Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548- 4725, or go to: http://www.intel.com/#/en_US_01. Any software source code reprinted in this document is furnished under a software license and may only be used or copied in accordance with the terms of that license. Intel processor numbers are not a measure of performance. Processor numbers differentiate features within each processor family, not across different processor families. Go to: http://www.intel.com/products/processor%5Fnumber/ for details. α Intel® Hyper-Threading Technology requires a computer system with a processor supporting Intel® HT Technology and an Intel® HT Technology- enabled chipset, BIOS and operating system. Performance will vary depending on the specific hardware and software you use. For more information including details on which processors support Intel® HT Technology, see http://www.intel.com/products/ht/hyperthreading_more.htm. β Intel® High Definition Audio requires a system with an appropriate Intel® chipset and a motherboard with an appropriate CODEC and the necessary drivers installed. System sound quality will vary depending on actual implementation, controller, CODEC, drivers and speakers. For more information about Intel® HD audio, refer to http://www.intel.com/. χ 64-bit computing on Intel® architecture requires a computer system with a processor, chipset, BIOS, operating system, device drivers and applications enabled for Intel® 64 architecture. Performance will vary depending on your hardware and software configurations. Consult with your system vendor for more information. δ Intel® Virtualization Technology requires a computer system with an enabled Intel® processor, BIOS, virtual machine monitor (VMM) and, for some uses, certain computer system software enabled for it. Functionality, performance or other benefits will vary depending on hardware and software configurations and may require a BIOS update. Software applications may not be compatible with all operating systems. Please check with your application vendor. ε The original equipment manufacturer must provide Intel® Trusted Platform Module (Intel® TPM) functionality, which requires an Intel® TPM-supported BIOS. Intel® TPM functionality must be initialized and may not be available in all countries. θ For Enhanced Intel SpeedStep® Technology, see the Processor Spec Finder or contact your Intel representative for more information. I2C* is a two-wire communications bus/protocol developed by Philips. SMBus is a subset of the I2C* bus/protocol and was developed by Intel. Implementations of the I2C* bus/protocol may require licenses from various entities, including Philips Electronics N.V. and North American Philips Corporation. BunnyPeople, Celeron, Celeron Inside, Centrino, Centrino Inside, Core Inside, i960, Intel, the Intel logo, Intel AppUp, Intel Atom, Intel Atom Inside, Intel Core, Intel Inside, the Intel Inside logo, Intel NetBurst, Intel NetMerge, Intel NetStructure, Intel SingleDriver, Intel SpeedStep, Intel Sponsors of Tomorrow., the Intel Sponsors of Tomorrow. logo, Intel StrataFlash, Intel Viiv, Intel vPro, Intel XScale, InTru, the InTru logo, InTru soundmark, Itanium, Itanium Inside, MCS, MMX, Moblin, Pentium, Pentium Inside, skoool, the skoool logo, Sound Mark, The Journey Inside, vPro Inside, VTune, Xeon, and Xeon Inside are trademarks of Intel Corporation in the U.S. and other countries. *Other names and brands may be claimed as the property of others. Copyright © 2011, Intel Corporation and/or its suppliers and licensors. All rights reserved. Intel® Platform Controller Hub EG20T GPIO Driver Programmer’s Guide February 2011 2 Order Number: 324257-002US Contents—Intel® Platform Controller Hub EG20T Contents 1.0 Introduction ..............................................................................................................5 2.0 Operating System (OS) Support ................................................................................6 3.0 Dependencies ............................................................................................................7 4.0 GPIO Driver API Details.............................................................................................8 4.1 Features ............................................................................................................8 4.2 Interface Details .................................................................................................8 4.3 IOCTL Usage Details ............................................................................................8 4.3.1 IOCTL_GPIO_ENABLE_INT.........................................................................8 4.3.2 IOCTL_GPIO_DISABLE_INT .......................................................................9 4.3.3 IOCTL_GPIO_DIRECTION ..........................................................................9 4.3.4 IOCTL_GPIO_READ................................................................................. 10 4.3.5 IOCTL_GPIO_WRITE ............................................................................... 11 4.3.6 IOCTL_GPIO_NOTIFY .............................................................................. 11 4.4 Structures, Enumerations and Macros .................................................................. 12 4.4.1 Structures ............................................................................................. 13 4.4.1.1 ioh_gpio_reqt........................................................................... 13 4.4.2 Enumerations ........................................................................................ 13 4.4.2.1 GPIO_SET_MODE...................................................................... 13 4.4.2.2 GPIO_SET_DIR......................................................................... 13 4.4.2.3 GPIO_SET_VALUE ..................................................................... 13 4.4.3 Macros.................................................................................................. 13 4.5 Error Handling .................................................................................................. 14 4.6 Inter-IOCTL dependencies .................................................................................. 14 5.0 Programming Guide................................................................................................. 15 5.1 Opening the Device ........................................................................................... 15 5.1.1 Using GUID Interface Exposed by the Driver .............................................. 15 5.2 Driver Configuration .......................................................................................... 15 5.3 Read/Write Operation ........................................................................................ 16 5.4 Close the Device ............................................................................................... 17 Tables 1 Supported IOCTLs......................................................................................................8 2 ioh_gpio_reqt structure ............................................................................................ 13 3 GPIO_SET_MODE enumeration .................................................................................. 13 4 GPIO_SET_DIR enumeration ..................................................................................... 13 5 GPIO_SET_ VALUE enumeration................................................................................. 13 6 Macros ..................................................................................................................