USBEndpoint

Интерфейс USBEndpoint API WebUSB предоставляет информацию об конечной точке, предоставляемой устройством USB. Конечная точка представляет собой однонаправленный поток данных в устройство или из устройства.

USBEndpoint() Экспериментально

Создаёт новый объект USBEndpoint, который будет заполнен информацией об конечной точке на предоставленном USBAlternateInterface с заданным номером конечной точки и направлением передачи.

USBEndpoint.endpointNumber Экспериментально

Возвращает "номер конечной точки" этой конечной точки, значение от 1 до 15, извлечённое из поля bEndpointAddress описателя конечной точки, определяющего эту конечную точку. Это значение используется для идентификации конечной точки при вызове методов на USBDevice.

USBEndpoint.direction Экспериментально

Возвращает направление, в котором эта конечная точка передаёт данные, одно из:

• "in" - Данные передаются от устройства к хосту.
• "out" - Данные передаются от хоста к устройству.

USBEndpoint.type Экспериментально

Возвращает тип этой конечной точки, один из:

• "bulk" - Предоставляет надёжную передачу данных для больших объёмов. Данные, отправленные через конечную точку типа bulk, гарантированно будут доставлены или сгенерируют ошибку, но могут быть прерваны другими данными.
• "interrupt" - Предоставляет надёжную передачу данных для небольших объёмов. Данные, отправленные через прерывание конечной точки, гарантированно будут доставлены или сгенерируют ошибку, а также получат выделенное время шины для передачи.
• "isochronous" - Предоставляет ненадежную передачу данных для данных, которые должны быть переданы периодически. Им выделяется выделенное время шины, но если срок выполнения пропущен, данные отбрасываются.

USBEndpoint.packetSize Экспериментально

Возвращает размер пакетов, на которые данные, отправленные через эту конечную точку, будут разделены.

Хотя иногда разработчик заранее знает точный макет конечных точек устройства, есть случаи, когда это необходимо обнаружить во время выполнения. Например, USB-устройство последовательной связи должно предоставлять конечные точки ввода/вывода типа bulk, но их номера конечных точек будут зависеть от других интерфейсов, которые предоставляет устройство.

Этот код идентифицирует правильные конечные точки, выполняя поиск интерфейса, реализующего класс USB CDC интерфейса, а затем идентифицирует кандидатуры конечных точек на основе их типа и направления.

let inEndpoint = undefined;
let outEndpoint = undefined;

for (const { alternates } of device.configuration.interfaces) {
  // Only support devices with out multiple alternate interfaces.
  const alternate = alternates[0];

  // Identify the interface implementing the USB CDC class.
  const USB_CDC_CLASS = 10;
  if (alternate.interfaceClass !== USB_CDC_CLASS) {
    continue;
  }

  for (const endpoint of alternate.endpoints) {
    // Identify the bulk transfer endpoints.
    if (endpoint.type !== "bulk") {
      continue;
    }

    if (endpoint.direction === "in") {
      inEndpoint = endpoint.endpointNumber;
    } else if (endpoint.direction === "out") {
      outEndpoint = endpoint.endpointNumber;
    }
  }
}