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

推荐订阅源

K
KPMG report finds enterprise disconnect between AI and its ROI | CIO
T
Troy Hunt's Blog
Schneier on Security
Schneier on Security
N
News | PayPal Newsroom
Hacker News: Ask HN
Hacker News: Ask HN
cs.CV updates on arXiv.org
cs.CV updates on arXiv.org
Google DeepMind News
Google DeepMind News
www.infosecurity-magazine.com
www.infosecurity-magazine.com
N
News and Events Feed by Topic
V
Vulnerabilities – Threatpost
Cyberwarzone
Cyberwarzone
K
Kaspersky official blog
P
Privacy & Cybersecurity Law Blog
P
Privacy International News Feed
WordPress大学
WordPress大学
U
Unit 42
PCI Perspectives
PCI Perspectives
S
Schneier on Security
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
V
Visual Studio Blog
Engineering at Meta
Engineering at Meta
The Cloudflare Blog
I
Intezer
宝玉的分享
宝玉的分享
N
News and Events Feed by Topic
Martin Fowler
Martin Fowler
B
Blog
美团技术团队
T
The Blog of Author Tim Ferriss
C
Cisco Blogs
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
酷 壳 – CoolShell
酷 壳 – CoolShell
The Last Watchdog
The Last Watchdog
J
Java Code Geeks
博客园_首页
A
About on SuperTechFans
Vercel News
Vercel News
Attack and Defense Labs
Attack and Defense Labs
H
Heimdal Security Blog
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
IT之家
IT之家
小众软件
小众软件
H
Help Net Security
D
Darknet – Hacking Tools, Hacker News & Cyber Security
Exploit-DB.com RSS Feed
Exploit-DB.com RSS Feed
T
The Exploit Database - CXSecurity.com
Y
Y Combinator Blog
Recent Commits to openclaw:main
Recent Commits to openclaw:main
Webroot Blog
Webroot Blog
T
Tenable Blog

博客园_首页

Plist 二进制格式 Milvus 和 PGVector,哪个更好? OpenClaw 已过时?在 VS Code 中运行 Hermes Agent! 第30篇文章:一个大三计科生的自白 Manim如何在数学公式中完美显示中文? Docker 部署 RocketMQ 5 并发编程核心概念辨析 C#事务处理最佳实践:别再让“主表存了、明细丢了”的破事发生 CLI 是什么?为什么大厂突然集体卷命令行? 【从0到1构建一个ClaudeAgent】协作-自主Agent UIImageView 设置图片不生效的原因排查 最小二乘问题详解20:无先验约束下的增量式SFM自由网平差 痞子衡嵌入式:大话双核i.MXRT1180之XIP应用里借助MU实现可靠Flash IAP的方法 AI Chat 封装, SemanticKerne.AiProvider.Unified 已发布 Windows下右键编辑js文件无法打开记事本——在注册表中使用环境变量 在后台服务中使用 Scoped 服务,为什么总是报错? H200 安装驱动并使用sglang启动模型 wireshark 抓包Trap上报告警内容 我用 AI 辅助开发了一系列小工具(2):图片压缩工具 [A Primer On MC and CC] 2.1 Memory Consistency 1 - 指令重排序和 SC 模型 Oracle数据库SCN推进技术详解与实践指南 玩转控件:封装个带图片的Label控件 Claude Code 4.7 真正该升级的不是模型,而是你的工作流 前端小白一句话,AI 帮我做了个颜值拉满的桌面媒体播放器。当代码不再是门槛,一句话编程就是现实。 5. WorkBuddy: 小龙虾的灵魂三件套,让你的小龙虾不只是工具 SQLite 分片方案实战:三种分片策略的深度对比 告别简陋 UI!一款基于 Fluent Design 和基于 WinUI 的开源免费、现代化的 Avalonia UI 控件库 关于二进制排列组合枚举的总结 AI开发-python-LangGraph框架(3-27-LangGraph从零实现大模型智能决策工作流) ElasticSearch主分片和副本分片概念详解 【002】HTTPS 粗解:证书、TLS 握手与对后端配置的影响 Hermes Agent 一周暴涨五万 Star,但我劝你别急着追 明明连接的是Redis的DB0,为什么能查到DB3的数据? 【从0到1构建一个ClaudeAgent】协作-Agent团队 熟悉电子元器件之后,电子小白下一步该怎么走? MAF快速入门(23)通过C#类定义Skills .NET 高级开发 | 手写一个对象映射框架 FastAPI数据库ORM怎么选?我肝了三个Demo后,终于不再纠结了 mysqldump 参数拾遗:在遗忘与铭记之间 C# .NET 周刊|2026年3月5期 Claude code入门 - 陈彦斌 一文学习入门 ThingsBoard 开源物联网平台 GitHub 热门项目 | 2026年04月16日 如何为GIT设置全局勾子,为每次提交追加信息 Number.isFinite和isFinite与isNaN()和Number.isNaN的区别 PortSwigger SQL注入LAB2 推荐一个测试人必备的Skills,从功能到性能全搞定(附详细实操和安装下载方式) 筑基期:掌握Odoo基础核心知识点02(Odoo XML 开发方式详解) GLM模型这么火,咱们用vllm也咧一个呗! 深入理解 AbortController:从底层原理到跨语言设计哲学 字符串学习笔记 多租户系统框架的基础模块设计和分析设计 Apache SeaTunnel Zeta 为什么能做到“又快又稳”? AI开发-python-LangGraph框架(3-26-LangGraph基本概念及第一个简单样例) Vue 3 组件通信,别只会用 Props 和 Emits 了,这几个狠活儿你得看看 ElasticSearch7.X版本配置密码 用Manim实现动态交点计算--从一个动点问题说起 团结引擎+Addressable+Instant Game打包抖音小游戏 function call 实战:让 LLM 自动判断 pod 异常、调用日志工具并完成故障分析 bubseek —— 让 Agent 的足迹,变成团队的洞察 通过 C# 读取并导出 PDF 书签 如何用 GitHub Actions 实现 Steam 自动化发布 【从0到1构建一个ClaudeAgent】并发-后台任务 .NET 高级开发 | 定制 ASP.NET Core 框架 电子小白:什么是运算放大器(运放) zero2Agent:面向大厂面试的 Agent 工程教程,从概念到生产的完整学习路线 堆上的ORW HC32F460 USB CDC通信异常:非对齐访问异常排查 20260413-Hyperbridge 攻击事件:发生在默克尔山上的验证绕过 那些喊着AI 要淘汰你的人,正在靠你的焦虑赚大钱! 深度学习进阶(八)Swin Transformer 最小二乘问题详解19:带先验约束的增量式SFM优化与实现 SnapTranslate 3.0 正式发布:全局划词翻译 + 完整英语学习闭环,一站式搞定查词、记词、复习 工作的意义、工作的困难认知再思考 .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 上下文工程是什么?过时了么?一文讲明白! - 一枫说码 开了 TUN 模式还是直连?90% 的人都踩过这个坑 AScript扩展多种脚本语言 - rockey627 AI 学习笔记:Agent 的记忆机制 你能被装进一个文件里吗?——7 万人把同事"蒸馏"成了 AI - 我没有三颗心脏 Claude Code 通关手册(七):给 AI 装上技能包——Skills 完全指南 - 暮色之狐 在浏览器中快速编辑代码:VSCode Web 集成实践 - Newbe36524 蒸馏自己 skill?基于 Deepseek 的蒸馏器,丐版蒸馏方式,简单便捷 - To_Carpe_Diem Spring AI Aliababa和AgentScope,哪个更好? - 苏三说技术
龙芯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处理器用户手册