惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

H
Help Net Security
Scott Helme
Scott Helme
爱范儿
爱范儿
WordPress大学
WordPress大学
博客园 - 三生石上(FineUI控件)
阮一峰的网络日志
阮一峰的网络日志
博客园 - Franky
V
V2EX
腾讯CDC
博客园_首页
博客园 - 司徒正美
酷 壳 – CoolShell
酷 壳 – CoolShell
T
Tailwind CSS Blog
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
小众软件
小众软件
J
Java Code Geeks
大猫的无限游戏
大猫的无限游戏
月光博客
月光博客
Microsoft Azure Blog
Microsoft Azure Blog
B
Blog
雷峰网
雷峰网
Stack Overflow Blog
Stack Overflow Blog
IT之家
IT之家
罗磊的独立博客
Recorded Future
Recorded Future
博客园 - 聂微东
O
OpenAI News
S
Secure Thoughts
Hacker News: Ask HN
Hacker News: Ask HN
S
Schneier on Security
Hacker News - Newest:
Hacker News - Newest: "LLM"
Y
Y Combinator Blog
C
Cyber Attacks, Cyber Crime and Cyber Security
Project Zero
Project Zero
宝玉的分享
宝玉的分享
K
Kaspersky official blog
N
Netflix TechBlog - Medium
T
The Exploit Database - CXSecurity.com
Google Online Security Blog
Google Online Security Blog
cs.CL updates on arXiv.org
cs.CL updates on arXiv.org
cs.CV updates on arXiv.org
cs.CV updates on arXiv.org
Webroot Blog
Webroot Blog
云风的 BLOG
云风的 BLOG
Simon Willison's Weblog
Simon Willison's Weblog
C
Check Point Blog
D
Darknet – Hacking Tools, Hacker News & Cyber Security
L
LINUX DO - 热门话题
美团技术团队
L
Lohrmann on Cybersecurity

博客园_首页

