2.13. SD

Overview

提供SD卡应用示例、实验现象。具体软件代码见 apps/common/system/device_mount.c

2.13.1. 应用示例

示例演示:

  • 芯片接口选择,

  • 引脚配置,

  • 单/四线配置,

  • 时钟配置,

  • 卡插拔检测方法配置

example: 示例工程实现需在 apps/demo/demo_DevKitBoard/include/demo_config.h 中开启宏 USE_SD_TEST_DEMO

Note

1.开启宏之后,还要在 app_config.h 添加SD基本配置。

//*********************************************************************************//
//                        SD 配置(暂只支持打开一个SD外设)                        //
//*********************************************************************************//
//SD0       cmd,  clk,  data0, data1, data2, data3
//A     PB6   PB7   PB5    PB5    PB3    PB2
//B     PA7   PA8   PA9    PA10   PA5    PA6
//C     PH1   PH2   PH0    PH3    PH4    PH5
//D     PC9   PC10  PC8    PC7    PC6    PC5

//SD1       cmd,  clk,  data0, data1, data2, data3
//A     PH6   PH7   PH5    PH4    PH3    PH2
//B     PC0   PC1   PC2    PC3    PC4    PC5

#define TCFG_SD0_ENABLE    1   //使用SD0 IO
//#define TCFG_SD1_ENABLE    1 //使用SD1 IO

#if (TCFG_SD0_ENABLE || TCFG_SD1_ENABLE)
#define TCFG_SD_PORTS                      'D'                      //SD0/SD1的ABCD组(默认为开发板SD0-D),注意:IO占用问题
#define TCFG_SD_DAT_WIDTH                  1                        //1:单线模式, 4:四线模式
#define TCFG_SD_DET_MODE                   SD_CMD_DECT      //检测模式:命令检测,时钟检测,IO检测
#define TCFG_SD_DET_IO                     IO_PORTA_01      //SD_DET_MODE为SD_IO_DECT时有效
#define TCFG_SD_DET_IO_LEVEL               0                        //IO检卡上线的电平(0/1),SD_DET_MODE为SD_IO_DECT时有效
#define TCFG_SD_CLK                        24000000         //SD时钟
#endif

#if TCFG_SD0_ENABLE
#define CONFIG_STORAGE_PATH         "storage/sd0"  //定义对应SD0的路径
#define SDX_DEV                                     "sd0"
#endif

#if TCFG_SD1_ENABLE
#define CONFIG_STORAGE_PATH         "storage/sd1" //定义对应SD1的路径
#define SDX_DEV                                     "sd1"
#endif

#ifndef CONFIG_STORAGE_PATH
#define CONFIG_STORAGE_PATH         "no_sd_card" //不使用SD定义对应别的路径,防止编译出错
#define SDX_DEV                                     "no_sd"
#endif

//指定根目录
#define CONFIG_ROOT_PATH            CONFIG_STORAGE_PATH"/C/" //定义对应SD文件系统的根目录路径

Note

说明:

  • 1)

    #define TCFG_SD_PORTS ‘D’ //该值设置的是SD0/1的某一组IO,如下:

    SD0

    cmd

    clk

    data0

    data1

    data2

    data3

    A

    PB6

    PB7

    PB5

    PB5

    PB3

    PB2

    B

    PA7

    PA8

    PA9

    PA10

    PA5

    PA6

    C

    PH1

    PH2

    PH0

    PH3

    PH4

    PH5

    D

    PC9

    PC10

    PC8

    PC7

    PC6

    PC5

    SD1

    cmd

    clk

    data0

    data1

    data2

    data3

    A

    PH6

    PH7

    PH5

    PH4

    PH3

    PH2

    B

    PC0

    PC1

    PC2

    PC3

    PC4

    PC5

  • 2)

    #define TCFG_SD_DAT_WIDTH 1 //1:单线模式, 4:四线模式(单线需要接data0,4线data0-data3都要接,同时还需要cmd clk)

    #define TCFG_SD_DET_MODE SD_CMD_DECT //检测模式:SD_CMD_DECT命令检测,SD_CLK_DECT时钟检测,SD_IO_DECT IO检测(IO检测接SD卡座子的第9个引脚,会多占用1个IO,不建议使用IO检测)

  • 3)

    当使用IO检测,则以下宏定义需要用到: #define TCFG_SD_DET_IO IO_PORTA_01 //SD卡座子的IO检测引脚接芯片端的IO #define TCFG_SD_DET_IO_LEVEL 0 //IO检卡上线的电平(0/1),一般SD座子的检测引脚为低电平0是上线

  • 4)

    如下图是 doc/datasheet/AC791N规格书/schematic 原理图文件的SD连接部分,SD接口选择了SD0的D口,

    本例子需要看数据手册的 doc/datasheet/AC791N规格书/datasheet

