ELEC2645 (2018/19) / Mbed 2 deprecated el17ebs

Ellis Blackford Stroud 201155309

Dependencies:   mbed FATFileSystem

SDFileSystem/SDFileSystem.cpp@14:08ac9aaa34c3, 2019-05-08 (annotated)

Committer:
ellisbhastroud
Date:
Wed May 08 14:54:19 2019 +0000
Revision:
14:08ac9aaa34c3
Doxygen comments added;

Who changed what in which revision?

UserRevisionLine numberNew contents of line
ellisbhastroud 14:08ac9aaa34c3 1 /* mbed Microcontroller Library
ellisbhastroud 14:08ac9aaa34c3 2 * Copyright (c) 2006-2012 ARM Limited
ellisbhastroud 14:08ac9aaa34c3 3 *
ellisbhastroud 14:08ac9aaa34c3 4 * Permission is hereby granted, free of charge, to any person obtaining a copy
ellisbhastroud 14:08ac9aaa34c3 5 * of this software and associated documentation files (the "Software"), to deal
ellisbhastroud 14:08ac9aaa34c3 6 * in the Software without restriction, including without limitation the rights
ellisbhastroud 14:08ac9aaa34c3 7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
ellisbhastroud 14:08ac9aaa34c3 8 * copies of the Software, and to permit persons to whom the Software is
ellisbhastroud 14:08ac9aaa34c3 9 * furnished to do so, subject to the following conditions:
ellisbhastroud 14:08ac9aaa34c3 10 *
ellisbhastroud 14:08ac9aaa34c3 11 * The above copyright notice and this permission notice shall be included in
ellisbhastroud 14:08ac9aaa34c3 12 * all copies or substantial portions of the Software.
ellisbhastroud 14:08ac9aaa34c3 13 *
ellisbhastroud 14:08ac9aaa34c3 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
ellisbhastroud 14:08ac9aaa34c3 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
ellisbhastroud 14:08ac9aaa34c3 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
ellisbhastroud 14:08ac9aaa34c3 17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
ellisbhastroud 14:08ac9aaa34c3 18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
ellisbhastroud 14:08ac9aaa34c3 19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
ellisbhastroud 14:08ac9aaa34c3 20 * SOFTWARE.
ellisbhastroud 14:08ac9aaa34c3 21 */
ellisbhastroud 14:08ac9aaa34c3 22 /* Introduction
ellisbhastroud 14:08ac9aaa34c3 23 * ------------
ellisbhastroud 14:08ac9aaa34c3 24 * SD and MMC cards support a number of interfaces, but common to them all
ellisbhastroud 14:08ac9aaa34c3 25 * is one based on SPI. This is the one I'm implmenting because it means
ellisbhastroud 14:08ac9aaa34c3 26 * it is much more portable even though not so performant, and we already
ellisbhastroud 14:08ac9aaa34c3 27 * have the mbed SPI Interface!
ellisbhastroud 14:08ac9aaa34c3 28 *
ellisbhastroud 14:08ac9aaa34c3 29 * The main reference I'm using is Chapter 7, "SPI Mode" of:
ellisbhastroud 14:08ac9aaa34c3 30 * http://www.sdcard.org/developers/tech/sdcard/pls/Simplified_Physical_Layer_Spec.pdf
ellisbhastroud 14:08ac9aaa34c3 31 *
ellisbhastroud 14:08ac9aaa34c3 32 * SPI Startup
ellisbhastroud 14:08ac9aaa34c3 33 * -----------
ellisbhastroud 14:08ac9aaa34c3 34 * The SD card powers up in SD mode. The SPI interface mode is selected by
ellisbhastroud 14:08ac9aaa34c3 35 * asserting CS low and sending the reset command (CMD0). The card will
ellisbhastroud 14:08ac9aaa34c3 36 * respond with a (R1) response.
ellisbhastroud 14:08ac9aaa34c3 37 *
ellisbhastroud 14:08ac9aaa34c3 38 * CMD8 is optionally sent to determine the voltage range supported, and
ellisbhastroud 14:08ac9aaa34c3 39 * indirectly determine whether it is a version 1.x SD/non-SD card or
ellisbhastroud 14:08ac9aaa34c3 40 * version 2.x. I'll just ignore this for now.
ellisbhastroud 14:08ac9aaa34c3 41 *
ellisbhastroud 14:08ac9aaa34c3 42 * ACMD41 is repeatedly issued to initialise the card, until "in idle"
ellisbhastroud 14:08ac9aaa34c3 43 * (bit 0) of the R1 response goes to '0', indicating it is initialised.
ellisbhastroud 14:08ac9aaa34c3 44 *
ellisbhastroud 14:08ac9aaa34c3 45 * You should also indicate whether the host supports High Capicity cards,
ellisbhastroud 14:08ac9aaa34c3 46 * and check whether the card is high capacity - i'll also ignore this
ellisbhastroud 14:08ac9aaa34c3 47 *
ellisbhastroud 14:08ac9aaa34c3 48 * SPI Protocol
ellisbhastroud 14:08ac9aaa34c3 49 * ------------
ellisbhastroud 14:08ac9aaa34c3 50 * The SD SPI protocol is based on transactions made up of 8-bit words, with
ellisbhastroud 14:08ac9aaa34c3 51 * the host starting every bus transaction by asserting the CS signal low. The
ellisbhastroud 14:08ac9aaa34c3 52 * card always responds to commands, data blocks and errors.
ellisbhastroud 14:08ac9aaa34c3 53 *
ellisbhastroud 14:08ac9aaa34c3 54 * The protocol supports a CRC, but by default it is off (except for the
ellisbhastroud 14:08ac9aaa34c3 55 * first reset CMD0, where the CRC can just be pre-calculated, and CMD8)
ellisbhastroud 14:08ac9aaa34c3 56 * I'll leave the CRC off I think!
ellisbhastroud 14:08ac9aaa34c3 57 *
ellisbhastroud 14:08ac9aaa34c3 58 * Standard capacity cards have variable data block sizes, whereas High
ellisbhastroud 14:08ac9aaa34c3 59 * Capacity cards fix the size of data block to 512 bytes. I'll therefore
ellisbhastroud 14:08ac9aaa34c3 60 * just always use the Standard Capacity cards with a block size of 512 bytes.
ellisbhastroud 14:08ac9aaa34c3 61 * This is set with CMD16.
ellisbhastroud 14:08ac9aaa34c3 62 *
ellisbhastroud 14:08ac9aaa34c3 63 * You can read and write single blocks (CMD17, CMD25) or multiple blocks
ellisbhastroud 14:08ac9aaa34c3 64 * (CMD18, CMD25). For simplicity, I'll just use single block accesses. When
ellisbhastroud 14:08ac9aaa34c3 65 * the card gets a read command, it responds with a response token, and then
ellisbhastroud 14:08ac9aaa34c3 66 * a data token or an error.
ellisbhastroud 14:08ac9aaa34c3 67 *
ellisbhastroud 14:08ac9aaa34c3 68 * SPI Command Format
ellisbhastroud 14:08ac9aaa34c3 69 * ------------------
ellisbhastroud 14:08ac9aaa34c3 70 * Commands are 6-bytes long, containing the command, 32-bit argument, and CRC.
ellisbhastroud 14:08ac9aaa34c3 71 *
ellisbhastroud 14:08ac9aaa34c3 72 * +---------------+------------+------------+-----------+----------+--------------+
ellisbhastroud 14:08ac9aaa34c3 73 * | 01 | cmd[5:0] | arg[31:24] | arg[23:16] | arg[15:8] | arg[7:0] | crc[6:0] | 1 |
ellisbhastroud 14:08ac9aaa34c3 74 * +---------------+------------+------------+-----------+----------+--------------+
ellisbhastroud 14:08ac9aaa34c3 75 *
ellisbhastroud 14:08ac9aaa34c3 76 * As I'm not using CRC, I can fix that byte to what is needed for CMD0 (0x95)
ellisbhastroud 14:08ac9aaa34c3 77 *
ellisbhastroud 14:08ac9aaa34c3 78 * All Application Specific commands shall be preceded with APP_CMD (CMD55).
ellisbhastroud 14:08ac9aaa34c3 79 *
ellisbhastroud 14:08ac9aaa34c3 80 * SPI Response Format
ellisbhastroud 14:08ac9aaa34c3 81 * -------------------
ellisbhastroud 14:08ac9aaa34c3 82 * The main response format (R1) is a status byte (normally zero). Key flags:
ellisbhastroud 14:08ac9aaa34c3 83 * idle - 1 if the card is in an idle state/initialising
ellisbhastroud 14:08ac9aaa34c3 84 * cmd - 1 if an illegal command code was detected
ellisbhastroud 14:08ac9aaa34c3 85 *
ellisbhastroud 14:08ac9aaa34c3 86 * +-------------------------------------------------+
ellisbhastroud 14:08ac9aaa34c3 87 * R1 | 0 | arg | addr | seq | crc | cmd | erase | idle |
ellisbhastroud 14:08ac9aaa34c3 88 * +-------------------------------------------------+
ellisbhastroud 14:08ac9aaa34c3 89 *
ellisbhastroud 14:08ac9aaa34c3 90 * R1b is the same, except it is followed by a busy signal (zeros) until
ellisbhastroud 14:08ac9aaa34c3 91 * the first non-zero byte when it is ready again.
ellisbhastroud 14:08ac9aaa34c3 92 *
ellisbhastroud 14:08ac9aaa34c3 93 * Data Response Token
ellisbhastroud 14:08ac9aaa34c3 94 * -------------------
ellisbhastroud 14:08ac9aaa34c3 95 * Every data block written to the card is acknowledged by a byte
ellisbhastroud 14:08ac9aaa34c3 96 * response token
ellisbhastroud 14:08ac9aaa34c3 97 *
ellisbhastroud 14:08ac9aaa34c3 98 * +----------------------+
ellisbhastroud 14:08ac9aaa34c3 99 * | xxx | 0 | status | 1 |
ellisbhastroud 14:08ac9aaa34c3 100 * +----------------------+
ellisbhastroud 14:08ac9aaa34c3 101 * 010 - OK!
ellisbhastroud 14:08ac9aaa34c3 102 * 101 - CRC Error
ellisbhastroud 14:08ac9aaa34c3 103 * 110 - Write Error
ellisbhastroud 14:08ac9aaa34c3 104 *
ellisbhastroud 14:08ac9aaa34c3 105 * Single Block Read and Write
ellisbhastroud 14:08ac9aaa34c3 106 * ---------------------------
ellisbhastroud 14:08ac9aaa34c3 107 *
ellisbhastroud 14:08ac9aaa34c3 108 * Block transfers have a byte header, followed by the data, followed
ellisbhastroud 14:08ac9aaa34c3 109 * by a 16-bit CRC. In our case, the data will always be 512 bytes.
ellisbhastroud 14:08ac9aaa34c3 110 *
ellisbhastroud 14:08ac9aaa34c3 111 * +------+---------+---------+- - - -+---------+-----------+----------+
ellisbhastroud 14:08ac9aaa34c3 112 * | 0xFE | data[0] | data[1] | | data[n] | crc[15:8] | crc[7:0] |
ellisbhastroud 14:08ac9aaa34c3 113 * +------+---------+---------+- - - -+---------+-----------+----------+
ellisbhastroud 14:08ac9aaa34c3 114 */
ellisbhastroud 14:08ac9aaa34c3 115 #include "SDFileSystem.h"
ellisbhastroud 14:08ac9aaa34c3 116 #include "mbed_debug.h"
ellisbhastroud 14:08ac9aaa34c3 117
ellisbhastroud 14:08ac9aaa34c3 118 #define SD_COMMAND_TIMEOUT 5000
ellisbhastroud 14:08ac9aaa34c3 119
ellisbhastroud 14:08ac9aaa34c3 120 #define SD_DBG 0
ellisbhastroud 14:08ac9aaa34c3 121
ellisbhastroud 14:08ac9aaa34c3 122 SDFileSystem::SDFileSystem(PinName mosi, PinName miso, PinName sclk, PinName cs, const char* name) :
ellisbhastroud 14:08ac9aaa34c3 123 FATFileSystem(name), _spi(mosi, miso, sclk), _cs(cs), _is_initialized(0) {
ellisbhastroud 14:08ac9aaa34c3 124 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 125
ellisbhastroud 14:08ac9aaa34c3 126 // Set default to 100kHz for initialisation and 1MHz for data transfer
ellisbhastroud 14:08ac9aaa34c3 127 _init_sck = 100000;
ellisbhastroud 14:08ac9aaa34c3 128 _transfer_sck = 1000000;
ellisbhastroud 14:08ac9aaa34c3 129 }
ellisbhastroud 14:08ac9aaa34c3 130
ellisbhastroud 14:08ac9aaa34c3 131 #define R1_IDLE_STATE (1 << 0)
ellisbhastroud 14:08ac9aaa34c3 132 #define R1_ERASE_RESET (1 << 1)
ellisbhastroud 14:08ac9aaa34c3 133 #define R1_ILLEGAL_COMMAND (1 << 2)
ellisbhastroud 14:08ac9aaa34c3 134 #define R1_COM_CRC_ERROR (1 << 3)
ellisbhastroud 14:08ac9aaa34c3 135 #define R1_ERASE_SEQUENCE_ERROR (1 << 4)
ellisbhastroud 14:08ac9aaa34c3 136 #define R1_ADDRESS_ERROR (1 << 5)
ellisbhastroud 14:08ac9aaa34c3 137 #define R1_PARAMETER_ERROR (1 << 6)
ellisbhastroud 14:08ac9aaa34c3 138
ellisbhastroud 14:08ac9aaa34c3 139 // Types
ellisbhastroud 14:08ac9aaa34c3 140 // - v1.x Standard Capacity
ellisbhastroud 14:08ac9aaa34c3 141 // - v2.x Standard Capacity
ellisbhastroud 14:08ac9aaa34c3 142 // - v2.x High Capacity
ellisbhastroud 14:08ac9aaa34c3 143 // - Not recognised as an SD Card
ellisbhastroud 14:08ac9aaa34c3 144 #define SDCARD_FAIL 0
ellisbhastroud 14:08ac9aaa34c3 145 #define SDCARD_V1 1
ellisbhastroud 14:08ac9aaa34c3 146 #define SDCARD_V2 2
ellisbhastroud 14:08ac9aaa34c3 147 #define SDCARD_V2HC 3
ellisbhastroud 14:08ac9aaa34c3 148
ellisbhastroud 14:08ac9aaa34c3 149 int SDFileSystem::initialise_card() {
ellisbhastroud 14:08ac9aaa34c3 150 // Set to SCK for initialisation, and clock card with cs = 1
ellisbhastroud 14:08ac9aaa34c3 151 _spi.frequency(_init_sck);
ellisbhastroud 14:08ac9aaa34c3 152 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 153 for (int i = 0; i < 16; i++) {
ellisbhastroud 14:08ac9aaa34c3 154 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 155 }
ellisbhastroud 14:08ac9aaa34c3 156
ellisbhastroud 14:08ac9aaa34c3 157 // send CMD0, should return with all zeros except IDLE STATE set (bit 0)
ellisbhastroud 14:08ac9aaa34c3 158 if (_cmd(0, 0) != R1_IDLE_STATE) {
ellisbhastroud 14:08ac9aaa34c3 159 debug("No disk, or could not put SD card in to SPI idle state\n");
ellisbhastroud 14:08ac9aaa34c3 160 return SDCARD_FAIL;
ellisbhastroud 14:08ac9aaa34c3 161 }
ellisbhastroud 14:08ac9aaa34c3 162
ellisbhastroud 14:08ac9aaa34c3 163 // send CMD8 to determine whther it is ver 2.x
ellisbhastroud 14:08ac9aaa34c3 164 int r = _cmd8();
ellisbhastroud 14:08ac9aaa34c3 165 if (r == R1_IDLE_STATE) {
ellisbhastroud 14:08ac9aaa34c3 166 return initialise_card_v2();
ellisbhastroud 14:08ac9aaa34c3 167 } else if (r == (R1_IDLE_STATE | R1_ILLEGAL_COMMAND)) {
ellisbhastroud 14:08ac9aaa34c3 168 return initialise_card_v1();
ellisbhastroud 14:08ac9aaa34c3 169 } else {
ellisbhastroud 14:08ac9aaa34c3 170 debug("Not in idle state after sending CMD8 (not an SD card?)\n");
ellisbhastroud 14:08ac9aaa34c3 171 return SDCARD_FAIL;
ellisbhastroud 14:08ac9aaa34c3 172 }
ellisbhastroud 14:08ac9aaa34c3 173 }
ellisbhastroud 14:08ac9aaa34c3 174
ellisbhastroud 14:08ac9aaa34c3 175 int SDFileSystem::initialise_card_v1() {
ellisbhastroud 14:08ac9aaa34c3 176 for (int i = 0; i < SD_COMMAND_TIMEOUT; i++) {
ellisbhastroud 14:08ac9aaa34c3 177 _cmd(55, 0);
ellisbhastroud 14:08ac9aaa34c3 178 if (_cmd(41, 0) == 0) {
ellisbhastroud 14:08ac9aaa34c3 179 cdv = 512;
ellisbhastroud 14:08ac9aaa34c3 180 debug_if(SD_DBG, "\n\rInit: SEDCARD_V1\n\r");
ellisbhastroud 14:08ac9aaa34c3 181 return SDCARD_V1;
ellisbhastroud 14:08ac9aaa34c3 182 }
ellisbhastroud 14:08ac9aaa34c3 183 }
ellisbhastroud 14:08ac9aaa34c3 184
ellisbhastroud 14:08ac9aaa34c3 185 debug("Timeout waiting for v1.x card\n");
ellisbhastroud 14:08ac9aaa34c3 186 return SDCARD_FAIL;
ellisbhastroud 14:08ac9aaa34c3 187 }
ellisbhastroud 14:08ac9aaa34c3 188
ellisbhastroud 14:08ac9aaa34c3 189 int SDFileSystem::initialise_card_v2() {
ellisbhastroud 14:08ac9aaa34c3 190 for (int i = 0; i < SD_COMMAND_TIMEOUT; i++) {
ellisbhastroud 14:08ac9aaa34c3 191 wait_ms(50);
ellisbhastroud 14:08ac9aaa34c3 192 _cmd58();
ellisbhastroud 14:08ac9aaa34c3 193 _cmd(55, 0);
ellisbhastroud 14:08ac9aaa34c3 194 if (_cmd(41, 0x40000000) == 0) {
ellisbhastroud 14:08ac9aaa34c3 195 _cmd58();
ellisbhastroud 14:08ac9aaa34c3 196 debug_if(SD_DBG, "\n\rInit: SDCARD_V2\n\r");
ellisbhastroud 14:08ac9aaa34c3 197 cdv = 1;
ellisbhastroud 14:08ac9aaa34c3 198 return SDCARD_V2;
ellisbhastroud 14:08ac9aaa34c3 199 }
ellisbhastroud 14:08ac9aaa34c3 200 }
ellisbhastroud 14:08ac9aaa34c3 201
ellisbhastroud 14:08ac9aaa34c3 202 debug("Timeout waiting for v2.x card\n");
ellisbhastroud 14:08ac9aaa34c3 203 return SDCARD_FAIL;
ellisbhastroud 14:08ac9aaa34c3 204 }
ellisbhastroud 14:08ac9aaa34c3 205
ellisbhastroud 14:08ac9aaa34c3 206 int SDFileSystem::disk_initialize() {
ellisbhastroud 14:08ac9aaa34c3 207 _is_initialized = initialise_card();
ellisbhastroud 14:08ac9aaa34c3 208 if (_is_initialized == 0) {
ellisbhastroud 14:08ac9aaa34c3 209 debug("Fail to initialize card\n");
ellisbhastroud 14:08ac9aaa34c3 210 return 1;
ellisbhastroud 14:08ac9aaa34c3 211 }
ellisbhastroud 14:08ac9aaa34c3 212 debug_if(SD_DBG, "init card = %d\n", _is_initialized);
ellisbhastroud 14:08ac9aaa34c3 213 _sectors = _sd_sectors();
ellisbhastroud 14:08ac9aaa34c3 214
ellisbhastroud 14:08ac9aaa34c3 215 // Set block length to 512 (CMD16)
ellisbhastroud 14:08ac9aaa34c3 216 if (_cmd(16, 512) != 0) {
ellisbhastroud 14:08ac9aaa34c3 217 debug("Set 512-byte block timed out\n");
ellisbhastroud 14:08ac9aaa34c3 218 return 1;
ellisbhastroud 14:08ac9aaa34c3 219 }
ellisbhastroud 14:08ac9aaa34c3 220
ellisbhastroud 14:08ac9aaa34c3 221 // Set SCK for data transfer
ellisbhastroud 14:08ac9aaa34c3 222 _spi.frequency(_transfer_sck);
ellisbhastroud 14:08ac9aaa34c3 223 return 0;
ellisbhastroud 14:08ac9aaa34c3 224 }
ellisbhastroud 14:08ac9aaa34c3 225
ellisbhastroud 14:08ac9aaa34c3 226 int SDFileSystem::disk_write(const uint8_t* buffer, uint32_t block_number, uint32_t count) {
ellisbhastroud 14:08ac9aaa34c3 227 if (!_is_initialized) {
ellisbhastroud 14:08ac9aaa34c3 228 return -1;
ellisbhastroud 14:08ac9aaa34c3 229 }
ellisbhastroud 14:08ac9aaa34c3 230
ellisbhastroud 14:08ac9aaa34c3 231 for (uint32_t b = block_number; b < block_number + count; b++) {
ellisbhastroud 14:08ac9aaa34c3 232 // set write address for single block (CMD24)
ellisbhastroud 14:08ac9aaa34c3 233 if (_cmd(24, b * cdv) != 0) {
ellisbhastroud 14:08ac9aaa34c3 234 return 1;
ellisbhastroud 14:08ac9aaa34c3 235 }
ellisbhastroud 14:08ac9aaa34c3 236
ellisbhastroud 14:08ac9aaa34c3 237 // send the data block
ellisbhastroud 14:08ac9aaa34c3 238 _write(buffer, 512);
ellisbhastroud 14:08ac9aaa34c3 239 buffer += 512;
ellisbhastroud 14:08ac9aaa34c3 240 }
ellisbhastroud 14:08ac9aaa34c3 241
ellisbhastroud 14:08ac9aaa34c3 242 return 0;
ellisbhastroud 14:08ac9aaa34c3 243 }
ellisbhastroud 14:08ac9aaa34c3 244
ellisbhastroud 14:08ac9aaa34c3 245 int SDFileSystem::disk_read(uint8_t* buffer, uint32_t block_number, uint32_t count) {
ellisbhastroud 14:08ac9aaa34c3 246 if (!_is_initialized) {
ellisbhastroud 14:08ac9aaa34c3 247 return -1;
ellisbhastroud 14:08ac9aaa34c3 248 }
ellisbhastroud 14:08ac9aaa34c3 249
ellisbhastroud 14:08ac9aaa34c3 250 for (uint32_t b = block_number; b < block_number + count; b++) {
ellisbhastroud 14:08ac9aaa34c3 251 // set read address for single block (CMD17)
ellisbhastroud 14:08ac9aaa34c3 252 if (_cmd(17, b * cdv) != 0) {
ellisbhastroud 14:08ac9aaa34c3 253 return 1;
ellisbhastroud 14:08ac9aaa34c3 254 }
ellisbhastroud 14:08ac9aaa34c3 255
ellisbhastroud 14:08ac9aaa34c3 256 // receive the data
ellisbhastroud 14:08ac9aaa34c3 257 _read(buffer, 512);
ellisbhastroud 14:08ac9aaa34c3 258 buffer += 512;
ellisbhastroud 14:08ac9aaa34c3 259 }
ellisbhastroud 14:08ac9aaa34c3 260
ellisbhastroud 14:08ac9aaa34c3 261 return 0;
ellisbhastroud 14:08ac9aaa34c3 262 }
ellisbhastroud 14:08ac9aaa34c3 263
ellisbhastroud 14:08ac9aaa34c3 264 int SDFileSystem::disk_status() {
ellisbhastroud 14:08ac9aaa34c3 265 // FATFileSystem::disk_status() returns 0 when initialized
ellisbhastroud 14:08ac9aaa34c3 266 if (_is_initialized) {
ellisbhastroud 14:08ac9aaa34c3 267 return 0;
ellisbhastroud 14:08ac9aaa34c3 268 } else {
ellisbhastroud 14:08ac9aaa34c3 269 return 1;
ellisbhastroud 14:08ac9aaa34c3 270 }
ellisbhastroud 14:08ac9aaa34c3 271 }
ellisbhastroud 14:08ac9aaa34c3 272
ellisbhastroud 14:08ac9aaa34c3 273 int SDFileSystem::disk_sync() { return 0; }
ellisbhastroud 14:08ac9aaa34c3 274 uint32_t SDFileSystem::disk_sectors() { return _sectors; }
ellisbhastroud 14:08ac9aaa34c3 275
ellisbhastroud 14:08ac9aaa34c3 276
ellisbhastroud 14:08ac9aaa34c3 277 // PRIVATE FUNCTIONS
ellisbhastroud 14:08ac9aaa34c3 278 int SDFileSystem::_cmd(int cmd, int arg) {
ellisbhastroud 14:08ac9aaa34c3 279 _cs = 0;
ellisbhastroud 14:08ac9aaa34c3 280
ellisbhastroud 14:08ac9aaa34c3 281 // send a command
ellisbhastroud 14:08ac9aaa34c3 282 _spi.write(0x40 | cmd);
ellisbhastroud 14:08ac9aaa34c3 283 _spi.write(arg >> 24);
ellisbhastroud 14:08ac9aaa34c3 284 _spi.write(arg >> 16);
ellisbhastroud 14:08ac9aaa34c3 285 _spi.write(arg >> 8);
ellisbhastroud 14:08ac9aaa34c3 286 _spi.write(arg >> 0);
ellisbhastroud 14:08ac9aaa34c3 287 _spi.write(0x95);
ellisbhastroud 14:08ac9aaa34c3 288
ellisbhastroud 14:08ac9aaa34c3 289 // wait for the repsonse (response[7] == 0)
ellisbhastroud 14:08ac9aaa34c3 290 for (int i = 0; i < SD_COMMAND_TIMEOUT; i++) {
ellisbhastroud 14:08ac9aaa34c3 291 int response = _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 292 if (!(response & 0x80)) {
ellisbhastroud 14:08ac9aaa34c3 293 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 294 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 295 return response;
ellisbhastroud 14:08ac9aaa34c3 296 }
ellisbhastroud 14:08ac9aaa34c3 297 }
ellisbhastroud 14:08ac9aaa34c3 298 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 299 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 300 return -1; // timeout
ellisbhastroud 14:08ac9aaa34c3 301 }
ellisbhastroud 14:08ac9aaa34c3 302 int SDFileSystem::_cmdx(int cmd, int arg) {
ellisbhastroud 14:08ac9aaa34c3 303 _cs = 0;
ellisbhastroud 14:08ac9aaa34c3 304
ellisbhastroud 14:08ac9aaa34c3 305 // send a command
ellisbhastroud 14:08ac9aaa34c3 306 _spi.write(0x40 | cmd);
ellisbhastroud 14:08ac9aaa34c3 307 _spi.write(arg >> 24);
ellisbhastroud 14:08ac9aaa34c3 308 _spi.write(arg >> 16);
ellisbhastroud 14:08ac9aaa34c3 309 _spi.write(arg >> 8);
ellisbhastroud 14:08ac9aaa34c3 310 _spi.write(arg >> 0);
ellisbhastroud 14:08ac9aaa34c3 311 _spi.write(0x95);
ellisbhastroud 14:08ac9aaa34c3 312
ellisbhastroud 14:08ac9aaa34c3 313 // wait for the repsonse (response[7] == 0)
ellisbhastroud 14:08ac9aaa34c3 314 for (int i = 0; i < SD_COMMAND_TIMEOUT; i++) {
ellisbhastroud 14:08ac9aaa34c3 315 int response = _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 316 if (!(response & 0x80)) {
ellisbhastroud 14:08ac9aaa34c3 317 return response;
ellisbhastroud 14:08ac9aaa34c3 318 }
ellisbhastroud 14:08ac9aaa34c3 319 }
ellisbhastroud 14:08ac9aaa34c3 320 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 321 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 322 return -1; // timeout
ellisbhastroud 14:08ac9aaa34c3 323 }
ellisbhastroud 14:08ac9aaa34c3 324
ellisbhastroud 14:08ac9aaa34c3 325
ellisbhastroud 14:08ac9aaa34c3 326 int SDFileSystem::_cmd58() {
ellisbhastroud 14:08ac9aaa34c3 327 _cs = 0;
ellisbhastroud 14:08ac9aaa34c3 328 int arg = 0;
ellisbhastroud 14:08ac9aaa34c3 329
ellisbhastroud 14:08ac9aaa34c3 330 // send a command
ellisbhastroud 14:08ac9aaa34c3 331 _spi.write(0x40 | 58);
ellisbhastroud 14:08ac9aaa34c3 332 _spi.write(arg >> 24);
ellisbhastroud 14:08ac9aaa34c3 333 _spi.write(arg >> 16);
ellisbhastroud 14:08ac9aaa34c3 334 _spi.write(arg >> 8);
ellisbhastroud 14:08ac9aaa34c3 335 _spi.write(arg >> 0);
ellisbhastroud 14:08ac9aaa34c3 336 _spi.write(0x95);
ellisbhastroud 14:08ac9aaa34c3 337
ellisbhastroud 14:08ac9aaa34c3 338 // wait for the repsonse (response[7] == 0)
ellisbhastroud 14:08ac9aaa34c3 339 for (int i = 0; i < SD_COMMAND_TIMEOUT; i++) {
ellisbhastroud 14:08ac9aaa34c3 340 int response = _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 341 if (!(response & 0x80)) {
ellisbhastroud 14:08ac9aaa34c3 342 int ocr = _spi.write(0xFF) << 24;
ellisbhastroud 14:08ac9aaa34c3 343 ocr |= _spi.write(0xFF) << 16;
ellisbhastroud 14:08ac9aaa34c3 344 ocr |= _spi.write(0xFF) << 8;
ellisbhastroud 14:08ac9aaa34c3 345 ocr |= _spi.write(0xFF) << 0;
ellisbhastroud 14:08ac9aaa34c3 346 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 347 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 348 return response;
ellisbhastroud 14:08ac9aaa34c3 349 }
ellisbhastroud 14:08ac9aaa34c3 350 }
ellisbhastroud 14:08ac9aaa34c3 351 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 352 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 353 return -1; // timeout
ellisbhastroud 14:08ac9aaa34c3 354 }
ellisbhastroud 14:08ac9aaa34c3 355
ellisbhastroud 14:08ac9aaa34c3 356 int SDFileSystem::_cmd8() {
ellisbhastroud 14:08ac9aaa34c3 357 _cs = 0;
ellisbhastroud 14:08ac9aaa34c3 358
ellisbhastroud 14:08ac9aaa34c3 359 // send a command
ellisbhastroud 14:08ac9aaa34c3 360 _spi.write(0x40 | 8); // CMD8
ellisbhastroud 14:08ac9aaa34c3 361 _spi.write(0x00); // reserved
ellisbhastroud 14:08ac9aaa34c3 362 _spi.write(0x00); // reserved
ellisbhastroud 14:08ac9aaa34c3 363 _spi.write(0x01); // 3.3v
ellisbhastroud 14:08ac9aaa34c3 364 _spi.write(0xAA); // check pattern
ellisbhastroud 14:08ac9aaa34c3 365 _spi.write(0x87); // crc
ellisbhastroud 14:08ac9aaa34c3 366
ellisbhastroud 14:08ac9aaa34c3 367 // wait for the repsonse (response[7] == 0)
ellisbhastroud 14:08ac9aaa34c3 368 for (int i = 0; i < SD_COMMAND_TIMEOUT * 1000; i++) {
ellisbhastroud 14:08ac9aaa34c3 369 char response[5];
ellisbhastroud 14:08ac9aaa34c3 370 response[0] = _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 371 if (!(response[0] & 0x80)) {
ellisbhastroud 14:08ac9aaa34c3 372 for (int j = 1; j < 5; j++) {
ellisbhastroud 14:08ac9aaa34c3 373 response[i] = _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 374 }
ellisbhastroud 14:08ac9aaa34c3 375 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 376 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 377 return response[0];
ellisbhastroud 14:08ac9aaa34c3 378 }
ellisbhastroud 14:08ac9aaa34c3 379 }
ellisbhastroud 14:08ac9aaa34c3 380 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 381 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 382 return -1; // timeout
ellisbhastroud 14:08ac9aaa34c3 383 }
ellisbhastroud 14:08ac9aaa34c3 384
ellisbhastroud 14:08ac9aaa34c3 385 int SDFileSystem::_read(uint8_t *buffer, uint32_t length) {
ellisbhastroud 14:08ac9aaa34c3 386 _cs = 0;
ellisbhastroud 14:08ac9aaa34c3 387
ellisbhastroud 14:08ac9aaa34c3 388 // read until start byte (0xFF)
ellisbhastroud 14:08ac9aaa34c3 389 while (_spi.write(0xFF) != 0xFE);
ellisbhastroud 14:08ac9aaa34c3 390
ellisbhastroud 14:08ac9aaa34c3 391 // read data
ellisbhastroud 14:08ac9aaa34c3 392 for (uint32_t i = 0; i < length; i++) {
ellisbhastroud 14:08ac9aaa34c3 393 buffer[i] = _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 394 }
ellisbhastroud 14:08ac9aaa34c3 395 _spi.write(0xFF); // checksum
ellisbhastroud 14:08ac9aaa34c3 396 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 397
ellisbhastroud 14:08ac9aaa34c3 398 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 399 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 400 return 0;
ellisbhastroud 14:08ac9aaa34c3 401 }
ellisbhastroud 14:08ac9aaa34c3 402
ellisbhastroud 14:08ac9aaa34c3 403 int SDFileSystem::_write(const uint8_t*buffer, uint32_t length) {
ellisbhastroud 14:08ac9aaa34c3 404 _cs = 0;
ellisbhastroud 14:08ac9aaa34c3 405
ellisbhastroud 14:08ac9aaa34c3 406 // indicate start of block
ellisbhastroud 14:08ac9aaa34c3 407 _spi.write(0xFE);
ellisbhastroud 14:08ac9aaa34c3 408
ellisbhastroud 14:08ac9aaa34c3 409 // write the data
ellisbhastroud 14:08ac9aaa34c3 410 for (uint32_t i = 0; i < length; i++) {
ellisbhastroud 14:08ac9aaa34c3 411 _spi.write(buffer[i]);
ellisbhastroud 14:08ac9aaa34c3 412 }
ellisbhastroud 14:08ac9aaa34c3 413
ellisbhastroud 14:08ac9aaa34c3 414 // write the checksum
ellisbhastroud 14:08ac9aaa34c3 415 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 416 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 417
ellisbhastroud 14:08ac9aaa34c3 418 // check the response token
ellisbhastroud 14:08ac9aaa34c3 419 if ((_spi.write(0xFF) & 0x1F) != 0x05) {
ellisbhastroud 14:08ac9aaa34c3 420 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 421 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 422 return 1;
ellisbhastroud 14:08ac9aaa34c3 423 }
ellisbhastroud 14:08ac9aaa34c3 424
ellisbhastroud 14:08ac9aaa34c3 425 // wait for write to finish
ellisbhastroud 14:08ac9aaa34c3 426 while (_spi.write(0xFF) == 0);
ellisbhastroud 14:08ac9aaa34c3 427
ellisbhastroud 14:08ac9aaa34c3 428 _cs = 1;
ellisbhastroud 14:08ac9aaa34c3 429 _spi.write(0xFF);
ellisbhastroud 14:08ac9aaa34c3 430 return 0;
ellisbhastroud 14:08ac9aaa34c3 431 }
ellisbhastroud 14:08ac9aaa34c3 432
ellisbhastroud 14:08ac9aaa34c3 433 static uint32_t ext_bits(unsigned char *data, int msb, int lsb) {
ellisbhastroud 14:08ac9aaa34c3 434 uint32_t bits = 0;
ellisbhastroud 14:08ac9aaa34c3 435 uint32_t size = 1 + msb - lsb;
ellisbhastroud 14:08ac9aaa34c3 436 for (uint32_t i = 0; i < size; i++) {
ellisbhastroud 14:08ac9aaa34c3 437 uint32_t position = lsb + i;
ellisbhastroud 14:08ac9aaa34c3 438 uint32_t byte = 15 - (position >> 3);
ellisbhastroud 14:08ac9aaa34c3 439 uint32_t bit = position & 0x7;
ellisbhastroud 14:08ac9aaa34c3 440 uint32_t value = (data[byte] >> bit) & 1;
ellisbhastroud 14:08ac9aaa34c3 441 bits |= value << i;
ellisbhastroud 14:08ac9aaa34c3 442 }
ellisbhastroud 14:08ac9aaa34c3 443 return bits;
ellisbhastroud 14:08ac9aaa34c3 444 }
ellisbhastroud 14:08ac9aaa34c3 445
ellisbhastroud 14:08ac9aaa34c3 446 uint32_t SDFileSystem::_sd_sectors() {
ellisbhastroud 14:08ac9aaa34c3 447 uint32_t c_size, c_size_mult, read_bl_len;
ellisbhastroud 14:08ac9aaa34c3 448 uint32_t block_len, mult, blocknr, capacity;
ellisbhastroud 14:08ac9aaa34c3 449 uint32_t hc_c_size;
ellisbhastroud 14:08ac9aaa34c3 450 uint32_t blocks;
ellisbhastroud 14:08ac9aaa34c3 451
ellisbhastroud 14:08ac9aaa34c3 452 // CMD9, Response R2 (R1 byte + 16-byte block read)
ellisbhastroud 14:08ac9aaa34c3 453 if (_cmdx(9, 0) != 0) {
ellisbhastroud 14:08ac9aaa34c3 454 debug("Didn't get a response from the disk\n");
ellisbhastroud 14:08ac9aaa34c3 455 return 0;
ellisbhastroud 14:08ac9aaa34c3 456 }
ellisbhastroud 14:08ac9aaa34c3 457
ellisbhastroud 14:08ac9aaa34c3 458 uint8_t csd[16];
ellisbhastroud 14:08ac9aaa34c3 459 if (_read(csd, 16) != 0) {
ellisbhastroud 14:08ac9aaa34c3 460 debug("Couldn't read csd response from disk\n");
ellisbhastroud 14:08ac9aaa34c3 461 return 0;
ellisbhastroud 14:08ac9aaa34c3 462 }
ellisbhastroud 14:08ac9aaa34c3 463
ellisbhastroud 14:08ac9aaa34c3 464 // csd_structure : csd[127:126]
ellisbhastroud 14:08ac9aaa34c3 465 // c_size : csd[73:62]
ellisbhastroud 14:08ac9aaa34c3 466 // c_size_mult : csd[49:47]
ellisbhastroud 14:08ac9aaa34c3 467 // read_bl_len : csd[83:80] - the *maximum* read block length
ellisbhastroud 14:08ac9aaa34c3 468
ellisbhastroud 14:08ac9aaa34c3 469 int csd_structure = ext_bits(csd, 127, 126);
ellisbhastroud 14:08ac9aaa34c3 470
ellisbhastroud 14:08ac9aaa34c3 471 switch (csd_structure) {
ellisbhastroud 14:08ac9aaa34c3 472 case 0:
ellisbhastroud 14:08ac9aaa34c3 473 cdv = 512;
ellisbhastroud 14:08ac9aaa34c3 474 c_size = ext_bits(csd, 73, 62);
ellisbhastroud 14:08ac9aaa34c3 475 c_size_mult = ext_bits(csd, 49, 47);
ellisbhastroud 14:08ac9aaa34c3 476 read_bl_len = ext_bits(csd, 83, 80);
ellisbhastroud 14:08ac9aaa34c3 477
ellisbhastroud 14:08ac9aaa34c3 478 block_len = 1 << read_bl_len;
ellisbhastroud 14:08ac9aaa34c3 479 mult = 1 << (c_size_mult + 2);
ellisbhastroud 14:08ac9aaa34c3 480 blocknr = (c_size + 1) * mult;
ellisbhastroud 14:08ac9aaa34c3 481 capacity = blocknr * block_len;
ellisbhastroud 14:08ac9aaa34c3 482 blocks = capacity / 512;
ellisbhastroud 14:08ac9aaa34c3 483 debug_if(SD_DBG, "\n\rSDCard\n\rc_size: %d \n\rcapacity: %ld \n\rsectors: %lld\n\r", c_size, capacity, blocks);
ellisbhastroud 14:08ac9aaa34c3 484 break;
ellisbhastroud 14:08ac9aaa34c3 485
ellisbhastroud 14:08ac9aaa34c3 486 case 1:
ellisbhastroud 14:08ac9aaa34c3 487 cdv = 1;
ellisbhastroud 14:08ac9aaa34c3 488 hc_c_size = ext_bits(csd, 63, 48);
ellisbhastroud 14:08ac9aaa34c3 489 blocks = (hc_c_size+1)*1024;
ellisbhastroud 14:08ac9aaa34c3 490 debug_if(SD_DBG, "\n\rSDHC Card \n\rhc_c_size: %d\n\rcapacity: %lld \n\rsectors: %lld\n\r", hc_c_size, blocks*512, blocks);
ellisbhastroud 14:08ac9aaa34c3 491 break;
ellisbhastroud 14:08ac9aaa34c3 492
ellisbhastroud 14:08ac9aaa34c3 493 default:
ellisbhastroud 14:08ac9aaa34c3 494 debug("CSD struct unsupported\r\n");
ellisbhastroud 14:08ac9aaa34c3 495 return 0;
ellisbhastroud 14:08ac9aaa34c3 496 };
ellisbhastroud 14:08ac9aaa34c3 497 return blocks;
ellisbhastroud 14:08ac9aaa34c3 498 }