Projets:Interfaces XAC

Projet interface XAC

Description du projet

Réaliser et mettre oeuvre une solution logicielle et hardware pour connecter des interfaces de type Joystick à une XAC (Xbox Adaptive Controller).

On doit pouvoir se connecter sur les entrées arrières X1,X2 ou sur les entrées USB Gauche et Droite.

• 
• 
• 

• 
• 
• 

• Fournir plusieurs types de dispositifs
  • Joystick JPS ou Arduino sur Entrées Arrières X1 ou X2
  • Joystick JPS ou Arduino sur Teensy LC connectée comme Joystick à une entrée USB XAC
  • Joystick JPS ou arduino sur Arduino Micro Pro connectée comme Joystick à une entrée USB XAC
  • Souris avec ou sans fil ou Souris au-travers de R-Net BT connectées comme Joystick à une entrée USB XAC

Equipe (Porteur de projet et contributeurs)

• Jonathan (Porteur de projet)
• Contributeurs
• Animateur (Coordinateur du projet)
• Fabmanager référent
• Responsable de documentation
• Christian (Concepteur)

Matériel nécessaire

Carte Teensy LC.

Carte Arduino Micro-pro

Carte Mini Host Usb

Outils nécessaires

Imprimante 3d IDE Arduino 1.89 TeensyDuino 1.46

Fichiers source

Attention pour que le fichier compile il ne faut pas oublier de configurer depuis IDE Arduino>Outil>USB type>Serial+keyboard+Mouse+Joystick

Schémas

• Les fichiers "Sch" et "lib" sous Kicad pour concevoir les PCB
  • Les fichiers kicad: Fichier:KICAD XAC.zip

• 

  Host USB

• 

  In X1 ou X2

• 

  Joystick Carte Teensy

• 

  Joystick Carte Micro Pro

Code Arduino

• Les fichiers ".Ino" pour le firmware des cartes :
  • BT Hid vers XAC ou Pc sans envoie sur le port série carte Teensy LC :
    • Fichier:LC BTHID Mouse-to-Joy XAC-PC.zip
  • BT Hid vers Pc avec envoie sur le port série carte Teensy LC :
    • Fichier:LC BTHID Mouse-to-Joy-Serial PC.zip
  • USB Hid vers XAC ou Pc sans envoie sur le port série carte Teensy LC :
    • Fichier:LC USBHID Mouse-to-Joy XAC-PC.zip
  • USB Hid vers Pc avec envoie sur le port série carte Teensy LC :
    • Fichier:LC USBHID Mouse-to-Joy-Serial PC.zip
  • JPS ou Analogique Arduino vers XAC ou Pc sans envoie sur le port série carte Teensy LC :
    • Fichier:LC JPS-to-Joy XAC-PC.zip
  • JPS ou Analogique Arduino vers Pc avec envoie sur le port série carte Teensy LC :
    • Fichier:LC JPS-to-Joy-Serial PC.zip
  • JPS ou Analogique Arduino vers XAC ou Pc sans envoie sur le port série carte Micro Pro :
    • Fichier:MICRO JPS-to-Joy-XAC-PC.zip
  • JPS ou Analogique Arduino vers Pc avec envoie sur le port série carte Micro Pro :
    • Fichier:MICRO JPS-to-Joy-Serial PC.zip

Les Librairies à ajouter ou à remplacer

Sources librairies :

https://github.com/felis/USB_Host_Shield_2.0

https://github.com/gdsports/xac-mouse2joy/blob/master/joystick_teensy_20181205.zip

Le développement de ce code a été modifié par Christian Fromentin MHK Rennes.

Voir le fichier "Regarde-moi.txt" dans le dossier XAC-Joystick

A placer dans la librairie Arduino :

• • • Fichier:Lib-189.zip
  • A placer dans le répertoire du logiciel /../Arduino/Hardware :
    • Fichier:A deposer dans Arduino Hardware 189.zip

Etapes de fabrication pas à pas

La carte Mini Usb Host doit être modifiée.

(Certaine carte possède un strap qui permet de le faire sans couper une piste)

Il faut permettre l'alimentation du connecteur USB avec 5 volt et non 3.3v par défaut avec cette carte:

• Etape 1 :
  • Couper la piste comme sur la photo (juste avant l'inscription "2.2k") et souder un fil :
    • 

• Etape :
  • Souder l'autre extrémité du fil :
    • 

Config 1: BT Hid vers XAC ou PC sans envoi sur le port série carte Teensy LC

Méthode pour valider le fonctionnement de l'ensemble

Pour tester le Joystick du fauteuil (industriel), il faut couper le Bluetooth du PC pour empêcher le fauteuil de se connecter directement au PC en mode souris.

1-Vérifier que le montage Teensy+Host USB est reconnu en tant que joystick par l'ordinateur

1. Connecter uniquement la teensy avec le host USB à l'ordinateur
2. Ouvrir le sketch test du joystick :LC JPS-to-Joy XAC-PC_TEST
3. Dans l'IDE Arduino, choisir dans Outil>USB Type : Joystick +Serial (vous devez voir cette option sinon c'est que les librairies sont mal ou pas installées)
4. Téléverser le sketch sur la Teensy.
5. Ouvrir les périphériques contrôleur de jeu (Sur Windows, taper dans la barre de recherche en bas à gauche, "Configurer les contrôleurs de jeu" puis la fenêtre Contrôleurs de jeu s'ouvre et vous devriez voir Keyboard/Mouse/Joystick, puis cliquer sur Propriétés pour avoir un affichage de l'état du joystick.)
6. Vous devriez voir le joystick bouger

