Tracking: IMX-Forge 后续路线任务追踪 / Roadmap Tasks

[Charliechen114514]

Tracking: IMX-Forge 后续路线任务追踪 / Roadmap Tasks

这个Issue将会是常青藤，因为我们将会持续的收到各种Feedback，目前这些是初稿，笔者计划是后续完成一个，更新一下这个Issue的需求，方便各位看看咱们到大版本成功发出时，可能需要做哪一些事情（当然会有subissue connect对应的PR，方便各位朋友追踪自己的需求）

关于路线讨论、项目定位与需求征集请见组织 Discussion：

• Discussion: 【意见征集】imx-forge 长期规划与社区需求收集

This issue tracks actionable roadmap tasks derived from the roadmap discussion above.
Please use the Discussion for general feedback, priority suggestions, and roadmap-level comments.
This issue is mainly used for task breakdown, progress tracking, and PR linking.

---

说明 / Notes

这个 Issue 不用于展开大段路线讨论，具体方向、优先级和需求建议请优先在 Discussion 中反馈。

这里主要用于：

• 拆分任务
• 标记优先级
• 关联 PR
• 跟踪进度
• 形成开发闭环

优先级不是最终承诺，会根据 Discussion 中的反馈和实际维护情况调整。

---

P0：系统工程主线闭环 / Main System Workflow

• Board bring-up quick start / 板子上手与硬件速查
• First boot and serial console checklist / 第一次上电与串口检查流程
• Boot mode and storage selection guide / 启动介质选择说明
• Safe flashing guide / 安全烧录教程
• Full build workflow from a clean clone / 从空仓库到完整构建的主线教程
• out/ directory explanation / out/ 目录结构说明
• BSP default build workflow / BSP 默认构建链路说明
• Mainline build verification workflow / mainline 构建验证链路说明
• Patch workflow guide / patch 工作流实战说明
• Common build failure troubleshooting / 常见构建失败排查说明

---

P0：Rootfs 与用户空间 / Rootfs and User Space

• BusyBox Rootfs extension guide / BusyBox Rootfs 扩展教程
• init process explanation / init 流程说明
• mdev, fstab, network and startup scripts / mdev、fstab、网络配置与启动脚本说明
• rootfs overlay guide / rootfs overlay 使用教程
• Kernel module deployment guide / 内核模块部署教程
• Auto-loading kernel modules at boot / 内核模块开机加载说明
• Firmware and third-party library deployment / 固件与第三方库部署说明
• NFS-based development workflow / NFS 开发流说明
• Rootfs mount failure troubleshooting / Rootfs 挂载失败排查

---

P1：应用开发与部署 / Application Development and Deployment

• C / CMake cross-compilation tutorial / C/CMake 交叉编译应用教程
• Minimal Qt application deployment / Qt 最小应用部署教程
• Qt touchscreen configuration / Qt 触摸屏配置说明
• Qt font and input device configuration / Qt 字体与输入设备配置说明
• Application deployment convention / 应用部署规范说明
• Deploying applications via rootfs overlay / 通过 rootfs overlay 部署应用
• Deploying applications via NFS / 通过 NFS 部署应用
• Board-side application debugging guide / 板端应用调试说明

---

P1：系统调试手册 / System Debugging Handbook

• U-Boot common issues / U-Boot 常见问题排查
• Serial console no-output troubleshooting / 串口无输出排查
• Network boot troubleshooting / 网络启动问题排查
• Kernel panic common issues / Kernel panic 常见问题排查
• DTB mismatch troubleshooting / DTB 不匹配问题排查
• Rootfs and init failure troubleshooting / Rootfs 与 init 失败排查
• NFS / TFTP troubleshooting / NFS / TFTP 常见问题排查
• Kernel module loading failure troubleshooting / 模块加载失败排查
• Serial log reading guide / 串口日志阅读路线
• How to submit useful debug logs / 如何提交有效的问题日志

---

P1：交叉调试与诊断 / Cross Debugging and Diagnostics

• gdbserver deployment guide / gdbserver 板端部署说明
• VSCode + GDB cross-debugging setup / VSCode + GDB 交叉调试配置
• Debugging shared libraries / 共享库调试说明
• strace basic usage / strace 基础使用
• Core dump debugging workflow / core dump 调试流程
• Basic logging workflow / 基础日志收集流程
• Basic performance inspection tools / 基础性能分析工具说明

---

P2：开发工作流与工具链 / Development Workflow and Tooling

