长江计算服务器安装NingOS后不识别光口

打400吧

# 长江计算服务器 NingOS‑V3‑1.0.2403‑aarch64，SP681 (Hi1822) 光口不识别

>
> SP681 是华为 Hi1822 芯片 25G 标卡，**NingOS V3‑1.0.2403 内核默认不带 hinic3 驱动**，系统可以识别 PCI 硬件，但**无法加载网卡驱动，不会出现 eth 网口，光口不显示**。

## 第一步：先做基础排查（区分硬件 / 驱动问题）

```
# 查看PCI总线是否识别到SP681 Hi1822硬件
lspci | grep Hi1822
# 或者
lspci -nn | grep 19e5
```

1. ✅ 如果`lspci`能看到 Hi1822 设备：**硬件没问题，就是缺少 hinic3 驱动**，这是绝大多数现场现象。
2. ❌ 如果`lspci`完全看不到：BIOS 禁用、PCIe 插槽故障、网卡硬件损坏；进 BIOS 确认网卡 PCIe 设备启用。

>
> 现象：lspci 可见网卡，`ip a`看不到任何光口设备，`lsmod | grep hinic`为空。

## 二、驱动 & 固件获取渠道（NingOS‑V3 aarch64）

>
> SP681 (Hi1822) 驱动包是华为 iDriver 套件，**NingOS 是基于鲲鹏内核的国产 OS，需要 ARM‑aarch64 版本驱动 rpm 包**。

### 渠道 1：华为企业支持网站（iDriver，官方来源）

访问：`support.huawei.com`，登录企业账号，搜索 **TaiShanServer iDriver**

1. 选择版本，操作系统筛选：**openEuler / 鲲鹏 ARM aarch64**（NingOS 基于 openEuler 内核，优先用 openEuler 的 aarch64 驱动包）
2. 下载 iDriver 压缩包，解压得到 `onboard_driver_xxx.iso`，里面包含：
- `hinic3`：网卡内核驱动 rpm（**必须**）
- `hinicadm3`：网卡管理工具 rpm（**必须**）
- `hisdk3`：依赖包
- Hi1822‑ARM 固件包 `NIC‑SP681‑Hi1822‑FW‑xxx‑ARM.zip`（网卡固件）

>
> ⚠️注意：**不要下载 x86_64 包，必须 aarch64**；区分标卡（无 smart），SP681 是标准网卡，不要下智能网卡包。

### 渠道 2：长江计算原厂技术支持（最推荐，NingOS 定制适配）

NingOS 是长江计算定制系统，**优先找长江计算 400，提供服务器 SN、NingOS 版本：NingOS‑V3‑1.0.2403‑aarch64，网卡 SP681 Hi1822**。

>
> 优点：直接给到**已经适配 NingOS 内核版本的 rpm 驱动包**，避免内核版本不匹配，出现模块编译失败、内核 panic。

### 渠道 3：鲲鹏兼容性查询

[***.***/compute/component/compatibility](***.***/compute/component/compatibility)
查询 SP681 Hi1822 对 openEuler 版本适配，NingOS‑V3‑1.0.2403 内核和 openEuler 2403 对齐。

## 三、安装驱动步骤（aarch64）

>
> 顺序不能颠倒，先装依赖，再装驱动，再装管理工具。

```
# 1. 上传rpm包到服务器，先安装依赖hisdk3
rpm -ivh hisdk3-xxx.aarch64.rpm
# 2. 安装hinic3网卡驱动（核心）
rpm -ivh hinic3-xxx.aarch64.rpm
# 3. 安装管理工具hinicadm3
rpm -ivh hinicadm3-xxx.aarch64.rpm

# 4. 加载驱动模块
modprobe hinic3

# 5. 验证
lsmod | grep hinic3
ip a
# 此时会出现hinic的网口（如hinic0、hinic1，对应两个光口）
```

>
> 如果出现`kernel module version mismatch`：代表驱动 rpm 包内核版本和 NingOS 当前内核不一致。
> 解决：要么找长江计算提供适配当前内核的 rpm；要么使用源码编译 hinic3 模块。

## 四、网卡固件升级（Hi1822 SP681）

>
> 驱动装好后，网口出现，但是光口无法 up、识别不到光模块，需要升级网卡固件。

1. 解压固件包：`NIC‑SP681‑Hi1822‑FW‑xxx‑ARM.zip`，得到`Hinic3_flash.bin`
2. 使用 hinicadm3 工具升级固件

```
hinicadm3 updatefw -i hinic0 -f Hinic3_flash.bin
```

>
> ⚠️固件升级**严禁断电**，升级完成重启服务器。

## 五、BIOS 侧补充排查（容易踩坑）

