Tina Linux Key 快速配置使用指南

1 前言

1.1 文檔簡介

本文介紹Tina 平臺key 相關的快速配置和使用方法。

1.2 目標讀者

Allwinner key 驅動驅動層/應用層的使用/開發/維護人員。

1.3 適用范圍

?

表1-1: 適用產品列表

?

產品名稱	內核版本	平臺架構
R18	Linux-4.4	cortex-a53(64 位)
R30	Linux-4.4	cortex-a53(64 位)
R328	Linux-4.9	cortex-a7(32 位)
R329	Linux-4.9	cortex-a53(64 位)
R818	Linux-4.9	cortex-a53(64 位)
R818B	Linux-4.9	cortex-a53(64 位)
MR813	Linux-4.9	cortex-a53(64 位)
MR813B	Linux-4.9	cortex-a53(64 位)
R528	Linux-5.4	cortex-a7(32 位)
D1	Linux-5.4	risc-v(64 位)
H133	Linux-5.4	cortex-a7(32 位)

2 模塊介紹

2.1 Key 配置

Allwinner 平臺支持三種不同類型的Key：GPIO-Key，ADC-Key，AXP-Key。其中，GPIOKey又包括普通的gpio 按鍵和矩陣鍵盤。

按鍵相關配置根據平臺不同內核會有部分差異，下面作詳細介紹。

說明

若板子上沒有使用我司的帶有按鍵功能的PMU，則就沒有對應的AXP 按鍵。

2.2 相關術語介紹

2.2.1 軟件術語

?

表2-1: Key 軟件術語列表

?

術語	解釋說明
Key	按鍵
GPIO-Key	使用GPIO 檢測按鍵的設備
ADC	模數轉換器
ADC-Key	通過ADC 讀取電壓檢測按鍵的設備
LRADC	精度為6 位的單通道ADC
GPADC	精度為12 位的多通道ADC
PMU	電源管理單元
AXP-Key	連接在電源芯片的按鍵

3 GPIO-Key

3.1 4.4 以及4.9 內核

4.4 以及4.9 內核的按鍵相關配置是一樣的。涉及到的驅動文件位于如下位置：

其中，64 位平臺和32 位平臺的dts 文件位置是不一樣的。

lichee/linux-*/arch/arm/boot/dts/平臺代號.dtsi //32位平臺的dts文件位置

lichee/linux-*/arch/arm64/boot/dts/sunxi/平臺代號.dtsi //64位平臺的dts文件位置

其中drivers/input/keyboard/目錄下的相關文件為驅動文件，而平臺名稱.dtsi 為設備樹文件,例如R328 的dts 文件sun8iw18p1.dtsi，下面以R328 為例進行說明。

支持interrupt-key,poll-key 驅動文件如下:

lichee/linux-*/drivers/input/keyboard/gpio-keys-polled.c //gpio poll key

lichee/linux-*/drivers/input/keyboard/gpio-keys.c //interrupt key

R328 的dts 文件：

lichee/linux-4.9/arch/arm/boot/dts/sun8iw18p1.dtsi

配置這種類型的gpio-key 時，請先查詢，當前的gpio 是否可以用作中斷功能，如果該引腳可以用作中斷功能，則采用interrupt 觸發方式獲取按鍵信息，若不能用

作中斷功能，則只能采用輪詢的方式查詢按鍵的狀態信息。

GOIO-Key 的硬件配置圖參考下圖所示：

?

圖3-1: GPIO-Key 配置圖

?

3.1.1 普通GPIO 采用poll 方式

修改設備樹文件

根據原理圖arch/arm/boot/dts/sun8iw18p1.dtsi 文件中添加對應的gpio。例如音量加減鍵分別用到PH5,PH6 這兩個GPIO，則修改方法如下：

gpio-keys {

compatible = "gpio-keys";

status = "okay";

vol-down-key {

gpios = <&pio PH 5 1 2 2 1>;

linux,code = <114>;

label = "volume down";

debounce-interval = <10>;

wakeup-source = <0x1>;

};

vol-up-key {

gpios = <&pio PH 6 1 2 2 1>;

linux,code = <115>;

label = "volume up";

debounce-interval = <10>;

};

};

