U-Boot番外篇 | U-Boot dm-gpio使用方法以及工作流程

Posted Neutionwei

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了U-Boot番外篇 | U-Boot dm-gpio使用方法以及工作流程相关的知识,希望对你有一定的参考价值。

一、dm-gpio架构

建议先参考《[uboot] (番外篇)uboot 驱动模型》搞懂uboot下的驱动模型。

1、dm-gpio架构图

如下:

2、说明

  • gpio core
    也在gpio uclass中实现,
    • 主要是为上层提供接口
    • 从dts中获取GPIO属性
    • 从gpio uclass的设备链表中获取到相应的udevice设备,并使用其操作集
  • gpio uclass

    • 链接属于该uclass的所有gpio udevice设备
    • 为gpio udevice的driver提供统一的操作集接口
  • bank和gpio

    • 有些平台上,将某些使用同一组寄存器的gpio构成一个bank,例如三星的s5pv210
    • 当然,并不是所有平台都有bank的概念,例如高通,高通的GPIO都有自己独立的寄存器,因此,可以将高通当成只有一个bank
  • gpio udevice

    • 一个bank对应一个gpio udevice,用bank中的偏移来表示具体的GPIO号
    • gpio udevice的driver就会根据bank以及offset对相应的寄存器上的相应的bit进行操作。

3、原理介绍

这里先简单介绍一下dm下gpio的工作原理

  • 一个bank对应一个udevice,udevice中私有数据中存放着该bank的信息,比如相应寄存器地址等等
  • 上层用gpio_desc描述符来描述一个GPIO,其中包括该GPIO所属的udevice、在bank内的偏移、以及标志位。
  • 上层通过调用gpio core的接口从dtsi获取到GPIO属性对应的gpio_desc描述符
  • 上层使用gpio_desc描述符来作为调用gpio core的操作接口的参数
  • gpio core从gpio_desc描述符提取udevice,并调用其driver中对应的操作集,以bank内的偏移作为其参数(这样driver就能判断出是哪个GPIO了)
  • driver中提取udevice的私有数据中的bank信息,并进行相应的操作

二、dm-gpio的使用示例

这里简单的以tiny210的led_1的闪烁为例子来介绍一下GPIO的使用。
虽然uboot中已经实现了led的uclass,但是我们这里先不使用这个uclass,只是简单的实现通过dm-gpio来控制一个led。

0、硬件简单说明(具体去参考原理图吧)

  • s5pv210的GPIO的地址空间
    参考《S5PV210_UM_REV1.1》2.1.2 SPECIAL FUNCTION REGISTER MAP,
    s5pv210的GPIO的地址空间为0xE020_0000开始的1000B的区域

  • 在tiny210上,有四个led,低电平为亮,高电平为灭

    • GPJ2_0 -> led_1
    • GPJ2_1 -> led_2
    • GPJ2_2 -> led_3
    • GPJ2_3 -> led_4
  • GPJ2这个bank的寄存器
    对应控制寄存器 0xE020_0280
    对应数据寄存器 0xE020_0284

1、dtsi中的定义

这里只说明GPIO引用的节点,不说明gpio控制器的节点,gpio控制器的节点在后面driver中进行说明
arch/arm/dts/s5pv210-tiny210.dts

    led_test {
        compatible = "dm-gpio,test";
        led1-gpio = <&gpj2 0 0>;      // 属性"led1-gpio",表示gpj2 bank的第0个gpio,0是值标志
        led2-gpio = <&gpj2 1 0>;    // gpj2 bank的第1个gpio,0是值标志
        led3-gpio = <&gpj2 2 0>;    // gpj2 bank的第2个gpio,0是值标志
        led4-gpio = <&gpj2 3 0>;    // gpj2 bank的第3个gpio,0是值标志
    };  

注意,这里<&gpj2 0 0>取决于driver是如何对这个属性进行转化的。并不是所有平台都是一样的。

2、驱动中从节点中获取一个GPIO

我们在board_late_init中来实现GPIO闪烁的功能
board/samsung/tiny210/board.c

