1. ioctl 接口概述
在 Linux 内核驱动开发中，ioctl（Input/Output Control）是设备驱动程序向用户空间应用程序提供“自定义控制命令”的核心接口。它允许应用程序绕过标准的 read/write 抽象，直接向设备发送特定控制码，执行硬件配置、状态查询、参数调节等非数据流操作。
核心定义：ioctl 是一个系统调用，原型为
int ioctl(int fd, unsigned long request, ...)。其中 fd 是设备文件描述符，request 是驱动程序定义的命令码，第三个参数为可选参数，通常用于传递用户空间与内核空间之间的数据缓冲区指针。
1.1 ioctl 在 Linux 驱动中的地位
ioctl 是 Linux 字符设备驱动三大标准文件操作（open、release、ioctl）之一，也是驱动开发者实现“设备特有功能”的主要手段。它在驱动架构中的位置如下图所示：
从上图可以看出，ioctl 与 read/write 处于同一层级，但承担完全不同的职责。在嵌入式系统中，ioctl 常用于：
- 设备参数配置：设置波特率、采样率、分辨率、工作模式等。
- 硬件状态查询：读取设备版本号、温度、错误计数、连接状态等。
- 特殊功能触发：启动校准、复位设备、进入低功耗模式、触发 DMA 传输等。
- 寄存器直接访问：在调试或测试阶段，通过 ioctl 直接读写硬件寄存器。
1.2 ioctl 与 read/write 的核心区别
理解 ioctl 与标准 read/write 的差异，是正确设计驱动接口的前提。下表从多个维度进行对比：
| 对比维度 | read / write | ioctl |
|---|---|---|
| 设计目的 | 数据流传输（连续数据块） | 控制/配置/状态查询（离散命令） |
| 操作语义 | 从设备读取数据 / 向设备写入数据 | 执行设备特定控制操作 |
| 命令标识 | 无（仅通过文件偏移区分） | 使用 32 位命令码（request）区分不同操作 |
| 参数传递 | 固定为数据缓冲区指针 + 长度 | 可变参数（指针、整数、结构体指针） |
| 数据方向 | 单向（read 从设备到用户，write 从用户到设备） | 双向（可读、可写、可读写，由命令码定义） |
| 典型场景 | 音频流、视频流、传感器数据采集 | 设置采样率、切换通道、启动校准、读取固件版本 |
| 驱动实现复杂度 | 较低（统一的数据拷贝逻辑） | 较高（需要解析命令码、处理多种参数类型） |
| 系统调用开销 | 较低（批量数据传输时摊销） | 较高（每次调用均需解析命令码） |
经验法则：如果操作涉及“设置一个值”或“读取一个状态”，使用 ioctl；如果操作涉及“传输一批数据”，使用 read/write。两者可以共存于同一个驱动中，互不冲突。
1.3 ioctl 的工作流程
一次完整的 ioctl 调用在用户空间和内核空间之间的交互流程如下：
注意：在 Linux 2.6.36 之后，内核移除了旧的
ioctl 函数指针，改用 unlocked_ioctl（无需大内核锁）和 compat_ioctl（32/64 位兼容）。现代驱动开发应使用 unlocked_ioctl。
1.4 ioctl 命令码的编码规范
Linux 内核为 ioctl 命令码定义了标准的编码格式，确保不同驱动之间的命令码不会冲突。命令码是一个 32 位整数，按位域划分为：
| 位域 | 位范围 | 名称 | 说明 |
|---|---|---|---|
| 31-30 | 2 位 | 方向（dir） | 00=无数据，01=写（用户→内核），10=读（内核→用户），11=读写 |
| 29-16 | 14 位 | 类型（type/magic） | 设备类型标识符，通常使用 ASCII 字符，如 'M'、'S'、'E' |
| 15-8 | 8 位 | 序号（nr） | 同一类型下的命令序号，从 0 开始递增 |
| 7-0 | 8 位 | 大小（size） | 参数数据大小（字节），最大 255 字节 |
内核提供了辅助宏来生成和解析命令码：
// 头文件：<linux/ioctl.h> 和 <asm-generic/ioctl.h>
// 定义命令码
#define MY_IOCTL_MAGIC 'M'
#define MY_IOCTL_GET_STATUS _IOR(MY_IOCTL_MAGIC, 0, int) // 读：获取状态
#define MY_IOCTL_SET_CONFIG _IOW(MY_IOCTL_MAGIC, 1, struct my_config) // 写：设置配置
#define MY_IOCTL_RW_PARAM _IOWR(MY_IOCTL_MAGIC, 2, struct my_param) // 读写：交换参数
// 解析命令码（驱动内部使用）
// _IOC_DIR(cmd) - 获取方向
// _IOC_TYPE(cmd) - 获取类型
// _IOC_NR(cmd) - 获取序号
// _IOC_SIZE(cmd) - 获取数据大小
最佳实践：始终使用
_IO、_IOR、_IOW、_IOWR 宏定义命令码，不要手动拼写 32 位数值。这可以保证命令码的唯一性和可移植性，并让代码阅读者一目了然地知道数据方向。
1.5 本章小结
- ioctl 是 Linux 驱动中实现“设备自定义控制命令”的标准接口，与 read/write 的数据流传输形成互补。
- ioctl 通过 32 位命令码区分不同操作，支持双向数据传递，适用于参数配置、状态查询、特殊功能触发等场景。
- 驱动开发者应使用
unlocked_ioctl函数指针，并遵循内核命令码编码规范，确保接口的标准化和兼容性。 - 理解 ioctl 与 read/write 的职责划分，是设计清晰、可维护驱动接口的第一步。