Partilhar via

Suporte experimental do Azure Sphere WSL2

Importante

Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (Integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

Agora você pode usar o WSL2 (Subsistema Windows para Linux 2) para desenvolver aplicativos para o Azure Sphere. O WSL2 permite uma experiência de desenvolvimento Linux para o Azure Sphere que não requer que você mude de máquina. Apenas ambientes baseados no Ubuntu, suportados pelo SDK, são compatíveis.

Atenção

O uso do SDK do Azure Sphere no WSL2 é experimental. O suporte é fornecido apenas com base no melhor esforço.

Pré-requisitos

  1. Instale o WSL2 na sua máquina Windows. Certifique-se de selecionar uma imagem do Ubuntu suportada pelo SDK do Azure Sphere.

  2. Em um terminal WSL2 e usando seu editor de texto preferido, escreva a seguinte configuração para /etc/wsl.conf:

    [boot]
systemd=true
[interop]
appendWindowsPath=false

  3. Reinicie o WSL2 executando wsl --shutdown a partir de um terminal do Windows.

  4. Em um terminal WSL2, instale o SDK do Azure Sphere para Linux.

  5. No Windows, instale o usbipd.

Ligar um dispositivo

  1. Em um terminal Windows:

    1. Execute o usbipd wsl list.

    2. Na saída, localize o BUSID para o dispositivo Azure Sphere que você gostaria de usar no WSL2:

      BUSID  VID:PID    DEVICE                                                        STATE
2-1    045e:07a5  USB Input Device                                              Not attached
2-3    06cb:00fc  Synaptics UWP WBDI                                            Not attached
2-4    174f:2454  Integrated Camera, Integrated IR Camera                       Not attached
2-10   8087:0026  Intel(R) Wireless Bluetooth(R)                                Not attached
3-2    045e:0840  Microsoft Modern Webcam, USB Input Device                     Not attached
3-5    0451:82ff  USB Input Device                                              Not attached
4-4    0403:6011  USB Serial Converter A, MSFT MT3620 Std Interface, USB Se...  Not attached

    3. Execute o usbipd wsl attach -b BUSID. Certifique-se de substituir BUSID pelo BUSID do dispositivo escolhido. Com a saída de usbipd wsl list acima, o comando attach seria usbipd wsl attach -b 4-4

  2. Em um terminal WSL2, execute lsusb. O resultado deve ser algo semelhante ao seguinte:

    Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 001 Device 002: ID 0403:6011 Future Technology Devices International, Ltd FT4232H Quad HS USB-UART/FIFO IC
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

    Neste exemplo, Bus 001 Device 002 é o dispositivo Azure Sphere conectado.