USB NCM nel sistema operativo factory

Nota

finddevice è ora in github!

USB NCM (Network Control Model) è una funzionalità predefinita del sistema operativo Factory. Fornisce un dispositivo del sistema operativo Factory connesso a un PC host tramite USB un indirizzo IP locale di collegamento (169.254.0.0/16) nel PC host. Se più dispositivi del sistema operativo factory sono connessi allo stesso PC host vengono tutti assegnati indirizzi IP locali di collegamento univoci. Ciò consente a un PC host di comunicare contemporaneamente con qualsiasi numero di dispositivi del sistema operativo usb connessi alla factory.

Requisiti importanti per il supporto di USB NCM

• Il PC host deve anche supportare USB NCM. Aggiornamento di Windows 10 (maggio 2019) (build 18362) e versioni successive supportano gli host USB NCM senza funzionalità o driver Windows facoltativi necessari.
• La funzionalità WCOS_DEVICEPORTAL è impostata nell'immagine del sistema operativo Factory per consentire il funzionamento del codice di esempio di individuazione dei dispositivi USB NCM.

Comunicazione con il dispositivo del sistema operativo Factory con USB NCM

Dopo aver stabilito la connessione USB NCM, è possibile comunicare con il dispositivo del sistema operativo Factory usando il relativo indirizzo IP localhost dal PC host come se il dispositivo del sistema operativo Factory fosse connesso alla rete locale del PC host tramite ethernet. Ad esempio, dal PC host è possibile:

• Usare il open-device <NCM link-local IP Address> cmdlet TShell(connect-using-tshell.md#open-device-connect-tshell-to-target-device) per connettersi al dispositivo di destinazione con TShell
• Connettersi al dispositivo di destinazione tramite SSH
• Connettersi al dispositivo di destinazione usando l'app Factory Orchestrator o l'API client

Individuazione degli indirizzi IP locali di collegamento USB NCM a livello di codice

WSK include un eseguibile .NET Core 3.1 di esempio (finddevice.exe) e il codice sorgente che è possibile eseguire nel PC host per rilevare automaticamente gli indirizzi IP locali di qualsiasi dispositivo del sistema operativo usb connesso a Factory. Eseguire finddevice.exe -? per visualizzare l'elenco completo di argomenti supportati dal programma.

Combinare il codice sorgente finddevice.exe o il file eseguibile con uno script di PowerShell usando i cmdlet di TShell o un programma .NET Core che effettua chiamate API client di Orchestrator factory factory a livello di codice, consente di rilevare a livello di codice i dispositivi connessi del sistema operativo factory, stabilire una connessione ai dispositivi e quindi usare tali connessioni per interagire a livello di codice con i dispositivi connessi.

Il codice eseguibile e il codice sorgente predefiniti si trovano in: WSK\Program Files\Windows Kits\10\WSKSamples\UsbNcmFindDevice

Risoluzione dei problemi di connessione

Se si esegue finddevice.exe e non è possibile trovare dispositivi connessi, controllare quanto segue:

• Assicurarsi di aver soddisfatto i requisiti elencati in precedenza
• Verificare che il dispositivo venga visualizzato in Gestione dispositivi nel PC host
  • Il dispositivo deve essere visualizzato in Schede di rete
  • Il nome del dispositivo sarà "Dispositivo host UsbNcm"
• Il firewall del PC host può bloccare la comunicazione tra l'host e il dispositivo:
  • Creare una regola per consentire la comunicazione da finddevice.exe
  • Abilitare la regola per i tipi di rete Domain, Private e Public