SDIO 控制器介绍及使用场景

什么是 SDIO 控制器?

SDIO 控制器(Secure Digital Input Output Controller),它是嵌入式系统中非常重要的一个模块,用于通过 SD 接口连接各种 非存储类外设(如 Wi-Fi 模块、蓝牙模块、FPGA、自定义从设备等)。

  • 是一种扩展的 SD 主机控制器(SD Host Controller)。
  • 支持 SDIO 协议标准,可以与支持 SDIO 的从设备进行数据通信。
  • 属于 SD 协议的一部分,但面向的是 外设设备通信,而非存储。
  • 通信采用 命令(CMD)+ 数据(DAT0~DAT3)+ 时钟(CLK)
  • 支持 中断、寄存器访问、异步数据传输等功能。

接下来对其进行详细的说明,包括定义、架构、常见用途、并以瑞芯微RK3588为例说明与FPGA 设备通信的设计建议。


SDIO 通信架构

 +-------------------+ +--------------------+ | RK3588 (Host) | <---> | FPGA (Slave) | | | | | | SDIO Controller | | SDIO Slave Logic | +-------------------+ +--------------------+ 
  • 主设备(Host):RK3588(或任意ARM SoC)
  • 从设备(Slave):FPGA模拟SDIO设备,响应命令、返回数据
  • 典型线数:CMD、CLK、DAT0~DAT3、(可选中断线)

SDIO控制器的主要功能

功能类型说明
命令控制向设备发送 CMD0~CMD53 等命令
块/字节传输支持多块(multi-block)与字节级传输
总线宽度1-bit / 4-bit 模式可选
中断支持支持设备发起中断(IRQ)到主控
DMA支持部分 SoC 支持DMA,提升吞吐量

RK3588 的 SDIO 控制器支持

RK3588 内置多个 SDMMC/SDIO 控制器,部分通道可配置为 SDIO 模式

如何使用:

  1. 硬件连线
    • CMD, CLK, DAT0~DAT3 接 FPGA 或 WiFi/BT 模块
    • 可选:添加 CD(卡检测)和 WP(写保护)引脚
  2. 设备树配置 (Device Tree)
    • 指定为 sdio 模式,而非 mmc 存储设备模式
    • 启用中断、DMA、总线宽度参数等
  3. Linux 驱动
    • Kernel 中 SDIO 设备走的是 mmc core 框架
    • 主控通过 mmc host 驱动访问 SDIO 设备
    • FPGA 侧若为自定义设备,需要配套 sdio function 驱动开发

FPGA 实现 SDIO 从设备

在 FPGA 中实现 SDIO 从设备(Slave)逻辑,需要做到:

主要模块

模块功能
SDIO 命令解析器识别 CMD52(寄存器访问)/CMD53(数据传输)等命令
寄存器接口映射一些“逻辑地址”用于与 Host 通信
数据收发模块支持 block/byte 读写
CRC/校验模块SDIO 有严格的 CRC 校验,需兼容

SDIO 典型使用场景

场景描述
WiFi模块如 802.11n WiFi 芯片(ESP32、Realtek 等)
蓝牙模块如 BCM20702、RTL8723 等
FPGA通信FPGA伪装SDIO设备,与主控定制通信
工业IO扩展设备如 GPIO/ADC 采集模块

结论

  • SDIO 控制器是 RK3588 中标准而强大的外设接口,非常适合与 FPGA等定制设备通信。
  • 如果你需要比 SPI/UART 更高带宽、稳定性更好的通信方式,SDIO 是一个非常值得使用的方案
  • 不过你需要为 FPGA 实现或移植一个完整的 SDIO 从机协议栈,这通常是项目中较难的一部分。

附录:SDIO命令集

以下是 SDIO(Secure Digital Input Output)命令(CMD)0–53 的完整表格,以及每条命令的说明。

SDIO命令用于主机与SDIO从设备之间的通信,命令通常以 CMD 开头,编号从 CMD0CMD53,其中 CMD52CMD53 是特定的IO命令。


SDIO命令表(CMD0 – CMD53)

