CANN 9.1.1 发布说明深度解读:版本配套矩阵、子包独立升级与废弃特性迁移指南

原创2026-10-02 09:15:092,188 阅读
文章标签:文档CANN

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

从该矩阵可以提炼出两个关键事实:

  1. 9.1.x 系列的最低驱动门槛是 25.2.X。若你的环境仍停留在 25.0.X 驱动,则无法升级到 CANN 9.1.x,需要先升级驱动;
  2. 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.h
  • es_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 版本修复(本版本核心增量)

  1. 修复 Atlas A2、Atlas A3 系列产品及 Ascend 950 系列 NPU 的 MM 算子经 GE aclnn fallback 回调路径执行时,HF32 属性未正确传递至底层导致的性能不达预期问题;
  2. 修复 Atlas A2、Atlas A3 系列产品 RmsNorm 算子在输入 shape 超过 int32 最大值时的精度误差问题;
  3. 修复 Atlas A2、Atlas A3 系列产品 Matmul 算子融合通路转 MatmulV2 场景下 _deterministic_level 属性未继承、导致后续节点属性丢失的问题;
  4. 修复 Atlas A2、Atlas A3 系列产品 Matmul 算子 host 端性能劣化场景下,FSDP 通信与计算细粒度流水受阻、导致模型整体性能下降的问题;
  5. 修复 FAG 算子在 EOD 场景下偶现清空 pad 不完整的问题;
  6. 修复 Atlas A3 系列产品 aclgraph AICPU 展开中 HCCL 主流与 capture 主流为同一条 stream 时,orderStream 图规则校验失败的问题;
  7. 修复 Atlas A3 系列产品 AllGatherRingConcurrentDirect 算法在大集群规模下主/从流任务下发死锁的问题;
  8. 修复 Atlas A2、Atlas A3 系列产品导入非主线版本环境变量时,RingMLAOperation 接口 demo 运行失败的问题;
  9. 修复 Atlas A2、Atlas A3 系列产品 torch_npu.npu_format_cast 接口在 format 与 shape 不匹配场景下由拦截 fallback 到 aclop 的问题;
  10. (不兼容变更) 修复 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 一并追溯的既有修复)

  1. 修复 QuantBatchMatmulV3 算子在 Atlas 推理系列产品上编译时指定 AUTO_SYNC=false 导致的读写冲突问题;
  2. 修复 Atlas A2、Atlas A3 系列产品 MatmulReduceScatterV2 算子在 M 小于 512 场景下 flag 位清零过快、导致其他卡检测不到而超时的问题;
  3. 修复 Atlas A2 系列产品 MoE EP 场景下 D 节点注入片上内存多 bit 故障后无法进入快速恢复流程的问题;
  4. 修复 4k 卡训练任务在 500+ step 后随机 step 位置概率性出现通信超时的问题;
  5. 修复 PD 分离场景下 decode 频繁任务中断重启导致的 refill 积压问题;
  6. 修复开源仓用户自定义算子与内置算子 IR 原型重名不生效的问题;
  7. 修复 aclnnAddmv 算子压测偶现 coredump 的问题;
  8. 修复万卡任务拉起时异常报错的问题;
  9. 修复 aclgraph 场景特定 shape 下 MatMulV3 性能比 MatMulV2 差的问题;
  10. 修复 fused_quant_mat_mul 场景存在的精度问题;
  11. 修复 BatchMatmulV2 在特定 bias 场景下存在的精度问题;
  12. 修复 FAG 算子短序列 GQA、NoMask 场景存在的精度问题。

八、版本升级与迁移的行动清单

综合以上发布说明,面向生产环境的升级可遵循以下顺序执行:

  1. 核对驱动:确认当前驱动版本不低于 25.2.X(9.1.x 系列门槛),并按配套表升级到 26.1.1 以匹配 CANN 9.1.1;
  2. 规划子包升级:若仅需算子能力更新,可利用 ops 与 Toolkit 解耦特性,按需独立升级 math/nn/cv/transformer/hccl/hixl 六个子包之一,无需全量升级;
  3. 编译期迁移:将 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)相关引用;
  4. API 迁移:逐项执行 rt_* → aclrt_、FlashAttention 系列 → V4、GroupedMatmul 系列 → V5、DVPP 算子 IR → acldvpp 接口的替换;对标注"无可替换功能"或"后续不提供"的接口,需重构业务逻辑而非简单改名;
  5. 回归验证:重点关注本版本修复涉及的算子与场景——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 的转换是升级工作的重点。建议生产环境在升级前完成驱动版本核对、废弃接口清理与关键算子场景回归,确保版本切换平滑可控。

登录后查看全文
release-management