dimanche 25 octobre 2015

X-plane : Mise en place d'instruments de bord sur tablette/SmartPhone Android

Dans cet article, je vous propose d'installer et d'utiliser le programme de Ville Ranki pour déporter des instruments de cockpit sur une tablette android.

Mais d'abord, voici un aperçu des instruments qui sont disponibles  :


Installation :

plugin Xplane :

Suivant le type de votre système d'exploitation sur lequel tourne Xplane, télécharger le plugin.
depuis gitHub ExtPlane-Panel dans la section téléchargement ou directement ici :

linux 64 bit

 Ext-Plane_plugin_lin64.xpl

MacOS

 Ext-Plane_plugin_mac64.xpl

Windows 64 bit

 Ext-Plane_plugin_win64.xpl



puis ajouter le fichier  Ext-Plane_plugin_[os].xpl dans le répertoire Resources/Plugins d'xplane.

Pour tester si le plugin fonctionne, lancer xplane. Ensuite créer une connexion telnet sur le port 51000. Exemple, depuis le même ordi qui exécute xplane:
telnet localhost 51000.
doit afficher
EXTPLANE 1

pour sortir de telnet, taper
disconnect


Tablette Android :

une fois le plugin installé, il ne reste plus qu'à télécharger le programme sur votre tablette ou smartphone. Malheureusement, je ne l'ai pas mis sur le GooglePlay (ou playStore) car c'est une option payante pour le développeur.
Donc pour installer le programme, essayez de le télécharger directement en cliquant sur le lien suivant :
android-build-debug.apk

Si tout se passe bien, le système Androïd doit vous demander votre autorisation pour installer le programme, sinon aller dans les paramètres du système et vérifier que androïd autorise l'installation de programme non signé.

Une fois le programme 'android-build-debug.apk' installé sur votre appareil android, télécharger le fichier 'ExtPlane-Panel-Default.ini' dans le répertoire 'Mes Documents'. Ce fichier sert à enregistrer la configuration du Panel (tableau de bord). Ainsi, en démarrant programme Panel, vous aurez quelques instruments affichés.
Si vous ne téléchargez pas ce fichier, le programme en créera un 'vide'. Vous devrez alors aller dans le menu pour ajouter des instruments.

Paramétrage de l'application Androïd


remarque préalable : l'application ne se redimensionne pas automatiquement en fonction de la résolution de l'écran. Ainsi, vous serez parfois obligé de jongler avec l'orientation de l'écran pour afficher le bas du menu ou la partie droite du Panel.

Le menu de l'appli :

'cliquer' dans le coin gauche pour afficher le menu :

Dans le Menu, cliquer sur 'App Settings'

Renseigner l'adresse IP de l'ordinateur exécutant Xplane. Garder 51000 comme numéro de port :


Ajout/modification/suppression d'un instrument :

Passer en mode édition en cochant 'Edit Panel' dans le menu principal :

modification :

Double clic sur l'instrument permet d'afficher ses propriétés (Nous détaillerons plus tard certaines d'entre elles).

Ajout nouveau instrument :
cliquer sur add-itemet choisir l'instrument dans la liste puis OK.

Sauvegarde de la configuration :
Pour enregistrer les modifications, cliquer sur 'save profile' dans le menu principal. Vous pouvez également sauvegarder la config dans un nouveau fichier 'Save Profile as ...' et l'appeler par la suite en faisant 'load profile'.


Les propriétés des instruments :
Ces propriétés sont propres à chaque instrument. (hormis la rotation, la position dessus/dessous (Z-value) et la taille de la police (Relative font size).

Par exemple, prenons les propriété de l'instrument 'generic_little_gauge' :
Cet instrument est dit "générique" car il permet de récupérer n'importe quel indicateur xplane et de l'afficher sous forme de cadran circulaire.
Pour définir l'indicateur à afficher, il faut indiquer dans la propriété 'dataRef string' de l'instrument la dataref correspondant à l'indicateur. (dans l'exemple ici, la température en degré de la sortie des gaz d'échappement EGT).

Pour savoir quelle 'dataRef String' mettre, il faut aller sur la page web
http://www.xsquawkbox.net/xpsdk/docs/DataRefs.html
et chercher dans le fichier la ligne correspondante au capteur souhaité.
Je vous recommande de chercher dans le chapitre 'sim/cockpit2'



Une fois la dataref trouvée, renseigner la dans la propriété Dataref String' en mettant le chemin complet.
exemple : sim/cockpit2/engine/indicators/EGT_deg_C

Enfin, cocher la propriété 'datarefs values are in table' si les valeurs sont dans un tableau indicé et renseigner le numéro d'indice du tableau ( propriété 'selected index for value'). Souvent l'indice correspond au numéro du capteur. Exemple 0: réservoir principal, 1: réservoir aile gauche, etc...)

Pour savoir si les valeurs sont sous forme de tableau, il suffit de regarder dans le fichier dataRefs.html si le 'type' est suivi de crochés dans lesquels le nombre d'index du tableau est indiqué.


Donc revenons à nos propriétés de l'instrument générique.
  • 'Designation line 1/2' : texte affiché au milieu haut du cadran
  • 'Designation line 2/2' : texte affiché au milieu bas du cadran
  • 'DataRef String' : chemin et nom de l'indicateur xplane (cf dataRefs.html)
  • 'accuracy' : Précision de l'indicateur (en gros une valeur sera considérée à rafraîchir dans l'indicateur si la donnée a diminué ou augmenté d'une valeur supérieure à la précision indiquée).
  • 'Datarefs values are in table' : indique que la valeur est a prendre dans un tableau.
  • 'selected index for value' : si la valeur est dans un tableau, alors dans quel numéro de case est elle. La première case ayant l'indice zéro.
  • 'number of big graduations' : nombre de graduations principales avec indication des chiffres
  • 'number of thin graduations' : nombre de graduations intermédiaires
  • 'display values' : afficher les chiffres.
  • 'display into logarithlic values' : échelle logarithmique







arc vert
  • 'green arc value begins at' : l'arc vert commence à la valeur ...
  • 'green arc value ends at' : l'arc vert finit à la valeur ...
  • 'green arc thickness' : épaisseur du trait
arc jaune
  • idem
arc rouge
  • idem


Voici par exemple ce que donne trois configurations différentes d'instruments génériques afin d'afficher les valeurs moteurs de :
La température de sortie d'échappement, La pression de l'huile et la température de l'huile :


Cette configuration est disponible dans le fichier 'ExtPlane-Panel-Default.ini' donné en exemple.

Il ne me reste plus qu'à vous souhaiter une bonne installation, configuration, et surtout un bon vol avec votre tablette écran supplémentaire.
( OOPS, oui je sais, j'ai laissé mes freins en positions serrés ... )




3 commentaires:

  1. Bonjour, peux-ton faire de même avec une tablette windows ?

    RépondreSupprimer
  2. Bonjour
    superbe application toujours d'actualité après 4 ans
    Un grand merci pour votre développement
    Avez vous développé des mises à jour depuis ?

    RépondreSupprimer
    Réponses
    1. Bonjour, tout d'abord bravo pour votre travail et merci pour le partage.
      J'ai un problème de connection. Lorsque je lance l'appli j'ai le message rouge en haut à gauche qui affiche "connecting to xplane..." puis faut de pouvoir se connecter il affiche "connection timed out..."
      Je précise que le test du plugin fonctionne : telnet localhost 51000 => EXTPLANE 1
      D'avance merci pour votre aide
      Julien

      Supprimer