最近在移植linux，用到kernel版本為3.14.28，在高版本的核心原始碼中用到了裝置樹（device-tree），裝置樹中用到pinctrl的配置，記錄一下。

1、普通設定

在配置串列埠時，pinctrl的配置資訊如下所示：

1. &uart2 {  
2.     pinctrl-names = "default";  
3.     pinctrl-0 = <&pinctrl_uart2>;  
4.     status = "okay";  
5. };  
6. //。。。。。。。。
7. pinctrl_uart2: uart2grp {  
8.             fsl,pins = <  
9.                 MX6QDL_PAD_SD4_DAT7__UART2_TX_DATA  0x1b0b1  
10.                 MX6QDL_PAD_SD4_DAT4__UART2_RX_DATA  0x1b0b1  
11.             >;  
12. };  

這裡的MX6QDL_PAD_SD4_DAT7__UART2_TX_DATA在imx6dl-pinfunc.h檔案中有如下定義:

1. MX6QDL_PAD_SD4_DAT7__UART2_TX_DATA          0x35c 0x744 0x000 0x2 0x0  

將管腳的配置展開即： 0x35c 0x744 0x000 0x2 0x00x1b0b1

 

想知道這六個值都是什麼意思，可以從兩個路出發：①查詢解讀dts的檔案，即看核心原始碼；②在網上查詢相關知識。

1.1 檢視原始碼對裝置樹檔案的解讀

首先在imx6dl-pinfunc.h檔案中有對前5個變數的解釋，如下圖：

為了驗證這5個變數，並查詢第6個變數的含義，我們開啟讀取裝置樹檔案的程式碼。

讀取dts檔案的檔案為：drivers/pinctrl/freescale/pinctrl-imx.c，實現函式名為：static int imx_pinctrl_parse_groups(。。。)，如下：

1. staticint imx_pinctrl_parse_groups(
   struct device_node *np,  
2.                     struct imx_pin_group *grp,  
3.                     struct imx_pinctrl_soc_info *info,  
4.                     u32 index)  
5. {  
6.     int size, pin_size;  
7.     const __be32 *list;  
8.     int i;  
9.     u32 config;  
10.     dev_dbg(info->dev, "group(%d): %s\n", index, np->name);  
11.     if (info->flags & SHARE_MUX_CONF_REG)  
12.         pin_size = SHARE_FSL_PIN_SIZE;  
13.     else
14.         pin_size = FSL_PIN_SIZE;  
15.     /* Initialise group */
16.     grp->name = np->name;  
17.     /* 
18.      * the binding format is fsl,pins = <PIN_FUNC_ID CONFIG ...>, 
19.      * do sanity check and calculate pins number 
20.      */
21.     list = of_get_property(np, "fsl,pins", &size);  
22.     if (!list) {  
23.         dev_err(info->dev, "no fsl,pins property in node %s\n", np->full_name);  
24.         return -EINVAL;  
25.     }  
26.     /* we do not check return since it's safe node passed down */
27.     if (!size || size % pin_size) {  
28.         dev_err(info->dev, "Invalid fsl,pins property in node %s\n", np->full_name);  
29.         return -EINVAL;  
30.     }  
31.     grp->npins = size / pin_size;  
32.     grp->pins = devm_kzalloc(info->dev, grp->npins * sizeof(struct imx_pin),  
33.                 GFP_KERNEL);  
34.     grp->pin_ids = devm_kzalloc(info->dev, grp->npins * sizeof(unsigned int),  
35.                 GFP_KERNEL);  
36.     if (!grp->pins || ! grp->pin_ids)  
37.         return -ENOMEM;  
38.     for (i = 0; i < grp->npins; i++) {  
39.         u32 mux_reg = be32_to_cpu(*list++);  
40.         u32 conf_reg;  
41.         unsigned int pin_id;  
42.         struct imx_pin_reg *pin_reg;  
43.         struct imx_pin *pin = &grp->pins[i];  
44.         if (info->flags & SHARE_MUX_CONF_REG)  
45.             conf_reg = mux_reg;  
46.         else
47.             conf_reg = be32_to_cpu(*list++);  
48.         pin_id = mux_reg ? mux_reg / 4 : conf_reg / 4;  
49.         pin_reg = &info->pin_regs[pin_id];  
50.         pin->pin = pin_id;  
51.         grp->pin_ids[i] = pin_id;  
52.         pin_reg->mux_reg = mux_reg;  
53.         pin_reg->conf_reg = conf_reg;  
54.         pin->input_reg = be32_to_cpu(*list++);  
55.         pin->mux_mode = be32_to_cpu(*list++);  
56.         pin->input_val = be32_to_cpu(*list++);  
57.         /* SION bit is in mux register */
58.         config = be32_to_cpu(*list++);  
59.         if (config & IMX_PAD_SION)  
60.             pin->mux_mode |= IOMUXC_CONFIG_SION;  
61.         pin->config = config & ~IMX_PAD_SION;  
62.         dev_dbg(info->dev, "%s: 0x%x 0x%08lx", info->pins[pin_id].name,  
63.                 pin->mux_mode, pin->config);  
64.     }  
65.     return 0;  
66. }

