CANN 9.2.0-beta.1 版本发布说明解读:组合包配套关系、FusedSgd 新增算子与废弃接口迁移指南

原创2026-10-02 10:00:211,874 阅读
文章标签:文档CANN

CANN 9.2.0-beta.1 版本发布说明解读:组合包配套关系、FusedSgd 新增算子与废弃接口迁移指南

CANN 9.2.0-beta.1 是昇腾 CANN 社区版 9.2.0 的首个 Beta 版本,本文基于仓库内的 release-notes.md 与 release-plan.md 整理,系统讲解该版本的三类组合包(Toolkit / 算子包 ops / 加速库 NNAL)及其 34 个子包的配套关系、6 个可独立升级子包的升级方式,并完整梳理新增的 FusedSgd 算子与横跨运行时、图引擎、算子库、加速库、调试工具和维测能力的全部废弃接口及对应迁移路径。读完本文,你将能够依据配套表完成版本选型与安装规划,并能对照迁移指引完成废弃接口的平滑替换。

版本定位与发布节奏

CANN 9.2.0-beta.1 属于 9.2.0 大版本在正式发布前的 Beta 验证版本。仓库根目录的 README.md 将该仓库定位为"CANN 版本发布管理仓库",用于统一版本管控规范、发布计划、Release Notes 与协作规则。对应版本的发布计划记录在 release-plan.md 中,其时间线如下:

阶段 开始时间 结束时间
Collect feature(特性收集) 2026/07/01 2026/07/05
Develop(开发) 2026/07/06 2026/07/18
Build(构建) 2026/07/19 2026/07/19
Test round 1(测试第 1 轮) 2026/07/20 2026/07/26
Test round 2(测试第 2 轮) 2026/07/27 2026/08/02
QA report(QA 报告) 2026/08/04 2026/08/04
Release(发布) 2026/08/10 2026/08/10

发布计划中还以特性清单(Feature list)形式记录了本版本的验收特性:Atlas A2 系列产品和 Atlas A3 系列产品新增适配 FusedSgd 算子,状态为 Accepted(已验收),归属 SIG 为 ops-nn。该特性与本版本 Release Notes 中"新增特性"一节的描述完全对应,说明本版本的核心新增能力即集中在 ops-nn 算子库的 FusedSgd 算子适配上。

版本配套说明:CANN 与 Ascend HDK 驱动配套

版本配套表定义了 CANN 与硬件驱动(Ascend HDK)的对应关系,是选包与部署的硬约束:

CANN 驱动版本(Ascend HDK)
9.2.0-beta.1 26.0.RC1

在部署 CANN 9.2.0-beta.1 前,必须先安装配套的 26.0.RC1 驱动(固件与驱动可经昇腾社区固件驱动页面按产品型号自动匹配后获取),驱动版本不一致可能导致运行时报错。CANN 软件包本体可从昇腾社区 CANN 下载页面获取。

CANN 软件包内部配套关系:三类组合包全景

CANN 9.2.0-beta.1 包含 Toolkit 包、算子包(ops)、加速库(NNAL) 三个组合包,下文完整列出组合包与子包的配套关系。需要说明的是:子包版本号一栏中,凡标注为 9.2.0-beta.1 且对应独立源码仓库的子包,其源码标签均为 v9.2.0-beta.1(如 cann/ge、cann/runtime、cann/opbase 等仓库的对应 tag),可据此获取与二进制一致的源码版本。

Toolkit 组合包(22 个子包)

子包名称 子包版本号 架构
ascendnpu-ir 1.2.0 arm/x86
cann-acl-extend 9.2.0-beta.1 arm/x86
cann-aoe 9.2.0-beta.1 arm/x86
cann-asc-devkit 9.2.0-beta.1 arm/x86
cann-asc-tools 9.2.0-beta.1 arm/x86
cann-bisheng-compiler 9.2.0-beta.1 arm/x86
cann-dflow-executor 9.2.0-beta.1 arm/x86
cann-ge-compiler 9.2.0-beta.1 arm/x86
cann-ge-executor 9.2.0-beta.1 arm/x86
cann-graph-autofusion 9.2.0-beta.1 arm/x86
cann-hcomm 9.2.0-beta.1 arm/x86
cann-metadef 9.2.0-beta.1 arm/x86
cann-ncs 9.2.0-beta.1 arm/x86
cann-npu-runtime 9.2.0-beta.1 arm/x86
cann-oam-tools 9.2.0-beta.1 arm/x86
cann-opbase 9.2.0-beta.1 arm/x86
cann-tbe-tik 9.2.0-beta.1 arm/x86
cann-simulator 9.2.0-beta.1 arm/x86
cann-pto-isa 9.2.0-beta.1 arm/x86
mindstudio-toolkit 26.1.0 arm/x86
pyACL 9.2.0-beta.1 arm/x86
test-ops 9.2.0-beta.1 arm/x86

