XBOFS.win

XBox One Fight Sticks for Windows

This project is maintained by OOPMan

Device Contributor Guide

This document aims to provide users of unsuppored XBO fight stick controllers with the tools and knowledge they need to assist in the process of adding support for new devices

Contents

  1. Requirements
  2. Tools
  3. Preparation
  4. Data Capture
  5. Delivery

Requirements

Tools

Preparation

Before you can start capturing data for your device it is necessary to ensure it is not configured to use the XBO Controller beta drivers from 2014. If these drivers are active for your device then Device Montioring Studio will be unable to see the controller.

In order to determine whether you are using the beta drivers
  1. Press Win + R to open the Run dialog

  2. Enter devmgmt.msc and press Enter

  3. In the Device Manager window, locate the Xbox Peripherals item and expand it

  4. Locate the Xbox Gaming Device item

  5. Right-click on the item and click Properties

  6. Click on the Driver tab

  7. Check the Driver Date and Driver version items. If the driver date is 5/26/2014 and the driver version is 6.2.11059.0 then you are using the beta drivers and will need to temporarily switch to a newer version while you collect the data

In order to update to the latest drivers
  1. Navigate to the Driver tab as described above

  2. Click the Update button

  3. Click the Search automatically for updated driver software option

  4. Wait for the driver to be updated

  5. Check the Driver Date and Driver version items. They should reflect a newer version of the driver that the one described above. You may be instructed to reboot. If so, reboot as instructed before proceeding to capture data. If for some reason the driver is not updated to a newer version using this process then it is recommended to run Windows Update and retry this process from step 1

To rollback to the beta drivers
  1. Navigate to the Driver tab as described above

  2. Click the Update button

  3. Click the Browse my computer for driver software option

  4. Click the Let me pick from a list of available drivers on this computer option

  5. Select the Xbox Gaming Device Version 6.2.11059.0 [5/26/2014] item and click Next

  6. Wait for the driver to be rolled back

  7. You should get a success message. You may also see a Microsoft Visual C++ Runtime Library error dialog. This can be ignored, it’s a side-effect of using ancient, beta drivers. You may be instructed to reboot. If instructed, do so

Data Capture

  1. Plug in your controller. It is also recommended to unplug any other controllers
  2. Confirm the controller is detected correctly using Device Manager

  3. Use the Start Menu to locate and run your text editor

  4. Use the Start Menu to locate and run Device Monitoring Studio

  5. Locate your controller in the Devices pane and select it

  6. Click the Device Descriptor tab in the bottom pane

  7. Drag-select all of the text, right-click and click Copy

  8. Switch to your text editor and paste the copied text

  9. Switch back to Device Monitoring Studio and click the Configuration Descriptor tab in the bottom pane

  10. Drag-select all of the text, right-click and clik Copy

  1. Switch to your text editor and paste the copied text

  1. Save the text file

  1. Switch back to Device Monitoring Studio, locate your controlled in the Devices pane, right-click on it and click Start Monitoring

  1. Double-click the Packet View item in the left-hand pane

  1. Confirm the Packet View item appears in the right-hand pane

  1. Click the Start button

  1. Click in the Packet View tab to focus the window and press a button on your controller until you start to see items appear in the list view. Items labelled DOWN are sent by the PC to the controller while items labelled UP represent data sent from the controller

  1. Select the first DOWN item in the list view

  1. This data represents the INIT packet sent by the PC to the controller

  1. Right-click in the Complete tab and click Copy

  1. Switch to your text editor and paste the copied text and save

  1. Switch back to Device Monitoring Studio, click in the Packet View tab and press and release the X button on your controller. Two new UP items should appear the list view. The first item represents the button press, the second the release. Select the first item

  1. This data represents the button/stick action sent by the controller to the PC

  1. Right-click in the Complete tab and click Copy

  1. Switch to your text editor and line a noting the button/stick direction that was pressed (E.g. Button X)

  1. Paste the copied text and save

  1. Repeat steps 22 through 26 for each button, including the Start, View and XBox Guide buttons

  2. Repeat steps 22 through 26 for each single stick direction (I.e. Up, Left, Down, Right). Be careful not to press the stick diagonally. If you are not sure whether you pressed diagonally, try again and check the data in the Complete tab

  3. Once you have collected data on all the buttons and stick directions you can close Device Monitoring Studio and make sure your data capture text file is saved. Not that you DO NOT need to capture diagonal directions on the stick or any buttom press combinations (E.g. X and Y together). All that is required are the single button/direction values

Delivery

The data capture text file needs to be submitted so that support can be implemented. The recommended means of doing this is to create a new issue on GitHub. You will need to sign-up for a GitHub account (Don’t worry, it’s free) before you can submit an issue.

For the Title field, fill in a value adjusted for your controller like so: Device support request: Razer Atrox XBO.

Drag-and-drop your data capture text file into the Write text area and then click the Submit new issue button.

If you have any questions, check the index document for support details