构建第一个Linux驱动模块

原创 一起学嵌入式 2023-07-15 08:49

扫描关注一起学嵌入式,一起学习,一起成长


上一篇文章介绍了 Linux 驱动编程需要了解的基础知识:

Linux驱动编程必备基础知识

这篇文章来介绍一下,如何构建一个驱动模块。构建一个模块,可以在两个地方完成:

  • 内核树内部
  • 内核树外部

除此之外,还需要编写相应的构建脚本文件 makefile。

接下来,我们逐步进行介绍。

模块构建的makefile

makefile 是用来执行一组操作的特殊文件,其中最重要的操作是程序的编译。专用工具 make 用于解析makefile。

在说明整个make文件之前,先介绍一下 obj-    kbuild 变量。 可以取值为 y、m、n或者空白。

例如:

obj-y += mymodule.o

告诉 kbuild 在当前目录中有一个名为 mymodule.o 的对象。mymodule.o 将从 mymodule.c 或 mymodule.S 构建。 的值决定了如何构建以及是否构建或链接 mymodule.o

  • 如果 设置为 m,则使用变量 obj-m,并将 mymodule.o 构建为模块
  • 如果 设置为 y,则使用变量 obj-y,mymodule.o将构建为内核的一部分。也可以说它是一个内置模块。
  • 如果 设置为 n,则使用变量 obj-n,不会构建 mymodule.o

如果后边跟着是某个目录,例如

obj- += onedir/

kbuild 应该进入 onedir 目录,查找其中所有的 makefile 并处理它们,从而决定应该构建哪些对象。

一份完整的模块构建Makefile 示例:

KERNELDIR ?= /lib/modules/$(shell uname -r)/build

obj-m := helloworld.o

all:
    $(MAKE) -C $(KERNELDIR) M=$(shell pwd) modules;

clean:
    $(MAKE) -C $(KERNELDIR) M=$(shell pwd) clean;
  • obj-m := hellowolrd.o 解析,obj-m 列出要构建的模块。对于每一个 .o,进行系统构建时会查找 .c

  • KERNELDIR := /lib/modules/$(shell uname -r)/build 解析,KERNELDIR 是预构建的内核源码的位置。构建任何模块都需要预构建内核。 -C 要求 make 在读取 makefile 或执行其他任何操作之前先更改到指定的目录。

  • M=$(shell pwd) 解析,这与内核构建系统相关。内核 makefile 使用这个变量来定位要构建的外部模块的目录,.c 文件应该被放置在这。

  • (MAKE) -C $(KERNELDIR ) M=$(shell pwd) modules; 构建驱动模块的规则

内核树内的模块

在内核树中构建驱动程序,需要把驱动程序的代码文件放在特定的目录中。驱动程序中的每个子目录都有 makefile 和 kconfig。

例如,驱动文件 mychardev.c 为字符驱动程序源码,则应该把他放在内核源码的 drivers/char 目录中。

一个 kconfig 的示例文件如下:

config PACKT_MYCDEV
    tristate "Our packtpub special Characterdriver"
    default m
    help
        Say Y here if you want to support the/dev/mycdev device.
        The /dev/mycdev device is used to access packtpub.

同时,在这个目录下的 makefile 文件中添加一下语句:

obj-$(CONFIG_PACKT_MYCDEV) += mychardev.o

注意,.o 文件名称必须与 .c 文件名完全一致。

配置完成后,可以分别使用 make 和 make modules 构建内核和模块。

内核源码树中包含的模块安装在 /lib/modules/$(KERNELRELEASE)/kernel/ 中。在Linux系统上,它是/lib/modules/$(uname -r)/kernel/

内核树外的模块

在构建外部模块之前,需要有一个完整的、预编译的内核源代码树。内核源码树版本必须与将加载和使用模块的内核相同。

有两种方法可以获得预构建的内核版本:

  • 自己构建

  • 从发行版本库安装linux-headers- *包
安装指令
sudo apt-get update
sudo apt-get install linux-headers-$(uname -r)

这将只安装头文件,而不是整个源代码树。

头文件将被安装在 /usr/src/linux-headers-$(uname -r) 目录下 。

有一个符号链接 /lib/modules/$(uname-r)/build,指向前面安装的头文件,这应该是在 makefile 中指定为内核目录的路径。

以上内容准备完成之后,就可以进行构建驱动模块。

