嵌入式Linux驱动笔记(二十一)------GPIO和Pinctrl子系统的思考

2019-07-12 17:19发布

你好!这里是风筝的博客,

欢迎和我一起交流。


好久都没有写东西了,最近来广州某公司实习,顺便记录下吧。
吐槽下,因为是二级保密单位,公司里电脑不给联网,贼难受。。。。。。 不过第一次接触真正的产品开发,正式的工程项目,还是有很多值得我学习的地方的。
公司用的是联芯的一套方案,分配电脑后,师傅给了我一个简单的任务:给一台手机(Android6.0)移植光线&距离传感器驱动和充电呼吸灯芯片的驱动。
因为是移植,所以,,,,,,,,我觉得我可以叫设备树工程师…
任务很简单,但是我却对代码陷入了沉思。 当我拿到一份代码方案时,最简单的,操作GPIO。
当我最初学习的时候,用的是S3C2440,从网上很多资料还是知道GPIO的宏,如:S3C2410_GPF(4) 在我使用全志 H3的芯片,大部分我都是直接操作寄存器了,而且网上也有资料可循。
现在我在公司接触的这块芯片,网上根本没有资料,资料就是厂家提供的说明文档,那以操作GPIO为例,我该怎么操作一个GPIO呢? 其实有经验的人都知道:模仿!
看工程下别人写的代码就知道了,这算是一种取巧捷径,那我们现在是思考,该怎么做呢?
因为公司是完全要求保密的,代码我也拷不出来,我就以我手上的sun8i-h3代码分析吧:
首先,打开手册,查找芯片手册里关于GPIO的章节:
address
这里我们可以看出GPIO的基地址是:0x01C20800
像我公司里用的芯片,是普通GPIO有一个基地址,可复用的GPIO又是另一个基地址,所以有gpio节点和pinctrl节点。
但是现在我们sun8i-h3都放在一个基地址了,所以gpio、pinctrl描述的是同一个节点。
我们去内核搜索一下,grep一下0x01C20800这个地址即可:
pio
接着我们可以去找下他的compatible属性,搜索一下 “&pio”很快就找到:
compatible
compatible属性是:“allwinner,sun8i-h3-pinctrl”
那么可以安心去找他的代码了: static const struct sunxi_pinctrl_desc sun8i_h3_pinctrl_data = { .pins = sun8i_h3_pins,//数组内容放在pins字段 .npins = ARRAY_SIZE(sun8i_h3_pins), .irq_banks = 2, .irq_read_needs_mux = true }; static int sun8i_h3_pinctrl_probe(struct platform_device *pdev) { return sunxi_pinctrl_init(pdev, &sun8i_h3_pinctrl_data); } static const struct of_device_id sun8i_h3_pinctrl_match[] = { { .compatible = "allwinner,sun8i-h3-pinctrl", }, {} }; static struct platform_driver sun8i_h3_pinctrl_driver = { .probe = sun8i_h3_pinctrl_probe, .driver = { .name = "sun8i-h3-pinctrl", .of_match_table = sun8i_h3_pinctrl_match, }, }; 这里面有个数组需要注意一下,那就是:sun8i_h3_pins static const struct sunxi_desc_pin sun8i_h3_pins[] = { SUNXI_PIN(SUNXI_PINCTRL_PIN(A, 0), SUNXI_FUNCTION(0x0, "gpio_in"), SUNXI_FUNCTION(0x1, "gpio_out"), SUNXI_FUNCTION(0x2, "uart2"), /* TX */ SUNXI_FUNCTION(0x3, "jtag"), /* MS */ SUNXI_FUNCTION_IRQ_BANK(0x6, 0, 0)), /* PA_EINT0 */ SUNXI_PIN(SUNXI_PINCTRL_PIN(A, 1), SUNXI_FUNCTION(0x0, "gpio_in"), SUNXI_FUNCTION(0x1, "gpio_out"), SUNXI_FUNCTION(0x2, "uart2"), /* RX */ SUNXI_FUNCTION(0x3, "jtag"), /* CK */ SUNXI_FUNCTION_IRQ_BANK(0x6, 0, 1)), /* PA_EINT1 */ SUNXI_PIN(SUNXI_PINCTRL_PIN(A, 2), SUNXI_FUNCTION(0x0, "gpio_in"), SUNXI_FUNCTION(0x1, "gpio_out"), SUNXI_FUNCTION(0x2, "uart2"), /* RTS */ SUNXI_FUNCTION(0x3, "jtag"), /* DO */ SUNXI_FUNCTION_IRQ_BANK(0x6, 0, 2)), /* PA_EINT2 */ SUNXI_PIN(SUNXI_PINCTRL_PIN(A, 3), SUNXI_FUNCTION(0x0, "gpio_in"), SUNXI_FUNCTION(0x1, "gpio_out"), SUNXI_FUNCTION(0x2, "uart2"), /* CTS */ SUNXI_FUNCTION(0x3, "jtag"), /* DI */ SUNXI_FUNCTION_IRQ_BANK(0x6, 0, 3)), /* PA_EINT3 */ SUNXI_PIN(SUNXI_PINCTRL_PIN(A, 4), SUNXI_FUNCTION(0x0, "gpio_in"), SUNXI_FUNCTION(0x1, "gpio_out"), SUNXI_FUNCTION(0x2, "uart0"), /* TX */ SUNXI_FUNCTION_IRQ_BANK(0x6, 0, 4)), /* PA_EINT4 */ //...... } 看到那些"管脚映射结构体"数组里的参数,A0、A1…是不是觉得有有那么一丝丝熟悉?
里面的参数可以解读为:以A6为例
配置0x0为输入,0x1为输出,0x2为复用为串口,0x6为中断线配置,和芯片手册上是完全对应的!
进入probe函数看,挑一些重点的来写吧: int sunxi_pinctrl_init_with_variant(struct platform_device *pdev, const struct sunxi_pinctrl_desc *desc, unsigned long variant) { pctl = devm_kzalloc(&pdev->dev, sizeof(*pctl), GFP_KERNEL); //...... res = platform_get_resource(pdev, IORESOURCE_MEM, 0); pctl->membase = devm_ioremap_resource(&pdev->dev, res);//基地址,也就是0x01C20800 pctl->dev = &pdev->dev; pctl->desc = desc; pctl->variant = variant; //...... ret = sunxi_pinctrl_build_state(pdev);//重要!和pinctrl子系统有关,懒得分析了,后面给链接,讲得挺好的 //...... for (i = 0, pin_idx = 0; i < pctl->desc->npins; i++) {//取出数组内容 const struct sunxi_desc_pin *pin = pctl->desc->pins + i;//数组内容 if (pin->variant && !(pctl->variant & pin->variant)) continue; pins[pin_idx++] = pin->pin; } //...... pctrl_desc->name = dev_name(&pdev->dev); pctrl_desc->owner = THIS_MODULE; pctrl_desc->pins = pins;//里面就是之前数组里的内容 pctrl_desc->npins = pctl->ngroups; pctrl_desc->confops = &sunxi_pconf_ops;//和pinctrl里pinctrl_select_state函数使用有关,即(pinctrl_select_state) pctrl_desc->pctlops = &sunxi_pctrl_ops;//和pinctrl里pinctrl_select_state函数使用有关 pctrl_desc->pmxops = &sunxi_pmx_ops;//和pinctrl里pinctrl_select_state函数使用有关 pctl->pctl_dev = devm_pinctrl_register(&pdev->dev, pctrl_desc, pctl);//和pinctrl有关,注册 //...... last_pin = pctl->desc->pins[pctl->desc->npins - 1].pin.number; pctl->chip->owner = THIS_MODULE; pctl->chip->request = gpiochip_generic_request, pctl->chip->free = gpiochip_generic_free, pctl->chip->direction_input = sunxi_pinctrl_gpio_direction_input, pctl->chip->direction_output = sunxi_pinctrl_gpio_direction_output, pctl->chip->get = sunxi_pinctrl_gpio_get, pctl->chip->set = sunxi_pinctrl_gpio_set, pctl->chip->of_xlate = sunxi_pinctrl_gpio_of_xlate, pctl->chip->to_irq = sunxi_pinctrl_gpio_to_irq, pctl->chip->of_gpio_n_cells = 3,//cells参数个数 pctl->chip->can_sleep = false, pctl->chip->ngpio = round_up(last_pin, PINS_PER_BANK) - pctl->desc->pin_base; pctl->chip->label = dev_name(&pdev->dev); pctl->chip->parent = &pdev->dev; pctl->chip->base = pctl->desc->pin_base; ret = gpiochip_add_data(pctl->chip, pctl); for (i = 0; i < pctl->desc->npins; i++) { const struct sunxi_desc_pin *pin = pctl->desc->pins + i; ret = gpiochip_add_pin_range(pctl->chip, dev_name(&pdev->dev), pin->pin.number - pctl->desc->pin_base, pin->pin.number, 1);//建立动态链表chip->pin_ranges,node为gpio_pin_range,其成员range包含pin脚基地址。 if (ret) goto gpiochip_error; } //后面就是一些和irq相关的东西了 } 可以看出,这个函数,一开始
a)把GPIO的基地址取出来,放到pctl->membase里。 b)sunxi_pinctrl_build_state函数,这是和pinctrl子系统有关的,里面差不多是:将pctl->desc的子项数据(即sunxi_pinctrl_desc数据)复制到pctl相应子项(sunxi_pinctrl结构),文章末尾我会放一篇文章链接,讲的还不错,看那个即可。 c)把之前描述GPIO的数组放到pctrl_desc结构体中,以及填充confops、pctlops和pmxops三个字段,这三个字段就厉害了,当我们使用pinctrl_select_state(pinctrl的API)函数时就是调用的这些! d)填充pctl->chip里面的各个字段,其中字段:direction_input、direction_output和get、set字段是我们所熟悉的,当我们使用GPIO的函数,如:GPIO_SET_VALUE或者GPIO_GET_VALUE时就是调用到里面的回调函数!还有注意of_xlate这个字段,我们在获取设备树节点时也要用到!而且其中of_gpio_n_cells字段也让我们知道,设备树里描述GPIO的属性是三个参数。 e)调用gpiochip_add_data,其实如果我们不是从设备树里通过compatible属性来反推代码的话,也可以直接搜索这个函数,因为每个平台都会调用这个函数来添加GPIO,这里就是GPIO驱动将通过chip来与pinctrl联系(bsp工程师通过gpiochip_add将gpio chip添加到gpio子系统中) 举个例子,当我们要从设备树获取GPIO时,API为:
of_get_named_gpio_flags函数 int of_get_named_gpio_flags(struct device_node *np, const char *list_name, int index, enum of_gpio_flags *flags) { struct gpio_desc *desc; desc = of_get_named_gpiod_flags(np, list_name, index, flags);//获取描述 if (IS_ERR(desc)) return PTR_ERR(desc); else return desc_to_gpio(desc);//这里才是通过描述得到具体的GPIO } 其中 struct gpio_desc *of_get_named_gpiod_flags(struct device_node *np, const char *propname, int index, enum of_gpio_flags *flags) { ret = of_parse_phandle_with_args(np, propname, "#gpio-cells", index, &gpiospec);//获取参数,存放在gpiospec里 chip = of_find_gpiochip_by_xlate(&gpiospec); desc = of_xlate_and_get_gpiod_flags(chip, &gpiospec, flags); return desc; } 重点就在of_xlate_and_get_gpiod_flags函数里: static struct gpio_desc *of_xlate_and_get_gpiod_flags(struct gpio_chip *chip, struct of_phandle_args *gpiospec, enum of_gpio_flags *flags) { int ret; if (chip->of_gpio_n_cells != gpiospec->args_count) return ERR_PTR(-EINVAL); ret = chip->of_xlate(chip, gpiospec, flags); if (ret < 0) return ERR_PTR(ret); return gpiochip_get_desc(chip, ret); } 可以看到,这里就是会调用到我们之前说的of_xlate回调函数了,即sunxi_pinctrl_gpio_of_xlate函数: static int sunxi_pinctrl_gpio_of_xlate(struct gpio_chip *gc, const struct of_phandle_args *gpiospec, u32 *flags) { int pin, base; base = PINS_PER_BANK * gpiospec->args[0]; pin = base + gpiospec->args[1]; if (pin > gc->ngpio) return -EINVAL; if (flags) *flags = gpiospec->args[2]; return pin; } 可以简单看出,我们的设备树里GPIO的属性有三个参数,第一个是base,第二个是pin引脚,第三个是flag标志了。
看了下设备树,也确实是这样写的:
a10
设备树这里描述的就是A10了,从芯片文档我们可知,分为好几组IO口,第0组就是A。也就是base是0,pin是10,flags是GPIO_ACTIVE_HIGH。 再者,of_get_named_gpiod_flags函数的返回值为gpio_desc结构体,会通过调用desc_to_gpio函数通过gpio_desc得到具体的GPIO: int desc_to_gpio(const struct gpio_desc *desc) { //gdev->base在gpiochip_add_data函数填充 return desc->gdev->base + (desc - &desc->gdev->descs[0]); } ###同理
    我们在设置某个GPIO为高时: static inline void gpio_set_value(unsigned int gpio, int value) { __gpio_set_value(gpio, value); } __gpio_set_value
    -->gpiod_set_raw_value
        -->_gpiod_set_raw_value
            -->chip->set(chip, gpio_chip_hwgpio(desc), value);//调用set回调函数 gpio_chip_hwgpio:获取该gpio号对应于该chip的offset,由于chip的起始号不一定就是开始与系统全局desc的起点,需要这个函数转换一下
其中set回调函数就是sunxi_pinctrl_gpio_set函数了: static void sunxi_pinctrl_gpio_set(struct gpio_chip *chip, unsigned offset, int value) { struct sunxi_pinctrl *pctl = gpiochip_get_data(chip); u32 reg = sunxi_data_reg(offset); u8 index = sunxi_data_offset(offset); unsigned long flags; u32 regval; raw_spin_lock_irqsave(&pctl->lock, flags); regval = readl(pctl->membase + reg); if (value) regval |= BIT(index); else regval &= ~(BIT(index)); writel(regval, pctl->membase + reg); raw_spin_unlock_irqrestore(&pctl->lock, flags); } 里面基本就是:
先读取GPIO寄存器的值
修改值
再写回去!
其中读写的地址为(pctl->membase + reg),这里pctl->membase就是我们文章一开始分析时获取到的0x01C20800 地址了。 . 关于什么使用pinctrl,有这么几个API: struct pinctrl *devm_pinctrl_get(struct device *dev) pinctrl_lookup_state //寻找一个pin的配置 pinctrl_select_state // 设置选择一个pin的配置 .
关于pinctrl的文章,可以看看这个:
链接:
gpio子系统和pinctrl子系统(一)
gpio子系统和pinctrl子系统(二)
gpio子系统和pinctrl子系统(三)
Linux内核中提供了pinctrl子系统,目的是为了统一各SoC厂商的pin脚管理,避免各SoC厂商各自实现相同的pin脚管理子系统,减少SoC厂商系统移植工作量。
功能:
  1. 管理系统中所有可以控制的pin。在系统初始化的时候,枚举所有可以控制的pin,并标识这些pin。
  2. 管理这些pin的复用(Multiplexing)。对于SOC而言,其引脚除了配置成普通GPIO之外,若干个引脚还可以组成一个pin group,形成特定的功能。例如pin number是{ 0, 8, 16, 24 }这四个引脚组合形成一个pin group,提供SPI的功能。pin control subsystem要管理所有的pin group。
  3. 配置这些pin的特性。例如配置该引脚上的pull-up/down电阻,配置drive strength等。
  4. 与GPIO子系统的交互
  5. 实现pin中断
关于为什么引进pinctrl,看这篇文章:Pinctrl基础简介
即:Gpiolib方式的缺点在于:当同一套代码对应多个board设计时,需要在board--gpiomux.c文件中加宏进行区分。对于不同平台项目,在board-msm8974-gpiomux.c文件中添加了很多宏控。
pinctrl方式可以避免代码中的这种冗余代码,它将board--gpiomux.c文件中的配置信息移到-pinctrl.dtsi;这样,针对不同project的board设计,分别在各自project的-pinctrl.dtsi中定义各自的gpio配置信息。
.
gpio子系统让驱动工程师不用关心底层gpio chip的具体实现,让bsp工程师不用关心上层驱动工程师的使用方式。pinctrl子系统帮我们管理了pin信息,包括了pin的mux和conf,同时也透明的处理了与gpio子系统的关联以及设备模型的关联。
了解更多,请点击:蜗窝科技