• VSCode development workflow / VSCode 开发工作流说明
• WSL2 development notes / WSL2 开发注意事项
• Docker development workflow / Docker 开发环境说明
• Remote-SSH workflow / Remote-SSH 工作流说明
• clangd cross-compilation configuration / clangd 交叉编译配置说明
• tasks.json command templates / tasks.json 常用任务模板
• Host and board file synchronization workflow / 主机与板端文件同步流程
• Git workflow for third-party source patches / 第三方源码 patch 的 Git 工作流

---

P2：工具快捷索引 / Tool Quick Reference

• dd flashing guide / dd 烧录说明
• uuu basic usage / uuu 基础使用说明
• mkfs.* filesystem creation guide / mkfs.* 文件系统创建说明
• minicom usage / minicom 使用说明
• screen usage / screen 使用说明
• picocom usage / picocom 使用说明
• cpio initramfs packing guide / cpio initramfs 打包说明
• squashfs usage / squashfs 使用说明
• losetup and loop mount guide / losetup 与 loop 挂载说明
• tftp usage / tftp 使用说明
• nfs usage / nfs 使用说明
• scp / rsync deployment notes / scp / rsync 部署说明
• objdump, nm, readelf, file quick reference / ELF 工具快捷索引

---

P2：常见错误模式 / Common Error Patterns

• Shell scripts executed under Windows paths / 在 Windows 路径下执行 shell 脚本的问题
• CRLF and permission issues / 换行符与权限问题
• Docker permission issues / Docker 权限问题
• WSL2 filesystem performance issues / WSL2 文件系统性能问题
• Missing submodules / 忘记初始化 submodule
• Wrong cross-compilation toolchain / 使用错误交叉编译工具链
• Path with spaces or special characters / 路径包含空格或特殊字符
• Flashing the wrong disk / 写错磁盘问题
• Missing sync after flashing / 烧录后忘记 sync
• Wrong serial baud rate / 串口波特率错误
• Wrong U-Boot environment variables / U-Boot 环境变量错误
• DTB and kernel mismatch / DTB 与内核版本不匹配
• Missing runtime libraries on target / 板端缺少运行时库
• Qt missing fonts or plugins / Qt 缺少字体或插件

---

P3：参考资源索引 / Reference Index

• NXP official documentation index / NXP 官方文档索引
• i.MX6ULL reference manual links / i.MX6ULL 手册链接
• NXP Linux BSP links / NXP Linux BSP 链接
• U-Boot documentation links / U-Boot 文档索引
• Linux Kernel Documentation links / Linux Kernel Documentation 索引
• Device Tree documentation links / 设备树文档索引
• Buildroot documentation links / Buildroot 文档索引
• Yocto documentation links / Yocto 文档索引
• Qt documentation links / Qt 文档索引
• ARM GCC toolchain links / ARM GCC 工具链文档索引
• Community and forum links / 社区与论坛索引

---

P3：小项目迭代 / Small Project Iterations

• PROJ-001 MVP definition: environment monitor / PROJ-001 环境监测站 MVP 定义
• PROJ-001 I2C sensor bring-up / PROJ-001 I2C 传感器接入
• PROJ-001 Qt local display / PROJ-001 Qt 本地显示
• PROJ-001 deployment guide / PROJ-001 部署说明
• PROJ-001 troubleshooting notes / PROJ-001 故障排查说明
• PROJ-002 MVP definition: image analyzer / PROJ-002 图像分析仪 MVP 定义
• PROJ-002 image capture demo / PROJ-002 图像采集样例
• PROJ-002 Qt image display / PROJ-002 Qt 图像显示
• Small project tutorial template / 小项目教程模板
• Small project deployment template / 小项目部署模板

---

P3：版本号与发布策略 / Versioning and Release Strategy

• Release versioning policy / release 版本号策略
• Distinguish roadmap numbers from release tags / 区分路线图编号与正式 release tag
• Docker tag policy / Docker tag 策略
• preview image policy / preview 镜像策略
• latest image policy / latest 镜像策略
• vX.Y.Z image policy / vX.Y.Z 镜像策略
• GitHub Release checklist / GitHub Release 检查清单
• CI artifact explanation / CI artifact 定位说明

---

如何参与 / How to Contribute

欢迎通过以下方式参与：

• 在 Discussion 中提出路线建议。
• 在本 Issue 下认领具体任务。
• 提交 PR 补充文档、脚本或示例。
• 提交新的 Issue 反馈具体问题。
• 补充开发板经验、调试记录或常见错误。
• 帮助翻译、润色或校对文档。

Contributions are welcome in many forms:

• roadmap suggestions
• documentation
• scripts
• examples
• board notes
• debugging records
• issue reports
• pull requests
• translation and proofreading

---

关联 / Links

• Roadmap Discussion: 【意见征集】imx-forge 长期规划与社区需求收集
• Related PRs: 还在开发中！
• Related Issues: 还在开发中！