已开启
docs: 归档arch5162 API支持关系分析 #4491
docs: 归档arch5162 API支持关系分析 #4491
已开启
zhangpengpeng8创建于 13 天前
zhangpengpeng8成员
13 天前

Pull Request

描述

归档 arch5162 API 当前支持性结论,并给出 ACL-Runtime 支持关系矩阵和 Runtime provider 实施清单:

  1. baseline 展示单一支持状态。ACL 共 459 项:92 项支持、325 项不支持、42 项待确认;Runtime 共 165 项:16 项支持、149 项不支持。
  2. ACL-Runtime 矩阵包含 386 个已确认非 acltdt* ACL API、399 条 ACL -> Runtime 静态依赖边,以及公共 catalog 的 783 个 rt/rts API;rtDeinit 仅有 compact C 实现,不进入普通 arch5162 provider。
  3. 618 个 baseline 未列 Runtime API 中,108 个由支持 ACL/Runtime 调用链或单独确认结论判定为需要支持,508 个在未发现支持调用方后按默认不支持处理;rtDeviceSetLimitrtRegKernelLaunchFillFunc 单独确认为不支持,并接受 aclInit 对应扩展配置能力降级。
  4. 目标 provider 由 654 个 FEATURE_NOT_SUPPORT 生成强桩、3 个 SUCCESS_NOOP 生成强桩、1 个 VOID_NOOP 生成强桩、1 个 rtGetDevice arch5162 专用成功实现和 123 个真实实现组成,共 782 项。rtGetSocSpecrtGetTsMemType 均保持库上已有真实实现;rtDeinit 仅定义在 src/runtime_compact/feature/src/api.c,既不生成强桩,也不补普通 Runtime 真实实现。
  5. 实施清单列出 arch5162_unsupported_runtime_api.def 最终应包含的全部 658 个接口,按 catalog 模块拆为 21 个表格并使用连续序号 1-658,逐项标明清单动作、catalog 桩策略和原因。
  6. 目标清单包含 654 个保留强桩和 4 个新增强桩;另行汇总 11 个一致性分析已明确的已有强桩、24 个必须保持库上真实实现的接口、rtGetDevice 专用适配和 rtDeinit compact 排除项。
  7. 实施清单同时逐项列出 37 个 ACL 或产品边界适配候选,并列出外部组件、仅 C/compact、42 个待确认及无需 provider 调整的支持引用;一致性分析中的 174 个 acl/rt/rts API 标识均可在实施清单中定位。

本 PR 仅包含 4 份 Markdown 文档,不修改 Runtime 实现和 arch5162 产品强桩清单。

变更类型

关联的Issue

无。

如何测试

  1. 校验 baseline 状态统计为 ACL 92/325/42、Runtime 16/149
  2. 校验矩阵覆盖公共 catalog 的 783 个 Runtime API;其中 rtDeinit 仅有 compact C 实现且不进入普通 arch5162 provider,另有 4 个不进入公共 catalog 的 compact Runtime 入口单列;矩阵不含复选框,仅风险项加粗。
  3. 校验 baseline 未列 Runtime API 的目标分组为 108 个需要支持、508 个默认不支持,以及 2 个单独确认不支持的 rtDeviceSetLimitrtRegKernelLaunchFillFunc
  4. 校验实施清单按 catalog 模块拆为 21 个标准 Markdown 表格,共 658 项,序号从 1 连续到 658,各分组内按接口名称字母序排列且全局无重复;每项均列出清单动作、catalog 桩策略和原因。
  5. 校验目标清单包含 654 个保留强桩和 4 个新增强桩;24 个保持真实实现的接口、rtGetDevicertDeinit 均不在目标强桩清单中。
  6. 校验普通 arch5162 provider 数量为 654 + 3 + 1 + 1 + 123 = 782rtGetTsMemTypertDeinit 均不在目标强桩清单中,且 rtDeinit 不计入真实 provider。
  7. 执行 git diff --check,无空白错误;对文档执行 pre-commit,OAT 检查通过。

核对清单

