2. HDF驱动框架入门：从零认识鸿蒙的驱动骨架

说实话，我第一次接触HDF（Hardware Driver Foundation）时，第一反应是——这不就是个驱动框架嘛。但真正在项目里跑了一遍之后，我才意识到它和Linux驱动模型有本质区别。今天我们就从最核心的几个概念入手，把HDF的底裤扒清楚。

2.1 HDF是什么？为什么鸿蒙要自己搞一套？

HDF的全称是Hardware Driver Foundation，翻译过来就是硬件驱动基础框架。它是鸿蒙系统专门为南向设备（传感器、显示屏、外设等）设计的一套驱动开发与管理框架。

你可能会问：Linux不是已经有成熟的驱动模型了吗？为什么还要重复造轮子？

嗯，这个问题我在项目初期也纠结过。后来发现，鸿蒙要解决的是物联网场景下的碎片化问题。Linux驱动模型是为PC和服务器设计的，一个驱动动辄几千行，加载流程复杂。而HDF的目标是——轻量、跨芯片、统一接口。

说白了，HDF就是给驱动开发上了一套标准化流程。你只要按照它的规矩写代码，剩下的加载、匹配、资源管理，框架全帮你搞定。

2.2 HDF驱动模型：三层架构，各司其职

HDF的驱动模型分为三层，我习惯叫它「三层蛋糕」：

这三层的关系，我用一个实际例子来说明：

2.3 驱动生命周期：从生到死，框架全包

HDF驱动的生命周期，说白了就是四个阶段：加载 → 初始化 → 运行 → 卸载。每个阶段都有对应的回调函数，框架会自动调用。

我记得第一次写HDF驱动时，以为只要实现一个入口函数就行了。结果发现框架要求实现三个回调：Bind、Init、Release。当时还纳闷，为什么搞这么复杂？后来才明白——这是为了精细控制资源。

// 驱动入口结构体
struct HdfDriverEntry g_sensorDriverEntry = {
    .moduleVersion = 1,
    .moduleName = "HDF_SENSOR",
    .Bind = SensorDriverBind,    // 绑定服务
    .Init = SensorDriverInit,    // 初始化硬件
    .Release = SensorDriverRelease // 释放资源
};

// 框架自动调用的顺序：
// 1. Bind() → 2. Init() → 3. 正常运行 → 4. Release()

每个回调的职责很清晰：

• Bind()：把驱动服务注册到HDF框架，让上层能找到你。我习惯在这里创建服务接口表。
• Init()：真正的初始化工作——配置GPIO、初始化I2C/SPI、申请内存。如果失败，返回非零值，框架会自动回滚。
• Release()：卸载时释放资源。这个函数特别容易被忽略，我曾经因为忘记释放中断，导致系统重启后驱动加载失败。

2.4 驱动配置与加载：HCS文件才是幕后老板

HDF驱动最大的特点之一，就是配置驱动。什么意思呢？驱动的行为、参数、设备信息，都写在HCS（HDF Configuration Source）配置文件里。框架启动时，会解析HCS文件，然后根据配置加载驱动。

我个人非常喜欢这个设计。以前写Linux驱动，改个设备地址都要重新编译内核。现在改HCS文件，重启一下服务就行，开发效率提升不少。

来看一个典型的HCS配置片段：

/* sensor_config.hcs */
root {
    sensor_driver {
        match_attr = "hdf_sensor";
        device_info {
            sensor0 {
                device_id = 0;
                device_name = "temperature_sensor";
                device_attr {
                    i2c_bus = 1;        // I2C总线号
                    i2c_addr = 0x48;    // 设备地址
                    poll_interval = 100; // 轮询间隔(ms)
                }
            }
        }
    }
}

HCS文件的加载流程是这样的：

1. 系统启动，HDF框架读取HCS配置文件
2. 解析配置，找到 match_attr 匹配的驱动节点
3. 匹配驱动，根据 moduleName 找到对应的驱动入口
4. 调用Bind()，注册驱动服务
5. 调用Init()，传入配置参数，初始化硬件
6. 驱动就绪，上层可以通过服务接口访问设备

2.5 驱动加载的两种模式：按需加载 vs 自动加载

HDF支持两种加载模式，具体用哪种，取决于你的业务场景：

我建议传感器驱动使用按需加载。为什么？因为很多传感器不是一直需要工作的。比如温度传感器，可能每隔几分钟才采集一次数据。如果系统启动时就加载，白白占用内存和总线资源。按需加载，上层调用时才激活驱动，用完还可以卸载，省电又省资源。