CMD编号命令名称类型描述
0GO_IDLE_STATEBasic复位所有卡到Idle状态。
1SEND_OP_CONDSDIO启动初始化过程,查询卡是否已准备好(仅MMC/SDIO)。
2ALL_SEND_CIDBroadcast获取卡的CID寄存器(卡识别码)。
3SEND_RELATIVE_ADDRAddressed分配并获取卡的RCA(相对地址)。
4SET_DSRI/O设置设备状态寄存器(极少使用)。
5IO_SEND_OP_CONDSDIO检查卡是否为SDIO类型,同时启动初始化过程。
6SWITCH_FUNCSD设置或查询卡功能组(如切换速度模式)。
7SELECT/DESELECT_CARDAddressed选择或取消选择卡。
8SEND_IF_CONDSD检查电压范围、接口条件(用于识别SD v2.0+)。
9SEND_CSDAddressed获取CSD寄存器(卡的容量、速度等参数)。
10SEND_CIDAddressed获取CID寄存器。
11READ_DAT_UNTIL_STOPDeprecated已废弃。读取数据直到发送STOP。
12STOP_TRANSMISSIONAddressed停止多块读/写操作。
13SEND_STATUSAddressed获取卡的状态寄存器。
14BUSTEST_RTest总线测试读取(用于制造测试)。
15GO_INACTIVE_STATEBroadcast将卡切换为Inactivate状态。
16SET_BLOCKLENAddressed设置块长度(默认512字节)。
17READ_SINGLE_BLOCKAddressed读取单个块数据。
18READ_MULTIPLE_BLOCKAddressed连续读取多个块。
19BUSTEST_WTest总线测试写入(用于制造测试)。
20WRITE_DAT_UNTIL_STOPDeprecated已废弃。写入数据直到STOP。
21Reserved保留命令。
22Reserved保留命令。
23SET_BLOCK_COUNTAddressed设置将要传输的块数(预写命令)。
24WRITE_BLOCKAddressed写入一个块数据。
25WRITE_MULTIPLE_BLOCKAddressed连续写入多个块数据。
26PROGRAM_CIDManufacturer编程CID寄存器(一次性写入)。
27PROGRAM_CSDManufacturer编程CSD寄存器(极少使用)。
28SET_WRITE_PROTAddressed设置写保护。
29CLR_WRITE_PROTAddressed清除写保护。
30SEND_WRITE_PROTAddressed查询写保护状态。
31SEND_WRITE_PROT_TYPEAddressed查询写保护类型(永久/临时)。
32ERASE_WR_BLK_STARTAddressed指定擦除操作的起始地址。
33ERASE_WR_BLK_ENDAddressed指定擦除操作的结束地址。
34Reserved保留命令。
35ERASE_GROUP_STARTAddressed指定擦除组起始地址(大容量卡)。
36ERASE_GROUP_ENDAddressed指定擦除组结束地址(大容量卡)。
37Reserved保留命令。
38ERASEAddressed执行擦除操作。
39FAST_IOSDIO单位寄存器级别写操作(用于寄存器IO,极少使用)。
40GO_IRQ_STATESDIO用于中断处理状态控制。
41Reserved保留(用于旧版兼容性)。
42LOCK_UNLOCKAddressed启用卡锁功能。
43–49Reserved保留命令。
50General CommandSDIO保留供未来SDIO使用。
51IO_RW_DIRECTSDIOSDIO直接读写命令(CMD52)别名。
52IO_RW_DIRECTSDIO直接读写单字节寄存器,用于配置。
53IO_RW_EXTENDEDSDIO用于读写多个字节(块/流)数据

补充说明

  • CMD52 和 CMD53 是SDIO通信中最关键的命令
    • CMD52(IO_RW_DIRECT):用于访问单字节寄存器(如功能寄存器、配置寄存器等)。
    • CMD53(IO_RW_EXTENDED):用于批量读写,可以是块模式或字节流模式,适用于高速数据传输。
  • 广播命令(Broadcast) 作用于总线上所有卡,而非特定卡。
  • Addressed 命令 作用于已分配相对地址(RCA)的单个卡。

Read more

ubuntu上安装OpenClaw并接入飞书机器人

ubuntu上安装OpenClaw并接入飞书机器人

