Revised metadata for HDK 1.4, improved Windows 10 support

@rpavlik rpavlik released this Jun 2, 2016 · 35 commits to master since this release

There are two main changes in this release compared to 1.2.6.

The first is a modification to the device metadata files to clarify that a given device may either be an HDK 1.3 or 1.4, to avoid confusing HDK 1.4 owners who see 1.3 pop up. (The electronics and drivers are substantially similar, so this is a cosmetic change only.)

The second is some minor updates to the .inf drivers: the USB serial port driver has been adjusted so that on Windows 10 it installs and wraps the bundled ("in-box") Windows 10 USB serial driver, and the IR camera driver has been modified slightly to better match the in-box USB video drivers on Windows 10 and to fix a corner case where the displayed name in the Device Manager would not always be overridden by the installation of the .inf file.

The attached executable installer includes:

  • The USB-CDC (USB serial) driver (for that "OSVR unknown device") used by the OSVR Control app (for updating firmware, etc). (Required on Windows 8.1 and below, will show up on Windows 10 as well) - shows up as OSVR HMD Communications Device under Ports in Device Manager
  • Windows 7 and up: "Device Metadata Packages" - aka, the data that makes nice icons appear in Devices and Printers - for:
    • OSVR HDK
    • OSVR HDK display panel (see #2 for why this is separate)
    • OSVR HDK 1.2/1.3/1.4 Belt Box/Audio (primarily for control of the USB Audio codec on the belt box that lets you plug analog headsets in - handles the "OSVR Audio" or the mystery "RAZER USB AUDIO" you might have seen there before, but also changes name to help indicate the HDK hardware model you likely have)
    • OSVR HDK IR Tracking Camera (will change name and icon indicate if an outdated firmware version is detected)
  • "Atmel USB DFU" driver needed for when the HDK is in firmware-upgrade mode.
  • Extra .inf drivers (primarily for naming purposes in the Device Manager - they do not need to override the behavior of the system-bundled driver yet), for:
    • OSVR HDK Head-Mounted Display - under Monitors (normal for this to be missing/hidden when in direct mode)
    • OSVR HDK Orientation Tracker (and its parent device, OSVR HDK USB HID Interface) - under Human Interface Devices
    • OSVR High-Speed Infrared Tracking Camera - under Imaging devices

Note that the device metadata installer that is a part of the executable bundle requires the .NET framework v4 client profile. You probably already have it, but if not, you can get it through Windows Update or at

As with previous installer executables, it can be run in silent mode by passing /S (case-sensitive!) on the command line to the installer.

The zip file contains only the .inf drivers for the USB-CDC (USB serial) device and the naming in Device Manager - it does not contain the "Devices and Printers" device metadata. It is provided as an option for those on non-x86/x64 platforms or as a convenience for advanced bundling purposes: its contents are a strict subset of the executable installer.

All drivers, as well as the installer, have been digitally signed by Sensics, Inc.