RK3588S嵌入式Linux GPIO驱动开发实战：LED控制-嵌云网-嵌入式AI开发资源站

RK3588S嵌入式Linux GPIO驱动开发实战：LED控制

王羽翊

1. 项目概述

在嵌入式Linux开发中，点亮LED是最基础也是最经典的入门实验。这个看似简单的操作，实际上涵盖了嵌入式Linux开发的多个核心概念：GPIO控制、字符设备驱动、用户空间与内核空间交互等。本文将基于鲁班猫4（RK3588S）开发板，详细讲解如何通过编写字符设备驱动来控制GPIO4_B5引脚，实现LED的点亮与熄灭。

RK3588S是瑞芯微推出的一款高性能处理器，广泛应用于各类嵌入式设备。与常见的STM32等单片机不同，在Linux系统下操作GPIO需要编写内核驱动，这涉及到寄存器映射、设备树、文件操作接口等一系列复杂概念。对于初学者来说，这些内容往往令人望而生畏。

2. 硬件准备与环境确认

2.1 确认开发板型号

在开始之前，首先需要确认我们使用的鲁班猫4开发板的具体版本。不同版本的硬件规格可能有所差异，这会影响GPIO引脚的定义和使用方式。

在终端执行以下命令可以查看开发板型号：

bash复制cat /proc/device-tree/model

输出结果类似于：

code复制Lubancat 4-V1

这表明我们使用的是鲁班猫4-V1版本。这个信息非常重要，因为不同版本的开发板LED连接的GPIO引脚可能不同。

2.2 硬件连接分析

根据鲁班猫4的硬件规格书，开发板上有一个可编程控制的系统状态指示灯（绿色LED），它连接在GPIO4_B5引脚上。这个LED在上电后会进入心跳模式（周期性闪烁），表示系统正常运行。我们的目标就是通过驱动代码接管这个LED的控制权。

硬件连接示意图：

code复制GPIO4_B5 -> LED驱动电路 -> 绿色LED

值得注意的是，这个LED在系统启动时已经被设备树配置为系统指示灯。因此，在我们编写自己的驱动之前，需要先禁用系统的默认控制。

3. 寄存器与GPIO控制原理

3.1 RK3588S的GPIO控制器架构

RK3588S的GPIO控制器采用分层设计：

每个GPIO控制器（如GPIO0、GPIO4等）管理32个引脚
这32个引脚又分为4个组（A、B、C、D），每组8个引脚
每个组有独立的配置寄存器和数据寄存器

对于GPIO4_B5来说：

"4"表示GPIO4控制器
"B"表示GPIO4的B组
"5"表示B组的第5个引脚（从0开始计数）

3.2 关键寄存器解析

控制一个GPIO引脚需要操作以下几类寄存器：

3.2.1 引脚复用寄存器（IOMUX）

RK3588S的引脚复用配置位于BUS_IOC模块（基地址0xFD5F8000）。GPIO4_B5的复用配置寄存器是BUS_IOC_GPIO4B_IOMUX_H（偏移量0x008C）。

每个引脚占用4个bit位，可以配置为GPIO、PWM等不同功能。系统复位后，GPIO4_B5默认就是GPIO功能，因此我们不需要修改这个寄存器。

3.2.2 数据方向寄存器（DDR）

数据方向寄存器决定GPIO是输入还是输出模式。RK3588S提供了两组寄存器：

GPIO_SWPORT_DDR_L：控制GPIO0-15（A组和B组）
GPIO_SWPORT_DDR_H：控制GPIO16-31（C组和D组）

每个寄存器32位，其中：

高16位是写使能位（WE）
低16位是实际的数据方向配置位

要将GPIO4_B5设置为输出，需要：

确定它在DDR_L寄存器中的位置（B组第5个引脚 → 位13）
同时设置位13和写使能位29（13+16）

3.2.3 数据寄存器（DR）

数据寄存器用于设置（输出模式）或读取（输入模式）GPIO的电平状态。同样分为：

GPIO_SWPORT_DR_L：GPIO0-15
GPIO_SWPORT_DR_H：GPIO16-31

设置GPIO4_B5输出高电平：