Linux实操--组管理、权限管理和定时任务 Java + EasyExcel 实现单个接口导出多个Excel Mem0 源码解析系列(二):提示词工程的深度剖析 Openclaw TaskFlow究竟是什么?和普通Skill技能有什么区别 博文阅读密码验证 - 博客园 嘉立创开源:应该是全网MicroPython教程最多的开发板 Hermes Agent 集成实践:从协议到生产 2026年AI编程工具横评:Cursor、Codex、Claude Code、Zed、Windsurf Java程序员必看的RAG入门教程 2026 AI效率神器:Superpowers + Claude Code 保姆级教程 本地大模型部署全攻略:从 0 到 1 玩转 Ollama 【从0到1构建一个ClaudeAgent】内存管理-上下文压缩 .NET 高级开发 | 设计、实现一个事件总线框架 电子小白入门之NE555 3. WorkBuddy:隐藏玩法,一键召唤专家,让 AI 以"专家身份"给你干活 和AI一起搞事情#3:Claude Teammate 游戏开发翻车实录 【OpenClaw】通过 Nanobot 源码学习架构---(7)Memory C# .NET 周刊|2026年3月3期 我在 Debian 11 上把 K8s 单机搭起来了,过程没你想的那么顺(/opt 目录版) 深度学习进阶(七)Data-efficient Image Transformer CLI+Skill搭建浏览器AI自动化框架,告别一切重复枯燥任务 告别Token账单无底洞:OpenClaw本地部署,重塑企业数据主权的唯一解 FastAPI+Vue:文件分片上传+秒传+断点续传,这坑我帮你踩平了! SBTI 爆火后,我做了个程序员版的 CBTI。。已开源 + 附开发过程 多模态检索开始进入工程期:用 Sentence Transformers 搭建可落地的 Multimodal RAG 100多行代码实现一个最简单的Agent(用ReAct) Claude Code 通关手册(八):推荐 5 个 Hooks,代码质量提升 3 倍 老板:“有人截图了!”。安全部门:“收到,马上查暗水印!” - why技术 技术之外,皆是人间 C#/.NET/.NET Core技术前沿周刊 | 第 69 期(2026年4.01-4.12) Snack JSONPath 项目架构分析 Claude Code Buddy 小析:一个非核心功能,如何体现产品的细节完成度 AI新时代下的图床管理方案-Cloudflare图床+MCP+Skills方案指南 化繁为简:顺丰速运App如何通过 HarmonyOS SDK实现专业级空间测量 从零实现富文本编辑器#13-React非编辑节点的内容渲染 AI开发-python-langchain框架(3-23-OpenAI Functions风格Tool Calling智能助手) .NET + AI 进阶实战:基于类的技能开发 - 打造可治理的 Agent 能力模块 【从0到1构建一个ClaudeAgent】规划与协调-技能 上周热点回顾(4.6-4.12) 电子小白的工具三件套:面包板、杜邦线、万能板 单表五亿数据的查询优化 | Mysql、StarRocks 2. WorkBuddy:从“我是谁”到“帮我干活” C# 如何减少代码运行时间:7 个实战技巧 基于HelixToolkit.SharpDX 渲染3D模型 - 笺上知微 从零开始的双臂具身VLA起源及现阶段发展综述 - SkyXZ 记对 xonsh shell 的使用, 脚本编写, 迁移及调优 - pluvium27 受够了Vibe Coding的失控?换个起点,让AI事半功倍 从开始配置漏洞环境到漏洞复现流程 - 難しい 关于10年工作经验的程序员对OpenClaw的实战经验分享以及看法 - 虚无境 Any metadata 的内存布局 C# .NET 周刊|2026年3月2期 - InCerry 我帮你测过了,测试圈排名第二的 Skill 依然很牛逼 Skill Discovery | 无监督技能发现的经典工作总结 - MoonOut PbootCMS 网站内容数量多导致访问慢?这些实用优化方案帮你提速! - 家兴网络技术工作室 上下文工程是什么?过时了么?一文讲明白! - 一枫说码 网站漏洞怎么发现并修复?一篇实用指南(附完整流程) - 家兴网络技术工作室 开了 TUN 模式还是直连?90% 的人都踩过这个坑 Github日报|2026年04月12日 - AI一族 AScript扩展多种脚本语言 - rockey627 AI 学习笔记:Agent 的记忆机制 你能被装进一个文件里吗?——7 万人把同事"蒸馏"成了 AI - 我没有三颗心脏 Claude Code 通关手册(七):给 AI 装上技能包——Skills 完全指南 - 暮色之狐 在浏览器中快速编辑代码:VSCode Web 集成实践 - Newbe36524 蒸馏自己 skill?基于 Deepseek 的蒸馏器,丐版蒸馏方式,简单便捷 - To_Carpe_Diem Spring AI Aliababa和AgentScope,哪个更好? - 苏三说技术 Etsy 把 1000 个 MySQL 分片迁进 Vitess:425TB 数据背后的真正问题不是性能,而是运维规模 MicroPython LVGL基础知识和概念:底层渲染与性能优化 - FreakStudio 数据库草图算法 Python 潮流周刊#146:CPython 引入 Rust 的进展 - 豌豆花下猫 最小生成树 - mofei1116 红日靶场七:从外网入口、容器逃逸到 AD 接管的完整利用链复盘 - YouDiscovered1t 分享四款开源且实用的 Kafka 管理工具 - 追逐时光者 vLLM 权重加载机制全解析:从挑战到理想架构 LCT 学习笔记 - ACehomoxue Avalonia UI 12.0.0 正式发布:架构演进和性能飞跃 - 张善友 当 AI Agent 把调用链拉长,延迟开始成为一门生意 conhost.exe 无法显示 U+2717 - 145a 太秀了,我把自己蒸馏成了 Skill!已开源 - 程序员鱼皮 ASP.NET Core 内存缓存实战:一篇搞懂该怎么配、怎么避坑 基于 Ghostty 带有分割标签页和为 Claude 编程设计的通知终端 - BugShare AI 焊死入口:教育的“操作系统级”重塑 - 郝hai 初级Java开发工程师使用sql脚本编写代码的过程是简单而且不糊涂 - CoderOilStation Claude Code通关手册(六):MCP协议完全指南 - 暮色之狐 边框灯光环绕动画特效实现指南 - Newbe36524 开源:子木蒸馏版的 SEO 审计工具 seo-audit-skill v1.0 我所理解的Python元模型 【从0到1构建一个ClaudeAgent】规划与协调-TodoWrite - 程序员Seven Claude 和 Codex 在审计 Skill 上性能差异探究 - ACai_sec AScript如何实现中文脚本引擎 - rockey627 【渗透测试】HTB Season10 Garfield 全过程wp - dynasty_chenzi Android 开发者为什么必须掌握 AI 能力?端侧视角下的技术变革 树状数组正确性证明 - AC-wyr 你的 AI 焦虑,可能比 AI 本身更危险——ATM 机没有消灭银行柜员,但恐慌消灭了你的判断力 - 我没有三颗心脏 一个拉胯的分库分表方案有多绝望?整个部门都在救火! - 冰河团队 动态规划入门必学之走方格问题 - Ofnoname PostgREST 与 PostgreSQL 角色权限配置全解析(生产级实践) - SheepDog1998 使用 UEFI 图形输出协议 GOP 在屏幕上显示图像的方法 - 阿源- Claude Code通关手册(五):组建你的AI专家团队,子代理系统 - 暮色之狐 一个程序员到架构师的催婚路之感悟(整整10年后的催婚相亲感悟) - MisterLip 用 Agent Skill 自动生成工作周报 - 赵康
龙芯2k0300 - 走马观碑组按键驱动移植
大奥特曼打小怪兽 · 2026-05-09 · via 博客园_首页

