# DeviceConfig XML Properties<no value>
The **DeviceConfig.xml** file is used to determine how different **device profiles** will be displayed within the UI. Each device input package should only ever have *one* of these files, and it must always be named "DeviceConfig" for the simulation to recognize it.

 

This file is created automatically for you when you use [The Input Device Editor](../../devmode/editors/input-editors/the-input-device-editor/), and a such, this page is provided **purely for reference** and all edition of the file should be done using the editor to ensure that it is set up correctly. Please see the following page for more information on how to do this:

-   [Device Profiles](device-profiles/)

 

The `DeviceConfig.xml` file has the following schematic structure:

``` xml
<?xml version= "1.0" encoding= "utf-8" ?>
<DeviceConfig>
    
    <Device [attributes] />
    <Device [attributes] />
    ...
    
    <Device [attributes] >
        <MergeIcons [attibutes]/>
        <MergeIcons [attibutes]/>
        ...
        
        <ButtonTT [attibutes]/>
        <ButtonTT [attibutes]/>
        ...
    </Device>
    ...
</DeviceConfig>
```

 

 

### &lt;DeviceConfig&gt;

This is a container element where you will place one or more `<Device>` sub-elements. This element has no attributes.

 

 

### &lt;Device&gt;

This element is a sub-element of `<DeviceConfig>` and is used to setup a specific device definition for use in the simulation UI. If the device has no icons then the element is self-closing, otherwise it will have one or more `<MergeIcons>` sub-elements. Note that if the device is **Keyboard** or **Mouse** then you *cannot* use the `<MergeIcons>` sub-element as these inputs will always use the default UI icons.

 

It can have the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>ProductID</code></td><td><p>This is the product ID for the device being defined. The ID should be formatted as a hexadecimal value, prefixed by "0x". You can find the product ID from the <a href="../../2_DevMode/Input_Editors/The_Input_Device_Editor.htm">Input Device Editor</a>. For example, if the Product ID is 767 you would have:</p><pre class="language-xml"><code>ProductID=&quot;0x02FF&quot;</code></pre></td><td>String</td><td>Yes</td></tr><tr class="even"><td><code>Platform</code></td><td><p>This sets the platform(s) that the device can be used on. If the device can be used on all platforms, this attribute can be omitted, otherwise you can use one of the following strings to limit the device to that platform:</p><ol><li>"PC"</li><li>"XBOX"</li><li>"PLAYSTATION"</li><li>"PC, XBOX"</li><li>"PC, PLAYSTATION"</li><li>"XBOX, PLAYSTATION"</li><li>"ALL"</li></ol></td><td>String</td><td>No</td></tr><tr class="odd"><td><code>CompositeID</code></td><td>This is the composite ID for the device being defined, expressed as an integer. You can find the composite ID from the <a href="../../2_DevMode/Input_Editors/The_Input_Device_Editor.htm">Input Device Editor</a>.</td><td>Integer</td><td>No</td></tr><tr class="even"><td><code>DisplayName</code></td><td>This is the name of the device that will be displayed in the UI.</td><td>String</td><td>Yes</td></tr><tr class="odd"><td><code>TextureFolder</code></td><td>This is the relative path to the texture folder where the required images and optional icons can be found. Each device requires a unique folder which should be named the same as the <a href="Input_Configuration_XML_Properties.htm">Input Configuration XML</a> file.</td><td>String</td><td>Yes</td></tr><tr class="even"><td><code>Priority</code></td><td>This sets the priority in the UI for the device profile, expressed as an integer, where a lower value will represent a higher priority in the UI list. If this attribute is not included, then the default priority is 0.</td><td>Integer</td><td>No</td></tr></tbody></table>

 

 

### &lt;MergeIcons&gt;

This is a sub-element of `<Device>` and is used to define one or more icons that can be used to represent a button, axis or slider on the device being defined. The icons to be used should be placed within the folder defined in the `<Device>` attributes. It is recommended that you have a merge icon tag for *every* input on the controller, although it is assumed that you will assign the same icon to multiple inputs (for example, a single "Left Stick" icon can be assigned to the left stick +X, -X, +Y and -Y inputs).

 

