1. 項目概述當4G模組遇上高速網口與Wi-Fi最近在搞一個工業網關項目核心需求是把現場的各種傳感器數據通過4G網絡穩定地傳到云端同時設備本地還得有個Wi-Fi熱點方便現場工程師用筆記本或手機快速連接進去做配置和調試。這個需求聽起來挺常規但真到選型和聯調的時候坑是一個接一個。主控平臺用的是性能還不錯的嵌入式Linux系統帶千兆網口。最初的想法很簡單找一款帶網口的4G模組直接插上網線就能讓整個系統上網再配一個獨立的Wi-Fi模組做AP。市面上這類模組不少移遠的EC20系列就是其中的熱門選擇它有個衍生版本EC20-CEHLG支持SGMII接口理論上能和主控的千兆網口直連省去一個USB轉接性能和穩定性應該更好。而Wi-Fi部分看中了移遠的FC20這是一款支持2.4G/5G雙頻的Wi-Fi 6模組做AP性能綽綽有余。想法很美好但“支持SGMII”和“調試通過”之間隔著一片名為“底層驅動適配和硬件時序”的汪洋大海。網口通訊不像USB插上就能認它涉及到物理層、鏈路層的諸多參數匹配而FC20模組雖然接口是常見的SDIO或USB但在Linux系統下把它配置成一個性能穩定、功能完整的AP同樣需要一番折騰。這次調試就是要把EC20的SGMII網口徹底打通讓系統把它識別為一個標準的以太網設備比如eth1同時把FC20配置成一個雙頻的無線接入點。整個過程是對嵌入式Linux網絡驅動、網絡配置、無線工具集的一次深度實踐。2. 核心需求與方案選型背后的考量2.1 為什么選擇SGMII接口的EC20模組在4G模組與主控的連接方式上常見的有USB、PCIe和網口RMII/SGMII等。USB方式最普遍驅動成熟即插即用但缺點也明顯需要占用一個USB主機端口在某些緊湊型設計中資源緊張USB總線在高速率、大數據量傳輸時穩定性和CPU占用率可能不如專用網絡接口此外還需要額外的USB網絡共享驅動如rndis_host,qmi_wwan。而網口直連尤其是SGMIISerial Gigabit Media Independent Interface則提供了另一種思路。SGMII是一種串行吉比特媒體獨立接口常用于芯片與PHY物理層芯片或交換芯片之間的連接。選擇EC20-CEHLG的SGMII版本主要基于以下幾點考量性能與資源獨立SGMII是純硬件鏈路數據交換不經過主控CPU的USB或PCIe控制器理論上延遲更低、吞吐更穩定。對于需要保證4G通道數據實時性的工業場景這一點很重要。它相當于給系統直接增加了一個由4G模組驅動的“網卡”主控CPU負擔更輕。簡化網絡拓撲在Linux系統看來通過SGMII連接的EC20就是一個標準的網絡接口。我們可以直接用ifconfig或ip命令來管理它用route命令添加默認路由所有網絡棧TCP/IP的處理都和普通網卡無異軟件架構清晰運維也方便。硬件設計簡化省去了USB接口所需的ESD保護、電源管理等外圍電路對于PCB布局和成本控制有一定好處。當然這帶來了新的挑戰需要主控SoC支持SGMII接口并正確連接時鐘和數據線。為什么不選RMIIRMII是百兆接口而EC20的4G CAT4理論下行速率可達150Mbps在信號好時RMII可能成為瓶頸。SGMII是千兆接口為4G速率留足了余量未來升級到CAT6模組也無需改動硬件接口。2.2 為什么選擇FC20作為Wi-Fi AP模組Wi-Fi模組的選擇主要看中三點性能、驅動支持和功能。FC20是一款基于高通方案的Wi-Fi 6模組支持2.4GHz和5GHz雙頻并支持AP/STA/并發模式。雙頻支持這是選擇它的關鍵。現場環境復雜2.4GHz頻段干擾嚴重但穿墻性好5GHz頻段干凈、速率高但覆蓋范圍小。提供雙頻AP可以讓現場設備根據情況自動選擇最佳頻段連接保障配置通道的可靠性。這也是搜索熱詞中“linux wifi 模組如何設置ap 支持5g頻段”所關心的核心問題。驅動與軟件生態FC20通常使用ath11k驅動該驅動是Linux內核主線支持的用于高通Wi-Fi 6芯片。主線驅動意味著更好的兼容性、更持續的維護和更豐富的功能支持如802.11ax特性、WPA3加密等。相比于一些需要單獨移植私有驅動SDK的模組主線驅動的可維護性要高得多。接口與功耗FC20多采用SDIO或USB接口。SDIO接口功耗更低更適合嵌入式設備。我們的主控平臺SDIO資源充足因此選擇了SDIO接口的版本。方案總結最終硬件鏈路是EC20通過SGMII接口直接連接到主控SoC的MAC層FC20通過SDIO接口連接到主控。在操作系統層面我們需要讓Linux正確識別這兩個“網卡”并完成4G撥號和Wi-Fi AP的配置。3. EC20 SGMII接口驅動調試詳解這是整個項目中最硬核、最容易踩坑的部分。EC20的SGMII接口并不是一個即插即用的標準以太網卡。模組內部集成了一個以太網控制器可能是IP核并通過SGMII接口暴露出來。主控端需要做相應的配置才能與之“握手”成功。3.1 硬件連接與引腳檢查首先必須確保硬件連接萬無一失。SGMII接口通常包含以下幾組信號TXD/TXD-發送差分對RXD/RXD-接收差分對REFCLK參考時鐘非常重要其中時鐘信號是重中之重。SGMII的參考時鐘頻率通常是125MHz。需要確認時鐘由誰提供是主控輸出給模組還是模組輸出給主控或者雙方共用一個外部時鐘源EC20-CEHLG的規格書明確要求由主控提供125MHz參考時鐘。我們必須檢查主控SoC的相應引腳是否配置為SGMII REFCLK輸出模式并用示波器測量時鐘頻率和幅值是否穩定、準確。差分數據線的PCB走線必須嚴格遵循差分對規則等長、等距、阻抗控制避免信號完整性出現問題導致鏈接不穩定。實操心得很多SGMII鏈接不上的問題首先出在時鐘上。我們用示波器抓取時鐘信號發現幅值不足且波形有畸變。排查后發現是主控端時鐘輸出驅動的強度drive-strength配置不夠在設備樹Device Tree中調整了對應引腳的drive-strength屬性后時鐘波形立刻變得干凈漂亮鏈接成功率大幅提升。3.2 Linux內核驅動配置與設備樹編寫硬件無誤后需要在軟件層面讓Linux內核識別這個接口。這主要依靠設備樹Device Tree來描述硬件連接。啟用主控SGMII MAC驅動首先確保內核編譯時啟用了主控SoC的以太網控制器驅動并且支持SGMII模式。例如對于NXP的i.MX系列需要啟用CONFIG_FEC并確認其支持SGMII。編寫設備樹節點這是核心步驟。我們需要在主控的以太網控制器節點下添加一個子節點來描述連接的PHY。但EC20內部的以太網控制器本身就是一個“PHY”從Linux MAC的角度看。因此配置比較特殊。// 示例以i.MX6UL平臺為例fec1節點配置 fec1 { pinctrl-names default; pinctrl-0 pinctrl_fec1; // 引腳復用配置 phy-mode sgmii; // 關鍵指定模式為sgmii phy-handle sgmii_phy; // 指向我們定義的“PHY” status okay; mdio { #address-cells 1; #size-cells 0; // 定義一個“PHY”地址為0。實際上對應EC20的內部控制器 sgmii_phy: ethernet-phy0 { compatible ethernet-phy-ieee802.3-c22; // 使用標準兼容性 reg 0; // PHY地址需與硬件設計匹配 // 可能需要的特殊屬性如固定鏈接模式 fixed-link { speed 1000; // 固定為千兆 full-duplex; // 全雙工 // 有時需要指定 pause 等流控屬性 }; }; } };關鍵點解析phy-mode sgmii;必須明確指定。fixed-link由于EC20內部不是標準的MDIO可管理PHY我們無法通過MDIO總線去讀取它的狀態寄存器比如鏈接狀態、速度協商。因此通常使用fixed-link屬性來告訴內核“這是一個固定鏈接速度就是1000M全雙工你別去嘗試協商了”。這是解決“鏈路不停up/down”或“速度識別為10M/100M”問題的關鍵。reg 0;這個PHY地址需要根據硬件設計來定如果EC20的MDIO管理地址是0這里就寫0。編譯與更新內核/設備樹修改設備樹源文件.dts后編譯生成設備樹二進制文件.dtb并更新到開發板。3.3 系統啟動與網絡接口識別更新設備樹重啟后觀察內核啟動日志dmesg | grep -i fec或dmesg | grep -i eth。成功跡象fec 2188000.ethernet eth1: registered PHC device 0 fec 2188000.ethernet eth1: SGMII link up fec 2188000.ethernet eth1: Link is Up - 1Gbps/Full - flow control rx/tx出現類似“SGMII link up”和“1Gbps/Full”的日志并且使用ifconfig -a或ip link show能看到eth1或其他編號接口狀態為UP就說明SGMII物理層和鏈路層已經通了。常見問題與排查看不到eth1接口檢查內核驅動是否編譯進內核或模塊檢查設備樹節點狀態是否為okay檢查引腳復用pinctrl配置是否正確。鏈路狀態不穩定頻繁up/down99%是硬件問題或fixed-link配置問題。用示波器仔細檢查SGMII差分信號和時鐘質量。確認設備樹中fixed-link的speed和full-duplex屬性是否正確。速度顯示為100M或10M同樣是fixed-link配置問題確保speed 1000;。也可能是硬件信號質量差導致自動協商雖然我們用了fixed-link但底層可能仍有機制失敗降速運行。當eth1接口穩定出現后它就是一個普通的以太網接口了。給這個接口配置一個IP地址如192.168.225.1并嘗試ping通EC20模組內部的網關地址通常是192.168.225.1這里需要查EC20 AT命令手冊通過ATCGDCONT和ATCGPADDR獲取這是驗證數據鏈路層是否完全暢通的關鍵一步。4. EC20 4G網絡撥號與路由配置SGMII鏈路通了只意味著主控和EC20模組之間可以通信了。要讓整個設備通過4G上網還需要在EC20內部建立PPPPoint-to-Point Protocol連接也就是常說的“撥號”。4.1 使用QMI協議進行撥號移遠模組通常支持多種撥號協議如PPP、QMI、MBIM。在嵌入式Linux中使用QMIQualcomm MSM Interface是一種更現代、功能更強大的方式。它通過USB或網口暴露一個控制端口使用libqmi工具和qmichannel驅動進行交互。安裝必要工具在文件系統中需要包含libqmi、qmi-utils等軟件包。可以通過Buildroot或Yocto在編譯根文件系統時加入。識別QMI設備當EC20通過SGMII“上網”后我們需要通過AT命令切換到QMI模式如果默認不是的話。通常發送ATQCFGusbnet,2可以設置為QMI模式具體AT命令需查手冊。然后在主控Linux中應該能看到一個新的網絡接口比如wwan0或者通過ls /dev/cdc-wdm*看到QMI的控制設備。執行撥號腳本撥號過程可以編寫成一個腳本。核心步驟如下#!/bin/bash # 1. 設置APN接入點名稱根據你的SIM卡運營商來定 APN3gnet # 2. 通過qmicli工具啟動網絡連接 # 首先獲取網絡服務客戶端 qmicli -d /dev/cdc-wdm0 --wds-start-networkip-type4,apn$APN --client-no-release-cid # 此命令會返回一個數據端口如net0 # 3. 為上一步返回的數據端口如net0配置IP和路由 ifconfig net0 up # 使用dhcp從模組獲取IP也可以靜態配置 udhcpc -i net0 -q # 或者 dhclient -v net0 # 4. 配置默認路由將所有流量指向4G網絡 # 先刪除可能存在的默認路由 ip route del default 2/dev/null # 添加通過net0接口的默認路由 ip route add default dev net0配置DNS撥號成功后運營商會分配DNS服務器地址。udhcpc或dhclient通常會自動更新/etc/resolv.conf。如果沒有可以手動添加例如echo nameserver 8.8.8.8 /etc/resolv.conf。4.2 網絡地址轉換NAT與防火墻設備通過net0上網了但設備上其他接口如Wi-Fi AP的接口wlan0上的設備還不能上網。這就需要用到NAT網絡地址轉換。啟用IP轉發echo 1 /proc/sys/net/ipv4/ip_forward為了讓重啟后生效需要修改/etc/sysctl.conf設置net.ipv4.ip_forward1。配置iptables實現NAT# 清除現有規則生產環境慎用 iptables -F iptables -t nat -F # 設置默認策略 iptables -P INPUT ACCEPT iptables -P FORWARD ACCEPT iptables -P OUTPUT ACCEPT # 在nat表的POSTROUTING鏈上添加MASQUERADE規則 # 這條規則的意思是從wlan0出去要從net0接口發出的數據包將其源IP地址偽裝成net0的地址 iptables -t nat -A POSTROUTING -o net0 -j MASQUERADE # 允許轉發來自wlan0去往net0的流量 iptables -A FORWARD -i wlan0 -o net0 -j ACCEPT # 允許轉發已建立連接及相關流量返回wlan0 iptables -A FORWARD -i net0 -o wlan0 -m state --state RELATED,ESTABLISHED -j ACCEPT同樣這些iptables規則需要保存并在開機時自動加載。注意事項在調試階段可以暫時把防火墻規則放得寬松一些如上面設置的默認策略為ACCEPT但產品化時必須根據安全需求嚴格配置INPUT、FORWARD鏈的規則僅開放必要的端口和服務。至此4G通道應該已經完全打通。你可以嘗試在設備上ping一個外網地址如8.8.8.8如果成功說明從主控到互聯網的路徑已經暢通。5. FC20 Wi-Fi模組AP模式配置實戰接下來我們要把FC20變成一臺無線路由器。這需要幾個步驟加載驅動、配置hostapd用于創建AP、配置DHCP服務器為連接的設備分配IP。5.1 驅動加載與接口確認FC20通過SDIO連接內核需要加載ath11k驅動。確保內核配置中啟用了CONFIG_ATH11K和CONFIG_ATH11K_SDIO如果使用SDIO接口。啟動后使用dmesg | grep ath11k查看驅動加載日志。成功的話使用iw dev命令應該能看到一個無線接口通常命名為wlan0或wlx...。# 查看無線接口 iw dev # 輸出示例 phy#0 Interface wlan0 ifindex 3 wdev 0x1 addr aa:bb:cc:dd:ee:ff type managed channel 1 (2412 MHz), width: 20 MHz, center1: 2412 MHz txpower 20.00 dBm如果接口類型是managed客戶端模式我們需要先將其設置為AP模式。但更常見的做法是直接用一個支持AP模式的網絡配置工具來管理它會自動處理模式切換。5.2 使用hostapd創建雙頻Wi-Fi熱點hostapd是Linux下創建無線接入點的標準工具。我們需要為它編寫一個配置文件同時定義2.4G和5G的SSID可以相同也可以不同。安裝hostapd確保文件系統中包含hostapd軟件包。創建配置文件例如/etc/hostapd/hostapd.conf。一個支持雙頻的簡化配置如下# 通用接口和驅動設置 interfacewlan0 drivernl80211 country_codeCN # 設置國家代碼影響可用信道和功率 hw_modeg # 2.4G的基礎模式 channel6 # 2.4G信道可改為1, 11等干擾少的 # 2.4GHz網絡配置 ssidMyIndustrialGateway_2G ignore_broadcast_ssid0 auth_algs1 wpa2 wpa_passphraseYourStrongPassword123 wpa_key_mgmtWPA-PSK wpa_pairwiseCCMP rsn_pairwiseCCMP # 5GHz網絡配置 (通過創建虛擬接口實現) # 首先需要確認驅動和硬件支持并發虛擬接口 # 這里使用 hostapd 的多 BSS 功能 bsswlan0_5g hw_modea # 5G的基礎模式 channel36 # 5G信道可選36, 40, 44, 48, 149, 153, 157, 161, 165 ht_capab[HT40][SHORT-GI-20][SHORT-GI-40][DSSS_CCK-40] vht_capab[SHORT-GI-80] ssidMyIndustrialGateway_5G ignore_broadcast_ssid0 auth_algs1 wpa2 wpa_passphraseYourStrongPassword123 wpa_key_mgmtWPA-PSK wpa_pairwiseCCMP rsn_pairwiseCCMP關鍵參數說明hw_modeg對應2.4GHza對應5GHz。channel2.4G建議用1、6、11這三個不重疊的信道。5G信道根據國家法規選擇中國常用36-64149-165。country_code非常重要必須正確設置否則可能無法使用5GHz頻段或最大發射功率受限。設置CN表示中國。wpa和rsn_pairwise設置WPA2加密和AESCCMP加密算法這是目前最安全通用的配置。啟動hostapdhostapd -B /etc/hostapd/hostapd.conf使用-B參數在后臺運行。查看日志tail -f /var/log/messages或使用iw dev wlan0 info確認接口模式已變為AP。實操心得FC20的ath11k驅動對并發虛擬接口即單個物理射頻同時提供2.4G和5G AP的支持可能需要較新的內核版本和特定的固件。如果上述多BSS配置不生效一個更穩妥但需要兩個物理射頻的方案是使用兩個獨立的FC20模組或者退而求其次只配置一個頻段2.4G或5G。另一種變通方法是配置一個雙頻合一的SSID讓AP根據情況在2.4G和5G之間切換但這需要更復雜的hostapd配置和驅動支持如802.11v/k/r。5.3 配置DHCP服務器dnsmasqAP創建好了手機能搜到Wi-Fi信號并連接但連接后設備沒有IP地址無法通信。我們需要一個DHCP服務器來分配IP。dnsmasq是一個輕量級的DHCP和DNS服務器非常適合嵌入式場景。安裝dnsmasq。配置dnsmasq。編輯/etc/dnsmasq.conf關鍵配置如下# 指定監聽無線接口 interfacewlan0 # 禁用對有線接口的服務除非你需要 no-dhcp-interfaceeth0 # 設置DHCP地址池、租期、網關和DNS dhcp-range192.168.100.100,192.168.100.200,255.255.255.0,12h dhcp-optionoption:router,192.168.100.1 # 網關地址即AP本身的IP dhcp-optionoption:dns-server,8.8.8.8,114.114.114.114為wlan0接口配置靜態IP這個IP就是上面設置的網關地址。ifconfig wlan0 192.168.100.1 netmask 255.255.255.0 up啟動dnsmasqdnsmasq -C /etc/dnsmasq.conf現在用手機連接MyIndustrialGateway_2G或MyIndustrialGateway_5G應該能成功獲取到192.168.100.x網段的IP并且可以ping通網關192.168.100.1。5.4 整合與自啟動最后我們需要將上述所有步驟整合到啟動腳本中如/etc/rc.local或systemd服務單元確保設備上電后能自動完成加載驅動識別EC20 SGMII接口eth1和FC20無線接口wlan0。配置EC20接口IP執行QMI撥號腳本建立4G連接net0。配置wlan0的靜態IP。啟動hostapd創建Wi-Fi熱點。啟動dnsmasq提供DHCP服務。配置iptables NAT規則開啟IP轉發讓連接Wi-Fi的設備能通過4G上網。6. 調試過程中遇到的典型問題與解決方案6.1 EC20 SGMII鏈路無法建立Link Down現象dmesg中始終顯示SGMII link downip link顯示接口狀態為DOWN。排查硬件第一用示波器測量SGMII的REFCLK125MHz是否穩定、幅值是否達標通常1.2V或1.8V LVDS。檢查TXD/RXD差分對是否有信號。設備樹檢查確認phy-mode sgmii;。確認fixed-link屬性是否正確設置speed1000; full-duplex;。檢查PHY地址reg值是否正確。電源與復位確保EC20模組的供電穩定尤其是為SGMIO接口供電的電源。檢查模組的復位信號是否正常釋放。解決我們的案例中調整主控端時鐘引腳的驅動強度解決了問題。如果硬件測量無誤可以嘗試在設備樹中為MAC節點添加一些延遲屬性如tx-delay和rx-delay單位ps以補償時序偏差。6.2 Wi-Fi AP啟動失敗hostapd報錯現象運行hostapd后報錯例如nl80211: Could not configure driver mode或Interface initialization failed。排查驅動與固件確認ath11k驅動已正確加載lsmod | grep ath11k。檢查必要的固件文件如WLAN.HK.2.0-xxxxx-2-fw.bin是否已放入/lib/firmware/ath11k/目錄。接口狀態運行iw list查看Supported interface modes是否包含AP。如果不包含可能是驅動或硬件不支持AP模式。國家代碼極其重要未設置或設置錯誤的country_code會導致無法使用任何無線功能特別是5GHz。在hostapd.conf中務必正確設置country_codeCN并確保系統區域設置一致可通過iw reg set CN命令設置。RF Kill有些硬件有射頻硬件開關RFKill。使用rfkill list查看如果被hard blocked需要檢查硬件如果被soft blocked使用rfkill unblock wifi解鎖。解決確保固件存在且驅動加載無誤在hostapd.conf首行就設置正確的國家代碼并在啟動hostapd前用rfkill和iw reg set命令做好環境準備。6.3 手機能連接Wi-Fi但無法上網現象手機顯示已連接Wi-Fi并獲取到IP但無法打開網頁ping外網地址不通。排查網關設備自身能否上網在網關上ping 8.8.8.8確認4G撥號成功且路由正確。IP轉發是否開啟檢查/proc/sys/net/ipv4/ip_forward是否為1。iptables NAT規則運行iptables -t nat -L -n -v和iptables -L -n -v檢查POSTROUTING鏈的MASQUERADE規則和FORWARD鏈的規則是否存在且匹配-o net0,-i wlan0等。防火墻屏蔽某些發行版默認防火墻如firewalld, ufw可能阻止轉發。臨時關閉防火墻測試iptables -F iptables -t nat -F iptables -P FORWARD ACCEPT。DNS問題手機能ping通8.8.8.8但打不開網頁可能是DNS問題。檢查dnsmasq配置中的dhcp-optionoption:dns-server是否正確或手動在手機上設置DNS。解決按照上述順序排查。最常見的原因是IP轉發未開啟或iptables NAT規則未正確配置。一個完整的診斷命令序列是cat /proc/sys/net/ipv4/ip_forward # 檢查轉發 iptables -t nat -L -n -v # 檢查NAT規則 iptables -L -n -v # 檢查過濾規則 # 在網關上跟蹤到手機IP和外網IP的路由 traceroute -i wlan0 手機IP # 在網關上抓取經過wlan0和net0的包 tcpdump -i wlan0 -n tcpdump -i net0 -n6.4 網絡性能不達標或不穩定現象4G下載速度遠低于理論值或Wi-Fi吞吐量低、延遲高。排查4G側通過EC20的AT命令如ATQENGservingcell檢查信號強度RSRP, RSRQ、小區信息。信號差是首要原因。其次檢查SGMII接口的ethtool eth1統計信息是否有大量的錯誤或丟包。Wi-Fi側使用iw dev wlan0 station dump查看已連接客戶端的信息包括信號強度、速率等。確保AP和客戶端處于干擾少的信道2.4G用1/6/115G用36/149等。檢查是否有同頻干擾。系統負載使用top或htop查看CPU占用率。hostapd、加密解密WPA2、NAT轉發iptables/conntrack都會消耗CPU資源。對于高流量場景考慮使用更高效的網絡工具如nftables替代iptables或硬件加速特性。解決優化天線擺放改善信號更換信道避免干擾對于高性能要求場景可能需要選用主頻更高的處理器并優化系統軟件配置。整個調試過程是對嵌入式系統軟硬件結合能力的全面考驗。從硬件原理圖、信號完整性到Linux內核驅動、網絡協議棧、無線配置每一個環節都需要仔細驗證。當最終看到設備指示燈規律閃爍手機通過Wi-Fi順暢地瀏覽網頁時那種成就感是對所有調試工作的最好回報。這套方案已經穩定運行在多個現場網關設備中證明了EC20 SGMIIFC20 AP方案的可行性。