2-Vérifier la communication entre la XAC et l'ordinateur

1. Connecter la XAC à l'ordinateur (le pilote s'installe à la connection)
2. On garde les propriétés du contrôleur de jeu ouvert
3. On doit voir le dispositif xbox reconnu, avec le périphérique qui s'actualise dans la fenêtre des propriétés du controleur. Evidemment ici on ne voit pas le joystick bouger puisque la teensy n'est pas connectée

(Il faut télécharger l'interface de la xbox pour ordi pour pouvoir prendre le contrôle/remapper/etc... (ou on peut le faire sur la xbox)

3-Vérifier que le joystick simulé par la teensy est reconnu quand connecté à la XAC

1. connecter le proto host usb/teensy sur la xac toujours avec le sketch test du joystick :LC JPS-to-Joy XAC-PC_TEST
2. vérifier dans les propriétés du contrôleur de jeu que le joystick bouge

4-Test avec le joystick du fauteuil

1. Teléverser le sketch LC_BTHID_Mouse-to-Joy_XAC-PC sur la teensy

LC_BTHID_Mouse-to-Joy_XAC-PC sur la teensy

1. Connecter directement la teensy+host sur le pc
2. Vérifier dans les propriétés du contrôleur que le joystick du fauteuil envoie en bluetooth les informations de déplacement

5-Vérifier que la XAC est reconnue

1. Déconnecter la teensy du pc
2. Connecter la xac sur le pc
3. Vérifier dans le contrôleur de jeu que la xbox one (xac) est bien reconnue (le contrôleur doit actualiser le nom du périphérique reconnu)
4. connecter ensuite la teensy+host usb sur la xac. Vous devriez visualiser les mouvements du joycstick du fauteuil.

6-[OPTIONNEL] Test avec l'application Accessoire xbox

1. Télécharger l'application. Cette application est uniquement valable pour Windows 10. Elle permet de visualiser la XAC et de la paramétrer. https://www.microsoft.com/fr-fr/p/accessoires-xbox/9nblggh30xj3?activetab=pivot:regionofsystemrequirementstab
2. Démarrer l'application

Aller sur "configurer">Editer en cliquant sur l'icône crayon>Stick analogique gauche Vous devriez visualiser le joystick bouger.

La sensibilité du joystick se règle directement sur la xac. Il est préférable de laisser toute la configuration du mapping se faire dans l'interface la XAC et de ne pas introduire cette notion dans le code.

7-Tester le dispositif sur la XBOX

1. Déconnecter la XAC du PC
2. Connecter la XAC +teensy host USB sur la XBOX

Contexte technique du projet

Le joystick du fauteuil est en réalité une souris, c'est-à-dire qu'à chaque fois qu'on bouge la souris on reprend la position là où on l'avait laché, on est en position relative qui s'incrémente à chaque fois qu'on la bouge. Le code n'est pas optimisé pour l'utilisation avec le joystick du fauteuil, mais pour le joystick proportionnel sensible qui lui a une position neutre et fonctionne avec des positions absolues.

Christian n'a pas mappé les valeurs dans le code. Les valeurs vont de 0 à 1024 sur les deux axes (X et Y). Il est préférable de faire le mapping dans la xac.

La vitesse de deplacement de la souris est prise en compte pour l'incrémentation (lentement on incrémente de 1 et rapidement on a un pas de 100). Ce qu il faudrait , c'est au lieu d'avoir un pas de 100, le remplacer par un pas de 1 mais qui va beaucoup plus vite.

Développements à prévoir

Introduction du neutre dans le code

- Comment avoir un neutre sur une souris en respectant les contraintes de temps (latence) dans un jeu ? On ne peut avoir l'information que la souris est en position neutre à part observer qu'elle n'envoie pas d'information sur un temps donné (ce temps doit être très court, de l'ordre de microsecondes)

Retour visuel des connections/com

- Prévoir des leds de couleurs ou clignotement pour avoir un retour visuel des informations reçus par la Teensy : l'appairage en bluetooth, reconnaissance du joystick fauteuil, de la xac etc..

Anticiper l'ajout de boutons/leds/ ... sur des pins

- Prévoir les pins pour les devs futurs avec des pins headers (voir schema) pour pouvoir ajouter des boutons, leds ou autres