WebUSB API Nedir?

WebUSB API, web sayfalarının yerel sürücü veya masaüstü uygulaması yüklemeden doğrudan USB cihazlarıyla iletişim kurmasını sağlayan bir tarayıcı standardıdır. Chrome 61'de tanıtılan bu API, web sitelerine mikrodenetleyiciler, geliştirme kartları, MIDI arayüzleri ve diğer USB çevre birimleri gibi donanımlara kontrollü ve izin tabanlı erişim sağlar.

Geleneksel USB erişiminin aksine (çekirdek düzeyinde sürücüler gerektiren), WebUSB tamamen tarayıcı korumalı alanında çalışır. Kullanıcılar tarayıcının yerleşik cihaz seçicisi aracılığıyla her cihaza açıkça izin vermelidir; bu sayede hiçbir web sitesi sessizce donanımınızdan okuyamaz veya yazamaz.

Araç Açıklaması

Bu araç, WebUSB API aracılığıyla tarayıcıya izin verilen USB cihazlarını listelemenizi sağlar. Sayfa yüklendiğinde daha önce izin verilen cihazları otomatik olarak listeler. Ayrıca tarayıcının yerel USB seçicisini açarak yeni bağlı bir cihaza erişim izni verebilir veya listeyi istediğiniz zaman yenileyebilirsiniz.

Her cihaz için araç ürün adını, üreticisini, satıcı kimliğini, ürün kimliğini, seri numarasını ve USB protokol sürümünü gösterir.

Özellikler

  • Sayfa açıldığında daha önce verilen USB cihazlarını otomatik olarak yükler
  • Yeni cihazlara erişim izni vermek için tarayıcının yerel USB cihaz seçicisini açar
  • Satıcı kimliğini ve ürün kimliğini standart onaltılık gösterimde gösterir (örn. 0x1A2B)
  • USB protokol sürümünü (örn. 2.0, 3.1) cihaz kimlik alanlarının yanında gösterir
  • Sıralanabilir sonuç tablosu ile CSV ve JSON dışa aktarma

Nasıl Çalışır

Cihaz Ekle düğmesine tıkladığınızda, tarayıcı navigator.usb.requestDevice() öğesini çağırır ve bağlı USB cihazlarını listeleyen sistem düzeyinde bir seçici görüntüler. Bir cihaz seçerseniz, tarayıcı bu kaynak için izni depolar. Sonraki ziyaretlerde (veya Yenile düğmesine tıkladıktan sonra), navigator.usb.getDevices() daha önce izin verilen tüm cihazları tekrar sormadan döndürür.

Satıcı kimliği ve ürün kimliği 4 haneli büyük harf onaltılık olarak gösterilir (örn. 0x04D8) — USB kayıtlarında ve veri sayfalarında kullanılan standart format.

Kullanım Alanları

  • Yazılım Geliştirici bağlı bir mikrodenetleyici veya geliştirme kartının (Arduino, STM32, RP2040, vb.) tarayıcı tarafından doğru şekilde numaralandırıldığını WebUSB tabanlı bir yazılım yazma aracı yazmadan önce hızlıca doğrulayabilir.
  • Web Uygulaması Geliştirici WebUSB özellikli uygulamalarının erken prototip aşamasında beklenen cihaz kimlik alanlarını göreceğini doğrulayabilir.

Sınırlamalar

  • WebUSB yalnızca Chromium tabanlı tarayıcılarda (Chrome, Edge, Opera) desteklenir. Firefox ve Safari bu API'yi uygulamaz.
  • Sayfa HTTPS üzerinden sunulmalıdır (veya localhost) — WebUSB düz HTTP kaynaklarında engellenir.
  • Bazı işletim sistemi ve tarayıcı kombinasyonları, izinler verilse bile belirli cihaz sınıflarına (örn. HID, toplu depolama) erişimi kısıtlar.
  • Bu araç yalnızca cihaz meta verilerini okur; herhangi bir USB arayüzü açmaz veya cihaza/cihazdan veri aktarmaz.