還是按照S5PV210的學習順序來，我們首先解決按鍵問題。TQ335x有六個使用者按鍵，分別是上、下、左、右、Enter和ESC。開始我想到的是跟學習S5PV210時一樣，編寫輸入子系統驅動解決按鍵問題，但是瀏覽driver/input/keyboard目錄時意外的發現了gpio-keys.c，大體上看下該驅動程式，其功能是實現了通用的gpio按鍵。再去看了下DTS，發現DTS中有對gpio-keys的引用，於是猜到，新的核心不需要自己編寫輸入子系統驅動，可以通過配置DTS直接解決按鍵問題。本人最終通過實驗證實了這個猜想，下面是實驗筆記及本人的一些理解。

（1）確定GPIO管腳

通過檢視TQ335x的原理圖可以看到，TQ335x的6個按鍵分別接在GPIO1的20~25管腳上，原理圖如下：

（2）檢視原有的dts配置

進行DTS檔案修改之前可以閱讀下核心相關文件，在Documentation/devicetree/目錄下有很多關於devicetree的記載，其實，這些第一手的資料才是最具參考價值的資料。我還沒來得及系統的閱讀這些文件，急於實現功能，僅閱讀了gpio-key和pinmux相關的部分就開始了修改工作，這是浮躁的表現，大家不要養成這種惡習啊！

通過仔細閱讀原dts檔案可以發現am335x-evm開發板上有個gpio矩陣鍵盤和gpio的音量+、音量-鍵，且矩陣鍵盤和音量鍵與TQ335x的按鍵管腳有衝突，因此，刪除這兩組配置並重新新增適應TQ335x按鍵的配置。修改後的DTS程式碼片段如下：

gpio_keypad: [email protected]{
    compatible = "gpio-keys";
    #address-cells = <1>;
    #size-cells = <0>;
    autorepeat;

    [email protected] {
        label = "up";
        linux,code = <103>;
        gpios = <&gpio1 20 GPIO_ACTIVE_LOW>;
        gpio-key,wakeup;
    };

    
 
[email protected] {
        label = "down";
        linux,code = <108>;
        gpios = <&gpio1 21 GPIO_ACTIVE_LOW>;
        gpio-key,wakeup;
    };

    [email protected] {
        label = "left";
        linux,code = <105>;
        gpios = <&gpio1 22 GPIO_ACTIVE_LOW>;
        gpio-key,wakeup;
    };

    [email protected] {
        label = "right";
        linux,code = <106>;
        gpios = <&gpio1 23 GPIO_ACTIVE_LOW>;
        gpio-key,wakeup;
    };

    [email protected] {
        label = "enter";
        linux,code = <28>;
        gpios = <&gpio1 24 GPIO_ACTIVE_LOW>;
        gpio-key,wakeup;
    };

    [email protected] {
        label = "esc";
        linux,code = <1>;
        gpios = <&gpio1 25 GPIO_ACTIVE_LOW>;
        gpio-key,wakeup;
    };
};

其中，linux,code後面對應的是linux標準的鍵值，可以在linux系統中找到，路徑是：/usr/include/linux/input.h。

由於這六個按鍵使用的是gpio管腳，還需要通過後面的pinmux配置下gpio相關暫存器。同樣的，刪除gpio矩陣鍵盤和音量鍵相關的配置，新增使用TQ335x的配置，修改後的程式碼片段如下：

