Rev 248 | Blame | Last modification | View Log | RSS feed
// ***********************************************************// File: mmc.c// Description: Library to access a MultiMediaCard// functions: init, read, write ...// C. Speck / S. Schauer// Texas Instruments, Inc// June 2005//// Version 1.1// corrected comments about connection the MMC to the MSP430// increased timeout in mmcGetXXResponse//// ***********************************************************// MMC Lib// ***********************************************************/* ************************************************************ THIS PROGRAM IS PROVIDED "AS IS". TI MAKES NO WARRANTIES OR* REPRESENTATIONS, EITHER EXPRESS, IMPLIED OR STATUTORY,* INCLUDING ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS* FOR A PARTICULAR PURPOSE, LACK OF VIRUSES, ACCURACY OR* COMPLETENESS OF RESPONSES, RESULTS AND LACK OF NEGLIGENCE.* TI DISCLAIMS ANY WARRANTY OF TITLE, QUIET ENJOYMENT, QUIET* POSSESSION, AND NON-INFRINGEMENT OF ANY THIRD PARTY* INTELLECTUAL PROPERTY RIGHTS WITH REGARD TO THE PROGRAM OR* YOUR USE OF THE PROGRAM.** IN NO EVENT SHALL TI BE LIABLE FOR ANY SPECIAL, INCIDENTAL,* CONSEQUENTIAL OR INDIRECT DAMAGES, HOWEVER CAUSED, ON ANY* THEORY OF LIABILITY AND WHETHER OR NOT TI HAS BEEN ADVISED* OF THE POSSIBILITY OF SUCH DAMAGES, ARISING IN ANY WAY OUT* OF THIS AGREEMENT, THE PROGRAM, OR YOUR USE OF THE PROGRAM.* EXCLUDED DAMAGES INCLUDE, BUT ARE NOT LIMITED TO, COST OF* REMOVAL OR REINSTALLATION, COMPUTER TIME, LABOR COSTS, LOSS* OF GOODWILL, LOSS OF PROFITS, LOSS OF SAVINGS, OR LOSS OF* USE OR INTERRUPTION OF BUSINESS. IN NO EVENT WILL TI'S* AGGREGATE LIABILITY UNDER THIS AGREEMENT OR ARISING OUT OF* YOUR USE OF THE PROGRAM EXCEED FIVE HUNDRED DOLLARS* (U.S.$500).** Unless otherwise stated, the Program written and copyrighted* by Texas Instruments is distributed as "freeware". You may,* only under TI's copyright in the Program, use and modify the* Program without any charge or restriction. You may* distribute to third parties, provided that you transfer a* copy of this license to the third party and the third party* agrees to these terms by its first use of the Program. You* must reproduce the copyright notice and any other legend of* ownership on each copy or partial copy, of the Program.** You acknowledge and agree that the Program contains* copyrighted material, trade secrets and other TI proprietary* information and is protected by copyright laws,* international copyright treaties, and trade secret laws, as* well as other intellectual property laws. To protect TI's* rights in the Program, you agree not to decompile, reverse* engineer, disassemble or otherwise translate any object code* versions of the Program to a human-readable form. You agree* that in no event will you alter, remove or destroy any* copyright notice included in the Program. TI reserves all* rights not specifically granted under this license. Except* as specifically provided herein, nothing in this agreement* shall be construed as conferring by implication, estoppel,* or otherwise, upon you, any license or other right under any* TI patents, copyrights or trade secrets.** You may not use the Program in non-TI devices.* ********************************************************* */#ifndef _MMCLIB_C#define _MMCLIB_C////---------------------------------------------------------------#include "mmc.h"#include "hal_SPI.h"#include "hal_hardware_board.h"//#define withDMA// Function Prototypeschar mmcGetResponse(void);char mmcGetXXResponse(const char resp);char mmcCheckBusy(void);char mmcGoIdle();// Initialize MMC cardchar mmcInit(void){//raise CS and MOSI for 80 clock cycles//SendByte(0xff) 10 times with CS high//RAISE CSint i;// Port x Function Dir On/Off// mmcCS Out 0 - Active 1 - none Active// Dout Out 0 - off 1 - On -> init in SPI_Init// Din Inp 0 - off 1 - On -> init in SPI_Init// Clk Out - -> init in SPI_Init// mmcCD In 0 - card inserted// // Init Port for MMC (default high)// MMC_PxOUT |= MMC_SIMO + MMC_SOMI + MMC_UCLK;// MMC_PxDIR |= MMC_SIMO + MMC_UCLK;// MMC_PxDIR &= ~MMC_SOMI;//// // Chip Select// MMC_CS_PxOUT |= MMC_CS;// MMC_CS_PxDIR |= MMC_CS;//// // Card Detect// MMC_CD_PxDIR &= ~MMC_CD;// Enable secondary function#if SPI_SER_INTF == SER_INTF_BITBANGMMC_PxSEL |= MMC_SIMO + MMC_SOMI + MMC_UCLK;#endif// Ping the card to check if it exists// Set the clock speed to something slowhalSPISetSpeedLow();// Initialization sequence on powerupMMC_CS_HIGH();for(i=0;i<=9;i++)spiSendByte(DUMMY_CHAR);__delay_cycles(100);return (mmcGoIdle());}// Set MMC in Idle modechar mmcGoIdle(){char response=0x01;MMC_CS_LOW();// Send Command 0 to put MMC in SPI modemmcSendCmd(MMC_GO_IDLE_STATE,0,0x95);// Now wait until idle state bit is clearedif(mmcGetResponse()!=0x01)return MMC_INIT_ERROR;while(response==0x01){MMC_CS_HIGH();spiSendByte(DUMMY_CHAR);MMC_CS_LOW();mmcSendCmd(MMC_SEND_OP_COND,0x00,0xff);response=mmcGetResponse();}MMC_CS_HIGH();// Card is now initialized, increase the clock speedhalSPISetSpeedHigh();spiSendByte(DUMMY_CHAR);spiSendByte(DUMMY_CHAR);return (MMC_SUCCESS);}// MMC Get Responsechar mmcGetResponse(void){//Response comes 1-8bytes after command//the first bit will be a 0//followed by an error code//data will be 0xff until responseint i=0;volatile unsigned char response;while(i<=64){response=spiSendByte(DUMMY_CHAR);if(response==0x00)break;if(response==0x01)break;i++;}return response;}char mmcGetXXResponse(const char resp){//Response comes 1-8bytes after command//the first bit will be a 0//followed by an error code//data will be 0xff until responseint i=0;char response;while(i<=1000){response=spiSendByte(DUMMY_CHAR);if(response==resp)break;i++;}return response;}// Check if MMC card is still busychar mmcCheckBusy(void){//Response comes 1-8bytes after command//the first bit will be a 0//followed by an error code//data will be 0xff until responseint i=0;char response;char rvalue;while(i<=64){response=spiSendByte(DUMMY_CHAR);response &= 0x1f;switch(response){case 0x05: rvalue=MMC_SUCCESS;break;case 0x0b: return(MMC_CRC_ERROR);case 0x0d: return(MMC_WRITE_ERROR);default:rvalue = MMC_OTHER_ERROR;break;}if(rvalue==MMC_SUCCESS)break;i++;}i=0;do{response=spiSendByte(DUMMY_CHAR);i++;}while(response==0);return response;}// The card will respond with a standard response token followed by a data// block suffixed with a 16 bit CRC.// read a size Byte big block beginning at the address.char mmcReadBlock(const unsigned long address, const unsigned long count, unsigned char *pBuffer){char rvalue = MMC_RESPONSE_ERROR;// Set the block length to readif (mmcSetBlockLength (count) == MMC_SUCCESS) // block length could be set{// CS = LOW (on)MMC_CS_LOW ();// send read command MMC_READ_SINGLE_BLOCK=CMD17mmcSendCmd (MMC_READ_SINGLE_BLOCK,address, 0xFF);// Send 8 Clock pulses of delay, check if the MMC acknowledged the read block command// it will do this by sending an affirmative response// in the R1 format (0x00 is no errors)if (mmcGetResponse() == 0x00){// now look for the data token to signify the start of// the dataif (mmcGetXXResponse(MMC_START_DATA_BLOCK_TOKEN) == MMC_START_DATA_BLOCK_TOKEN){// clock the actual data transfer and receive the bytes; spi_read automatically finds the Data BlockspiReadFrame(pBuffer, count);// get CRC bytes (not really needed by us, but required by MMC)spiSendByte(DUMMY_CHAR);spiSendByte(DUMMY_CHAR);rvalue = MMC_SUCCESS;}else{// the data token was never receivedrvalue = MMC_DATA_TOKEN_ERROR; // 3}}else{// the MMC never acknowledge the read commandrvalue = MMC_RESPONSE_ERROR; // 2}}else{rvalue = MMC_BLOCK_SET_ERROR; // 1}MMC_CS_HIGH ();spiSendByte(DUMMY_CHAR);return rvalue;}char mmcWriteBlock (const unsigned long address, const unsigned long count, unsigned char *pBuffer){char rvalue = MMC_RESPONSE_ERROR; // MMC_SUCCESS;// char c = 0x00;// Set the block length to readif (mmcSetBlockLength (count) == MMC_SUCCESS) // block length could be set{// CS = LOW (on)MMC_CS_LOW ();// send write commandmmcSendCmd (MMC_WRITE_BLOCK,address, 0xFF);// check if the MMC acknowledged the write block command// it will do this by sending an affirmative response// in the R1 format (0x00 is no errors)if (mmcGetXXResponse(MMC_R1_RESPONSE) == MMC_R1_RESPONSE){spiSendByte(DUMMY_CHAR);// send the data token to signify the start of the dataspiSendByte(0xfe);// clock the actual data transfer and transmitt the bytesspiSendFrame(pBuffer, count);// put CRC bytes (not really needed by us, but required by MMC)spiSendByte(DUMMY_CHAR);spiSendByte(DUMMY_CHAR);// read the data response xxx0<status>1 : status 010: Data accected, status 101: Data// rejected due to a crc error, status 110: Data rejected due to a Write error.mmcCheckBusy();rvalue = MMC_SUCCESS;}else{// the MMC never acknowledge the write commandrvalue = MMC_RESPONSE_ERROR; // 2}}else{rvalue = MMC_BLOCK_SET_ERROR; // 1}// give the MMC the required clocks to finish up what ever it needs to do// for (i = 0; i < 9; ++i)// spiSendByte(0xff);MMC_CS_HIGH ();// Send 8 Clock pulses of delay.spiSendByte(DUMMY_CHAR);return rvalue;}// Send command to MMCvoid mmcSendCmd (const char cmd, unsigned long data, const char crc){unsigned char frame[6];char temp;int i;frame[0]=(cmd|0x40);for(i=3;i>=0;i--){temp=(char)(data>>(8*i));frame[4-i]=(temp);}frame[5]=(crc);spiSendFrame(frame,6);}//--------------- set blocklength 2^n ------------------------------------------------------char mmcSetBlockLength (const unsigned long blocklength){// CS = LOW (on)MMC_CS_LOW ();// Set the block length to readmmcSendCmd(MMC_SET_BLOCKLEN, blocklength, 0xFF);// get response from MMC - make sure that its 0x00 (R1 ok response format)if(mmcGetResponse()!=0x00){ mmcInit();mmcSendCmd(MMC_SET_BLOCKLEN, blocklength, 0xFF);mmcGetResponse();}MMC_CS_HIGH ();// Send 8 Clock pulses of delay.spiSendByte(DUMMY_CHAR);return MMC_SUCCESS;}// Reading the contents of the CSD and CID registers in SPI mode is a simple read-block transaction.char mmcReadRegister (const char cmd_register, const unsigned char length, unsigned char *pBuffer){char uc = 0;char rvalue = MMC_TIMEOUT_ERROR;if (mmcSetBlockLength (length) == MMC_SUCCESS){MMC_CS_LOW ();// CRC not used: 0xff as last bytemmcSendCmd(cmd_register, 0x000000, 0xff);// wait for response// in the R1 format (0x00 is no errors)if (mmcGetResponse() == 0x00){if (mmcGetXXResponse(0xfe)== 0xfe)for (uc = 0; uc < length; uc++)pBuffer[uc] = spiSendByte(DUMMY_CHAR); //mmc_buffer[uc] = spiSendByte(0xff);// get CRC bytes (not really needed by us, but required by MMC)spiSendByte(DUMMY_CHAR);spiSendByte(DUMMY_CHAR);rvalue = MMC_SUCCESS;}elservalue = MMC_RESPONSE_ERROR;// CS = HIGH (off)MMC_CS_HIGH ();// Send 8 Clock pulses of delay.spiSendByte(DUMMY_CHAR);}MMC_CS_HIGH ();return rvalue;}#include "math.h"unsigned long mmcReadCardSize(void){// Read contents of Card Specific Data (CSD)unsigned long MMC_CardSize;unsigned short i, // indexj, // indexb, // temporary variableresponse, // MMC response to commandmmc_C_SIZE;unsigned char mmc_READ_BL_LEN, // Read block lengthmmc_C_SIZE_MULT;MMC_CS_LOW ();spiSendByte(MMC_READ_CSD); // CMD 9for(i=4; i>0; i--) // Send four dummy bytesspiSendByte(0);spiSendByte(DUMMY_CHAR); // Send CRC byteresponse = mmcGetResponse();// data transmission always starts with 0xFEb = spiSendByte(DUMMY_CHAR);if( !response ){while (b != 0xFE) b = spiSendByte(DUMMY_CHAR);// bits 127:87for(j=5; j>0; j--) // Host must keep the clock running for atb = spiSendByte(DUMMY_CHAR);// 4 bits of READ_BL_LEN// bits 84:80b =spiSendByte(DUMMY_CHAR); // lower 4 bits of CCC andmmc_READ_BL_LEN = b & 0x0F;b = spiSendByte(DUMMY_CHAR);// bits 73:62 C_Size// xxCC CCCC CCCC CCmmc_C_SIZE = (b & 0x03) << 10;b = spiSendByte(DUMMY_CHAR);mmc_C_SIZE += b << 2;b = spiSendByte(DUMMY_CHAR);mmc_C_SIZE += b >> 6;// bits 55:53b = spiSendByte(DUMMY_CHAR);// bits 49:47mmc_C_SIZE_MULT = (b & 0x03) << 1;b = spiSendByte(DUMMY_CHAR);mmc_C_SIZE_MULT += b >> 7;// bits 41:37b = spiSendByte(DUMMY_CHAR);b = spiSendByte(DUMMY_CHAR);b = spiSendByte(DUMMY_CHAR);b = spiSendByte(DUMMY_CHAR);b = spiSendByte(DUMMY_CHAR);}for(j=4; j>0; j--) // Host must keep the clock running for atb = spiSendByte(DUMMY_CHAR); // least Ncr (max = 4 bytes) cycles after// the card response is receivedb = spiSendByte(DUMMY_CHAR);MMC_CS_LOW ();MMC_CardSize = (mmc_C_SIZE + 1);// power function with base 2 is better with a loop// i = (pow(2,mmc_C_SIZE_MULT+2)+0.5);for(i = 2,j=mmc_C_SIZE_MULT+2; j>1; j--)i <<= 1;MMC_CardSize *= i;// power function with base 2 is better with a loop//i = (pow(2,mmc_READ_BL_LEN)+0.5);for(i = 2,j=mmc_READ_BL_LEN; j>1; j--)i <<= 1;MMC_CardSize *= i;return (MMC_CardSize);}char mmcPing(void) {char stat = MMC_CD_STAT();if (stat)return (MMC_SUCCESS);elsereturn (MMC_INIT_ERROR);}#ifdef withDMA#ifdef __IAR_SYSTEMS_ICC__#pragma vector = DACDMA_VECTOR__interrupt void DMA_isr(void)#endif#ifdef __TI_COMPILER_VERSION____interrupt void DMA_isr(void);DMA_ISR(DMA_isr)__interrupt void DMA_isr(void)#endif{DMA0CTL &= ~(DMAIFG);LPM3_EXIT;}#endif//---------------------------------------------------------------------#endif /* _MMCLIB_C */