Windows üzerinde Linux için Azure IoT Edge'e USB cihazı bağlama

Şunlar için geçerlidir: IoT Edge 1.5

Önemli

IoT Edge 1.5 LTS desteklenen sürümdür. IoT Edge 1.4 LTS, 12 Kasım 2024 itibarıyla kullanım ömrü sona erer. Önceki bir sürümdeyseniz bkz. IoT Edge’i güncelleştirme.

Bazı senaryolarda iş yüklerinizin veri alması veya USB cihazlarıyla iletişim kurması gerekir. Windows üzerinde Linux için Azure IoT Edge (EFLOW) sanal makine olarak çalıştığından, bu cihazları sanal makineye bağlamanız gerekir. Bu makale, usbipd-win adlı USB/IP açık kaynak projesini kullanarak BIR USB cihazını EFLOW sanal makinesine bağlamak için gereken adımlarda size yol gösterir.

Windows makinenizde USB/IP projesinin ayarlanması arduino yanıp söner, USB seri cihazı bağlama veya doğrudan EFLOW sanal makinesinden akıllı kart okuyucuya erişme gibi yaygın geliştirici USB senaryolarına olanak tanır.

Uyarı

IP üzerinden USB, Windows ana bilgisayar işletim sistemi ile EFLOW sanal makinesi arasındaki ağı kullanarak USB cihazlarını yeniden yönlendirmek için genel bir mekanizma sağlar. Ağ gecikme süresine duyarlı olan bazı cihazlarda sorunlarla karşılaşabilirsiniz. Ayrıca, sürücü uyumluluğu sorunları nedeniyle bazı cihazlar beklendiği gibi çalışmayabilir. Üretime dağıtmadan önce cihazlarınızın beklendiği gibi çalıştığından emin olun. USB/IP ile test edilen cihazlar hakkında daha fazla bilgi için bkz . USBIP-Win - Wiki - Test Edilen Cihazlar.

Önkoşullar

• Windows 1.3.1 veya üzeri sürümlerde Linux için Azure IoT Edge güncelleştirmesi. EFLOW sürüm notları hakkında daha fazla bilgi için bkz . EFLOW Sürümleri.
• x64/x86 işlemcisi olan bir makine gereklidir, usbipd-win ARM64'i desteklemez.

Not

Windows'da Linux için Azure IoT Edge sürümünüzü denetlemek için Program Ekle veya Kaldır'a gidin ve Azure IoT Edge'i arayın. Yüklü sürüm Azure IoT Edge altında listelenir. En son sürüme güncelleştirmeniz gerekiyorsa bkz . Windows güncelleştirmelerinde Linux için Azure IoT Edge.

UsbIp-Win projesini yükleme

USB cihazlarını bağlama desteği EFLOW ile yerel olarak kullanılamaz. Aşağıdaki adımları kullanarak açık kaynak usbipd-win projesini yüklemeniz gerekir:

1. usbipd-win projesi için en son sürüm sayfasına gidin.
2. usbipd-win_x.y.z.msi dosyasını seçin ve indirin. (İndirilen yükleyiciye güvendiğinizi onaylamanızı isteyen bir uyarı alabilirsiniz).
3. İndirilen usbipd-win_x.y.z.msi yükleyici dosyasını çalıştırın.

Not

Alternatif olarak, Windows Paket Yöneticisi (winget) kullanarak usbipd-win projesini de yükleyebilirsiniz. Winget'i zaten yüklediyseniz, usbipd-win yüklemek için komutunu winget install --interactive --exact dorssel.usbipd-win kullanın. parametresini --interactive kullanmıyorsanız, sürücüleri yüklemek için gerekirse winget bilgisayarınızı hemen yeniden başlatabilir.

UsbIp-Win yüklemeleri:

• (USBIP Cihaz Ana Bilgisayarı) adlı usbipd bir hizmet. Windows'daki Hizmetler uygulamasını kullanarak bu hizmetin durumunu de kontrol edebilirsiniz.
• Komut satırı aracı usbipd. Bu aracın konumu PATH ortam değişkenine eklenir.
• Tüm yerel alt ağların hizmete bağlanmasına izin vermek için çağrılan usbipd bir güvenlik duvarı kuralı. Erişim denetiminde ince ayar yapmak için bu güvenlik duvarı kuralını değiştirebilirsiniz.

Bu noktada, USB cihazlarını paylaşmak için Windows üzerinde bir hizmet çalıştırılır ve paylaşılan cihazlara eklemek için gerekli araçlar EFLOW sanal makinesine yüklenir.

Uyarı

Açık bir PowerShell oturumlarınız varsa, kapatmayı ve komut satırı aracını yüklemek için yeni bir oturum açtığınızdan usbipd emin olun.

EFLOW VM'sine USB cihazı ekleme

Aşağıdaki adımlar, EFLOW VM'sine USB cihazı eklemek için örnek bir EFLOW PowerShell cmdlet'i sağlar. Gerekli komutları el ile yürütmek istiyorsanız bkz . Usbip-win kullanma.

Önemli

Aşağıdaki işlevler, üretim dağıtımlarında kullanılması amaçlanmamış örneklerdir. Üretim kullanımı için işlevselliği doğruladığınızdan ve bu örneklere göre kendi işlevlerinizi oluşturduğunuzdan emin olun. Örnek işlevler değiştirilebilir ve silinemez.

1. EFLOW-Util'e gidin ve EFLOW-USBIP örnek PowerShell modülünü indirin.

2. Yönetici Olarak Çalıştır ile başlayıp yükseltilmiş bir PowerShell oturumu açın.

3. İndirilen EFLOW-USBIP modülünü içeri aktarın.

   Import-Module "<path-to-module>/EflowUtil-Usbip.psm1"
   

4. Windows'a bağlı tüm USB cihazlarını listeleyin.

   Get-EflowUSBDevices
   

5. Tüm ağ arabirimlerini listeleme ve Windows ana bilgisayar işletim sistemi IP adresini alma

   ipconfig
   

6. EFLOW'a eklemek istediğiniz cihazın veri yolu kimliğini seçin.

   Add-EflowUSBDevices -busid <busid> -hostIp <host-ip>
   

7. Cihazın EFLOW VM'sine doğru şekilde bağlı olup olmadığını denetleyin.

   Invoke-EflowVmCommand "lsusb"
   

8. Cihazı EFLOW'da kullanmayı tamamladıktan sonra USB cihazının bağlantısını fiziksel olarak kesebilir veya bu komutu yükseltilmiş bir PowerShell oturumundan çalıştırabilirsiniz.

   Remove-EflowUSBDevices -busid <busid>
   

Önemli

EFLOW VM'sinden USB cihazına ek, yeniden başlatmalar arasında kalıcı olmaz. Usb cihazını yeniden başlatma işleminden sonra takmak için, başlatma sırasında çalışan ve bash komutunu kullanarak usbip cihazı bağlayan bir bash betiği oluşturmanız gerekebilir. Cihazı EFLOW VM tarafına ekleme hakkında daha fazla bilgi için bkz . Add-EflowUSBDevices.

IP üzerinden USB'nin nasıl olduğu hakkında daha fazla bilgi edinmek için bkz . USB cihazlarını WSL'ye bağlama ve GitHub'da usbipd-win deposu.

Sonraki adımlar

Windows üzerinde Linux için IoT Edge kullanarak Linux kapsayıcılarıyla IoT Edge modülleri geliştirme. Windows üzerinde Linux için IoT Edge ile bir modül geliştirmek ve hatalarını ayıklamak için bu adımları izleyin.