source: soft/giet_vm/giet_drivers/sdc_driver.h @ 542

Last change on this file since 542 was 536, checked in by alain, 10 years ago

Blap.

File size: 4.7 KB
Line 
1///////////////////////////////////////////////////////////////////////////////////
2// File     : sdc_driver.h
3// Date     : 31/08/2012
4// Author   : cesar fuguet
5// Copyright (c) UPMC-LIP6
6///////////////////////////////////////////////////////////////////////////////////
7
8#ifndef _GIET_SDC_DRIVER_H_
9#define _GIET_SDC_DRIVER_H_
10
11#include <spi_driver.h>
12#include <mapping_info.h>
13
14///////////////////////////////////////////////////////////////////////////////
15// SD card structure definition
16///////////////////////////////////////////////////////////////////////////////
17struct sdcard_dev
18{ 
19    // SPI controller pointer
20    struct spi_dev * spi;
21
22    // block length of the SDCARD
23    unsigned int block_length;
24
25    // access pointer representing the offset in bytes used to read or write in
26    // the SDCARD. This driver is for cards SDSD, therefore this offset must be
27    // multiple of the block length
28    unsigned int access_pointer;
29
30    // slave ID. This ID represents the number of the slave select signal used
31    // in the hardware platform (SPI channel)
32    int slave_id;
33
34    // is the card high capacity ?
35    int sdhc;
36};
37
38///////////////////////////////////////////////////////////////////////////////
39// This function initializes the SPI controller and call sdc_open to
40// initialize  the SD card
41// - channel: channel to initialize (only channel 0 supported)
42// Returns 0 if success, other value if failure
43///////////////////////////////////////////////////////////////////////////////
44unsigned int _sdc_init();
45
46///////////////////////////////////////////////////////////////////////////////
47// Transfer data between the block device and a memory buffer.
48// - use_irq   : not used, as DMA is not supported yet
49// - to_mem    : to memory if non zero
50// - lba       : first block index on the block device
51// - buf_vaddr : base address of the memory buffer
52// - count     : number of blocks to be transfered.
53// Returns 0 if success, > 0 if error.
54///////////////////////////////////////////////////////////////////////////////
55unsigned int _sdc_access( unsigned int       use_irq, 
56                          unsigned int       to_mem,
57                          unsigned int       lba,
58                          unsigned long long buf_vaddr,
59                          unsigned int       count);
60
61///////////////////////////////////////////////////////////////////////////////
62// SD card constants
63///////////////////////////////////////////////////////////////////////////////
64
65// Number of retries after an unacknowledge command
66#define SDCARD_COMMAND_TIMEOUT  100
67
68// This command is a simple SD commmand
69#define SDCARD_CMD              0
70
71// This is an application specific command
72#define SDCARD_ACMD             1
73
74// The transmition is done in the negative edge of the clock
75#define SDCARD_TX_NEGEDGE       0
76
77// The transmition is done in the positive edge of the clock
78#define SDCARD_TX_POSEDGE       1
79
80// The reception is done in the negative edge of the clock
81#define SDCARD_RX_NEGEDGE       0
82
83// The reception is done in the positive edge of the clock
84#define SDCARD_RX_POSEDGE       1
85
86///////////////////////////////////////////////////////////////////////////////
87// SD card macros
88///////////////////////////////////////////////////////////////////////////////
89
90///////////////////////////////////////////////////////////////////////////////
91//   SDCARD_CHECK_R1_VALID()
92// This macro checks if the SD card response is valid
93// - x: SD card response
94// Returns 1 if valid and 0 otherwise
95///////////////////////////////////////////////////////////////////////////////
96#define SDCARD_CHECK_R1_VALID(x)    (~x & SDCARD_R1_RSP_VALID) ? 1 : 0
97
98///////////////////////////////////////////////////////////////////////////////
99//   SDCARD_CHECK_R1_ERROR()
100// This macro checks if there is an error in SD card response
101// - x: SD card response
102// Returns 1 if error and 0 otherwise
103///////////////////////////////////////////////////////////////////////////////
104#define SDCARD_CHECK_R1_ERROR(x)    ( x & 0x7E)                ? 1 : 0
105
106// SD card response 1 (R1) format constants
107#define SDCARD_R1_IN_IDLE_STATE     ( 1 << 0 ) // R1 bit 0
108#define SDCARD_R1_ERASE_RESET       ( 1 << 1 ) // R1 bit 1
109#define SDCARD_R1_ILLEGAL_CMD       ( 1 << 2 ) // R1 bit 2
110#define SDCARD_R1_COM_CRC_ERR       ( 1 << 3 ) // R1 bit 3
111#define SDCARD_R1_ERASE_SEQ_ERR     ( 1 << 4 ) // R1 bit 4
112#define SDCARD_R1_ADDRESS_ERR       ( 1 << 5 ) // R1 bit 5
113#define SDCARD_R1_PARAMETER_ERR     ( 1 << 6 ) // R1 bit 6
114#define SDCARD_R1_RSP_VALID         ( 1 << 7 ) // R1 bit 7
115
116#endif
117
118// Local Variables:
119// tab-width: 4
120// c-basic-offset: 4
121// c-file-offsets:((innamespace . 0)(inline-open . 0))
122// indent-tabs-mode: nil
123// End:
124// vim: filetype=c:expandtab:shiftwidth=4:tabstop=4:softtabstop=4
Note: See TracBrowser for help on using the repository browser.