Notice1：

使用wxtool在線燒錄網(wǎng)卡固件時(shí)請(qǐng)注意以下事項(xiàng)：

       1、燒寫過(guò)程中，禁止因?yàn)槿魏卧颍袛酂龑懗绦颉＿@會(huì)導(dǎo)致網(wǎng)卡故障損壞。

       2、燒寫固件固件完成后，必須掉電重啟使flash reload生效。禁止不重啟連續(xù)執(zhí)行燒錄固件操作。這會(huì)導(dǎo)致網(wǎng)卡故障損壞。

Q1

問(wèn)題現(xiàn)象：

linux系統(tǒng)下，驅(qū)動(dòng)編譯時(shí)報(bào)錯(cuò)

*** 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.

原因：

       操作系統(tǒng)上未安裝kernel-headers包和kernel-devel包；

       或者，所安裝的kernel-headers包和kernel-devel包與當(dāng)前運(yùn)行的內(nèi)核版本不匹配。

解決途徑：

      若未安裝相關(guān)內(nèi)核包，可以選擇到操作系統(tǒng)安裝鏡像ISO中安裝找rpm/deb包安裝；

      若內(nèi)核版本和內(nèi)核包的版本不匹配，例如內(nèi)核升級(jí)過(guò)，可以通過(guò)在線升級(jí)+在線安裝手段，使內(nèi)核版本和kernel-headers包和kernel-devel包的版本一致。

其它：

      對(duì)于Debian系的操作系統(tǒng)，相關(guān)的包不是kernel-headers和kernel-devel，而是linux-headers。

Q2

問(wèn)題現(xiàn)象：

      linux系統(tǒng)下，千兆網(wǎng)卡驅(qū)動(dòng)加載/卸載時(shí)報(bào)錯(cuò)：

      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

原因：

      使用普通用戶登錄，相關(guān)操作沒(méi)有可執(zhí)行權(quán)限。

解決途徑：

      使用root權(quán)限登錄后，執(zhí)行上述操作。

其它：

      萬(wàn)兆網(wǎng)卡驅(qū)動(dòng)報(bào)錯(cuò)同理，模塊顯示為txgbe/txgbe.ko。

Q3

問(wèn)題現(xiàn)象：

      在麒麟V10/銀河麒麟操作系統(tǒng)下，網(wǎng)卡驅(qū)動(dòng)編譯時(shí)報(bào)錯(cuò)：

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

原因：

      為適配上述系統(tǒng)，網(wǎng)卡驅(qū)動(dòng)做了單獨(dú)宏定義，若不加編譯參數(shù)，直接make; make install會(huì)導(dǎo)致報(bào)錯(cuò)。

解決途徑：

      編譯參數(shù)可參考驅(qū)動(dòng)編譯手冊(cè)內(nèi)容，下載路徑如下：

      萬(wàn)兆網(wǎng)卡驅(qū)動(dòng)：網(wǎng)迅官網(wǎng)->技術(shù)支持->下載中心->文檔->網(wǎng)迅萬(wàn)兆網(wǎng)卡驅(qū)動(dòng)使用方法（驅(qū)動(dòng)加載手冊(cè)）

      千兆網(wǎng)卡驅(qū)動(dòng)：網(wǎng)迅官網(wǎng)->技術(shù)支持->下載中心->文檔->網(wǎng)迅千兆網(wǎng)卡驅(qū)動(dòng)使用方法（驅(qū)動(dòng)加載手冊(cè)）

其它：

無(wú)。

Q4

問(wèn)題現(xiàn)象：

linux系統(tǒng)下，lspci看到的網(wǎng)迅網(wǎng)卡設(shè)備為 8088:XXXX，而不是類似其他pcie設(shè)備的“公司名稱+設(shè)備型號(hào)”的字符串信息。

原因：

網(wǎng)迅網(wǎng)卡設(shè)備已經(jīng)在官方 https://pci-ids.ucw.cz/v2.2/pci.ids 注冊(cè)，客戶環(huán)境上的pci.ids 尚未更新，不包含網(wǎng)迅設(shè)備信息。

解決途徑：

將設(shè)備與因特網(wǎng)連接，使用命令update-pciids更新本地的 /usr/share/hwdata/pci.ids 文件。

若客戶環(huán)境不允許連接外部網(wǎng)絡(luò)，可以從 https://pci-ids.ucw.cz/v2.2/pci.ids 下載后，手動(dòng)更新到系統(tǒng)中：/usr/share/hwdata/pci.ids。

其它：

相反，若客戶反饋的是“l(fā)spci |grep 8088 看不到網(wǎng)迅網(wǎng)卡”，排除pcie未連接的情況，可能是客戶環(huán)境上的pci.ids 已經(jīng)包含了網(wǎng)迅設(shè)備信息，可以用“Wangxun”或者設(shè)備型號(hào)如“RP1000”、“RP2000”作為關(guān)鍵字來(lái)grep信息。

Q5

問(wèn)題現(xiàn)象：

      Windows系統(tǒng)下，安裝網(wǎng)卡驅(qū)動(dòng)失敗，而實(shí)際設(shè)備管理器可以識(shí)別到NIC Controller設(shè)備。

