> For the complete documentation index, see [llms.txt](https://wiki.retrobat.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.retrobat.org/francais/controleurs/supported-controllers/volants.md).

# Volants

Vroum vroum

{% hint style="warning" %}
**En cours de développement** : la gestion des volants dans RetroBat est encore en construction. Seuls quelques volants ont une configuration prête pour chaque émulateur, et ils n'ont pu être testés qu'avec les volants que possède l'équipe.

**Nous avons besoin de vous !** Si vous avez un volant qui n'est pas encore configuré, créez son mappage (voir plus bas) et partagez-le sur le Discord RetroBat ou sur GitHub, pour qu'il soit ajouté à RetroBat pour tout le monde.
{% endhint %}

## Fonctionnement

Quand les volants sont activés, RetroBat :

1. détecte les volants branchés grâce à leur identifiant USB (voir la liste des volants détectés) ;
2. cherche le mappage de ce modèle de volant dans le fichier de mappage de l'émulateur (votre copie dans `user\inputmapping` en priorité, sinon `system\resources\inputmapping\wheels`) ;
3. écrit ce mappage dans la configuration de l'émulateur (direction, pédales, vitesses, boutons).

Si un volant n'est pas dans la liste des volants détectés, ou n'a pas de mappage pour l'émulateur, RetroBat ne le configure pas comme un volant.

{% hint style="info" %}

* Un volant **avec pédalier** est nécessaire (accélérateur et frein) : RetroBat ne propose pas de jouer avec un volant sans pédales.
* Le levier de vitesses est optionnel : sans levier en H, activez **DÉSACTIVER LE LEVIER DE VITESSE** (les vitesses passent alors par les boutons du volant). Sur certains volants Thrustmaster, le levier est un périphérique séparé : c'est géré par la valeur `DeportedShifter` des fichiers de mappage, ou par **FORCER L'ID DU LEVIER DE VITESSE**.
  {% endhint %}

## Activer les volants

Les volants **ne sont pas activés automatiquement**. Activez-les pour un système ou pour un jeu :

* Pour un système : ouvrez les [Options d'affichage](https://wiki.retrobat.org/francais/navigation/view-options.md) du système, choisissez **CONFIGURATION AVANCÉE DU SYSTÈME**, puis **VOLANTS DE COURSE**, et réglez **ACTIVER LES VOLANTS** sur **ON**.
* Pour un jeu : même option dans les [Options du jeu](https://wiki.retrobat.org/francais/navigation/game-options.md) > **CONFIGURATION AVANCÉE DU JEU** > **VOLANTS DE COURSE**.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FjgwmcrfIlfxp5VY4M0kg%2Fimage.png?alt=media&amp;token=a4d9ae4c-cbb5-4b68-a284-77cd1f057cb3" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FrUb6l7pQOKNncbb7kDY7%2Fimage.png?alt=media&amp;token=02349cbd-4347-4bf9-ba67-5efff12510d5" alt=""><figcaption></figcaption></figure></div>

Le sous-menu **VOLANTS DE COURSE** contient aussi les options volant de chaque émulateur (retour de force, disposition des boutons…), voir le tableau plus bas.

### Jeux au volant

RetroBat sait quels jeux se jouent au volant :

* Une icône de volant s'affiche à côté de leur nom dans la liste des jeux (**MENU PRINCIPAL > PARAMÈTRES D'AFFICHAGE > ICÔNES > AFFICHER L'ICÔNE VOLANT**).

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FMFua3vf6Qu7DlX3mHkZw%2Fimage.png?alt=media&amp;token=e7008df3-4abb-44df-9662-d9800e94f6ac" alt=""><figcaption></figcaption></figure></div>

* La collection **VOLANT** contient tous les jeux au volant.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FUlQBUIJCutwvatMO3z8h%2Fimage.png?alt=media&amp;token=0e27c7f4-8bc7-4375-82e2-2be5fe5fa1b3" alt=""><figcaption></figcaption></figure></div>

La liste des jeux au volant est dans le fichier `emulationstation\resources\gamesdb.xml` (jeux marqués `<wheel/>`). Pour la personnaliser, copiez le fichier dans `emulationstation\.emulationstation\resources\gamesdb.xml` et modifiez la copie : elle est lue en priorité et n'est pas écrasée par les mises à jour de RetroBat.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FPRwm99KhT711xjq0Avfb%2Fimage.png?alt=media&amp;token=3ca6b1cb-f0d2-43b4-903e-d9defaaf964c" alt=""><figcaption></figcaption></figure></div>

## Émulateurs compatibles

<table><thead><tr><th width="149">Émulateur</th><th width="153">Systèmes</th><th>Fichier de mappage</th><th>Options volant (sous-menu VOLANTS DE COURSE)</th></tr></thead><tbody><tr><td><strong>Model 2 Emulator</strong></td><td>Sega Model 2</td><td><code>model2_wheels.yml</code></td><td>ACTIVER LE RETOUR DE FORCE, DÉSACTIVER LE LEVIER DE VITESSE, GARDER LES VITESSES, FORCER L'ID DU LEVIER DE VITESSE</td></tr><tr><td><strong>Keisho</strong></td><td>Sega Model 1, Model 2, Model 3</td><td><code>keisho_wheels.yml</code> (boutons uniquement : direction et pédales sont détectées par Keisho)</td><td>ACTIVER LE RETOUR DE FORCE, FORCE DU RETOUR DE FORCE, DÉSACTIVER LE LEVIER DE VITESSE</td></tr><tr><td><strong>Supermodel</strong></td><td>Sega Model 3</td><td><code>model3_wheels.yml</code></td><td>ACTIVER LE RETOUR DE FORCE, FORCER L'INDEX DU VOLANT, DÉSACTIVER LE LEVIER DE VITESSE, FORCER L'ID DU LEVIER DE VITESSE</td></tr><tr><td><strong>Model3-Vulkan</strong></td><td>Sega Model 3</td><td><code>model3vulkan_wheels.yml</code>, sinon <code>model3_wheels.yml</code></td><td>DÉSACTIVER LE LEVIER DE VITESSE, FORCER L'INDEX DU VOLANT, FORCER L'ID DU LEVIER DE VITESSE</td></tr><tr><td><strong>Odin</strong></td><td>Hikaru (NASCAR Arcade), Gaelco (ATV Track, Smashing Drive)</td><td><code>odin_wheels.yml</code>, sinon <code>model3_wheels.yml</code> (sans mappage, Odin dirige avec le premier axe)</td><td>ROTATION DU VOLANT, FORCE DU RETOUR DE FORCE</td></tr><tr><td><strong>Linuxloader</strong></td><td>Sega Lindbergh</td><td><code>linuxloader_wheels.yml</code> (les volants XInput, vus comme des manettes, utilisent le mappage manette)</td><td>–</td></tr><tr><td><strong>Flycast</strong></td><td>Dreamcast, Naomi, Atomiswave</td><td><code>flycast_wheels.yml</code> (Dreamcast), <code>flycast_racing_wheels.yml</code> (Dreamcast avec <strong>UTILISER LE RACING CONTROLLER</strong>), <code>flycast_arcade_wheels.yml</code> (arcade)</td><td>UTILISER LE RACING CONTROLLER, DISPOSITION DES BOUTONS DU VOLANT</td></tr><tr><td><strong>PCSX2</strong></td><td>PlayStation 2</td><td><code>pcsx2_wheels.yml</code></td><td>TYPE DE VOLANT JOUEUR 1, ACTIVER LE RETOUR DE FORCE, SIMULER LE VOLANT AVEC LA MANETTE…</td></tr><tr><td><strong>PCSX2x6</strong></td><td>Namco System 246/256</td><td><code>pcsx2x6_wheels.yml</code></td><td>ACTIVER LE RETOUR DE FORCE</td></tr><tr><td><strong>TeknoParrot</strong></td><td>Arcade sur PC</td><td><code>teknoparrot_wheels.yml</code></td><td>BOUTONS COIN &#x26; START, BOUTONS TEST &#x26; SERVICE, PROFIL PERSONNALISÉ…</td></tr><tr><td><strong>RetroArch - lr-flycast</strong></td><td>Dreamcast, Naomi, Atomiswave</td><td><code>libretro_flycast_wheels.yml</code> (pas encore fourni)</td><td>ACTIVER LES VOLANTS</td></tr></tbody></table>

### Volants avec un mappage prêt

<table><thead><tr><th width="125.5">Volant</th><th width="75.5" align="center">Model 2</th><th width="71.75" align="center">Keisho</th><th width="105.5" align="center">Supermodel, Model3-Vulkan, Odin</th><th width="80.5" align="center">Linuxloader</th><th width="73" align="center">Flycast</th><th width="88" align="center">PCSX2 / PCSX2x6</th><th align="center">TeknoParrot</th></tr></thead><tbody><tr><td>Logitech G29</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td></tr><tr><td>Logitech G920</td><td align="center">✔</td><td align="center">✔</td><td align="center"></td><td align="center">✔</td><td align="center">✔</td><td align="center"></td><td align="center">✔</td></tr><tr><td>Logitech G923 (PlayStation)</td><td align="center">✔</td><td align="center">✔</td><td align="center"></td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td></tr><tr><td>Logitech G923 (Xbox)</td><td align="center">✔</td><td align="center">✔</td><td align="center"></td><td align="center">✔</td><td align="center">✔</td><td align="center"></td><td align="center">✔</td></tr><tr><td>Logitech Driving Force GT</td><td align="center"></td><td align="center">✔</td><td align="center"></td><td align="center"></td><td align="center">✔</td><td align="center">✔</td><td align="center"></td></tr><tr><td>Thrustmaster T300RS (mode PS3)</td><td align="center">✔</td><td align="center">✔</td><td align="center"></td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td></tr><tr><td>Moza R5</td><td align="center"></td><td align="center">✔</td><td align="center"></td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td></tr></tbody></table>

TeknoParrot et Linuxloader ont aussi un mappage pour de nombreux autres volants (Logitech G Pro, Thrustmaster T150 / TMX / T248 / T300RS PS4 / T500RS / TX / TS-XW, Fanatec, Moza R9 / R12 / R16, Simucube, Simagic, Asetek, Cammus, PXN V9) et un mappage `default` utilisé pour les autres volants détectés.

Supermodel, Model3-Vulkan et Odin utilisent le même fichier `model3_wheels.yml`. \
Model3-Vulkan et Odin lisent d'abord `model3vulkan_wheels.yml` / `odin_wheels.yml` s'il existe (non fournis par RetroBat).\
Avec un volant configuré par RetroBat, Model3-Vulkan désactive le lissage et la sensibilité de la direction prévus pour la manette : la direction suit le volant sans filtre.

{% hint style="info" %}
**Thrustmaster T300RS** : réglez les pédales en mode **séparé** (split) dans le Thrustmaster Control Panel, et vérifiez qu'elles ne sont pas inversées (corrigé en maintenant **MODE + L3 + R3**).
{% endhint %}

## Ajouter ou modifier le mappage d'un volant

{% hint style="info" %}
Les fichiers de mappage des volants fournis par RetroBat sont dans `system\resources\inputmapping\wheels`. Vos propres fichiers vont dans `user\inputmapping` .
{% endhint %}

Chaque fichier de mappage contient **un bloc par modèle de volant**, nommé avec le nom RetroBat du volant (voir Volants détectés). Les lignes du bloc sont indentées de 2 espaces.

{% hint style="warning" %}
Chaque émulateur utilise **sa propre notation** pour les boutons et les axes (boutons numérotés à partir de 0 ou de 1, noms des axes…). Partez toujours d'un bloc existant **du même fichier** (le bloc `LogitechG29` est un bon exemple) et lisez les explications en haut du fichier.
{% endhint %}

<table><thead><tr><th width="224.5">Fichier</th><th>Boutons</th><th>Axes</th></tr></thead><tbody><tr><td><code>model2_wheels.yml</code></td><td><code>button0</code>, <code>button1</code>… (à partir de 0)</td><td><code>axis0</code>, <code>axisinv0</code>…</td></tr><tr><td><code>keisho_wheels.yml</code></td><td><code>0</code>, <code>1</code>… (à partir de 0), <code>-1</code> = aucun</td><td>Détectés par Keisho (à calibrer dans le menu de Keisho)</td></tr><tr><td><code>model3_wheels.yml</code>, <code>linuxloader_wheels.yml</code></td><td><code>BUTTON1</code>, <code>BUTTON2</code>… (à partir de 1), <code>POV1_UP</code>…</td><td><code>XAXIS_NEG</code>, <code>RZAXIS_POS</code>, <code>SLIDER1</code>…</td></tr></tbody></table>

### Exemple : Model 2 Emulator

Le bloc `LogitechG29` de `model2_wheels.yml` :

```yaml
LogitechG29:
  DeportedShifter: false
  Up: hatup
  Down: hatdown
  Left: hatleft
  Right: hatright
  Steer: axis0
  Throttle: axis1
  Brake: axis2
  ShiftDown: button5
  ShiftUp: button4
  South: button0
  East: button2
  West: button1
  North: button3
  Start: button9
  Select: button8
  Gear1: button12
  Gear2: button13
  Gear3: button14
  Gear4: button15
  GearN: button18
  Service: button10
  Test: button11
```

* `axis0`, `axis1`… sont les axes du volant (direction, accélérateur, frein). Utilisez `axisinv` au lieu de `axis` pour inverser un axe.
* `button0`, `button1`… sont les boutons du volant, **numérotés à partir de 0**. Dans le panneau des contrôleurs de jeu de Windows (`joy.cpl` > Propriétés), les boutons sont numérotés à partir de 1 : retirez 1.
* `DeportedShifter: true` ne sert que pour les volants dont le levier de vitesses est un périphérique séparé.

Pour ajouter votre volant :

1. Copiez le fichier dans `user\inputmapping` (par exemple `user\inputmapping\model2_wheels.yml`) : RetroBat lit cette copie en priorité, et elle n'est pas écrasée par les mises à jour.
2. Dupliquez le bloc `LogitechG29` et renommez-le avec le nom de votre volant (par exemple `ThrustmasterT150:`).
3. Remplacez les valeurs par les axes et boutons de votre volant, puis testez en jeu.
4. Vérifiez `emulationstation\emulatorLauncher.log` : les lignes `[WHEELS]` indiquent le volant détecté et le mappage utilisé.

{% hint style="info" %}
Pour **Flycast** et **PCSX2**, le plus simple est de configurer le volant une fois dans l'émulateur lui-même, puis de reporter les valeurs du fichier de configuration qu'il crée (pour Flycast : `emulators\flycast\mappings`). La valeur `name` doit être le nom exact du volant affiché par l'émulateur.
{% endhint %}

{% hint style="success" %}
Votre mappage fonctionne ? Partagez-le sur le Discord RetroBat ou sur GitHub, pour qu'il soit ajouté à RetroBat !
{% endhint %}

### RetroArch (lr-flycast)

La gestion des volants est prête pour le core **lr-flycast** (option **ACTIVER LES VOLANTS**), mais **RetroBat ne fournit pas encore de fichier de mappage pour ce core**. Pour utiliser votre volant avec lr-flycast, créez le fichier `libretro_flycast_wheels.yml` dans `user\inputmapping`, avec un bloc par volant :

* les clés sont les entrées RetroArch : `a`, `b`, `x`, `y`, `start`, `select`, `up`, `down`, `left`, `right`, `l`, `r`, `l2`, `r2`, `l3`, `r3`, `l_x_minus`, `l_x_plus`, `l_y_minus`, `l_y_plus`… ;
* une valeur qui commence par `+` ou `-` est un **axe** (par exemple `-0` pour l'axe 0 dans le sens négatif), toute autre valeur est un numéro de **bouton** ;
* la clé optionnelle `driver` indique le pilote d'entrée RetroArch à utiliser avec ce volant (`sdl2`, `dinput`…).

```yaml
LogitechG29:
  driver: sdl2
  l_x_minus: ...   # direction à gauche (axe)
  l_x_plus: ...    # direction à droite (axe)
  r2: ...          # accélérateur (axe)
  l2: ...          # frein (axe)
  a: ...           # bouton
  b: ...           # bouton
  start: ...       # bouton
```

Si vous créez ce fichier, partagez-le avec l'équipe !

## Volants détectés

<details>

<summary>Noms RetroBat des volants et identifiants USB</summary>

| Nom dans RetroBat            | Identification USB (VID/PID) |
| ---------------------------- | ---------------------------- |
| AsetekForte                  | 2433 / F301                  |
| AsetekInvicta                | 2433 / F300                  |
| AsetekLaPrima                | 2433 / F303                  |
| AsetekTonyKannan             | 2433 / F306                  |
| CammusC5                     | 3416 / 0301                  |
| CammusC12                    | 3416 / 0302                  |
| FanatecClubSportWheelBaseV2  | 0EB7 / 0001                  |
| FanatecClubSportWheelBaseV25 | 0EB7 / 0004                  |
| FanatecCSLElite              | 0EB7 / 0E03                  |
| FanatecCSLElitePS4           | 0EB7 / 0005                  |
| FanatecCSRElite              | 0EB7 / 0011                  |
| FanatecDD                    | 0EB7 / 0020                  |
| FanatecPodiumDD1             | 0EB7 / 0006                  |
| FanatecPodiumDD2             | 0EB7 / 0007                  |
| LogitechDrivingForce         | 046D / C294, C298            |
| LogitechDrivingForceGT       | 046D / C29A                  |
| LogitechG25                  | 046D / C299                  |
| LogitechG27                  | 046D / C29B                  |
| LogitechG29                  | 046D / C24F, C260            |
| LogitechG920                 | 046D / C262                  |
| LogitechG923PS               | 046D / C266, C267            |
| LogitechG923X                | 046D / C26D, C26E            |
| LogitechGPro                 | 046D / C272                  |
| LogitechMomoForce            | 046D / C295                  |
| LogitechMomoRacing           | 046D / CA03                  |
| LogitechRacingWheel          | 046D / CA04                  |
| LogitechSpeedForce           | 046D / C29C                  |
| LogitechWingmanFormula       | 046D / C202                  |
| LogitechWingmanFormulaForce  | 046D / C293                  |
| LogitechWingmanFormulaGP     | 046D / C20E                  |
| MicrosoftSideWinder          | 045E / 001A, 0034            |
| MozaR3                       | 346E / 0005                  |
| MozaR5                       | 346E / 0004                  |
| MozaR9                       | 346E / 0002                  |
| MozaR12                      | 346E / 0006                  |
| MozaR16                      | 346E / 0000                  |
| PXNV9                        | 11FF / 0511                  |
| SimagicM10                   | 0483 / 0522                  |
| Simucube1                    | 16D0 / 0D5A                  |
| Simucube2Pro                 | 16D0 / 0D60                  |
| Simucube2Sport               | 16D0 / 0D61                  |
| Simucube2Ultimate            | 16D0 / 0D5F                  |
| SimXperienceAccuForcePro     | 1FC9 / 804C                  |
| ThrustmasterF430FF           | 044F / B56A                  |
| ThrustmasterFGTFF            | 044F / B654                  |
| ThrustmasterFGTRumbleForce   | 044F / B651                  |
| ThrustmasterNascarProFF2     | 044F / B605                  |
| ThrustmasterRGT              | 044F / B653                  |
| ThrustmasterT150             | 044F / B677                  |
| ThrustmasterT248             | 044F / B696                  |
| ThrustmasterT300RSPS3        | 044F / B66E                  |
| ThrustmasterT300RSPS3ADV     | 044F / B66F                  |
| ThrustmasterT300RSPS4        | 044F / B66D                  |
| ThrustmasterT500RS           | 044F / B56E                  |
| ThrustmasterTMX              | 044F / B67F                  |
| ThrustmasterTSPC             | 044F / B689                  |
| ThrustmasterTSXW             | 044F / B692                  |
| ThrustmasterTX               | 044F / B669                  |
| VRSDirectForcePro            | 0483 / A355                  |

</details>

Votre volant n'est pas dans la liste ? Relevez son VID et son PID dans le Gestionnaire de périphériques de Windows (Propriétés > Détails > ID du matériel) et envoyez-les à l'équipe sur Discord ou GitHub.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wiki.retrobat.org/francais/controleurs/supported-controllers/volants.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