构建模块

处理完 makefile 后,只需要切换到源码目录并运行 make 命令,即可开始构建模块。

一个简单模块程序 helloworld.c

#include 
#include
#include

/* 模块入口点函数 */
static int helloworld_init(void)
{
pr_info("Hello world!\n");
return 0;
}

/* 模块出口点函数 */
static void helloworld_exit(void)
{
pr_info("End of the world\n");
}

/* 指定函数用途 */
module_init(helloworld_init);
module_exit(helloworld_exit);

MODULE_AUTHOR("zsky");
MODULE_LICENSE("GPL");

构建脚本文件 Makefile

KERNELDIR ?= /lib/modules/`uname -r`/build

obj-m:=   helloworld.o

all :
    $(MAKE) -C $(KERNELDIR) M=$(shell pwd) modules;

clean:
    $(MAKE) -C $(KERNELDIR) M=$(shell pwd) clean;
    rm -f *.ko;

开始构建:

$ make
make -C /lib/modules/`uname -r`/build M=/home/user/learn/drivers/chap2 modules;
make[1]: Entering directory '/usr/src/linux-headers-5.15.0-73-generic'
CC [M] /home/user/learn/drivers/chap2/helloworld.o
MODPOST /home/user/learn/drivers/chap2/Module.symvers
CC [M] /home/user/learn/drivers/chap2/helloworld.mod.o
LD [M] /home/user/learn/drivers/chap2/helloworld.ko
BTF [M] /home/user/learn/drivers/chap2/helloworld.ko
Skipping BTF generation for /home/user/learn/drivers/chap2/helloworld.ko due to unavailability of vmlinux
make[1]: Leaving directory '/usr/src/linux-headers-5.15.0-73-generic'

构建完成后,在当先目录下会生成一些文件,其中 helloworld.ko,为最终生成的内核模块。

交叉编译

上面的例子使用的是本地构建,在 x86 机器上为x86 机器编译。交叉编译怎么实现?

这个过程是在机器 A(称为宿主机)上编译,该代码要运行在机器 B(称为目标机)上;宿主机和目标机具有不同的体系结构。

常见的交叉编译是在 x86 机器上构建的代码要运行在 ARM 架构上。交叉编译内核模块时,构建 makefile 需要指定两个变量:ARCH 和 CROSS_COMPILE,它们分别表示目标体系结构和编译器的前缀名称。

因此,内核模块本地编译和交叉编译之间的差别在于 makefile 构建文件。

另外,还需要一份目标机器正在使用的内核源码,编译模块的时候需要用到。

模块装载和卸载

模块构建完成后,可以通过 insmod 指令进行装载。注意装载和卸载需要 root 访问权限,可以在模块加载指令之前加上 sudo

$ sudo insmod helloworld.ko

指令执行完,看不到任何信息。

加载内核模块,模块的打印信息需要通过 dmsg 指令查看。可以看到入口函数 helloworld_init()打印的 Hello world!

卸载模块,通过 rmmod 指令

sudo rmmod helloworld

同样出口函数打印的信息,dmesg 指令查看。

另外,用 modinfo 查看模块信息如下:

$ modinfo helloworld.ko
filename: /home/user/learn/drivers/chap2/helloworld.ko
license: GPL
author: zsky
srcversion: 6EFA6AC1502C67E96C09216
depends:
retpoline: Y
name: helloworld
vermagic: 5.15.0-73-generic SMP mod_unload modversions

好了,感谢阅读,加油~


扫码,拉你进高质量嵌入式交流群


关注我【一起学嵌入式】,一起学习,一起成长。


觉得文章不错,点击“分享”、“”、“在看” 呗!

