本文導讀：ZDP1440是一款基于開源GUI引擎的圖像顯示專用驅動芯片，可以通過串口或者SPI與其他芯片通信，但本身沒有多余的接口去外接按鈕，本文將介紹通過與其他芯片通信，實現外接旋轉按鈕的功能。

在有的產品上，通常沒有外接電阻電容觸摸，通過外接實體按鍵來控制UI；對于一些極簡的鍵盤類型，如：三鍵鍵盤、五鍵鍵盤以及旋轉按鈕，AWTK也有對應的方案支持。這類鍵盤通常通過控制焦點的移動然后觸發“確認/取消”功能，下面介紹設置流程：

1. 啟用焦點停留

?在沒有觸摸輸入時，通過按鍵切換焦點來控制UI中的控件，該控件必須啟用焦點停留功能。在AWTK中，除edit相關控件外，其余控件需指定控件的focusable屬性為true；

• 在AWTK Designer中，可以勾選focusable復選框：

勾選focusable復選框

?

2. 指定初始焦點

? ?

啟用了焦點停留后，還需指定每個頁面的初始焦點；

• 在C代碼中，可以這樣指定：

widget_set_prop_bool(widget, WIDGET_PROP_FOCUSED, TRUE);

3. 設置鍵盤類型

AWTK中將鍵盤分為三種類型：正常鍵盤、三鍵鍵盤和五鍵鍵盤；對于三鍵或五鍵鍵盤（有些變種帶有數字鍵和功能鍵也歸于此類）來說方向鍵既要用于導航（切換焦點），又要用于控件輸入數據，所以需要引入一種狀態（或稱為模式）：

• 在移動焦點的狀態：方向鍵用于切換焦點；
• 在非移動焦點的狀態：方向鍵用于修改控件的值；

回車的作用：

• 在按鈕等支持用回車鍵激活的控件上，用于激活按鈕，相當于點擊事件；
• 在編輯器等控件上，用于切換狀態，用于改變方向鍵的作用；

旋轉按鈕處理方法等同于三鍵：左旋觸發方向左鍵，右旋觸發方向右鍵，按下觸發回車鍵。由于處理方式的不同，在初始化時需指定鍵盤的類型，建議將這部分代碼放至application.c的application_init中，以旋轉按鈕為例：

ret_t application_init() {

system_info_set_keyboard_type(system_info(), KEYBOARD_3KEYS);

?

return RET_OK;

}

4.傳遞鍵值

? ? ?由于ZDP1440無法外接旋轉按鈕，所以旋鈕等鍵盤外設只能接在控制芯片上，通過串口/SPI向ZDP1440發送按鈕狀態，ZDP1440收到消息后通過對應接口發送鍵值及按鍵狀態：

ret_t main_loop_post_key_event(main_loop_t* l, bool_t pressed, uint8_t key);

?其中：

• l為main_loop_t類型的指針，固定傳入main_loop()
• pressed為按鍵狀態，1為按下、0為抬起
• key為鍵值

注：PC端不支持此函數接口對于三鍵及五鍵鍵盤來說，對應的鍵值宏定義為：

上：TK_KEY_UP

下：TK_KEY_DOWN

左：TK_KEY_LEFT

右：TK_KEY_RIGHT

回車：TK_KEY_RETURN

?我們可以使用ZDP1440內置的協議解析器，采用命令+數據的方式，傳遞鍵值：

1? ?/**

2? ?* brief? 收到鍵值

3? ?*/

4???static void on_key_down(void)

5? ?{

6 ? ? ? ?char* cmd_data;? ? ? ? ? ? ? ? ? ? ? ?// 存放命令后的數據

7? ? ? ? int data_len;? ? ? ? ? ? ? ? ? ? ? ? ? ? // 存放命令后數據的長度

8 ? ? ? ?get_cmd_data(&cmd_data, &data_len); // 獲取命令后的數據

9? ? ? ? uint8_t key = TK_KEY_UNKNOWN;

10?? ?? if(data_len == 1) {? ? ? ? ? ? ? ? ? ? // 命令長讀為1

11? ? ? ? ??switch((uint8_t)(cmd_data[0])) {? ?// 強制轉換為無符號

12? ? ? ? ? ? ? ?case TK_KEY_UP:

13? ? ? ? ? ? ? ? ? ? key = TK_KEY_UP;

14? ? ? ? ? ? ? ? ? ? break;

15 ? ? ? ? ? ? ? case TK_KEY_DOWN:

16 ? ? ? ? ? ? ? ? ? key = TK_KEY_DOWN;

17? ? ? ? ? ? ? ? ? ? break;

18 ? ? ? ? ? ? ? case TK_KEY_RETURN:

19 ?? ? ? ? ? ? ? ? ? key = TK_KEY_RETURN;

20? ? ? ? ? ? ? ? ? ? break;

21? ? ? ? ? ? ? ?default:

22? ? ? ? ? ? ? ? ? ? break;

23? ? ? ? ? ? }

24? ? ? ? }

25? ? ? ? if (key != TK_KEY_UNKNOWN) {

26? ? ? ? ? ? main_loop_post_key_event(main_loop(), 1, key);

27? ? ? ? ? ? main_loop_post_key_event(main_loop(), 0, key);

28? ? ? ? }

29? }

30? /* 注冊收到鍵值的回調函數 */

31? ZDP_REGISTER_CMD(keydn, on_key_down);

5.運行效果

? ?按照上述操作，創建一個簡單的UI，設置所有按鈕支持焦點停留，設置初始焦點為第一個按鈕，label顯示上一次按下的按鈕名稱：

?

新建簡單UI

?

設置鍵盤類型為三鍵模式，添加協議解析器并加入解析數據和發送鍵值相關代碼，生成固件下載至ZDP1440

? ?

資料分享

HMI-ZDP1440開發套件資料持續更新中，需要獲取最新資料，可關注如下鏈接：

https://gitee.com/zlgmcuopen/HMI_ZDP1440D