Difference between revisions of "Build drivers from source for rpi/zh"

Latest revision as of 07:47, 21 March 2026

English

本文主要参考资料为官方piOS编译方法。

我们提供了在树莓派上本地编译和在PC上交叉编译的方法。建议使用树莓派本地编译，这更简单，也更快捷。

1 树莓派本地编译

以下操作均在树莓派上进行。

以下以piOS 5.15.32为例：

1.1 编译环境准备

sudo apt install git bc bison flex libssl-dev make

1.2 下载本机piOS的内核头文件

sudo apt install raspberrypi-kernel-headers

1.3 下载veye驱动代码

git clone https://github.com/veyeimaging/raspberrypi_v4l2.git

1.4 确认自己的树莓派上的piOS版本：

$ uname -a

Linux raspberrypi 5.15.32-v8+ #1538 SMP PREEMPT Thu Mar 31 19:40:39 BST 2022 aarch64 GNU/Linux

1.5 编译驱动

进入对应目录并编译

cd ~/raspberrypi_v4l2/driver_source/cam_drv_src/rpi-5.15_all

make

完成。

1.6 编译dts

cd ~/raspberrypi_v4l2/driver_source/dts/rpi-5.15.y

./build_dtbo.sh

完成。

1.7 常见错误

1.7.1 找不到build目录

make[1]: *** /lib/modules/[version]/build: No such file or directory. Stop.

sudo apt install raspberrypi-kernel-headers只是简单地安装上可用的最新内核头文件。这不一定与当前你使用的piOS系统的内核匹配。

Raspbian维护者总是从存储库索引文件中删除旧的内核头文件。

解决方法：

1.7.1.1 1.升级piOS并重新编译。

sudo apt update

sudo apt full-upgrade

sudo apt install raspberrypi-kernel-headers

特别的，对于rpi4系列，32bit的PiOS升级到最新版本后会自动启用64-bit模式。但是raspberrypi-kernel-headers包中缺少v8+模式的build目录。

比如：

$ uname -a

Linux raspberrypi 6.1.21-v8+ #1642 SMP PREEMPT Mon Apr 3 17:24:16 BST 2023 aarch64 GNU/Linux

却没有/lib/modules/6.1.21-v8+/build目录。

此时可以在/boot/config.txt中添加arm_64bit=0然后重启，切换回32bit模式。

1.7.2 2. 安装对应的raspberrypi-kernel-header的deb包。

从这个链接中查找到对应当前的版本的deb安装包并安装。

tag请根据本机piOS版本与raspberrypi OS tags确定。

1.7.3 3. 使用rpi-source

使用rpi-source工具，它会设置好构建自己内核所需的一切（默认情况下是从当前运行的内核构建）。

2 安装编译后的驱动

编译完成后，就得到了指定版本的驱动和dtbo文件。

参考安装驱动步骤，

wget https://github.com/veyeimaging/raspberrypi_v4l2/releases/latest/download/raspberrypi_v4l2.tgz

tar -xzvf raspberrypi_v4l2.tgz

cd raspberrypi_v4l2/release/

mkdir driver_bin/$(uname -r)

将编译得到的驱动的驱动和dtbo放到此目录下。

然后执行安装命令即可。

chmod +x *

sudo ./install_driver.sh [camera module]

camera module：可以是veye327,csimx307,cssc132,veyecam2m,veye_mvcam等。

3 参考资料

树莓派的piOS编译方案：

https://www.raspberrypi.org/documentation/linux/kernel/building.md

4 本文修改记录

20260321

删除交叉编译的相关章节。

20230326

完善找不到build目录错误的处理方法。

20230326

增加找不到build目录错误的描述和处理方法。

20220424

增加在树莓派本地编译的支持方法。

20220411

独立成篇，增加MV系列的描述。

@@ Line 1: / Line 1: @@
 [[Build drivers from source for rpi|English]]
