no-OS
Macros | Functions
sd.c File Reference

Implementation of SD card interface over SPI. More...

#include "sd.h"
#include "no-os/delay.h"
#include "no-os/error.h"
Include dependency graph for sd.c:

Macros

#define BIT_CCS   (1u<<30)
 
#define BIT_APPLICATION_CMD   (1u<<7)
 
#define CMD(x)   ((x) + 64)
 
#define ACMD(x)   (CMD(x) | BIT_APPLICATION_CMD)
 
#define CMD0_RETRY_NUMBER   (5u)
 
#define WAIT_RESP_TIMEOUT   (1000u)
 
#define R1_READY_STATE   (0x00u)
 
#define R1_IDLE_STATE   (0x01u)
 
#define R1_ILLEGAL_COMMAND   (0x04u)
 
#define R1_LEN   (1u)
 
#define R2_LEN   (2u)
 
#define R3_LEN   (5u)
 
#define R7_LEN   (5u)
 
#define CSD_LEN   (18u)
 
#define CRC_LEN   (2u)
 
#define CMD_LEN   (8u)
 
#define STUFF_ARG   (0x00000000u)
 
#define CMD8_ARG   (0x000001AAu)
 
#define ACMD41_ARG   (0x40000000u)
 
#define DATA_BLOCK_BITS   (9u)
 
#define MASK_ADDR_IN_BLOCK   (DATA_BLOCK_LEN - 1u)
 
#define MASK_BLOCK_NUMBER   (~(uint64_t)MASK_ADDR_IN_BLOCK)
 
#define START_1_BLOCK_TOKEN   (0xFEu)
 
#define START_N_BLOCK_TOKEN   (0xFCu)
 
#define STOP_TRANSMISSION_TOKEN   (0xFDu)
 
#define MASK_RESPONSE_TOKEN   (0x0Eu)
 
#define MASK_ERROR_TOKEN   (0xF0u)
 

Functions

int32_t sd_read (struct sd_desc *sd_desc, uint8_t *data, uint64_t address, uint64_t len)
 
int32_t sd_write (struct sd_desc *sd_desc, uint8_t *data, uint64_t address, uint64_t len)
 
int32_t sd_init (struct sd_desc **sd_desc, const struct sd_init_param *param)
 
int32_t sd_remove (struct sd_desc *desc)
 

Detailed Description

Implementation of SD card interface over SPI.

Author
Mihail Chindris (mihai.nosp@m.l.ch.nosp@m.indri.nosp@m.s@an.nosp@m.alog..nosp@m.com)

Copyright 2019(c) Analog Devices, Inc.

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ANALOG DEVICES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, INTELLECTUAL PROPERTY RIGHTS, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Macro Definition Documentation

◆ ACMD

#define ACMD (   x)    (CMD(x) | BIT_APPLICATION_CMD)

◆ ACMD41_ARG

#define ACMD41_ARG   (0x40000000u)

◆ BIT_APPLICATION_CMD

#define BIT_APPLICATION_CMD   (1u<<7)

◆ BIT_CCS

#define BIT_CCS   (1u<<30)

◆ CMD

#define CMD (   x)    ((x) + 64)

◆ CMD0_RETRY_NUMBER

#define CMD0_RETRY_NUMBER   (5u)

◆ CMD8_ARG

#define CMD8_ARG   (0x000001AAu)

◆ CMD_LEN

#define CMD_LEN   (8u)

◆ CRC_LEN

#define CRC_LEN   (2u)

◆ CSD_LEN

#define CSD_LEN   (18u)

◆ DATA_BLOCK_BITS

#define DATA_BLOCK_BITS   (9u)

◆ MASK_ADDR_IN_BLOCK

#define MASK_ADDR_IN_BLOCK   (DATA_BLOCK_LEN - 1u)

◆ MASK_BLOCK_NUMBER

#define MASK_BLOCK_NUMBER   (~(uint64_t)MASK_ADDR_IN_BLOCK)

◆ MASK_ERROR_TOKEN

#define MASK_ERROR_TOKEN   (0xF0u)

◆ MASK_RESPONSE_TOKEN

#define MASK_RESPONSE_TOKEN   (0x0Eu)

◆ R1_IDLE_STATE

#define R1_IDLE_STATE   (0x01u)

◆ R1_ILLEGAL_COMMAND

#define R1_ILLEGAL_COMMAND   (0x04u)

◆ R1_LEN

#define R1_LEN   (1u)

◆ R1_READY_STATE

#define R1_READY_STATE   (0x00u)

◆ R2_LEN

#define R2_LEN   (2u)

◆ R3_LEN

#define R3_LEN   (5u)

◆ R7_LEN

#define R7_LEN   (5u)

◆ START_1_BLOCK_TOKEN

#define START_1_BLOCK_TOKEN   (0xFEu)

◆ START_N_BLOCK_TOKEN

#define START_N_BLOCK_TOKEN   (0xFCu)

◆ STOP_TRANSMISSION_TOKEN

#define STOP_TRANSMISSION_TOKEN   (0xFDu)

◆ STUFF_ARG

#define STUFF_ARG   (0x00000000u)

◆ WAIT_RESP_TIMEOUT

#define WAIT_RESP_TIMEOUT   (1000u)

Function Documentation

◆ sd_init()

int32_t sd_init ( struct sd_desc **  sd_desc,
const struct sd_init_param param 
)

Initialize an instance of SD card and stores it to the parameter desc

Parameters
sd_desc- Pointer where to store the instance of the SD
param- Contains an initialized SPI descriptor
Returns
SUCCESS in case of success, FAILURE otherwise.

◆ sd_read()

int32_t sd_read ( struct sd_desc sd_desc,
uint8_t *  data,
uint64_t  address,
uint64_t  len 
)

Read data of size len from the specified address and store it in data. This operation returns only when the read is complete

Parameters
sd_desc- Instance of the SD card
data- Where data will be read
address- Address in memory from where data will be read
len- Length in bytes of data to be read
Returns
SUCCESS in case of success, FAILURE otherwise.
Here is the caller graph for this function:

◆ sd_remove()

int32_t sd_remove ( struct sd_desc desc)

Remove the initialize instance of SD card.

Parameters
desc- Instance of the SD card
Returns
SUCCESS in case of success, FAILURE otherwise.

◆ sd_write()

int32_t sd_write ( struct sd_desc sd_desc,
uint8_t *  data,
uint64_t  address,
uint64_t  len 
)

Write data of size len to the specified address This operation returns only when the write is complete

Parameters
sd_desc- Instance of the SD card
data- Data to write
address- Address in memory where data will be written
len- Length of data in bytes
Returns
SUCCESS in case of success, FAILURE otherwise.