----------------------------------------------------------------------------------------------------------------------------

开发板 :久久派开发板
eMMC8GB
DDR4512MB
u-bootu-boot 2022.04
linux6.12
rootfsbuildroot-2024.08
----------------------------------------------------------------------------------------------------------------------------

在《龙芯2k0300 - 走马观碑组第21届智能汽车竞赛软硬件设计》中,我们使用久久派开发板作为智能车主控板。前面已经完成了PWM、编码器、显示屏、摄像头等模块的移植,这一节我们继续补充久久派板载按键驱动。

久久派开发板上有两个用户按键:

其中:

  • KEY0:对应UART2_TXD,也就是GPIO44
  • KEY1:对应UART2_RXD,也就是GPIO45

这两个按键可以用于智能车的发车、停车、模式切换、参数确认、调试触发等功能。不过内核驱动不应该直接处理“发车”这类业务逻辑,驱动只负责把硬件按键转换成标准Linux input事件,具体业务逻辑交给用户态程序处理。

一、久久派KEY0/KEY1按键

1.1 硬件连接关系

久久派两个按键和龙芯2K0300的连接关系如下:

按键 复用引脚 GPIO 默认电平 按下电平 说明
KEY0 UART2_TXD GPIO44 高电平 低电平 低有效按键
KEY1 UART2_RXD GPIO45 高电平 低电平 低有效按键

也就是说,按键没有按下时,GPIO 原始电平为高;按下按键后,GPIO 原始电平被拉低。

因此设备树中必须使用GPIO_ACTIVE_LOW描述按键极性。这样驱动通过gpiod_get_value_cansleep()读取 GPIO 时,内核gpiod框架会自动把低有效电平转换为逻辑值:

  • 未按下:逻辑值0
  • 按下:逻辑值1

1.2 为什么使用input子系统

按键驱动有很多种实现方式,比如:

  • 字符设备:用户态通过read()读取自定义结构体;
  • misc 设备:用户态打开/dev/xxx读取按键状态;
  • input设备:驱动上报标准EV_KEY事件。

这里选择Linux input子系统,原因是:

  • 按键本身就是标准输入设备,适合用EV_KEY事件描述;
  • 用户态可以直接读取/dev/input/eventX
  • 后续也可以用evtestlibinput等工具调试;
  • 驱动只负责上报按下、释放事件,不和智能车业务逻辑耦合。

本文中驱动注册的 input 设备名称为:

LS2K300 99Pi Keys

默认键值映射如下:

按键 Linux key code 数值 说明
KEY0 KEY_PROG1 148 可作为发车、确认等自定义功能键
KEY1 KEY_PROG2 149 可作为停车、模式切换等自定义功能键

二、按键设备驱动

2.1 创建驱动目录

driver目录下创建key_driver子目录:

zhengyang@ubuntu:~$ cd /opt/2k0300/loongson_2k300_lib/driver
zhengyang@ubuntu:/opt/2k0300/loongson_2k300_lib/driver$ mkdir key_driver
zhengyang@ubuntu:/opt/2k0300/loongson_2k300_lib/driver$ cd key_driver

目录结构如下:

zhengyang@ubuntu:/opt/2k0300/loongson_2k300_lib/driver/key_driver$ tree .
.
├── key_driver.c
├── Makefile
└── README.md

2.2 key_driver.c

按键驱动的核心思路如下:

  1. 通过设备树匹配compatible = "ls2k300-99pi-keys"
  2. 获取key0-gpioskey1-gpios
  3. 将 GPIO 转换为 IRQ;
  4. 同时监听上升沿和下降沿;
  5. 中断触发后启动延迟工作队列做消抖;
  6. 消抖完成后读取 GPIO 逻辑状态;
  7. 通过input_report_key()input_sync()上报按键事件。