int board_late_init(void)
{
    struct gpio_desc led1_gpio;
    int node;
    node = fdt_node_offset_by_compatible(gd->fdt_blob, 0, "dm-gpio,test");   
   // 注意,我们并没有使用dm模型的driver来匹配compatible = "dm-gpio,test"的节点,所以这里直接获取compatible = "dm-gpio,test"的节点,存放在node中
    if (node < 0)
    {   
        printf("===========================Don't find dm-gpio,test node\\n");
        return -1; 
    }   
    gpio_request_by_name_nodev(gd->fdt_blob, node, "led1-gpio", 0, &led1_gpio, GPIOD_IS_OUT);
    // 调用gpio_request_by_name_nodev来获取node节点中的"led1-gpio"属性,并转化为gpio_desc描述符,标志为输出
    if (dm_gpio_is_valid(&led1_gpio))// 判断对应gpio_desc是否可用
    {   
        printf("===========================Get led1-gpio\\n");
        while(1) 
        {   
            dm_gpio_set_value(&led1_gpio, 0);  // 调用dm_gpio_set_value将led1_gpio设置输出低电平
            mdelay(1000);
            dm_gpio_set_value(&led1_gpio, 1);  // 调用dm_gpio_set_value将led1_gpio设置输出高电平
            mdelay(1000);
        }
    }
    else
    {
        printf("===========================Can't get led1-gpio\\n");
    }

3、简单说明

  • 在dtsi中将需要的GPIO以一定的格式在属性中描述,如下:
    led1-gpio = <&gpj2 0 0>;
  • 在驱动中调用gpio_request_by_name_nodev接口或者其他接口从dtsi节点中获取对应GPIO属性的gpio_desc描述符
  • 调用dm_gpio_is_valid判断该gpio_desc是否可用
  • 调用gpio core的dm操作接口,以gpio_desc为参数,实现控制GPIO的目的

后面介绍dm-gpio的实现

三、gpio uclass

建议先参考《[uboot] (番外篇)uboot 驱动模型》搞懂uboot下的驱动模型。
在gpio uclass中实现了两部分,

  • gpio uclass driver:gpio uclass驱动,提供gpio udevice绑定到uclass的设备链表之前和之后的一些操作,以及udevice的driver的操作集规范。
  • gpio core:为上层提供GPIO的操作接口

1、需要打开的宏

(1)CONFIG_DM
dm-gpio是基于uboot的DM实现的,关于uboot的DM可以参考《[uboot] (番外篇)uboot 驱动模型》。
所以需要先使能DM,也就是打开CONFIG_DM宏。
在configs/tiny210_defconfig中定义了如下:

CONFIG_DM=y

(2)打开CONFIG_DM_GPIO宏
在configs/tiny210_defconfig中定义了如下:

CONFIG_DM_GPIO=y

2、结构体说明

  • (1)gpio_desc
    前面也说过了,上层是通过gpio_desc来和gpio core进行交互的。
struct gpio_desc {
    struct udevice *dev;    /* Device, NULL for invalid GPIO */  //对应bank的udevice设备
    unsigned long flags;
    uint offset;        /* GPIO offset within the device */ // 该GPIO在bank内的偏移
};

offset对应bank内的偏移,通过offset+bank的gpio_base可以得到具体的GPIO号(用于兼容老版本的方式)。
调用uclass的接口可以从dts直接获得对应GPIO的描述符。DM框架下对GPIO的使用推荐使用这种方法。

  • (2)gpio_dev_priv
    每个gpio uclass设备链表下的udevice都有一部分属于uclass的私有数据。udevice->uclass_priv。
    都有一个这样的数据结构,提供给gpio uclass使用,让gpio uclass知道这个udevice中的gpio信息和情况。
struct gpio_dev_priv {
    const char *bank_name;  // udevice的名字,也是bank名称
    unsigned gpio_count; // 这个bank中的GPIO数量
    unsigned gpio_base; // 每个bank的gpio都占有gpio uclass的一部分连续的gpio空间,gpio_base则表示该bank的第一个GPIO号。
    char **name; //  阵列,每个gpio被request之后,都会有自己的label名称,存储在这里,可以防止GPIO request冲突
};
  • (3)标准dm-gpio的操作集合
struct dm_gpio_ops {
    int (*request)(struct udevice *dev, unsigned offset, const char *label); 
    int (*free)(struct udevice *dev, unsigned offset);
    int (*direction_input)(struct udevice *dev, unsigned offset);
    int (*direction_output)(struct udevice *dev, unsigned offset,
                int value);
    int (*get_value)(struct udevice *dev, unsigned offset);
    int (*set_value)(struct udevice *dev, unsigned offset, int value);
    int (*get_function)(struct udevice *dev, unsigned offset);
        /* 这里具体看注释 */
    int (*xlate)(struct udevice *dev, struct gpio_desc *desc,
             struct fdtdec_phandle_args *args);
};

注意都是以udevice和bank内的偏移为参数,驱动中可以根据udevice获取到对应bank的信息以及私有数据,然后根据偏移就可以确认出到底是哪个GPIO了。

3、gpio uclass driver

DM模型中gpio模块的uclass。定义模块加载前和加载后的操作函数等等。

UCLASS_DRIVER(gpio) = {
    .id     = UCLASS_GPIO,
    .name       = "gpio",
    .flags      = DM_UC_FLAG_SEQ_ALIAS,
    .post_probe = gpio_post_probe,
    .pre_remove = gpio_pre_remove,
    .per_device_auto_alloc_size = sizeof(struct gpio_dev_priv),
};
  • (1)gpio_post_probe
    gpio_post_probe会在gpio udevice probe之后被调用,实现如下:
static int gpio_post_probe(struct udevice *dev)
{
    struct gpio_dev_priv *uc_priv = dev_get_uclass_priv(dev); // 获取刚probe的udevice的提供给uclass使用私有数据
    uc_priv->name = calloc(uc_priv->gpio_count, sizeof(char *)); // 为私有数据中的GPIO label分配空间
    if (!uc_priv->name)
        return -ENOMEM;
    return gpio_renumber(NULL); // 重新分配GPIO空间
}

4、gpio core

主要负责通过gpio uclass为上层提供接口,

(1)接口说明
其中既提供了兼容老版本的接口,也提供了DM框架下的接口

  • DM框架下的接口
    注意,外部通过gpio_desc 来描述一个GPIO,所以这些接口都是以gpio_desc作为参数

    • gpio_request_by_name
      int gpio_request_by_name(struct udevice *dev, const char *list_name, int index, struct gpio_desc *desc, int flags)
      通过对应的udevice找到其dtsi节点中属性名为list_name的GPIO属性并转化为gpio_desc,并且request。
    • gpio_request_by_name_nodev
      int gpio_request_by_name_nodev(const void *blob, int node, const char *list_name, int index, struct gpio_desc *desc, int flags)
      通过对应的dtsi节点中属性名为list_name的GPIO属性并转化为gpio_desc,并且request。
    • dm_gpio_request
      int dm_gpio_request(struct gpio_desc *desc, const char *label)
      申请gpio_desc描述的GPIO
    • dm_gpio_get_value
      int dm_gpio_get_value(const struct gpio_desc *desc)
      获取gpio_desc描述的GPIO的值
    • dm_gpio_set_value
      int dm_gpio_set_value(const struct gpio_desc *desc, int value)
      设置gpio_desc描述的GPIO的值
    • dm_gpio_set_dir_flags
      int dm_gpio_set_dir_flags(struct gpio_desc *desc, ulong flags)
      设置gpio_desc描述的GPIO的输入输出方向,带标志
    • dm_gpio_set_dir
      int dm_gpio_set_dir(struct gpio_desc *desc)
      设置gpio_desc描述的GPIO的输入输出方向
    • dm_gpio_is_valid
      static inline bool dm_gpio_is_valid(const struct gpio_desc *desc)
      判断gpio_desc是否可用
  • 老接口:
    这些接口是为了兼容老版本的接口,注意,但是最终还是会调用DM框架下的接口

    • gpio_request
      int gpio_request(unsigned gpio, const char *label)
      申请一个GPIO
    • gpio_direction_input
      int gpio_direction_input(unsigned gpio)
      设置某个GPIO为输入
    • gpio_direction_output
      int gpio_direction_output(unsigned gpio, int value)
      设置某个GPIO为输出
    • gpio_get_value
      int gpio_get_value(unsigned gpio)
      获取某个GPIO上的值
    • gpio_set_value
      int gpio_set_value(unsigned gpio, int value)
      设置GPIO的值

(2)举例:dm_gpio_set_value

int dm_gpio_set_value(const struct gpio_desc *desc, int value)
{
    int ret;
    ret = check_reserved(desc, "set_value"); // 判断这个GPIO是否已经被request了,必须是request之后才能被使用
    if (ret)
        return ret;
    if (desc->flags & GPIOD_ACTIVE_LOW)
        value = !value;
    gpio_get_ops(desc->dev)->set_value(desc->dev, desc->offset, value);
        // 先获取对应udevice的driver,也就是对应bank的drvier的操作集中的set_value方法,
        // 然后以udevice、bank内的偏移,电平值为参数传入到set_value方法
        // 剩下的就是driver中的事了,driver中需要能根据udevice和bank内偏移操作到对应的GPIO上去
    return 0;
}

(3)举例:gpio_set_value

int gpio_set_value(unsigned gpio, int value)
{
    struct gpio_desc desc;
    int ret;
    ret = gpio_to_device(gpio, &desc); // 将GPIO转化为对应的gpio_desc描述符
        // 前面我们也说了,所有bank都占用uclass的gpio空间的一部分、并且是连续的不冲突的,因此,uclass core可以将对应的gpio转化为gpio_desc描述符
        // 具体实现自己看代码
    if (ret)
        return ret;
    return dm_gpio_set_value(&desc, value);
}

四、gpio driver

所有驱动都有自己的方式来解析gpio_desc,这里我们以s5pv210为例:
不同driver可能差异较大。这里只作为一个参考。
drivers/gpios5p_gpio.c

0、重点说明

所有bank都有对应的udevice,因此在绑定的过程都需要创建udevice中关于这个bank的私有数据。
s5pv210下这个私有数据是:

struct s5p_gpio_bank {
    unsigned int    con;
    unsigned int    dat;
    unsigned int    pull;
    unsigned int    drv;
    unsigned int    pdn_con;
    unsigned int    pdn_pull;
    unsigned char   res1[8];
};

其size刚好是一个bank的占有的寄存器的地址空间长度。并且意义也和寄存器中的对应。
另外,s5pv210并不会为每个bank都创建一个匹配节点(注意是匹配节点而不是节点,节点还是会用的,匹配节点是指带有compitable属性的节点),而是将所有bank的节点都放在一个匹配节点下,而driver会在bind这个匹配节点的时候,去probe这个节点下面的bank节点。而匹配节点是不做probe操作的。

1、dtsi中的定义

/{
    pinctrl: pinctrl@e0200000 {
        compatible = "samsung,s5pc110-pinctrl";   // 只有这个节点被匹配到,但是在这个节点bind的过程中,会去为子节点的bank创建对应udevice并且绑定到gpio uclass上,然后probe子节点
        reg = <0xe0200000 0x1000>;
        #address-cells = <1>;
        #size-cells = <1>;
        gpa0: gpa0 {
            gpio-controller;
            #gpio-cells = <2>;
        };  
        gpa1: gpa1 {
            gpio-controller;
            #gpio-cells = <2>;
        };  
        gpb: gpb {
            gpio-controller;
            #gpio-cells = <2>;
        };  
        gpc0: gpc0 {
            gpio-controller;
            #gpio-cells = <2>;
        };  
// 后面的bank这里不写了。。。
    }; 
}; 

注意这里的bank是有顺序的,必须和硬件上bank的顺序完全一致。

2、定义一个driver

具体成员的意义参考《[uboot] (番外篇)uboot 驱动模型

U_BOOT_DRIVER(gpio_exynos) = {
    .name   = "gpio_exynos",
    .id = UCLASS_GPIO, // 定义所属uclass的id
    .of_match = exynos_gpio_ids,
    .bind   = gpio_exynos_bind,
    .probe = gpio_exynos_probe,
    .priv_auto_alloc_size = sizeof(struct exynos_bank_info),
    .ops    = &gpio_exynos_ops,
};

3、实现exynos_gpio_ids

static const struct udevice_id exynos_gpio_ids[] = {
    { .compatible = "samsung,s5pc100-pinctrl" },
    { .compatible = "samsung,s5pc110-pinctrl" },
    { .compatible = "samsung,exynos4210-pinctrl" },
    { .compatible = "samsung,exynos4x12-pinctrl" },
    { .compatible = "samsung,exynos5250-pinctrl" },
    { .compatible = "samsung,exynos5420-pinctrl" },
    { }
};

4、实现gpio_exynos_bind

对应udevice绑定到uclass上所做的操作

static int gpio_exynos_bind(struct udevice *parent)
{
    struct exynos_gpio_platdata *plat = parent->platdata;
    struct s5p_gpio_bank *bank, *base;
    const void *blob = gd->fdt_blob;
    int node;
    /* If this is a child device, there is nothing to do here */
    if (plat)
        return 0;
        // 只有匹配的节点,也就是所有bank节点的父节点会做这个操作
    base = (struct s5p_gpio_bank *)dev_get_addr(parent); // 获取gpio寄存器的基地址
    for (node = fdt_first_subnode(blob, parent->of_offset), bank = base;
         node > 0;
         node = fdt_next_subnode(blob, node), bank++) { // 遍历所有子节点
        struct exynos_gpio_platdata *plat;
        struct udevice *dev;
        fdt_addr_t reg;
        int ret;
        if (!fdtdec_get_bool(blob, node, "gpio-controller")) // 判断是否有"gpio-controller"属性,也就是是否一个bank
            continue;
        plat = calloc(1, sizeof(*plat));    // 分配平台数据
        if (!plat)
            return -ENOMEM;
        plat->bank_name = fdt_get_name(blob, node, NULL);  // 设置平台数据的部分值
        ret = device_bind(parent, parent->driver, // 绑定子设备,这里会为bank创建udevice,并且绑定到gpio uclass中
                  plat->bank_name, plat, -1, &dev);
        if (ret)
            return ret;
        dev->of_offset = node; // 设备bank对应的udevice的node
        reg = dev_get_addr(dev); 
        if (reg != FDT_ADDR_T_NONE)
            bank = (struct s5p_gpio_bank *)((ulong)base + reg); // 所有bank的物理空间是以此排列的,并且长度都是一样的。
        plat->bank = bank; // 设置bank的物理地址
        debug("dev at %p: %s\\n", bank, plat->bank_name);
    }
    return 0;
}

5、实现gpio_exynos_probe

static int gpio_exynos_probe(struct udevice *dev)
{
    struct gpio_dev_priv *uc_priv = dev_get_uclass_priv(dev);
    struct exynos_bank_info *priv = dev->priv;
    struct exynos_gpio_platdata *plat = dev->platdata;
    /* Only child devices have ports */
    if (!plat)
        return 0;
        // 只有bank节点会做probe操作,而bank的父节点则不会做probe操作
    priv->bank = plat->bank; // 设置bank的私有数据
    uc_priv->gpio_count = GPIO_PER_BANK;  // 设置提供给uclass使用的私有数据gpio_dev_priv
    uc_priv->bank_name = plat->bank_name; // 设置提供给uclass使用的私有数据gpio_dev_priv
    return 0;
}

6、实现操作集

用于给gpio uclass提供udevice对应的bank操作集,必须使用dm_gpio_ops来进行定义

static const struct dm_gpio_ops gpio_exynos_ops = {
    .direction_input    = exynos_gpio_direction_input,
    .direction_output   = exynos_gpio_direction_output,
    .get_value      = exynos_gpio_get_value,
    .set_value      = exynos_gpio_set_value,
    .get_function       = exynos_gpio_get_function,
    .xlate          = exynos_gpio_xlate,
};

在这些操作方法中,最终会直接操作到GPIO对应的寄存器上去。
以exynos_gpio_set_value为例:

static int exynos_gpio_set_value(struct udevice *dev, unsigned offset,
                 int value)
// 以bank对应的udevice,以及bank内的偏移为参数
{
    struct exynos_bank_info *state = dev_get_priv(dev); // 获取平台私有数据,state->bank则是对应bank的寄存器地址
    s5p_gpio_set_value(state->bank, offset, value);
    return 0;
}
static void s5p_gpio_set_value(struct s5p_gpio_bank *bank, int gpio, int en)
{
    unsigned int value;
    value = readl(&bank->dat); // 读bank中的data寄存器
    value &= ~DAT_MASK(gpio);
    if (en)
        value |= DAT_SET(gpio);
    writel(value, &bank->dat); // 写入
}

注意,上述还提供了转化方式exynos_gpio_xlate,负责解析dtsi的GPIO属性。所以,dtsi的GPIO的属性的格式就是取决于这里是怎么解析的。

以上是关于U-Boot番外篇 | U-Boot dm-gpio使用方法以及工作流程的主要内容,如果未能解决你的问题,请参考以下文章

U-Boot番外篇 | fdt介绍

U-Boot番外篇 | relocation介绍

U-Boot番外篇 | global_data介绍

U-Boot技术细节索引

番外篇-Prometheus入门

番外篇-Flutter初识三问