RF 工具

發行項
08/09/2023

無線電頻 (RF) 工具可在根據 Azure 球體的設計驗證和硬體製造期間，視需要啟用低階控制無線電裝置。這些工具組括可控制和顯示 RF 設定的互動式應用程式。

如果您正在設計包含 MT3620 晶片的面板或模組，您必須先測試並校正無線電波，才能出貨該面板或模組。如果您正在製造連接的裝置，其中包含來自其他供應商的面板或模組，供應商應該已經執行 RF 測試;如有任何問題，請洽詢您的供應商。

製造連線裝置包括 RF 測試如何配合製造工作流程的相關資訊。

重要

RF 工具需要 啟用 RF 測試模式 功能。此功能預設會出現在處於 [空白] 製造狀態的白板上，但在 Module1Complete 或 DeviceComplete 狀態中無法使用。

使用 azsphere 裝置功能顯示附加命令來判斷您的裝置上是否存在此功能。如果您需要在沒有此功能的裝置上執行 RF 工具，請依照要求 RF 工具連絡 Microsoft 以取得協助中的指示進行。

RF 工具只會使用必須連接到電腦上的 USB 埠的服務 UART 埠。 RF 工具要求未來技術裝置國際 (FTDI) FT4232HQ UART 對 USB 介面晶片公開 UART。如需服務 UART 埠的詳細資料，請參閱 MCU 程式設計與偵錯介面。

要求 RF 工具

當客戶、合作夥伴和安全性研究者提出要求時，Microsoft 會提供 RF 工具套件。您可以向技術銷售專業人員要求他們 (TSP) 。如果您沒有 TSP，請傳送內含下列資訊的電子郵件 azspheremfrsamplesup@microsoft.com ：

您的名稱、組織和連絡人資訊。
如果您有 Microsoft 帳戶小組或 TSP 的連絡人資訊，
如果您建置模組 (而非直接) 使用 MT3620 晶片的裝置，您必須使用 RF 工具。
您計畫使用工具執行的測試類型。
製造 (裝置需要製造/認證) 的預計時程表。

Microsoft 代表將與您合作，決定適當的通訊通道。

設定與安裝

您必須先使用最新的軟體來設定您的電腦和 MT3620 裝置，然後解壓縮工具，如下列各節所述。

電腦設定

使用目前的 Azure 球體 SDK設定您的電腦。

MT3620 裝置設定

設定電腦之後，請確定您的 MT3620 裝置執行的是最新的 Azure 球體作業系統。依照目前版本的版本資訊中的指示操作。

RF 工具安裝

將 RF 工具套件解壓縮到電腦上的目錄。產生的資料夾包含四個子資料夾：

