Notice1：

使用wxtool在线烧录网卡固件时请注意以下事项：

       1、烧写过程中，禁止因为任何原因，中断烧写程序。这会导致网卡故障损坏。

       2、烧写固件固件完成后，必须掉电重启使flash reload生效。禁止不重启连续执行烧录固件操作。这会导致网卡故障损坏。

Q1

问题现象：

linux系统下，驱动编译时报错

*** Kernel header files not in any of the expexted locations.

*** Install the appropriate kernel development package, e.g.

*** kernel-devel, for building kernel modules and try again.

原因：

       操作系统上未安装kernel-headers包和kernel-devel包；

       或者，所安装的kernel-headers包和kernel-devel包与当前运行的内核版本不匹配。

解决途径：

      若未安装相关内核包，可以选择到操作系统安装镜像ISO中安装找rpm/deb包安装；

      若内核版本和内核包的版本不匹配，例如内核升级过，可以通过在线升级+在线安装手段，使内核版本和kernel-headers包和kernel-devel包的版本一致。

其它：

      对于Debian系的操作系统，相关的包不是kernel-headers和kernel-devel，而是linux-headers。

Q2

问题现象：

      linux系统下，千兆网卡驱动加载/卸载时报错：

      modprobe: ERROR: could not insert 'ngbe': Operation not permitted

      insmod: ERROR: could not insert 'ngbe': Operation not permitted

      rmmod: ERROR: could not remove 'ngbe.ko': Operation not permitted

原因：

      使用普通用户登录，相关操作没有可执行权限。

解决途径：

      使用root权限登录后，执行上述操作。

其它：

      万兆网卡驱动报错同理，模块显示为txgbe/txgbe.ko。

Q3

问题现象：

      在麒麟V10/银河麒麟操作系统下，网卡驱动编译时报错：

      error: redefinition of 'csum_replace_by_diff' static inline void csum_replace_by_diff(__sum16 *sum, __wsum diff)

原因：

      为适配上述系统，网卡驱动做了单独宏定义，若不加编译参数，直接make; make install会导致报错。

解决途径：

      编译参数可参考驱动编译手册内容，下载路径如下：

      万兆网卡驱动：网迅官网->技术支持->下载中心->文档->网迅万兆网卡驱动使用方法（驱动加载手册）

      千兆网卡驱动：网迅官网->技术支持->下载中心->文档->网迅千兆网卡驱动使用方法（驱动加载手册）

其它：

无。

Q4

问题现象：

linux系统下，lspci看到的网迅网卡设备为 8088:XXXX，而不是类似其他pcie设备的“公司名称+设备型号”的字符串信息。

原因：

网迅网卡设备已经在官方 https://pci-ids.ucw.cz/v2.2/pci.ids 注册，客户环境上的pci.ids 尚未更新，不包含网迅设备信息。

解决途径：

将设备与因特网连接，使用命令update-pciids更新本地的 /usr/share/hwdata/pci.ids 文件。

若客户环境不允许连接外部网络，可以从 https://pci-ids.ucw.cz/v2.2/pci.ids 下载后，手动更新到系统中：/usr/share/hwdata/pci.ids。

其它：

相反，若客户反馈的是“lspci |grep 8088 看不到网迅网卡”，排除pcie未连接的情况，可能是客户环境上的pci.ids 已经包含了网迅设备信息，可以用“Wangxun”或者设备型号如“RP1000”、“RP2000”作为关键字来grep信息。

Q5

问题现象：

      Windows系统下，安装网卡驱动失败，而实际设备管理器可以识别到NIC Controller设备。

原因：

      1、检查驱动版本是否为官网最新版本，若非最新版本驱动可能会有部分网卡ID不支持，建议更新。

      2、检查固件版本：在linux系统下执行ethtool -i <网口名>，建议更新到最新版本。

      3、可能是驱动ndis版本未对应，需要检查加载的驱动是否下载错误：

            62x64（支持ndis6.2，对应操作系统版本win7/win2008R2）

            63x64（支持ndis6.3，对应操作系统版本win10/win2012R2/win2016/win2019）。

      4、win7/2008r2操作系统需要在安装驱动前，打好相应补丁。

解决途径：

      升级最新版本的windows驱动，可在官网下载：网迅官网->技术支持->下载中心->驱动。

      升级固件版本，请联系销售获取。

      在win7/2008r2操作系统下安装驱动前，请查看驱动包内readme，下载相关补丁并安装。

其它：

      无。

Q6

问题现象：

       使用固件升级工具对网卡固件进行升级时，报错“map-mem failed”。

原因：

1、未使用root权限运行固件升级工具。

2、系统启动参数中iomem设不对。

3、部分操作系统（如arm平台上的centos）的内核不支持iomem地址映射。

解决途径：

     1、执行sudo su切换到root账户，再执行固件升级操作。  

     2、部分系统（非centos、UOS）在系统启动参数中设置 iomem=relaxed。

     3、使用wxtool-3.7.4及以上版本的工具，编译并插入随工具一起发布wx_upgrade.ko或者mem.ko模块。

其它：

      详细解决步骤请参考工具包内的《固件升级工具用户手册》第2.5.10章节。

Q7

问题现象：

       在部分国产CPU平台（如飞腾/龙芯/兆芯等），lspci无法认到WX1820AL万兆网络控制器芯片设备。

原因：

部分国产平台上PCIe 3.0 信号质量存在不稳定情况。

解决途径：

购买RP2000的万兆网卡设备的客户，可以换用RP2000P2SPF-SW网卡。

购买网络控制器芯片的客户，请联系销售。

其它：

该问题出现时，可能会导致其他问题现象，如：

1、网卡识别失败，lspci看不到设备；

2、服务器平台无法启动（BIOS卡住）；

3、服务器某个CPU核占用率异常高；

4、概率性panic等。

Q8

问题现象：

      此问题针对自主设计的客户，linux系统下驱动加载不成功，查看dmesg信息报错如下：

      Software semaphore SMBI between device drivers not granted.

      The EEPROM Checksum Is Not valid

      failed with error -5

原因：

      固件烧写错误，硬件虚焊、硬件disable网口等导致flash读写异常，非软件原因。

解决途径：

      1、首先检查固件烧写是否正确，若确认固件烧写无误，则检查硬件设计。

      2、查看0x10000和0x10028寄存器的值（此操作可跳过，直接检查硬件）：

          ./wxtool -s 01:00.0 -r 0x10000

          ./wxtool -s 01:00.0 -r 0x10028

          其中0x10028寄存器的值bit0正常时为1，若读出为0，排查以下：

             a）硬件上lan_dis下拉关闭网口。若0口被关闭，则可能报错semaphore SMBI not granted。若物理上需要disable1/2/3网口，可将固件更新为对应网口数量的固件。

             b）检查硬件mng_det是否下拉了（mng_det下拉会导致firmware无法启动）。

             c）检查芯片复位是否拉高，若没有拉高会导致异常。

             d）检查SPI_DVI分频模式配置是否为011。

             e）检查flash的IO是否接反了，可用示波器抓以下信号CS、DI、DO、CLK。

其它：

      若以上步骤执行完毕后问题无法解决，请联系销售发送设计原理图，以供我司硬件工程师检视。

      或者联系网迅FAE，参考《WX1860 原理图checklist》和《万兆芯片原理图checklist》中常见问题解决。