已合并
docs: 完善环境部署文档的驱动与CANN安装说明 #4100
於欣洁创建于 7月15日
docs: 完善环境部署文档的驱动与CANN安装说明 #4100
已合并
共 1 个文件变更+13-5
| @@ -43,9 +43,13 @@ | |||
| 43 | > - 镜像文件比较大，下载需要一定时间，请您耐心等待。关于docker命令的选项介绍可通过`docker --help`查询。 | 43 | > - 镜像文件比较大，下载需要一定时间，请您耐心等待。关于docker命令的选项介绍可通过`docker --help`查询。 |
| 44 | > - 环境默认安装最新版本CANN包，源码下载时注意与软件配套。 | 44 | > - 环境默认安装最新版本CANN包，源码下载时注意与软件配套。 |
| 45 | 45 | ||
| 46 | -1. **安装驱动与固件（运行态依赖）** | 46 | +1. **安装驱动（运行态依赖）** |
| 47 | 47 | ||
| 48 | - 驱动与固件是运行态依赖，若仅编译算子，可以不安装。使用`npu-smi info`检查是否有NPU相关信息，若没有，请参考《[CANN快速安装](https://www.hiascend.com/cann/download)》完成驱动与固件安装。 | 48 | + 驱动是运行态依赖，若仅编译算子，可以不安装。使用`npu-smi info`检查是否有NPU相关信息，若没有，请参考《[CANN快速安装](https://www.hiascend.com/cann/download)》完成驱动安装： |
| 49 | + | ||
| 50 | + - 步骤1：在页面中选择自己的产品系列、CPU架构、操作系统，安装方式选择“在线安装（Yum）”。 | ||
| 51 | + - 步骤2：按照页面指引依次完成“配置用户属组”、“安装依赖&配源”、“安装NPU驱动”三个环节。 | ||
| 52 | + - 步骤3：执行`npu-smi info`，若能正常显示NPU设备信息，则说明驱动安装成功。 | ||
| 49 | 53 | ||
| 50 | 2. **下载镜像** | 54 | 2. **下载镜像** |
| 51 | 55 | ||
| @@ -95,9 +99,13 @@ | |||
| 95 | 99 | ||
| 96 | - **场景1：体验master版本能力或基于master版本进行开发** | 100 | - **场景1：体验master版本能力或基于master版本进行开发** |
| 97 | 101 | ||
| 98 | - 1. **安装驱动与固件（运行态依赖）** | 102 | + 1. **安装驱动（运行态依赖）** |
| 99 | 103 | ||
| 100 | - 驱动与固件是运行态依赖，若仅编译算子，可以不安装。使用`npu-smi info`检查是否有NPU相关信息，若没有，请参考《[CANN快速安装](https://www.hiascend.com/cann/download)》完成驱动与固件安装。 | 104 | + 驱动是运行态依赖，若仅编译算子，可以不安装。使用`npu-smi info`检查是否有NPU相关信息，若没有，请参考《[CANN快速安装](https://www.hiascend.com/cann/download)》完成驱动安装： |
| 105 | + | ||
| 106 | + - 步骤1：在页面中选择自己的产品系列、CPU架构、操作系统，安装方式选择“在线安装（Yum）”。 | ||
| 107 | + - 步骤2：按照页面指引依次完成“配置用户属组”、“安装依赖&配源”、“安装NPU驱动”三个环节。 | ||
| 108 | + - 步骤3：执行`npu-smi info`，若能正常显示NPU设备信息，则说明驱动安装成功。 | ||
 | |||
| 101 | 109 | ||
| 102 | 2. **安装CANN包** | 110 | 2. **安装CANN包** |
| 103 | 111 | ||
| @@ -126,7 +134,7 @@ | |||
| 126 | 134 | ||
| 127 | - **场景2：体验已发布版本能力或基于已发布版本进行开发** | 135 | - **场景2：体验已发布版本能力或基于已发布版本进行开发** |
| 128 | 136 | ||
| 129 | - 请访问[CANN官网下载中心](https://www.hiascend.com/cann/download)，选择发布版本（仅支持CANN 8.5.0及后续版本），并根据产品型号和环境架构下载对应包，最后参考网页提供的命令完成安装。 | 137 | + 请参考《[CANN快速安装](https://www.hiascend.com/cann/download)》，选择版本（仅支持CANN 8.5.0及后续版本），并根据产品系列、CPU架构、操作系统等下载对应包，最后参考页面提供的命令完成安装。 |
| 130 | 138 | ||
| 131 | #### 安装基础依赖 | 139 | #### 安装基础依赖 |
| 132 | 140 | ||
🟡 Medium Priority
本次变更将"方式2 Docker"和"方式3 手动安装-场景1"中的"驱动与固件"修正为"驱动"，意图移除固件作为运行态依赖的表述。但文档中以下位置仍将固件列为运行态依赖，未被同步更新：
这造成文档内部矛盾：顶部说明引导用户安装驱动与固件，但变更后的操作步骤仅要求安装驱动。用户将无法确定固件是否实际需要安装，可能导致部署遗漏（若固件实际仍需）或多余操作（若固件已不需要）。
触发条件：任何按文档顺序阅读的用户都会先看到"需安装驱动与固件"，然后进入具体步骤时发现只需安装驱动，产生认知冲突。
建议：需同步更新文档中所有仍将"固件"列为运行态依赖的位置，以确保文档一致性。具体应修改的位置包括：
或者，如果固件在特定场景下确实仍是运行态依赖，则需要在文档中明确区分哪些场景需要固件、哪些不需要，而非简单移除。