? compatible：用于匹配驅動。 ? status：是否加載設備。 ? vol-down-key：每一個按鍵都是單獨的一份配置，需要分別區分開來。 ? gpios：GPIO 口配置。 ? linux,code：這個按鍵對應的input 鍵值。 ? label：單個按鍵對應的標簽。 ? debounce-interval：消抖時間，單位為us。 ? wakeup-source：是否作為喚醒源，配置了這個項的按鍵可以作為喚醒源喚醒系統。

確認驅動是否被選中

確認gpio_keys_polled.c 是否編譯進系統，在tina 目錄下執行make kernel_menuconfig，需要將Polled GPIO buttons 選成“[*]”。

Device Drivers

└─>Input device support

└─>Keyboards

└─>Polled GPIO buttons

?

圖3-2: linux4.4/4.9 輪詢按鍵配置圖

?

3.1.2 普通GPIO 采用中斷方式

跟采用poll 方式一樣，也需要完成如下步驟：

修改設備樹文件 可見普通gpio 采用poll 方式，不一樣的是這里gpio 采用中斷的方式。

gpio-keys {

compatible = "gpio-keys";

status = "okay";

vol-down-key {

gpios = <&pio PH 5 6 2 2 1>;

linux,code = <114>;

label = "volume down";

debounce-interval = <10>;

wakeup-source = <0x1>;

};

vol-up-key {

gpios = <&pio PH 6 6 2 2 1>;

linux,code = <115>;

label = "volume up";

debounce-interval = <10>;

};

};

? compatible：用于匹配驅動。

? status：是否加載設備。

? vol-down-key：每一個按鍵都是單獨的一份配置，需要分別區分開來。

? gpios：GPIO 口配置。

? linux,code：這個按鍵對應的input 鍵值。

? label：單個按鍵對應的標簽。

? debounce-interval：消抖時間，單位為us。

? wakeup-source：是否作為喚醒源，配置了這個項的按鍵可以作為喚醒源喚醒系統。

確認驅動是否被選中 在tina 目錄下執行make kernel_menuconfig，確保GPIO Buttons 被選上。

Device Drivers

└─>Input device support

└─>Keyboards

└─>GPIO Buttons

?

圖3-3: linux4.4/4.9 中斷按鍵配置圖

?

3.2 5.4 內核

Linux-5.4 內核相對4.4/4.9 來說，GPIO 子系統有所變化，因此dts 的配置也不大一樣。

dts 文件位置：

lichee/linux-5.4/arch/arm/boot/dts/平臺代號.dtsi //32位平臺的dts文件位置

lichee/linux-5.4/arch/riscv/boot/dts/sunxi/平臺代號.dtsi //risc-v架構平臺的dts文件位置

其中drivers/input/keyboard/目錄下的相關文件為驅動文件。

支持interrupt-key,poll-key 驅動文件如下:

lichee/linux-5.4/drivers/input/keyboard/gpio-keys-polled.c //gpio poll key lichee/linux-5.4/drivers/input/keyboard/gpio-keys.c //interrupt key

3.2.1 普通GPIO 采用poll 方式

修改設備樹文件

gpio-keys { compatible = "gpio-keys"; status = "okay"; vol-down-key { gpios = <&pio PH 5 GPIO_ACTIVE_LOW>; linux,code = <114>; label = "volume down"; debounce-interval = <10>; wakeup-source = <0x1>; }; vol-up-key { gpios = <&pio PH 6 GPIO_ACTIVE_LOW>; linux,code = <115>; label = "volume up"; debounce-interval = <10>; }; };

? compatible：用于匹配驅動。 ? status：是否加載設備。 ? vol-down-key：每一個按鍵都是單獨的一份配置，需要分別區分開來。 ? gpios：GPIO 口配置。 ? linux,code：這個按鍵對應的input 鍵值。 ? label：單個按鍵對應的標簽。 ? debounce-interval：消抖時間，單位為us。 ? wakeup-source：是否作為喚醒源，配置了這個項的按鍵可以作為喚醒源喚醒系統。