大家好,我是一根甜苦瓜。今天来分享如何在本地安装openclaw并接入飞书,实现让AI给我打工。 最近AI圈更新太快了,从github copilot到cursor 到claud code ,再到codex,然后是最近火爆了的小龙虾(OpenClaw),可谓是百花齐放,应接不暇。本人也是github copilot+codex的深度用户,确实不错,所以最近打算折腾一下小龙虾,顺带教大家如何把智谱GLM 接入OpenClaw。 1. 前言 1.1 什么是openclaw 2026 年开年,AI 圈突然冒出一匹“野生黑马”——OpenClaw。这个开源个人 AI 助手项目在 GitHub 上只用了 两周时间就狂揽 15 万 Star,速度堪比开挂。 简单说,它就像给你配了一个 24 小时不下班的数字打工人: 把它部署在自己的电脑或服务器上,它就能接入 WhatsApp、Telegram、

企业微信群通知机器人添加点击链接教程(图文 / Markdown 两种方式)

在使用企业微信群通知机器人时,很多开发者会有 “能否添加可点击链接” 的需求 —— 比如推送文档地址、业务系统入口、数据报表链接等。答案是:完全可以!本文将详细介绍两种核心实现方式(图文消息 / Markdown 消息),附完整代码示例和注意事项,新手也能快速上手。 一、前置准备:已获取群机器人 Webhook 地址 在添加链接前,需先完成群机器人的创建并获取 Webhook 地址,步骤回顾: 1. 进入企业微信目标群聊 → 点击右上角 “...” → 选择 “添加群机器人” → 新建机器人并命名; 2. 创建成功后,复制系统生成的 Webhook 地址(格式类似 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx),后续发送请求需用到该地址。 二、两种添加点击链接的实现方式

【大模型应用篇】用 OpenClaw + 飞书打造 7x24 小时服务器运维机器人

【大模型应用篇】用 OpenClaw + 飞书打造 7x24 小时服务器运维机器人

前言 本文基于OpenClaw,也是最近超火的可在本地运行的AI Agent网关,记录从零搭建通过飞书对话管理服务器运维机器人的全过程。该机器人支持随时随地通过飞书查看服务器状态、检索日志、管理进程,其核心机制在于:由OpenClaw将聊天平台(飞书等)的消息路由至大模型,模型调用本地工具(如Shell、文件系统、浏览器)执行相应任务,最终将结果自动返回至飞书会话中,实现自动化运维交互。 架构概览 飞书 App (WebSocket 长连接)         ↕ OpenClaw Gateway (服务器上 systemd 常驻)         ↕ AI 模型 (DeepSeek v3.2/GLM 4.7)         ↕ 服务器 Shell (受白名单限制的命令执行) 核心组件: * OpenClaw Gateway:Agent 网关,管理会话、工具调用、渠道连接 * 飞书插件:通过

《机器人实践开发①:Foxglove 开发环境完整搭建指南(含常见坑位) 》

《机器人实践开发①:Foxglove 开发环境完整搭建指南(含常见坑位) 》

导语: 在机器人项目中,调试工具往往比算法本身更耗时间。Foxglove 作为新一代机器人可视化平台,提供了强大的话题订阅、视频显示、3D 展示和日志分析能力。本篇从零开始,手把手带你完成 Foxglove 的环境搭建,包含依赖安装、连接配置以及常见踩坑点。 《机器人实践开发》系列文章索引 《机器人实践开发①:Foxglove 开发环境完整搭建指南(含常见坑位)》 《机器人实践开发②:Foxglove 嵌入式移植 + CMake 集成》 《机器人实践开发③:Foxglove可视化机器人的眼睛-视频》 《机器人实践开发④:Foxglove可视化机器人的耳朵-声音》 《机器人实践开发⑤:Foxglove可视化机器人的3D显示》 《机器人实践开发⑥:Foxglove可视化机器人传感器数据》 《机器人实践开发⑦:Foxglove可视化机器人的日志显示》 《机器人实践开发⑧:Foxglove可视化机器人的地图显示》 《机器人实践开发⑨:Foxglove可视化机器人的MyBag 数据回放》 foxglove 官网 Foxglove 是一个专为机器人团队打造的平台,用于收