-<br />
+本文主要参考资料为[https://www.raspberrypi.org/documentation/linux/kernel/building.md 官方piOS编译方法]。
+我们提供了在树莓派上本地编译和在PC上交叉编译的方法。建议使用树莓派本地编译，这更简单，也更快捷。
+===树莓派本地编译===
+以下操作均在树莓派上进行。
+以下以piOS 5.15.32为例：
+====编译环境准备====
+<code>sudo apt install git bc bison flex libssl-dev make</code>
+====下载本机piOS的内核头文件====
+<code>sudo apt install raspberrypi-kernel-headers</code>
+====下载veye驱动代码====
+<code>git clone <nowiki>https://github.com/veyeimaging/raspberrypi_v4l2.git</nowiki></code>
+====确认自己的树莓派上的piOS版本：====
+<code>$ uname -a</code>
+<code>Linux raspberrypi 5.15.32-v8+ #1538 SMP PREEMPT Thu Mar 31 19:40:39 BST 2022 aarch64 GNU/Linux</code>
+====编译驱动====
+进入对应目录并编译
+<code>cd ~/raspberrypi_v4l2/driver_source/cam_drv_src/rpi-5.15_all</code>
+<code>make</code>
+完成。
+====编译dts====
+<code>cd ~/raspberrypi_v4l2/driver_source/dts/rpi-5.15.y</code>
+<code>./build_dtbo.sh</code>
+完成。
+====常见错误====
+=====找不到build目录=====
+<code>make[1]: *** /lib/modules/[version]/build: No such file or directory. Stop.</code>
+<code>sudo apt install raspberrypi-kernel-headers</code>只是简单地安装上可用的最新内核头文件。这不一定与当前你使用的piOS系统的内核匹配。
+Raspbian维护者总是从存储库索引文件中删除旧的内核头文件。
+解决方法：
+======1.升级piOS并重新编译。======
+<code>sudo apt update</code>
+<code>sudo apt full-upgrade</code>
+<code>sudo apt install raspberrypi-kernel-headers</code>
+'''特别的'''，对于rpi4系列，32bit的PiOS升级到最新版本后会自动启用64-bit模式。但是<code>raspberrypi-kernel-headers</code>包中缺少v8+模式的build目录。
+比如：
+<code>$ uname -a</code>
+<code>Linux raspberrypi 6.1.21-v8+ #1642 SMP PREEMPT Mon Apr  3 17:24:16 BST 2023 aarch64 GNU/Linux</code>
+却没有<code>/lib/modules/6.1.21-v8+/build</code>目录。
+此时可以在/boot/config.txt中添加<code>arm_64bit=0</code>然后重启，切换回32bit模式。
+=====2. 安装对应的raspberrypi-kernel-header的deb包。=====
+从这个[https://archive.raspberrypi.org/debian/pool/main/r/raspberrypi-firmware/ 链接]中查找到对应当前的版本的deb安装包并安装。
+tag请根据本机piOS版本与raspberrypi OS [https://github.com/raspberrypi/linux/tags tags]确定。
+=====3. 使用rpi-source=====
+使用[https://github.com/RPi-Distro/rpi-source rpi-source]工具，它会设置好构建自己内核所需的一切（默认情况下是从当前运行的内核构建）。
+===安装编译后的驱动===
+编译完成后，就得到了指定版本的驱动和dtbo文件。
+参考[[V4L2 mode for Raspberry Pi/zh#.E9.A9.B1.E5.8A.A8.E5.AE.89.E8.A3.85|安装驱动步骤]]，
+<code>wget <nowiki>https://github.com/veyeimaging/raspberrypi_v4l2/releases/latest/download/raspberrypi_v4l2.tgz</nowiki></code>
+<code>tar -xzvf raspberrypi_v4l2.tgz</code>
+<code>cd raspberrypi_v4l2/release/</code>
+<code>mkdir driver_bin/$(uname -r)</code>
+将编译得到的驱动的驱动和dtbo放到此目录下。
+然后执行安装命令即可。
+<code>chmod +x *</code>
+<code>sudo ./install_driver.sh [camera module]</code>
+camera module：可以是veye327,csimx307,cssc132,veyecam2m,veye_mvcam等。
+===参考资料===
+*树莓派的piOS编译方案：
+https://www.raspberrypi.org/documentation/linux/kernel/building.md
+===本文修改记录===
+* 20260321
+删除交叉编译的相关章节。
+*20230326
+完善'''找不到build目录'''错误的处理方法。
+*20230326
+增加'''找不到build目录'''错误的描述和处理方法。
+*20220424
+增加在树莓派本地编译的支持方法。
+*20220411
+独立成篇，增加MV系列的描述。<br />