USB デバイス

このドキュメントでは、USB API を使用して USB デバイスと通信する方法について説明します。一部のデバイス は USB API でアクセスできません（詳しくは、下記の「注意点」をご覧ください）。Chrome アプリ シリアル デバイスや Bluetooth デバイスに接続することもできます。

USB の背景情報については、公式の USB 仕様をご覧ください。 USB in a NutShell は、参考になる合理的な集中講座です。

マニフェストの要件

USB API では「usb」が必要権限を宣言する必要があります。

"permissions": [
  "usb"
]

また、フィンガープリントを防ぐため、デバイスのタイプをすべて宣言する必要があります。 マニフェスト ファイルで宣言します。USB デバイスの各タイプはベンダー ID または製品 ID に対応しています。 （VID/PID）ペアを返します。usb.getDevices を使用すると、VID/PID ペアでデバイスを列挙できます。

使用するデバイスのタイプごとに VID と PID のペアを usbDevices で宣言する必要があります 権限を宣言する必要があります。次の例をご覧ください。

"permissions": [
  {
    "usbDevices": [
      {
        "vendorId": 123,
        "productId": 456
      }
    ]
  }
]

Chrome 57 以降では、アプリ マニフェストですべてのデバイスタイプを宣言する必要があります。 ChromeOS のキオスクアプリとして実行されるアプリの場合は緩和されています。キオスクアプリの場合、 interfaceClass 権限プロパティを使用して、次のような USB デバイスへのアクセス権限をリクエストします。

• 特定のインターフェース クラスの USB インターフェースを実装する
• 特定の USB デバイスクラスがある

たとえば、次の usbDevices 権限は、すべての USB デバイスへのアクセス権をアプリに付与します。 プリンタ インターフェース（インターフェース クラスコード 7）と USB ハブデバイス（デバイス クラスコード）への実装 9）:

"permissions": [
  {
    "usbDevices": [
      {"interfaceClass": 7},
      {"interfaceClass": 9}
    ]
  }
]

使用可能な interfaceClass 値の一覧については、USB クラスコードをご覧ください。

interfaceClass プロパティを vendorId プロパティと組み合わせると、USB にのみアクセスできます （次の例で示すとおり）に特定のベンダーのデバイスを接続できます。

"permissions": [
  {
    "usbDevices": [
      {
        "vendorId": 123,
        "interfaceClass": 7
      }
    ]
  }
]

デバイスの検索

ユーザーのシステムに接続されている特定のデバイスが 1 つ以上あるかどうかを確認するには、 usb.getDevices メソッド:

chrome.usb.getDevices(enumerateDevicesOptions, callback);

例:

function onDeviceFound(devices) {
  this.devices=devices;
  if (devices) {
    if (devices.length > 0) {
      console.log("Device(s) found: "+devices.length);
    } else {
      console.log("Device could not be found");
    }
  } else {
    console.log("Permission denied.");
  }
}

chrome.usb.getDevices({"vendorId": vendorId, "productId": productId}, onDeviceFound);

デバイスの起動

Device オブジェクトが返されたら、usb.openDevice を使用してデバイスを開き、 あります。USB デバイスと通信するには、接続ハンドルを使用する必要があります。

例:

var usbConnection = null;
var onOpenCallback = function(connection) {
  if (connection) {
    usbConnection = connection;
    console.log("Device opened.");
  } else {
    console.log("Device failed to open.");
  }
};

chrome.usb.openDevice(device, onOpenCallback);

開くプロセスを簡素化するために、usb.findDevices メソッドを使用できます。このメソッドは、 リクエストして、1 回の呼び出しでデバイスを開くことができます。

chrome.usb.findDevices({"vendorId": vendorId, "productId": productId, "interfaceId": interfaceId}, callback);

これは次と同等です。

chrome.usb.getDevices({"vendorId": vendorId, "productId": productId}, function (devices) {
  if (!devices) {
    console.log("Error enumerating devices.");
    callback();
    return;
  }
  var connections = [], pendingAccessRequests = devices.length;
  devices.forEach(function (device) {
    chrome.usb.requestAccess(interfaceId, function () {
      // No need to check for errors at this point.
      // Nothing can be done if an error occurs anyway. You should always try
      // to open the device.
      chrome.usb.openDevices(device, function (connection) {
        if (connection) connections.push(connection);
        pendingAccessRequests--;
        if (pendingAccessRequests == 0) {
          callback(connections);
        }
      });
    });
  })
});

USB でのデバイスのデータの転送と受信

USB プロトコルでは、コントロール、バルク、アイソクロナス、および 4 種類の転送が定義されています。 割り込み。以下では、これらの転送について説明します。

転送は、デバイスからホスト（インバウンド）とホストからデバイス（アウトバウンド）の双方向で行うことができます。期限 USB プロトコルの性質上、インバウンドとアウトバウンドの両方のメッセージはホストが開始する必要があります。 （Chrome アプリを実行しているパソコン）。受信（デバイスからホスト）メッセージの場合、ホスト（開始 （JavaScript コードで指定）によって「受信」フラグが付けられたメッセージを送信します。ダウンロードします。詳細情報 メッセージはデバイスによって異なりますが、通常はユーザーがリクエストしようとしているものを 削除します。その後、デバイスはリクエストされたデータを返します。デバイスの応答は、 転送方法で指定したコールバックに非同期で配信されます。アウトバウンド （ホストからデバイスへの）メッセージもこれと似ていますが、レスポンスにはデバイスから返されたデータは含まれません。

