Pull Request已成功合入, 合并人@CANN-robot
(感谢 GRJ_XIDUO 的贡献)变更摘要
本 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 索引正确申请空间。


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


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
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)


compile


| 🚀 CI 流水线已启动 |
|---|
| 📋 执行详情: 点击查看流水线 |


描述
修正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,检查通过。文档更新
更新以下文档:
类型标签