最近在移植Linux,用到kernel版本为3.18.22和4.1.3,在高版本的内核源码中用到了设备树(device-tree),设备树中用到pinctrl的配置,记录一下。
1、普通设置
在配置串口时,pinctrl的配置信息如下所示:
这里的MX6QDL_PAD_SD4_DAT7__UART2_TX_DATA在imx6dl-pinfunc.h文件中有如下定义:
将管脚的配置展开即: 0x35c 0x744 0x000 0x2 0x00x1b0b1
想知道这六个值都是什么意思,可以从两个路出发:①查找解读dts的文件,即看内核源码;②在网上查找相关知识。
1.1 查看源码对设备树文件的解读
首先在imx6dl-pinfunc.h文件中有对前5个变量的解释,如下图:
为了验证这5个变量,并查找第6个变量的含义,我们打开读取设备树文件的代码。
读取dts文件的文件为:linux-3.18.22/drivers/pinctrl/freescale/pinctrl-imx.c,实现函数名为:static int imx_pinctrl_parse_groups(。。。),如下:
这段代码中list = of_get_property(np, "fsl,pins", &size);实现了读取dts文件中的fsl,pin属性值,并保存在了list指针变量中。紧接着,分别将list中的值mux_reg、conf_reg、input_reg、mux_mode、input_val、config六个变量中,由名字可以猜测个大概,前5个得以验证,第六个表示config,config的值说白了就是对寄存器配置(上拉电阻、频率等等)的值,就是pad_ctrl的值。
因此对应关系如下:
0x35c | 0x744 | 0x000 | 0x2 | 0x0 | 0x1b0b1
---------------------------------------------------------------------------------------------------------
mux_ctrl_ofs | pad_ctrl_ofs | sel_input_ofs | mux_mode | sel_input | pad_ctrl
以上参数在参考手册怎么确定的呢?由于是对复用管脚的配置,于是在管脚复用的章节(IOMUXC)中查找。但是现确定pad name才方便,于是定义在External Signals and Pin Multiplexing章节,搜索MX6QDL_PAD_SD4_DAT7__UART2_TX_DATA的中间部分:SD4_DAT7,如下图
可知UART2_TX_DATA是属于SD4_DAT7的ALT2,于是mux_mode=0x2即可。上图表格中最后一列SW_PAD_CTL_PAD_SD4_DATA7是config配置需要查找的名称,跳到管脚复用的章节(IOMUXC)中,找到SW_PAD_CTL_PAD_SD4_DATA7,如下所示:
如果直接取默认值的话结果是config=0x1b0b0,这里可以根据自己的需要(硬件)更改为与自己的板子匹配的值,我把最后SRE的值设置为1,即Fast Slew Rate,如下图说明:
OK,接下来是mux_ctrl_ofs、pad_ctrl_ofs、sel_input_ofs三个偏移值,这些值都是在复用管脚的章节确定的。因为pad name为SD4_DATA7,所以在找的时候可以拿它当关键字。
首先是mux_ctrl_ofs,找到IOMUXC_SW_MUX_CTL_PAD*开头的部分,结尾选择SD4_DATA7即可,如下图,
由”Address: 20E_0000h base + 35Ch offset = 20E_035Ch“中可知offset=35C,即mux_ctrl_oft=0x35c
其他的查找方法类似。pad_ctrl_ofs,查找IOMUXC_SW_PAD_CTL_PAD_SD4_DATA7一节,可知偏移值pad_ctrl_ofs=0x744
sel_input_ofs查找IOMUXC章节以SELECT_INPUT结尾的部分,中间选择UART2_TX,如果没有这里sel_input_ofs=0x000即可,对应的sel_input为0即可。如果有例如IOMUXC_UART2_UART_RX_DATA_SELECT_INPUT,即uart的rx管脚配置,如下图,所以RX的sel_input_ofs=0x904,这里选择对应的值“110 SD4_DATA4_ALT2 — Selecting ALT2 mode of pad SD4_DAT4 for UART2_RX_DATA..“所以RX(MX6QDL_PAD_SD4_DAT4__UART2_RX_DATA)的sel_input=0x6。
1.2 在网上查找
虽然没有完全对应的配置博客,但是http://blog.csdn.NET/xnwyd/article/details/9042159介绍了低版本内核源码的管脚配置方法,参考价值很大。
上面记录了设备树文件中管脚普通配置的查找与确定,下面介绍一下特殊的配置。
首先还是先看代码,看看到底特殊到哪里。
可以看出来特殊的配置就是后面的值也就是上一篇讲的config(pad_ctrl)的值改变了,变为0x80000000和0x4001b8b1了,当我们查找相应的pad值时是这样的:
这明显不和常理,在上图中显示高15位全部置0,取值也没啥用,那么为什么设置为0x80000000和0x4001b8b1呢?在网上搜罗一番没有任何有帮助的文档,只能靠自己了。还是老思路,查找设备树文件的读取源码,Linux-3.18.22/drivers/pinctrl/freescale/pinctrl-imx.c中,找到了惊喜!!!代码如下
再将IMX_NO_PAD_CTL使用部分的代码贴上(随便找一处)
可以看出来确实如注释(/* no pin config need */)所述,表示该管脚的配置config(pad_ctrl)无效,或者说不需要。
同理0x40000000表示设置了SION。但是0x4001b8b1表示什么意思呢,从上一个注释(/* The bits in CONFIG cell defined in binding doc*/)可以找到方向,即取binding doc中找,所以打开linux-3.18.22/Documentation/devicetree/bindings/pinctrl目录下的fsl,imx6dl-pinctrl.txt文件,里面有关于SION的介绍,如下:
再从芯片的参考手册中查阅可知,SION就相当于一个标志为(第30位),去掉这一位后config=0x1b8b1,这个值就是从pad_ctrl一节找到的,具体可以参见上一篇关于第6个参数的确定方法。