Czym jest WebUSB API?

WebUSB API to standard przeglądarki, który umożliwia stronom internetowym bezpośrednią komunikację z urządzeniami USB — bez konieczności instalowania natywnych sterowników lub aplikacji desktopowych. Został wprowadzony w Chrome 61 i daje witrynom kontrolowany, chroniony uprawnieniami dostęp do sprzętu, takiego jak mikrokontrolery, płytki rozwojowe, interfejsy MIDI i inne urządzenia peryferyjne USB.

W przeciwieństwie do tradycyjnego dostępu USB (który wymaga sterowników na poziomie jądra), WebUSB działa całkowicie w piaskownicy przeglądarki. Użytkownicy muszą wyraźnie udzielić uprawnienia dla każdego urządzenia za pośrednictwem wbudowanego selektora urządzeń przeglądarki, co zapewnia, że żadna witryna nie może w ciszy czytać z lub pisać do Twojego sprzętu.

Opis narzędzia

To narzędzie umożliwia wyliczenie urządzeń USB, które zostały przyznane przeglądarce za pośrednictwem WebUSB API. Po załadowaniu automatycznie wyświetla listę wcześniej dozwolonych urządzeń. Możesz również otworzyć natywny selektor USB przeglądarki, aby udzielić dostępu do nowo podłączonego urządzenia, lub odświeżyć listę w dowolnym momencie.

Dla każdego urządzenia narzędzie wyświetla nazwę produktu, producenta, identyfikator dostawcy, identyfikator produktu, numer seryjny i wersję protokołu USB.

Funkcje

  • Automatyczne ładowanie wcześniej przyznanych urządzeń USB po otwarciu strony
  • Otwieranie natywnego selektora urządzeń USB przeglądarki w celu udzielenia dostępu do nowych urządzeń
  • Wyświetlanie identyfikatora dostawcy i identyfikatora produktu w standardowej notacji szesnastkowej (np. 0x1A2B)
  • Pokazywanie wersji protokołu USB (np. 2.0, 3.1) obok pól tożsamości urządzenia
  • Sortowalna tabela wyników z eksportem CSV i JSON

Jak to działa

Po kliknięciu przycisku Dodaj urządzenie, przeglądarka wywołuje navigator.usb.requestDevice() i wyświetla selektor na poziomie systemu zawierający listę podłączonych urządzeń USB. Jeśli wybierzesz jedno, przeglądarka zapisuje uprawnienie dla tego pochodzenia. Przy kolejnych wizytach (lub po kliknięciu przycisku Odśwież), navigator.usb.getDevices() zwraca wszystkie wcześniej dozwolone urządzenia bez ponownego wyświetlania monitu.

Identyfikator dostawcy i identyfikator produktu są renderowane w 4-cyfrowym formacie szesnastkowym z wielkimi literami (np. 0x04D8) — standardowy format używany w rejestrach USB i kartach katalogowych.

Przypadki użycia

  • Deweloperzy oprogramowania sprzętowego mogą szybko potwierdzić, że podłączony mikrokontroler lub płytka rozwojowa (Arduino, STM32, RP2040, itp.) jest prawidłowo wyliczony przez przeglądarkę przed napisaniem narzędzia do flashowania opartego na WebUSB.
  • Deweloperzy aplikacji internetowych mogą sprawdzić, czy ich aplikacja obsługująca WebUSB będzie widzieć oczekiwane pola tożsamości urządzenia podczas wczesnego prototypowania.

Ograniczenia

  • WebUSB jest obsługiwany tylko w przeglądarkach opartych na Chromium (Chrome, Edge, Opera). Firefox i Safari nie implementują tego API.
  • Strona musi być serwowana przez HTTPS (lub localhost) — WebUSB jest blokowany na zwykłych źródłach HTTP.
  • Niektóre kombinacje systemu operacyjnego i przeglądarki ograniczają dostęp do określonych klas urządzeń (np. HID, magazyn masowy) nawet gdy uprawnienia są przyznane.
  • To narzędzie odczytuje tylko metadane urządzenia; nie otwiera żadnego interfejsu USB ani nie przesyła danych do/z urządzenia.