236 lines
6.3 KiB
C
236 lines
6.3 KiB
C
|
|
/*
|
|
Copyright 2007, Freie Universitaet Berlin. All rights reserved.
|
|
|
|
These sources were developed at the Freie Universität Berlin, Computer
|
|
Systems and Telematics group.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are
|
|
met:
|
|
|
|
- Redistributions of source code must retain the above copyright
|
|
notice, this list of conditions and the following disclaimer.
|
|
|
|
- Redistributions in binary form must reproduce the above copyright
|
|
notice, this list of conditions and the following disclaimer in the
|
|
documentation and/or other materials provided with the distribution.
|
|
|
|
- Neither the name of Freie Universitaet Berlin (FUB) nor the names of its
|
|
contributors may be used to endorse or promote products derived from
|
|
this software without specific prior written permission.
|
|
|
|
This software is provided by FUB and the contributors on an "as is"
|
|
basis, without any representations or warranties of any kind, express
|
|
or implied including, but not limited to, representations or
|
|
warranties of non-infringement, merchantability or fitness for a
|
|
particular purpose. In no event shall FUB or contributors be liable
|
|
for any direct, indirect, incidental, special, exemplary, or
|
|
consequential damages (including, but not limited to, procurement of
|
|
substitute goods or services; loss of use, data, or profits; or
|
|
business interruption) however caused and on any theory of liability,
|
|
whether in contract, strict liability, or tort (including negligence
|
|
or otherwise) arising in any way out of the use of this software, even
|
|
if advised of the possibility of such damage.
|
|
|
|
This implementation was developed by the CST group at the FUB.
|
|
|
|
For documentation and questions please use the web site
|
|
http://scatterweb.mi.fu-berlin.de and the mailinglist
|
|
scatterweb@lists.spline.inf.fu-berlin.de (subscription via the Website).
|
|
Berlin, 2007
|
|
*/
|
|
|
|
/**
|
|
* @file ScatterWeb.Sd.internals.h
|
|
* @ingroup libsd
|
|
* @brief MMC-/SD-Card library
|
|
*
|
|
* @author Michael Baar <baar@inf.fu-berlin.de>
|
|
* @version $Revision: 1.2 $
|
|
*
|
|
* Header file containing private declarations used MMC-/SD-Card library.
|
|
*
|
|
* $Id: sd_internals.h,v 1.2 2008/03/28 15:58:44 nvt-se Exp $
|
|
*/
|
|
|
|
#ifndef SD_INT_H_
|
|
#define SD_INT_H_
|
|
|
|
#include <string.h>
|
|
#include "sd_platform.h"
|
|
|
|
#define RETF(x) if( ! x ) return FALSE;
|
|
|
|
/**
|
|
* @name SD Card SPI responses
|
|
*/
|
|
struct sd_response_r1 {
|
|
uint8_t in_idle_state:1;
|
|
uint8_t erase_reset:1;
|
|
uint8_t illegal_cmd:1;
|
|
uint8_t crc_err:1;
|
|
uint8_t erase_seq_err:1;
|
|
uint8_t address_err:1;
|
|
uint8_t param_err:1;
|
|
uint8_t start_bit:1;
|
|
};
|
|
|
|
struct sd_response_r2 {
|
|
uint16_t in_idle_state:1;
|
|
uint16_t erase_reset:1;
|
|
uint16_t illegal_cmd:1;
|
|
uint16_t crc_err:1;
|
|
uint16_t erase_seq_err:1;
|
|
uint16_t address_err:1;
|
|
uint16_t param_err:1;
|
|
uint16_t start_bit:1;
|
|
|
|
uint16_t card_locked:1;
|
|
uint16_t write_failed:1;
|
|
uint16_t unspecified_err:1;
|
|
uint16_t controller_err:1;
|
|
uint16_t ecc_failed:1;
|
|
uint16_t protect_violation:1;
|
|
uint16_t erase_param:1;
|
|
uint16_t out_of_range:1;
|
|
};
|
|
|
|
#ifdef __TI_COMPILER_VERSION__
|
|
#pragma pack(1)
|
|
#endif
|
|
struct sd_response_r3 {
|
|
struct sd_response_r1 r1;
|
|
#ifdef __GNUC__
|
|
__attribute__ ((packed))
|
|
#endif
|
|
uint32_t ocr;
|
|
};
|
|
|
|
#ifdef __TI_COMPILER_VERSION__
|
|
#pragma pack()
|
|
#endif
|
|
|
|
struct sd_read_error_token {
|
|
uint8_t unspecified_err:1;
|
|
uint8_t controller_err:1;
|
|
uint8_t ecc_failed:1;
|
|
uint8_t out_of_range:1;
|
|
uint8_t card_locked:1;
|
|
uint8_t:3;
|
|
};
|
|
|
|
struct sd_data_error_token {
|
|
uint8_t error:1;
|
|
uint8_t cc_error:1;
|
|
uint8_t ecc_error:1;
|
|
uint8_t out_of_range:1;
|
|
uint8_t:4; // always 0 (-> SD_DATA_ERROR_TOKEN_MASK)
|
|
};
|
|
|
|
typedef struct sd_read_error_token sd_read_error_token_t;
|
|
typedef struct sd_data_error_token sd_data_error_t;
|
|
|
|
#define SD_DATA_ERROR_TOKEN_MASK 0x0F ///< mask for error token
|
|
#define SD_R1_ERROR_MASK 0x7C ///< mask for error bits in r1 response
|
|
///@}
|
|
|
|
/**
|
|
* @name Private interface
|
|
*/
|
|
|
|
/// Reset card
|
|
int _sd_reset(struct sd_response_r3 *pOpCond);
|
|
|
|
/// Send command and read response
|
|
bool _sd_send_cmd(const uint8_t command,
|
|
const int response_size,
|
|
const void *pArg, void (*const pResponse)
|
|
);
|
|
|
|
/// Wait for card to leave idle mode
|
|
bool _sd_wait_standby(struct sd_response_r3 *pOpCond);
|
|
|
|
/// Read card register
|
|
uint16_t _sd_read_register(void (*const pBuffer), const uint8_t cmd,
|
|
const uint16_t size);
|
|
|
|
/// Begin block read operation
|
|
bool _sd_read_start(const uint8_t cmd, const uint32_t address);
|
|
|
|
/// Cancel block read operation
|
|
void _sd_read_stop(const uint16_t count);
|
|
|
|
#if SD_WRITE
|
|
enum sd_write_ret _sd_write_block(const uint32_t * pAddress,
|
|
const void *pBuffer, int increment);
|
|
#endif
|
|
|
|
#if SD_CACHE
|
|
void _sd_cache_init();
|
|
void _sd_cache_flush();
|
|
#endif
|
|
///@}
|
|
|
|
#define SD_TOKEN_READ 0xFE
|
|
#define SD_TOKEN_WRITE 0xFE
|
|
#define SD_TOKEN_ZP 0xFF
|
|
|
|
#define SD_TIMEOUT_IDLE 1000 // # of poll-cycles for reset procedure (takes some time)
|
|
#define SD_TIMEOUT_READ 20000
|
|
#define SD_TIMEOUT_NCR 8 // 8-64 cycles
|
|
#define SD_RESET_RETRY_COUNT 4
|
|
|
|
#define SD_OCR_BUSY(ocr) ((ocr & 0x80000000) == 0)
|
|
#define SD_V_MASK 0x003E0000 // 3,4 - 2,9 V
|
|
#define SD_HCR_BIT 0x40000000
|
|
|
|
#define SD_RESPONSE_SIZE_R1 1
|
|
#define SD_RESPONSE_SIZE_R2 2
|
|
#define SD_RESPONSE_SIZE_R3 5
|
|
|
|
/**
|
|
* @name Command classes
|
|
* @{
|
|
*/
|
|
#define SD_CCC_BASIC BIT0
|
|
#define SD_CCC_BLOCK_READ BIT2
|
|
#define SD_CCC_BLOCK_WRITE BIT4
|
|
#define SD_CCC_APP_SPECIFIC BIT8
|
|
|
|
#if SD_WRITE
|
|
#define SD_DEFAULT_MINCCC (SD_CCC_BASIC | \
|
|
SD_CCC_BLOCK_READ | \
|
|
SD_CCC_APP_SPECIFIC | \
|
|
SD_CCC_BLOCK_WRITE)
|
|
#else
|
|
#define SD_DEFAULT_MINCCC (SD_CCC_BASIC | \
|
|
SD_CCC_BLOCK_READ | \
|
|
SD_CCC_APP_SPECIFIC)
|
|
#endif
|
|
//@}
|
|
|
|
/**
|
|
* @name Commands
|
|
* @{
|
|
*/
|
|
#define SD_CMD_GO_IDLE_STATE 0 // R1 "reset command"
|
|
#define SD_CMD_SEND_OP_COND 1 // R1 (MMC only!)
|
|
#define SD_CMD_SEND_CSD 9 // R1
|
|
#define SD_CMD_SEND_CID 10 // R1
|
|
#define SD_CMD_STOP_TRANSMISSION 12 // R1b
|
|
#define SD_CMD_SEND_STATUS 13 // R2
|
|
#define SD_CMD_SET_BLOCKLENGTH 16
|
|
#define SD_CMD_READ_SINGLE_BLOCK 17 // R1
|
|
#define SD_CMD_READ_MULTI_BLOCK 18 // R1
|
|
#define SD_CMD_WRITE_SINGLE_BLOCK 24 // R1
|
|
#define SD_CMD_ERASE_WR_BLK_START_ADDR 32 // R1
|
|
#define SD_CMD_ERASE_WR_BLK_END_ADDR 33 // R1
|
|
#define SD_CMD_ERASE 38 // R1b
|
|
#define SD_CMD_APP_SECIFIC_CMD 55
|
|
#define SD_CMD_READ_OCR 58 // R3
|
|
|
|
#define SD_ACMD_SEND_OP_COND 41 // R1
|
|
//@}
|
|
|
|
#endif /*SD_INT_H_ */
|