osd-contiki/platform/msb430/dev/sd/sd_internals.h

/*
Copyright 2007, Freie Universitaet Berlin. All rights reserved.

These sources were developed at the Freie Universit<EFBFBD>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_ */