KallistiOS  ##version##
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups
Functions
sd.h File Reference

Block-level access to an SD card attached to the SCIF port. More...

#include <sys/cdefs.h>
#include <arch/types.h>
#include <kos/blockdev.h>

Go to the source code of this file.

Functions

uint8 sd_crc7 (const uint8 *data, int size, uint8 crc)
 Calculate a SD/MMC-style CRC over a block of data. More...
 
int sd_init (void)
 Initialize the SD card for use. More...
 
int sd_shutdown (void)
 Shut down SD card support. More...
 
int sd_read_blocks (uint32 block, size_t count, uint8 *buf)
 Read one or more blocks from the SD card. More...
 
int sd_write_blocks (uint32 block, size_t count, const uint8 *buf)
 Write one or more blocks to the SD card. More...
 
uint64 sd_get_size (void)
 Retrieve the size of the SD card. More...
 
int sd_blockdev_for_partition (int partition, kos_blockdev_t *rv, uint8 *partition_type)
 Get a block device for a given partition on the SD card. More...
 

Detailed Description

Block-level access to an SD card attached to the SCIF port.

This file contains the interface to working with the SD card reader that was designed by jj1odm. The SD card reader itself connects to the SCIF port and uses it basically as a simple SPI bus.

For reference, all I/O through this code should be done in the order of SD card blocks (which are 512 bytes a piece). Also, this should adequately support SD and SDHC cards (and possibly SDXC, but I don't have any of them to try out).

This code doesn't directly implement any filesystems on top of the SD card, but rather provides you with direct block-level access. This probably will not be useful to most people in its current form (without a filesystem), but this will provide you with all of the building blocks you should need to actually make it work for you.

Due to the patent-encumbered nature of certain parts of the FAT32 filesystem, that filesystem will likely never be supported in KOS proper (unless, of course, people are still using KOS after those patents expire). I'm not going to encourage anyone to violate Microsoft's patents on FAT32 and I'm not going to be the enabler for anyone to do so either. So, if you want FAT32, you're on your own.

Author
Lawrence Sebald
See also
dc/scif.h

Function Documentation

int sd_blockdev_for_partition ( int  partition,
kos_blockdev_t rv,
uint8 partition_type 
)

Get a block device for a given partition on the SD card.

This function creates a block device descriptor for the given partition on the attached SD card. This block device is used to interface with various filesystems on the device.

Parameters
partitionThe partition number (0-3) to use.
rvUsed to return the block device. Must be non-NULL.
partition_typeUsed to return the partition type. Must be non-NULL.
Return values
0On success.
-1On error, errno will be set as appropriate.
Error Conditions:
ENXIO - SD card support was not initialized
EIO - an I/O error occurred in reading data
EINVAL - invalid partition number was given
EFAULT - rv or partition_type was NULL
ENOENT - no MBR found
ENOENT - no partition at the specified position
ENOMEM - out of memory
Note
This interface currently only supports MBR-formatted SD cards. There is currently no support for GPT partition tables.
uint8 sd_crc7 ( const uint8 data,
int  size,
uint8  crc 
)

Calculate a SD/MMC-style CRC over a block of data.

This function calculates a 7-bit CRC over a given block of data. The polynomial of this CRC is x^7 + x^3 + 1. The CRC is shifted into the upper 7 bits of the return value, so bit 0 should always be 0.

Parameters
dataThe block of data to calculate the CRC over.
sizeThe number of bytes in the block of data.
crcThe starting value of the calculation. If you're passing in a full block, this will probably be 0.
Returns
The calculated CRC.
uint64 sd_get_size ( void  )

Retrieve the size of the SD card.

This function reads the size of the SD card from the card's CSD register. This is the raw size of the card, not its formatted capacity. To get the number of blocks from this, divide by 512.

Returns
On succes, the raw size of the SD card in bytes. On error, (uint64)-1.
Error Conditions:
EIO - an I/O error occurred in reading data
ENXIO - SD card support was not initialized
int sd_init ( void  )

Initialize the SD card for use.

This function initializes the SD card for first use. This includes all steps of the basic initialization sequence for SPI mode, as documented in the SD card spec and at http://elm-chan.org/docs/mmc/mmc_e.html . This also will call scif_sd_init() for you, so you don't have to worry about that ahead of time.

Return values
0On success.
-1On failure. This could indicate any number of problems, but probably means that no SD card was detected.
int sd_read_blocks ( uint32  block,
size_t  count,
uint8 buf 
)

Read one or more blocks from the SD card.

This function reads the specified number of blocks from the SD card from the beginning block specified into the buffer passed in. It is your responsibility to allocate the buffer properly for the number of bytes that is to be read (512 * the number of blocks requested).

Parameters
blockThe starting block number to read from.
countThe number of 512 byte blocks of data to read.
bufThe buffer to read into.
Return values
0On success.
-1On error, errno will be set as appropriate.
Error Conditions:
EIO - an I/O error occurred in reading data
ENXIO - SD card support was not initialized
int sd_shutdown ( void  )

Shut down SD card support.

This function shuts down SD card support, and cleans up anything that the sd_init() function set up.

Return values
0On success.
-1On failure. The only currently defined error is if the card was never initialized to start with.
int sd_write_blocks ( uint32  block,
size_t  count,
const uint8 buf 
)

Write one or more blocks to the SD card.

This function writes the specified number of blocks to the SD card at the beginning block specified from the buffer passed in. Each block is 512 bytes in length, and you must write at least one block at a time. You cannot write partial blocks.

If this function returns an error, you have quite possibly corrupted something on the card or have a damaged card in general (unless errno is ENXIO).

Parameters
blockThe starting block number to write to.
countThe number of 512 byte blocks of data to write.
bufThe buffer to write from.
Return values
0On success.
-1On error, errno will be set as appropriate.
Error Conditions:
EIO - an I/O error occurred in reading data
ENXIO - SD card support was not initialized