银河麒麟os怎么编写内核模块驱动自定义硬件设备

老磊姑娘_6390

老磊姑娘_6390

2026-11-17

841人浏览

原创

需严格匹配内核版本并验证/lib/modules/$(uname -r)/build指向有效源码树,否则编译报错;编写适配4.19.90+的最小字符设备驱动,使用标准file_operations接口替代已废弃的class_simple。

银河麒麟os怎么编写内核模块驱动自定义硬件设备

在银河麒麟OS上为自定义硬件设备编写内核模块驱动,需严格匹配当前运行内核版本、启用正确的编译环境、处理符号导出与模块签名限制,否则编译会失败或加载时提示“Unknown symbol in module”“module verification failed”等致命错误。

确认内核版本与头文件路径

这一步不能跳过,否则后续所有编译都会报 【Unable to find kernel source tree】 错误。银河麒麟V10/V10SPx 的内核头文件路径不统一,/usr/src/kernels/ 下可能有多个目录,但只有软链接 /lib/modules/$(uname -r)/build 指向的那个才是真实可用的源码树。

执行以下命令验证:

uname -r → 输出类似 4.19.90-24.4.v2101.ky10.x86_64

ls -l /lib/modules/$(uname -r)/build → 必须指向一个真实存在的目录,且该目录下要有 Makefile 和 include/ 子目录

若返回 “No such file or directory”,说明 kernel-devel 包未安装或版本不匹配,必须立即补装:sudo yum install -y kernel-devel-$(uname -r)

编写最简字符设备驱动(hello_world.c)

从最小可运行单元开始,避免一上来就写复杂寄存器操作导致调试无从下手。以下代码已适配银河麒麟V10 SP2+ 内核(4.19.90+),删除了旧版内核中已废弃的 class_simple 接口。

创建 hello_world.c:

#include
#include
#include
#include
#include

#define DEVICE_NAME "hello_dev"
#define CLASS_NAME "hello_class"

static int major;
static struct class* hello_class = NULL;
static struct device* hello_device = NULL;

static int dev_open(struct inode *inodep, struct file *filep) {
  printk(KERN_INFO "hello_dev: Device opened\n");
  return 0;
}

static ssize_t dev_read(struct file *filep, char __user *buffer, size_t len, loff_t *offset) {
  const char msg[] = "Hello from Kylin kernel!\n";
  if (*offset >= sizeof(msg)) return 0;
  if (copy_to_user(buffer, msg + *offset, sizeof(msg) - *offset))
    return -EFAULT;
  *offset += sizeof(msg) - *offset;
  return sizeof(msg) - *offset;
}

static int dev_release(struct inode *inodep, struct file *filep) {
  printk(KERN_INFO "hello_dev: Device closed\n");
  return 0;
}

static const struct file_operations fops = {
  .owner = THIS_MODULE,
  .open = dev_open,
  .read = dev_read,
  .release = dev_release,
};

static int __init hello_init(void) {
  major = register_chrdev(0, DEVICE_NAME, &fops);
  if (major     printk(KERN_ALERT "hello_dev: Failed to register major number\n");
    return major;
  }
  printk(KERN_INFO "hello_dev: Registered with major number %d\n", major);

  hello_class = class_create(THIS_MODULE, CLASS_NAME);
  if (IS_ERR(hello_class)) {
    unregister_chrdev(major, DEVICE_NAME);
    return PTR_ERR(hello_class);
  }

  hello_device = device_create(hello_class, NULL, MKDEV(major, 0), NULL, DEVICE_NAME);
  if (IS_ERR(hello_device)) {
    class_destroy(hello_class);
    unregister_chrdev(major, DEVICE_NAME);
    return PTR_ERR(hello_device);
  }
  return 0;
}

static void __exit hello_exit(void) {
  device_destroy(hello_class, MKDEV(major, 0));
  class_unregister(hello_class);
  class_destroy(hello_class);
  unregister_chrdev(major, DEVICE_NAME);
  printk(KERN_INFO "hello_dev: Unloaded\n");
}

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Kylin Driver Dev");
MODULE_DESCRIPTION("A minimal character device for Kylin OS");
module_init(hello_init);
module_exit(hello_exit);

编写Makefile并编译模块

银河麒麟默认禁用未签名模块加载,因此编译阶段必须使用系统当前内核的构建环境,且 Makefile 中的 KDIR 路径必须与 /lib/modules/$(uname -r)/build 完全一致,否则会链接到错误头文件,导致编译通过但加载失败。

创建 Makefile:

obj-m += hello_world.o
KDIR := /lib/modules/$(shell uname -r)/build

all:
  make -C $(KDIR) M=$(PWD) modules

clean:
  make -C $(KDIR) M=$(PWD) clean

执行 make 编译,成功后生成 hello_world.ko 文件。若报错 “error: implicit declaration of function ‘class_create’”,说明内核头文件路径错误或 kernel-devel 版本不匹配。

签名与加载驱动模块

银河麒麟V10 SP2+ 默认启用 Secure Boot 或 MODULE_SIG_FORCE,未签名模块会被拒绝加载,dmesg 中显示 “module verification failed: signature and/or required key missing”。必须签名才能加载。

方法一:使用系统已有的签名密钥(推荐)

AssemblyAI
AssemblyAI

AssemblyAI是一款为开发者提供语音转文字、语音理解和语音 Agent API 的 Speech AI 平台。

下载

sudo /usr/src/kernels/$(uname -r)/scripts/sign-file sha256 \
  /usr/src/kernels/$(uname -r)/certs/signing_key.pem \
  /usr/src/kernels/$(uname -r)/certs/signing_key.x509 \
  hello_world.ko

方法二:临时禁用模块签名检查(仅测试环境)

echo 'options kvm-intel ignore_msrs=1' | sudo tee /etc/modprobe.d/disable-modsig.conf
sudo dracut -f
sudo reboot

⚠️ 注意:【禁用签名检查会降低系统安全性,生产环境严禁使用】

签名完成后执行:

sudo insmod hello_world.ko
dmesg | tail -5 → 应看到 “Registered with major number” 成功日志
ls /dev/hello_dev → 设备节点应存在

设置开机自动加载

第一步:将模块复制到标准路径

sudo cp hello_world.ko /lib/modules/$(uname -r)/extra/
sudo depmod -a

第二步:写入模块名到配置文件

echo "hello_world" | sudo tee /etc/modules-load.d/hello_world.conf

第三步:(可选)添加别名与权限规则

echo 'KERNEL=="hello_dev", MODE="0666", GROUP="wheel"' | sudo tee /etc/udev/rules.d/99-hello-dev.rules
sudo udevadm control --reload-rules

重启后执行 lsmod | grep hello_world,确认模块已自动加载。

相关文章

驱动精灵
驱动精灵

驱动精灵基于驱动之家十余年的专业数据积累,驱动支持度高,已经为数亿用户解决了各种电脑驱动问题、系统故障,是目前有效的驱动软件,有需要的小伙伴快来保存下载体验吧!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.14

2308

9

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

1059

6

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

467

5

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

347

5

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

446

5

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

600

5

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.21

1449

9

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

2024.03.22

1257

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1345

9

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习