一起学嵌入式 公众号【一起学嵌入式】,RTOS、Linux编程、C/C++,以及经验分享、行业资讯、物联网等技术知
评论
  • 近日,搭载紫光展锐W517芯片平台的INMO GO2由影目科技正式推出。作为全球首款专为商务场景设计的智能翻译眼镜,INMO GO2 以“快、准、稳”三大核心优势,突破传统翻译产品局限,为全球商务人士带来高效、自然、稳定的跨语言交流体验。 INMO GO2内置的W517芯片,是紫光展锐4G旗舰级智能穿戴平台,采用四核处理器,具有高性能、低功耗的优势,内置超微高集成技术,采用先进工艺,计算能力相比同档位竞品提升4倍,强大的性能提供更加多样化的应用场景。【视频见P盘链接】 依托“
    紫光展锐 2024-12-11 11:50 65浏览
  • 智能汽车可替换LED前照灯控制运行的原理涉及多个方面,包括自适应前照灯系统(AFS)的工作原理、传感器的应用、步进电机的控制以及模糊控制策略等。当下时代的智能汽车灯光控制系统通过车载网关控制单元集中控制,表现特殊点的有特斯拉,仅通过前车身控制器,整个系统就包括了灯光旋转开关、车灯变光开关、左LED前照灯总成、右LED前照灯总成、转向柱电子控制单元、CAN数据总线接口、组合仪表控制单元、车载网关控制单元等器件。变光开关、转向开关和辅助操作系统一般连为一体,开关之间通过内部线束和转向柱装置连接为多,
    lauguo2013 2024-12-10 15:53 93浏览
  • 首先在gitee上打个广告:ad5d2f3b647444a88b6f7f9555fd681f.mp4 · 丙丁先生/香河英茂工作室中国 - Gitee.com丙丁先生 (mr-bingding) - Gitee.com2024年对我来说是充满挑战和机遇的一年。在这一年里,我不仅进行了多个开发板的测评,还尝试了多种不同的项目和技术。今天,我想分享一下这一年的故事,希望能给大家带来一些启发和乐趣。 年初的时候,我开始对各种开发板进行测评。从STM32WBA55CG到瑞萨、平头哥和平海的开发板,我都
    丙丁先生 2024-12-11 20:14 58浏览
  • 在智能化技术快速发展当下,图像数据的采集与处理逐渐成为自动驾驶、工业等领域的一项关键技术。高质量的图像数据采集与算法集成测试都是确保系统性能和可靠性的关键。随着技术的不断进步,对于图像数据的采集、处理和分析的需求日益增长,这不仅要求我们拥有高性能的相机硬件,还要求我们能够高效地集成和测试各种算法。我们探索了一种多源相机数据采集与算法集成测试方案,能够满足不同应用场景下对图像采集和算法测试的多样化需求,确保数据的准确性和算法的有效性。一、相机组成相机一般由镜头(Lens),图像传感器(Image
    康谋 2024-12-12 09:45 63浏览
  • 概述 通过前面的研究学习,已经可以在CycloneVGX器件中成功实现完整的TDC(或者说完整的TDL,即延时线),测试结果也比较满足,解决了超大BIN尺寸以及大量0尺寸BIN的问题,但是还是存在一些之前系列器件还未遇到的问题,这些问题将在本文中进行详细描述介绍。 在五代Cyclone器件内部系统时钟受限的情况下,意味着大量逻辑资源将被浪费在于实现较大长度的TDL上面。是否可以找到方法可以对此前TDL的长度进行优化呢?本文还将探讨这个问题。TDC前段BIN颗粒堵塞问题分析 将延时链在逻辑中实现后
    coyoo 2024-12-10 13:28 108浏览
  • 习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习笔记&记录学习习笔记&记学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记
    youyeye 2024-12-11 17:58 75浏览
  • 时源芯微——RE超标整机定位与解决详细流程一、 初步测量与问题确认使用专业的电磁辐射测量设备,对整机的辐射发射进行精确测量。确认是否存在RE超标问题,并记录超标频段和幅度。二、电缆检查与处理若存在信号电缆:步骤一:拔掉所有信号电缆,仅保留电源线,再次测量整机的辐射发射。若测量合格:判定问题出在信号电缆上,可能是电缆的共模电流导致。逐一连接信号电缆,每次连接后测量,定位具体哪根电缆或接口导致超标。对问题电缆进行处理,如加共模扼流圈、滤波器,或优化电缆布局和屏蔽。重新连接所有电缆,再次测量
    时源芯微 2024-12-11 17:11 104浏览
  • 我的一台很多年前人家不要了的九十年代SONY台式组合音响,接手时只有CD功能不行了,因为不需要,也就没修,只使用收音机、磁带机和外接信号功能就够了。最近五年在外地,就断电闲置,没使用了。今年9月回到家里,就一个劲儿地忙着收拾家当,忙了一个多月,太多事啦!修了电气,清理了闲置不用了的电器和电子,就是一个劲儿地扔扔扔!几十年的“工匠式”收留收藏,只能断舍离,拆解不过来的了。一天,忽然感觉室内有股臭味,用鼻子的嗅觉功能朝着臭味重的方向寻找,觉得应该就是这台组合音响?怎么会呢?这无机物的东西不会腐臭吧?
    自做自受 2024-12-10 16:34 163浏览
  • 习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习笔记&记录学习习笔记&记学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记
    youyeye 2024-12-10 16:13 113浏览
  • 【萤火工场CEM5826-M11测评】OLED显示雷达数据本文结合之前关于串口打印雷达监测数据的研究,进一步扩展至 OLED 屏幕显示。该项目整体分为两部分: 一、框架显示; 二、数据采集与填充显示。为了减小 MCU 负担,采用 局部刷新 的方案。1. 显示框架所需库函数 Wire.h 、Adafruit_GFX.h 、Adafruit_SSD1306.h . 代码#include #include #include #include "logo_128x64.h"#include "logo_
    无垠的广袤 2024-12-10 14:03 74浏览
  • 铁氧体芯片是一种基于铁氧体磁性材料制成的芯片,在通信、传感器、储能等领域有着广泛的应用。铁氧体磁性材料能够通过外加磁场调控其导电性质和反射性质,因此在信号处理和传感器技术方面有着独特的优势。以下是对半导体划片机在铁氧体划切领域应用的详细阐述: 一、半导体划片机的工作原理与特点半导体划片机是一种使用刀片或通过激光等方式高精度切割被加工物的装置,是半导体后道封测中晶圆切割和WLP切割环节的关键设备。它结合了水气电、空气静压高速主轴、精密机械传动、传感器及自动化控制等先进技术,具有高精度、高
    博捷芯划片机 2024-12-12 09:16 69浏览
  • 一、SAE J1939协议概述SAE J1939协议是由美国汽车工程师协会(SAE,Society of Automotive Engineers)定义的一种用于重型车辆和工业设备中的通信协议,主要应用于车辆和设备之间的实时数据交换。J1939基于CAN(Controller Area Network)总线技术,使用29bit的扩展标识符和扩展数据帧,CAN通信速率为250Kbps,用于车载电子控制单元(ECU)之间的通信和控制。小北同学在之前也对J1939协议做过扫盲科普【科普系列】SAE J
    北汇信息 2024-12-11 15:45 104浏览
  • 天问Block和Mixly是两个不同的编程工具,分别在单片机开发和教育编程领域有各自的应用。以下是对它们的详细比较: 基本定义 天问Block:天问Block是一个基于区块链技术的数字身份验证和数据交换平台。它的目标是为用户提供一个安全、去中心化、可信任的数字身份验证和数据交换解决方案。 Mixly:Mixly是一款由北京师范大学教育学部创客教育实验室开发的图形化编程软件,旨在为初学者提供一个易于学习和使用的Arduino编程环境。 主要功能 天问Block:支持STC全系列8位单片机,32位
    丙丁先生 2024-12-11 13:15 60浏览
  • RK3506 是瑞芯微推出的MPU产品,芯片制程为22nm,定位于轻量级、低成本解决方案。该MPU具有低功耗、外设接口丰富、实时性高的特点,适合用多种工商业场景。本文将基于RK3506的设计特点,为大家分析其应用场景。RK3506核心板主要分为三个型号,各型号间的区别如下图:​图 1  RK3506核心板处理器型号场景1:显示HMIRK3506核心板显示接口支持RGB、MIPI、QSPI输出,且支持2D图形加速,轻松运行QT、LVGL等GUI,最快3S内开
    万象奥科 2024-12-11 15:42 80浏览
  • 全球知名半导体制造商ROHM Co., Ltd.(以下简称“罗姆”)宣布与Taiwan Semiconductor Manufacturing Company Limited(以下简称“台积公司”)就车载氮化镓功率器件的开发和量产事宜建立战略合作伙伴关系。通过该合作关系,双方将致力于将罗姆的氮化镓器件开发技术与台积公司业界先进的GaN-on-Silicon工艺技术优势结合起来,满足市场对高耐压和高频特性优异的功率元器件日益增长的需求。氮化镓功率器件目前主要被用于AC适配器和服务器电源等消费电子和
    电子资讯报 2024-12-10 17:09 95浏览
我要评论
0
点击右上角,分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