接口设计

3 Mar 2025

Read time: 3 minute(s)

以下接口皆为 MMC 子系统所需要的标准接口，通过 mmc_host_ops 注册到 MMC 子系统。

static const struct mmc_host_ops artinchip_mmc_ops = {
    .request        = artinchip_mmc_request,
    .pre_req        = artinchip_mmc_pre_req,
    .post_req       = artinchip_mmc_post_req,
    .set_ios        = artinchip_mmc_set_ios,
    .get_ro         = artinchip_mmc_get_ro,
    .get_cd         = artinchip_mmc_get_cd,
    .hw_reset               = artinchip_mmc_hw_reset,
    .enable_sdio_irq    = artinchip_mmc_enable_sdio_irq,
    .ack_sdio_irq       = artinchip_mmc_ack_sdio_irq,
    .execute_tuning     = artinchip_mmc_execute_tuning,
    .card_busy      = artinchip_mmc_card_busy,
    .start_signal_voltage_switch = artinchip_mmc_switch_voltage,
    .init_card      = artinchip_mmc_init_card,
};

表 1. artinchip_mmc_request
函数原型	static void artinchip_mmc_request(struct mmc_host mmc, struct mmc_request mrq)
功能说明	读取当前的 RTC 时间
功能说明	操作寄存器实现 request
参数定义	mmc：MMC 设备指针 mrq：请求的参数和资源
返回值	-
注意事项	-

表 2. artinchip_mmc_pre_req
函数原型	static void artinchip_mmc_pre_req(struct mmc_host mmc, struct mmc_request mrq)
功能说明	准备下一个 request
参数定义	mmc：MMC 设备指针 mrq：请求的参数和资源
返回值	-
注意事项	在准备下一个请求前，一般需要调用 artinchip_mmc_post_request

表 3. artinchip_mmc_post_req
函数原型	static void artinchip_mmc_post_req(struct mmc_host mmc, struct mmc_request mrq, int err)
功能说明	送出一个 request
参数定义	mmc：MMC 设备指针 mrq：请求的参数和资源 err：如果非零，需要清理掉 pre_req() 中申请的资源
返回值	-
注意事项	-

表 4. artinchip_mmc_set_ios
函数原型	static void artinchip_mmc_set_ios(struct mmc_host mmc, struct mmc_ios ios)
功能说明	对设备的位宽、DDR 模式、clock、power 模式等进行配置
参数定义	mmc：MMC 设备指针 ios：配置参数
返回值	-
注意事项	-

表 5. artinchip_mmc_get_cd
函数原型	static int artinchip_mmc_get_cd(struct mmc_host *mmc)
功能说明	探测外部 SD 设备
参数定义	mmc：MMC 设备指针
返回值	执行成功则返回 1
注意事项	-

表 6. artinchip_mmc_hw_reset
函数原型	static void artinchip_mmc_hw_reset(struct mmc_host *mmc)
功能说明	对 MMC 控制器、DMA 等进行一次 reset
参数定义	mmc：MMC 设备指针
返回值	-
注意事项	-

表 7. artinchip_mmc_enable_sdio_irq
函数原型	static void artinchip_mmc_enable_sdio_irq(struct mmc_host *mmc, int enb)
功能说明	使能或者关闭 MMC 控制器的中断
参数定义	mmc：MMC 设备指针 enb：使能开关
返回值	-
注意事项	-

表 8. artinchip_mmc_ack_sdio_irq
函数原型	static void artinchip_mmc_ack_sdio_irq(struct mmc_host *mmc)
功能说明	打开 MMC 控制器的中断
参数定义	mmc：MMC 设备指针
返回值	-
注意事项	-

表 9. artinchip_mmc_execute_tuning
函数原型	static int artinchip_mmc_execute_tuning(struct mmc_host *mmc, u32 opcode)
功能说明	MMC 的 tuning 功能接口
参数定义	mmc：MMC 设备指针 opcode：tuning 命令码
返回值	-
注意事项	-

表 10. artinchip_mmc_card_busy
函数原型	static int artinchip_mmc_card_busy(struct mmc_host *mmc)
功能说明	查看 MMC 设备是否处于 Busy 状态
参数定义	mmc：MMC 设备指针
返回值	若处于 idle 状态返回 0，busy 则返回 1
注意事项	-

表 11. artinchip_mmc_switch_voltage
函数原型	static int artinchip_mmc_switch_voltage(struct mmc_host mmc, struct mmc_ios ios)
功能说明	设置 MMC 设备的工作电压
参数定义	mmc：MMC 设备指针 ios：设置参数
返回值	0，成功。 < 0，失败
注意事项	-

表 12. artinchip_mmc_init_card
函数原型	static void artinchip_mmc_init_card(struct mmc_host mmc, struct mmc_card card)
功能说明	初始化外部 mmc 设备
参数定义	mmc：MMC 设备指针 card：card 设备指针
返回值	-
注意事项	-