本系列導航：

有上一篇文章，我們瞭解了dts的背景知識和相關基礎，這次我們對應實際裝置進行一下相關分析。

DTS裝置樹的匹配過程

一個dts檔案確定一個專案，多個專案可以包含同一個dtsi檔案。找到該專案對應的dts檔案即找到了該裝置樹的根節點。

kernel\arch\arm\boot\dts\qcom\sdm630-mtp.dts

1. /* Copyright (c) 2017, The Linux Foundation. All rights reserved. 
2.  * 
3.  * This program is free software; you can redistribute it and/or modify
    
4.  * it under the terms of the GNU General Public License version 2 and 
5.  * only version 2 as published by the Free Software Foundation. 
6.  * 
7.  * This program is distributed in the hope that it will be useful, 
8.  * but WITHOUT ANY WARRANTY; without even the implied warranty of 
9.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    
10.  * GNU General Public License for more details. 
11.  */
12. /dts-v1/;  
13. #include "sdm630.dtsi"
14. #include "sdm630-mtp.dtsi"
15. //#include "sdm660-external-codec.dtsi"
16. #include "sdm660-internal-codec.dtsi"
17. #include "synaptics-dsx-i2c.dtsi"
18. / {  
19.     model = "Qualcomm Technologies, Inc. SDM 630 PM660 + PM660L MTP";  
20.     compatible = "qcom,sdm630-mtp"
    , "qcom,sdm630", "qcom,mtp";  
21.     qcom,board-id = <80>;  
22.     qcom,pmic-id = <0x0001001b 0x0101011a 0x00x0>,  
23.             <0x0001001b 0x0201011a 0x00x0>;  
24. };  
25. &tavil_snd {  
26.     qcom,msm-mbhc-moist-cfg = <0>, <0>, <3>;  
27. };  

當然devicetree的根節點也是需要和板子進行匹配的，這個匹配資訊存放在sbl（second boot loader）中，對應dts檔案中描述的board-id（上面程式碼中的qcom,board-id屬性），通過共享記憶體傳遞給bootloader，由bootloader將此board-id匹配dts檔案（devicetree的根節點檔案），將由dtc編譯後的dts檔案（dtb檔案）載入到記憶體，然後在kernel中展開dts樹，並且掛載dts樹上的所有裝置。

（ps：cat /proc/cmdline 檢視cmdline）

Dts中相關符號的含義

/        根節點

@     如果裝置有地址，則由此符號指定

&     引用節點

:        冒號前的label是為了方便引用給節點起的別名，此label一般使用為&label

,        屬性名稱中可以包含逗號。如compatible屬性的名字 組成方式為"[manufacturer], [model]"，加入廠商名是為了避免重名。自定義屬性名中通常也要有廠商名，並以逗號分隔。

##並不表示註釋。如 #address-cells ，#size-cells 用來決定reg屬性的格式。

        空屬性並不一定表示沒有賦值。如 interrupt-controller 一個空屬性用來宣告這個node接收中斷訊號

資料型別

“”     引號中的為字串，字串陣列：”strint1”,”string2”,”string3”

< >    尖括號中的為32位整形數字，整形陣列<12 3 4>

[ ]      方括號中的為32位十六進位制數，十六機制資料[0x11 0x12 0x13]  其中0x可省略

構成節點名的有效字元：

構成屬性名的有效字元：

DTS中幾個難理解的屬性的解釋

a. 地址

裝置的地址特性根據一下幾個屬性來控制：

1. reg  
2. #address-cells
3. #size-cells

reg意為region，區域。格式為：

1. reg = <address1length1 [address2 length2] [address3 length3]>;  

address-cells決定了address1/2/3包含幾個cell，size-cells決定了length1/2/3包含了幾個cell。本地模組例如：

1. spi@10115000{  
2.         compatible = "arm,pl022";  
3.         reg = <0x101150000x1000 >;  
4. };  

位於0x10115000的SPI裝置申請地址空間，起始地址為0x10115000，長度為0x1000，即屬於這個SPI裝置的地址範圍是0x10115000~0x10116000。

實際應用中，有另外一種情況，就是通過外部晶片片選啟用模組。例如，掛載在外部總線上，需要通過片選線工作的一些模組：

1. external-bus{  
2.     #address-cells = <2>
3.     #size-cells = <1>;
4.     ethernet@0,0 {  
5.         compatible = "smc,smc91c111";  
6.         reg = <000x1000>;  
7.     };  
8.     i2c@1,0 {  
9.         compatible ="acme,a1234-i2c-bus";  
10.         #address-cells = <1>;
11.         #size-cells = <0>;
12.         reg = <100x1000>;  
13.         rtc@58 {  
14.             compatible ="maxim,ds1338";  
15.             reg = <58>;  
16.         };  
17.     };  
18.     flash@2,0 {  
19.         compatible ="samsung,k8f1315ebm", "cfi-flash";  
20.         reg = <200x4000000>;  
21.     };  
22. };  

external-bus使用兩個cell來描述地址，一個是片選序號，另一個是片選序號上的偏移量。而地址空間長度依然用一個cell來描述。所以以上的子裝置們都需要3個cell來描述地址空間屬性——片選、偏移量、地址長度。在上個例子中，有一個例外，就是i2c控制器模組下的rtc模組。因為I2C裝置只是被分配在一個地址上，不需要其他任何空間，所以只需要一個address的cell就可以描述完整，不需要size-cells。

當需要描述的裝置不是本地裝置時，就需要描述一個從裝置地址空間到CPU地址空間的對映關係，這裡就需要用到ranges屬性。還是以上邊的external-bus舉例：

1. #address-cells= <1>;
2. #size-cells= <1>;
3. ...  
4. external-bus{  
5.     #address-cells = <2>
6.     #size-cells = <1>;
7.     ranges = <000x101000000x10000// Chipselect 1,Ethernet
8.               100x101600000x10000// Chipselect 2, i2c controller
9.               200x300000000x1000000>; // Chipselect 3, NOR Flash
10. };  

ranges屬性為一個地址轉換表。表中的每一行都包含了子地址、父地址、在自地址空間內的區域大小。他們的大小（包含的cell）分別由子節點的address-cells的值、父節點的address-cells的值和子節點的size-cells來決定。以第一行為例：

·        0 0 兩個cell，由子節點external-bus的address-cells=<2>決定；

·        0x10100000 一個cell，由父節點的address-cells=<1>決定；

·        0x10000 一個cell，由子節點external-bus的size-cells=<1>決定。
最終第一行說明的意思就是：片選0，偏移0（選中了網絡卡），被對映到CPU地址空間的0x10100000~0x10110000中，地址長度為0x10000。

b. 中斷

描述中斷連線需要四個屬性：
1. interrupt-controller 一個空屬性用來宣告這個node接收中斷訊號；
2. #interrupt-cells 這是中斷控制器節點的屬性，用來標識這個控制器需要幾個單位做中斷描述符；
3. interrupt-parent 標識此裝置節點屬於哪一個中斷控制器，如果沒有設定這個屬性，會自動依附父節點的；
4. interrupts 一箇中斷識別符號列表，表示每一箇中斷輸出訊號。

如果有兩個，第一個是中斷號，第二個是中斷型別，如高電平、低電平、邊緣觸發等觸發特性。對於給定的中斷控制器，應該仔細閱讀相關文件來確定其中斷標識該如何解析。一般如下：

二個cell的情況

第一個值： 該中斷位於他的中斷控制器的索引；