Amazon AppStream 2.0
Administration Guide

Qualify USB Devices for Use with Streaming Applications

To qualify your USB devices so that they can be used with streaming applications, perform these steps.

  1. If you haven't already done so, install the AppStream 2.0 client. For information, see Install and Configure the AppStream 2.0 Client.

  2. Connect the USB device that you want to qualify to your computer.

  3. Navigate to C:\Users\<logged-in-user>\AppData\Local\AppStreamClient, and double-click dcvusblist.exe.

  4. In the DCV - USB devices dialog box, the list of USB devices that are connected to your local computer displays. The Filter column displays the filter string for every USB device. Right-click the list entry for a USB device that you want to enable, and choose Copy filter string.

  5. On your desktop, choose the Windows Start button, and search for Notepad. Double-click Notepad to open a new file, copy the filter string to the file, and save it. Later, you'll use the filter string to qualify the USB device.

  6. Launch a new image builder. For more information, see Launch an Image Builder to Install and Configure Streaming Applications.

  7. Create a streaming URL for your image builder, and use it to connect to the image builder with the AppStream 2.0 client.

  8. Log in as Administrator.

  9. If your USB device requires you to install drivers before you use it, download and install the drivers on the image builder. For example, if you use the Connexion 3D mouse, you must download and install the required Connexion drivers on the image builder.

  10. On your image builder desktop, choose the Windows Start button, and search for Notepad. Right-click Notepad, and choose Run as Administrator.

  11. Choose File, Open, and open the following file: C:\ProgramData\Amazon\Photon\DCV\usb_device_whitelist.txt. You can also allow an entire category of devices or all devices from a specific manufacturer by using wildcard expressions in the usb_device_whitelist.txt file.

  12. Copy the filter string from your local computer to the image builder. The filter string for a specific USB device is a comma-separated string of the following fields: Name, Base Class, SubClass, Protocol, ID Vendor, ID Product, Support Autoshare, and Skip Reset. For detailed information about these strings, see the next section, Working with USB Device Filter Strings.

  13. Disconnect from your image builder, restart it, and reconnect to it by using the AppStream 2.0 client application.

  14. On the image builder, test your USB device to confirm that it works as expected.

  15. To use the USB device in an AppStream 2.0 session, you must share the device with the session first. For more information, see Share a USB Device with an AppStream 2.0 Streaming Session. After you finish testing, you can provide the information in the Guidance for Users section of this topic to your users.

  16. If the USB device works with the image builder as expected, create an image. For more information, see Tutorial: Create a Custom AppStream 2.0 Image by Using the AppStream 2.0 Console.

  17. After you finish creating the image, update your AppStream 2.0 fleet to use the new image.

Working with USB Device Filter Strings

This section describes the filter strings available for qualifying USB devices for AppStream 2.0 streaming sessions and provides guidance for working with these strings. The following filter strings are available:

  • Name — By default, the value for this filter string is the name of the device. You can optionally specify your own value.

  • Base Class,SubClass,Protocol — The USB class code for the device. For more information, see Defined Class Codes.

  • ID Vendor (VID) — A unique identifier that is assigned by the USB organization to the manufacturer of the USB device.

  • ID Product (PID) — A unique identifier that assigned by the manufacturer to the USB device.

  • Support Autoshare — Lets the AppStream 2.0 client automatically share the device when a streaming session starts. Set this value to 1 to allow automatic device sharing or to 0 to not allow automatic device sharing.

  • Skip Reset — By default, when a USB device is shared by AppStream 2.0 with a streaming session, the device is reset to ensure that it functions correctly. However, some USB devices don’t function correctly during the streaming session if they are reset. To prevent this problem from occurring, set the value for this filter string to 1 to instruct the AppStream 2.0 client not to reset the device while it is shared with a streaming session. To ensure that the device is reset while it is shared with a streaming session, set this value to 0. When you set a value for Skip Reset, make sure that you set the value for Support Autoshare to 0 or 1.

The filter string that is copied from the local computer is specific to a USB device. In some cases, you may want to allow an entire class of devices instead of allowing every possible USB device. For example, you may want to allow your users to use any kind of WACOM design tablets or use any USB mass storage device. In such scenarios, you can provide wildcard characters for specific filter string fields. If you don’t know the VID and PID for your USB devices, you can search for this information in the USB ID database.

The following examples show how to configure filter strings for USB device sharing during streaming sessions:

  • Allow all mass storage devices automatically on starting a streaming session — "Mass storage, 8, *, *, *, *,1,0"

  • Allow all Wacom devices automatically on starting a streaming session — "Wacom Tablets, 3, *, *, 1386, *,1,0"

  • Allow all devices that provide an audio interface - "Audio, 1, *, *, *, *,1,0"

  • Allow device X but don't reset it while the device is shared. Also don’t share the device automatically on starting a streaming session — "X, Y, *, *, 1386, *,0,1"