OK3506 开发板内核模块编译与加载

一、前言

在嵌入式 Linux 系统开发中，内核模块（Kernel Module） 是一种可动态加载到内核中的驱动或功能扩展，不需要重新编译整个内核。

本文将以 OK3506 开发板为例，介绍如何在 Ubuntu 虚拟机中使用提供的交叉编译工具链编译一个简单的 hello.ko 内核模块，并将其加载到开发板中运行。

注意：我已经实现在宿主机上完整的编译过一次内核！！！

二、环境准备

1️⃣ 主机环境

• 系统 ：Ubuntu 64-bit（虚拟机环境）
• 内核源码路径 ：

/home/xiaozhou/Desktop/ok3506/OK3506_Linux_Source/kernel

• 交叉编译工具链路径 ：

/home/xiaozhou/Desktop/ok3506/OK3506_Linux_Source/prebuilts/gcc/linux-x86/arm/gcc-arm-10.3-2021.07-x86_64-arm-none-linux-gnueabihf/bin/

• 工具链前缀 ：

arm-none-linux-gnueabihf-

2️⃣ 开发板环境

• 设备 ：OK3506 ARM 板
• 系统 ：基于 Linux 的嵌入式系统
• 连接方式 ：SSH 或串口终端
• 模块加载权限 ：需要 root 权限

三、编译过程

1️⃣ 编写测试模块

在 Ubuntu 虚拟机中创建目录：

mkdir ~/Desktop/module_test
cd ~/Desktop/module_test

创建 hello.c：

#include <linux/init.h>
#include <linux/module.h>
#include <linux/kernel.h>

MODULE_LICENSE("GPL");
MODULE_AUTHOR("xiaozhou");
MODULE_DESCRIPTION("A simple Hello World module for OK3506");
MODULE_VERSION("1.0");

static int __init hello_init(void)
{
    printk(KERN_INFO "Hello, world! Kernel module loaded.\\\\\\\\\\\\\\\\n");
    return 0;
}

static void __exit hello_exit(void)
{
    printk(KERN_INFO "Goodbye, world! Kernel module unloaded.\\\\\\\\\\\\\\\\n");
}

module_init(hello_init);
module_exit(hello_exit);

创建 Makefile：

obj-m := hello.o

export CROSS_COMPILE=/home/xiaozhou/Desktop/ok3506/OK3506_Linux_Source/prebuilts/gcc/linux-x86/arm/gcc-arm-10.3-2021.07-x86_64-arm-none-linux-gnueabihf/bin/arm-none-linux-gnueabihf-
export ARCH=arm
export KERNEL_DIR=/home/xiaozhou/Desktop/ok3506/OK3506_Linux_Source/kernel

all:
	make -C $(KERNEL_DIR) M=$(PWD) ARCH=$(ARCH) CROSS_COMPILE=$(CROSS_COMPILE) modules

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

2️⃣ 开始编译

执行命令：

make

若输出类似如下信息：

CC [M]  /home/xiaozhou/Desktop/module_test/hello.o
Building modules, stage 2.
MODPOST 1 modules
CC      /home/xiaozhou/Desktop/module_test/hello.mod.o
LD [M]  /home/xiaozhou/Desktop/module_test/hello.ko

表示编译成功，目录中会生成 hello.ko 文件。

四、在开发板上加载模块

1️⃣ 上传模块到开发板

假设开发板 IP 为 192.168.1.100，执行：

scp hello.ko root@192.168.1.100:/root/

⚠️ 注意：请确保开发板和主机在同一网络，并已启用 SSH。这里最好上传到/tem上作为临时文件

2️⃣ 登录开发板

ssh root@192.168.1.100

3️⃣ 加载模块

在开发板上执行：

insmod /root/hello.ko

使用 dmesg 查看日志：

dmesg | tail

你会看到：

[  123.456789] Hello, world! Kernel module loaded.

4️⃣ 卸载模块

rmmod hello
dmesg | tail

输出：

[  130.987654] Goodbye, world! Kernel module unloaded.

五、常见问题

六、结果展示

• ✅ 成功生成 hello.ko 文件（内核模块）
• ✅ 成功加载到 OK3506 开发板
• ✅ dmesg 输出显示：
• 

  Hello, world! Kernel module loaded.
  Goodbye, world! Kernel module unloaded.
  

七、总结

本文完整演示了从交叉编译环境配置到内核模块编译、传输与加载的全过程。

掌握这一流程后，你可以进一步编写更复杂的驱动模块，访问硬件外设（如 I2C、GPIO、SPI 等），为嵌入式系统开发奠定基础。