摘要使用正确的 RK3588 defconfig 构建 Linux 6.1 kerneldeb并通过pipefail、日志和阶段化检查定位失败原因。适用对象已经准备好 LubanCat SDK、需要生成 Linux 6.1 内核 DEB 包的开发者。构建必须在开发主机执行。文章目录本篇要解决什么问题为什么不能只看最后一行“成功”一、选择正确的 defconfig二、检查关键配置三、构建 kerneldeb 并保存日志四、为什么采用 DEB五、定位失败位置六、把构建过程做成可追溯记录构建成功后再做产物级验收七、.config、defconfig 与最终产物的关系八、本文验收清单小结工作流实测截图专栏导航参考资料本篇要解决什么问题这一篇从“环境已经可用”进入真正的内核构建阶段。目标不是看到终端滚过大量编译日志而是得到一组可以安装、可以校验、可以回滚的 DEB 产物。整个过程可以拆成四个检查点阶段关键问题验证手段选择配置SDK 是否真的选择 RK3588 Linux 6.1defconfig 输出、kernel-6.1/.config内核配置PREEMPT_RT、CAN、YT6801 是否进入最终.configgrep CONFIG_...编译打包kerneldeb是否真正成功pipefail 退出码 完整日志产物验收DEB 中是否含内核、DTB、模块dpkg-deb -c、SHA256为什么不能只看最后一行“成功”带有tee的构建命令如果没有pipefail管道最后一个命令成功并不一定代表前面的构建程序成功。因此本文不仅保存日志还要求检查退出码和最终包内容。一、选择正确的 defconfig在 SDK 根目录执行SDK$HOME/lubancat/LubanCat_SDKcd$SDK./build.sh\rk3588:LubanCat_rk3588_ubuntu_linux6.1_gnome_defconfig芯片前缀rk3588:很重要。配置成功后SDK 会在output/.config中写入最终配置并选择kernel-6.1目录。二、检查关键配置grep-ECONFIG_PREEMPT_RT|CONFIG_CAN_GS_USB|CONFIG_NET_VENDOR_MOTORCOMM|CONFIG_FUXI\kernel-6.1/.config本次移植至少关注CONFIG_PREEMPT_RTy CONFIG_HZ_1000y CONFIG_CANy CONFIG_CAN_RAWy CONFIG_CAN_GS_USBm CONFIG_NET_VENDOR_MOTORCOMMy CONFIG_FUXImm表示编译成模块y表示编译进内核。配置文件中的项目必须被实际构建系统读取不能只修改一个未使用的.config。三、构建 kerneldeb 并保存日志set-opipefail ./build.sh kerneldeb21|teeoutput/kerneldeb-rt36.logset -o pipefail能让管道前面的构建失败正确传递到脚本退出码避免tee成功导致误判。构建完成后查看最后的错误tail-n100output/kerneldeb-rt36.log成功日志末尾应出现类似内容Running 10-kernel.sh - build_kerneldeb succeeded.还必须确认命令退出码为0。本次最终构建生成的是 revision-12linux-image-6.1.99-rt36-rk3588_6.1.99-rt36-rk3588-12_arm64.deb linux-headers-6.1.99-rt36-rk3588_6.1.99-rt36-rk3588-12_arm64.deb检查包元数据和关键文件image_deblinux-image-6.1.99-rt36-rk3588_6.1.99-rt36-rk3588-12_arm64.deb dpkg-deb-f$image_debPackage Version Architecture dpkg-deb-c$image_deb\|grep-Eboot/vmlinuz|rk3588-lubancat-5io\.dtb|gs_usb\.ko|yt6801\.kosha256sum$image_deb本次两个部署包的 SHA256 为d4141e0a4f7b93c0e1736232aef893c42e2987272158637c4fb3820e131901d7 linux-image-6.1.99-rt36-rk3588_6.1.99-rt36-rk3588-12_arm64.deb 3ee5fd9a8ebd8a11c1644aeea1d9c367b57545ed35b1871404b9687557e44f82 linux-headers-6.1.99-rt36-rk3588_6.1.99-rt36-rk3588-12_arm64.deb每次重新构建后都要重新计算哈希不能沿用本文数值。四、为什么采用 DEBDEB 可以由dpkg管理安装时自动生成 initramfs、写入模块目录并记录版本适合在多台相同设备上重复部署。不要直接把单个Image覆盖到启动分区后就认为升级完成这样容易遗漏模块、设备树或 initramfs。五、定位失败位置看到错误时先判断阶段Kconfig 阶段多为flex、bison或配置名问题内核编译阶段检查编译器、配置和具体源文件check-kernel.sh阶段检查lz4和压缩格式打包阶段检查 DEB 控制文件、模块安装路径和设备树布局。六、把构建过程做成可追溯记录建议每次正式构建都创建一个独立的日志和产物记录目录而不是只保留终端历史stamp$(date%Y%m%d-%H%M%S)record_diroutput/build-record-$stampmkdir-p$record_dircpkernel-6.1/.config$record_dir/kernel.config./build.shhelp$record_dir/build-help.txt21set-opipefail ./build.sh kerneldeb21|tee$record_dir/kerneldeb.logrc${PIPESTATUS[0]}echokerneldeb_exit$rc|tee$record_dir/result.txtexit$rc这里使用PIPESTATUS[0]直接读取管道中build.sh的退出状态。即使最终终端显示了tee的正常输出也不会把构建失败误判成成功。构建成功后再做产物级验收至少检查三个层面包元数据Package、Version、Architecture 是否正确关键文件kernel、DTB、gs_usb.ko、yt6801.ko是否进入最终包完整性对最终准备部署的 DEB 重新计算 SHA256。七、.config、defconfig 与最终产物的关系一个常见误区是“我明明改了配置为什么模块没有生成”。原因往往是修改的配置文件没有被当前构建入口真正读取。defconfig用于生成初始配置.config本次构建实际使用的展开配置CONFIG_xxxm/y只有进入当前.config并参与 Kbuild才会反映到最终产物。因此每次构建前、构建后都建议检查关键配置和包内容形成首尾闭环。八、本文验收清单使用了带rk3588:前缀的正确 defconfigCONFIG_PREEMPT_RTy、CAN、YT6801 配置进入实际.configkerneldeb退出码为 0保存了完整构建日志image/headers DEB 文件名明确不使用模糊通配符最终 DEB 中存在目标 DTB 和关键模块SHA256 已重新计算并记录。小结一次可靠构建必须同时保留配置命令、完整日志、SDK manifest 和最终 DEB。这样出现启动问题时才能把“源码问题”和“部署问题”分开。工作流实测截图图1PREEMPT_RT、HZ、SocketCAN 和 gs_usb 配置确认。图2内核 DEB 包构建末尾日志以该日志和生成文件作为构建成功判据。专栏导航专栏LubanCat RK3588 实时 Linux 开发实战第 4/13 篇上一篇LubanCat RK3588 实时 Linux 开发三SDK 环境准备与 flex、bison、LZ4 依赖排查下一篇LubanCat RK3588 实时 Linux 开发五如何确认 PREEMPT_RT 实时内核真正生效参考资料Linux Kconfig LanguageLinux Kbuild 文档Debian package tools: dpkg-deb文中的版本号、接口名、设备地址和测试数据均应以自己的板卡实测为准引用命令前请先确认当前 SDK、内核和启动布局。标签RK3588LubanCat SDKLinux 6.1内核编译kerneldeb