其他信息

  • 来源 README 提交:ed5ef652eff961bf4bddc2d4f040a744790d5e04
  • Runtime/主线分析基线:f03655875e9615f46bd73d87f920d6769447d8bb
  • 当前提交:c2468e130e7425360bbd31784113381e9ac6267b
likedislike
合并受阻
Zzhangpengpeng8成员
13 天前 创建了 pull request,commit 0a224164
atomgit-bot
atomgit-bot
13 天前 评论:

变更摘要

本 PR 属于纯文档更新(Markdown),用于归档 arch5162 的 API 支持性分析,并将接口支持矩阵从实现侧 PR 4486 中独立出来,不修改任何 Runtime 实现或 arch5162 产品强桩清单。文档汇总了参考 README 中 417 个已确认的 ACL API 及 467 条 ACL -> Runtime 静态依赖边,覆盖 Runtime 仓 787 个 rt/rts API,并对 README 未列出的 622 个接口统一标记为"默认不支持",同时标注 arch5162 当前 436 个强桩与 351 个保留实现,跨层矛盾、功能降级及目标状态未落地项以加粗方式呈现。此外,文档单独保留了 42 个待确认 ACL API,以及 Dump、Profiling 的产品能力确认边界,明确了支持矩阵的确认范围。

主要改动

  • 支持矩阵独立归档: 将 arch5162 接口支持矩阵从实现侧 PR 4486 中分离出来,以独立 Markdown 文档归档 API 支持关系分析,供后续核对与追溯。
  • 覆盖范围与默认策略标记: 汇总参考 README 中 417 个已确认 ACL API 与 467 条 ACL -> Runtime 静态依赖边,并对 README 未列出的 622 个 rt/rts 接口统一标记为"默认不支持"。
  • 强桩与保留实现标注: 对 arch5162 当前的 436 个强桩和 351 个保留实现进行标注,并对跨层矛盾、功能降级及目标状态未落地项加粗展示,突出未达标项。
  • 待确认与能力边界保留: 单独保留 42 个待确认 ACL API,以及 Dump、Profiling 的产品能力确认边界,避免将其纳入默认支持/不支持结论。
likedislike
不准确?
atomgit-bot
atomgit-bot
13 天前 评论:

🤖 本次改动均为数据 / 生成 / 二进制文件(如测试用例、锁文件、媒体资源),没有可审查的代码逻辑,已跳过 AI 代码审查。

likedislike
不准确?
CANN-robotCANN-robot成员
13 天前 添加了label:cann-cla/yes
CANN-robot
CANN-robot成员
13 天前 评论:

Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
For more, you also can visit HICANN.


PR Approval Progress

⚠️ This PR does not yet meet the following requirements:lgtm (requires ≥ 2 person(s) per module)、approve (requires ≥ 1 person(s) per module)

Module Approval Details

module lgtm status approve status
docs ❌ (0/2)(You can also ask: 卢煜坤, 侯延保, Reyn52166, yanmingxiang, 王涛) ❌ (0/1)(You can also ask: 张子菁, 卢煜坤, 侯延保, 王涛)

💡 Tip:

  • Committer can comment /approve or /lgtm
  • Commenting /approve implies both code review (lgtm) and intent to merge (approve)

CLA Signature Pass

zhangpengpeng8, thanks for your pull request. All authors of the commits have signed the CLA. 👍

likedislike
此处折叠了148条消息 查看更多
Zzhangpengpeng8成员
11 天前 推送  2 个提交:2e01565c-docs: remove implementation PR references,c2468e13-docs: refresh arch5162 analysis link
Zzhangpengpeng8成员
11 天前 update merge request[project id: 8810053, iid: 4491, commit_id: 1c6b5e4e0d7a4e1fcc4a59c34066fd9450235bc5] virtual merging success
CANN-robotCANN-robot成员
11 天前 删除了label:cann-cla/yes
CANN-robotCANN-robot成员
11 天前 添加了label:cann-cla/yes
Zzhangpengpeng8成员
11 天前 修改了pull request 的描述