Tina SDK Linux Kernel 基本使用（实战篇：为开发板添加用户按键驱动支持）

Tina SDK Linux Kernel 基本使用实战篇为开发板添加用户按键驱动支持本文是全志Tina-SDK Linux内核开发实战系列的第二篇以100ASK_T113s3-Pro开发板上的用户按键USER KEY为例手把手带你完成从硬件原理图分析、Pinctrl/GPIO子系统理解、设备树修改、内核模块配置到驱动加载验证的完整流程。学完本节你将掌握为任何嵌入式Linux系统添加独立按键或GPIO输入设备的方法并深入理解Pinctrl框架在设备树中的配置方式。本文延续上一篇的超详细风格所有内容全面展开不偷工减料。 本任务的学习目标和重点掌握程度分级图标含义工作要求必须掌握⭐⭐⭐独立作业考核核心能独立完成从原理图到设备树再到验证的全过程。重点掌握⭐⭐了解原理能按文档完成理解Pinctrl基本概念能看懂设备树中的引脚配置。了解即可⭐知道概念能复述知道Pinctrl框架的分层面试能说清楚。优先掌握必须掌握⭐⭐⭐的内容是你的核心竞争力重点掌握⭐⭐能帮你快速定位问题了解即可⭐部分可以后续再深入学习。文章目录Tina SDK Linux Kernel 基本使用实战篇为开发板添加用户按键驱动支持 本任务的学习目标和重点掌握程度一、项目背景我们要做什么二、理论基础Pinctrl 子系统与 GPIO⭐⭐ 重点掌握2.1 Pinctrl 系统架构2.2 全志平台 Pinctrl 的重要节点2.3 设备树中描述一个 GPIO 按键的格式三、查看硬件原理图与数据手册⭐⭐⭐ 必须掌握3.1 从原理图找到按键引脚3.2 确认引脚未被其他功能占用四、修改设备树⭐⭐⭐ 必须掌握4.1 定位板级设备树文件4.2 添加 gpio-keys 节点4.3 检查引脚冲突五、配置内核模块⭐⭐⭐ 必须掌握5.1 进入 Tina 配置主界面5.2 找到 gpio-keys 模块5.3 保存配置六、编译、打包与烧录⭐⭐ 重点掌握6.1 编译系统6.2 打包镜像6.3 烧录镜像七、验证按键功能⭐⭐⭐ 必须掌握7.1 检查模块是否已自动加载7.2 手动加载模块7.3 查看输入设备列表7.4 测试按键事件7.5 设置开机自动加载八、进阶理解 GPIO 配置的格式九、常见问题排查十、面试官提问环节第1问设备树中 gpio-keys 节点的 compatible 属性为什么是 gpio-keys它如何匹配驱动第2问Pinctrl 子系统中的 default 和 sleep 状态是什么意思什么时候会切换第3问为什么在 TinaSDK 中不能直接用 make kernel_menuconfig 来永久保存内核配置应该怎么做第4问在验证按键时cat /dev/input/event3 出现乱码这是否代表失败怎样正确观察按键事件十一、总结一、项目背景我们要做什么在嵌入式Linux产品中经常需要用到独立按键如用户按键USER KEY、复位键、音量键等。Linux内核提供了gpio-keys驱动可以将连接到GPIO的按键抽象为输入设备向上层上报按键事件如 KEY_VOLUMEDOWN、KEY_POWER等。本次任务为100ASK_T113s3-Pro开发板上的USER KEY添加驱动支持使得按下按键时系统能够检测到并上报对应的键值例如KEY_VOLUMEDOWN或自定义键值后续应用可以通过/dev/input/eventX读取按键事件。硬件连接分析通过查阅开发板原理图100ASK_T113-Pro_Base-SCH_V1.2.pdf和实物图USER KEY 连接到 T113 芯片的PB4引脚且按键按下时引脚为低电平GPIO_ACTIVE_LOW。我们需要在设备树中配置该引脚为中断模式并关联对应的键值。二、理论基础Pinctrl 子系统与 GPIO⭐⭐ 重点掌握在动手修改设备树之前你需要先了解一些背景知识。Linux内核使用PinctrlPin Controller子系统统一管理所有引脚的复用和电气特性。2.1 Pinctrl 系统架构Pinctrl 框架分为四层参考图示textDevice Tree 描述引脚的配置信息设备树节点 ↓ Pinctrl Interface 上层驱动调用的接口如 pinctrl_select_state ↓ Pinctrl Framework Linux 内核核心框架处理状态、复用和配置 ↓ Pinctrl Driver 芯片厂商实现的底层驱动全志为 SUNXI PinctrlPinctrl 主要处理三类功能Pin State引脚状态支持default正常运行、sleep休眠、idle空闲等不同状态每种状态可以配置不同的引脚功能。Pin Mux引脚复用一个引脚可以承担多种功能如 GPIO、UART、I2C、SPI等通过设置 Mux 值来切换。例如 PE0 可以作为NCSI_PCLK、RGMII_RXD1、I2S1_MCLK、PWM0、SDC1_CLK、UART3_TX、TWI3_SCK等。Pin Config引脚配置配置驱动能力、上拉/下拉、输入/输出等电气特性。2.2 全志平台 Pinctrl 的重要节点在 T113 的设备树中有两个 Pinctrl 节点节点名寄存器地址管理的引脚注意pio0x02000000PL0 之前的引脚包括 PA~PK大部分外设引脚r_pio0x07022000PL0 及以后的引脚部分低功耗、RTC相关引脚我们使用的 PB4 属于pio管理。2.3 设备树中描述一个 GPIO 按键的格式gpio-keys驱动要求我们在设备树中创建一个节点格式如下cgpio-keys { compatible gpio-keys; status okay; user-key { gpios pio PB 4 GPIO_ACTIVE_LOW; linux,code 114; // KEY_VOLUMEDOWN 的键值 label user key; debounce-interval 10; // 消抖时间毫秒 wakeup-source; // 可作为唤醒源 }; };各属性含义compatible匹配内核中的gpio-keys驱动。gpios指定 GPIO 引脚、极性。linux,code上报给 input 子系统的键值114对应KEY_VOLUMEDOWN也可以使用其他值如KEY_POWER、KEY_ENTER等。label此按键的描述名称。debounce-interval简单消抖延迟毫秒。wakeup-source系统休眠时该按键可以唤醒系统可选.三、查看硬件原理图与数据手册⭐⭐⭐ 必须掌握3.1 从原理图找到按键引脚查阅100ASK_T113-Pro_Base-SCH_V1.2.pdf中的按键部分实物图标注 USER KEY 旁边有 SW2。根据电路图USER KEY 连接到 T113 的PB4引脚按下时接地低电平。因此我们需要在设备树中配置GPIO_ACTIVE_LOW。3.2 确认引脚未被其他功能占用查阅T113-s3_datasheet_v1.6.pdf第40页的 GPIO Multiplex Function 表PB4 的默认功能是LCDD-D8但也可复用为其他功能。在我们的开发板上PB4 未用于其他外设因此可以直接作为 GPIO 使用。排查冲突在添加前建议用grep -r PB4 device/检查是否已有其他设备使用了该引脚。如果有冲突需要解除冲突或更换引脚。四、修改设备树⭐⭐⭐ 必须掌握4.1 定位板级设备树文件回顾之前的内容板级设备树位于bash# 切换到板级配置目录 ccconfigs cd linux-5.4 vim board.dts快捷命令说明执行ccconfigs可直接进入device/config/chips/t113/configs/100ask/linux/目录再执行vim board.dts编辑设备树。4.2 添加 gpio-keys 节点在board.dts文件的合适位置通常在根节点下远离其他大括号添加如下内容cpio { // ... 原有配置保持不变 ... }; /* 新增按键设备节点 */ gpio-keys { compatible gpio-keys; status okay; user-key { gpios pio PB 4 GPIO_ACTIVE_LOW; // PB4, 低电平有效 linux,code 114; // KEY_VOLUMEDOWN label user key; debounce-interval 10; wakeup-source; }; /* 如果你还有别的按键可以继续添加例如 power-key { gpios pio PE 1 GPIO_ACTIVE_LOW; linux,code 116; // KEY_POWER label power key; debounce-interval 10; }; */ };4.3 检查引脚冲突检查是否有其他设备也使用了 PB4。如果在board.dts或sun8iw20p1.dtsi中搜索到 PB4且状态为okay则需要禁用或修改。通常情况下开发板默认未使用可以直接添加。验证方法在board.dts中搜索PB4若无其他节点使用则安全。五、配置内核模块⭐⭐⭐ 必须掌握我们已经知道在 TinaSDK 中内核模块是通过make menuconfig而不是make kernel_menuconfig来永久选中的。5.1 进入 Tina 配置主界面bash# 回到 SDK 根目录 cd ~/tina-d1-h source build/envsetup.sh lunch 4 # 选择 t113_100ask-tina make menuconfig5.2 找到 gpio-keys 模块在菜单中依次进入textKernel modules --- Input modules --- [*] kmod-input-gpio-keys --- GPIO key support使用Y键选中该项变为*。注意我们不需要kmod-input-gpio-keys-polled轮询方式除非你的按键不适合中断方式。5.3 保存配置按Esc两次退出到主界面选择Save确认保存为.config然后退出。配置保存后Tina 会在后续make时自动将CONFIG_KEYBOARD_GPIO等选项写入内核的.config并编译gpio-keys.ko模块。六、编译、打包与烧录⭐⭐ 重点掌握6.1 编译系统bash# 在 SDK 根目录执行 make -j$(nproc)编译过程中你会看到系统编译gpio_keys.ko模块的日志类似下图textCC [M] drivers/input/keyboard/gpio_keys.o Building modules, stage 2. CC [M] drivers/input/keyboard/gpio_keys.mod.o LD [M] drivers/input/keyboard/gpio_keys.ko6.2 打包镜像bashpack打包成功后最终镜像路径为text/home/ubuntu/tina-d1-h/out/t113-100ask/tina_t113-100ask_uart3.img使用ls -lh查看大小约43MB。6.3 烧录镜像将镜像复制到 Windows通过共享文件夹或拖拽使用PhoenixSuit线刷到开发板的 SPI NAND 中。七、验证按键功能⭐⭐⭐ 必须掌握烧录完成后启动开发板通过串口登录。7.1 检查模块是否已自动加载首先查看lsmod看gpio_keys是否已在模块列表中bashlsmod | grep gpio_keys如果未出现需要手动安装或设置开机自动加载后面会讲。按照预期Tina 默认不会自动加载 gpio_keys.ko需要手动处理。7.2 手动加载模块进入模块目录并手动安装bashcd /lib/modules/5.4.61/ insmod gpio_keys.ko加载后内核日志会显示textinput: gpio-keys as /devices/platform/gpio-keys/input/input3此时新的输入设备节点/dev/input/event3已创建。7.3 查看输入设备列表bashcat /proc/bus/input/devices在输出中找到gpio-keys段确认其对应的H行Handlers为event2。7.4 测试按键事件bashcat /dev/input/event2然后按下开发板上的 USER KEY 按键终端上应出现二进制乱码输出表明有数据上报。你也可以使用hexdump查看具体数据bashhexdump /dev/input/event3按下按键会输出类似text0000000 0a9a 0000 3b2c 0008 0001 0072 0001 0000 ...其中0001 0072中的0x72就是十进制 114即KEY_VOLUMEDOWN。说明按键驱动工作正常。7.5 设置开机自动加载为了避免每次都要insmod可以修改系统启动脚本/etc/init.d/rc.modulesbashvi /etc/init.d/rc.modules在文件中仿照其他.ko的加载方式添加一行bash/sbin/insmod /lib/modules/5.4.61/gpio_keys.ko保存后重启系统即会自动加载 gpio_keys 模块。八、进阶理解 GPIO 配置的格式在设备树中gpios pio PB 4 GPIO_ACTIVE_LOW;是一个简化的写法。更完整的 GPIO 属性在旧版设备树中可能使用 6 个数字textgpios pio bank pin mux pull drive data;对应关系字段含义示例值pio指向哪个 Pinctrl 控制器pio或r_piobankGPIO 组PB对应数值 1? 但设备树中通常直接写 PB由宏转换pin组内序号4mux复用模式输入为 0, 输出为 10输入pull上下拉0禁用,1上拉,2下拉0drive驱动能力通常 0xffffffff 表示默认data输出电平仅输出时有效0xffffffff 忽略但在新的设备树中gpios pio PB 4 GPIO_ACTIVE_LOW;使用了 GPIO 子系统中定义的标志宏更简洁。九、常见问题排查现象可能原因解决方法lsmod看不到gpio_keys模块未编译或未安装检查make menuconfig中是否选中重新makeinsmod失败提示Unknown symbol依赖模块未加载检查input-core是否已编译进内核按键无反应cat /dev/input/eventX无输出设备树配置错误或引脚冲突检查gpios的引脚号和极性确认无其他设备占用 PB4按键上报乱码但无正确键值测试工具问题用hexdump查看具体上报数据确认linux,code值正确十、面试官提问环节第1问设备树中gpio-keys节点的compatible属性为什么是gpio-keys它如何匹配驱动参考答案compatible属性是设备树与内核驱动匹配的关键字段。内核中的gpio-keys驱动通过of_match_table声明自己支持gpio-keys。当内核解析设备树时发现节点compatible为gpio-keys就会调用该驱动的probe函数来初始化设备。第2问Pinctrl 子系统中的default和sleep状态是什么意思什么时候会切换参考答案default系统正常运行时的引脚状态如 UART 的 TX/RX 引脚工作在 UART 模式。sleep系统进入休眠状态时的引脚状态通常会将引脚设置为gpio_in或高阻态以节省功耗。当系统通过pm_runtime或suspend/resume切换电源状态时Pinctrl 框架会自动调用pinctrl_select_state来切换引脚配置。第3问为什么在 TinaSDK 中不能直接用make kernel_menuconfig来永久保存内核配置应该怎么做参考答案因为 TinaSDK 的内核配置是由多个片段动态合并而成的generic/config-5.4board/linux/config-5.4。直接修改.config会在下次make时被覆盖。正确做法是通过make menuconfigTina主配置中的Kernel modules选项来选择需要的内核模块这些选项会被转化为内核配置片段永久保存在modules.mk或config-5.4中。如果需要修改更深层次的内核选项应修改板级config-5.4文件。第4问在验证按键时cat /dev/input/event3出现乱码这是否代表失败怎样正确观察按键事件参考答案cat将二进制数据直接打印到终端会造成乱码这并不代表失败反而说明有数据上报。要正确查看按键事件可以使用hexdump /dev/input/event3查看十六进制数据或者安装evtest工具evtest /dev/input/event3它会解析并显示每个事件的具体类型、键值和状态。十一、总结本文带你完整走了一遍为 T113 开发板添加用户按键驱动支持的流程包括硬件分析从原理图找到 USER KEY 的引脚 PB4 和极性。设备树修改添加gpio-keys节点配置 GPIO 和键值。内核模块配置在 Tina 的make menuconfig中选中kmod-input-gpio-keys。编译与烧录执行make和pack生成镜像并烧录。验证与动手手动加载模块用hexdump或evtest测试最后设为开机自动加载。同时你还深入了解了 Pinctrl 子系统的概念、设备树中 GPIO 配置的格式以及 TinaSDK 中内核模块的配置机制。学习阶段任务⭐ 入门按本文步骤完成按键驱动添加成功看到按键事件。⭐⭐ 进阶修改linux,code为其他值如 KEY_POWER并观察上层应用反应。⭐⭐⭐ 高级查阅 Pinctrl 驱动源码理解引脚状态切换的实现细节。整个系列完结撒花你从一个完全不懂嵌入式 Linux 的小白到现在已经能够独立为开发板添加 LCD 触摸屏和按键驱动理解和修改设备树配置内核模块烧录验证。你已经具备了嵌入式 Linux 驱动开发的初步能力。后续可以深入学习 I2C/SPI 子系统、设备树语法、内核调试等高级主题。祝你职场顺利考核满分