設定，其中包含可促進無線電設定設定的檔案
文件庫，其中包含用於執行 RF 測試的 C、C# 和 Python 文件庫
rftest-server，其中包含預先建立的工具所使用的 rftest-server.imagepackage，或您使用 RF 工具庫建立的應用程式。
工具中包含 MacAddressTool、RfToolCli、RfSettingsTool、Windows x86、x64 和 Linux) (x64) 和 Python ( (MacAddressTool、RfSettingsTool) 目錄的預先建立應用程式。

MT3620 RF 設定與校正

MT3620 會將無線電設定和校正資料儲存在電子合成中，且可進行有限的程式設計次數。此資料包括晶片應支援的無線電頻段 (，例如 2.4GHz 或 5GHz) 、調整傳輸電源，以及裝置上的天線設定。如需電子合成設定的詳細資訊，請參閱 MediaTek 提供的 MT3620 N9 E-fuse 內容指導方針。

天線變異

無線電訊號會從環境中的物件退回。因此，單一無線電訊號會採用從傳輸器到接收器的多個路徑。由於這些無線電訊號的行經距離不同，因此會在不同時間到達接收器。有時候，送達的訊號會干擾破壞性，而天線也不會看到任何訊號。解決此問題的其中一個方法是透過天線變異。 為提供天線多樣性，第二個方向不同的天線會放置短距離 (至少四分之一的波寬) 遠離第一個天線。

MT3620 支援兩種天線多樣性設定，它們是使用無線電電子合成來設定。圖中顯示這兩種設定。

天線變異

左側的設定顯示 接收多樣性 (RX 多樣性) 。在此設定中，第二個天線會連接到助天線埠。如果主天線埠上收到的訊號等級低於特定閾值，MT3620 會在接收資料時自動切換到第二個天線。在此設定中，傳輸仍必須使用主要天線。

右側的設定顯示 傳輸和接收變異 ( TX 和 RX 多樣性) ，使用次要天線來傳輸和接收。 MT3620 是透過使用外接式雙極線、雙回 (DPDT) 開關來達到此目的，這可讓訊號路由至任一天線。在傳輸和接收多樣性設定中，未使用助天線埠。 MT3620 有兩個專用的天線選取釘，用於控制此外接式開關。

緩衝區間

在 RF 測試期間，MT3620 可以使用動態記憶體中的值，而非永久的 e-fus，這樣測試運算子和設備就可以在不永久變更電子合成的情況下調整這些設定。用來儲存這些設定的動態記憶體稱為「緩衝區間」。測試運算子或設備確定緩衝區間中的值正確無誤之後，緩衝區間隔的狀態就可以永久寫入電子合成。

進入 RF 測試模式時，您可以載入「預設緩衝區間隔」檔案，將緩衝區區的內容設定為已知的預先設定值。測試運算子或設備可以視需要設定其他設定或校正值。

RF 工具套件在 Configurations\MT3620 目錄中提供多個預設緩衝區間檔案。這些檔案可用來將裝置初始化為預先設定的狀態，或覆寫先前已在裝置上測試 (DUT) 下，程式化為永久電子合成的任何校正設定。

下列緩衝區間檔案支援使用主要天線的傳輸：

MT3620_eFuse_N9_V5_20180321_24G_5G_NoDpdt.bin 會將無線電設置為同時支援 2.4GHz 和 5GHz 作業。
MT3620_eFuse_N9_V5_20180321_24G_Only_NoDpdt.bin 會將無線電設置為僅支援 2.4GHz 作業。

下列緩衝區間檔案支援使用助天線傳輸：

MT3620_eFuse_N9_V5_20180321_24G_5G_Dpdt.bin 支援 DPDT 參數的 2.4GHz 和 5GHz 運算。
MT3620_eFuse_N9_V5_20180321_24G_Only_Dpdt.bin 支援 DPDT 參數的 2.4GHz 運算。

預設緩衝區間檔案可以進一步自訂到您的特定裝置應用程式。如需其他自訂選項，請連絡 MediaTek 或 Microsoft。

RF 工具使用量完成後

在製造裝置上完成 RF 測試和校正之後，應該從裝置移除 rftest_server.imagepackage ，並且應設定裝置的製造狀態，以防止進一步的 RF 設定修改。

移除 rftest_server.imagepackage

使用 RF 工具之後，名為 rftest_server.imagepackage 的套件可能會留在裝置上。此作業系統套件可讓您透過 FTDI 介面存取低階 RF 設定。當裝置下一步連線至 AS3 時，AS3 會自動移除此套件。不過，使用 RF 工具的製造商應該在 RF 測試完成時刪除此套件。

若要刪除套件：

執行 azsphere 裝置映射 命令，如下所示：
```
azsphere device image list-installed --full
```
檢查是否已安裝名為 rftest_server的元件。若是如此，請執行 azsphere 裝置側載 命令，後面接著 azsphere 裝置映射 命令，如下所示：
```
azsphere device sideload delete -component-id 508eddf2-b8c3-4a99-93d9-a045d9a060eb
```
執行此命令之後，裝置將會重新開機。
```
azsphere device image list-installed --full
```
請 注意，執行 此命令之後，rftest_server圖像套件已不再出現。

注意

如果您在 Linux 上執行 RfTools，您可能需要在 RfTool 程式上設定執行許可權在 [工具]/[預先建立]/[Linux-x64] 資料夾中，執行此命令以在 RfToolCli 上設定許可權。

chmod +x RfToolCli

防止進一步修改 RF 設定

為了避免進一步修改 RF 設定，您應將裝置的製造狀態設為 Module1Complete。

請注意，如果裝置會立即繼續進行應用程式載入 (例如，在單一生產線) 上完成 RF 測試和裝置軟體載入的晶片式設計，則可以略過此步驟。在應用程式載入和測試程式結束時，裝置會移至 DeviceComplete 狀態，這也會防止 RF 設定修改。

RfToolCli

RfToolCli 是互動式命令列工具，可讓低階控制 MT3620 無線電以進行測試和診斷。執行此工具之前，請確定在測試 (DUT) 下的裝置已連線，並執行最新的 Azure 球體作業系統。

若要使用此工具，請開啟命令提示字元/終端機視窗，移至包含 RfToolCli 應用程式的目錄，然後執行 RfToolCli。 RfToolCli 有下列啟動選項：

RfToolCli [-BufferBin <filename>] [-Image <filename>] [-Device <IP address of device to use [Default: 192.168.35.2]>]

-BufferBin 選項會傳遞自訂預設緩衝區間隔組態檔的路徑。根據預設，RfToolCli 會使用程式設計到裝置上的無線電設定。這些設定包括任何傳輸電源調整、允許的頻帶和天線設定。若要使用替代設定檔案，請使用 -BufferBin 選項提供檔案路徑。

-圖像選項會傳遞 rftest-server.imagepackage 檔案的路徑。此映射套件檔案必須載入至 DUT，才能讓裝置進入 RF 測試模式。 rftest-server 會與 RfToolCli 程式在同一個資料夾中提供，而在大多數情況下，RfToolCli 可以找到此檔案。如果您從不同的位置執行 RfToolCli，您可能需要使用 -Image 選項來傳遞此檔案的路徑。

啟動時，RfToolCli 會準備裝置，然後顯示互動式提示：

RfToolCli
Preparing DUT...
>

RFToolCli 提供下表中列出的命令。

命令 (縮寫) 選項	描述
天線 {aux \| main}	選取助動或主天線。
頻道號碼	選取頻道。
設定為已讀取 {macaddress \| data}	取得裝置 MAC 位址和緩衝區區資料。
設定書寫 {macaddress \| data}	設定裝置 MAC 位址和緩衝區區資料。
設定儲存	將 MAC 位址或緩衝區區資料的變更儲存為永久的電子合成。
退出	結束程式。
說明命令名稱	在命令上顯示說明。
接收 (rx) {start \| stop \| stats}	開始或停止接收，或顯示已接收封包的統計資料。
設置	顯示目前的無線電設置。
showchannel (sc)	列出裝置支援的頻道。
傳輸 (tx) {frame \| 模式 \| 電源 \| 速率 \| start}	設定及傳輸封包。設定封包的框架、模式、電源和評分選項;每個都有可定義相關組態設定的參數。 [開始] 選項會開始傳輸。

您可以輸入說明，後面接著命令名稱，以及一個選項，以取得任何命令的說明。例如：

help transmit frame
Usage:
Transmit Frame [-BSS <Str>] [-Destination <Str>] [-Duration
<UInt16>]
[-FrameControl <UInt16>] [-Source <Str>]
Configure transmit frame header
Optional Parameters:
-BSS <Str> - BSS MAC address (in colon-delimited format)
-Destination <Str> - Destination MAC address (in colon-delimited
format)
-Duration <UInt16> - Frame duration [Alias: -D]
-FrameControl <UInt16> - Frame Control Number [Alias: -F]
-Source <Str> - Source MAC address (in colon-delimited format)

範例：檢視啟動設定

啟動時，RfToolCli 會設定數個預設值，包括傳輸模式、資料速率和通道。若要檢視這些啟動設定，請使用 [設定] 命令。

 > settings
 ------Radio------

 Mode: Normal
 Power: 16.0
 Channel: 1
 Rate: Ofdm54M

---TX Frame Header---

Frame Control: 8000
Duration: 2000
BSS MAC: 62:45:8D:72:06:18
Source MAC: AC:AC:AC:AC:AC:AC
Destination MAC: 62:45:8D:72:06:18

---TX Frame Data---

Frame Size: 1000
Use Random Data: True

範例：設定通道並取得收到封包統計資料

此命令順序會將無線電波置於指定的 802.11 通道上的接收模式，然後取得所收到封包的統計資料：

> channel 9
Setting channel to 9
> rx start
Starting receive
> rx stats
Total packets received: 2578
Data packets received: 4
Unicast packets received: 0
Other packets received: 4
>

範例：目前通道上的傳輸封包

此命令會造成無線電波傳送目前通道上的封包：

> transmit start
Starting transmit
Press any key to stop transmission

範例：在目前通道上以連續模式傳輸封包

此命令會使無線電波以連續模式傳輸目前通道上的封包，直到您停止傳輸或設定不同的模式為止：

> tx mode continuous
> tx start
Starting transmit
Press any key to stop transmission

當裝置以連續模式傳輸時，封包之間沒有空格，這對測量電源很有用。

範例：傳送目前通道上的連續音調

此命令順序會讓收音機在目前頻道上傳輸音調，直到您按下按鍵為止。

> tx mode continuouswave
> tx start
Starting transmit
Press any key to stop transmission

範例：Get the device's currently confired MAC address

此命令會讀取裝置上目前設定的 MAC 位址。

> config read MacAddress
Device MAC address: 4E:FB:C4:1C:4F:0C

範例：設定裝置的 MAC 位址

此命令會將新的 MAC 位址寫入裝置的緩衝區區。如果已為裝置設定 MAC 位址，系統會要求您確認變更。

> config write MacAddress 02:12:ab:cd:ef:11
Device already has MAC address 4E:FB:C4:1C:4F:0C
Are you sure you want to modify this? (y/N):y

注意

若要永久變更緩衝區間或 MAC 位址，請使用 [設定儲存 ] 命令。

範例：設定組態資料的一個位元組

設定寫入資料命令可用來在指定的緩衝區區位址設定一個位元組的資料。

> config write data 0x34 0xDD

範例：Display device configuration data

設定讀取資料命令會輸出裝置緩衝區區中的整個內容。

> config read data
Current configuration data:
0x0000: 20 36 04 00 B2 EE D2 16 E5 73 00 00 00 00 00 00
0x0010: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x0020: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x0030: 00 00 00 00 00 00 00 00 FF FF 20 00 60 00 CC 00
...

範例：將組態資料儲存至電子合成

設定儲存命令會將緩衝區區間的任何變更永久寫入到非動態的電子合成。電子合成只能撰寫有限的次數，因此我們強烈建議您先執行所有的緩衝區間變更，然後在單一步驟中將這些變更寫入電子合成。

> config save
About to commit data to non-volatile storage
Changes will be permanent. Continue? (y/N):y
Done

RF 設定工具

RF 設定工具會顯示 MT3620 電子合成設定，讓您可以驗證設定是否正確。與 RfToolCli 不同，RF 設定工具是唯讀的。因此，即使在特定裝置上停用無線電測試功能之後，也可以用來檢查裝置設定。

若要使用工具，請開啟命令提示字元/終端機視窗，移至 [工具]/[預先建立]/ < [Win-x86] |Win-x64 |Linux-x64 > 資料夾，然後執行 RfSettingsTool。工具有兩個命令，並且有兩個啟動選項：

RfSettingsTool <command> [--image <filename>] [--usefile <filename>] [-Device <IP address of device to use [Default: 192.168.35.2]>]

支援下列命令：

命令 (縮寫)	描述
檢查 (c)	驗證 MT3620 裝置設定資料
協助 (？)	顯示說明資訊
顯示 (的)	顯示 MT3620 組態資料。

RfSettingsTool 檢查命令

RfSettingsTool 檢查命令會讀取附加裝置的設定，並與包含預期設定的緩衝區間組態檔進行比較。檢查命令具有下列格式：

RfSettingsTool check --expected <filename> [--image <filename>] [--nomacaddress] [--showconfig] [--usefile <filename>] [--verbose]

參數 (縮寫)	描述
--expected filename (-e)	包含要檢查之預期電子合成設定的緩衝區間檔案路徑。必填。
--image filename (-i)	RF 測試圖像的路徑。如果省略，預設為 rftest-server.imagepackage。選。
--nomacaddress (-n)	表示不應在裝置上設定 MAC 位址。選。
--showconfig (-s)	在檢查後顯示裝置設定。選。
--usefile 檔案名 (-u)	讀取指定檔案的組態資料，而不是附加的裝置。選。
--詳細資訊 (-v)	顯示額外的輸出資訊。

例如，下列命令會驗證無線電設置符合指定緩衝區間隔檔案中的設定：

> RfSettingsTool check --expected ..\Configurations\MT3620\
MT3620_eFuse_N9_V5_20180321_24G_5G_DPDT.bin

針對此命令，RfSettingsTool 會檢查下列專案。命令必須全部正確才能成功：

區碼與預期設定相同
外部天線開關呈現與預期設定相同的內容
天線設定與預期設定相同
與預期設定完全相同的目標電源
操作頻帶與預期設定相同
MAC 位址已設定

未核取特定裝置的無線電電源位移。

RfSettingsTool 顯示命令

RfSettingsTool 顯示命令會以人性化的方式顯示已在 MT3620 e-fus 上設定的無線電設定。顯示的欄位是使用者可設定的無線電設置。檢查命令具有下列格式：

RfSettingsTool show [--hexdump] [--image <filename>] [--usefile <filename>] [--verbose]

參數 (縮寫)	描述
--hexd但 (-x)	顯示電子合成的原始十六進位內容。選。
--image filename (-i)	RF 測試圖像的路徑。如果省略，預設為 rftest-server.imagepackage。選。
--usefile 檔案名 (-u)	讀取指定檔案的組態資料，而不是附加的裝置。選。
--詳細資訊 (-v)	顯示額外的輸出資訊。

下列範例顯示 顯示顯示 命令的部分輸出：

> RfSettingsTool show
Reading configuration data from device.
--------------------------------------------------------------------------------
MAC Address : C6:76:EC:79:1D:6B
--------------------------------------------------------------------------------
Region : GB
--------------------------------------------------------------------------------
External RF switch : Present
2.4GHz Diversity : MainOnly
5GHz Diversity : MainOnly
.
.
.

RF 測試 C 文件庫

RF 工具套件包含一個 C 文件庫，可用來開發您自己的測試程式。 C 文件庫位於文件庫\C 目錄中。 C API 的頁首檔案可在文件庫\C\Include 資料夾中使用，而使用該文件庫所需的二進位檔案則會在文件庫\C\Bin 資料夾中提供。如果您想要使用文件庫，請連絡 Microsoft 以取得檔。

RF 測試伺服器映射 (rftest-server.imagepackage) 也提供在 Bin 資料夾中。此影像必須先載入測試的裝置上，裝置才能進入 RF 測試模式。 C 文 檔庫中的mt3620rf_load_rf_test_server_image () 函數會以程式設計方式載入影像套件。

如果您轉散發使用 C 文件庫的應用程式，您必須包含文件庫\C\Bin 的 DLL 檔案，以及 rftest-server.imagepackage 檔案。

跨作業系統版本之 RF 工具的相容性

不保證一個作業系統版本的 RF 工具會在所有作業系統版本中相容。一般而言，建議您使用與在裝置上執行之作業系統所執行之製造套件一起發行的工具 (版本及相關的 C 文件庫) 。

下表摘要說明工具版本與 Azure 球體作業系統版本的相容性。

RF 工具版本	作業系統版本
23.05	22.02 及更新版本
21.01	21.01 及更新版本
20.10	20.07 或 20.10
20.07	20.07
20.04	20.04 或 20.01
20.01	20.04 或 20.01

重要

請注意，您可能需要更新您的裝置 OS 或部署更新的受信任 Keystore.bin，才能使用 23.05 版的 RF 工具，如需詳細資訊，請參閱此處。

請參閱 Azure 球體的新增功能，以瞭解目前版本中任何其他變更。

勘誤表

下列 errata 適用于 MT3620 硬體上所有版本的 RF 工具。其他版本特定問題會列在屬於工具套件一部分的 README 檔案中。

MT3620 Wi-Fi 韌體有次要錯誤：

如果您切換到連續模式傳輸 (tx 模式連續) 並開始傳輸， (tx 在停止標準模式傳輸之後立即啟動) ，就不會有訊號輸出。

若要解決此問題，請停止 [接續原生模式] 傳輸並重新啟動，以便進行傳輸。在此之後，[接續本頁] 模式傳輸將會正常運作。

從 [連續模式] 切換到 [標準模式] 時不會發生問題。
從連續波傳輸模式切換到標準或連續傳輸模式時，傳輸功率會不正確地增加 +6 dB。您必須重新初始化無線電波，才能將電源等級恢復正常。
- 如果使用 RfToolCli 互動式工具，請結束並重新啟動工具，藉此重新安裝無線電波。
- 如果使用 C、C# 或 Python 文件庫，請呼叫mt3620_reinitialize_buffer_bin () 函數。這也會重新安裝無線電波，並可用來解決此問題。

共用方式為

RF 工具

要求 RF 工具

設定與安裝

電腦設定

MT3620 裝置設定

RF 工具安裝

MT3620 RF 設定與校正

天線變異

緩衝區間

RF 工具使用量完成後

移除 rftest_server.imagepackage

防止進一步修改 RF 設定

RfToolCli

範例：檢視啟動設定

範例：設定通道並取得收到封包統計資料

範例：目前通道上的傳輸封包

範例：在目前通道上以連續模式傳輸封包

範例：傳送目前通道上的連續音調

範例：Get the device's currently confired MAC address

範例：設定裝置的 MAC 位址

範例：設定組態資料的一個位元組

範例：Display device configuration data

範例：將組態資料儲存至電子合成

RF 設定工具

RfSettingsTool 檢查命令

RfSettingsTool 顯示命令

RF 測試 C 文件庫

跨作業系統版本之 RF 工具的相容性

勘誤表

其他資源