跳转至

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。