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