&am33xx_pinmux {
pinctrl-names = "default";
pinctrl-0 = <&clkout2_pin>;

gpio_key_pins: gpio_keys_s0 {
    pinctrl-single,pins = <
        0x50 (PIN_INPUT_PULLUP | MUX_MODE7) /* gpmc_a3.gpio1_20 */
        0x54 (PIN_INPUT_PULLUP | MUX_MODE7) /* gpmc_a5.gpio1_21 */
        0x58 (PIN_INPUT_PULLUP | MUX_MODE7) /* gpmc_a6.gpio1_22 */
        0x5C (PIN_INPUT_PULLUP | MUX_MODE7) /* gpmc_a7.gpio1_23 */
        0x60 (PIN_INPUT_PULLUP | MUX_MODE7) /* gpmc_a8.gpio1_24 */
        0x64 (PIN_INPUT_PULLUP | MUX_MODE7) /* gpmc_a9.gpio1_25 */
    >;
};

i2c0_pins: pinmux_i2c0_pins {
    pinctrl-single,pins = <
        0x188 (PIN_INPUT_PULLUP | MUX_MODE0)    /* i2c0_sda.i2c0_sda */
        0x18c (PIN_INPUT_PULLUP | MUX_MODE0)    /* i2c0_scl.i2c0_scl */
    >;
};

需要注意的是，pinctrl-0後與矩陣鍵盤和音量鍵相關的配置項名稱也要刪除，對於phandler，目前還沒有看懂什麼意思，這裡先讓按鍵功能正常，之後再去詳細的研究dts。學習dts的時候也會來寫筆記的。

（3）重新編譯dts

與之前編譯dts的方法一樣：

make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- tq335x.dtb

（4）用新的dtb啟動核心

將新的tq335x.dtb拷貝到SD卡的boot目錄下（可以直接覆蓋掉原來的）並給開發板上電，同時按任意鍵使u-boot進入命令列模式，使用命令啟動核心：

load mmc 0 ${fdtaddr} /boot/tq335x.dtb
load mmc 0 ${loadaddr} /boot/zImage
load mmc 0 ${rdaddr} /boot/ramdisk.img
bootz ${loadaddr} ${rdaddr} ${fdtaddr}

（5）測試按鍵

從終端上無法直接看到按鍵效果，不過可以同hexdump命令來測試按鍵功能是否正常，使用方法如下：

hexdump /dev/input/event0

由於gpio-keys驅動將按鍵事件對映到了/dev/input/event0裝置節點上，因此，對該裝置節點使用hexdump工具可以讀取到按鍵事件。執行上述指令後按鍵，可以從終端上看到輸出。我按照上、下、左、右、Enter和ESC的順序短按這六個鍵，可以看到如下Log：

@tq335x #hexdump /dev/input/event0 
0000000 4b7c 386d f9b4 0005 0001 0067 0001 0000
0000010 4b7c 386d f9b4 0005 0000 0000 0000 0000
0000020 4b7c 386d 80c4 0008 0001 0067 0000 0000
0000030 4b7c 386d 80c4 0008 0000 0000 0000 0000
0000040 4b7d 386d 09f8 0008 0001 006c 0001 0000
0000050 4b7d 386d 09f8 0008 0000 0000 0000 0000
0000060 4b7d 386d 1005 000a 0001 006c 0000 0000
0000070 4b7d 386d 1005 000a 0000 0000 0000 0000
0000080 4b7f 386d 1304 000d 0001 0069 0001 0000
0000090 4b7f 386d 1304 000d 0000 0000 0000 0000
00000a0 4b80 386d 48e6 0000 0001 0069 0000 0000
00000b0 4b80 386d 48e6 0000 0000 0000 0000 0000
00000c0 4b80 386d f340 000a 0001 006a 0001 0000
00000d0 4b80 386d f340 000a 0000 0000 0000 0000
00000e0 4b80 386d cd6f 000c 0001 006a 0000 0000
00000f0 4b80 386d cd6f 000c 0000 0000 0000 0000
0000100 4b81 386d a2d7 0007 0001 001c 0001 0000
0000110 4b81 386d a2d7 0007 0000 0000 0000 0000
0000120 4b81 386d b39d 0009 0001 001c 0000 0000
0000130 4b81 386d b39d 0009 0000 0000 0000 0000
0000140 4b82 386d 5aa3 0002 0001 0001 0001 0000
0000150 4b82 386d 5aa3 0002 0000 0000 0000 0000
0000160 4b82 386d 4bf3 0004 0001 0001 0000 0000
0000170 4b82 386d 4bf3 0004 0000 0000 0000 0000

通過hexdump工具看到的數字是16進位制的。由於linux的input_event事件定義如下：

struct input_event {
    struct timeval time;
    __u16 type;
    __u16 code;
    __s32 value;
};

結合之前設定的linux,code分析可知，hexdump列印的各列資料含義如下：

第一列：行號

第2~5列：輸入事件時間戳，即結構體中的time。

第6列：輸入事件型別，即結構體中的type。

第7列：按鍵的鍵值，即結構體中的code。

第8列：按鍵的狀態，即結構體中的value，1表示按下，0表示鬆開。

細心的朋友會發現，按下並鬆開一個按鍵後能看到四行資料，這是由於每個input_event後會接一個linux同步事件，從上述log可以看到，同步事件的type，code，value都為0。

到這裡，就完成了TQ335x的按鍵驅動移植。雖然過程很簡單，但已經體會到了DTS的好處。對於一些通用的功能，可以不修改核心原始碼、不重新編譯核心，僅修改dts配置就能實現所需的功能，如這裡的gpio按鍵功能。dts方式啟動核心有著巨大的優勢，必須弄清DTS的編寫規則，以後會記錄DTS相關的筆記的。

本文作者：girlkoo