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