Loading...
Searching...
No Matches
sd.c File Reference
SD card driver implementation file. More...
#include <stdbool.h>#include <string.h>#include "sd.h"#include "common.h"#include "err.h"#include "init.h"#include "io.h"#include "log.h"#include "modules.h"#include "cmd.h"#include "configuration.h"#include "stm32f401re.h"#include "stm32f401re_gpio.h"#include "stm32f401re_rcc.h"#include "stm32f401re_spi.h"#include "arm_cortex_m4_systick.h"
Include dependency graph for sd.c:
Go to the source code of this file.
Classes | |
| struct | CMD_RESPONSE_ts |
| Holds the R1, R3, and R7 response bytes returned by the SD card after a command. More... | |
| struct | SD_CSD_INFO_ts |
| Decoded contents of the SD card CSD register. More... | |
| struct | sd_handle_s |
| Internal structure representing a single SD card handle instance. More... | |
| struct | internal_state_s |
| Internal state of the SysTick driver. More... | |
Functions | |
| static ERR_te | sd_go_idle_state (SD_HANDLE_ts *sd_handle) |
| Issues CMD0 to reset the SD card into idle (SPI) mode. | |
| static ERR_te | sd_send_if_cond (SD_HANDLE_ts *sd_handle, bool *match_o, bool *no_resp_o) |
| Issues CMD8 to determine whether the card is SD Ver.2 or older. | |
| static ERR_te | sd_app_send_op_cond (SD_HANDLE_ts *sd_handle, uint32_t arg) |
| Issues ACMD41 to initiate SD card initialization (SD Ver.2 and Ver.1). | |
| static ERR_te | sd_read_ocr (SD_HANDLE_ts *sd_handle) |
| Reads the OCR register via CMD58 and stores power-up status, addressing mode, and voltage range. | |
| static ERR_te | sd_send_op_cond (SD_HANDLE_ts *sd_handle) |
| Issues CMD1 to initiate MMC Ver.3 card initialization. | |
| static ERR_te | sd_set_blocklen (SD_HANDLE_ts *sd_handle) |
| Issues CMD16 to set the block length to 512 bytes for byte-addressed cards. | |
| static ERR_te | sd_read_csd (SD_HANDLE_ts *sd_handle) |
| Issues CMD9 to read the CSD register and stores capacity information in the handle. | |
| static ERR_te | decode_csd_v1 (const uint8_t *csd_raw, SD_CSD_INFO_ts *csd_info_o) |
| Decodes a CSD v1.0 register (SDSC cards) into a SD_CSD_INFO_ts structure. | |
| static ERR_te | decode_csd_v2 (const uint8_t *csd_raw, SD_CSD_INFO_ts *csd_info_o) |
| Decodes a CSD v2.0 register (SDHC/SDXC cards) into a SD_CSD_INFO_ts structure. | |
| static ERR_te | sd_send_cmd (SPI_REGDEF_ts *spi_instance, uint8_t index, uint32_t arg, bool acmd, CMD_RESPONSE_ts *cmd_response_o) |
| Transmits a single SPI-mode SD command and receives the response. | |
| static ERR_te | sd_cease_comms (SD_HANDLE_ts *sd_handle, bool deinit) |
| Raises CS, sends two dummy bytes, and disables SPI. Optionally deinitializes the handle. | |
| static ERR_te | sd_cmd_list_handler (uint32_t argc, char **argv) |
| CLI handler for the "list" command. Logs the names of all active SD card handles. | |
| static ERR_te | sd_cmd_info_handler (uint32_t argc, char **argv) |
| CLI handler for the "info" command. Logs detailed information about a named SD card handle. | |
| ERR_te | sd_init_subsys (void) |
| Initializes the SD card subsystem. | |
| ERR_te | sd_deinit_subsys (void) |
| Deinitializes the SD card subsystem. | |
| ERR_te | sd_start_subsys (void) |
| Starts the SD card subsystem. | |
| ERR_te | sd_stop_subsys (void) |
| Stops the SD card subsystem. | |
| ERR_te | sd_init_handle (SD_CFG_ts *sd_cfg, SD_HANDLE_ts **sd_handle_o) |
| Initializes an SD card handle and performs the full SPI-mode power-up sequence. | |
| ERR_te | sd_deinit_handle (SD_HANDLE_ts *sd_handle) |
| Deinitializes an SD card handle and resets the SPI peripheral. | |
| ERR_te | sd_get_handle_init (SD_HANDLE_ts *sd_handle, bool *handle_init_o) |
| Retrieves the initialization state of an SD card handle. | |
| ERR_te | sd_get_sector_count (SD_HANDLE_ts *sd_handle, uint32_t *sector_count_o) |
| Retrieves the total sector (block) count of the SD card. | |
| ERR_te | sd_get_sector_size (SD_HANDLE_ts *sd_handle, uint32_t *sector_size_o) |
| Retrieves the sector (block) size of the SD card in bytes. | |
| ERR_te | sd_read (SD_HANDLE_ts *sd_handle, uint8_t *read_buf, uint32_t start_sector, uint32_t num_sectors) |
| Reads one or more sectors from the SD card. | |
| ERR_te | sd_write (SD_HANDLE_ts *sd_handle, uint8_t *write_buf, uint32_t start_sector, uint32_t num_sectors) |
| Writes one or more sectors to the SD card. | |
Variables | |
| struct internal_state_s | internal_state |
| Singleton instance of the SD card subsystem internal state. | |
| CMD_INFO_ts | sd_cmds [] |
| Table of CLI commands registered by the SD card subsystem. | |
| CMD_CLIENT_INFO_ts | sd_cmd_client_info |
| Registration descriptor passed to the command subsystem. | |
Detailed Description
SD card driver implementation file.
- Version
- 0.1
- Date
- 2026-02-05
- Copyright
- Copyright (c) 2026
Definition in file sd.c.
Enumeration Type Documentation
◆ OCR_te
| enum OCR_te |
Bit positions within the 32-bit OCR register.
Used to extract individual fields from the OCR value reconstructed from the R3 response of CMD58. Voltage range bits 4–23 each represent a 100 mV window; bit 30 is the Card Capacity Status (0 = SDSC, 1 = SDHC); bit 31 is the power-up completion flag.
Definition at line 54 of file sd.c.
54 {
55 OCR_1_7V_1_6V = 4,
56 OCR_1_8V_1_7V,
57 OCR_1_9V_1_8V,
58 OCR_2_0V_1_9V,
59 OCR_2_1V_2_0V,
60 OCR_2_2V_2_1V,
61 OCR_2_3V_2_2V,
62 OCR_2_4V_2_3V,
63 OCR_2_5V_2_4V,
64 OCR_2_6V_2_5V,
65 OCR_2_7V_2_6V,
66 OCR_2_8V_2_7V,
67 OCR_2_9V_2_8V,
68 OCR_3_0V_2_9V,
69 OCR_3_1V_3_0V,
70 OCR_3_2V_3_1V,
71 OCR_3_3V_3_2V,
72 OCR_3_4V_3_3V,
73 OCR_3_5V_3_4V,
74 OCR_3_6V_3_5V,
75 OCR_CAPACITY_STATUS = 30,
77} OCR_te;
◆ SD_MIN_OPERATING_VOLTAGE_te
Minimum allowed operating voltage of the SD card, decoded from the OCR register.
Definition at line 82 of file sd.c.
82 {
SD_MIN_OPERATING_VOLTAGE_te
Minimum allowed operating voltage of the SD card, decoded from the OCR register.
Definition sd.c:82
◆ SD_MAX_OPERATIING_VOLTAGE_te
Maximum allowed operating voltage of the SD card, decoded from the OCR register.
Definition at line 108 of file sd.c.
108 {
SD_MAX_OPERATIING_VOLTAGE_te
Maximum allowed operating voltage of the SD card, decoded from the OCR register.
Definition sd.c:108
◆ SD_ADDR_MODE_te
| enum SD_ADDR_MODE_te |
Addressing mode used by the SD card for read/write sector addresses.
| Enumerator | |
|---|---|
| SD_ADDR_MODE_BYTE | Byte addressing (SDSC cards). Address = sector × block length. |
| SD_ADDR_MODE_BLOCK | Block addressing (SDHC/SDXC cards). Address = sector number directly. |
Definition at line 134 of file sd.c.
134 {
135 SD_ADDR_MODE_BYTE,
137} SD_ADDR_MODE_te;
SD_ADDR_MODE_te
Addressing mode used by the SD card for read/write sector addresses.
Definition sd.c:134
◆ SD_PWRUP_STATUS_te
| enum SD_PWRUP_STATUS_te |
Power-up completion status decoded from the OCR register.
| Enumerator | |
|---|---|
| SD_PWRUP_STATUS_BUSY | Card is still completing its power-up sequence. |
| SD_PWRUP_STATUS_READY | Card has completed power-up and is ready for commands. |
Definition at line 142 of file sd.c.
142 {
143 SD_PWRUP_STATUS_BUSY,
145} SD_PWRUP_STATUS_te;
◆ SD_TYPE_te
| enum SD_TYPE_te |
Card type decoded from the OCR Capacity Status bit.
| Enumerator | |
|---|---|
| SDSC | Standard Capacity SD card (byte addressing, ≤ 2 GB). |
| SDHC | High Capacity SD card (block addressing, > 2 GB). |
Variable Documentation
◆ internal_state
| struct internal_state_s internal_state |
◆ sd_cmds
| CMD_INFO_ts sd_cmds[] |
Initial value:
= {
{
.name = "list",
.help = "Lists active sd objects, usage: sd list",
.handler = sd_cmd_list_handler
},
{
.name = "info",
.help = "Shows sd object info, usage: sd info <sd object>",
.handler = sd_cmd_info_handler
}
}
static ERR_te sd_cmd_info_handler(uint32_t argc, char **argv)
CLI handler for the "info" command. Logs detailed information about a named SD card handle.
Definition sd.c:1803
static ERR_te sd_cmd_list_handler(uint32_t argc, char **argv)
CLI handler for the "list" command. Logs the names of all active SD card handles.
Definition sd.c:1761
Table of CLI commands registered by the SD card subsystem.
Registered with the command subsystem via sd_cmd_client_info during sd_init_subsys.
Definition at line 292 of file sd.c.
292 {
293 {
294 .name = "list",
295 .help = "Lists active sd objects, usage: sd list",
296 .handler = sd_cmd_list_handler
297 },
298 {
299 .name = "info",
300 .help = "Shows sd object info, usage: sd info <sd object>",
301 .handler = sd_cmd_info_handler
302 }
303};
◆ sd_cmd_client_info
| CMD_CLIENT_INFO_ts sd_cmd_client_info |
Initial value:
= {
.cmds_ptr = sd_cmds,
.log_level_ptr = &internal_state.log_level,
.name = "sd"
}
static struct internal_state_s internal_state
Singleton instance of the SysTick driver internal state.
Definition arm_cortex_m4_systick.c:33
Registration descriptor passed to the command subsystem.
Bundles the command table, its size, the subsystem name prefix used on the CLI, and a pointer to the runtime log-level variable.
Definition at line 312 of file sd.c.
312 {
313 .cmds_ptr = sd_cmds,
315 .log_level_ptr = &internal_state.log_level,
316 .name = "sd"
317};
