3、设备框架与注册：Linux设备模型回顾，PX4的设备抽象层，设备注册流程

好，我们进入第三章。这一章说实话，是PX4驱动开发的「地基」。地基打不牢，后面盖楼全是危房。我个人习惯，每接触一个新平台，第一件事就是看它的设备模型怎么设计的。你想想看，驱动说白了就是管理硬件设备，那设备怎么被系统发现、怎么注册、怎么跟上层交互——这些搞不清楚，写出来的驱动就是野路子。

3.1 Linux设备模型回顾——别嫌啰嗦，这是基础

虽然咱们讲的是PX4，但PX4的设备抽象层脱胎于Linux。所以有必要先回顾一下Linux那套东西。嗯，这里要注意，我不是要给你上Linux内核课，而是挑跟PX4相关的几个核心概念讲。

Linux设备模型有三个核心概念：总线（Bus）、设备（Device）、驱动（Driver）。说白了就是：设备挂在总线上，驱动去匹配设备。匹配上了，probe函数就被调用，驱动开始干活。

我在项目中遇到过一个问题：一个SPI传感器，在Linux下工作得好好的，移植到RTOS上就死活不通。后来发现，Linux的设备模型帮我们自动处理了设备和驱动的匹配，而RTOS下你得手动注册。这就是为什么我们要理解这套机制——它帮你省掉很多「隐形的坑」。

3.2 PX4的设备抽象层——轻量但五脏俱全

PX4跑在NuttX上，NuttX本身也有设备模型，但PX4觉得不够用，自己又包了一层。为什么？因为PX4需要统一的接口来管理各种传感器、执行器，而且还要支持热插拔、设备别名这些高级功能。

PX4的设备抽象层，核心结构体是device::Device。它定义在src/lib/drivers/device/Device.hpp里。我建议你打开这个文件看一眼，代码不多，但设计得很精巧。

// PX4设备抽象层核心接口（简化版）
class Device
{
public:
    // 设备类型枚举
    enum class DeviceType {
        UNKNOWN,
        I2C,
        SPI,
        UART,
        GPIO,
        PWM,
        CAN,
        // ...
    };

    // 核心操作接口
    virtual int     init() = 0;
    virtual int     read(unsigned offset, void *data, unsigned count) = 0;
    virtual int     write(unsigned offset, const void *data, unsigned count) = 0;
    virtual int     ioctl(unsigned operation, unsigned &arg) = 0;

    // 设备标识
    const char     *get_devname() const { return _devname; }
    int             get_device_id() const { return _device_id; }

protected:
    const char     *_devname;      // 设备名称，如"/dev/gyro0"
    int             _device_id;    // 设备ID，用于唯一标识
    DeviceType      _type;         // 设备类型
};

你看，这个接口跟Linux的file_operations很像，但更精简。read/write/ioctl三个函数，覆盖了绝大多数场景。我刚开始用PX4时觉得这接口太简单了，后来发现——够用就好。嵌入式系统讲究的是「刚刚好」，不是「大而全」。

3.3 设备注册流程——从硬件到/dev节点

好，重头戏来了。一个传感器从硬件上电，到出现在/dev目录下，中间经历了什么？我画了一张流程图，你一看就明白。

这张图把流程说清楚了。但有几个细节我得强调一下：

3.4 注册流程中的关键细节

第一，init()函数是分阶段的。 我见过很多新手把init写得又臭又长，恨不得在init里把传感器校准都做了。其实init应该只做两件事：探测硬件是否存在，以及配置基本寄存器。其他初始化工作，放到后面按需做。

第二，设备命名有讲究。 PX4的设备命名规范是/dev/类型+序号，比如/dev/gyro0、/dev/accel1。这个命名不是随便起的，uORB模块会根据设备名来匹配对应的传感器数据。你如果乱起名字，上层模块就找不到数据源。

设备类型	命名规范	示例
陀螺仪	/dev/gyro[N]	/dev/gyro0, /dev/gyro1
加速度计	/dev/accel[N]	/dev/accel0, /dev/accel1
磁力计	/dev/mag[N]	/dev/mag0, /dev/mag1
气压计	/dev/baro[N]	/dev/baro0
PWM输出	/dev/pwm_output	/dev/pwm_output

第三，register_driver()干了什么？ 这个函数是NuttX提供的，它会在/dev下创建一个文件节点，并把驱动的操作函数表挂上去。之后，用户程序就可以用open/read/write/ioctl来操作设备了。说白了，就是给硬件设备做了一个「文件接口」。

// NuttX register_driver 原型
int register_driver(FAR const char *path, 
                    FAR const struct file_operations *fops, 
                    mode_t mode, 
                    FAR void *priv);

// PX4中典型的调用方式
register_driver(devname, &fops, 0666, (void *)this);

这里有个小细节：priv参数传的是this指针。这样当上层调用read/write时，回调函数里就能拿到设备对象的指针，进而调用到具体的实现。嗯，其实就是面向对象编程里「对象方法」的C语言实现方式。

3.5 设备ID与系统唯一标识

每个PX4设备都有一个唯一的device_id，它是一个32位的整数，编码了设备的总线类型、地址、版本等信息。这个ID有什么用？我举个例子：

你的飞控上有两个陀螺仪，一个在SPI总线上，一个在I2C总线上。如果只看设备名/dev/gyro0，你分不清它是哪个。但看device_id，就能知道它是SPI还是I2C，地址是多少。这在日志分析和故障排查时特别有用。

3.6 设备注册的完整代码骨架

说了这么多，不如看一段实际代码。这是一个典型的PX4传感器驱动注册流程：

// 伪代码：PX4传感器驱动注册骨架
class MySensor : public device::CDev
{
public:
    MySensor(const char *name) : 
        CDev(name)  // 调用基类构造函数
    {
        // 构造函数只做成员变量初始化
        _device_id = generate_device_id();
    }

    virtual ~MySensor() = default;

    virtual int init() override
    {
        // 1. 调用基类init
        int ret = CDev::init();
        if (ret != OK) return ret;

        // 2. 探测硬件
        if (!probe_sensor()) {
            return -ENODEV;  // 硬件不存在
        }

        // 3. 配置寄存器
        configure_sensor();

        // 4. 注册到设备框架
        ret = register_driver(_devname, &fops, 0666, (void *)this);
        if (ret != OK) return ret;

        // 5. 发布到uORB（如果是传感器）
        _sensor_pub = orb_advertise(ORB_ID(sensor_data), nullptr);

        return OK;
    }

private:
    int _device_id;
    orb_advert_t _sensor_pub;
};

// 驱动入口
extern "C" int my_sensor_main(int argc, char *argv[])
{
    auto sensor = new MySensor("/dev/my_sensor0");
    if (sensor == nullptr) return -ENOMEM;

    if (sensor->init() != OK) {
        delete sensor;
        return -EIO;
    }

    return OK;
}

这段代码你看懂了吗？核心逻辑就三步：构造对象、调用init、注册设备。但每一步都有坑，我前面已经帮你踩过了。

好了，这一章的内容就到这。设备注册是PX4驱动开发的「第一关」，搞懂了它，后面写具体驱动时就会顺手很多。记住我强调的那几个关键点：init要轻量、命名要规范、device_id要打印。这些都是实战中总结出来的经验，不是书本上能学到的。