與4.4/4.9 相比，主要是gpios 配置方式變化了。

選上驅動 GPIO-Key 輪詢驅動kernel_menuconfig 路徑：

Device Drivers └─>Input device support └─>Keyboards └─>Polled GPIO buttons

3.2.2 普通GPIO 采用中斷方式

修改設備樹文件

gpio-keys { compatible = "gpio-keys"; status = "okay"; vol-down-key { gpios = <&pio PH 5 GPIO_ACTIVE_LOW>; linux,code = <114>; label = "volume down"; debounce-interval = <10>; wakeup-source = <0x1>; }; vol-up-key { gpios = <&pio PH 6 GPIO_ACTIVE_LOW>; linux,code = <115>; label = "volume up"; debounce-interval = <10>; }; };

? compatible：用于匹配驅動。 ? status：是否加載設備。 ? vol-down-key：每一個按鍵都是單獨的一份配置，需要分別區分開來。 ? gpios：GPIO 口配置。 ? linux,code：這個按鍵對應的input 鍵值。 ? label：單個按鍵對應的標簽。 ? debounce-interval：消抖時間，單位為us。 ? wakeup-source：是否作為喚醒源，配置了這個項的按鍵可以作為喚醒源喚醒系統。

選上驅動 GPIO-Key 中斷驅動kernel_menuconfig 路徑：

Device Drivers └─>Input device support └─>Keyboards └─>GPIO Button

3.2.3 矩陣鍵盤 當需要使用大量按鍵的時候，如果單獨給每一個按鍵配一個GPIO 的話，那GPIO 是遠遠不夠的。這時，可以使用矩陣鍵盤的方式，使用N 個GPIO，就可以最大支持N*N 個按鍵。矩陣按鍵的硬件原理圖如下所示：

?

圖3-4: 矩陣按鍵硬件原理圖

?

警告 矩陣鍵盤的GPIO 建議使用SOC 自帶的IO 口，不使用擴展IO 芯片的IO 口。因為矩陣鍵盤掃描按鍵的時間比較短，而擴展IO 芯片的IO 是通過I2C/UART 等等的總線去修改IO 狀態的，修改一次狀態時間比較長，可能會導致矩陣按鍵掃描按鍵檢測失敗的。

這里以R528 為示例，dts 為：

lichee/linux-5.4/arch/arm/boot/dts/sun8iw20p1.dtsi

驅動文件為：

lichee/linux-5.4/drivers/input/keyboard/matrix_keypad.c

修改設備樹文件 根據R528 原理圖來添加對應行和列的gpio，分別寫在row-gpios 和col-gpios，詳細設備樹文件為：