驱动头文件和基本宏定义如下:

#include <linux/gpio/consumer.h>
#include <linux/input.h>
#include <linux/interrupt.h>
#include <linux/module.h>
#include <linux/of.h>
#include <linux/platform_device.h>
#include <linux/slab.h>
#include <linux/workqueue.h>

#define DRIVER_NAME "ls2k300_99pi_keys"
#define DEFAULT_DEBOUNCE_MS 20

单个按键运行状态使用struct key_button描述:

struct key_device;

struct key_button {
	const char *name;
	struct gpio_desc *gpiod;
	int irq;
	unsigned int code;
	bool last_pressed;
	struct delayed_work work;
	struct key_device *parent;
};

整个双按键设备使用struct key_device描述:

struct key_device {
	struct device *dev;
	struct input_dev *input;
	struct key_button buttons[2];
	unsigned int debounce_ms;
};

默认按键名称和键值:

static const char *const default_names[] = {
	"KEY0",
	"KEY1",
};

static const unsigned int default_codes[] = {
	KEY_PROG1,
	KEY_PROG2,
};
2.2.1 读取按键状态

由于设备树使用GPIO_ACTIVE_LOW,所以gpiod_get_value_cansleep()返回的是逻辑值,而不是原始电平。也就是说,按键按下时返回1,松开时返回0

static bool button_pressed(struct key_button *button)
{
	int value = gpiod_get_value_cansleep(button->gpiod);

	if (value < 0) {
		dev_warn(button->parent->dev, "failed to read %s GPIO: %d\n",
			 button->name, value);
		return button->last_pressed;
	}

	return value != 0;
}
2.2.2 上报按键事件

只有当前状态和上一次状态不一致时才上报事件,避免重复打印和重复上报。

static void report_button_state(struct key_button *button)
{
	bool pressed = button_pressed(button);

	if (pressed == button->last_pressed)
		return;

	button->last_pressed = pressed;
	input_report_key(button->parent->input, button->code, pressed);
	input_sync(button->parent->input);
	dev_info(button->parent->dev, "%s %s code=%u\n",
		 button->name,
		 pressed ? "pressed" : "released",
		 button->code);
}
2.2.3 中断与消抖

机械按键按下和释放时会出现抖动,因此不能在中断中立即上报事件。这里中断处理函数只负责启动一个延迟工作,真正读取 GPIO 和上报 input 事件在工作队列中完成。

static void key_work(struct work_struct *work)
{
	struct key_button *button =
		container_of(to_delayed_work(work), struct key_button, work);

	report_button_state(button);
}

static irqreturn_t key_irq(int irq, void *data)
{
	struct key_button *button = data;

	mod_delayed_work(system_wq,
			 &button->work,
			 msecs_to_jiffies(button->parent->debounce_ms));
	return IRQ_HANDLED;
}
2.2.4 初始化单个按键

setup_button()完成一个按键的 GPIO 获取、IRQ 映射、input capability 设置和中断注册。

static int setup_button(struct key_device *keys, int index)
{
	struct device *dev = keys->dev;
	struct key_button *button = &keys->buttons[index];
	char gpio_name[8];
	int ret;

	snprintf(gpio_name, sizeof(gpio_name), "key%d", index);

	button->name = default_names[index];
	button->code = default_codes[index];
	button->parent = keys;
	INIT_DELAYED_WORK(&button->work, key_work);

	if (dev->of_node) {
		of_property_read_string_index(dev->of_node,
					      "linux,key-names",
					      index,
					      &button->name);
		of_property_read_u32_index(dev->of_node,
					   "linux,key-codes",
					   index,
					   &button->code);
	}

	button->gpiod = devm_gpiod_get(dev, gpio_name, GPIOD_IN);
	if (IS_ERR(button->gpiod)) {
		ret = PTR_ERR(button->gpiod);
		dev_err(dev, "failed to get %s GPIO: %d\n", gpio_name, ret);
		return ret;
	}

	button->irq = gpiod_to_irq(button->gpiod);
	if (button->irq < 0) {
		dev_err(dev, "failed to map %s GPIO to IRQ: %d\n",
			button->name, button->irq);
		return button->irq;
	}

	button->last_pressed = button_pressed(button);
	input_set_capability(keys->input, EV_KEY, button->code);

	ret = devm_request_threaded_irq(dev,
					button->irq,
					NULL,
					key_irq,
					IRQF_TRIGGER_RISING |
					IRQF_TRIGGER_FALLING |
					IRQF_ONESHOT,
					button->name,
					button);
	if (ret) {
		dev_err(dev, "failed to request IRQ for %s: %d\n",
			button->name, ret);
		return ret;
	}

	dev_info(dev, "%s registered on IRQ %d code %u initial=%s\n",
		 button->name,
		 button->irq,
		 button->code,
		 button->last_pressed ? "pressed" : "released");
	return 0;
}
2.2.5 probe函数