原因：

      1、檢查驅(qū)動(dòng)版本是否為官網(wǎng)最新版本，若非最新版本驅(qū)動(dòng)可能會(huì)有部分網(wǎng)卡ID不支持，建議更新。

      2、檢查固件版本：在linux系統(tǒng)下執(zhí)行ethtool -i <網(wǎng)口名>，建議更新到最新版本。

      3、可能是驅(qū)動(dòng)ndis版本未對(duì)應(yīng)，需要檢查加載的驅(qū)動(dòng)是否下載錯(cuò)誤：

            62x64（支持ndis6.2，對(duì)應(yīng)操作系統(tǒng)版本win7/win2008R2）

            63x64（支持ndis6.3，對(duì)應(yīng)操作系統(tǒng)版本win10/win2012R2/win2016/win2019）。

      4、win7/2008r2操作系統(tǒng)需要在安裝驅(qū)動(dòng)前，打好相應(yīng)補(bǔ)丁。

解決途徑：

      升級(jí)最新版本的windows驅(qū)動(dòng)，可在官網(wǎng)下載：網(wǎng)迅官網(wǎng)->技術(shù)支持->下載中心->驅(qū)動(dòng)。

      升級(jí)固件版本，請(qǐng)聯(lián)系銷售獲取。

      在win7/2008r2操作系統(tǒng)下安裝驅(qū)動(dòng)前，請(qǐng)查看驅(qū)動(dòng)包內(nèi)readme，下載相關(guān)補(bǔ)丁并安裝。

其它：

      無(wú)。

Q6

問(wèn)題現(xiàn)象：

       使用固件升級(jí)工具對(duì)網(wǎng)卡固件進(jìn)行升級(jí)時(shí)，報(bào)錯(cuò)“map-mem failed”。

原因：

1、未使用root權(quán)限運(yùn)行固件升級(jí)工具。

2、系統(tǒng)啟動(dòng)參數(shù)中iomem設(shè)不對(duì)。

3、部分操作系統(tǒng)（如arm平臺(tái)上的centos）的內(nèi)核不支持iomem地址映射。

解決途徑：

     1、執(zhí)行sudo su切換到root賬戶，再執(zhí)行固件升級(jí)操作。  

     2、部分系統(tǒng)（非centos、UOS）在系統(tǒng)啟動(dòng)參數(shù)中設(shè)置 iomem=relaxed。

     3、使用wxtool-3.7.4及以上版本的工具，編譯并插入隨工具一起發(fā)布wx_upgrade.ko或者mem.ko模塊。

其它：

      詳細(xì)解決步驟請(qǐng)參考工具包內(nèi)的《固件升級(jí)工具用戶手冊(cè)》第2.5.10章節(jié)。

Q7

問(wèn)題現(xiàn)象：

       在部分國(guó)產(chǎn)CPU平臺(tái)（如飛騰/龍芯/兆芯等），lspci無(wú)法認(rèn)到WX1820AL萬(wàn)兆網(wǎng)絡(luò)控制器芯片設(shè)備。

原因：

部分國(guó)產(chǎn)平臺(tái)上PCIe 3.0 信號(hào)質(zhì)量存在不穩(wěn)定情況。

解決途徑：

購(gòu)買RP2000的萬(wàn)兆網(wǎng)卡設(shè)備的客戶，可以換用RP2000P2SPF-SW網(wǎng)卡。

購(gòu)買網(wǎng)絡(luò)控制器芯片的客戶，請(qǐng)聯(lián)系銷售。

其它：

該問(wèn)題出現(xiàn)時(shí)，可能會(huì)導(dǎo)致其他問(wèn)題現(xiàn)象，如：

1、網(wǎng)卡識(shí)別失敗，lspci看不到設(shè)備；

2、服務(wù)器平臺(tái)無(wú)法啟動(dòng)（BIOS卡?。?/p>

3、服務(wù)器某個(gè)CPU核占用率異常高；

4、概率性panic等。

Q8

問(wèn)題現(xiàn)象：

      此問(wèn)題針對(duì)自主設(shè)計(jì)的客戶，linux系統(tǒng)下驅(qū)動(dòng)加載不成功，查看dmesg信息報(bào)錯(cuò)如下：

      Software semaphore SMBI between device drivers not granted.

      The EEPROM Checksum Is Not valid

      failed with error -5

原因：

      固件燒寫錯(cuò)誤，硬件虛焊、硬件disable網(wǎng)口等導(dǎo)致flash讀寫異常，非軟件原因。

解決途徑：

      1、首先檢查固件燒寫是否正確，若確認(rèn)固件燒寫無(wú)誤，則檢查硬件設(shè)計(jì)。

      2、查看0x10000和0x10028寄存器的值（此操作可跳過(guò)，直接檢查硬件）：

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

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

          其中0x10028寄存器的值bit0正常時(shí)為1，若讀出為0，排查以下：

             a）硬件上lan_dis下拉關(guān)閉網(wǎng)口。若0口被關(guān)閉，則可能報(bào)錯(cuò)semaphore SMBI not granted。若物理上需要disable1/2/3網(wǎng)口，可將固件更新為對(duì)應(yīng)網(wǎng)口數(shù)量的固件。

             b）檢查硬件mng_det是否下拉了（mng_det下拉會(huì)導(dǎo)致firmware無(wú)法啟動(dòng)）。

             c）檢查芯片復(fù)位是否拉高，若沒(méi)有拉高會(huì)導(dǎo)致異常。

             d）檢查SPI_DVI分頻模式配置是否為011。

             e）檢查flash的IO是否接反了，可用示波器抓以下信號(hào)CS、DI、DO、CLK。

其它：

      若以上步驟執(zhí)行完畢后問(wèn)題無(wú)法解決，請(qǐng)聯(lián)系銷售發(fā)送設(shè)計(jì)原理圖，以供我司硬件工程師檢視。

      或者聯(lián)系網(wǎng)迅FAE，參考《WX1860 原理圖checklist》和《萬(wàn)兆芯片原理圖checklist》中常見問(wèn)題解決。