相容性
支援的硬體
Vonode 節點能在哪些主機上執行、能使用哪些行動網路模組。每一項都註明依據:已在實際硬體上測試,或程式碼已支援但尚未測試。
已實測Vonode 團隊已在實際硬體上驗證。每個型號分別標出測試過的功能。
相容同一模組系列或已列入節點的型號表,或只試過單項功能;尚未在硬體上完整測試。
規劃中暫不支援,預計在後續版本提供。
不支援已知無法使用,或不在節點的設計範圍內。
主機
節點在一台長時間開機的 Linux 電腦上執行。依處理器架構列出需求:
- 作業系統
- Debian 12、Ubuntu 22.04 以上版本,或 Fedora,需使用 systemd(安裝套件的需求)
- 安裝方式
- systemd 安裝套件(本版本建議);Docker Compose 即將推出
- 系統套件
- 完整的 iproute2(ip -V 輸出 iproute2)、核心驅動程式 option 和 qmi_wwan;Wi-Fi 通話需要 /dev/net/tun
- 模組存取
- root 權限;已停用並禁止啟動 ModemManager
- 網路
- 手機能透過連接埠轉送或 VPN 連到 TCP 2222 連接埠(預設)
- 硬體範例
- Intel N100 迷你電腦、二手精簡型電腦或 NUC;節點本身只需 2 GB 記憶體和 4 GB 磁碟
- 驗證平台
- Ubuntu 22.04,amd64
- 作業系統
- 待確認
- 安裝方式
- 使用多架構映像檔的 Docker Compose(預計在 1.3.1 提供)
- 系統套件
- 待確認
- 模組存取
- 待確認
- 網路
- 待確認
- 硬體範例
- Raspberry Pi 4 和 5、RK3588 開發板(待確認)
- 驗證平台
- 尚未測試
行動網路模組
節點透過 USB,用模組的序列埠(AT)和 QMI 介面驅動採用高通平台的模組。一個節點最多連接五個模組。
已實測
部分實測
程式碼支援,未測試
不支援
測試過的功能(DJI Cellular 模組):經行動網路和 Wi-Fi 通話收發簡訊;Wi-Fi 通話註冊、雙向有聲的來電和撥出、通話保留與恢復;eSIM 設定檔切換;行動數據連線。行動網路通話目前在所有模組上都尚未確認。
| 模組 | 狀態 | 驗證平台 |
簡訊 | 行動網路通話 | Wi-Fi 通話 |
eSIM | 行動數據 | 說明 |
| DJI Cellular 模組內建 Quectel EG25-G · 需先切換一次 USB 識別 |
已實測 | amd64 · Ubuntu 22.04 | 已實測已實測 | 不支援不支援 | 已實測已實測 | 部分實測部分實測 | 已實測已實測 |
已測試兩台。簡訊:經行動網路接收,經 Wi-Fi 通話收發。行動網路通話:不支援;通話可經 Wi-Fi 通話進行。eSIM:在可插拔 eUICC 卡上切換設定檔;下載設定檔尚未測試。詳見下方「使用 DJI Cellular 模組」。 |
|---|
| Quectel EG25-GUSB 2c7c:0125 |
相容 | 未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 |
與已測試的 DJI 模組內部是同一款模組,但尚未單獨測試。 |
|---|
| Quectel EC25EC25-E、-AF、-AU、-J 等地區版本 |
相容 | 未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 |
與 EG25-G 屬於同一 USB ID 系列。請購買適合你所在國家或地區頻段的版本。 |
|---|
| Quectel EC20USB 2c7c:0125 系列 |
相容 | amd64 · Ubuntu 22.04 | 程式碼支援,未測試程式碼支援,未測試 | 部分實測部分實測 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 |
曾用一個模組試過行動網路通話:USB 音訊可以開啟,但尚未確認雙向有聲的通話。其他功能未測試。 |
|---|
| Quectel EC21 和 EG21LTE Cat 1 |
相容 | 未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 |
已列入節點的型號表。 |
|---|
| Quectel EM05、EM06 和 EG06M.2 和 Mini PCIe LTE |
相容 | 未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 |
已列入節點的型號表。需要具備 USB 和 SIM 卡槽的轉接板。 |
|---|
| Quectel RM500Q5G · M.2 |
相容 | 未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 | 程式碼支援,未測試程式碼支援,未測試 |
5G 下的表現尚未確認。需要具備 SIM 卡槽的 M.2 轉 USB 3 轉接板。 |
使用 DJI Cellular 模組
DJI Cellular 模組內建 Quectel EG25-G。出廠時它回報的是 DJI 的 USB ID(2ca3:4006),Linux 標準驅動程式無法辨識。把它的 USB 識別切換成 Quectel 一次後,節點就會把它當作 EG25-G 使用。我們硬體測試用的模組,就是這樣切換過的 DJI Cellular 模組。
示意圖:這次切換只改變模組回報的 USB ID。
傳送任何指令之前,請先閱讀
- 這些指令只修改模組的 USB 識別,不修改 IMEI、韌體,也不修改任何射頻參數。
- 修改後,在恢復原識別之前,模組可能無法在 DJI 裝置上使用;也可能影響保固。風險由你自行承擔。
- 切勿修改模組的 IMEI。在許多國家,這是違法行為。
讓 AT 埠出現
把模組插到 Linux 主機上。DJI 模式下標準序列埠驅動程式不會自動綁定,所以先載入驅動程式,並在本次工作階段中加入 DJI 的 ID。之後模組會出現幾個 ttyUSB 連接埠。
$ sudo modprobe option
$ echo 2ca3 4006 | sudo tee /sys/bus/usb-serial/drivers/option1/new_id
$ ls /dev/ttyUSB*
開啟 AT 埠
AT 埠通常是 /dev/ttyUSB2,但編號以你的系統為準:輸入 AT 後回覆 OK 的那個連接埠就是 AT 埠。可以使用 picocom、minicom 或 screen 等任何序列埠終端機(picocom 按 Ctrl-A 再按 Ctrl-X 離開)。
$ sudo picocom -b 115200 /dev/ttyUSB2
切換為 Quectel 識別
在序列埠終端機中輸入這兩道指令。第二道會重新啟動模組;新的識別在斷電後仍會保留。
AT+QCFG="usbcfg",0x2C7C,0x0125,1,1,1,1,1,0,0
檢查結果
重新啟動完成後,lsusb 應顯示 2c7c:0125(Quectel)。此時節點的安裝指令碼就能偵測到這個模組。
$ lsusb | grep -i -E '2c7c|2ca3'
恢復 DJI 原識別
如果要把模組重新用在 DJI 裝置上,用同樣的方法開啟 AT 埠並傳送這兩道指令。之後 lsusb 會重新顯示 2ca3:4006。
AT+QCFG="usbcfg",0x2CA3,0x4006,1,1,1,1,1,0,0
指令改編自 wlzh/dji-4g-vohive-mac, 授權條款為 CC BY 4.0. 改動:改寫為互動式序列埠終端機的操作步驟,並加入驅動程式綁定、尋找 AT 埠和 lsusb 檢查。
DJI 是 SZ DJI Technology Co., Ltd. 的商標;Quectel 是 Quectel Wireless Solutions Co., Ltd. 的商標;Vonode 與 DJI 及 Quectel 無關聯,也未獲得其認可。
SIM 卡與電信業者
- 請先在手機上關閉 SIM 卡的 PIN 碼。實體 SIM 卡插上即可使用。
- 模組沒有內建 eSIM。要使用 eSIM 設定檔,請在模組的 SIM 卡槽插入一張可插拔 eUICC 卡(俗稱「eSIM 卡」)。
- Wi-Fi 通話需要電信業者在你的資費方案中開通,和手機上一樣。模組必須至少用這張 SIM 卡在行動網路上註冊過一次。
- Vonode 無法保證某家電信業者或資費方案一定可用。能否使用取決於電信業者的網路和資費方案。
不支援
- 只提供網路卡功能的 USB 網卡(HiLink、僅 RNDIS 或僅 ECM 韌體)。節點需要模組的序列埠和 QMI 介面。
- 非高通晶片平台的模組,包括上表未列出的 Quectel 系列。
- 其他廠商的模組尚未測試。部分功能使用 Quectel 專用的 AT 指令。
- OpenWrt 路由器、macOS 或 Windows 上的 Docker Desktop,以及沒有 USB 直通的虛擬機器。
- 本版本暫不支援 ARM 主機:預計在 1.3.1 提供,見上方 arm64 一欄。