probe函数中分配驱动上下文、初始化 input 设备、初始化两个按键,最后注册 input 设备。

static int key_probe(struct platform_device *pdev)
{
	struct key_device *keys;
	int ret;
	int i;

	dev_info(&pdev->dev, "probing %s input driver\n", DRIVER_NAME);

	keys = devm_kzalloc(&pdev->dev, sizeof(*keys), GFP_KERNEL);
	if (!keys)
		return -ENOMEM;

	keys->dev = &pdev->dev;
	keys->debounce_ms = DEFAULT_DEBOUNCE_MS;
	device_property_read_u32(&pdev->dev,
				 "debounce-interval-ms",
				 &keys->debounce_ms);

	keys->input = devm_input_allocate_device(&pdev->dev);
	if (!keys->input)
		return -ENOMEM;

	keys->input->name = "LS2K300 99Pi Keys";
	keys->input->phys = "ls2k300-99pi-keys/input0";
	keys->input->id.bustype = BUS_HOST;

	for (i = 0; i < ARRAY_SIZE(keys->buttons); ++i) {
		ret = setup_button(keys, i);
		if (ret)
			return ret;
	}

	ret = input_register_device(keys->input);
	if (ret) {
		dev_err(&pdev->dev, "failed to register input device: %d\n", ret);
		return ret;
	}

	platform_set_drvdata(pdev, keys);
	dev_info(&pdev->dev, "LS2K300 99Pi key input driver ready: %s\n",
		 keys->input->name);
	return 0;
}
2.2.6 设备树匹配表

这里需要注意compatible,设备树节点和驱动模块要匹配。

static const struct of_device_id key_of_match[] = {
	{ .compatible = "ls2k300-99pi-keys" },
	{ }
};
MODULE_DEVICE_TABLE(of, key_of_match);

static struct platform_driver key_driver = {
	.probe = key_probe,
	.remove = key_remove,
	.driver = {
		.name = DRIVER_NAME,
		.of_match_table = key_of_match,
	},
};

module_platform_driver(key_driver);

MODULE_AUTHOR("zhengyang");
MODULE_DESCRIPTION("LS2K300 99Pi GPIO key input driver");
MODULE_LICENSE("GPL");

2.3 Makefile

Makefile如下:

KERNELDIR ?= /opt/2k0300/build-2k0300/workspace/linux-6.12
PWD := $(shell pwd)
CROSS_COMPILE ?= loongarch64-linux-gnu-
ARCH := loongarch

BUILD_DIR := build
KO_DIR := ko

obj-m := ls2k300_99pi_keys.o
ls2k300_99pi_keys-y := key_driver.o

all: prepare compile move_files

prepare:
	@mkdir -p $(BUILD_DIR) $(KO_DIR)
	@echo "key_driver: prepare build directories"

compile:
	@echo "key_driver: build kernel module"
	make -C $(KERNELDIR) ARCH=$(ARCH) CROSS_COMPILE=$(CROSS_COMPILE) M=$(PWD) modules

move_files:
	@find . -type f \
		-not -path "./$(BUILD_DIR)/*" -not -path "./$(KO_DIR)/*" \
		\( -name '*.o' -o -name '*.mod' -o -name '*.mod.o' -o -name '*.mod.c' -o -name '.*.cmd' -o -name 'modules.order' -o -name 'Module.symvers' \) \
		! -name '*.ko' -exec mv -t $(BUILD_DIR)/ {} +
	@find . -type f \
		-not -path "./$(BUILD_DIR)/*" -not -path "./$(KO_DIR)/*" \
		-name '*.ko' -exec cp -f {} $(KO_DIR)/ \; -exec rm -f {} \;