This element can have the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>SourceIcons</code></td><td><p>A combination of "keys" which represent specific in-sim actions. These "keys" will be bound to the target icon and localised text. See the <a href="../../2_DevMode/Input_Editors/The_Input_Device_Editor/#device_keys">Device Keys</a> section for more information. For multiple keys, they should be concatenated using <code>&amp;amp;</code> symbol, for example:</p><pre class="language-xml"><code>SourceIcons=&quot;R-STICK LEFT&amp;amp;R-STICK RIGHT&quot;</code></pre></td><td>String</td><td>Yes</td></tr><tr class="even"><td><code>TargetIcon</code></td><td><p>This is the name of the SVG file that should be linked to the source icon key. The name is given <em>without</em> the file extension, for example, the file <code>R-STICK_1.svg</code> would be given as:</p><pre class="language-xml"><code>TargetIcon=&quot;R-STICK_1&quot;</code></pre></td><td>String</td><td>Yes</td></tr><tr class="odd"><td><code>TargetTT</code></td><td><p>This is a localisable string that describes the action/icon. It is used as a <em>fallback</em> for those times when the icon cannot be displayed, and will not generally be shown in the simulation (but should still be supplied). For example:</p><pre class="language-xml"><code>TargetTT=&quot;TT:INPUT.GAMEPAD.ANALOGLEFT&quot;</code></pre><p>or</p><pre class="language-xml"><code>TargetTT=&quot;Analogue Left Stick&quot;</code></pre><p>Note that if you do not have a <a href="../Localization/Localization.htm">*.loc file</a> or have not localised the inputs, then you can leave this blank, or - preferably - add a string with an English description. Also note that if a text description is required by the simulation for <em>any</em> input, then the <code>&lt;ButtonTT&gt;</code> will be used.</p></td><td>String</td><td>Yes</td></tr></tbody></table>

 

 

### &lt;ButtonTT&gt;

This is a sub-element of `<Device>` and is used to define one or more localisable strings that represent a button, axis or slider on the device being used. These strings are used in the simulation when an icon is not appropriate or hasn't been defined, and there should be *one `<ButtonTT>` for every input on the device*. For example, if the device has a joystick, you should have 4 `<ButtonTT>` for up / down / left / right, or if there is a slider, there should be two `<ButtonTT>` for slider up and slider down, etc...

 

It can have the following attributes:

 

{{< table-wrapper >}}

| Attribute  | Description                                                                                                                                                                                          | Type   | Required |
|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|:--------:|
| `buttonId` | This is the ID string of the button that you want to describe.                                                                                                                                       | String |    Yes   |
| `TT`       | This is the description of the button. If you have a [\*.loc file](../localization/loc-files-localization/) then you can use the `TT:[string]` format, otherwise the button should be described in English. | String |    Yes   |

{{< /table-wrapper >}}


 

 

### SourceIcons Keys

There are a number of predefined keys available to you to use to bind one or more inputs to a given icon. The tables below show the keys for the different input devices, along with the **hardware string** they are associated with. Note that there are no tables for **mouse** or **Keyboard** input, as those devices will use the default UI icons.

 

#### Controller (XBox One for Windows)

<table><thead><tr class="header"><th><code>SourceIcons</code> Key</th><th><code>Information</code> Key</th><th>Controller Input</th></tr></thead><tbody><tr class="odd"><td>A</td><td>Button1</td><td><img src="css/control_transparent.png" id="_a" class="xbox" /></td></tr><tr class="even"><td>B</td><td>Button2</td><td><img src="css/control_transparent.png" id="_b" class="xbox" /></td></tr><tr class="odd"><td>X</td><td>Button3</td><td><img src="css/control_transparent.png" id="_x" class="xbox" /></td></tr><tr class="even"><td>Y</td><td>Button4</td><td><img src="css/control_transparent.png" id="_y" class="xbox" /></td></tr><tr class="odd"><td>LB</td><td>Button5</td><td><img src="css/control_transparent.png" id="_lb" class="xbox" /></td></tr><tr class="even"><td>RB</td><td>Button6</td><td><img src="css/control_transparent.png" id="_rb" class="xbox" /></td></tr><tr class="odd"><td>LT</td><td>Axis Z  

