sd_card_spi.h

#pragma once
 
/************************************************************************************************
 * @file    sd_card_spi.h
 *
 * @brief   Sd Card Spi
 *
 * @date    2025-06-07
 * @author  Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <status.h>
#include <stddef.h>
#include <stdint.h>
 
/* Inter-component Headers */
#include "gpio.h"
 
/* Intra-component Headers */
 
typedef enum {
  SPI_PORT_1 = 0, 
  SPI_PORT_2,     
  SPI_PORT_3,     
  NUM_SPI_PORTS,  
} SdSpiPort;
 
typedef enum {
  SD_SPI_MODE_0 = 0,  // CPOL: 0 CPHA: 0
  SD_SPI_MODE_1,      // CPOL: 0 CPHA: 1
  SD_SPI_MODE_2,      // CPOL: 1 CPHA: 0
  SD_SPI_MODE_3,      // CPOL: 1 CPHA: 1
  NUM_SD_SPI_MODES,
} SdSpiMode;
 
typedef struct {
  uint32_t baudrate;
  SdSpiMode mode;
 
  GpioAddress mosi;
  GpioAddress miso;
  GpioAddress sclk;
  GpioAddress cs;
} SdSpiSettings;
 
/*  Constant + Macros */
#define SD_BLOCK_SIZE 512U
#define SD_SPI_INIT_LOW_FREQ_HZ 400000U
#define SD_SPI_INIT_HIGH_FREQ_HZ 25000000U
 
StatusCode sd_card_spi_init(SdSpiPort p, SdSpiSettings *settings);
 
StatusCode sd_read_blocks(SdSpiPort p, uint8_t *dst, uint32_t lba, uint32_t number_of_blocks);
 
StatusCode sd_write_blocks(SdSpiPort p, uint8_t *src, uint32_t lba, uint32_t number_of_blocks);
 
StatusCode sd_is_initialized(SdSpiPort p);