Notice1:
使用wxtool在線燒錄網卡固件時請注意以下事(shì)項:
1、燒寫過(guò)程中,禁止因爲任何原因,中斷燒寫程序。這(zhè)會(huì)導緻網卡故障損壞。
2、燒寫固件固件完成(chéng)後(hòu),必須掉電重啓使flash reload生效。禁止不重啓連續執行燒錄固件操作。這(zhè)會(huì)導緻網卡故障損壞。
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包安裝;
若内核版本和内核包的版本不匹配,例如内核升級過(guò),可以通過(guò)在線升級+在線安裝手段,使内核版本和kernel-headers包和kernel-devel包的版本一緻。
其它:
對(duì)于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
原因:
使用普通用戶登錄,相關操作沒(méi)有可執行權限。
解決途徑:
使用root權限登錄後(hòu),執行上述操作。
其它:
萬兆網卡驅動報錯同理,模塊顯示爲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會(huì)導緻報錯。
解決途徑:
編譯參數可參考驅動編譯手冊内容,下載路徑如下:
萬兆網卡驅動:網迅官網->技術支持->下載中心->文檔->網迅萬兆網卡驅動使用方法(驅動加載手冊)
千兆網卡驅動:網迅官網->技術支持->下載中心->文檔->網迅千兆網卡驅動使用方法(驅動加載手冊)
其它:
無。
Q4
問題現象:
linux系統下,lspci看到的網迅網卡設備爲 8088:XXXX,而不是類似其他pcie設備的“公司名稱+設備型号”的字符串信息。
原因:
網迅網卡設備已經(jīng)在官方 https://pci-ids.ucw.cz/v2.2/pci.ids 注冊,客戶環境上的pci.ids 尚未更新,不包含網迅設備信息。
解決途徑:
將(jiāng)設備與因特網連接,使用命令update-pciids更新本地的 /usr/share/hwdata/pci.ids 文件。
若客戶環境不允許連接外部網絡,可以從 https://pci-ids.ucw.cz/v2.2/pci.ids 下載後(hòu),手動更新到系統中:/usr/share/hwdata/pci.ids。
其它:
相反,若客戶反饋的是“lspci |grep 8088 看不到網迅網卡”,排除pcie未連接的情況,可能(néng)是客戶環境上的pci.ids 已經(jīng)包含了網迅設備信息,可以用“Wangxun”或者設備型号如“RP1000”、“RP2000”作爲關鍵字來grep信息。
Q5
問題現象:
Windows系統下,安裝網卡驅動失敗,而實際設備管理器可以識别到NIC Controller設備。
原因:
1、檢查驅動版本是否爲官網最新版本,若非最新版本驅動可能(néng)會(huì)有部分網卡ID不支持,建議更新。
2、檢查固件版本:在linux系統下執行ethtool -i <網口名>,建議更新到最新版本。
3、可能(néng)是驅動ndis版本未對(duì)應,需要檢查加載的驅動是否下載錯誤:
62x64(支持ndis6.2,對(duì)應操作系統版本win7/win2008R2)
63x64(支持ndis6.3,對(duì)應操作系統版本win10/win2012R2/win2016/win2019)。
4、win7/2008r2操作系統需要在安裝驅動前,打好(hǎo)相應補丁。
解決途徑:
升級最新版本的windows驅動,可在官網下載:網迅官網->技術支持->下載中心->驅動。
升級固件版本,請聯系銷售獲取。
在win7/2008r2操作系統下安裝驅動前,請查看驅動包内readme,下載相關補丁并安裝。
其它:
無。
Q6
問題現象:
使用固件升級工具對(duì)網卡固件進(jìn)行升級時,報錯“map-mem failed”。
原因:
1、未使用root權限運行固件升級工具。
2、系統啓動參數中iomem設不對(duì)。
3、部分操作系統(如arm平台上的centos)的内核不支持iomem地址映射。
解決途徑:
1、執行sudo su切換到root賬戶,再執行固件升級操作。
2、部分系統(非centos、UOS)在系統啓動參數中設置 iomem=relaxed。
3、使用wxtool-3.7.4及以上版本的工具,編譯并插入随工具一起(qǐ)發(fā)布wx_upgrade.ko或者mem.ko模塊。
其它:
詳細解決步驟請參考工具包内的《固件升級工具用戶手冊》第2.5.10章節。
Q7
問題現象:
在部分國(guó)産CPU平台(如飛騰/龍芯/兆芯等),lspci無法認到WX1820AL萬兆網絡控制器芯片設備。
原因:
部分國(guó)産平台上PCIe 3.0 信号質量存在不穩定情況。
解決途徑:
購買RP2000的萬兆網卡設備的客戶,可以換用RP2000P2SPF-SW網卡。
購買網絡控制器芯片的客戶,請聯系銷售。
其它:
該問題出現時,可能(néng)會(huì)導緻其他問題現象,如:
1、網卡識别失敗,lspci看不到設備;
2、服務器平台無法啓動(BIOS卡住);
3、服務器某個CPU核占用率異常高;
4、概率性panic等。
Q8
問題現象:
此問題針對(duì)自主設計的客戶,linux系統下驅動加載不成(chéng)功,查看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寄存器的值(此操作可跳過(guò),直接檢查硬件):
./wxtool -s 01:00.0 -r 0x10000
./wxtool -s 01:00.0 -r 0x10028
其中0x10028寄存器的值bit0正常時爲1,若讀出爲0,排查以下:
a)硬件上lan_dis下拉關閉網口。若0口被(bèi)關閉,則可能(néng)報錯semaphore SMBI not granted。若物理上需要disable1/2/3網口,可將(jiāng)固件更新爲對(duì)應網口數量的固件。
b)檢查硬件mng_det是否下拉了(mng_det下拉會(huì)導緻firmware無法啓動)。
c)檢查芯片複位是否拉高,若沒(méi)有拉高會(huì)導緻異常。
d)檢查SPI_DVI分頻模式配置是否爲011。
e)檢查flash的IO是否接反了,可用示波器抓以下信号CS、DI、DO、CLK。
其它:
若以上步驟執行完畢後(hòu)問題無法解決,請聯系銷售發(fā)送設計原理圖,以供我司硬件工程師檢視。
或者聯系網迅FAE,參考《WX1860 原理圖checklist》和《萬兆芯片原理圖checklist》中常見問題解決。