1. 项目概述：平台总线下的LED控制实验
在嵌入式开发领域，点亮LED灯是最基础的入门实验，但通过平台总线（Platform Bus）来实现这个功能，则是一个理解Linux驱动模型的重要切入点。这个实验看似简单，却包含了设备树（Device Tree）、平台设备（Platform Device）、平台驱动（Platform Driver）等关键概念的实际运用。
我十年前第一次接触这个实验时，花了整整三天才搞明白platform_driver_register()和of_match_table之间的关系。现在回头看，这个实验确实是理解Linux设备驱动框架的最佳起点。通过控制GPIO点亮LED，我们能直观看到代码的执行效果，而平台总线机制则展示了Linux内核如何优雅地管理硬件资源。
2. 硬件准备与电路设计
2.1 硬件选型要点
对于这个实验，我们需要准备以下硬件：
- 开发板（推荐使用树莓派或BeagleBone等常见嵌入式平台）
- LED灯（普通5mm直径LED即可）
- 限流电阻（通常220Ω-1kΩ）
- 杜邦线若干
选择LED时要注意正向电压（Vf）和正向电流（If）参数。普通红色LED的Vf约为1.8-2.2V，If约10-20mA。假设我们使用3.3V的GPIO电压，通过欧姆定律计算电阻值：
R = (Vcc - Vf) / If = (3.3V - 2.0V) / 0.01A = 130Ω
实际可选择220Ω的标准电阻，既能保护LED又能防止GPIO过载。
2.2 电路连接方案
典型的连接方式有两种：
- GPIO直接驱动LED：
GPIO → 电阻 → LED → GND - GPIO通过晶体管驱动LED（适用于高功率LED）：
GPIO → 基极电阻 → NPN晶体管 → LED → 限流电阻 → VCC
对于初学者，建议采用第一种简单方案。以树莓派为例，将LED正极通过220Ω电阻连接到GPIO17（物理引脚11），负极连接到GND（物理引脚9）。
重要提示：务必确认开发板的GPIO电压等级（3.3V或5V），错误连接可能损坏GPIO引脚。我曾在实验中因疏忽这一点烧毁过一块BeagleBone的GPIO控制器。
3. Linux平台总线驱动框架解析
3.1 平台总线核心概念
平台总线（Platform Bus）是Linux内核中用于连接不具有物理总线的片上系统外设的虚拟总线。它主要由两部分组成：
- 平台设备（platform_device）：代表具体的硬件设备
- 平台驱动（platform_driver）：包含操作设备的驱动代码
与传统字符设备驱动不同，平台总线驱动实现了设备与驱动的分离，通过设备树（Device Tree）来描述硬件配置，使驱动代码更具可移植性。
3.2 设备树关键节点解析
对于LED控制，我们需要在设备树中添加如下节点（以树莓派为例）：
code复制/ {
led_demo {
compatible = "my-led-driver";
led-gpios = <&gpio 17 GPIO_ACTIVE_HIGH>;
label = "my_led";
};
};
这段设备树代码定义了一个名为"led_demo"的节点，指定了：
- compatible属性：用于匹配驱动
- led-gpios属性：指定使用的GPIO引脚（17号）和有效电平
- label属性：设备标签
编译设备树后，内核启动时会自动创建对应的platform_device。
4. 驱动代码实现详解
4.1 驱动框架搭建
完整的平台驱动需要实现以下核心结构：
c复制static struct platform_driver my_led_driver = {
.probe = my_led_probe,
.remove = my_led_remove,
.driver = {
.name = "my-led-driver",
.of_match_table = my_led_of_match,
},
};
其中：
- probe函数：设备匹配成功后调用，进行资源分配和初始化
- remove函数：设备移除时调用，进行资源释放
- of_match_table：用于匹配设备树中的compatible属性
4.2 GPIO操作关键代码
在probe函数中，我们需要获取GPIO并配置为输出：
c复制static int my_led_probe(struct platform_device *pdev)
{
struct device *dev = &pdev->dev;
struct gpio_desc *led_gpio;
int ret;
// 从设备树获取GPIO
led_gpio = devm_gpiod_get(dev, "led", GPIOD_OUT_LOW);
if (IS_ERR(led_gpio)) {
dev_err(dev, "Failed to get GPIO\n");
return PTR_ERR(led_gpio);
}
// 保存GPIO到设备私有数据
priv->led_gpio = led_gpio;
// 创建sysfs接口
ret = sysfs_create_group(&dev->kobj, &my_led_attr_group);
if (ret) {
dev_err(dev, "Failed to create sysfs group\n");
return ret;
}
return 0;
}
4.3 用户空间控制接口
为了方便测试，我们可以通过sysfs提供用户空间控制接口：
c复制static ssize_t led_state_show(struct device *dev,
struct device_attribute *attr, char *buf)
{
struct my_led_priv *priv = dev_get_drvdata(dev);
int value = gpiod_get_value(priv->led_gpio);
return sprintf(buf, "%d\n", value);
}
static ssize_t led_state_store(struct device *dev,
struct device_attribute *attr,
const char *buf, size_t count)
{
struct my_led_priv *priv = dev_get_drvdata(dev);
unsigned long value;
int ret;
ret = kstrtoul(buf, 10, &value);
if (ret)
return ret;
gpiod_set_value(priv->led_gpio, value);
return count;
}
static DEVICE_ATTR(led_state, 0644, led_state_show, led_state_store);
编译加载驱动后，可以通过以下命令控制LED：
bash复制# 点亮LED
echo 1 > /sys/devices/platform/led_demo/led_state
# 熄灭LED
echo 0 > /sys/devices/platform/led_demo/led_state
5. 常见问题与调试技巧
5.1 驱动加载失败排查
如果驱动加载失败，可以按以下步骤排查：
-
检查dmesg输出：
bash复制dmesg | tail -20常见错误包括：
- 设备树节点未正确编译加载
- GPIO申请失败（可能已被其他驱动占用）
- 内存分配失败
-
确认设备树节点已生效：
bash复制ls /proc/device-tree/led_demo -
检查GPIO状态：
bash复制cat /sys/kernel/debug/gpio
5.2 LED不亮的情况处理
如果LED不亮，建议按以下顺序检查：
- 用万用表测量GPIO引脚电压，确认是否有输出
- 检查电路连接是否正确，特别是LED极性
- 尝试降低电阻值（但不要低于计算的最小值）
- 确认设备树中GPIO号与实际硬件一致
经验分享：我曾遇到LED微弱发光但不正常点亮的情况，最终发现是GPIO驱动能力不足。解决方法是在GPIO和LED之间增加一个NPN晶体管作为电流放大器。
5.3 性能优化建议
对于需要快速切换LED状态的场景（如PWM控制），需要注意：
- 避免在驱动中使用msleep()等阻塞操作
- 考虑使用硬件PWM控制器而非GPIO模拟
- 对于高频切换，可以使用GPIO子系统提供的快速接口：
c复制gpiod_set_value_cansleep(led_gpio, 1); // 可睡眠版本 gpiod_set_value(led_gpio, 0); // 原子操作版本
6. 进阶应用与扩展思路
掌握了基础的点亮LED操作后，可以尝试以下扩展：
- 实现LED呼吸灯效果（通过PWM调节亮度）
- 添加中断支持，实现按键控制LED
- 开发用户空间应用程序通过ioctl控制LED
- 将多个LED组织为LED类设备，使用内核的LED子系统
一个实用的进阶例子是实现LED闪烁频率控制：
c复制static int led_blink_thread(void *data)
{
struct my_led_priv *priv = data;
unsigned int interval = priv->blink_interval;
while (!kthread_should_stop()) {
gpiod_set_value(priv->led_gpio, 1);
msleep(interval);
gpiod_set_value(priv->led_gpio, 0);
msleep(interval);
}
return 0;
}
static ssize_t blink_interval_store(struct device *dev,
struct device_attribute *attr,
const char *buf, size_t count)
{
struct my_led_priv *priv = dev_get_drvdata(dev);
unsigned long interval;
int ret;
ret = kstrtoul(buf, 10, &interval);
if (ret)
return ret;
if (interval > 1000) // 限制最大1秒
return -EINVAL;
priv->blink_interval = interval;
if (priv->blink_thread) {
kthread_stop(priv->blink_thread);
priv->blink_thread = NULL;
}
if (interval > 0) {
priv->blink_thread = kthread_run(led_blink_thread,
priv, "led_blinker");
if (IS_ERR(priv->blink_thread))
return PTR_ERR(priv->blink_thread);
}
return count;
}
这段代码实现了一个可调节频率的LED闪烁功能，通过sysfs接口设置闪烁间隔（毫秒级），设置为0时停止闪烁。