CANN 9.1.1 发布说明深度解读:版本配套矩阵、子包独立升级与废弃特性迁移指南
CANN 9.1.1 发布说明深度解读:版本配套矩阵、子包独立升级与废弃特性迁移指南
CANN 9.1.1 是 CANN 9.1.x 系列的重要补丁版本,本文基于 CANN release-management 仓库中的官方发布说明(9.1.1/release-notes_en.md),系统梳理该版本的驱动配套关系、CANN 与 Ascend HDK 的兼容矩阵、Toolkit/ops/NNAL 三大组合包及其子包的内部配套、独立升级策略,以及横跨运行时、图引擎、算子库、加速库、调试工具、维测能力与模型压缩工具七大模块的废弃特性迁移路径。读完本文,你将能够根据硬件形态准确选配 CANN 9.1.1 与驱动版本、按需独立升级算子子包,并掌握从旧版 rt_* 接口平滑迁移到新版 aclrt_* 接口的完整对照清单。
一、版本定位:9.1.1 在 CANN 版本序列中的角色
在 CANN 的发布节奏中,x.y.0 为主版本,x.y.1 为主版本后的补丁版本。从仓库目录结构(9.1.0/、9.1.1/、9.1.1/index_en.md)可以看到,9.1.1 与 9.1.0 同属 9.1.x 系列,9.1.1 聚焦于在 9.1.0 基础上修复算子精度、通信稳定性与图引擎规则校验等已知缺陷,并同步承接 9.1.0 宣布的废弃特性计划。
根据 9.1.1/release-plan.md 记录的发布计划,该版本走的是紧凑的补丁节奏:
| 阶段 | 开始时间 | 结束时间 |
|---|---|---|
| Collect feature | 2026/08/06 | 2026/08/13 |
| Develop | 2026/08/13 | 2026/08/18 |
| Build | 2026/08/18 | 2026/08/21 |
| Test round 1 | 2026/08/21 | 2026/08/26 |
| Test round 2 | 2026/08/26 | 2026/08/26 |
| QA report | 2026/08/26 | 2026/08/26 |
| Release | 2026/08/31 | 2026/08/31 |
从开发到发布仅约 3 周,印证了补丁版本"修复优先、快速收敛"的定位。仓库 README.md 同时说明,该仓库承担着统一 CANN 版本管控规范、明确发布全流程步骤与变更记录要求的职责,release notes 即其中"发布说明"部分的核心交付物。
二、版本下载地址与驱动配套
2.1 官方下载地址
CANN 9.1.1 可通过昇腾社区官方下载页获取:
https://www.hiascend.com/en/cann/download
2.2 版本配套关系
CANN 9.1.1 与驱动(Ascend HDK)的配套关系如下:
| CANN | 驱动版本(Ascend HDK) |
|---|---|
| 9.1.1 | 26.1.1 |
安装时务必保证驱动与 CANN 版本严格匹配:CANN 9.1.1 必须搭配 Ascend HDK 26.1.1,这是该版本在官方配套表中的唯一指定驱动版本。
三、版本兼容性矩阵:CANN 与 Ascend HDK 的横向对照
官方发布说明给出了 CANN 8.5.2、9.0.X、9.1.X 三个版本序列与六档驱动版本的完整兼容矩阵(Y 表示兼容,N 表示不兼容):
| CANN | 25.0.X | 25.2.X | 25.3.X | 25.5.X | 26.0.RC1/25.7.RC1 | 26.1.1 |
|---|---|---|---|---|---|---|
| 8.5.2 | Y | Y | Y | Y | Y | Y |
| 9.0.X | Y | Y | Y | Y | Y | Y |
| 9.1.X | N | Y | Y | Y | Y | Y |
从该矩阵可以提炼出两个关键事实:
- 9.1.x 系列的最低驱动门槛是 25.2.X。若你的环境仍停留在 25.0.X 驱动,则无法升级到 CANN 9.1.x,需要先升级驱动;
- CANN 8.5.2 与 9.0.X 的兼容面最宽,覆盖 25.0.X 到 26.1.1 的全部六档驱动,是向下兼容的稳定序列,适合旧驱动环境下的过渡部署。
四、CANN 软件包内部配套关系
4.1 三大组合包与子包全景
CANN 9.1.1 由三个组合包构成:
- Toolkit(工具链与开发套件,含 22 个子包)
- ops(算子包,含 10 个子包)
- NNAL(加速库,含 2 个子包)
完整的组合包与子包配套关系如下表(所有子包均支持 Arm/x86 两种架构):
| 组合包 | 子包名称 | 子包版本 | 架构 |
|---|---|---|---|
| Toolkit | ascendnpu-ir | 1.2.0 | Arm/x86 |
| Toolkit | cann-acl-extend | 9.1.1 | Arm/x86 |
| Toolkit | cann-aoe | 9.1.1 | Arm/x86 |
| Toolkit | cann-asc-devkit | 9.1.1 | Arm/x86 |
| Toolkit | cann-asc-tools | 9.1.1 | Arm/x86 |
| Toolkit | cann-bisheng-compiler | 9.1.1 | Arm/x86 |
| Toolkit | cann-dflow-executor | 9.1.1 | Arm/x86 |
| Toolkit | cann-ge-compiler | 9.1.1 | Arm/x86 |
| Toolkit | cann-ge-executor | 9.1.1 | Arm/x86 |
| Toolkit | cann-graph-autofusion | 9.1.1 | Arm/x86 |
| Toolkit | cann-hcomm | 9.1.1 | Arm/x86 |
| Toolkit | cann-metadef | 9.1.1 | Arm/x86 |
| Toolkit | cann-ncs | 9.1.1 | Arm/x86 |
| Toolkit | cann-npu-runtime | 9.1.1 | Arm/x86 |
| Toolkit | cann-oam-tools | 9.1.1 | Arm/x86 |
| Toolkit | cann-opbase | 9.1.1 | Arm/x86 |
| Toolkit | cann-tbe-tik | 9.1.1 | Arm/x86 |
| Toolkit | cann-simulator | 9.1.1 | Arm/x86 |
| Toolkit | cann-pto-isa | 9.1.1 | Arm/x86 |
| Toolkit | mindstudio-toolkit | 26.1.0 | Arm/x86 |
| Toolkit | pyACL | 9.1.1 | Arm/x86 |
| Toolkit | test-ops | 9.1.1 | Arm/x86 |
| ops | cann-dvpp | 9.1.1 | Arm/x86 |
| ops | cann-opbase | 9.1.1 | Arm/x86 |
| ops | ops-legacy | 9.1.1 | Arm/x86 |
| ops | cann-hccl | 9.1.1 | Arm/x86 |
| ops | cann-hixl | 9.1.1 | Arm/x86 |
| ops | ops-cv | 9.1.1 | Arm/x86 |
| ops | ops-math | 9.1.1 | Arm/x86 |
| ops | ops-nn | 9.1.1 | Arm/x86 |
| ops | ops-transformer | 9.1.1 | Arm/x86 |
| ops | ops-ras | 9.1.1 | Arm/x86 |
| NNAL | atb | 9.1.1 | Arm/x86 |
| NNAL | sip | 9.1.1 | Arm/x86 |
几点实用提示:
- 表格中绝大多数子包与 CANN 主版本号保持一致(9.1.1),仅
ascendnpu-ir(1.2.0)与mindstudio-toolkit(26.1.0)使用独立的版本号体系,升级时需留意这两个例外; - 带源码标签链接的子包均有对应的独立开源仓库与
v9.1.1标签,例如 ge、runtime、hccl、ops-nn 等,便于按组件追踪源码级变更。
4.2 CANN ops 包与 Toolkit 的解耦配套
自 CANN 8.5.x 起,算子包(ops)已与 Toolkit 解耦,支持独立安装与独立升级。官方配套关系如下:
| ops 版本 | 兼容的 Toolkit 版本 |
|---|---|
| ascend-cann-ops 9.1.1 | ascend-cann-toolkit 9.1.x / 9.0.x / 8.5.2 |
| ascend-cann-ops 9.0.0 | ascend-cann-toolkit 9.1.x / 9.0.x / 8.5.2 |
| ascend-cann-ops 8.5.2 | ascend-cann-toolkit 9.1.x / 9.0.x / 8.5.2 |
可见 ops 包具有显著的向下兼容特性:即使 Toolkit 升级到 9.1.x,旧的 ops 8.5.2 / 9.0.0 依然可以配套使用,这为分阶段升级(先升 Toolkit、后升算子)留出了弹性空间。
4.3 ops 组合包内可独立升级的子包
在 ops 组合包内,官方进一步开放了 6 个子包的独立升级能力,每个子包都有明确的源码标签与配套 CANN 版本范围:
| CANN 子包版本 | 版本源码标签 | 配套 CANN 版本 |
|---|---|---|
| cann-ops-math 9.1.1 | CANN 9.1.x / 9.0.x / 8.5.2 | |
| cann-ops-nn 9.1.1 | CANN 9.1.x / 9.0.x / 8.5.2 | |
| cann-ops-cv 9.1.1 | CANN 9.1.x / 9.0.x / 8.5.2 | |
| cann-ops-transformer 9.1.1 | CANN 9.1.x / 9.0.x / 8.5.2 | |
| cann-hccl 9.1.1 | CANN 9.1.x / 9.0.x / 8.5.2 | |
| cann-hixl 9.1.1 | CANN 9.1.x / 9.0.x / 8.5.2 |
这 6 个子包覆盖了数学算子(math)、神经网络算子(nn)、视觉算子(cv)、Transformer 专属算子(transformer)、集合通信(hccl)与底层通信库(hixl)。子包独立升级的具体操作步骤,请参考官方文档 Independent Subpackage Upgrade。
五、删除与废弃特性:七大模块的迁移路径全解
发布说明中对"删除"与"废弃"给出了严格定义:
- 删除特性:当前版本已删除的特性;
- 废弃特性:当前版本标记为废弃、将在未来版本下线的特性。
文中 ${install_path} 统一指代 CANN 软件安装路径。需要特别关注的是各废弃项的计划删除时间——2026.12.30 与 2027.3.30 之后是两个关键时间节点,存量代码应在此之前完成迁移。
5.1 运行时(Runtime):rt_* 接口向 aclrt_* 接口的大规模迁移
这是 9.1.1 版本中迁移工作量最大的部分,共分为两批废弃:
第一批(CANN 9.1.0 标记,计划 2027.6.30 之后删除):
| 废弃项 | 替换项 |
|---|---|
include/driver 目录头文件 |
pkg_inc/driver 目录 |
第二批(CANN 8.5.0 标记,计划 2026.12.30 之后删除),核心是头文件目录归一与 rt_* 接口向 aclrt_* 接口的映射:
| 废弃项 | 替换项 |
|---|---|
${install_path}/ascend-toolkit/latest/runtime/include/acl |
${install_path}/cann/include/acl |
${install_path}/ascend-toolkit/latest/runtime/include/aclnn |
${install_path}/cann/include/aclnn |
${install_path}/ascend-toolkit/latest/runtime/include/graph |
${install_path}/cann/include/graph |
${install_path}/cann/pkg_inc/runtime/runtime 目录下所有头文件 |
后续不提供相关功能 |
| rtGetC2cCtrlAddr(rt_ffts.h) | aclrtGetHardwareSyncAddr(aclrt.h) |
| rtFftsTaskLaunch、rtFftsTaskLaunchWithFlag(rt_ffts.h) | 后续不提供相关功能 |
| rtBindHostPid、rtUnbindHostPid、rtProfSetProSwitch、rtQueryProcessHostPid、rtGetDeviceIdByGeModelIdx、rtGetExceptionRegInfo、rtGetMaxModelNum、rtLabelGoto、rtLabelGotoEx、rtProfilerConfig、rtProfilerInit、rtProfilerTrace、rtProfilingCommandHandle、rtProfRegisterCtrlCallback、rtSetDeviceIdByGeModelIdx、rtSetExceptCallback、rtSetMsprofReporterCallback、rtSetProfDirEx、rtUnsetDeviceIdByGeModelIdx(rt_base.h) | 后续不提供相关功能 |
| rtGetBinaryDeviceBaseAddr(rt_base.h) | aclrtBinaryGetDevAddress |
| rtGetTaskIdAndStreamID(rt_base.h) | aclrtGetThreadLastTaskId + aclrtStreamGetId |
| rtLabelCreate、rtLabelCreateEx、rtLabelCreateExV2、rtLabelCreateV2(rt_base.h) | aclrtCreateLabel |
| rtLabelListCpy(rt_base.h) | aclrtCreateLabelList + aclrtDestroyLabelList |
| rtLabelSet(rt_base.h) | aclrtSetLabel |
| rtLabelSwitchByIndex(rt_base.h) | aclrtSwitchLabelByIndex |
| rtProfilerTraceEx(rt_base.h) | aclrtProfTrace |
| rtRegDeviceStateCallbackEx(rt_base.h) | aclrtRegDeviceStateCallback |
| rtRegTaskFailCallbackByModule(rt_base.h) | aclrtSetExceptionInfoCallback |
| rtSetIpcMemorySuperPodPid(rt_base.h) | aclrtIpcMemImportPidInterServer |
| rtSetIpcNotifySuperPodPid(rt_base.h) | aclrtNotifySetImportPidInterServer |
| rtSetTaskAbortCallBack(rt_base.h) | aclrtSetTaskAbortCallBack |
| rtSetTaskFailCallback(rt_base.h) | aclrtSetExceptionInfoCallback |
| rtStreamGetMode(rt_base.h) | aclrtGetStreamAttribute |
| rtStreamSetMode(rt_base.h) | aclrtSetStreamFailureMode + aclrtSetStreamOverflowSwitch |
| aclsysGetCANNVersion(acl.h) | aclsysGetVersionStr + aclsysGetVersionNum |
| libascendcl.so(ascend-toolkit/latest/lib64) | libacl_rt.so、libacl_mdl.so、libacl_op_executor.so(cann/lib64) |
迁移要点:
- 头文件路径归一到
${install_path}/cann/include/或pkg_inc/体系,编译期替换 include 路径即可,这是成本最低的一类迁移; - 带替代接口的 API 遵循"同名语义"原则(rtLabel* 系列 → aclrtLabel 系列、rtProfiler* 系列 → aclrtProf 系列),可逐项按上表替换;
- 标注"后续不提供相关功能"的 API(如 rtFftsTaskLaunch、rtProfilerInit 等)没有替代品,需要重构调用逻辑,务必在计划删除时间前完成改造。
5.2 图引擎(Graph Engine)
| 废弃目录 | 替换目录 |
|---|---|
${install_path}/ascend-toolkit/latest/runtime/include/graph |
${install_path}/cann/include/graph |
${install_path}/ascend-toolkit/latest/compiler/python/func2graph |
${install_path}/cann/x86_64-linux/python 目录下的 func2graph |
同时,自 Ascend 950 系列产品起,aclblas 与 aclop 接口不再推荐使用,后续版本将逐步废弃,官方建议迁移至对应的 aclnn 算子接口。这意味着面向 Ascend 950 的新开发应直接采用 aclnn 编程范式。
5.3 算子库(Operator Libraries)
本模块包含三类变更:
(1)不兼容变更:控制类算子 Identity、IdentityN、Rank、Shape、ShapeN 从 ops-nn 迁移至 ops-math。对应头文件与实现目录发生如下变更:
ops_proto_nn.h→ops_proto_math.hes_nn目录 →es_math目录
引用这些算子原型头文件的应用需要同步更新引用路径(关联合入 ops-math !2333 与 ops-nn !3995)。
(2)CANN 9.0.0 标记的废弃(计划 2027.3.30 之后删除),核心是 FlashAttention 系列与 Matmul-AllReduce 融合系列 API 的版本收敛:
| 废弃项 | 替换项 |
|---|---|
| aclnnGroupedMatMulAllReduce | aclnnMatmulAllReduce |
| aclnnGroupedMatmul / V2 / V3 / V4 | aclnnGroupedMatmulV5 |
| aclnnFusedInferAttentionScore / V2 / V3 | aclnnFusedInferAttentionScoreV4 |
| aclnnIncreFlashAttention / V2 / V3 | aclnnIncreFlashAttentionV4 |
| aclnnPromptFlashAttention / V2 | aclnnPromptFlashAttentionV3 |
| aclnnMlaProlog、aclnnMlaPrologV2WeightNz | aclnnMlaPrologV3WeightNz |
| aclnnMatmulAllReduceAddRmsNorm | aclnnMatmulAllReduce + aclnnAddRmsNorm |
| aclnnQuantMatmulAllReduceAddRmsNorm | aclnnQuantMatmulAllReduceV2 + aclnnAddRmsNorm |
| aclnnWeightQuantMatmulAllReduceAddRmsNorm | aclnnWeightQuantMatmulAllReduce + aclnnAddRmsNorm |
| aclnnInplaceQuantMatmulAllReduceAddRmsNorm | aclnnQuantMatmulAllReduceV2 + aclnnAddRmsNorm |
| aclnnInplaceMatmulAllReduceAddRmsNorm | aclnnMatmulAllReduce + aclnnAddRmsNorm |
| aclnnInplaceWeightQuantMatmulAllReduceAddRmsNorm | aclnnWeightQuantMatmulAllReduce + aclnnAddRmsNorm |
(3)CANN 8.5.0 标记的废弃(计划 2026.12.30 之后删除),同步包含算子组件包拆分带来的路径调整(表中 ${ops_project} 代表实际的 cv、math、nn、transformer、legacy):
| 废弃项 | 替换项 |
|---|---|
${install_path}/ascend-toolkit/latest/opp/built-in/op_proto/inc/*.h |
${install_path}/cann/opp/built-in/op_graph/inc/${ops_project}_ops_proto.h |
${install_path}/ascend-toolkit/latest/lib64/libopapi.so |
${install_path}/cann/lib64/libopapi_${ops_project}.so |
| aclnnGroupedMatMulAllReduce | 无可替换功能 |
| aclnnWeightQuantBatchMatmul | aclnnWeightQuantBatchMatmulV3 |
| aclnnQuantMatmul / V2 / V3 / V4 | aclnnQuantMatmulV5 |
| aclnnGroupedMatmul / V2 / V3 / V4 | aclnnGroupedMatmulV5 |
| aclnnIncreFlashAttentionV2 / V3 | aclnnIncreFlashAttentionV4 |
| aclnnPromptFlashAttentionV2 | aclnnPromptFlashAttentionV3 |
| aclnnFusedInferAttentionScoreV2 / V3 | aclnnFusedInferAttentionScoreV4 |
可以看出算子 API 的演进呈现出明确的"收敛版本号"规律:同一算子的历史分支(V2/V3/V4)统一收敛到 V4/V5 单一入口,融合算子(MatmulAllReduceAddRmsNorm 等)则拆分为基础算子的组合调用。升级存量代码时建议优先将 FlashAttention 类调用迁移到 V4、GroupedMatmul 类迁移到 V5。
5.4 加速库(Acceleration Libraries)
DVPP 加速能力相关的算子 IR 被成批废弃,替换为等价的 acldvpp* 显式 API:
- 整批废弃的 DVPP 算子 IR:Crop、CropAndResize、DecodeAndCropJpeg、DecodeJpeg、PadV3D、Resize、ResizeV2、ResizeBicubic、ResizeBilinearV2、ResizeNearestNeighborV2、ReverseV2、WarpPerspective、WarpAffineV2、AdjustContrast、AdjustHue、AdjustSaturation。
单项映射(均计划 2026.12.30 之后删除):
| 废弃项 | 替换项 |
|---|---|
| AdjustBrightness 算子 IR(image.h) | acldvppAdjustBrightness |
| AdjustBrightnessV2 算子 IR(image.h) | acldvppAdjustBrightness |
| AdjustContrastWithMean 算子 IR(image.h) | acldvppAdjustContrast |
| AdjustSaturationV2 算子 IR(image.h) | acldvppAdjustSaturation |
| GaussianBlur 算子 IR(image.h) | acldvppGaussianBlur |
| ImgCrop 算子 IR(image.h) | acldvppCrop |
| RgbToGrayscale 算子 IR(image.h) | acldvppRgbToGrayscale |
| Rotate 算子 IR(image.h) | acldvppRotate |
| CropAndResizeV2 算子 IR(image_ops.h) | acldvppCropAndResize |
| ImgToTensor 算子 IR(image_ops.h) | acldvppImgToTensor |
| NormalizeV2 算子 IR(image_ops.h) | acldvppNormalize |
对图像预处理链路(尤其是基于 image.h/image_ops.h 图模式 IR 的推理应用),建议直接改用 acldvpp 编程接口,以规避图模式 IR 下线带来的风险。
5.5 调试与分析工具(Debugging and Analysis Tools)
| 废弃项 | 替换项 |
|---|---|
Profiling 头文件 aprof_pub.h、prof_api.h、prof_common.h(ascend-toolkit/latest/include/experiment/msprof/toolchain) |
同名词头文件迁移至 ${install_path}/cann/pkg_inc/profiling |
仅为头文件路径迁移,编译期替换 include 路径即可。
5.6 维测能力(Diagnostics)
错误上报与日志接口统一收敛到新头文件:
| 废弃项 | 替换项 |
|---|---|
| Error Manager 头文件 error_manager.h | ${install_path}/cann/include/base/err_msg.h |
| REPORT_INNER_ERROR、REPORT_CALL_ERROR 接口 | REPORT_INNER_ERR_MSG |
| REPORT_INPUT_ERROR、REPORT_ENV_ERROR 接口 | REPORT_PREDEFINED_ERR_MSG |
| 日志头文件 slog.h(toolchain) | ${install_path}/cann/pkg_inc/base/dlog_pub.h |
| 日志头文件 alog_pub.h(base) | ${install_path}/cann/pkg_inc/base/dlog_pub.h |
| AlogCheckDebugLevel 接口(alog_pub.h) | CheckLogLevel 接口(dlog_pub.h) |
| AlogRecord 接口(alog_pub.h) | DlogRecord 接口,或 dlog_error、dlog_warn 等封装宏 |
5.7 模型压缩工具(Model Compression Toolkit)
以下特性在 CANN 9.0.0 被标记废弃,在当前版本已经删除:
- 非均匀量化(Non-uniform quantization)
- 自动混合精度(Automatic mixed precision)
- 近似校准(Approximate calibration)
- int4 量化感知训练(int4 QAT)
- amct_mindspore 的所有特性
如果你的业务依赖以上任一能力,需要在模型压缩方案上重新选型;特别是 amct_mindspore 的全部能力已下线,MindSpore 场景的量化压缩需要迁移到其他受支持的路径。
六、已知问题(Known Issues)
9.1.1 版本披露的已知问题仅一项,集中在量化算子精度显示:
- 问题现象:算子
aclnnMatmulCompressDequant的输入参数deqScale取值为inf/-inf时,其精度详情中显示inf或nan; - 引入版本:CANN 8.5.0;
- 缺陷影响:由特殊构造的测试用例触发,非新算子引入;实际量化场景中
deqScale不会出现-inf/inf取值,当前版本影响可控; - 规避方案:实际量化任务中无需特殊处理。
该问题的关键在于其触发条件依赖极端输入构造,不构成真实量化流水线的风险,但测试框架中若包含这类边界用例,需要知晓该显示现象。
七、已修复问题:两代版本的修复清单
7.1 9.1.1 版本修复(本版本核心增量)
- 修复 Atlas A2、Atlas A3 系列产品及 Ascend 950 系列 NPU 的 MM 算子经 GE aclnn fallback 回调路径执行时,HF32 属性未正确传递至底层导致的性能不达预期问题;
- 修复 Atlas A2、Atlas A3 系列产品 RmsNorm 算子在输入 shape 超过 int32 最大值时的精度误差问题;
- 修复 Atlas A2、Atlas A3 系列产品 Matmul 算子融合通路转 MatmulV2 场景下
_deterministic_level属性未继承、导致后续节点属性丢失的问题; - 修复 Atlas A2、Atlas A3 系列产品 Matmul 算子 host 端性能劣化场景下,FSDP 通信与计算细粒度流水受阻、导致模型整体性能下降的问题;
- 修复 FAG 算子在 EOD 场景下偶现清空 pad 不完整的问题;
- 修复 Atlas A3 系列产品 aclgraph AICPU 展开中 HCCL 主流与 capture 主流为同一条 stream 时,orderStream 图规则校验失败的问题;
- 修复 Atlas A3 系列产品 AllGatherRingConcurrentDirect 算法在大集群规模下主/从流任务下发死锁的问题;
- 修复 Atlas A2、Atlas A3 系列产品导入非主线版本环境变量时,RingMLAOperation 接口 demo 运行失败的问题;
- 修复 Atlas A2、Atlas A3 系列产品
torch_npu.npu_format_cast接口在 format 与 shape 不匹配场景下由拦截 fallback 到 aclop 的问题; - (不兼容变更) 修复 Atlas A2、Atlas A3 系列产品 SparseFlashMLA 算子 torch 接口参数默认值错误的问题(涉及
ori_mask_mode、cmp_mask_mode、ori_win_left、ori_win_right等参数)。
其中第 10 项标注为不兼容变更,涉及 SparseFlashMLA 的 torch 接口参数默认值调整,使用该算子的框架侧代码需要重新校验参数默认行为。
7.2 9.1.0 版本修复(随 9.1.1 一并追溯的既有修复)
- 修复 QuantBatchMatmulV3 算子在 Atlas 推理系列产品上编译时指定
AUTO_SYNC=false导致的读写冲突问题; - 修复 Atlas A2、Atlas A3 系列产品 MatmulReduceScatterV2 算子在 M 小于 512 场景下 flag 位清零过快、导致其他卡检测不到而超时的问题;
- 修复 Atlas A2 系列产品 MoE EP 场景下 D 节点注入片上内存多 bit 故障后无法进入快速恢复流程的问题;
- 修复 4k 卡训练任务在 500+ step 后随机 step 位置概率性出现通信超时的问题;
- 修复 PD 分离场景下 decode 频繁任务中断重启导致的 refill 积压问题;
- 修复开源仓用户自定义算子与内置算子 IR 原型重名不生效的问题;
- 修复 aclnnAddmv 算子压测偶现 coredump 的问题;
- 修复万卡任务拉起时异常报错的问题;
- 修复 aclgraph 场景特定 shape 下 MatMulV3 性能比 MatMulV2 差的问题;
- 修复 fused_quant_mat_mul 场景存在的精度问题;
- 修复 BatchMatmulV2 在特定 bias 场景下存在的精度问题;
- 修复 FAG 算子短序列 GQA、NoMask 场景存在的精度问题。
八、版本升级与迁移的行动清单
综合以上发布说明,面向生产环境的升级可遵循以下顺序执行:
- 核对驱动:确认当前驱动版本不低于 25.2.X(9.1.x 系列门槛),并按配套表升级到 26.1.1 以匹配 CANN 9.1.1;
- 规划子包升级:若仅需算子能力更新,可利用 ops 与 Toolkit 解耦特性,按需独立升级 math/nn/cv/transformer/hccl/hixl 六个子包之一,无需全量升级;
- 编译期迁移:将
ascend-toolkit/latest/runtime/include、opp/built-in/op_proto/inc等旧头文件引用切换到cann/include、cann/opp/built-in/op_graph/inc新路径,并同步替换日志(slog.h/alog_pub.h → dlog_pub.h)、错误上报(REPORT_* → REPORT_*_ERR_MSG)与 Profiling(→ cann/pkg_inc/profiling)相关引用; - API 迁移:逐项执行 rt_* → aclrt_、FlashAttention 系列 → V4、GroupedMatmul 系列 → V5、DVPP 算子 IR → acldvpp 接口的替换;对标注"无可替换功能"或"后续不提供"的接口,需重构业务逻辑而非简单改名;
- 回归验证:重点关注本版本修复涉及的算子与场景——MM/RmsNorm/Matmul 融合链路的 HF32 与确定性属性、FSDP 流水、FAG 的 EOD 与短序列 GQA、AllGatherRingConcurrentDirect 大集群、SparseFlashMLA 参数默认值(不兼容变更)等。
九、安全与漏洞管理
关于本版本开源及第三方软件漏洞的修复情况,发布说明统一指向官方 Fixed Vulnerabilities 清单,该清单随版本维护更新,是安全合规审查时核对漏洞状态的一手依据。
十、小结
CANN 9.1.1 作为 9.1.x 系列的补丁版本,其价值集中在三点:其一,以紧凑的发布节奏(release-plan.md 显示从特性收集到发布仅 3 周)快速收敛了 A2/A3 与 Ascend 950 平台上算子精度、通信死锁与图引擎校验等十余项缺陷;其二,延续了 ops 与 Toolkit 解耦的策略,为大规模集群提供了按子包独立升级的弹性;其三,通过两批废弃计划(2026.12.30 与 2027.3.30 为界)为存量代码划定了清晰的迁移窗口,其中运行时 rt_* 到 aclrt_* 的接口映射、FlashAttention/GroupedMatmul 的版本收敛以及 DVPP 算子 IR 到 acldvpp API 的转换是升级工作的重点。建议生产环境在升级前完成驱动版本核对、废弃接口清理与关键算子场景回归,确保版本切换平滑可控。