matrix_keypad:matrix-keypad { compatible = "gpio-matrix-keypad"; keypad,num-rows = <6>; keypad,num-columns = <7>; row-gpios = <&pio PG 17 GPIO_ACTIVE_LOW ? ? ? ?&pio PG 18 GPIO_ACTIVE_LOW ? ? ? ?&pio PG 1 GPIO_ACTIVE_LOW ? ? ? ?&pio PG 2 GPIO_ACTIVE_LOW ? ? ? ?&pio PG 3 GPIO_ACTIVE_LOW ? ? ? ?&pio PG 4 GPIO_ACTIVE_LOW>; col-gpios = <&pio PG 0 GPIO_ACTIVE_LOW ? ? ? ?&pio PG 5 GPIO_ACTIVE_LOW ? ? ? ?&pio PG 12 GPIO_ACTIVE_LOW ? ? ? ?&pio PG 14 GPIO_ACTIVE_LOW ? ? ? ?&pio PG 6 GPIO_ACTIVE_LOW ? ? ? ?&pio PG 8 GPIO_ACTIVE_LOW ? ? ? ?&pio PG 10 GPIO_ACTIVE_LOW>; linux,keymap = < ? ? ? ?0x00000001 //row 0 col0 ? ? ? ?0x00010002 ? ? ? ?0x00020003 ? ? ? ?0x00030004 ? ? ? ?0x00040005 ? ? ? ?0x00050006 ? ? ? ?0x00060007 ? ? ? ?0x01000008 //row 1 col0 ? ? ? ?0x01010009 ? ? ? ?0x0102000a ? ? ? ?0x0103000b ? ? ? ?0x0104000c ? ? ? ?0x0105000d ? ? ? ?0x0106000e ? ? ? ?0x0200000f //row 2 col0 ? ? ? ?0x02010010 ? ? ? ?0x02020011 ? ? ? ?0x02030012 ? ? ? ?0x02040013 ? ? ? ?0x02050014 ? ? ? ?0x02060015 ? ? ? ?0x03000016 //row 3 col0 ? ? ? ?0x03010017 ? ? ? ?0x03020018 ? ? ? ?0x03030019 ? ? ? ?0x0304001a ? ? ? ?0x0305001b ? ? ? ?0x0306001c ? ? ? ?0x0400001d //row 4 col0 ? ? ? ?0x0401001e ? ? ? ?0x0402001f ? ? ? ?0x04030020 ? ? ? ?0x04040021 ? ? ? ?0x04050022 ? ? ? ?0x04060023 ? ? ? ?0x05000024 //row 5 col0 ? ? ? ?0x05010025 ? ? ? ?0x05020026 ? ? ? ?0x05030027 ? ? ? ?0x05040028 ? ? ? ?0x05050029 ? ? ? ?0x0506002a ? ?>; gpio-activelow; debounce-delay-ms = <20>; col-scan-delay-us = <20>; linux,no-autorepeat; status = "okay"; };

設備樹文件參數描述如下： ? keypad,num-rows：行數 ? keypad,num-columns：列數 ? row-gpios：行對應的gpio 口，從第一行開始 ? col-gpios：列對應的gpio 口，從第一列開始 ? linux,keymap：每一個按鍵對應的鍵值 ? gpio-activelow：按鍵按下時，行線是否為低電平。用于觸發中斷，必須配置。 ? debounce-delay-ms：消抖時間。 ? col-scan-delay-us：掃描延時，如果IO 狀態轉換時間過長可能會導致按鍵掃描錯誤。 ? linux,no-autorepeat：按鍵按下時是否重復提交按鍵, 設1 就是不重復, 設0 重復。

確認驅動是否被選中在tina 目錄下執行運行make kernel_menuconfig，確認以下配置：

Device Drivers └─>Input device support └─>Keyboards └─>GPIO driven matrix keypad support

?

圖3-5: 矩陣鍵盤配置圖

?

4 ADC-Key

ADC-Key 一共有兩種adc 檢測方式，分別是LRADC 和GPADC。LRADC 分辨率為6 位，GPADC 分辨率為12 位，因此后者精度會更高。

下面將分別講述兩種不同的方式。

4.1 4.4 以及4.9 內核

4.1.1 LRADC-Key

LRADC-Key 有如下特性：

1.Support voltage input range between 0 to 2V。 2.Support sample rate up to 250Hz，可以配置為32Hz,62Hz,125Hz,250Hz,R328 sdk中默認配置為250Hz。

3.當前lradc key 最大可以支持到13 個按鍵(0.15V 為一個檔)，通常情況下，建議lradc key最大不要超過8 個(0.2V 為一檔)，否則由于采樣誤差、精度等因素存在，

會很容易出現誤判的情況。

如下圖所示,lradc-key 檢測原理是當有按鍵被按下或者抬起時，LRADC 控制器(6bit) 檢測到電壓變化后，經過LRADC 內部的邏輯控制單元進行比較運算后，產生相

應的中斷給CPU, 同時電壓的變化值會通過LRADC 內部的data register 的值(0~0x3f) 來體現。

?

圖4-1: LRADC 按鍵原理圖

?

下面以R328 為例進行說明，驅動文件：

linux-4.9/drivers/input/keyboard/sunxi-keyboard.c linux-4.9/arch/arm/boot/dts/sun8iw18p1.dtsi

如果使用adc-key , 請先確保softwinner KEY BOARD support 有被選擇上。

Device Drivers └─>Input device support └─>Keyboards └─>softwinnner KEY BOARD support

?

圖4-2: linux4.4/4.9 LRADC 按鍵配置圖

?

在lradc-key 驅動中涉及兩個重要的結構體

static unsigned char keypad_mapindex[64] = { 0,0,0,0,0,0,0, /* key 1, 0-7 */ 1,1,1,1,1,1, /* key 2, 8-14 */ 2,2,2,2,2,2, /* key 3, 15-21 */ 3,3,3,3,3, /* key 4, 22-27 */ 4,4,4,4,4, /* key 5, 28-33 */ 5,5,5,5,5, /* key 6, 34-39 */ 6,6,6,6,6,6,6,6,6, /* key 7, 40-49 */ 7,7,7,7,7,7,7,7,7,7,7,7,7 /* key 8, 50-63 */ }; static unsigned int sunxi_scankeycodes[KEY_MAX_CNT] = { [0 ] = KEY_VOLUMEUP, [1 ] = KEY_VOLUMEDOWN, [2 ] = KEY_HOME, [3 ] = KEY_ENTER, [4 ] = KEY_MENU, [5 ] = KEY_RESERVED, [6 ] = KEY_RESERVED, [7 ] = KEY_RESERVED, [8 ] = KEY_RESERVED, [9 ] = KEY_RESERVED, [10] = KEY_RESERVED, [11] = KEY_RESERVED, [12] = KEY_RESERVED, };

keypad_mapindex[] 數組的值跟LRADC_DATA0(0x0C) 的值是對應的，表示的具體意義是：key_val(lradc_data0 寄存器的值) 在0~7 范圍內時，表示的是操作

key1，依此類推，key_val為8~14 的范圍之內時，表示的操作key2。正常來說，按照R16 推薦的硬件設計，該數組內無需任何更改，當個別情況下，如遇到adc-

key input 上報的keycode 有異常時，需要依次按下每個按鍵同時讀取key_val 的值來修正keypad_mapindex[]。

sunxi_scankeycodes[]: 該數組的意義為sunxi_scankeycodes[*] 標示的是具體的某一個key，用戶可以修改其中的keycode。

例如，key_val 等于25, 則根據keypad_mapindex 得到scancode 為4, 再由sunxi_scankeycodes得到鍵值為KEY_MENU。

keypad_mapindex 這個數組可以通過sys_config 進行配置：

[key_para] key_used = 1 key_cnt = 5 key1_vol = 300 key2_vol = 600 key3_vol = 1000 key4_vol = 1500 key5_vol = 1800

這個配置下轉換得到的keypad_mapindex 數組是：

static unsigned char keypad_mapindex[64] = { 0,0,0,0,0,0,0,0,0,0 /* key 1, 0-9 */ 1,1,1,1,1,1,1,1,1,1, /* key 2, 10-19 */ 2,2,2,2,2,2,2,2,2,2,2,2,2, /* key 3, 20-32 */ 3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3, /* key 4, 33-48 */ 4,4,4,4,4,4,4,4,4,4, /* key 5, 49-58 */ 5,5,5,5,5, /* key 6, 59-63 */ };

設備樹文件sun8iw18p1.dtsi

keyboard0:keyboard{ compatible = "allwinner,keyboard_1350mv"; reg = <0x0 0x05070800 0x0 0x400>; interrupts = ; status = "okay"; key_cnt = <5>; key0 = <164 115>; key1 = <415 114>; key2 = <646 139>; key3 = <900 28>; key4 = <1157 102>; wakeup-source; };

? compatible：匹配驅動。

? reg：LRADC 模塊的基地址。

? interrupts：LRADC 中斷源。

? status：是否加載驅動。

? key_cnt：按鍵數量。

? key0：第一個按鍵，前面數字的是電壓范圍，后者是input 系統的鍵值。

? wakeup-source：LRADC 作為喚醒源。

驅動初始化時，會讀取設備樹中相關屬性，其中key_cnt 表示配置的按鍵個數，keyX 配置對應的ADC 值以及鍵值。根據這些屬性，會重新設置keypad_mapindex

數組，以及sunxi_scankeycodes 數組。

keypad_mapindex[] 數組的值跟ADC 值是對應的, 6bitADC, 范圍0~63，表示的具體意義是：key_val 在0~190 范圍內時，表示的是操作key0, 以此類推，key_val

為191~390 范圍內時，表示的是操作key1。

sunxi_scankeycodes[]: 該數組的意義為sunxi_scankeycodes[*] 表示的是具體的某一個key，用戶可以修改設備樹來改變keycode。

例如，默認配置下，key_val 等于300, 則根據keypad_mapindex 得到scancode 為1, 再由sunxi_scankeycodes 得到鍵值114。

4.1.2 GPADC-Key

GPADC 有多個通道，例如在R328S3 中有4 個通道。

通道有三種工作模式：

一、是在指定的通道完成一次轉換，轉換數據更新在對應通道的數據寄存器中；

二、在所有指定的通道連續轉換直到軟件停止，轉換數據更新在對應通道的數據寄存器中；

三、可以在指定的通道進行adc 的采樣和轉換，并將結果順序地存入FIFO，FIFO 深度為64 并支持中斷控制。

檢測原理是當按鍵被按下或抬起時，指定的通道的控制器檢測到電壓變化，然后經過邏輯控制單元進行比較運算后，產生相應的中斷給CPU。R328S3 的GPADC

的框圖如下圖所示。

?

圖4-3: GPADC 按鍵硬件圖

?

以R328S3 為例，驅動文件：

linux-4.9/drivers/input/sensor/sunxi_gpadc.c linux-4.9/drivers/input/sensor/sunxi_gpadc.h

如果使用gpadc-key，請先確保SENSORS_GPADC 有被選上。

Device Drivers └─>Device Drivers └─>Input device support └─>Sensors └─>SUNXI GPADC

?

圖4-4: linux4.4/4.9 GPADC 按鍵配置圖

?

在gpadc 中與lradc 一樣涉及兩個重要的結構體

static unsigned char keypad_mapindex[128] = { 0, 0, 0, 0, 0, 0, 0, 0, 0, /* key 1, 0-8 */ 1, 1, 1, 1, 1, /* key 2, 9-13 */ 2, 2, 2, 2, 2, 2, /* key 3, 14-19 */ 3, 3, 3, 3, 3, 3, /* key 4, 20-25 */ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, /* key 5, 26-36 */ 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, /* key 6, 37-39 */ 6, 6, 6, 6, 6, 6, 6, 6, 6, /* key 7, 40-49 */ 7, 7, 7, 7, 7, 7, 7 /* key 8, 50-63 */ }; u32 scankeycodes[KEY_MAX_CNT];

keypad_mapindex[] 數組的定義與LRADC 的相似，但是要注意的是，GPADC 的數組大小為128，而LRADC 的是64，所以說GPADC 的精度更高。在linux4.9 內核

中已經不在數組里配置了，程序中該數組只是初始化的。后面會根據sys_config 或者dts 的配置來生成所要使用的keypad_mapindex[]。

設備樹文件這里示例的是R328S3 的方案級設備樹文件：

lichee/linux-4.9/arch/arm/boot/dts/sun8iw18p1.dtsi

詳細GPADC 配置如下：

gpadc:gpadc{ compatible = "allwinner,sunxi-gpadc"; reg = <0x0 0x05070000 0x0 0x400>; interrupts = ; clocks = <&clk_gpadc>; status = "disable"; };

? compatible：匹配驅動。 ? reg：GPADC 寄存器基地址。 ? interrupts：GPADC 中斷源。 ? clocks：GPADC 依賴的時鐘。 ? status：是否加載設備。

4.sys_config.fex 文件

[gpadc] gpadc_used = 1 channel_num = 1 channel_select = 0x01 channel_data_select = 0 channel_compare_select = 0x01 channel_cld_select = 0x01 channel_chd_select = 0 channel0_compare_lowdata = 1700000 channel0_compare_higdata = 1200000 key_cnt = 4 key0_vol = 164 key0_val = 115 key1_vol = 415 key1_val = 114 key2_vol = 700 key2_val = 139 key3_vol = 1000 key3_val = 28

在sys_config 中，配置含義如下：

? channel_num：表示平臺上支持的最大通道數； ? channel_select：表示通道啟用設置，通道0:0x01 通道1:0x02 通道2:0x04 通道3:0x08； ? channel_data_select：表示通道數據啟用，通道0:0x01 通道1:0x02 通道2:0x04 通道3:0x08； ? channel_compare_select；表示比較功能啟用，通道寫法跟前面一致； ? channel0_compare_lowdata：表示的低于該電壓可以產生中斷，這里是1.7V； ? channel0_compare_higdata：則是高于該電壓可以產生中斷，這里是1.2V； ? key_cnt：表示的是按鍵個數； ? key_vol：表示第 個按鍵的電壓值； ? key_val：表示的是第 個按鍵的鍵值。

在軟件上，當key_vol 在0~164 范圍時，表示的是操作key0，以此類推；在硬件上，164 表示的是164mV，通過計算keyn_vol = keyn_vol + ( key(n+1)_vol -

keyn_vol) / 2來得到范圍。比如說第一個范圍為key0_vol = 164 + (415 - 164) / 2 = 289.5，即電壓在0~289.5 在，adc 檢測到為操作的key0，以此類推。然后通過

scankeycodes 得到鍵值115。

5.board.dts 文件

方案級設備樹文件只寫這個模塊的配置，而詳細的按鍵配置一般需要寫在板級的board.dts 中。

/* resistance gpadc configuration channel_num: Maxinum number of channels supported on the platform. channel_select: channel enable setection. channel0:0x01 channel1:0x02 channel2:0x04 channel3:0x08 channel_data_select: channel data enable. channel0:0x01 channel1:0x02 channel2:0x04 channel3:0x08. channel_compare_select: compare function enable channel0:0x01 channel1:0x02 channel2:0 x04 channel3:0x08. channel_cld_select: compare function low data enable setection: channel0:0x01 channel1:0 x02 channel2:0x04 channel3:0x08. channel_chd_select: compare function hig data enable setection: channel0:0x01 channel1:0 x02 channel2:0x04 channel3:0x08. */ gpadc:gpadc{ channel_num = <1>; channel_select = <0x01>; channel_data_select = <0>; channel_compare_select = <0x01>; channel_cld_select = <0x01>; channel_chd_select = <0>; channel0_compare_lowdata = <1700000>; channel0_compare_higdata = <1200000>; channel1_compare_lowdata = <460000>; channel1_compare_higdata = <1200000>; key_cnt = <5>; key0_vol = <210>; key0_val = <115>; key1_vol = <410>; key1_val = <114>; key2_vol = <590>; key2_val = <139>; key3_vol = <750>; key3_val = <28>; key4_vol = <880>; key4_val = <102>; status = "okay"; };

dts 文件參數的含義可以參考sys_config.fex 的。

4.2 5.4 內核

4.2.1 LRADC-Key

5.4 內核的LRADC 驅動功能與4.4/4.9 內核的無明顯變化，因此下面只介紹設備樹文件與配置教程。

修改設備樹文件

這里以D1 為例，設備樹文件路徑為：

lichee/linux-5.4/arch/riscv/boot/dts/sunxi/sun20iw1p1.dtsi

dtsi 一般默認已經寫好LRADC 的配置：

keyboard0: keyboard@2009800 { compatible = "allwinner,keyboard_1350mv"; reg = <0x0 0x02009800 0x0 0x400>; interrupts-extended = <&plic0 77 IRQ_TYPE_EDGE_RISING>; clocks = <&ccu CLK_BUS_LRADC>; resets = <&ccu RST_BUS_LRADC>; key_cnt = <5>; key0 = <210 115>; key1 = <410 114>; key2 = <590 139>; key3 = <750 28>; key4 = <880 172>; wakeup-source; status = "okay"; };

? compatible：匹配驅動。

? reg：LRADC 模塊的基地址。

? interrupts：LRADC 中斷源。

? status：是否加載驅動。

? key_cnt：按鍵數量。

? key0：第一個按鍵，前面數字的是電壓范圍，后者是input 系統的鍵值。

? wakeup-source：LRADC 作為喚醒源。

但是D1 方案電路板上實際LRADC 只連接了一個按鍵，此時可以通過修改board.dts 來進行配置。若實際的電路板上LRADC 按鍵是符合以上配置的，則不需要修

改。

說明 board.dts 的配置最終會覆蓋了方案的dtsi 文件配置

board.dts 配置：

&keyboard0 { key_cnt = <1>; key0 = <210 115>; status = "okay"; };

確認驅動是否被選中在tina 目錄下執行make kernel_menuconfig，確認以下配置：

Device Drivers └─>Input device support └─>Keyboards └─>softwinnner KEY BOARD support

?

圖4-5: Linux-5.4 LRADC 按鍵配置圖

?

4.2.2 GPADC-Key

5.4 內核的GPADC 設備樹配置主要是時鐘和中斷方面有所改動，board.dts 配置可參考4.9 內核。

修改設備樹文件

這里以D1 來作為示例，設備樹文件為：

lichee/linux-5.4/arch/riscv/boot/dts/sunxi/sun20iw1p1.dtsi

詳細配置為：

gpadc: gpadc@2009000 { compatible = "allwinner,sunxi-gpadc"; reg = <0x0 0x02009000 0x0 0x400>; interrupts-extended = <&plic0 73 IRQ_TYPE_LEVEL_HIGH>; clocks = <&ccu CLK_BUS_GPADC>; clock-names = "bus"; resets = <&ccu RST_BUS_GPADC>; status = "okay"; };

? compatible：匹配驅動。 ? reg：GPADC 寄存器基地址。 ? interrupts：GPADC 中斷源。 ? clocks：GPADC 依賴的時鐘。 ? status：是否加載設備。

確認驅動是否被選中 在tina 目錄下執行make kernel_menuconfig，確認以下配置：

Device Drivers └─>Input device support └─>Sensors └─>sunxi gpadc driver support

?

圖4-6: Linux-5.4 GPADC 配置圖

?

5 AXP-Key

使用AXP-Key 的話需要電路板上帶上我司提供power-key 功能的PMU，這是由PMU 識別該按鍵，并在驅動中上報相關事件，power-key 驅動源碼在電源驅動源碼

同目錄下。用戶不需要做任何更改，這部分是可以直接使用的。

這里使用R329 來作為例子，其對應的設備節點為：

?

圖5-1: AXP 按鍵節點圖

?

上報的鍵值為KEY_POWER 116

5.1 4.9 內核

修改設備樹文件這里以R329-evb1 為例，設備樹文件為board.dts，路徑：

device/config/chips/r329/configs/evb1/board.dts

詳細配置為：

&twi2{ no_suspend = <1>; status = "okay"; pmu0: pmu@34 { compatible = "x-powers,axp2585"; ............省略其他無關配置 powerkey0: powerkey@0 { status = "okay"; compatible = "x-powers,axp2585-pek"; pmu_powkey_off_time = <6000>; pmu_powkey_off_func = <0>; pmu_powkey_off_en = <1>; pmu_powkey_long_time = <1500>; pmu_powkey_on_time = <1000>; wakeup_rising; /* wakeup_falling; */ }; }; };

確認驅動是否被選中

tina 目錄下執行make kernel_menuconfig，確認以下配置：

Device Drivers └─>Input device support └─>Miscellaneous devices └─>X-Powers AXP2101 power button driver

?

圖5-2: AXPKEY 配置圖

?

警告 不同方案使用的PMU 可能會不一樣，因此AXP-KEY 的配置也會不一致，詳細查看各個方案使用的PMU 型號。

這里另外，PMU 還提供了AXP GPIO, 根據不同型號的PMU, GPIO 數量可能不一樣，但gpio number 均以1024 開始，例如AXP GPIO0 的gpio number 為1024,

AXP GPIO1 的gpio number 為1025。它們均能當做普通gpio 使用，因此按照GPIO-Key 章節的描述去操作它們即可需要注意的是，sys_config 中axp gpio 的命名

與普通gpio 有些區別，例如AXP gpio0：

port:power0<1><0><0>

5.2 5.4 內核

說明 本章節暫不介紹Linux-5.4 內核。