确定它在DR_L寄存器中的位置（位13）
同时设置位13和写使能位29

4. 驱动开发实战

4.1 禁用系统默认控制

在编写驱动前，需要先禁用系统对LED的默认控制。有两种方法：

修改设备树，将leds节点的status改为"disabled"
直接通过sysfs接口关闭控制：

bash复制sudo sh -c 'echo 0 > /sys/class/leds/sys_led/brightness'

建议采用第二种方法，因为它不需要重新编译和烧写设备树。

4.2 驱动代码解析

完整的驱动代码主要包括以下几个部分：

4.2.1 寄存器映射

在Linux内核中不能直接访问物理地址，需要通过ioremap将物理地址映射到内核虚拟地址空间：

c复制#define GPIO4_BASE 0xFEC50000
#define GPIO4_DR_L (GPIO4_BASE + 0x0000)
#define GPIO4_DDR_L (GPIO4_BASE + 0x0008)

static volatile unsigned int *gpio4_dr;
static volatile unsigned int *gpio4_ddr;

gpio4_dr = ioremap(GPIO4_DR_L, 4);
gpio4_ddr = ioremap(GPIO4_DDR_L, 4);

4.2.2 文件操作接口

实现标准的文件操作接口，让用户空间程序可以通过设备文件控制LED：

c复制static struct file_operations led_fops = {
    .open = led_open,
    .write = led_write,
};

在open函数中初始化GPIO：

c复制static int led_open(struct inode *inode, struct file *file)
{
    // 设置GPIO4_B5为输出模式
    unsigned int data = (1 << (GPIO_PIN_BIT + 16)) | (1 << GPIO_PIN_BIT);
    iowrite32(data, gpio4_ddr);
    
    // 初始化为高电平（LED灭）
    iowrite32(data, gpio4_dr);
    
    return 0;
}

在write函数中根据用户输入控制LED：

c复制ssize_t led_write(struct file *file, const char __user *ubuf, 
                 size_t size, loff_t *loff_t)
{
    char val;
    copy_from_user(&val, ubuf, 1);
    
    if(val == '0') {
        // LED灭
        unsigned int data = (1 << (GPIO_PIN_BIT + 16)) | (1 << GPIO_PIN_BIT);
        iowrite32(data, gpio4_dr);
    } else if(val == '1') {
        // LED亮
        unsigned int data = (1 << (GPIO_PIN_BIT + 16)) | (0 << GPIO_PIN_BIT);
        iowrite32(data, gpio4_dr);
    }
    
    return size;
}

4.2.3 设备注册

在init函数中注册字符设备：

c复制static int __init led_init(void)
{
    dev_t dev_num;
    
    // 动态分配设备号
    alloc_chrdev_region(&dev_num, 0, 1, "myled");
    
    // 初始化cdev结构体
    cdev_init(&mycdev, &led_fops);
    cdev_add(&mycdev, dev_num, 1);
    
    // 创建设备节点
    class = class_create(THIS_MODULE, "myled_class");
    device_create(class, NULL, dev_num, NULL, "myled");
    
    return 0;
}

4.3 用户空间测试程序

编写一个简单的测试程序来控制LED：

c复制#include <stdio.h>
#include <fcntl.h>
#include <unistd.h>

int main(int argc, char *argv[])
{
    if(argc != 2) {
        printf("Usage: %s <1|0>\n", argv[0]);
        return -1;
    }

    int fd = open("/dev/myled", O_RDWR);
    write(fd, argv[1], 1);
    close(fd);
    
    return 0;
}

使用方法：

bash复制./test 1  # 点亮LED
./test 0  # 熄灭LED

5. 常见问题与调试技巧

5.1 LED不响应控制

可能原因：

没有禁用系统的默认控制
- 检查/sys/class/leds/sys_led/brightness是否为0
- 检查/sys/class/leds/sys_led/trigger是否为"none"
GPIO映射失败
- 检查dmesg输出，确认ioremap是否成功
- 确认GPIO基地址和偏移量是否正确
寄存器操作错误
- 确认GPIO_PIN_BIT的值是否正确（GPIO4_B5对应13）
- 确认写使能位是否正确设置（位29）

5.2 驱动加载失败