已合并
修正核间同步gmWorkspace空间说明 #6616
修正核间同步gmWorkspace空间说明 #6616
已合并
GRJ_XIDUO创建于 22 天前
GRJ_XIDUO
GRJ_XIDUO成员
22 天前

描述

修正IBSet和IBWait文档中关于gmWorkspace空间申请的约束说明。issue1822涉及原说明只给出简化公式,未明确eventStride、eventID和blockIdx之间的取值关系,容易导致用户在多事件同步或MIX模式下误算gmWorkspace空间大小。

补充gmWorkspace空间计算公式、eventStride取值规则,以及AIVOnly模式下多事件同步场景的计算示例,帮助用户按同步事件和逻辑AIV索引正确申请空间。

关联的Issue

https://gitcode.com/cann/asc-devkit/issues/1822

测试

已执行git diff --check,检查通过。

文档更新

更新以下文档:

  • docs/zh/api/SIMD-API/basic_api/sync_control/inter_core_sync/IBSet.md
  • docs/zh/api/SIMD-API/basic_api/sync_control/inter_core_sync/IBWait.md

类型标签

likedislike
Pull Request已成功合入, 合并人@CANN-robot
(感谢 GRJ_XIDUO 的贡献)
GRJ_XIDUOGRJ_XIDUO成员
22 天前 创建了 pull request,commit cd0994ba
GRJ_XIDUOGRJ_XIDUO成员
22 天前 关联了issue:[Documentation|文档反馈]: IBSet 的约束描述不清晰
atomgit-bot
atomgit-bot
22 天前 评论:

变更摘要

本 PR 为文档更新,修正 IBSet 与 IBWait 两个接口文档中关于 gmWorkspace 空间申请的约束说明(对应 issue 1822),并同步 docs/zh/api/SIMD-API/basic_api/sync_control/inter_core_sync/IBSet.md、docs/zh/api/SIMD-API/basic_api/sync_control/inter_core_sync/IBWait.md 两个文件。原说明仅给出简化公式,未明确 eventStride、eventID 与 blockIdx 之间的取值关系,容易导致用户在多事件同步或 MIX 模式下误算 gmWorkspace 空间大小。本次参考 PR6590 中已确认的说明,补充 gmWorkspace 空间计算公式、eventStride 取值规则,以及 AIVOnly 模式下多事件同步场景的计算示例,帮助用户按同步事件和逻辑 AIV 索引正确申请空间。

主要改动

  • 补充 gmWorkspace 空间计算公式:在 IBSet、IBWait 文档中新增核间同步所需的 gmWorkspace 空间计算公式,替换原先只给出简化公式的说明。
  • 明确 eventStride 取值规则:补充 eventStride 的取值规则说明,明确其与同步事件数量/索引的关系。
  • 明确 eventID 与 blockIdx 的取值关系:说明核间同步场景下 eventID 与 blockIdx 之间的取值关系,避免用户自行推断出错。
  • 新增 AIVOnly 模式多事件同步计算示例:给出 AIVOnly 模式下多事件同步场景的空间计算示例,便于用户按同步事件和逻辑 AIV 索引正确申请空间。
likedislike
不准确?
atomgit-bot
atomgit-bot
22 天前 评论:

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

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

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

✅ Congratulations! All modules have met the lgtm and approve requirements.

Module Approval Details

module lgtm status approve status
docs ✅ munanhw, wuyang_hw (2/2) ✅ munanhw (1/1)

💡 Tip:

  • Committer can comment /approve or /lgtm
  • Commenting /approve implies both code review (lgtm) and intent to merge (approve)
likedislike
CANN-robot
CANN-robot成员
22 天前 评论:

CLA Signature Pass

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

likedislike
CANN-robotCANN-robot成员
22 天前 将zengjuan,zhanghao_0689,suqwe,wulinyu,kong0808,dengjing_aoe,YeZZzzz1,bluesky901,yangbinhua,zhudi22,chenyiyuan,xun_zhuge,XuebinYang,sjtulxh,bianque,houyuyang,Lycheeeee,YANXI_ZHAO,chentianyu19,shi_nanxiang,wuyang_hw,jiangxinyu3,munanhw,ai_xin,ascendhjh,hujiawen_kaven,wangxiaozhi,DragonBornHD84,louyuxuan,hyolee,yukangchen设为评审人
CANN-robotCANN-robot成员
22 天前 将bianque,munanhw,ai_xin,ascendhjh设为审查人
GRJ_XIDUO
GRJ_XIDUO成员
22 天前 评论:

compile

likedislike
GRJ_XIDUOGRJ_XIDUO成员
22 天前 预合并成功(commit_id: 7ea6d758616bc11aa6768e05e0067732e2092e44)
CANN-robot
CANN-robot成员
22 天前 评论:
🚀 CI 流水线已启动
📋 执行详情: 点击查看流水线
likedislike
CANN-robotCANN-robot成员
22 天前 添加了label:ci-pipeline-running
CANN-robotCANN-robot成员
22 天前 删除了label:ci-pipeline-running
CANN-robotCANN-robot成员
22 天前 添加了label:ci-pipeline-passed
munanhw成员
22 天前 评论:

/approve

likedislike
CANN-robotCANN-robot成员
22 天前 添加了label:approved
吴洋成员
21 天前 评论:

/lgtm

likedislike
CANN-robotCANN-robot成员
21 天前 添加了label:lgtm
CANN-robotCANN-robot成员
21 天前 合入了pull request
GRJ_XIDUOGRJ_XIDUO成员
21 天前 修改了pull request 的描述
GRJ_XIDUOGRJ_XIDUO成员
21 天前 删除了关联的issue:[Documentation|文档反馈]: IBSet 的约束描述不清晰