Note

除以上之外还要在board.c添加SD模块配置和SD设备。

/****************SD模块**********************************************************
* 暂只支持1个SD外设,如需要多个SD外设,自行去掉下面SD0/1_ENABLE控制,另外定义即可
********************************************************************************/
  #if (TCFG_SD0_ENABLE || TCFG_SD1_ENABLE)
  #if TCFG_SD0_ENABLE
  //sd0
  #define SD_PLATFORM_DATA_BEGIN() SD0_PLATFORM_DATA_BEGIN(sd0_data)
  #define SD_PLATFORM_DATA_END() SD0_PLATFORM_DATA_END()
  #define SD_CLK_DETECT_FUNC          sdmmc_0_clk_detect
  #elif TCFG_SD1_ENABLE
  //sd1
  #define SD_PLATFORM_DATA_BEGIN() SD1_PLATFORM_DATA_BEGIN(sd1_data)
  #define SD_PLATFORM_DATA_END() SD1_PLATFORM_DATA_END()
  #define SD_CLK_DETECT_FUNC          sdmmc_1_clk_detect
  #endif

  SD_PLATFORM_DATA_BEGIN()
          .port                                       = TCFG_SD_PORTS,
          .priority                           = 3,
          .data_width                         = TCFG_SD_DAT_WIDTH,
          .speed                                      = TCFG_SD_CLK,
          .detect_mode                        = TCFG_SD_DET_MODE,
  #if (TCFG_SD_DET_MODE == SD_CLK_DECT)
          .detect_func                        = SD_CLK_DETECT_FUNC,
  #elif (TCFG_SD_DET_MODE == SD_IO_DECT)
          .detect_func                        = sdmmc_0_io_detect,
  #else
          .detect_func                        = NULL,
          .power                  = NULL,//sd_set_power, //是否需要PB8提供SD电源
  #endif


  SD_PLATFORM_DATA_END()
  #endif
  /****************SD模块*********************/

  //下面添加到device_table设备的子设备
  #if TCFG_SD0_ENABLE
          { "sd0",  &sd_dev_ops, (void *)&sd0_data },
  #endif
  #if TCFG_SD1_ENABLE
          { "sd1",  &sd_dev_ops, (void *)&sd1_data },
  #endif

Note

.power参数说明: 某些芯片封装包含PB8,PB8硬件IO可以作为提供SD卡的VCC电源,当需要使用PB8作为SD的电源接口时,需配置 : .power = sd_set_power,当不需要PB8提供SD电源时,可以直接去掉.power 或者.power = NULL,即可。

注意: 当使用PB8作为SD的电源接口时,需要注意某些芯片封装内部会把PB8和其他IO绑在一块,此时需要设置其他IO为高阻态(关闭上下拉,关闭DIE,设置输入状态)。

注意: 对于sd的IO组使用时候注意IO是否有占用IO问题,例如:使用SD1的A组IO,注意board.c中的adc_data是否有配置了MIC或者AUX通道导致录音时候掉卡。具体IO组中的IO使用可参考原理图。

2.13.2. 实验现象

系统启动后,拔插SD卡可以从串口打印看见sd in mount sd success和sd out unmount sd .