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

推荐订阅源

Project Zero
Project Zero
F
Fortinet All Blogs
Recent Announcements
Recent Announcements
云风的 BLOG
云风的 BLOG
CTFtime.org: upcoming CTF events
CTFtime.org: upcoming CTF events
M
MIT News - Artificial intelligence
S
SegmentFault 最新的问题
Blog — PlanetScale
Blog — PlanetScale
T
Tailwind CSS Blog
WordPress大学
WordPress大学
Engineering at Meta
Engineering at Meta
S
Schneier on Security
N
News and Events Feed by Topic
N
News | PayPal Newsroom
H
Help Net Security
C
CXSECURITY Database RSS Feed - CXSecurity.com
T
The Exploit Database - CXSecurity.com
Attack and Defense Labs
Attack and Defense Labs
博客园 - Franky
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
J
Java Code Geeks
A
About on SuperTechFans
AWS News Blog
AWS News Blog
S
Secure Thoughts
The Cloudflare Blog
Hugging Face - Blog
Hugging Face - Blog
爱范儿
爱范儿
C
Cybersecurity and Infrastructure Security Agency CISA
V2EX - 技术
V2EX - 技术
Recorded Future
Recorded Future
Microsoft Azure Blog
Microsoft Azure Blog
博客园_首页
MyScale Blog
MyScale Blog
Martin Fowler
Martin Fowler
Help Net Security
Help Net Security
人人都是产品经理
人人都是产品经理
Latest news
Latest news
C
Cyber Attacks, Cyber Crime and Cyber Security
大猫的无限游戏
大猫的无限游戏
The Last Watchdog
The Last Watchdog
www.infosecurity-magazine.com
www.infosecurity-magazine.com
月光博客
月光博客
H
Hacker News: Front Page
P
Proofpoint News Feed
N
News and Events Feed by Topic
H
Heimdal Security Blog
L
Lohrmann on Cybersecurity
有赞技术团队
有赞技术团队
L
LangChain Blog
Application and Cybersecurity Blog
Application and Cybersecurity Blog

博客园_首页

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处理器用户手册