Factory OS 上的 USB NCM

注意

finddevice現在位於 github！

USB NCM (網路控制模型) 是 Factory OS 的預設功能。 它提供透過 USB 連線到主機電腦的 Factory OS 裝置， (主機電腦上的 169.254.0.0/16) 。 如果多個 Factory OS 裝置連線到相同的主機電腦，它們全都會獲得唯一的連結本機 IP 位址。 這可讓一部主機電腦同時與任意數目的 USB 連線處理站 OS 裝置通訊。

USB NCM 支援的重要需求

• 主機電腦也必須支援 USB NCM。 Windows 10 2019 年 5 月更新 (組建 18362) 和更新版本支援為不需要選用 Windows 功能或驅動程式的 USB NCM 主機。
• WCOS_DEVICEPORTAL功能是在 Factory OS 映射中設定，讓USB NCM 裝置探索範例程式碼能夠運作。

使用 USB NCM 與 Factory OS 裝置通訊

建立 USB NCM 連線之後，您就可以使用主機電腦的 localhost IP 位址與處理站 OS 裝置通訊，就像 Factory OS 裝置透過乙太網路連線到主機電腦的區域網路一樣。 例如，從主機電腦，您可以：

• open-device <NCM link-local IP Address>使用 TShell Cmdlet (connect-using-tshell.md#open-device-connect-tshell-to-target-device) 使用 TShell 連線到目標裝置
• 透過SSH連線到目標裝置
• 使用Factory Orchestrator 應用程式或用戶端 API連線到目標裝置

以程式設計方式探索 USB NCM 連結本機 IP 位址

WSK 包含範例 .NET Core 3.1 可執行檔 (finddevice.exe) 和原始程式碼，您可以在主機電腦上執行，以自動偵測任何 USB 連線處理站 OS 裝置的連結本機 IP 位址。 執行 finddevice.exe -? 以查看程式所支援之引數的完整清單。

將finddevice.exe原始程式碼或可執行檔與使用 TShell Cmdlet 或 .NET Core 程式進行 Factory Orchestrator 用戶端 API 呼叫的 PowerShell 腳本結合，可讓您以程式設計方式偵測 USB 連線處理站 OS 裝置 () 、建立裝置 () 的連線，然後使用這些連線以程式設計方式與連線的裝置互動 () 。

預先建置的可執行檔和原始程式碼位於： WSK\Program Files\Windows Kits\10\WSKSamples\UsbNcmFindDevice

連接的疑難排解

如果您執行 finddevice.exe 且找不到任何已連線的裝置，請檢查下列各項：

• 請確定您已符合上述需求
• 確認您的裝置出現在主機電腦上的 裝置管理員
  • 裝置應該會出現在[網路介面卡]底下
  • 裝置名稱會是 「UsbNcm 主機裝置」
• 主機電腦的防火牆可能會封鎖主機與裝置之間的通訊：
  • 建立規則以允許來自的通訊 finddevice.exe
  • 啟用網域、私人和公用網路類型的規則