clean:
	@echo "key_driver: clean build outputs"
	make -C $(KERNELDIR) ARCH=$(ARCH) CROSS_COMPILE=$(CROSS_COMPILE) M=$(PWD) clean
	rm -rf *.ko *.o *.mod *.mod.o *.mod.c *.symvers *.order .*.cmd .tmp_versions build ko

.PHONY: all prepare compile move_files clean

三、新增设备树节点

3.1 keys节点

进入内核源码目录:

zhengyang@ubuntu:~$ cd /opt/2k0300/build-2k0300/workspace/linux-6.12

修改arch/loongarch/boot/dts/ls2k300_99pi.dtsi,在根节点/下增加keys节点:

keys {
	compatible = "ls2k300-99pi-keys";
	key0-gpios = <&gpio 44 GPIO_ACTIVE_LOW>;
	key1-gpios = <&gpio 45 GPIO_ACTIVE_LOW>;
	debounce-interval-ms = <20>;
	linux,key-codes = <148 149>;
	linux,key-names = "KEY0", "KEY1";
	status = "okay";
};

说明:

  • compatible必须和驱动中的of_device_id一致;
  • key0-gpios对应GPIO44
  • key1-gpios对应GPIO45
  • GPIO_ACTIVE_LOW表示按键低有效;
  • debounce-interval-ms = <20>表示消抖时间为20ms
  • linux,key-codes = <148 149>对应KEY_PROG1KEY_PROG2

3.2 禁用UART2

由于KEY0KEY1占用了UART2_TXDUART2_RXD,所以必须禁用uart2,避免串口和按键同时占用同一组引脚。

&uart2 {
	status = "disabled";
};

久久派默认可以把GPIO44GPIO45作为普通 GPIO 使用,因此这里不需要额外新增pinctrl节点把UART2_TXD/UART2_RXD切回 GPIO。

四、应用程序

4.1 创建测试程序目录

example目录下创建key_app

zhengyang@ubuntu:/opt/2k0300/loongson_2k300_lib/example$ mkdir key_app
zhengyang@ubuntu:/opt/2k0300/loongson_2k300_lib/example$ cd key_app

目录结构如下:

zhengyang@ubuntu:/opt/2k0300/loongson_2k300_lib/example/key_app$ tree .
.
├── main.c
└── Makefile

4.2 main.c

用户态测试程序的逻辑如下:

  1. 默认查找 input 设备名称LS2K300 99Pi Keys
  2. 如果找不到,可以通过--device /dev/input/eventX手动指定;
  3. 打开/dev/input/eventX
  4. 使用poll()等待 input 事件;
  5. 只打印KEY_PROG1KEY_PROG2对应的按键事件。

关键宏定义如下:

#include <errno.h>
#include <ctype.h>
#include <fcntl.h>
#include <linux/input.h>
#include <poll.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>

#define DEFAULT_DEVICE_NAME "LS2K300 99Pi Keys"
#define DEFAULT_KEY0_CODE KEY_PROG1
#define DEFAULT_KEY1_CODE KEY_PROG2

将键值转换为按键名称:

static const char *key_name(unsigned short code)
{
	if (code == DEFAULT_KEY0_CODE)
		return "KEY0";
	if (code == DEFAULT_KEY1_CODE)
		return "KEY1";
	return "UNKNOWN";
}

input 事件值转换为动作名称:

static const char *key_action(int value)
{
	switch (value) {
	case 0:
		return "release";
	case 1:
		return "press";
	case 2:
		return "repeat";
	default:
		return "unknown";
	}
}

主循环读取 input 事件:

while (max_events < 0 || event_count < max_events) {
	struct pollfd pfd = {
		.fd = fd,
		.events = POLLIN,
	};
	struct input_event event;
	ssize_t nread;
	int ret;

	ret = poll(&pfd, 1, -1);
	if (ret < 0) {
		if (errno == EINTR)
			continue;
		fprintf(stderr, "poll failed: %s\n", strerror(errno));
		break;
	}

	nread = read(fd, &event, sizeof(event));
	if (nread != sizeof(event))
		continue;

	if (event.type != EV_KEY)
		continue;
	if (event.code != DEFAULT_KEY0_CODE && event.code != DEFAULT_KEY1_CODE)
		continue;

	printf("%-4s %-7s code=%u value=%d time=%ld.%06ld\n",
	       key_name(event.code),
	       key_action(event.value),
	       event.code,
	       event.value,
	       (long)event.time.tv_sec,
	       (long)event.time.tv_usec);
	event_count++;
}

4.3 Makefile

