Omap35xxPkg/MMCHSDxe/MMCHS.h

   1 /** @file
   2
   3   Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
   4
   5   SPDX-License-Identifier: BSD-2-Clause-Patent
   6
   7 **/
   8
   9 #ifndef _MMCHS_H_
  10 #define _MMCHS_H_
  11
  12 #include <Uefi.h>
  13
  14 #include <Library/BaseLib.h>
  15 #include <Library/MemoryAllocationLib.h>
  16 #include <Library/DebugLib.h>
  17 #include <Library/IoLib.h>
  18 #include <Library/PcdLib.h>
  19 #include <Library/UefiBootServicesTableLib.h>
  20 #include <Library/BaseMemoryLib.h>
  21 #include <Library/OmapLib.h>
  22 #include <Library/OmapDmaLib.h>
  23 #include <Library/DmaLib.h>
  24
  25 #include <Protocol/EmbeddedExternalDevice.h>
  26 #include <Protocol/BlockIo.h>
  27 #include <Protocol/DevicePath.h>
  28
  29 #include <Omap3530/Omap3530.h>
  30 #include <TPS65950.h>
  31
  32 #define MAX_RETRY_COUNT  (100*5)
  33
  34 #define HCS               BIT30 //Host capacity support/1 = Supporting high capacity
  35 #define CCS               BIT30 //Card capacity status/1 = High capacity card
  36 typedef struct {
  37   UINT32  Reserved0:   7; // 0
  38   UINT32  V170_V195:   1; // 1.70V - 1.95V
  39   UINT32  V200_V260:   7; // 2.00V - 2.60V
  40   UINT32  V270_V360:   9; // 2.70V - 3.60V
  41   UINT32  RESERVED_1:  5; // Reserved
  42   UINT32  AccessMode:  2; // 00b (byte mode), 10b (sector mode)
  43   UINT32  Busy:        1; // This bit is set to LOW if the card has not finished the power up routine
  44 }OCR;
  45
  46 typedef struct {
  47   UINT32  NOT_USED;   // 1 [0:0]
  48   UINT32  CRC;        // CRC7 checksum [7:1]
  49   UINT32  MDT;        // Manufacturing date [19:8]
  50   UINT32  RESERVED_1; // Reserved [23:20]
  51   UINT32  PSN;        // Product serial number [55:24]
  52   UINT8   PRV;        // Product revision [63:56]
  53   UINT8   PNM[5];     // Product name [64:103]
  54   UINT16  OID;        // OEM/Application ID [119:104]
  55   UINT8   MID;        // Manufacturer ID [127:120]
  56 }CID;
  57
  58 typedef struct {
  59   UINT8   NOT_USED:           1; // Not used, always 1 [0:0]
  60   UINT8   CRC:                7; // CRC [7:1]
  61
  62   UINT8   RESERVED_1:         2; // Reserved [9:8]
  63   UINT8   FILE_FORMAT:        2; // File format [11:10]
  64   UINT8   TMP_WRITE_PROTECT:  1; // Temporary write protection [12:12]
  65   UINT8   PERM_WRITE_PROTECT: 1; // Permanent write protection [13:13]
  66   UINT8   COPY:               1; // Copy flag (OTP) [14:14]
  67   UINT8   FILE_FORMAT_GRP:    1; // File format group [15:15]
  68
  69   UINT16  RESERVED_2:         5; // Reserved [20:16]
  70   UINT16  WRITE_BL_PARTIAL:   1; // Partial blocks for write allowed [21:21]
  71   UINT16  WRITE_BL_LEN:       4; // Max. write data block length [25:22]
  72   UINT16  R2W_FACTOR:         3; // Write speed factor [28:26]
  73   UINT16  RESERVED_3:         2; // Reserved [30:29]
  74   UINT16  WP_GRP_ENABLE:      1; // Write protect group enable [31:31]
  75
  76   UINT32  WP_GRP_SIZE:        7; // Write protect group size [38:32]
  77   UINT32  SECTOR_SIZE:        7; // Erase sector size [45:39]
  78   UINT32  ERASE_BLK_EN:       1; // Erase single block enable [46:46]
  79   UINT32  C_SIZE_MULT:        3; // Device size multiplier [49:47]
  80   UINT32  VDD_W_CURR_MAX:     3; // Max. write current @ VDD max [52:50]
  81   UINT32  VDD_W_CURR_MIN:     3; // Max. write current @ VDD min [55:53]
  82   UINT32  VDD_R_CURR_MAX:     3; // Max. read current @ VDD max [58:56]
  83   UINT32  VDD_R_CURR_MIN:     3; // Max. read current @ VDD min [61:59]
  84   UINT32  C_SIZELow2:         2; // Device size [63:62]
  85
  86   UINT32  C_SIZEHigh10:       10;// Device size [73:64]
  87   UINT32  RESERVED_4:         2; // Reserved [75:74]
  88   UINT32  DSR_IMP:            1; // DSR implemented [76:76]
  89   UINT32  READ_BLK_MISALIGN:  1; // Read block misalignment [77:77]
  90   UINT32  WRITE_BLK_MISALIGN: 1; // Write block misalignment [78:78]
  91   UINT32  READ_BL_PARTIAL:    1; // Partial blocks for read allowed [79:79]
  92   UINT32  READ_BL_LEN:        4; // Max. read data block length [83:80]
  93   UINT32  CCC:                12;// Card command classes [95:84]
  94
  95   UINT8   TRAN_SPEED          ;  // Max. bus clock frequency [103:96]
  96   UINT8   NSAC                ;  // Data read access-time 2 in CLK cycles (NSAC*100) [111:104]
  97   UINT8   TAAC                ;  // Data read access-time 1 [119:112]
  98
  99   UINT8   RESERVED_5:         6; // Reserved [125:120]
 100   UINT8   CSD_STRUCTURE:      2; // CSD structure [127:126]
 101 }CSD;
 102
 103 typedef struct {
 104   UINT8   NOT_USED:           1; // Not used, always 1 [0:0]
 105   UINT8   CRC:                7; // CRC [7:1]
 106   UINT8   RESERVED_1:         2; // Reserved [9:8]
 107   UINT8   FILE_FORMAT:        2; // File format [11:10]
 108   UINT8   TMP_WRITE_PROTECT:  1; // Temporary write protection [12:12]
 109   UINT8   PERM_WRITE_PROTECT: 1; // Permanent write protection [13:13]
 110   UINT8   COPY:               1; // Copy flag (OTP) [14:14]
 111   UINT8   FILE_FORMAT_GRP:    1; // File format group [15:15]
 112   UINT16  RESERVED_2:         5; // Reserved [20:16]
 113   UINT16  WRITE_BL_PARTIAL:   1; // Partial blocks for write allowed [21:21]
 114   UINT16  WRITE_BL_LEN:       4; // Max. write data block length [25:22]
 115   UINT16  R2W_FACTOR:         3; // Write speed factor [28:26]
 116   UINT16  RESERVED_3:         2; // Reserved [30:29]
 117   UINT16  WP_GRP_ENABLE:      1; // Write protect group enable [31:31]
 118   UINT16  WP_GRP_SIZE:        7; // Write protect group size [38:32]
 119   UINT16  SECTOR_SIZE:        7; // Erase sector size [45:39]
 120   UINT16  ERASE_BLK_EN:       1; // Erase single block enable [46:46]
 121   UINT16  RESERVED_4:         1; // Reserved [47:47]
 122   UINT32  C_SIZELow16:        16;// Device size [69:48]
 123   UINT32  C_SIZEHigh6:        6; // Device size [69:48]
 124   UINT32  RESERVED_5:         6; // Reserved [75:70]
 125   UINT32  DSR_IMP:            1; // DSR implemented [76:76]
 126   UINT32  READ_BLK_MISALIGN:  1; // Read block misalignment [77:77]
 127   UINT32  WRITE_BLK_MISALIGN: 1; // Write block misalignment [78:78]
 128   UINT32  READ_BL_PARTIAL:    1; // Partial blocks for read allowed [79:79]
 129   UINT16  READ_BL_LEN:        4; // Max. read data block length [83:80]
 130   UINT16  CCC:                12;// Card command classes [95:84]
 131   UINT8   TRAN_SPEED          ;  // Max. bus clock frequency [103:96]
 132   UINT8   NSAC                ;  // Data read access-time 2 in CLK cycles (NSAC*100) [111:104]
 133   UINT8   TAAC                ;  // Data read access-time 1 [119:112]
 134   UINT8   RESERVED_6:         6; // 0 [125:120]
 135   UINT8   CSD_STRUCTURE:      2; // CSD structure [127:126]
 136 }CSD_SDV2;
 137
 138 typedef enum {
 139   UNKNOWN_CARD,
 140   MMC_CARD,              //MMC card
 141   SD_CARD,               //SD 1.1 card
 142   SD_CARD_2,             //SD 2.0 or above standard card
 143   SD_CARD_2_HIGH         //SD 2.0 or above high capacity card
 144 } CARD_TYPE;
 145
 146 typedef enum {
 147   READ,
 148   WRITE
 149 } OPERATION_TYPE;
 150
 151 typedef struct  {
 152   UINT16    RCA;
 153   UINTN     BlockSize;
 154   UINTN     NumBlocks;
 155   UINTN     ClockFrequencySelect;
 156   CARD_TYPE CardType;
 157   OCR       OCRData;
 158   CID       CIDData;
 159   CSD       CSDData;
 160 } CARD_INFO;
 161
 162 EFI_STATUS
 163 DetectCard (
 164   VOID
 165   );
 166
 167 extern EFI_BLOCK_IO_PROTOCOL gBlockIo;
 168
 169 #endif