Compartilhar via

NCM USB no sistema operacional de fábrica

Observação

finddevice agora está no github!

O USB NCM (Modelo de Controle de Rede) é um recurso padrão do sistema operacional de fábrica. Ele fornece a um dispositivo de sistema operacional de fábrica conectado a um computador host por USB um endereço IP local de link (169.254.0.0/16) no computador host. Se vários dispositivos do sistema operacional de fábrica estiverem conectados ao mesmo computador host, todos receberão endereços IP exclusivos de link local. Isso permite que um computador host se comunique simultaneamente com qualquer número de dispositivos do sistema operacional de fábrica conectados por USB.

Requisitos importantes para suporte a USB NCM

  • O computador host também deve dar suporte ao NCM USB. Atualização de maio de 2019 para o Windows 10 (build 18362) e posteriores dão suporte a hosts USB NCM sem necessidade de nenhum recurso ou driver opcional do Windows.
  • O recurso WCOS_DEVICEPORTAL é definido na imagem do sistema operacional de fábrica para que o código de exemplo de descoberta de dispositivo NCM USB funcione.

Comunicando-se com o dispositivo do sistema operacional de fábrica usando o NCM USB

Depois que a conexão USB NCM for estabelecida, você poderá se comunicar com o dispositivo do sistema operacional de fábrica usando seu endereço IP de localhost do computador host como se o dispositivo do sistema operacional de fábrica estivesse conectado à rede local do computador host por meio de ethernet. Por exemplo, no computador host, você pode:

  • Use o cmdlet do open-device <NCM link-local IP Address> TShell (connect-using-tshell.md#open-device-connecting-tshell-to-target-device) para se conectar ao dispositivo de destino com o TShell
  • Conectar-se ao dispositivo de destino por SSH
  • Conectar-se ao dispositivo de destino usando o aplicativo Factory Orchestrator ou a API do cliente

O WSK inclui um executável (finddevice.exe) do .NET Core 3.1 de exemplo e um código-fonte que você pode executar no computador host para detectar automaticamente os endereços IP locais do link de qualquer dispositivo do sistema operacional de fábrica conectado a USB. Execute finddevice.exe -? para ver a lista completa de argumentos compatíveis com o programa.

Combinar o código-fonte finddevice.exe ou executável com um script do PowerShell usando cmdlets do TShell ou um programa do .NET Core que faz chamadas à API do Cliente do Orchestrator de Fábrica, permite detectar programaticamente dispositivos do sistema operacional de fábrica conectados por USB, estabelecer uma conexão com os dispositivos e, em seguida, usar essas conexões para interagir programaticamente com os dispositivos conectados.

O executável predefinido e o código-fonte estão localizados em: WSK\Program Files\Windows Kits\10\WSKSamples\UsbNcmFindDevice

Solução de problemas de conexões

Se você executar finddevice.exe e não conseguir encontrar nenhum dispositivo conectado, marcar o seguinte:

  • Verifique se você atendeu aos requisitos listados acima
  • Verifique se o dispositivo aparece em Gerenciador de Dispositivos no computador host
    • O dispositivo deve aparecer em Adaptadores de rede
    • O nome do dispositivo será "Dispositivo Host UsbNcm"
  • O firewall do computador host pode estar bloqueando a comunicação entre o host e o dispositivo:
    • Criar uma regra para permitir a comunicação de finddevice.exe
    • Habilitar a regra para os tipos de rede Domínio, Privado e Público