Merge "Updated documentation for CTS uhid tests" into rvc-dev am: 01c36833b9

Change-Id: Ib0d730ae00bdad231d2ba4f5c9d537521e761752
This commit is contained in:
Siarhei Vishniakou
2020-04-03 16:00:37 +00:00
committed by Automerger Merge Worker

View File

@@ -38,17 +38,21 @@ legal JSON format, as this would imply multiple root elements).
Register a new uhid device
| Field | Type | Description |
|:-------------:|:-------------:|:--------------------------|
|:-------------:|:-------------:|:-------------------------- |
| id | integer | Device id |
| command | string | Must be set to "register" |
| name | string | Device name |
| vid | 16-bit integer| Vendor id |
| pid | 16-bit integer| Product id |
| bus | string | Bus that device should use |
| descriptor | byte array | USB HID report descriptor |
Device ID is used for matching the subsequent commands to a specific device
to avoid ambiguity when multiple devices are registered.
Device bus is used to determine how the uhid device is connected to the host.
The options are "usb" and "bluetooth".
USB HID report descriptor should be generated according the the USB HID spec
and can be checked by reverse parsing using a variety of tools, for example
[usbdescreqparser][5].
@@ -61,6 +65,7 @@ Example:
"name": "Odie (Test)",
"vid": 0x18d1,
"pid": 0x2c40,
"bus": "usb",
"descriptor": [0x05, 0x01, 0x09, 0x05, 0xa1, 0x01, 0x85, 0x01, 0x05, 0x09, 0x0a, 0x01, 0x00,
0x0a, 0x02, 0x00, 0x0a, 0x04, 0x00, 0x0a, 0x05, 0x00, 0x0a, 0x07, 0x00, 0x0a, 0x08, 0x00,
0x0a, 0x0e, 0x00, 0x0a, 0x0f, 0x00, 0x0a, 0x0d, 0x00, 0x05, 0x0c, 0x0a, 0x24, 0x02, 0x0a,
@@ -142,4 +147,4 @@ for debugging purposes.
[3]: ../../../../cts/tests/tests/hardware/res/raw/
[4]: https://developer.android.com/training/game-controllers/controller-input.html#button
[5]: http://eleccelerator.com/usbdescreqparser/
[6]: https://developer.android.com/training/game-controllers/controller-input.html
[6]: https://developer.android.com/training/game-controllers/controller-input.html