![[dts]DTS实例分析](https://image.shishitao.com:8440/aHR0cHM6Ly9ia3FzaW1nLmlrYWZhbi5jb20vdXBsb2FkL2NoYXRncHQtcy5wbmc%2FIQ%3D%3D.png?!?w=700&webp=1 "[dts]DTS实例分析")
此篇源文件arch/arm/boot/dts/imx6sx.dtsi
1. dts和dtsi完成的功能
以下是两段较为常见的dtsi和dts代码
uart5: serial@021f4000 {
compatible = "fsl,imx6sx-uart",
"fsl,imx6q-uart", "fsl,imx21-uart";
reg = <0x021f4000 0x4000>;
interrupts = <GIC_SPI IRQ_TYPE_LEVEL_HIGH>;
clocks = <&clks IMX6SX_CLK_UART_IPG>,
<&clks IMX6SX_CLK_UART_SERIAL>;
clock-names = "ipg", "per";
dmas = <&sdma >, <&sdma >;
dma-names = "rx", "tx";
status = "disabled";
};
以上这段代码更多出现在*.dtsi中
一般会在*.dtsi中将芯片的外设接口资源都做定义，
如uart5作为该外设的label，node-name@unit-address作为设备的名称，node-name只是设备类型，uart1/uart2/uart3等可以都是serial名称，而@后面则跟着设备寄存器起始地址。
compatible默认属性，
reg寄存器地址和长度，该uart5节点的父节点为aips2，在父节点中指明#address-cells = <1>;#size-cells = <1>;这决定了子节点字段长度address为1， length为1. 所以reg格式为reg = <0x021f4000 0x4000>;
interrupts对应的中断号和中断出发方式，uart5的父节点为aips2，而aips2的父节点为soc，soc节点定义了interrupt-parent = <&intc>;给出了节点所依附的中断控制器，如果节点没有指定interrupt-parent，那么就从父节点继承，所以该uart5节点继承了soc的中断控制器，即intc. 而intc节点的#interrupt-cells = <3>;所以就有了该节点中interrupts = <GIC_SPI 30 IRQ_TYPE_LEVEL_HIGH>;三个字段，具体这三个字段的含义可以参考芯片文档的描述。其中GIC_SPI定义在include/dt-bindings/interrupt-controller/arm-gic.h值为0，
clock外设时钟，在include/dt-bindings/clock/imx6sx-clock.h，指定设备工作时钟
status一般会设为disabled。
&uart5 {
pinctrl-names = "default";
pinctrl- = <&pinctrl_uart5>;
fsl,uart-has-rtscts;
status = "okay";
};
以上这段代码更多出现在*.dts中
在*.dts中如果想对该设备进行操作，需要进行override，至少status需要从disabled设置为okay, 当然也有可能需要对compatible属性进行重写(为了和自己的driver匹配)，另外需要使用&label首先引用该设备，使用pinctrl-names和pinctrl-0进行引脚的配置，当然这里可能出现多组引脚的配置，如下代码：
&usdhc3 {
pinctrl-names = "default", "state_100mhz", "state_200mhz";
pinctrl-0 = <&pinctrl_usdhc3>;
pinctrl- = <&pinctrl_usdhc3_100mhz>;
pinctrl- = <&pinctrl_usdhc3_200mhz>;
bus-width = <>;
cd-gpios = <&gpio2 GPIO_ACTIVE_HIGH>;
wp-gpios = <&gpio2 GPIO_ACTIVE_HIGH>;
keep-power-in-suspend;
enable-sdio-wakeup;
vmmc-supply = <&vcc_sd3>;
status = "okay";
};
而这里面的pinctrl-0对应的pinctrl_usdhc3内容如下：
pinctrl_usdhc3: usdhc3grp {
fsl,pins = <
MX6SX_PAD_SD3_CMD__USDHC3_CMD 0x17069
MX6SX_PAD_SD3_CLK__USDHC3_CLK 0x10071
MX6SX_PAD_SD3_DATA0__USDHC3_DATA0 0x17069
MX6SX_PAD_SD3_DATA1__USDHC3_DATA1 0x17069
MX6SX_PAD_SD3_DATA2__USDHC3_DATA2 0x17069
MX6SX_PAD_SD3_DATA3__USDHC3_DATA3 0x17069
MX6SX_PAD_SD3_DATA4__USDHC3_DATA4 0x17069
MX6SX_PAD_SD3_DATA5__USDHC3_DATA5 0x17069
MX6SX_PAD_SD3_DATA6__USDHC3_DATA6 0x17069
MX6SX_PAD_SD3_DATA7__USDHC3_DATA7 0x17069
MX6SX_PAD_KEY_COL0__GPIO2_IO_10 0x17059 /* CD */
MX6SX_PAD_KEY_ROW0__GPIO2_IO_15 0x17059 /* WP */
>;
};
这种pinctrl的设置可参照/Documentation/devicetree/bindinsg/pinctrl下示例代码
2. 通常会碰到的实际问题
到此，问题出现了：
1. 当写一个按键驱动，应该如何在*.dts或者*.dtsi中操作?
2. 当在串口driver中需要使用到某个pin脚作为普通输出IO，该如何操作？
3. 当在串口driver中需要使用某个muxpin脚作为ADC或者其他服用功能该如何操作？
4. 当在串口driver中有可能想使能某个功能而不想写定在driver代码中，该如何操作？
5. 当想向driver中传入一个常数如做delay延时操作等等，该如何操作？
解答：
1. 当写一个按键驱动，应该如何在*.dts或者*.dtsi中操作?
gpio-keys {
compatible = "gpio-keys";
pinctrl-names = "default";
pinctrl- = <&pinctrl_gpio_keys>;
volume-up {
label = "Volume Up";
gpios = <&gpio1 GPIO_ACTIVE_LOW>;
linux,code = <KEY_VOLUMEUP>;
};
volume-down {
label = "Volume Down";
gpios = <&gpio1 GPIO_ACTIVE_LOW>;
linux,code = <KEY_VOLUMEDOWN>;
};
};
pinctrl_gpio_keys: gpio_keysgrp {
fsl,pins = <
MX6SX_PAD_CSI_DATA04__GPIO1_IO_18 0x17059
MX6SX_PAD_CSI_DATA05__GPIO1_IO_19 0x17059
>;
};
2. 当在串口driver中需要使用到某个pin脚作为普通输出IO，该如何操作？
sii902x_reset: sii902x-reset {
compatible = "gpio-reset";
reset-gpios = <&gpio3 27 1>;
reset-delay-us = <>;
#reset-cells = <>;
status = "disabled";
};
最简单的不需要pinctrl来进行pin脚的设置，为什么？？？
3. 当在串口driver中需要使用某个muxpin脚作为ADC或者其他服用功能该如何操作？
这个问题其实上面有提到，就像上述的多个pin-names和多个pinctrl在后面的pinctrl中配置这个复用的管脚即可。
4. 当在串口driver中有可能想使能某个功能而不想写定在driver代码中，该如何操作？
&uart5 {
pinctrl-names = "default";
pinctrl- = <&pinctrl_uart5>;
fsl,uart-has-rtscts;
status = "okay";
};
只需要在driver中使用of函数读取此属性，如果有此字段，可以使能某些操作；如果没有就失能某些操作。
5. 当想向driver中传入一个常数如做delay延时操作等等，该如何操作？
&usdhc3 {
pinctrl-names = "default", "state_100mhz", "state_200mhz";
pinctrl- = <&pinctrl_usdhc3>;
pinctrl- = <&pinctrl_usdhc3_100mhz>;
pinctrl- = <&pinctrl_usdhc3_200mhz>;
bus-width = <8>;
cd-gpios = <&gpio2 GPIO_ACTIVE_HIGH>;
wp-gpios = <&gpio2 GPIO_ACTIVE_HIGH>;
keep-power-in-suspend;
enable-sdio-wakeup;
vmmc-supply = <&vcc_sd3>;
status = "okay";
};
只需要在driver中读取bus-width字段的值，即可获取到8这个常量，注意在devicetree中命名字段更多使用"-"而非下划线"_".