从子包构成可以看出 Toolkit 组合包的分层设计:底层包含图引擎相关子包(cann-ge-compiler / cann-ge-executor / cann-dflow-executor)、运行时子包(cann-npu-runtime)、算子开发框架子包(cann-tbe-tik / cann-opbase / cann-pto-isa)、编译优化子包(cann-bisheng-compiler / cann-graph-autofusion / cann-aoe)、通信子包(cann-hcomm)、Python 接口层(pyACL)以及配套工具链(cann-asc-devkit / cann-asc-tools / cann-oam-tools / mindstudio-toolkit)。其中 ascendnpu-ir 使用独立版本号 1.2.0,mindstudio-toolkit 使用 26.1.0,其余子包均与 CANN 主版本保持一致。

算子包(ops)组合包(10 个子包)

子包名称 子包版本号 架构
cann-dvpp 9.2.0-beta.1 arm/x86
cann-opbase 9.2.0-beta.1 arm/x86
ops-legacy 9.2.0-beta.1 arm/x86
cann-hccl 9.2.0-beta.1 arm/x86
cann-hixl 9.2.0-beta.1 arm/x86
ops-cv 9.2.0-beta.1 arm/x86
ops-math 9.2.0-beta.1 arm/x86
ops-nn 9.2.0-beta.1 arm/x86
ops-transformer 9.2.0-beta.1 arm/x86
ops-ras 9.2.0-beta.1 arm/x86

算子包按领域拆分为多个独立组件包:cann-dvpp 提供媒体/图像预处理(DVPP)相关算子能力,ops-cv / ops-math / ops-nn / ops-transformer 分别承载计算机视觉、数学、神经网络与 Transformer 场景算子,ops-legacy 承载历史遗留算子,cann-hccl 与 cann-hixl 提供集合通信能力,cann-opbase 作为算子底座包统一承载算子公共组件。这种拆分方式与废弃特性一节中"算子被拆分成组件包"的描述一致——各独立组件包均包含多个对应的库和头文件。

加速库(NNAL)组合包(2 个子包)

子包名称 子包版本号 架构
atb(Ascend Transformer Boost) 9.2.0-beta.1 arm/x86
sip 9.2.0-beta.1 arm/x86

NNAL(加速库)组合包包含 atb 与 sip 两个子包:atb 即 Ascend Transformer Boost,面向 Transformer 大模型场景提供高性能算子封装;sip 提供上层加速接口。两者源码标签均为 v9.2.0-beta.1。

ops 与 Toolkit 的配套关系

算子包与 Toolkit 包必须配套安装,配套矩阵如下:

ops 版本 配套 toolkit 版本
ascend-cann-ops 9.2.0-beta.1 ascend-cann-toolkit 9.2.0-beta.1

即安装 ascend-cann-ops 时,必须使用相同版本号的 ascend-cann-toolkit,二者不可混用不同版本,否则算子编译与执行阶段可能出现符号或版本不匹配问题。

ops 组合包内可独立升级的子包

在满足与 Toolkit 整体配套的前提下,ops 组合包内以下 6 个子包支持独立升级(即仅替换该子包,无需重新安装整个 ops 包):

CANN 子包版本 版本源码标签 配套 CANN 版本
cann-ops-math 9.2.0-beta.1 v9.2.0-beta.1 CANN 9.2.0-beta.1
cann-ops-nn 9.2.0-beta.1 v9.2.0-beta.1 CANN 9.2.0-beta.1
cann-ops-cv 9.2.0-beta.1 v9.2.0-beta.1 CANN 9.2.0-beta.1
cann-ops-transformer 9.2.0-beta.1 v9.2.0-beta.1 CANN 9.2.0-beta.1
cann-hccl 9.2.0-beta.1 v9.2.0-beta.1 CANN 9.2.0-beta.1
cann-hixl 9.2.0-beta.1 v9.2.0-beta.1 CANN 9.2.0-beta.1