TOOLCHAIN_DIR ?= ../../cross_lib/loongarch64-linux-gnu-gcc13.3/bin
CROSS_COMPILE ?= $(TOOLCHAIN_DIR)/loongarch64-linux-gnu-

ifeq ($(origin CC),default)
CC := $(CROSS_COMPILE)gcc
endif

CFLAGS ?= -Wall -Wextra -O2
TARGET := main

all:
	$(CC) $(CFLAGS) -o $(TARGET) main.c

clean:
	rm -rf *.o $(TARGET)

.PHONY: all clean

五、测试

5.1 烧录设备树

5.1.1 编译设备树

如果需要单独编译设备树,可以在driver目录使用统一脚本:

zhengyang@ubuntu:~$ cd /opt/2k0300/loongson_2k300_lib/driver
zhengyang@ubuntu:/opt/2k0300/loongson_2k300_lib/driver$ ./build_driver.sh --target dtb

脚本内部等价于在 Linux 内核目录执行:

zhengyang@ubuntu:~$ cd /opt/2k0300/build-2k0300/workspace/linux-6.12
zhengyang@ubuntu:/opt/2k0300/build-2k0300/workspace/linux-6.12$ source ../set_env.sh && make dtbs V=1
5.1.2 更新设备树

将设备树拷贝到久久派并烧录到SPI Nor Flashdtb分区:

zhengyang@ubuntu:/opt/2k0300/loongson_2k300_lib/driver$ ./build_driver.sh --target dtb --deploy root@172.23.17.235

脚本会把ls2k300_99pi_wifi.dtb上传到目标板/opt目录,并在目标板执行:

[root@LS-GD opt]# dd if=/opt/ls2k300_99pi_wifi.dtb of=/dev/mtdblock3 bs=1
[root@LS-GD opt]# sync

烧录完成后重启开发板:

[root@LS-GD opt]# reboot

5.2 安装驱动

5.2.1 编译并部署驱动

由于我们并没有将按键驱动源码放到内核源码树中,因此需要单独编译安装。

ubuntu宿主机执行:

zhengyang@ubuntu:~$ cd /opt/2k0300/loongson_2k300_lib/driver
zhengyang@ubuntu:/opt/2k0300/loongson_2k300_lib/driver$ ./build_driver.sh --target key --deploy root@172.23.17.235

脚本会完成以下工作:

  • 调用内核外部模块构建流程生成ls2k300_99pi_keys.ko
  • 将模块复制到本地driver/key_driver/install/目录;
  • 上传到开发板/lib/modules/$(uname -r)/目录;
  • 执行depmod -a $(uname -r)更新模块依赖。

部署日志示例:

key local install file updated:
-rw-rw-r-- 1 zhengyang zhengyang 16664  5月  9 20:52 /opt/2k0300/loongson_2k300_lib/driver/key_driver/install/ls2k300_99pi_keys.ko
Deploy /opt/2k0300/loongson_2k300_lib/driver/key_driver/install/ls2k300_99pi_keys.ko to root@172.23.17.235:/lib/modules/6.12.0.lsgd+/ls2k300_99pi_keys.ko
ls2k300_99pi_keys.ko 100%   16KB   3.2MB/s   00:00
depmod: WARNING: could not open modules.builtin at /lib/modules/6.12.0.lsgd+: No such file or directory
depmod: WARNING: could not open modules.builtin.modinfo at /lib/modules/6.12.0.lsgd+: No such file or directory

这里depmod的输出是警告,不是致命错误。含义是/lib/modules/$(uname -r)/目录缺少modules.builtinmodules.builtin.modinfo,不影响当前外部模块通过modprobe加载。

5.2.2 检查模块 alias

在开发板检查模块信息:

[root@LS-GD ~]# modinfo /lib/modules/$(uname -r)/ls2k300_99pi_keys.ko | grep alias
alias:          of:N*T*Cls2k300-99pi-keysC*
alias:          of:N*T*Cls2k300-99pi-keys
5.2.3 加载驱动

手动加载驱动:

[root@LS-GD ~]# modprobe ls2k300_99pi_keys

查看模块:

[root@LS-GD ~]# lsmod | grep ls2k300_99pi_keys
ls2k300_99pi_keys      65536  0

查看内核日志:

[root@LS-GD ~]# dmesg | grep -iE "Keys"

正常情况下可以看到类似输出:

