Création de votre propre fichier de définition d'un décodeur

[XTof_vl]

There-s absolutely no problem to post here in English.

I think it's a great idea to have a better management of languages in DecoderPro and all other JMRI project. I'm also interested to create a Dutch version of DecoderPro and of the decoder definition files.

I think it will be a good idea to work with a sort of generic labels dictionary used in the different applications, combined with your simplification regarding the XML definition file.

Best regards,

[XTof_vl]

L'élément Functionlabel
Est très simple: Il contient une succession d'éléments "Functionlabel" (sans "s") et n'a pas d'attribut.
C'est la liste des noms des fonctions du décodeur.

Elément FunctionLabel

Code: Tout sélectionner

      <functionlabels>
         <functionlabel num="0" lockable="true">Light</functionlabel>
         <functionlabel num="1" lockable="true">Bell</functionlabel>
         <functionlabel num="2" lockable="false">Horn</functionlabel>
         <functionlabel num="3" lockable="false">Coupler</functionlabel>
         <functionlabel num="4" lockable="true">Blower</functionlabel>
         <functionlabel num="5" lockable="false">Rev Up</functionlabel>
         <functionlabel num="6" lockable="false">Rev Dn</functionlabel>
         <functionlabel num="7" lockable="true">Mars</functionlabel>
         <functionlabel num="8" lockable="true">Mute</functionlabel>
         <functionlabel num="9" lockable="true">Squeal</functionlabel>
         <functionlabel num="10" lockable="false">CPC</functionlabel>
         <functionlabel num="11" lockable="true">Shunt</functionlabel>
         <functionlabel num="12" lockable="false">Set Brk</functionlabel>
         <functionlabel num="13" lockable="false">Rel Brk</functionlabel>
         <functionlabel num="14" lockable="false">Slack</functionlabel>
         <functionlabel num="15" lockable="false">Smash</functionlabel>
      </functionlabels>


Pour chaque fonction, "functionlabel" contient le nom, a un numéro et précise si la fonction est verrouiable ou non.
- Le contenu est le nom de la fonction
- Le premier attribut est le numéro de la fonction
- le second attribut précise si la fonction est verrouillable ou non (est-elle activée à chaque transition (OFF-ON et ON - OFF) ou uniquement pour les transitions OFF-ON.

Ces éléments clôturent le tag Family:

Code: Tout sélectionner

   </family>


Elément Programmaing

Code: Tout sélectionner

   <programming direct="yes" paged="yes" register="yes" ops="yes">
   </programming>


Cet élément décrit les capacité de programmation du décodeur. Il est vide, mais à comme attribut els différentes possibilités de programmation qui peuvent prendre la valeurs "Yes" ou "no", plus un attribut commentaire éventuel:
- direct: Programmation directe, avec éventuellement la possibilité de travailler en "bit" ou en "byte" seulement.
- paged: Mode paginé
- register: Mode registre
- ops: Ecriture en opération
- transpRead: Mode en opération système Digitrax
- bidirRead: Mode en opération système NMRA bidirectionnel
- opsaccbasic: Mode basique du support des accessoires
- opsaccextended: Mode étendu du support des accessoires
- opsacclegacy: Ancien mode de programmation des accessoires
- sv: Support du protocole SV
- comment: commentaire éventuel

[XTof_vl]

Etape suivante, le tag Variables
Celui-ci reprend la liste de toutes les variables du décodeur et comment ces variables sont effectivement codées dans le décodeur. Il est composé des éléments vriable (sans "s"), constant et ivariable. La différence entre variable et ivariable est la façon de lire les CVs (indexé ou non).
L'élément "Variables" n'a pas d'attribut.

Le contenu de l'élément variables représente 90% du travail de définition d'un décodeur. C'est en effte dans ce tag que nous trouverons toute la description des CVs.

Code: Tout sélectionner

   <variables>
                ...
   </variables>


[XTof_vl]

Pour ceux que cela intéresse, j'ai placé dans mon album SPROG tous les écrans de DecoderPro.

https://www.forum-train.com/gal/thumbnails.php?album=132&page=1

Je vais les utiliser au fur et à mesure des explications de configuration du décodeur Loksound 3.5.

[XTof_vl]

Description général de l'élément "Variable"
L'élément variable peut contenir les éléments suivants:
- enumVal: Nombre limité de choix correspondant à une valeur
- decVal: variable de type décimale, avec éventuel masque de saisie et limites
- hexVal: variable hexadécimale, avec éventuel masque et saisie de limites
- speedTabVal: Tableau des vitesses suivant la norme NMRA
- longAddressVal: adresse NMRA longue
- shortAddressVal: adresse NMA courte
- splitVal: Valeur décimale sur deux CVs
- compositeVal: variable composée.

L'élément "variable" a les attributs suivants:
- label: nom utilisé par le fabricant pour identifier la variable
- CV: numéro du CV contenant la valeur de la variable
- mask: masque des bits du CV contenant la valeur (jusqu'à 16) - "X" non utilisé, "V" utilisé
- readOnly: la variable est accessible en lecture seulement
- infoOnly: La variable n'existe pas réellement dans le décodeur, elle n'est utilisée qu'à des fins d'information
- opsOnly: La variable n'est accessible qu'en opération, pas sur la voie de programmation
- writeOnly: la variable n'est accessible qu'en écriture, pas en lecture (exemple: reset)
- default: valeur par défaut après un reset du décodeur
- comment: commentaire éventuel
- nom de la variable si différent du label
- minFn: Valeur minimum de la fonction pour être valide
- minOut: Valeur minimum de la sortie pour être valide
- inOptions: la variable est présent si une des options est rencontrée
- tooltip: Aide contextuelle lors de l'édtion de la variable
- include: liste des noms des "models" qui possèdent cette variable, vide pour tous
- exclude: liste des noms des "models" qui ne possèdent pas cette variable, vide pour aucun

[POMidi]

Je suis attentivement et j'espère pouvoir appliquer pour le masque des nouveaux décodeurs Zimo.

Pierre

[Rodolphe]

Ce serait super également pour les décodeurs de Mistral, d'ailleurs j'ai déjà une demande en ce sens.

Rodolphe

[XTof_vl]

Il faut toujours le mode d'emploi du décodeur pour y arriver... Evidemment!

[Rodolphe]

Il faut toujours le mode d'emploi du décodeur pour y arriver... Evidemment!

Tiens oui c'est vrai, justement je l'ai sous la main
Enfin le peu d'informations fournies...
J'ai demandé un complément à Mistral, aucune réponse à ce jour.

Rodolphe

[XTof_vl]

C'est suffisant et ce n'est pas sorcier. C'est juste dommage que le paramétrage de ce décodeur est limité.