1. 进入 BIOS → Device Manager，找到 SP681 网卡，**Reset Factory 恢复出厂设置**，保存重启。
2. 确认 BIOS 中 PCIe 插槽没有被禁用；
3. 确认 SFP28 光模块：SP681 为 25G SFP28，**不要混用普通 10G SFP 光模块**，部分固件会不识别；优先华为认证光模块。

## 六、故障场景总结

1. `lspci`看不到 Hi1822：硬件 / BIOS 问题；
2. `lspci`能看到 Hi1822，`ip a`无网口：缺少 hinic3 驱动；
3. 驱动装好，网口出现，光口无法 UP：网卡固件版本旧、光模块不兼容；

## 重要提醒

1. NingOS‑V3‑1.0.2403，**不要随便用通用 openEuler 驱动，内核版本不匹配会导致内核崩溃**，优先长江计算原厂适配包。
2. SP681 Hi1822 的驱动和固件**必须匹配版本**，驱动版本与固件版本不匹配，会出现光口异常、丢包。
3. 安装完驱动，建议把 hinic3 模块加入开机自启，防止重启后驱动丢失。

你遇到的问题，根源在于 NingOS V3-1.0.2403 系统的内核默认没有集成 SP681 网卡（基于华为 Hi1822 芯片）所需的 hinic3 驱动。系统虽然能识别到 PCIe 硬件，但因为缺少驱动，所以无法加载网卡，导致光口不显示。

要解决这个问题，核心就是手动安装适配你系统架构（aarch64）的网卡驱动。以下是详细的解决步骤和资源获取渠道。

🔧 第一步：确认硬件状态

在进行任何软件操作前，先确认系统能否识别到网卡硬件。

在服务器终端执行以下命令：

• 如果能看到 Hi1822 设备：说明硬件本身没有问题，问题就出在缺少驱动上。

• 如果完全看不到：则可能是 BIOS 中禁用了该设备、PCIe 插槽故障或网卡硬件损坏，需要先检查 BIOS 设置。

📥 第二步：获取驱动与固件（最关键）

驱动和固件需要从华为官方获取，因为 SP681 是华为自研网卡。

渠道一：华为企业支持网站（官方 iDriver 套件）

1. 访问 support.huawei.com 并登录（可能需要企业账号）。

2. 搜索 “TaiShanServer iDriver”。

3. 在筛选条件中，操作系统选择与 NingOS 内核兼容的 openEuler（aarch64） 或 CentOS 7.6（aarch64）。

4. 下载对应的 iDriver 压缩包，解压后你会得到 onboard_driver_xxx.iso 文件。

5. 挂载或解压这个 ISO 文件，里面通常包含以下关键包：

   • hinic3：网卡内核驱动 rpm 包（必须安装）

   • hinicadm3：网卡管理工具 rpm 包（必须安装）

   • hisdk3：依赖包

   • NIC-SP681-Hi1822-FW-xxx-ARM.zip：网卡固件升级包（视情况升级）

渠道二：联系长江计算原厂技术支持（最推荐）

由于 NingOS 是长江计算定制的系统，最稳妥的方式是直接联系长江计算的技术支持。提供你的服务器 SN 号、NingOS 版本（V3-1.0.2403-aarch64）和网卡型号（SP681 Hi1822），他们能直接提供已经过适配测试的驱动包，避免内核版本不匹配的风险。

⚠️ 关键提醒：

• 必须下载 aarch64 架构的包，绝对不能下载 x86_64 的包。

• SP681 是标准网卡，注意不要下载成智能网卡的驱动包。

🚀 第三步：安装驱动

获取到正确的 rpm 包后，安装过程比较简单。

1. 将所需的 rpm 包（如 hinic3-*.aarch64.rpm 和 hinicadm3-*.aarch64.rpm）上传到服务器。

2. 在包所在目录执行以下命令进行安装：

   bash

   rpm -ivh hinic3-*.aarch64.rpm rpm -ivh hinicadm3-*.aarch64.rpm

3. 安装完成后，可以重启服务器或手动加载驱动模块：

   bash

   modprobe hinic3

4. 使用 lsmod | grep hinic 命令检查驱动是否加载成功。如果能看到 hinic3 模块，说明驱动已正常工作。

⬆️ 第四步：（可选）升级网卡固件

如果驱动安装后问题依旧，或你希望更新到最新固件，可以考虑升级。

网卡固件升级通常有两种方式：

• Smart Provisioning 方式：使用华为的 Smart Provisioning 工具进行升级。

• SmartKit 方式：使用华为的 SmartKit 工具进行批量或单台升级。

这两种方式都需要从华为官网下载对应的工具和固件包，操作相对复杂，建议在必要时参考华为官方的详细指导文档进行。