各子包二进制版本号、源码标签与配套 CANN 版本三者一一对应:例如需要独立升级 cann-ops-nn 时,应取源码标签 v9.2.0-beta.1 对应的包进行替换,并确保宿主 CANN 版本为 9.2.0-beta.1。子包独立升级的具体操作步骤(含安装命令与校验方法)请参照昇腾社区文档中"子包独立升级"章节执行。

关键特性

本版本配套发布了两个社区侧的辅助能力:

  • CANN 版本配套查询助手:昇腾社区上线了 CANN 版本配套查询助手,开发者可快速查询 CANN 与上下游软件(驱动、固件、框架等)的配套关系,避免人工核对版本矩阵。
  • 固件与驱动(HDK)快速安装页面:昇腾社区上线了固件与驱动快速安装页面,可自动匹配产品型号与软件包,降低开发者选择驱动包的复杂度。

这两个特性配合上文的全量配套表,构成了从"选 CANN 版本 → 查 HDK 驱动 → 选子包"的完整选包闭环。

新增特性:ops-nn 库适配 FusedSgd 算子

本版本在新增特性上聚焦于 ops-nn 库:

  • Atlas A2 训练系列产品 / Atlas A2 推理系列产品、Atlas A3 训练系列产品 / Atlas A3 推理系列产品新增适配 FusedSgd 算子。

对应改动来自 ops-nn 仓库的 PR 6220。结合 release-plan.md 的特性清单,该特性在发布计划中状态为 Accepted(已验收),归属 SIG 为 ops-nn。FusedSgd 将 Sgd(随机梯度下降)优化器的参数更新步骤融合为一个算子下发,减少多次算子调用的调度开销,适用于在 Atlas A2/A3 系列产品上使用 Sgd 优化器训练的场景。开发者在上述硬件平台上调用 Sgd 优化器时,可优先使用融合后的 FusedSgd 算子路径以获得更优的执行效率。

删除和废弃特性总览

本节列出 9.2.0-beta.1 中删除与废弃的全部内容。约定说明:

  • 删除特性:当前版本已删除的特性;
  • 废弃特性:当前版本标记为废弃、未来版本即将下线的特性;
  • 文中 ${install_path} 请替换为 CANN 软件实际安装路径。

废弃项按废弃标记时间分为多批次,时间节点覆盖 CANN 9.0.0(计划 2027.3.30 之后删除)、CANN 8.5.0(计划 2026.12.30 之后删除)与 CANN 9.1.0(计划 2027.6.30 之后删除)三个标记批次。所有标记为废弃的接口都应在当前版本完成迁移,以规避后续版本删除带来的编译失败风险。

运行时(Runtime)废弃项

第一批:CANN 9.1.0 中标记废弃,计划在 2027.6.30 之后的版本删除。

废弃的目录、文件和接口 替换的目录、文件和接口
include/driver 目录头文件 pkg_inc/driver 目录

第二批:CANN 8.5.0 中标记废弃,计划在 2026.12.30 之后的版本删除。

废弃的目录、文件和接口 替换的目录、文件和接口
${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 接口(原位于 toolkit/include/experiment/runtime/runtime/rt_ffts.h) 使用 cann/include/acl/aclrt.h 中的 aclrtGetHardwareSyncAddr 接口替换
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) 使用 cann/include/acl/aclrt.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 接口(原位于 latest/include/acl/acl.h) 使用 cann/include/acl/acl.h 中的 aclsysGetVersionStr 和 aclsysGetVersionNum 接口替换
libascendcl.so(原位于 ascend-toolkit/latest/lib64) 使用 cann/lib64 中的 libacl_rt.so、libacl_mdl.so、libacl_op_executor.so 库文件替换

可以看到,运行时废弃清单的主线是头文件目录收敛(从 ascend-toolkit/latest/runtime/include 迁往 cann/include)与rt 系列接口向 aclrt 系列接口迁移:原实验路径下的 rt_* 接口(标签控制、流模式、错误回调、Profiling 等)统一替换为 aclrt.h 中的对应公开接口,libascendcl.so 则由三个细分库替换。

图引擎废弃项

CANN 8.5.0 中标记废弃,计划在 2026.12.30 之后的版本删除。