Axis Z+</td><td><img src="css/control_transparent.png" id="_lt" class="xbox" /></td></tr><tr class="even"><td>RT</td><td>Axis Z  

Axis Z-</td><td><img src="css/control_transparent.png" id="_rt" class="xbox" /></td></tr><tr class="odd"><td>L-STICK</td><td>Button9</td><td><img src="css/control_transparent.png" id="_lpress" class="xbox" width="16" height="16" /></td></tr><tr class="even"><td>R-STICK</td><td>Button10</td><td><img src="css/control_transparent.png" id="_rpress" class="xbox" /></td></tr><tr class="odd"><td>BACK</td><td>Button7</td><td><img src="css/control_transparent.png" id="_options" class="xbox" width="16" height="16" /></td></tr><tr class="even"><td>START</td><td>Button8</td><td><img src="css/control_transparent.png" id="_menu" class="xbox" width="16" height="16" /></td></tr><tr class="odd"><td>D-PAD LEFT</td><td>POV1  

POV1_LEFT</td><td><img src="css/control_transparent.png" id="_padl" class="xbox" width="16" height="16" /></td></tr><tr class="even"><td>D-PAD RIGHT</td><td>POV1  

POV1_RIGHT</td><td><img src="css/control_transparent.png" id="_padr" class="xbox" width="16" height="16" /></td></tr><tr class="odd"><td>D-PAD UP</td><td>POV1  

POV1_UP</td><td><img src="css/control_transparent.png" id="_padu" class="xbox" width="16" height="16" /></td></tr><tr class="even"><td>D-PAD DOWN</td><td>POV1  

POV1_DOWN</td><td><img src="css/control_transparent.png" id="_padd" class="xbox" width="16" height="16" /></td></tr><tr class="odd"><td>L-STICK LEFT</td><td>Axis X-</td><td><img src="css/control_transparent.png" id="_lsl" class="xbox" width="16" height="16" /></td></tr><tr class="even"><td>L-STICK RIGHT</td><td>Axis X+</td><td><img src="css/control_transparent.png" id="_lsr" class="xbox" /></td></tr><tr class="odd"><td>L-STICK UP</td><td>Axis Y-</td><td><img src="css/control_transparent.png" id="_lsu" class="xbox" /></td></tr><tr class="even"><td>L-STICK DOWN</td><td>Axis Y+</td><td><img src="css/control_transparent.png" id="_lsd" class="xbox" /></td></tr><tr class="odd"><td>R-STICK LEFT</td><td>Rotation X-</td><td><img src="css/control_transparent.png" id="_rsl" class="xbox" /></td></tr><tr class="even"><td>R-STICK RIGHT</td><td>Rotation X+</td><td><img src="css/control_transparent.png" id="_rsr" class="xbox" /></td></tr><tr class="odd"><td>R-STICK UP</td><td>Rotation Y-</td><td><img src="css/control_transparent.png" id="_rsu" class="xbox" /></td></tr><tr class="even"><td>R-STICK DOWN</td><td>Rotation Y+</td><td><img src="css/control_transparent.png" id="_rsd" class="xbox" /></td></tr><tr class="odd"><td>L-STICK X</td><td>Axis X</td><td><img src="css/control_transparent.png" id="_laxisx" class="xbox" /></td></tr><tr class="even"><td>L-STICK Y</td><td>Axis Y</td><td><img src="css/control_transparent.png" id="_laxisy" class="xbox" /></td></tr><tr class="odd"><td>R-STICK X</td><td>Rotation X</td><td><img src="css/control_transparent.png" id="_raxisx" class="xbox" /></td></tr><tr class="even"><td>R-STICK Y</td><td>Rotation Y</td><td><img src="css/control_transparent.png" id="_raxisy" class="xbox" /></td></tr></tbody></table>

 

 

#### Xinput Controller / XBox Series Gamepad

{{< table-wrapper >}}

