CANN 9.2.0-beta.1 版本发布说明解读:组合包配套关系、FusedSgd 新增算子与废弃接口迁移指南
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 | {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 两个独立调用),以及**算子组件包化后头文件与动态库按 {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 等替代原有函数式调用)。
废弃迁移的通用操作指引
结合上述六个模块的废弃清单,迁移时可按如下流程推进:
- 定位废弃点:全局搜索上述清单中的头文件路径(
ascend-toolkit/latest前缀)与接口名(rt、aclnn*、REPORT_*、Alog*等),确认受影响代码范围; - 对照替换表逐项迁移:对"后续不提供相关功能"的废弃项(如 rtFftsTaskLaunch、pkg_inc/runtime/runtime 头文件),需重构调用逻辑以移除依赖,而非简单替换;
- 更新头文件包含路径:统一从
cann/include、cann/pkg_inc目录包含头文件,并相应更新链接库(如将 libascendcl.so 替换为 libacl_rt.so 等); - 回归验证:迁移后重新编译链接,重点验证算子调用(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 等删除节点倒排迁移计划,以最小的兼容性成本平滑过渡到后续版本。