This is an old revision of the document!
Table of Contents
Protocole Client Rocrail (RCP)
Entête der communication
Toutes les requêtes et les réponses sont préfixées avec une entête XML qui annonce les contenus.
Exemple
ENTÊTE DU DÉBUT
<xmlh> <xml size="23" name="cmd"/> <bin size="4711" name="readme.pdf"/> </xmlh>
FIN ENTÊTE DÉBUT XML
<cmd auto="off"/>
FIN XML DEBUT BIN
A6007B98FF...
FIN BIN
Note
Après la balise de fin de l'entête, </xmlh>, aucun caractère supplémentaire n'est autorisé. (Même un '\0' n'est pas autorisé.)
Définition du protocole
Attributs de l'entête XML
| Nom | Description |
|---|---|
| size | longueur en octet du xml ou du flux binaire |
| name | nom du document xml ou nom du fichier binaire |
Requêtes client
Les clients peuvent envoyer presque tout ce qui se trouve dans la définition du protocole, et la liste suivante n'est pas complète.
Commandes du modèle: https://wiki.rocrail.net/rocrail-snapshot/rocrail/wrapper-en.html#model
Obtenir le plan complet
<model cmd="plan"/>
Get a list
The locomotives:
<model cmd="lclist"/>
The switches:
<model cmd="swlist"/>
Get an object
Locomotive:
<model cmd="lcprops" val="locoID"/>
Complete loco example
<xmlh><xml size="84" name="lc"/></xmlh><lc id="4711" V_raw="87" V_rawMax="100" cmd="velocity" throttleid="192.168.100.32"/>
Server responses
For every client request there is a server response.
Plan response
<plan>...</plan>
Server events
Many events are broadcasted to all clients including modifications by other clients.
Just a few example events.
Power event
Track power became high:
<state power="true"/>
Auto event
Automode is switched on:
<auto cmd="on"/>