Tools/Source/TianoTools/Include/Protocol/CpuIo.h

   1 /** @file
   2   This code abstracts the CPU IO Protocol
   3
   4   Copyright (c) 2006, Intel Corporation
   5   All rights reserved. This program and the accompanying materials
   6   are licensed and made available under the terms and conditions of the BSD License
   7   which accompanies this distribution.  The full text of the license may be found at
   8   http://opensource.org/licenses/bsd-license.php
   9
  10   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  11   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  12
  13   Module Name:  CpuIO.h
  14
  15   @par Revision Reference:
  16   CPU IO Protocol is defined in Framework of EFI CPU IO Protocol Spec
  17   Version 0.9
  18
  19 **/
  20
  21 #ifndef _CPUIO_H_
  22 #define _CPUIO_H_
  23
  24 #define EFI_CPU_IO_PROTOCOL_GUID \
  25   { \
  26     0xB0732526, 0x38C8, 0x4b40, {0x88, 0x77, 0x61, 0xC7, 0xB0, 0x6A, 0xAC, 0x45 } \
  27   }
  28
  29 typedef struct _EFI_CPU_IO_PROTOCOL EFI_CPU_IO_PROTOCOL;
  30
  31 //
  32 // *******************************************************
  33 // EFI_CPU_IO_PROTOCOL_WIDTH
  34 // *******************************************************
  35 //
  36 typedef enum {
  37   EfiCpuIoWidthUint8,
  38   EfiCpuIoWidthUint16,
  39   EfiCpuIoWidthUint32,
  40   EfiCpuIoWidthUint64,
  41   EfiCpuIoWidthFifoUint8,
  42   EfiCpuIoWidthFifoUint16,
  43   EfiCpuIoWidthFifoUint32,
  44   EfiCpuIoWidthFifoUint64,
  45   EfiCpuIoWidthFillUint8,
  46   EfiCpuIoWidthFillUint16,
  47   EfiCpuIoWidthFillUint32,
  48   EfiCpuIoWidthFillUint64,
  49   EfiCpuIoWidthMaximum
  50 } EFI_CPU_IO_PROTOCOL_WIDTH;
  51
  52 //
  53 // *******************************************************
  54 // EFI_CPU_IO_PROTOCOL_IO_MEM
  55 // *******************************************************
  56 //
  57 /**
  58   Enables a driver to access memory-mapped registers in the EFI system memory space.
  59   Or, Enables a driver to access registers in the EFI CPU I/O space.
  60
  61   @param  This A pointer to the EFI_CPU_IO_PROTOCOL instance.
  62
  63   @param  Width Signifies the width of the I/O or Memory operation.
  64
  65   @param  Address The base address of the I/O or Memoryoperation.
  66
  67   @param  Count The number of I/O or Memory operations to perform.
  68   The number of bytes moved is Width size * Count, starting at Address.
  69
  70   @param  Buffer For read operations, the destination buffer to store the results.
  71   For write operations, the source buffer from which to write data.
  72
  73   @retval EFI_SUCCESS The data was read from or written to the EFI system.
  74
  75   @retval EFI_INVALID_PARAMETER Width is invalid for this EFI system.Or Buffer is NULL.
  76
  77   @retval EFI_UNSUPPORTED The Buffer is not aligned for the given Width.
  78   Or,The address range specified by Address, Width, and Count is not valid for this EFI system.
  79
  80 **/
  81 typedef
  82 EFI_STATUS
  83 (EFIAPI *EFI_CPU_IO_PROTOCOL_IO_MEM) (
  84   IN EFI_CPU_IO_PROTOCOL                *This,
  85   IN  EFI_CPU_IO_PROTOCOL_WIDTH         Width,
  86   IN  UINT64                            Address,
  87   IN  UINTN                             Count,
  88   IN  OUT VOID                          *Buffer
  89   );
  90
  91 //
  92 // *******************************************************
  93 // EFI_CPU_IO_PROTOCOL_ACCESS
  94 // *******************************************************
  95 //
  96 typedef struct {
  97   EFI_CPU_IO_PROTOCOL_IO_MEM  Read;
  98   EFI_CPU_IO_PROTOCOL_IO_MEM  Write;
  99 } EFI_CPU_IO_PROTOCOL_ACCESS;
 100
 101 //
 102 // *******************************************************
 103 // EFI_CPU_IO_PROTOCOL
 104 // *******************************************************
 105 //
 106 /**
 107   @par Protocol Description:
 108   Provides the basic memory and I/O interfaces that are used to abstract
 109   accesses to devices in a system.
 110
 111   @param Mem.Read
 112   Allows reads from memory-mapped I/O space.
 113
 114   @param Mem.Write
 115   Allows writes to memory-mapped I/O space.
 116
 117   @param Io.Read
 118   Allows reads from I/O space.
 119
 120   @param Io.Write
 121   Allows writes to I/O space.
 122
 123 **/
 124 struct _EFI_CPU_IO_PROTOCOL {
 125   EFI_CPU_IO_PROTOCOL_ACCESS  Mem;
 126   EFI_CPU_IO_PROTOCOL_ACCESS  Io;
 127 };
 128
 129 extern EFI_GUID gEfiCpuIoProtocolGuid;
 130
 131 #endif