前言
- 以野火i.M 6U为例
2. 内核模块
本章节笔记主要理解内核模块代码框架和原理，分析一个简单的内核模块例子。
需要明确的是模块和驱动是两回事。
2.1 内核模块概念
2.1.1 内核
内核，是一个操作系统的核心。是基于硬件的第一层软件扩充，提供操作系统的最基本的功能， 是操作系统工作的基础，决定着整个操作系统的性能和稳定性。
内核按照体系结构分为：微内核和宏内核。
- 参考图：
2.1.2 内核模块机制的引入
提高系统灵活性，在调试驱动的时候不需要重新编译内核，也不需要重新启动内核，只需要插入需要调试的驱动即可。
内核模块的特点：
- 模块本身不被编译入内核映像，这控制了内核的大小。
- 模块一旦被加载，它就和内核中的其它部分完全一样。
2.2 内核模块
内核模块编译后会得到一个 .ko 的 ELF 文件。（ELF 文件可以百度一下，也可以参考野火的内核模块章节。）
ELF 文件：这类文件包含了代码和数据，可以被用来链接成可执行文件或共享目标文件，静态链接库也可以归为这一类。
2.2.1 内核模块参考例程
必须内容可分为以下几点：
- 入口函数：当通过insmod或modprobe命令加载内核模块时，模块的加载函数就会自动被内核执行，完成本模块相关的初始化工作。
- 出口函数：执行rmmod命令卸载模块时，模块卸载函数就会自动被内核自动执行，完成相关清理工作。
- 协议：许可证声明描述内核模块的许可权限，如果模块不声明，模块被加载时，将会有内核被污染的警告。
非必须内容：
- 模块参数：模块参数是模块被加载时，可以传值给模块中的参数。
- 模块导出符号： 模块可以导出准备好的变量或函数作为符号，以便其他内核模块调用。
- 模块的其他相关信息： 可以声明模块作者等信息。
hello_module.c
/** @file hello_module.c
* @brief 简要说明
* @details 详细说明
* @author lzm
* @date 2021-02-21 18:08:07
* @version v1.0
* @copyright Copyright By lizhuming, All Rights Reserved
*
**********************************************************
* @LOG 修改日志:
**********************************************************
*/
#include <linux/module.h>
#include <linux/init.h>
#include <linux/kernel.h>
// 入口函数：安装驱动时调用的函数
static int __init hello_init(void)
{
printk(KERN_EMERG "[ KERN_EMERG ] Hello Module Init
");
printk( "[ default ] Hello Module Init
");
return 0;
}
// 出口函数：卸载驱动时调用的函数
static void __exit hello_exit(void)
{
printk("[ default ] Hello Module Exit
");
}
module_init(hello_init);
module_exit(hello_exit);
//MODULE_LICENSE("GPL2");
MODULE_AUTHOR("embedfire ");
MODULE_DESCRIPTION("hello world module");
MODULE_ALIAS("test_module");
2.2.2 内核模块命令
insmod：插入模块：insmod+模块完整路径。
modprobe：插入模块，insmod具备同样的功能，同样可以将模块加载到内核中，除此以外modprobe还能检查模块之间的依赖关系， 并且按照顺序加载这些依赖，可以理解为按照顺序多次执行insmod。
depmod：创建模块依赖文件。modprobe是怎么知道一个给定模块所依赖的其他的模块呢？在这个过程中，depmod起到了决定性作用，当执行modprobe时， 它会在模块的安装目录下搜索module.dep文件，这是depmod创建的模块依赖关系的文件。
rmmod：删除模块：insmod+模块名称。
lsmod：查看所有模块。
modinfo：显示模块中的几个宏的定义。如协议、作者等等。
2.2.3 系统自动加载模块 **
让系统自动加载模块需要用到命令depmod和modprobe。
首先需要将我们想要自动加载的模块统一放到 /lib/modules/内核版本 目录下，内核版本使用 uname -r 查询；
其次使用depmod建立模块之间的依赖关系，命令 depmod -a ；
这个时候我们就可以在modules.dep中看到模块依赖关系，可以使用如下命令查看：
cat /lib/modules/内核版本/modules.dep | grep calculation
最后在/etc/modules加上我们自己的模块。
- 注意在该配置文件中，模块不写成.ko形式代表该模块与内核紧耦合，有些是系统必须要跟内核紧耦合，比如mm子系统， 一般写成.ko形式比较好，如果出现错误不会导致内核出现panic错误，如果集成到内核，出错了就会出现panic。
然后重启开发板，使用命令lsmod即可查看我们的模块开机就被加载到内核了。
2.2.4 导出符号
实际上，符号指的就是内核模块中使用 EXPORT_SYMBOL 声明的函数和变量。当模块被装入内核后，它所导出的符号都会记录在公共内核符号表中。可供给其它模块使用。
导出方法：
- 符号必须在模块文件的全局部分导出，不能在函数中使用。
- _GPL使得导出的模块只能被GPL许可的模块使用。
- 编译我们的模块时，这两个宏会被拓展为一个特殊变量的声明，存放在ELF文件中。 具体也就是存放在ELF文件的符号表中：
- st_name： 是符号名称在符号名称字符串表中的索引值；
- st_value： 是符号所在的内存地址；
- st_size： 是符号大小；
- st_info： 是符号类型和绑定信息；
- st_shndx： 表示符号所在section。
EXPORT_SYMBOL(name)
EXPORT_SYMBOL_GPL(name) // name为要导出的标志
调用方法(例子)：
extern int name;
2.2.5 模块参数
模块参数：模块参数是模块被加载时，可以传值给模块中的参数。
Linux内核提供一个宏来实现模块的参数传递：
#define module_param(name, type, perm) module_param_named(name, name, type, perm)
#define module_param_array(name, type, nump, perm) module_param_array_named(name, name, type, nump, perm)
- name： 我们定义的变量名；
- type：参数的类型，目前内核支持的参数类型有byte，short，ushort，int，uint，long，ulong，charp，bool，invbool。其中charp表示的是字符指针，bool是布尔类型，其值只能为0或者是1；invbool是反布尔类型，其值也是只能取0或者是1，但是true值表示0，false表示1。变量是char类型时，传参只能是byte，char * 时只能是charp。
- perm：表示的是该文件的权限，具体参数值见下表：
| 对应用户 | 字符 | 说明 |
|---|---|---|
| 当前用户 | S_IRUSR | 用户具有读权限 |
| 当前用户 | S_IWUSR | 用户具有写权限 |
| 当前用户组 | S_IRGRP | 当前用户组的其它用户拥有读权限 |
| 当前用户组 | S_IWGRP | 当前用户组的其它用户拥有写权限 |
| 其它用户 | S_IROTH | 其它用户具有读权限 |
| 其它用户 | S_IWOTH | 其它用户具有写权限 |
模块参数使用示例
模块源码：
static int nameA=0;
module_param(nameA,int,0);
static bool nameB=0;
module_param(nameB,bool,0644);
加载模块后，会在路径 /sys/module/模块名/parameters 下存在以模块参数为名的文件。（注：若文件权限为0，则无法查看该文件，也不会显示在该路径）