ACKNOWLEDGMENTS¶
A20OS 使用并参考了许多开源项目与公开标准。这里集中记录已知的集成、参考和待核实来源;它不对未完成的代码来源审计作“全部自主”或“未复制代码”的保证。
- 直接集成 / 构建的第三方项目(
user/external/、kernel/external/):包括普通 tracked tree 和 gitlink submodule,两者必须按各自许可证处理; - 实现参考与待核实来源:源码注释记录了部分移植/开发参考,但“参考”一词本身不能证明是否复制、改写或派生;
- 公开标准与规范:某些格式/协议由标准强制,任何实现都必须遵循。
许可证以普通 tracked tree 中的许可证文本或 gitlink 精确 revision 中的许可证为准;本列表供快速查阅,不替代这些原文。
1. 直接集成 / 构建的第三方项目¶
这些项目被构建系统直接消费,或可选地编译/安装进 A20OS 镜像;是否出现在某个具体镜像中取决于 profile 和构建目标。
| 项目 | 用途 | 许可证 | 位置 |
|---|---|---|---|
| musl | Linux ABI 用户态 libc | MIT | user/external/musl |
| mlibc | Native ABI libc 基础 | MIT | user/external/mlibc |
| uACPI | ACPI 表、AML namespace 与电源管理解释器 | MIT | kernel/external/uacpi |
| lwIP | 内核网络协议栈(NO_SYS=1) |
BSD-3-Clause | kernel/external/lwip |
| fastfetch | 系统信息工具 | MIT | user/external/apps/fastfetch |
上表是**仍由本仓库维护或编译**的核心第三方源码。默认基础用户态与 shell 工具链已统一由 BusyBox 提供;Alpine 上游包(vim、git、busybox、XFCE/Wayland/Mesa 栈等)由 apk 在组装镜像时拉取。
早期使用的独立工具集(mksh、sbase、TLSe)以及 vendored 项目(vim、git、zlib、binutils、musl-cross-make 等)已从源码树中彻底移除,其职责由 BusyBox 与 Alpine 官方包全面替代。
在仓库管理结构中,kernel/external/lwip 以及 user/external/{musl,mlibc} 是普通 tracked tree,不是 submodule。fastfetch 是 .gitmodules 中**唯一**登记的 gitlink。许可证结论必须针对普通树中跟踪的许可证文本,或针对该 gitlink 的精确 commit 核验,不能把整个 user/external/ 一概称为 submodule。
2. 实现参考与待核实来源¶
下表只记录源码注释或项目文档声称的参考关系,不证明代码是净室重写,也不解决派生作品或许可证义务。
| 参考项目 | 许可证 | 借鉴内容 | A20OS 中的对应方面 |
|---|---|---|---|
| Uinxed-Kernel | 当前源码注释称 Apache-2.0;精确 revision 未记录 | 当前源码注释归因的 USB BOT/SCSI 传输与 recovery 流程、ISO 9660 名字转小写/去 ;1 策略 |
USB Mass Storage、ISO 9660 |
| RocketOS | 未核实;当前 A20OS 源码注释称 MIT | VFS 设计启发;VisionFive 2 与 LS2K1000 的 board/GMAC bring-up 参考 | VFS、两个 board 文件与两个 GMAC 驱动;注释没有界定逐行来源 |
RocketOS 边界尚未解决:kernel/fs/vfs.c 写有设计启发说明,kernel/arch/<arch>/boards/{visionfive2,ls2k1000}/board.c 和 kernel/drivers/net/{starfive_gmac,ls2k_gmac}.c 写有 RocketOS porting/bring-up reference,但仓库没有记录所参考的精确 RocketOS revision、该 revision 的许可证文本、逐文件来源对照或单独授权。在取得这些证据前,不能把注释中的“MIT”、“inspired”或“reference”升级为已验证许可证,也不能断言相关文件未包含复制或改写代码。应对精确 revision 做 provenance/license 审计,或取得覆盖相关代码的单独授权。
两块物理板 bring-up 的硬件细节(JH7110 SYS_CRG 时钟偏移、YT8531 PHY、LS2K1000 GMAC0 基址 0x40040000 与 PCI 配置窗口 0xfe00001800 等)也参考了 RocketOS 的 StarFive drivers/net/starfive/ 与 la2000 drivers/net/la2000/ 驱动,并在 docs/zh/platforms/physical-boards.md 中逐项标注"未核实";该文档不等同于来源对照或授权记录。
2.1 新增板级移植的硬件事实来源¶
kernel/arch/<arch>/boards/{licheerv-nano,milk-v-duo,rk3328,sun50i-h616,x86_64-pc}/ 下各<board>_platform.h 中的每一个地址、尺寸、中断号与时钟频率,都逐项转录自上游公开设备树与文档,并在文件内就近标注了来源文件与 commit:
| 板 | 转录来源(Linux commit 551c722f40809618230001baccf219193e22fc5a) |
|---|---|
| LicheeRV Nano (SG2002) | arch/riscv/boot/dts/sophgo/{sg2002.dtsi,sg2000.dtsi,cv1800b.dtsi,cv180x.dtsi,cv181x.dtsi,cv180x-cpus.dtsi} |
| Milk-V Duo (CV1800B) | 同上(CV1800B 与 SG2002 共用 cv180x.dtsi 外设映射) |
| RK3328 | arch/arm64/boot/dts/rockchip/{rk3328.dtsi,rk3328-rock64.dts} |
| Allwinner H616/H618 | arch/arm64/boot/dts/allwinner/{sun50i-h616.dtsi,sun50i-h618-orangepi-zero3.dts,sun50i-h618-orangepi-zero2w.dts} |
另外还核对了以下上游事实,用于判断"哪些驱动可以复用"而不是抄写代码:
drivers/irqchip/irq-sifive-plic.c的of_device_id表里含thead,c900-plic,因此 SG2002、CV1800B 声明的 PLIC 走的是标准 SiFive 驱动,kernel/drivers/irqchip/plic.c得以直接复用。drivers/clk/sophgo/、include/dt-bindings/{clock/sophgo,cv1800.h,reset/*}提供了 CLK_UART0=77、CLK_APB_UART0=78、RST_UART0=23 等编号,用于判断"控制台 UART 的时钟由 U-Boot 打开、内核无需重配"这一结论。arch/*/boot/dts/*中的"snps,dw-apb-uart"与"arm,gic-400"compatible 字符串,用来确认 16550 串口与 GICv2 可直接复用既有实现。
以上均为**硬件事实的转录**(地址、编号、compatible 字符串),不含从上游内核搬运的代码;board.c 与 <board>_platform.h 是 A20OS 自己的实现。U-Boot 与 TF-A 的 mainline 支持情况(板级 defconfig 名称、TF-A 平台名、是否需要厂商 blob)依据各自的上游文档与 defconfig,同样只作为事实核对,未复制其代码。
各板移植文档中标注为 未核实 / UNVERIFIED 的字段(主要是 KERNEL_ENTRY 与PHYS_MEMORY_END),是当前无法从公开上游文档确定、必须上板读取的值。这些字段**不得**按上游默认值猜测填写。
3. 设计思路参考(design inspiration)¶
以下系统的公开机制被 A20OS 设计文档用作启发或对照,尤其涉及 Native ABI 与安全模型。本节只记录文档层面的关系,不作代码来源审计结论。
| 参考系统 | 启发内容 | A20OS 中的对应方面 |
|---|---|---|
| Microsoft Windows NT | 内核对象 / handle 统一资源模型:以句柄 + 安全权能管理所有内核对象,消灭各类资源的调用差异 | Native ABI 的 handle/capability 体系 |
| Zircon (Fuchsia) | Channel handle transfer 语义、futex 定位、ABI 版本管理对照 | Native ABI 的 Channel/Event 队列与 futex |
注意:Zircon、Windows NT 既是设计参考,也是研究文档中的**对照分析对象**(见下节),两者视角不同:"参考"指启发了设计,"对照"指作为比较基线分析优劣。
4. 研究对照系统(analysis objects)¶
docs/zh/research/ 系列文档在论证 A20OS 的设计时,将以下系统作为**对比/分析对象**:它们不是 A20OS 的代码或设计来源,而是用于评估 A20OS 特性(时态能力、混合信任边界、内核层 session type、ABI 版本化、委托模式等)的学术基线。
| 系统 | 对照内容 |
|---|---|
| Zircon (Fuchsia) | 能力系统、Channel 语义、syscall 版本化 |
| seL4 | 能力系统形式化、CSpace 撤销、Endpoint 无类型约束 |
| Capsicum | 混合信任边界、能力纪律 |
| CHERI | 硬件 capability、无硬件支持对比 |
| Redox | 能力内核对照 |
| S3K | 能力系统对照 |
| Mach | 微内核 IPC 对照 |
与 §2「实现参考」不同,当前文档只把本节项目列为学术比较基线,没有把它们登记为代码实现来源;这种分类本身不是完整 provenance 审计,也不能用来证明从未受其实现影响。
5. 公开标准与规范¶
以下格式/协议主要受公开标准约束,因此单列为规范来源。列在本节不能替代具体源码的 provenance 审计,也不自动解决派生作品判断:
- ISO 9660(CD-ROM 文件系统)— ECMA-119 / ISO 9660
- USB Bulk-Only Transport (BOT) — USB Implementers Forum, Mass Storage Class Bulk-Only Transport spec
- SCSI 命令集(READ(10)/WRITE(10)/READ CAPACITY(10)/INQUIRY)— SCSI Primary / Block Commands (SPC/SBC)
- TPM 2.0 / TIS / CRB — Trusted Computing Group (TCG) PC Client Platform TPM Profile
- Linux ABI / 系统调用约定 — 兼容层照搬 Linux 用户态 ABI 的编号与语义
- POSIX — 用户态 API 语义遵循 POSIX
6. 我们致谢的开源社区与平台¶
- OSDev Wiki:无数 OS 开发者的公共知识库。
- 所有上述第三方项目的维护者与贡献者。
本文件为致谢与出处说明,不替代任何第三方项目的原始 LICENSE。若您认为有遗漏或错误,欢迎提交 issue / PR。