| `SourceIcons` Key | `Information` Key |
|:-----------------:|:-----------------:|
|         A         |         A         |
|         B         |         B         |
|         X         |         X         |
|         Y         |         Y         |
|         LB        |         LB        |
|         RB        |         RB        |
|         LT        |         LT        |
|         RT        |         RT        |
|      L-STICK      |       LSTICK      |
|      R-STICK      |       RSTICK      |
|        BACK       |        BACK       |
|       START       |       START       |
|     D-PAD LEFT    |        LEFT       |
|    D-PAD RIGHT    |       RIGHT       |
|      D-PAD UP     |         UP        |
|     D-PAD DOWN    |        DOWN       |
|    L-STICK LEFT   |   LANALOG\_LEFT   |
|   L-STICK RIGHT   |   LANALOG\_RIGHT  |
|     L-STICK UP    |    LANALOG\_UP    |
|    L-STICK DOWN   |   LANALOG\_DOWN   |
|    R-STICK LEFT   |   RANALOG\_LEFT   |
|   R-STICK RIGHT   |   RANALOG\_RIGHT  |
|     R-STICK UP    |    RANALOG\_UP    |
|    R-STICK DOWN   |   RANALOG\_DOWN   |
|     L-STICK X     |     LANALOG\_X    |
|     L-STICK Y     |     LANALOG\_Y    |
|     R-STICK X     |     RANALOG\_X    |
|     R-STICK Y     |     RANALOG\_Y    |

{{< /table-wrapper >}}


 

 

#### XBox Series Stick

{{< table-wrapper >}}

|    `SourceIcons` Key   |  `Information` Key |
|:----------------------:|:------------------:|
| JOYSTICK BUTTON 1 - 16 | Button1 - Button32 |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |
|                        |                    |

{{< /table-wrapper >}}


 

 

#### XR Controller Left / XR Controller Right

{{< table-wrapper >}}

|   `SourceIcons` Key   |    `Information` Key   |
|:---------------------:|:----------------------:|
|        Click A        |        A\_CLICK        |
|        Touch A        |        A\_TOUCH        |
|        Click B        |        B\_CLICK        |
|        Touch B        |        B\_TOUCH        |
|          Back         |       BACK\_CLICK      |
|          Menu         |       MENU\_CLICK      |
|         Select        |      SELECT\_CLICK     |
|     Click Squeeze     |     SQUEEZE\_CLICK     |
|     Force Squeeze     |     SQUEEZE\_FORCE     |
|     Value Squeeze     |     SQUEEZE\_VALUE     |
|      Click System     |      SYSTEM\_CLICK     |
|      Touch System     |      SYSTEM\_TOUCH     |
|    Touch Thumbrest    |    THUMBREST\_TOUCH    |
|    Click Thumbstick   |    THUMBSTICK\_CLICK   |
|    Touch Thumbstick   |    THUMBSTICK\_TOUCH   |
| Horizontal Thumbstick |      THUMBSTICK\_X     |
|   Vertical Tumbstick  |      THUMBSTICK\_Y     |
|     Click Trackpad    |     TRACKPAD\_CLICK    |
|     Force Trackpad    |     TRACKPAD\_FORCE    |
|     Touch Trackpad    |     TRACKPAD\_TOUCH    |
|  Horizontal Trackpad  |       TRACKPAD\_X      |
|   Vertical Trackpad   |       TRACKPAD\_Y      |
|     Click Trigger     |     TRIGGER\_CLICK     |
|     Touch Trigger     |     TRIGGER\_TOUCH     |
|     Value Trigger     |     TRIGGER\_VALUE     |
|        Click X        |        X\_CLICK        |
|        Touch X        |        X\_TOUCH        |
|        Click Y        |        Y\_CLICK        |
|        Touch Y        |        Y\_TOUCH        |
|     Trackpack Left    |  TRACKPAD\_LEFT\_CLICK |
|    Trackpack Right    | TRACKPAD\_RIGHT\_CLICK |
|     Trackpack Down    |   TRACKPAD\_UP\_CLICK  |
|      Trackpack Up     |  TRACKPAD\_DOWN\_CLICK |

{{< /table-wrapper >}}