解读MT7620A上的DTS文件
DTS文件，即Device Tree Source，是某些芯片（在Openwrt的target/linux/中，至少ramips,lantiq和BRCM有此文件）用于描述硬件设备资源的文件。此文件是驱动研发人员用来配置这些芯片驱动的必要文件。 要想弄清楚DTS文件中的含义，笔者认为至少需要如下资料：芯片Datasheet，芯片开发手册，单板硬件连接图，单板GPIO配置清单，单板实物（有上盖） 。这里，笔者以配置一款采用MT7620A（主芯片）+MT7610E（5G wifi芯片）架构的路由器为例，描述一下对于DTS文件的解读。
手上资源： “MT7620_Datasheet”，“MT7620_ProgrammingGuide”，“MT7620_EEPROM Content v1_7.pdf”，单板硬件连接图，以及单板的GPIO配置清单，其中主要的几条内容如下：
通过分析硬件设计图，可以知道：port4是作为WAN口， 7610E和主CPU是通过PCIE接口连接
此外，linux/Documentation/devicetree目录中有一些说明文件，可以用于参考
OK，一切就绪；
下面解读一下DTS文件：MT7620a_MT7610e.dts （红色是我更改的部分；蓝色部分是注释）
/dts-v1/;
/include/ "mt7620a.dtsi" /*引用此文件，但同名定义以此文件为主*/
/ { /*根节点*/
compatible = "ralink,mt7620a-eval-board", "ralink,mt7620a-soc"; /*这些字符串列表被操作系统用来选择用哪一个driver来驱动该设备*/
model = "Ralink MT7620A evaluation board"; /*此字符串会显示在 单板status->system->model 页面中*/
palmbus@10000000 { /*寄存器映射位置，即0x1000,0000，见《MT7620_ProgrammingGuide》的1.3(P13)的 SYSCTL*/
sysc@0 {/*相对于palmbus的偏移，即0x1000,0000，见《MT7620_ProgrammingGuide》的1.3(P13)的 SYSCTL*/
ralink,gpiomux = "i2c", "jtag"; /*表示i2c和jtag，也可以用于gpio控制；具体到这里，是由于按键要用到i2c*/
ralink,uartmux = "gpio"; /*表示gpio，也可以用于UART输出*/
ralink,wdtmux = <1>;
};
/*MT7620A将GPIO分为4组，如下是针对各组的定义*/
gpio0: gpio@600 {/*相对于palmbus的偏移，即0x1000,0600，见《MT7620_ProgrammingGuide》的1.3(P13)的 PIO*/
status = "okay"; /*状态为okay，表示此GPIO组可用*/
};
gpio1: gpio@638 {
status = "okay";
};
gpio2: gpio@660 {
status = "okay";
};
gpio3: gpio@688 {
status = "okay";
};
spi@b00 {/*相对于palmbus的偏移，即0x1000,0b00，见《MT7620_ProgrammingGuide》的1.3(P13)的 SPI*/
status = "okay";
m25p80@0 {/*相对于SPI的偏移*/
#address-cells = <1>;
#size-cells = <1>;
compatible = "en25q64";
reg = <0 0>; /*mtd中的偏移量和大小*/
linux,modalias = "m25p80", "en25q64";
spi-max-frequency = <10000000>; /*Maximum SPI clocking speed of device in Hz；原来值是1000000，比驱动要求的值小；会导致Flash加载失败*/
/*如下分区只针对 8M 大小；当bootloader中没有设定分区定义时，内核就据此来划分Flash分区了*/
partition@0 {
label = "u-boot"; /*此分区的标识，会体现在 /proc/mtd文件中*/
reg = <0x0 0x30000>; /*此分区的偏移量和大小*/
read-only; /*表示此分区只读*/
};
partition@30000 {
label = "u-boot-env";
reg = <0x30000 0x10000>;
read-only;
};
factory: partition@40000 {
label = "factory";
reg = <0x40000 0x10000>;
read-only;
};
kernel: partition@50000 {
label = "kernel";
reg = <0x50000 0x190000>;
};
rootfs: partition@1E0000 {
label = "rootfs";
reg = <0x1E0000 0x620000>;
};
partition{
label = "firmware";
reg = <0x50000 0x7b0000>; /*这是kernel+rootfs的合计*/
};
};
};
};
pinctrl { /*描述pin控制逻辑*/
state_default: pinctrl0 {
/*ralink,group和ralink,function，用于mt7620.c中的识别处理；定义PIN节点："ephy", "i2c", "uartf", "wled","spi refclk",也可以用于GPIO控制*/
gpio {
ralink,group = "ephy", "i2c", "uartf", "wled", "spi refclk";
ralink,function = "gpio";
};
};
};
ethernet@10100000 {
status = "okay";
pinctrl-names = "default";
mtd-mac-address = <&factory 0x28>; /*在分区"factory"的偏移位置0x28,对应LAN侧的MAC地址*/
ralink,port-map = "llllw"; /*ralink,port-map，对应 mt7530.c中的mt7530_find_mapping 识别处理；这里表示port0到port3是lan;port4是wan*/
};
sdhci@10130000 {
status = "okay";
};
pcie@10140000 {
status = "okay";
};
gpio-keys-polled {
compatible = "gpio-keys-polled"; /*用于在gpio-button-hotplug中的识别*/
#address-cells = <1>;
#size-cells = <0>;
poll-interval = <20>; /*用于在gpio-button-hotplug中的轮训间隔设置；单位是ms*/
reset {/*特别定义reset按键*/
label = "reset";
gpios = <&gpio0 13 1>; /*reset按键的GPIO编号*/
linux,code = <0x198>; /*当按下reset按键后，向内核发出的code；这些code，用于input_event上报的code代码，具体含义见input.h:比如这里的0x198就对应KEY_RESTART；而在gpio-button-hotplug.c中，有BH_MAP(KEY_RESTART, "reset"),*/
};
};
wmac@10180000 {
ralink,mtd-eeprom = <&factory 0>; /*wifi的K值的读取起始位置*/
mtd-mac-address = <&factory 0x4>; /*wifi的MAC地址，读取起始位置*/
};
/*如下定义led灯控*/
gpio-leds {
compatible = "gpio-leds";
wan {
label = "w856n:blue:wan"; /*led灯的标识，会体现在/sys/class/leds目录中*/
gpios = <&gpio2 4 1>; /*led灯对应的gpio编号;表示是gpio2组中的第4个GPIO;这里的wan对应路由器面板外壳上的丝印*/
};
lan4 {
label = "w856n:blue:lan4";
gpios = <&gpio2 0 1>;
};
lan3 {
label = "w856n:blue:lan3";
gpios = <&gpio2 1 1>;
};
lan2 {
label = "w856n:blue:lan2";
gpios = <&gpio2 2 1>;
};
lan1 {
label = "w856n:blue:lan1";
gpios = <&gpio2 3 1>;
};
wlan {
label = "w856n:blue:wlan";
gpios = <&gpio3 0 1>;
};
wps {
label = "w856n:blue:wps";
gpios = <&gpio1 15 1>;
};
};
};