4、PX4设备框架：设备框架设计思想、设备注册与注销、设备文件操作接口

好，咱们今天聊聊PX4的设备框架。说实话，这个框架是PX4驱动开发的基石。你想想看，一个飞控上挂了多少设备？GPS、IMU、气压计、磁力计、舵机、电调……如果没有一套统一的框架来管理，那代码得乱成什么样？

我在做第一个PX4驱动时，就犯过这个错。当时图省事，直接在模块里裸调硬件寄存器。结果呢？代码耦合得一塌糊涂，换个硬件平台，几乎要重写。后来老老实实啃了设备框架，才明白什么叫「先设计，后编码」。

4.1 设备框架的设计思想

PX4的设备框架，说白了就是一套「标准化接口」。它把硬件设备抽象成一个个对象，然后通过统一的API来操作。这样做的好处很明显：

• 解耦：驱动代码和业务逻辑分开，你改驱动不影响上层应用
• 可移植：换一个MCU，只要实现底层接口就行，上层代码不用动
• 易扩展：加一个新设备，就像插个U盘一样简单

框架的核心思想是「设备即文件」。在NuttX（PX4底层的RTOS）里，每个设备都对应一个文件描述符。你打开设备、读写设备、关闭设备，用的都是标准的文件操作函数——open()、read()、write()、ioctl()、close()。

我习惯把设备框架分成三层：

1. 设备驱动层：直接跟硬件打交道，读写寄存器、处理中断
2. 设备管理层：负责设备的注册、注销、查找、引用计数
3. 应用接口层：给上层应用提供统一的文件操作接口

这三层各司其职，互不干扰。嗯，这里要注意：驱动层不要越界去管设备管理的事，否则框架就白设计了。

4.2 设备注册与注销

设备注册，就是把一个驱动实例「挂」到系统里。注销，就是把它「摘」下来。这个过程看似简单，但坑不少。

4.2.1 设备注册

在PX4里，设备注册用的是register_driver()函数。它的原型是这样的：

int register_driver(const char *path, const struct file_operations *fops, 
                    mode_t mode, void *priv);

参数说明：

参数	说明
path	设备路径，比如 /dev/gyro0
fops	文件操作结构体，包含 open/read/write/ioctl 等函数指针
mode	访问权限，通常用 0666
priv	私有数据指针，指向你的驱动实例

举个例子，注册一个虚拟的陀螺仪设备：

static const struct file_operations gyro_fops = {
    .open  = gyro_open,
    .read  = gyro_read,
    .write = gyro_write,
    .ioctl = gyro_ioctl,
    .close = gyro_close,
};

int gyro_register(const char *path, struct gyro_dev_s *dev)
{
    int ret;
    
    ret = register_driver(path, &gyro_fops, 0666, dev);
    if (ret != OK) {
        // 我曾经在这里吃过亏——注册失败后没有清理资源
        // 导致内存泄漏，排查了好久
        return -EIO;
    }
    
    return OK;
}

4.2.2 设备注销

注销设备用unregister_driver()：

int unregister_driver(const char *path);

调用很简单，但要注意时机。我见过有人直接在驱动卸载函数里调用unregister_driver()，结果设备还在被其他线程使用，一注销就崩溃。

4.3 设备文件操作接口

文件操作接口是设备框架的「门面」。上层应用通过它们来跟设备交互。每个接口都有明确的语义和约定。

4.3.1 open() 和 close()

open() 在设备被打开时调用，通常用来初始化硬件、分配资源。close() 则相反，用来释放资源。

static int gyro_open(struct file *filp)
{
    struct gyro_dev_s *dev = (struct gyro_dev_s *)filp->f_priv;
    
    // 增加引用计数
    dev->ref_count++;
    
    // 如果是第一次打开，初始化硬件
    if (dev->ref_count == 1) {
        gyro_hw_init(dev);
    }
    
    return OK;
}

static int gyro_close(struct file *filp)
{
    struct gyro_dev_s *dev = (struct gyro_dev_s *)filp->f_priv;
    
    // 减少引用计数
    dev->ref_count--;
    
    // 如果没有人在用了，关闭硬件
    if (dev->ref_count == 0) {
        gyro_hw_deinit(dev);
    }
    
    return OK;
}

你想想看，为什么要在open()里做引用计数？因为多个应用可能同时打开同一个设备。比如姿态估计和日志记录都要读陀螺仪数据。如果每次open都初始化硬件，那第二个open就会把第一个的配置冲掉。

4.3.2 read() 和 write()

read() 从设备读取数据，write() 向设备写入数据。对于传感器，通常只实现read()；对于执行器（比如舵机），通常只实现write()。

static ssize_t gyro_read(struct file *filp, char *buffer, size_t buflen)
{
    struct gyro_dev_s *dev = (struct gyro_dev_s *)filp->f_priv;
    struct gyro_data_s data;
    size_t bytes_to_copy;
    
    // 从硬件读取最新数据
    gyro_hw_read(dev, &data);
    
    // 拷贝到用户空间
    bytes_to_copy = (buflen < sizeof(data)) ? buflen : sizeof(data);
    memcpy(buffer, &data, bytes_to_copy);
    
    return bytes_to_copy;
}

4.3.3 ioctl()

ioctl() 是「万能接口」。那些不适合用 read/write 表达的操作，比如设置采样率、校准传感器、切换工作模式，都通过它来实现。

static int gyro_ioctl(struct file *filp, int cmd, unsigned long arg)
{
    struct gyro_dev_s *dev = (struct gyro_dev_s *)filp->f_priv;
    
    switch (cmd) {
    case GYROIOC_SETFREQ:
        // 设置采样频率
        dev->sample_rate = (uint32_t)arg;
        gyro_hw_set_freq(dev, dev->sample_rate);
        break;
        
    case GYROIOC_GETFREQ:
        // 获取当前采样频率
        *(uint32_t *)arg = dev->sample_rate;
        break;
        
    case GYROIOC_CALIBRATE:
        // 执行校准
        gyro_hw_calibrate(dev);
        break;
        
    default:
        return -ENOTTY;  // 不支持的命令
    }
    
    return OK;
}

我个人习惯把 ioctl 命令定义成 设备类型IOC_操作 的格式。比如 GYROIOC_SETFREQ，一看就知道是陀螺仪的设置频率命令。这样代码可读性高，也方便别人维护。

4.4 小结

设备框架是PX4驱动开发的「骨架」。理解了它，你写驱动时就不会「东一榔头西一棒槌」了。记住三个核心点：

• 设备即文件——用文件操作接口来抽象硬件
• 注册与注销——管理设备的生命周期
• 引用计数——确保设备被安全使用

下次你写驱动时，不妨先画个框架图，把设备注册、文件操作接口、硬件初始化这些模块理清楚。磨刀不误砍柴工，真的。