278 lines
8.8 KiB
C
278 lines
8.8 KiB
C
/* Arduino Sd2Card Library
|
|
* Copyright (C) 2012 by William Greiman
|
|
*
|
|
* This file is part of the Arduino Sd2Card Library
|
|
*
|
|
* This Library is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This Library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with the Arduino Sd2Card Library. If not, see
|
|
* <http://www.gnu.org/licenses/>.
|
|
*/
|
|
#ifndef SdInfo_h
|
|
#define SdInfo_h
|
|
#include <stdint.h>
|
|
// Based on the document:
|
|
//
|
|
// SD Specifications
|
|
// Part 1
|
|
// Physical Layer
|
|
// Simplified Specification
|
|
// Version 3.01
|
|
// May 18, 2010
|
|
//
|
|
// http://www.sdcard.org/developers/tech/sdcard/pls/simplified_specs
|
|
//------------------------------------------------------------------------------
|
|
// SD card commands
|
|
/** GO_IDLE_STATE - init card in spi mode if CS low */
|
|
uint8_t const CMD0 = 0X00;
|
|
/** SEND_IF_COND - verify SD Memory Card interface operating condition.*/
|
|
uint8_t const CMD8 = 0X08;
|
|
/** SEND_CSD - read the Card Specific Data (CSD register) */
|
|
uint8_t const CMD9 = 0X09;
|
|
/** SEND_CID - read the card identification information (CID register) */
|
|
uint8_t const CMD10 = 0X0A;
|
|
/** STOP_TRANSMISSION - end multiple block read sequence */
|
|
uint8_t const CMD12 = 0X0C;
|
|
/** SEND_STATUS - read the card status register */
|
|
uint8_t const CMD13 = 0X0D;
|
|
/** READ_SINGLE_BLOCK - read a single data block from the card */
|
|
uint8_t const CMD17 = 0X11;
|
|
/** READ_MULTIPLE_BLOCK - read a multiple data blocks from the card */
|
|
uint8_t const CMD18 = 0X12;
|
|
/** WRITE_BLOCK - write a single data block to the card */
|
|
uint8_t const CMD24 = 0X18;
|
|
/** WRITE_MULTIPLE_BLOCK - write blocks of data until a STOP_TRANSMISSION */
|
|
uint8_t const CMD25 = 0X19;
|
|
/** ERASE_WR_BLK_START - sets the address of the first block to be erased */
|
|
uint8_t const CMD32 = 0X20;
|
|
/** ERASE_WR_BLK_END - sets the address of the last block of the continuous
|
|
range to be erased*/
|
|
uint8_t const CMD33 = 0X21;
|
|
/** ERASE - erase all previously selected blocks */
|
|
uint8_t const CMD38 = 0X26;
|
|
/** APP_CMD - escape for application specific command */
|
|
uint8_t const CMD55 = 0X37;
|
|
/** READ_OCR - read the OCR register of a card */
|
|
uint8_t const CMD58 = 0X3A;
|
|
/** CRC_ON_OFF - enable or disable CRC checking */
|
|
uint8_t const CMD59 = 0X3B;
|
|
/** SET_WR_BLK_ERASE_COUNT - Set the number of write blocks to be
|
|
pre-erased before writing */
|
|
uint8_t const ACMD23 = 0X17;
|
|
/** SD_SEND_OP_COMD - Sends host capacity support information and
|
|
activates the card's initialization process */
|
|
uint8_t const ACMD41 = 0X29;
|
|
//------------------------------------------------------------------------------
|
|
/** status for card in the ready state */
|
|
uint8_t const R1_READY_STATE = 0X00;
|
|
/** status for card in the idle state */
|
|
uint8_t const R1_IDLE_STATE = 0X01;
|
|
/** status bit for illegal command */
|
|
uint8_t const R1_ILLEGAL_COMMAND = 0X04;
|
|
/** start data token for read or write single block*/
|
|
uint8_t const DATA_START_BLOCK = 0XFE;
|
|
/** stop token for write multiple blocks*/
|
|
uint8_t const STOP_TRAN_TOKEN = 0XFD;
|
|
/** start data token for write multiple blocks*/
|
|
uint8_t const WRITE_MULTIPLE_TOKEN = 0XFC;
|
|
/** mask for data response tokens after a write block operation */
|
|
uint8_t const DATA_RES_MASK = 0X1F;
|
|
/** write data accepted token */
|
|
uint8_t const DATA_RES_ACCEPTED = 0X05;
|
|
//------------------------------------------------------------------------------
|
|
/** Card IDentification (CID) register */
|
|
typedef struct CID {
|
|
// byte 0
|
|
/** Manufacturer ID */
|
|
unsigned char mid;
|
|
// byte 1-2
|
|
/** OEM/Application ID */
|
|
char oid[2];
|
|
// byte 3-7
|
|
/** Product name */
|
|
char pnm[5];
|
|
// byte 8
|
|
/** Product revision least significant digit */
|
|
unsigned char prv_m : 4;
|
|
/** Product revision most significant digit */
|
|
unsigned char prv_n : 4;
|
|
// byte 9-12
|
|
/** Product serial number */
|
|
uint32_t psn;
|
|
// byte 13
|
|
/** Manufacturing date year low digit */
|
|
unsigned char mdt_year_high : 4;
|
|
/** not used */
|
|
unsigned char reserved : 4;
|
|
// byte 14
|
|
/** Manufacturing date month */
|
|
unsigned char mdt_month : 4;
|
|
/** Manufacturing date year low digit */
|
|
unsigned char mdt_year_low :4;
|
|
// byte 15
|
|
/** not used always 1 */
|
|
unsigned char always1 : 1;
|
|
/** CRC7 checksum */
|
|
unsigned char crc : 7;
|
|
}__attribute__((packed)) cid_t;
|
|
//------------------------------------------------------------------------------
|
|
/** CSD for version 1.00 cards */
|
|
typedef struct CSDV1 {
|
|
// byte 0
|
|
unsigned char reserved1 : 6;
|
|
unsigned char csd_ver : 2;
|
|
// byte 1
|
|
unsigned char taac;
|
|
// byte 2
|
|
unsigned char nsac;
|
|
// byte 3
|
|
unsigned char tran_speed;
|
|
// byte 4
|
|
unsigned char ccc_high;
|
|
// byte 5
|
|
unsigned char read_bl_len : 4;
|
|
unsigned char ccc_low : 4;
|
|
// byte 6
|
|
unsigned char c_size_high : 2;
|
|
unsigned char reserved2 : 2;
|
|
unsigned char dsr_imp : 1;
|
|
unsigned char read_blk_misalign :1;
|
|
unsigned char write_blk_misalign : 1;
|
|
unsigned char read_bl_partial : 1;
|
|
// byte 7
|
|
unsigned char c_size_mid;
|
|
// byte 8
|
|
unsigned char vdd_r_curr_max : 3;
|
|
unsigned char vdd_r_curr_min : 3;
|
|
unsigned char c_size_low :2;
|
|
// byte 9
|
|
unsigned char c_size_mult_high : 2;
|
|
unsigned char vdd_w_cur_max : 3;
|
|
unsigned char vdd_w_curr_min : 3;
|
|
// byte 10
|
|
unsigned char sector_size_high : 6;
|
|
unsigned char erase_blk_en : 1;
|
|
unsigned char c_size_mult_low : 1;
|
|
// byte 11
|
|
unsigned char wp_grp_size : 7;
|
|
unsigned char sector_size_low : 1;
|
|
// byte 12
|
|
unsigned char write_bl_len_high : 2;
|
|
unsigned char r2w_factor : 3;
|
|
unsigned char reserved3 : 2;
|
|
unsigned char wp_grp_enable : 1;
|
|
// byte 13
|
|
unsigned char reserved4 : 5;
|
|
unsigned char write_partial : 1;
|
|
unsigned char write_bl_len_low : 2;
|
|
// byte 14
|
|
unsigned char reserved5: 2;
|
|
unsigned char file_format : 2;
|
|
unsigned char tmp_write_protect : 1;
|
|
unsigned char perm_write_protect : 1;
|
|
unsigned char copy : 1;
|
|
/** Indicates the file format on the card */
|
|
unsigned char file_format_grp : 1;
|
|
// byte 15
|
|
unsigned char always1 : 1;
|
|
unsigned char crc : 7;
|
|
}__attribute__((packed)) csd1_t;
|
|
//------------------------------------------------------------------------------
|
|
/** CSD for version 2.00 cards */
|
|
typedef struct CSDV2 {
|
|
// byte 0
|
|
unsigned char reserved1 : 6;
|
|
unsigned char csd_ver : 2;
|
|
// byte 1
|
|
/** fixed to 0X0E */
|
|
unsigned char taac;
|
|
// byte 2
|
|
/** fixed to 0 */
|
|
unsigned char nsac;
|
|
// byte 3
|
|
unsigned char tran_speed;
|
|
// byte 4
|
|
unsigned char ccc_high;
|
|
// byte 5
|
|
/** This field is fixed to 9h, which indicates READ_BL_LEN=512 Byte */
|
|
unsigned char read_bl_len : 4;
|
|
unsigned char ccc_low : 4;
|
|
// byte 6
|
|
/** not used */
|
|
unsigned char reserved2 : 4;
|
|
unsigned char dsr_imp : 1;
|
|
/** fixed to 0 */
|
|
unsigned char read_blk_misalign :1;
|
|
/** fixed to 0 */
|
|
unsigned char write_blk_misalign : 1;
|
|
/** fixed to 0 - no partial read */
|
|
unsigned char read_bl_partial : 1;
|
|
// byte 7
|
|
/** high part of card size */
|
|
unsigned char c_size_high : 6;
|
|
/** not used */
|
|
unsigned char reserved3 : 2;
|
|
// byte 8
|
|
/** middle part of card size */
|
|
unsigned char c_size_mid;
|
|
// byte 9
|
|
/** low part of card size */
|
|
unsigned char c_size_low;
|
|
// byte 10
|
|
/** sector size is fixed at 64 KB */
|
|
unsigned char sector_size_high : 6;
|
|
/** fixed to 1 - erase single is supported */
|
|
unsigned char erase_blk_en : 1;
|
|
/** not used */
|
|
unsigned char reserved4 : 1;
|
|
// byte 11
|
|
unsigned char wp_grp_size : 7;
|
|
/** sector size is fixed at 64 KB */
|
|
unsigned char sector_size_low : 1;
|
|
// byte 12
|
|
/** write_bl_len fixed for 512 byte blocks */
|
|
unsigned char write_bl_len_high : 2;
|
|
/** fixed value of 2 */
|
|
unsigned char r2w_factor : 3;
|
|
/** not used */
|
|
unsigned char reserved5 : 2;
|
|
/** fixed value of 0 - no write protect groups */
|
|
unsigned char wp_grp_enable : 1;
|
|
// byte 13
|
|
unsigned char reserved6 : 5;
|
|
/** always zero - no partial block read*/
|
|
unsigned char write_partial : 1;
|
|
/** write_bl_len fixed for 512 byte blocks */
|
|
unsigned char write_bl_len_low : 2;
|
|
// byte 14
|
|
unsigned char reserved7: 2;
|
|
/** Do not use always 0 */
|
|
unsigned char file_format : 2;
|
|
unsigned char tmp_write_protect : 1;
|
|
unsigned char perm_write_protect : 1;
|
|
unsigned char copy : 1;
|
|
/** Do not use always 0 */
|
|
unsigned char file_format_grp : 1;
|
|
// byte 15
|
|
/** not used always 1 */
|
|
unsigned char always1 : 1;
|
|
/** checksum */
|
|
unsigned char crc : 7;
|
|
}__attribute__((packed)) csd2_t;
|
|
//------------------------------------------------------------------------------
|
|
/** union of old and new style CSD register */
|
|
union csd_t {
|
|
csd1_t v1;
|
|
csd2_t v2;
|
|
};
|
|
#endif // SdInfo_h
|