EmbeddedPkg/Universal/MmcDxe/MmcDebug.c

   1 /** @file
   2 *
   3 *  Copyright (c) 2011-2013, ARM Limited. All rights reserved.
   4 *
   5 *  SPDX-License-Identifier: BSD-2-Clause-Patent
   6 *
   7 **/
   8
   9 #include "Mmc.h"
  10
  11 #if !defined(MDEPKG_NDEBUG)
  12 CONST CHAR8* mStrUnit[] = { "100kbit/s", "1Mbit/s", "10Mbit/s", "100MBit/s",
  13                             "Unknown", "Unknown", "Unknown", "Unknown" };
  14 CONST CHAR8* mStrValue[] = { "1.0", "1.2", "1.3", "1.5", "2.0", "2.5", "3.0", "3.5", "4.0", "4.5", "5.0",
  15                              "Unknown", "Unknown", "Unknown", "Unknown" };
  16 #endif
  17
  18 VOID
  19 PrintCID (
  20   IN UINT32* Cid
  21   )
  22 {
  23   DEBUG ((EFI_D_ERROR, "- PrintCID\n"));
  24   DEBUG ((EFI_D_ERROR, "\t- Manufacturing date: %d/%d\n", (Cid[0] >> 8) & 0xF, (Cid[0] >> 12) & 0xFF));
  25   DEBUG ((EFI_D_ERROR, "\t- Product serial number: 0x%X%X\n", Cid[1] & 0xFFFFFF, (Cid[0] >> 24) & 0xFF));
  26   DEBUG ((EFI_D_ERROR, "\t- Product revision: %d\n", Cid[1] >> 24));
  27   //DEBUG ((EFI_D_ERROR, "\t- Product name: %s\n", (char*)(Cid + 2)));
  28   DEBUG ((EFI_D_ERROR, "\t- OEM ID: %c%c\n", (Cid[3] >> 8) & 0xFF, (Cid[3] >> 16) & 0xFF));
  29 }
  30
  31
  32 VOID
  33 PrintCSD (
  34   IN UINT32* Csd
  35   )
  36 {
  37   UINTN Value;
  38
  39   if (((Csd[2] >> 30) & 0x3) == 0) {
  40     DEBUG ((EFI_D_ERROR, "- PrintCSD Version 1.01-1.10/Version 2.00/Standard Capacity\n"));
  41   } else if (((Csd[2] >> 30) & 0x3) == 1) {
  42     DEBUG ((EFI_D_ERROR, "- PrintCSD Version 2.00/High Capacity\n"));
  43   } else {
  44     DEBUG ((EFI_D_ERROR, "- PrintCSD Version Higher than v3.3\n"));
  45   }
  46
  47   DEBUG ((EFI_D_ERROR, "\t- Supported card command class: 0x%X\n", MMC_CSD_GET_CCC (Csd)));
  48   DEBUG ((EFI_D_ERROR, "\t- Speed: %a %a\n",mStrValue[(MMC_CSD_GET_TRANSPEED (Csd) >> 3) & 0xF],mStrUnit[MMC_CSD_GET_TRANSPEED (Csd) & 7]));
  49   DEBUG ((EFI_D_ERROR, "\t- Maximum Read Data Block: %d\n",2 << (MMC_CSD_GET_READBLLEN (Csd)-1)));
  50   DEBUG ((EFI_D_ERROR, "\t- Maximum Write Data Block: %d\n",2 << (MMC_CSD_GET_WRITEBLLEN (Csd)-1)));
  51
  52   if (!MMC_CSD_GET_FILEFORMATGRP (Csd)) {
  53     Value = MMC_CSD_GET_FILEFORMAT (Csd);
  54     if (Value == 0) {
  55       DEBUG ((EFI_D_ERROR, "\t- Format (0): Hard disk-like file system with partition table\n"));
  56     } else if (Value == 1) {
  57       DEBUG ((EFI_D_ERROR, "\t- Format (1): DOS FAT (floppy-like) with boot sector only (no partition table)\n"));
  58     } else if (Value == 2) {
  59       DEBUG ((EFI_D_ERROR, "\t- Format (2): Universal File Format\n"));
  60     } else {
  61       DEBUG ((EFI_D_ERROR, "\t- Format (3): Others/Unknown\n"));
  62     }
  63   } else {
  64     DEBUG ((EFI_D_ERROR, "\t- Format: Reserved\n"));
  65   }
  66 }
  67
  68 VOID
  69 PrintRCA (
  70   IN UINT32 Rca
  71   )
  72 {
  73   DEBUG ((EFI_D_ERROR, "- PrintRCA: 0x%X\n", Rca));
  74   DEBUG ((EFI_D_ERROR, "\t- Status: 0x%X\n", Rca & 0xFFFF));
  75   DEBUG ((EFI_D_ERROR, "\t- RCA: 0x%X\n", (Rca >> 16) & 0xFFFF));
  76 }
  77
  78 VOID
  79 PrintOCR (
  80   IN UINT32 Ocr
  81   )
  82 {
  83   UINTN MinV;
  84   UINTN MaxV;
  85   UINTN Volts;
  86   UINTN Loop;
  87
  88   MinV  = 36;  // 3.6
  89   MaxV  = 20;  // 2.0
  90   Volts = 20;  // 2.0
  91
  92   // The MMC register bits [23:8] indicate the working range of the card
  93   for (Loop = 8; Loop < 24; Loop++) {
  94     if (Ocr & (1 << Loop)) {
  95       if (MinV > Volts) {
  96         MinV = Volts;
  97       }
  98       if (MaxV < Volts) {
  99         MaxV = Volts + 1;
 100       }
 101     }
 102     Volts++;
 103   }
 104
 105   DEBUG ((EFI_D_ERROR, "- PrintOCR Ocr (0x%X)\n",Ocr));
 106   DEBUG ((EFI_D_ERROR, "\t- Card operating voltage: %d.%d to %d.%d\n", MinV/10, MinV % 10, MaxV/10, MaxV % 10));
 107   if (((Ocr >> 29) & 3) == 0) {
 108     DEBUG ((EFI_D_ERROR, "\t- AccessMode: Byte Mode\n"));
 109   } else {
 110     DEBUG ((EFI_D_ERROR, "\t- AccessMode: Block Mode (0x%X)\n", ((Ocr >> 29) & 3)));
 111   }
 112
 113   if (Ocr & MMC_OCR_POWERUP) {
 114     DEBUG ((EFI_D_ERROR, "\t- PowerUp\n"));
 115   } else {
 116     DEBUG ((EFI_D_ERROR, "\t- Voltage Not Supported\n"));
 117   }
 118 }
 119
 120 VOID
 121 PrintResponseR1 (
 122   IN  UINT32 Response
 123   )
 124 {
 125   DEBUG ((EFI_D_INFO, "Response: 0x%X\n", Response));
 126   if (Response & MMC_R0_READY_FOR_DATA) {
 127     DEBUG ((EFI_D_INFO, "\t- READY_FOR_DATA\n"));
 128   }
 129
 130   switch ((Response >> 9) & 0xF) {
 131   case 0:
 132     DEBUG ((EFI_D_INFO, "\t- State: Idle\n"));
 133     break;
 134   case 1:
 135     DEBUG ((EFI_D_INFO, "\t- State: Ready\n"));
 136     break;
 137   case 2:
 138     DEBUG ((EFI_D_INFO, "\t- State: Ident\n"));
 139     break;
 140   case 3:
 141     DEBUG ((EFI_D_INFO, "\t- State: StandBy\n"));
 142     break;
 143   case 4:
 144     DEBUG ((EFI_D_INFO, "\t- State: Tran\n"));
 145     break;
 146   case 5:
 147     DEBUG ((EFI_D_INFO, "\t- State: Data\n"));
 148     break;
 149   case 6:
 150     DEBUG ((EFI_D_INFO, "\t- State: Rcv\n"));
 151     break;
 152   case 7:
 153     DEBUG ((EFI_D_INFO, "\t- State: Prg\n"));
 154     break;
 155   case 8:
 156     DEBUG ((EFI_D_INFO, "\t- State: Dis\n"));
 157     break;
 158   default:
 159     DEBUG ((EFI_D_INFO, "\t- State: Reserved\n"));
 160     break;
 161   }
 162 }