[  698.012212] ls2k300_99pi_keys keys: probing ls2k300_99pi_keys input driver
[  698.019241] ls2k300_99pi_keys keys: debounce interval: 20 ms
[  698.025993] ls2k300_99pi_keys keys: input device name: LS2K300 99Pi Keys
[  698.034795] ls2k300_99pi_keys keys: KEY0 registered on IRQ 72 code 148 initial=released
[  698.043222] ls2k300_99pi_keys keys: KEY1 registered on IRQ 73 code 149 initial=released
[  698.051871] input: LS2K300 99Pi Keys as /devices/platform/keys/input/input0
[  698.067180] ls2k300_99pi_keys keys: LS2K300 99Pi key input driver ready: LS2K300 99Pi Keys

5.3 验证 input 设备

查看/proc/bus/input/devices

[root@LS-GD ~]# cat /proc/bus/input/devices

正常情况下可以看到类似内容:

[root@LS-GD 6.12.0.lsgd+]# cat /proc/bus/input/devices
I: Bus=0019 Vendor=0000 Product=0000 Version=0000
N: Name="LS2K300 99Pi Keys"
P: Phys=ls2k300-99pi-keys/input0
S: Sysfs=/devices/platform/keys/input/input0
U: Uniq=
H: Handlers=kbd event0
B: PROP=0
B: EV=3
B: KEY=300000 0 0

这里重点关注:

  • Name="LS2K300 99Pi Keys"
  • Handlers中存在eventX

5.4 应用程序测试

5.4.1 编译、部署并运行

在宿主机example目录执行:

zhengyang@ubuntu:~$ cd /opt/2k0300/loongson_2k300_lib/example
zhengyang@ubuntu:/opt/2k0300/loongson_2k300_lib/example$ ./build_deploy_run.sh --app key_app --deploy root@172.23.17.235

也可以只编译部署,不立即运行:

zhengyang@ubuntu:/opt/2k0300/loongson_2k300_lib/example$ ./build_deploy_run.sh --app key_app --deploy root@172.23.17.235 --no-run

然后在开发板上运行:

[root@LS-GD opt]# ./key_app
Listening on /dev/input/event0 (LS2K300 99Pi Keys)
KEY0=148 KEY1=149, press Ctrl+C to stop

按下和松开KEY0KEY1后,可以看到类似输出:

KEY0 press   code=148 value=1 time=123.456789
KEY0 release code=148 value=0 time=123.556789
KEY1 press   code=149 value=1 time=125.123456
KEY1 release code=149 value=0 time=125.223456
5.4.2 手动指定 event 设备

如果程序没有自动找到 input 设备,可以手动指定:

[root@LS-GD opt]# ./key_app --device /dev/input/event0

也可以限制打印事件数量:

[root@LS-GD opt]# ./key_app --count 4

5.5 常见问题

5.5.1 驱动加载后没有 probe 日志

先确认设备树中是否存在keys节点:

[root@LS-GD ~]# grep -aR "ls2k300-99pi-keys" /proc/device-tree 2>/dev/null
/proc/device-tree/keys/compatible:ls2k300-99pi-keys

再确认驱动 alias 是否匹配:

[root@LS-GD ~]# modinfo /lib/modules/$(uname -r)/ls2k300_99pi_keys.ko | grep alias
alias:          of:N*T*Cls2k300-99pi-keysC*
alias:          of:N*T*Cls2k300-99pi-keys

可以看到模块 aliasls2k300-99pi-keys,和设备树一致。

5.5.2 找不到 input 设备

检查驱动是否加载:

[root@LS-GD ~]# lsmod | grep ls2k300_99pi_keys

检查 platform devicedriver

[root@LS-GD ~]# ls /sys/bus/platform/devices | grep -i key
keys

[root@LS-GD ~]# ls /sys/bus/platform/drivers/ls2k300_99pi_keys
bind  keys  module  uevent  unbind

如果有 device,也有 driver,但是没有 probe 日志,通常就是compatible或模块 alias 不匹配。

5.5.3 按键一直是按下状态或状态相反

久久派KEY0/KEY1是低有效按键,设备树必须写:

key0-gpios = <&gpio 44 GPIO_ACTIVE_LOW>;
key1-gpios = <&gpio 45 GPIO_ACTIVE_LOW>;

如果误写成GPIO_ACTIVE_HIGH,按键逻辑会反过来。

六、代码下载

loongson_2k300_lib

参考文章

[1] Linux input 子系统文档

[2] 龙芯2K0300数据手册

[3] 龙芯2K0300处理器用户手册