デバイスからのメッセージごとに、指定されたコールバックは、イベント オブジェクトを 次のプロパティがあります。

例:

var onTransferCallback = function(event) {
   if (event && event.resultCode === 0 && event.data) {
     console.log("got " + event.data.byteLength + " bytes");
   }
};

chrome.usb.bulkTransfer(connectionHandle, transferInfo, onTransferCallback);

CONTROL による送金

コントロール転送は、設定やコマンド パラメータを USB に送受信するためによく使用されます。 ダウンロードしますcontrolTransfer メソッドは常にエンドポイント 0 との間で送受信を行い、claimInterface は 必要ありません。この方法は簡単で、次の 3 つのパラメータを受け取ります。

chrome.usb.controlTransfer(connectionHandle, transferInfo, transferCallback)

transferInfo オブジェクトの値:

例:

var transferInfo = {
  "requestType": "vendor",
   "recipient": "device",
  "direction": "out",
  "request":  0x31,
  "value": 120,
  "index": 0,
  // Note that the ArrayBuffer, not the TypedArray itself is used.
  "data": new Uint8Array([4, 8, 15, 16, 23, 42]).buffer
};
chrome.usb.controlTransfer(connectionHandle, transferInfo, optionalCallback);

ISOCHRONOUS 転送

アイソクロナス転送は、最も複雑なタイプの USB 転送です。通常はストリーミングで 動画や音声などのデータです。アイソクロナス転送（インバウンドまたはアウトバウンド）を開始するには、 usb.isochronousTransfer メソッドを使用する必要があります。

chrome.usb.isochronousTransfer(connectionHandle, isochronousTransferInfo, transferCallback)

isochronousTransferInfo オブジェクトの値:

例:

var transferInfo = {
  "direction": "in",
  "endpoint": 1,
  "length": 2560
};

var isoTransferInfo = {
  "transferInfo": transferInfo,
  "packets": 20,
  "packetLength": 128
};

chrome.usb.isochronousTransfer(connectionHandle, isoTransferInfo, optionalCallback);

一括転送

一括転送は、信頼性が高く、時間的制約のない大量のデータを転送する場合によく使用されます。 できます。usb.bulkTransfer には 3 つのパラメータがあります。

chrome.usb.bulkTransfer(connectionHandle, transferInfo, transferCallback);

transferInfo オブジェクトの値:

例:

var transferInfo = {
  "direction": "out",
  "endpoint": 1,
  "data": new Uint8Array([4, 8, 15, 16, 23, 42]).buffer
};

INTERRUPT 転送

割り込み転送は、時間的制約のある少量のデータに使用されます。すべての USB 通信は ホストコードは通常、デバイスを定期的にポーリングし、割り込み IN を送信します。 割り込みキューになんらかのデータがある場合に、デバイスからデータを送り返す転送 （デバイスで管理されます）。usb.interruptTransfer には次の 3 つのパラメータがあります。

chrome.usb.interruptTransfer(connectionHandle, transferInfo, transferCallback);

transferInfo オブジェクトの値:

例:

var transferInfo = {
  "direction": "in",
  "endpoint": 1,
  "length": 2
};
chrome.usb.interruptTransfer(connectionHandle, transferInfo, optionalCallback);

注意点

すべてのデバイスに USB API でアクセスできるわけではありません。一般に、次の理由でデバイスにアクセスできません。 オペレーティング システムのカーネルまたはネイティブ ドライバのいずれかが、ユーザー空間コードからそれらを保留します。一部 たとえば、OS X システムで HID プロファイルを持つデバイスや、USB ペンドライブなどです。

ほとんどの Linux システムでは、USB デバイスはデフォルトで読み取り専用権限にマッピングされます。Google Chat を開く方法 アクセスするには、ユーザーもそのデバイスに対する書き込みアクセス権を持っている必要があります。シンプルな解決策は、 udev ルールを設定します次の内容のファイル /etc/udev/rules.d/50-yourdevicename.rules を作成します。 content:

SUBSYSTEM=="usb", ATTR{idVendor}=="[yourdevicevendor]", MODE="0664", GROUP="plugdev"

次に、udev デーモン service udev restart を再起動します。デバイスの権限は 次の手順で正しく設定できます。

• lsusb を実行して、バス番号とデバイス番号を確認します。
• ls -al /dev/bus/usb/[bus]/[device] を実行します。このファイルの所有者はグループ「plugdev」である必要がありますかつ、 グループの書き込み権限を設定します。

この手順では root アクセス権が必要であるため、アプリは自動的にこの処理を実行できません。おすすめの方法 エンドユーザー向けの手順を提供し、Google Cloud サポートの 説明します。

ChromeOS の場合は、usb.requestAccess を呼び出すだけです。この処理は権限ブローカーが行います。