4、GPIO驱动移植案例：GPIO控制器寄存器分析、通用GPIO驱动框架、板级适配层实现

4.1 案例背景与目标

GPIO（General Purpose Input/Output）是最基础、最常用的外设接口。在驱动移植过程中，GPIO驱动的适配工作往往是最先被验证的环节。本章以某款基于ARM Cortex-M4内核的MCU（以下简称“目标芯片”）为例，详细讲解如何从芯片手册出发，分析GPIO控制器寄存器，并基于通用GPIO驱动框架实现板级适配层。

4.2 GPIO控制器寄存器深度分析

在编写任何驱动代码之前，必须彻底理解硬件寄存器。目标芯片的GPIO控制器具有以下典型特征：

• 端口分组： 每16个引脚为一个端口（如PORTA、PORTB），每个端口对应一组控制寄存器。
• 功能复用： 每个引脚可通过配置寄存器选择GPIO或最多4种外设功能（AF0~AF3）。
• 电气特性： 支持独立配置上拉/下拉、推挽/开漏、输出速度。

下表列出了GPIO控制器的核心寄存器及其偏移地址（以PORTA基址0x40020000为例）：

4.3 通用GPIO驱动框架（pinctrl + gpiolib）

Linux内核的GPIO驱动体系由两大子系统构成：pinctrl（引脚控制）和 gpiolib（GPIO库）。pinctrl负责引脚功能复用、电气属性配置；gpiolib负责提供标准的GPIO操作接口（如gpio_request、gpio_direction_output、gpio_set_value）。

驱动移植的核心工作，就是实现这两个子系统所要求的底层回调函数。下图展示了驱动框架的整体架构：

4.4 板级适配层实现

板级适配层是连接通用框架与具体硬件的桥梁。其主要工作包括：

1. 设备树绑定： 在设备树中描述GPIO控制器硬件资源（基址、中断、时钟）。
2. pinctrl回调实现： 实现引脚复用、上下拉、驱动强度等配置函数。
3. gpio_chip注册： 填充struct gpio_chip结构体，并调用gpiochip_add_data注册到内核。
4. 中断支持： 实现GPIO中断的映射与处理（通常通过irq_chip）。

4.4.1 设备树节点示例

在设备树源文件（.dts）中，GPIO控制器的描述如下：

gpioa: gpio@40020000 {
    compatible = "vendor,chip-gpio";
    reg = <0x40020000 0x400>;
    interrupts = <16 2>;
    gpio-controller;
    #gpio-cells = <2>;
    interrupt-controller;
    #interrupt-cells = <2>;
    clocks = <&rcc 0 38>;
    status = "disabled";
};

4.4.2 pinctrl回调函数实现

pinctrl子系统要求驱动实现一组操作函数，用于配置引脚功能。以下是核心回调的实现片段：

static int chip_pinctrl_set_mux(struct pinctrl_dev *pctldev,
                                unsigned int selector,
                                unsigned int group)
{
    struct chip_gpio_bank *bank = pinctrl_dev_get_drvdata(pctldev);
    unsigned int pin = group;  // 简化处理，实际需查表
    unsigned int mode = selector;
    unsigned int offset = pin * 2;
    u32 val;

    val = readl(bank->base + GPIO_MODER);
    val &= ~(0x3 << offset);
    val |= (mode & 0x3) << offset;
    writel(val, bank->base + GPIO_MODER);

    return 0;
}

static const struct pinctrl_ops chip_pinctrl_ops = {
    .get_groups_count = chip_get_groups_count,
    .get_group_name = chip_get_group_name,
    .get_group_pins = chip_get_group_pins,
    .set_mux = chip_pinctrl_set_mux,
};

4.4.3 gpio_chip结构体填充

gpiolib通过struct gpio_chip来抽象一个GPIO控制器。适配层需要填充该结构体并注册：

static int chip_gpio_get(struct gpio_chip *gc, unsigned int offset)
{
    struct chip_gpio_bank *bank = gpiochip_get_data(gc);
    return !!(readl(bank->base + GPIO_IDR) & BIT(offset));
}

static void chip_gpio_set(struct gpio_chip *gc, unsigned int offset, int value)
{
    struct chip_gpio_bank *bank = gpiochip_get_data(gc);
    if (value)
        writel(BIT(offset), bank->base + GPIO_BSRR);      // 低16位置位
    else
        writel(BIT(offset + 16), bank->base + GPIO_BSRR); // 高16位复位
}

static int chip_gpio_direction_output(struct gpio_chip *gc,
                                      unsigned int offset, int value)
{
    struct chip_gpio_bank *bank = gpiochip_get_data(gc);
    u32 val;

    chip_gpio_set(gc, offset, value);  // 先设值，避免毛刺

    val = readl(bank->base + GPIO_MODER);
    val &= ~(0x3 << (offset * 2));
    val |= (0x1 << (offset * 2));     // 01 = 输出模式
    writel(val, bank->base + GPIO_MODER);

    return 0;
}

static struct gpio_chip chip_gpio_chip = {
    .label = "chip-gpio",
    .owner = THIS_MODULE,
    .get = chip_gpio_get,
    .set = chip_gpio_set,
    .direction_input = chip_gpio_direction_input,
    .direction_output = chip_gpio_direction_output,
    .request = chip_gpio_request,
    .free = chip_gpio_free,
    .set_config = chip_gpio_set_config,
    .base = -1,                // 动态分配基号
    .ngpio = 16,
};

4.5 移植验证流程

完成板级适配层代码后，按以下步骤进行验证：

4.6 板级适配层数据流

下图展示了从用户请求到硬件寄存器的完整数据流，帮助理解各层之间的协作关系：

4.7 本章小结

本章通过一个完整的GPIO驱动移植案例，展示了从硬件寄存器分析到通用框架适配的全过程。核心要点包括：

• 寄存器分析是基础： 必须精确理解每个寄存器的位域定义，特别是MODER、BSRR等关键寄存器。
• 框架分层清晰： pinctrl负责引脚配置，gpiolib提供标准API，两者通过板级适配层与硬件交互。
• 适配层实现有章可循： 设备树描述硬件资源，pinctrl_ops和gpio_chip回调函数封装寄存器操作。
• 验证要全面： 从基本输入输出到复用功能、中断，逐项测试确保移植正确。