這段程式碼中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.         pinctrl_gpio_leds: gpioledsgrp {  
2.             fsl,pins = <  
3.                 MX6QDL_PAD_DISP0_DAT21__GPIO5_IO15  0x80000000  
4.             >;  
5.         };  
6.         pinctrl_i2c2: i2c2grp {  
7.             fsl,pins = <  
8.                 MX6QDL_PAD_EIM_EB2__I2C2_SCL    0x4001b8b1  
9.                 MX6QDL_PAD_KEY_ROW3__I2C2_SDA   0x4001b8b1  
10.             >;  
11.         };

可以看出來特殊的配置就是後面的值也就是上一篇講的config（pad_ctrl）的值改變了，變為0x80000000和0x4001b8b1了，當我們查詢相應的pad值時是這樣的：

這明顯不和常理，在上圖中顯示高15位全部置0，取值也沒啥用，那麼為什麼設定為0x80000000和0x4001b8b1呢？在網上搜羅一番沒有任何有幫助的文件，只能靠自己了。還是老思路，查詢裝置樹檔案的讀取原始碼，drivers/pinctrl/freescale/pinctrl-imx.c中，找到了驚喜！！！程式碼如下

1. /* The bits in CONFIG cell defined in binding doc*/
2. #define IMX_NO_PAD_CTL  0x80000000  /* no pin config need */
3. #define IMX_PAD_SION 0x40000000     /* set SION */</span>

再將IMX_NO_PAD_CTL使用部分的程式碼貼上（隨便找一處）

1. for (i = j = 0; i < grp->npins; i++) {  
2.         if (!(grp->pins[i].config & IMX_NO_PAD_CTL)) {  
3.             new_map[j].type = PIN_MAP_TYPE_CONFIGS_PIN;  
4.             new_map[j].data.configs.group_or_pin =  
5.                     pin_get_name(pctldev, grp->pins[i].pin);  
6.             new_map[j].data.configs.configs = &grp->pins[i].config;  
7.             new_map[j].data.configs.num_configs = 1;  
8.             j++;  
9.         }  
10.     }

可以看出來確實如註釋（/* no pin config need */）所述，表示該管腳的配置config（pad_ctrl）無效，或者說不需要。

同理0x40000000表示設定了SION。但是0x4001b8b1表示什麼意思呢，從上一個註釋（/* The bits in CONFIG cell defined in binding doc*/）可以找到方向，即取binding doc中找，所以開啟Documentation/devicetree/bindings/pinctrl目錄下的fsl,imx6dl-pinctrl.txt檔案，裡面有關於SION的介紹，如下：

相關推薦