Какво е WebUSB API?

WebUSB API е браузърен стандарт, който позволява на уеб страниците да комуникират директно с USB устройства — без инсталиране на собствени драйвери или настолни приложения. Той беше представен в Chrome 61 и дава на уебсайтовете контролиран, защитен с разрешения достъп до хардуер като микроконтролери, платки за разработка, MIDI интерфейси и други USB периферни устройства.

За разлика от традиционния USB достъп (който изисква драйвери на ниво ядро), WebUSB работи изцяло в браузърния пясък. Потребителите трябва да дадат явно разрешение за всяко устройство чрез вградения в браузъра избирач на устройства, което гарантира, че никой уебсайт не може мълчаливо да чете или пише на вашия хардуер.

Описание на инструмента

Този инструмент ви позволява да преброите USB устройства, които са дадени на браузъра чрез WebUSB API. При зареждане той автоматично изброява всички предварително разрешени устройства. Можете също да отворите вградения в браузъра USB избирач, за да дадете достъп до ново свързано устройство, или да опресните списъка по всяко време.

За всяко устройство инструментът показва името на продукта, производителя, ID на продавача, ID на продукта, серийния номер и версията на USB протокола.

Функции

  • Автоматично зарежда предварително разрешени USB устройства при отваряне на страницата
  • Отваря вградения в браузъра USB избирач на устройства, за да дадете достъп до нови устройства
  • Показва ID на продавача и ID на продукта в стандартна шестнадесетична нотация (напр. 0x1A2B)
  • Показва версията на USB протокола (напр. 2.0, 3.1) заедно с полетата за идентификация на устройството
  • Таблица с сортируеми резултати с експорт в CSV и JSON

Как работи

Когато щракнете на Добавяне на устройство, браузърът извиква navigator.usb.requestDevice() и показва избирач на системно ниво, който изброява свързаните USB устройства. Ако изберете едно, браузърът съхранява разрешението за този произход. При следващи посещения (или след щракване на Опресняване), navigator.usb.getDevices() връща всички предварително разрешени устройства без повторно подсказване.

ID на продавача и ID на продукта се показват в 4-цифрен главен шестнадесетичен формат (напр. 0x04D8) — стандартният формат, използван в USB регистрите и техническите спецификации.

Случаи на употреба

  • Разработчици на фърмуер могат бързо да потвърдят, че свързан микроконтролер или платка за разработка (Arduino, STM32, RP2040 и т.н.) е правилно преброен от браузъра, преди да напишат инструмент за WebUSB-базирано прошиване.
  • Разработчици на уеб приложения могат да проверят, че техното WebUSB-активирано приложение ще вижда очаквани полета за идентификация на устройството по време на ранна фаза на прототипиране.

Ограничения

  • WebUSB се поддържа само в браузъри, базирани на Chromium (Chrome, Edge, Opera). Firefox и Safari не прилагат този API.
  • Страницата трябва да се обслужва през HTTPS (или localhost) — WebUSB е блокиран на обикновени HTTP произходи.
  • Някои комбинации от операционна система и браузър ограничават достъпа до определени класове устройства (напр. HID, масово хранилище), дори когато разрешенията са дадени.
  • Този инструмент чете само метаданни на устройството; той не отваря никакъв USB интерфейс и не прехвърля данни към/от устройството.