本笔记仅以IMX6ULL为例子,方便本人后续学习回顾所用。
imx6ull 设备树中引脚定义规则和解析——pinctrl
imx6 引脚定义在 ”imx6ul-pinfunc.h“中,一个引脚一般支持8个可选功能(alternate MUX_MODE 缩写为ALT), 通过IOMUX Controller的控制器进行选择。
IOMUX Controller主要通过两个寄存器进行引脚的配置:
IOMUXC_SW_MUX_CTL_PAD_XXX :
XXX代表某一个PAD的名称,用于配置引脚MUX的输入功能,包括UART,GPIO,CSI 等功能。
IOMUXC_SW_PAD_CTL_PAD__XXX :
用于配置具体功能的特性,包括 上拉/下拉,速度,等特性
这里补充一下本人对Pin和PAD理解,如有不对,欢迎各位指出:
(1) Pin跟Lead差不多是一回事,都是指Silicon DIE封装后,留给用户使用的引脚。
(2)PAD是针对DIE的连接而言的,对于芯片使用者是不可见的,可以理解成Die上用于焊接打线的焊盘。
下面为imx6ul-pinfunc.h 中的部分定义:
#define MX6UL_PAD_UART1_CTS_B__UART1_DCE_CTS 0x008C 0x0318 0x0000 0x0 0x0
#define MX6UL_PAD_UART1_CTS_B__UART1_DTE_RTS 0x008C 0x0318 0x0620 0x0 0x2
#define MX6UL_PAD_UART1_CTS_B__ENET1_RX_CLK 0x008C 0x0318 0x0000 0x1 0x0
#define MX6UL_PAD_UART1_CTS_B__USDHC1_WP 0x008C 0x0318 0x066C 0x2 0x1
#define MX6UL_PAD_UART1_CTS_B__CSI_DATA04 0x008C 0x0318 0x04D8 0x3 0x0
#define MX6UL_PAD_UART1_CTS_B__ENET2_1588_EVENT1_IN 0x008C 0x0318 0x0000 0x4 0x0
#define MX6UL_PAD_UART1_CTS_B__GPIO1_IO18 0x008C 0x0318 0x0000 0x5 0x0
#define MX6UL_PAD_UART1_CTS_B__USDHC2_WP 0x008C 0x0318 0x069C 0x8 0x1
在设备树文件中,定义方法如下:
/* sneak KEY */
pinctrl_key: keygrp {
fsl,pins = <
MX6UL_PAD_UART1_CTS_B__GPIO1_IO18 0xF080 /* KEY0 */
>;
};
这里以MX6UL_PAD_UART1_CTS_B__GPIO1_IO18为例
#define MX6UL_PAD_UART1_CTS_B__GPIO1_IO18 0x008C 0x0318 0x0000 0x5 0x0
其中:
0x008C---> The pin mux register.
0x0318---> The config register.
0x0000---> The select input register
0x5 ---> mux_mode
0 ----> input_value
这里的mux register和config register对应的数值,都是该寄存器相较于基地址的偏移地址
在设备树文件中上还需要给这个引脚赋值
MX6UL_PAD_UART1_CTS_B__GPIO1_IO18 0xF080 /* KEY0 */
0xF080 ->config value
这里的赋值可以参考逻辑开发时对该引脚的电气属性配置数值
imx6ull 设备树中引脚定义规则和解析——根节点
一、根节点命名格式
/ {
model = "Freescale i.MX6 ULL 14x14 EVK Board";
compatible = "fsl,imx6ull-14x14-evk", "fsl,imx6ull";
chosen {
stdout-path = &uart1;
};
memory {
reg = <0x80000000 0x20000000>;
};
reserved-memory {
#address-cells = <1>;
#size-cells = <1>;
ranges;
linux,cma {
compatible = "shared-dma-pool";
reusable;
size = <0x14000000>;
linux,cma-default;
};
};
backlight {
compatible = "pwm-backlight";
pwms = <&pwm1 0 5000000>;
brightness-levels = <0 4 8 16 32 64 128 255>;
default-brightness-level = <7>;
status = "okay";
};
...
/* sneak key 2022/4/18 */
key {
#address-cells = <1>;
#size-cells = <1>;
compatible = "sneak-key"; //compatible兼容属性,属性值为一个字符串列表
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_key>;
key-gpio = <&gpio1 18 GPIO_ACTIVE_LOW>;
status = "okay";
};
};
二、设备/根节点的常见属性
样例:
/* sneak key 2022/4/18 */
key {
#address-cells = <1>;
#size-cells = <1>;
compatible = "sneak-key"; //compatible兼容属性,属性值为一个字符串列表
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_key>;
key-gpio = <&gpio1 18 GPIO_ACTIVE_LOW>;
status = "okay";
};
1、#address-cells 和#size-cells 属性
这两个属性的值都是无符号 32 位整形,#address-cells 和#size-cells这两个属性可以用在任何拥有子节点的设备中,用于描述子节点的地址信息。#address-cells属性值决定了子节点reg 属性中地址信息所占用的字长(32 位),#size-cells属性值决定了子节点 reg属性中长度信息所占的字长(32 位)。#address-cells 和#size-cells 表明了子节点应该如何编写reg属性值,一般 reg 属性都是和地址有关的内容,和地址相关的信息有两种:起始地址和地址长度,reg属性的格式一为:
reg = <address1 length1 address2 length2 address3 length3……>
每个“address length”
组合表示一个地址范围,其中 address
是起始地址,length
是地址长度,#address-cells
表明 address
这个数据所占用的字长,#size-cells
表明length
这个数据所占用的字长,比如:
/* sneak 2022/4/9 */
sneak {
#address-cells = <1>;
#size-cells = <1>;
compatible = "sneak-led";
status = "okay";
reg = < 0X020C406C 0X04 /* CCM_CCGR1_BASE */
0X020E0068 0X04 /* SW_MUX_GPIO1_IO03_BASE */
0X020E02F4 0x04 /* SW_PAD_GPIO1_IO03_BASE */
0X0209C000 0x04 /* GPIO1_DR_BASE */
0X0209C004 0X04 >; /* GPIO1_GDIR_BASE */
};
#address-cells = <1>;//表示用一个32位的数来描述地址
#size-cells = <1>;//表示用1个32位的数来描述该地址的大小
上面两个信息#address-cells和#size-cells主要用来描述子节点里面reg的信息
reg里面的个数,应该是address-cells + size-cells的整数倍
解析上方代码:
reg的起始地址为0X020C406C 大小为0x04
reg的起始地址为0X020E02F4 大小为0x04
reg的起始地址为0X020E02F4 大小为0x04等。
2、compatible 属性
compatible
属性也叫做“兼容性”属性,这是非常重要的一个属性!compatible
属性的值是一个字符串列表,compatible
属性用于将设备和驱动绑定起来。字符串列表用于选择设备所要使用的驱动程序,compatible
属性的值格式如下所示:
model = "SMDK24440";
compatible = "samsung,smdk2440","samsung,smdk24140","samsung,smdk24xx";
这里的compatible属性声明想要什么machine_desc,属性值可以是一系列字符串,依次与machine_desc匹配。
内核最好支持samsung,smdk2440,如果不支持,再尝试是否支持samsung,smdk24140,再不支持,最后尝试samsung,smdk24xx</code
总结如下:
设备树根节点的compatible属性列出了一系列的字符串,表示它兼容的单板名,从"最兼容"到次之;
特别注意,在设备节点中compatible 属性值是为了匹配 Linux 内核中的驱动程序
3、model 属性
model 属性值也是一个字符串,一般 model 属性描述设备模块信息,比如名字什么的,比如:
model = "wm8960-audio";
4、status 属性
status
属性看名字就知道是和设备状态有关的,status
属性值也是字符串,字符串是设备的状态信息,可选的状态如下表所示:
5、ranges 属性
ranges属性值可以为空或者按照(child-bus-address,parent-bus-address,length)格式编写的数字矩阵,ranges 是一个地址映射/转换表,ranges 属性每个项目由子地址、父地址和地址空间长度
这三部分组成:
child-bus-address:子总线地址空间的物理地址,由父节点的#address-cells 确定此物理地址
所占用的字长。
parent-bus-address:父总线地址空间的物理地址,同样由父节点的#address-cells 确定此物
理地址所占用的字长。
length:子地址空间的长度,由父节点的#size-cells 确定此地址长度所占用的字长。