Skip to content

Driver Documentation

Jump to bottom
Nathan Nuber edited this page Apr 19, 2022 · 21 revisions

This is an overview of the steps to write a new OpenVR driver. In the examples, the driver is simply called "mydriver".

It is advisable to use the built-in SteamVR drivers as references. For example, the Oculus driver is maintained by Valve and demonstrates nearly all of the below features (excluding driver registration). The built-in drivers can be found in your Steam install directory in the sub-path 'Steam\steamapps\common\SteamVR\drivers'.

  1. Put all the files for your driver under a directory. Let's say that directory is "/mydriver"
  2. Add a new DLL to "mydriver/bin/win64/driver_mydriver.dll" (For Linux use the appropriate platform directory and the appropriate shared library extension.)
  3. Implement the driver factory function in that DLL.
  4. Add an implementation of vr::IClientTrackedDeviceProvider to the DLL and return it from the factory. This provider will be phased out in the next SDK udpate, but for now you need it. This was removed in OpenVR version 1.0.6.
  5. Add an implementation of vr::IServerTrackedDeviceProvider and have that return implementations of vr::ITrackedDeviceServerDriver for each tracked device.
  6. Add a driver manifest file to "/mydriver"
  7. Add and remove your driver to SteamVR's config file using vrpathreg.
  8. If you are deploying your driver through Steam and do not have an executable to put in your Steam launch options, you can use a Steam URL to launch SteamVR. This way, if a user launches your driver through Steam, it will automatically start SteamVR. The launch option is: steam://run/250820

For devices with buttons, triggers, joysticks, and other kinds of input controls, please refer to the vr::IVRDriverInput API. Reference the Input Profiles page for information on icons, images, and localization.

For devices that wish to provide animation data through the Skeletal Input system, please refer to the Skeletal Input Driver documentation.

The source code for a sample driver is available here. The sample implements these interfaces and includes an example HMD/controller.

Other driver documentation:

Clone this wiki locally