废弃的目录 替换的目录
${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 算子接口。

算子库废弃项

第一批:CANN 9.0.0 中标记废弃,将在 2027.3.30 之后的版本删除。

废弃的接口 替换的接口
aclnnGroupedMatMulAllReduce aclnnMatmulAllReduce
aclnnGroupedMatmul、aclnnGroupedMatmulV2、aclnnGroupedMatmulV3、aclnnGroupedMatmulV4 aclnnGroupedMatmulV5
aclnnFusedInferAttentionScore、aclnnFusedInferAttentionScoreV2、aclnnFusedInferAttentionScoreV3 aclnnFusedInferAttentionScoreV4
aclnnIncreFlashAttention、aclnnIncreFlashAttentionV2、aclnnIncreFlashAttentionV3 aclnnIncreFlashAttentionV4
aclnnPromptFlashAttention、aclnnPromptFlashAttentionV2 aclnnPromptFlashAttentionV3
aclnnMlaProlog、aclnnMlaPrologV2WeightNz aclnnMlaPrologV3WeightNz
aclnnMatmulAllReduceAddRmsNorm aclnnMatmulAllReduce 和 aclnnAddRmsNorm
aclnnQuantMatmulAllReduceAddRmsNorm aclnnQuantMatmulAllReduceV2 和 aclnnAddRmsNorm
aclnnWeightQuantMatmulAllReduceAddRmsNorm aclnnWeightQuantMatmulAllReduce 和 aclnnAddRmsNorm
aclnnInplaceQuantMatmulAllReduceAddRmsNorm aclnnQuantMatmulAllReduceV2 和 aclnnAddRmsNorm
aclnnInplaceMatmulAllReduceAddRmsNorm aclnnMatmulAllReduce 和 aclnnAddRmsNorm
aclnnInplaceWeightQuantMatmulAllReduceAddRmsNorm aclnnWeightQuantMatmulAllReduce 和 aclnnAddRmsNorm

第二批: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 installpath/cann/opp/built−in/opgraph/inc/{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 接口 aclnnMatmulAllReduce 接口
aclnnWeightQuantBatchMatmul 接口 aclnnWeightQuantBatchMatmulV3 接口
aclnnQuantMatmul、aclnnQuantMatmulV2、aclnnQuantMatmulV3、aclnnQuantMatmulV4 接口 aclnnQuantMatmulV5 接口
aclnnGroupedMatmul、aclnnGroupedMatmulV2、aclnnGroupedMatmulV3、aclnnGroupedMatmulV4 接口 aclnnGroupedMatmulV5 接口
aclnnIncreFlashAttentionV2、aclnnIncreFlashAttentionV3 接口 aclnnIncreFlashAttentionV4 接口
aclnnPromptFlashAttentionV2 接口 aclnnPromptFlashAttentionV3 接口
aclnnFusedInferAttentionScoreV2、aclnnFusedInferAttentionScoreV3 接口 aclnnFusedInferAttentionScoreV4 接口

算子库废弃的主线清晰:多版本接口向单一最新版本收敛(V2/V3/V4 统一到 V5),复合接口拆分(如 MatmulAllReduceAddRmsNorm 拆为 MatmulAllReduce + AddRmsNorm 两个独立调用),以及**算子组件包化后头文件与动态库按 opsproject拆分∗∗(‘opproto/inc/∗.h‘→‘{ops_project} 拆分**(`op_proto/inc/*.h` → `{ops_project}ops_proto.h,libopapi.so→libopapi${ops_project}.so`)。Transformer 相关的 FlashAttention 系列接口迁移应重点核对:当前场景是否属于"非量化 decode"等新增泛化能力覆盖范围。

加速库废弃项

CANN 8.5.0 中标记废弃,将在 2026.12.30 之后的版本删除。

以下算子 IR 废弃使用的 DVPP 加速功能:Crop、CropAndResize、DecodeAndCropJpeg、DecodeJpeg、PadV3D、Resize、ResizeV2、ResizeBicubic、ResizeBilinearV2、ResizeNearestNeighborV2、ReverseV2、WarpPerspective、WarpAffineV2、AdjustContrast、AdjustHue、AdjustSaturation。

废弃的目录、文件和接口 替换的接口
AdjustBrightness 算子 IR(原位于 opp/built-in/op_proto/inc/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 接口

加速库废弃项表明:图像类算子的 IR 实现将整体迁往 DVPP 加速接口(acldvpp 系列)。此前依赖 image.h / image_ops.h 中算子 IR 完成图像处理逻辑的应用,应改为直接调用 acldvpp 接口以获得 DVPP 硬件加速;同时要注意 DVPP 加速功能对算子列表(Crop、Resize、WarpAffineV2 等 15 个算子)整体废弃,意味着这些算子的 IR 路径将不再提供加速能力。

调试与分析工具废弃项

CANN 8.5.0 中标记废弃,将在 2026.12.30 之后的版本删除。

废弃的目录、文件和接口 替换的目录、文件和接口
Profiling 头文件 aprof_pub.h、prof_api.h、prof_common.h(原位于 ascend-toolkit/latest/include/experiment/msprof/toolchain 路径) Profiling 头文件存放路径变更为 ${install_path}/cann/pkg_inc/profiling

维测能力废弃项

CANN 8.5.0 中标记废弃,将在 2026.12.30 之后的版本删除。

废弃的目录、文件和接口 替换的目录、文件和接口
Error Manager 头文件(原位于 include/experiment/metadef/common/util/error_manager/error_manager.h) Error Manager 头文件 ${install_path}/cann/include/base/err_msg.h
error_manager.h 中的 REPORT_INNER_ERROR 和 REPORT_CALL_ERROR 接口 REPORT_INNER_ERR_MSG 接口
REPORT_INPUT_ERROR、REPORT_ENV_ERROR 接口 REPORT_PREDEFINED_ERR_MSG 接口
日志头文件(原位于 include/toolchain/slog.h) 日志头文件 ${install_path}/cann/pkg_inc/base/dlog_pub.h
日志头文件(原位于 include/base/alog_pub.h) 日志头文件 ${install_path}/cann/pkg_inc/base/dlog_pub.h
alog_pub.h 中的 AlogCheckDebugLevel 接口 dlog_pub.h 中的 CheckLogLevel 接口
alog_pub.h 中的 AlogRecord 接口 dlog_pub.h 中的 DlogRecord 接口或封装的 dlog_error、dlog_warn 等宏

维测能力废弃项对应两类变更:错误上报接口统一(REPORT_* 系列收敛为 REPORT_INNER_ERR_MSG / REPORT_PREDEFINED_ERR_MSG)与日志接口统一(slog.h / alog_pub.h 收敛到 dlog_pub.h,宏形态的 dlog_error、dlog_warn 等替代原有函数式调用)。

废弃迁移的通用操作指引

结合上述六个模块的废弃清单,迁移时可按如下流程推进:

  1. 定位废弃点:全局搜索上述清单中的头文件路径(ascend-toolkit/latest 前缀)与接口名(rt、aclnn*、REPORT_*、Alog* 等),确认受影响代码范围;
  2. 对照替换表逐项迁移:对"后续不提供相关功能"的废弃项(如 rtFftsTaskLaunch、pkg_inc/runtime/runtime 头文件),需重构调用逻辑以移除依赖,而非简单替换;
  3. 更新头文件包含路径:统一从 cann/include、cann/pkg_inc 目录包含头文件,并相应更新链接库(如将 libascendcl.so 替换为 libacl_rt.so 等);
  4. 回归验证:迁移后重新编译链接,重点验证算子调用(aclnn 接口)、流与标签控制(aclrt 接口)、错误上报与日志打印功能与迁移前行为一致。

版本升级与漏洞修补说明

版本配套与废弃迁移之外,还需关注两点:

  • 本版本的开源及第三方软件漏洞修复情况详见官方"漏洞修补列表"文档,升级前建议核对所涉及组件(如开源库、三方依赖)的 CVE 修复覆盖范围;
  • 由于 9.2.0-beta.1 属于 Beta 版本,正式商用环境建议关注后续正式版本(如 9.2.0 正式版)的发布说明,本仓库各版本目录(如 9.1.0/release-notes.md、9.2.0-beta.2/release-notes.md)持续记录各版本的配套关系与废弃变更,可作为跨版本迁移的对比依据。

小结

CANN 9.2.0-beta.1 在配套体系上延续了三类组合包(Toolkit 22 个子包、ops 10 个子包、NNAL 2 个子包)的版本矩阵,明确了与 Ascend HDK 26.0.RC1 驱动的配套约束,并开放 6 个 ops 子包的独立升级通道;在能力演进上,面向 Atlas A2/A3 系列产品新增 FusedSgd 算子适配;在存量兼容上,横跨运行时、图引擎、算子库、加速库、调试工具与维测能力六个模块发布了成体系的废弃清单与迁移映射。对开发者而言,建议按本文的配套表完成选包,优先将废弃接口迁移至 aclrt / aclnn / acldvpp 等新一代接口体系,并依据 2026.12.30、2027.3.30、2027.6.30 等删除节点倒排迁移计划,以最小的兼容性成本平滑过渡到后续版本。

登录后查看全文
release-management