Fragen und Lösungen zur neuen StwSim Schnittstelle

[Yojo]

Hallo zusammen,

ich hab vor kurzem mit der PlugIn Entwicklung gestartet. Ich habe dabei einige neue Features gefunden, die bislang nur in der Java Libary aus dem Handbuch dokumentiert sind. Ich habe mich jetzt etwas damit auseinander gestezt und meine Erkentnisse im Handbuch hinzugefügt. Ich würde mich auch freuen, wenn das jemand gegenließt (beginnend mit <stitz>): https://doku.stellwerksim.de/doku.php?i ... zifikation.
Allerdings sind noch ein paar fragen offen, die ich nicht beantworten konnte:
- Was ist die Hitze von einem Stellwerk? Man kann die hitze von einem Stellwerk abfragen, aber man bekommt nur eine Zahl zurück und ich weiß nicht wie ich die Interpretieren soll.
- Was macht der debug modus? Man kann einen Debug Modus aktivieren, aber ich habe keine veränderung festgestellt wenn er aktiv war.
- Beim Stitz Befehl kommt der Regional und ein Allgemein Raum zurück. Ich kenn mich mit Stitz nicht wirklich aus, aber von einem allgemeinen Raum hab ich noch nichts gehört, also was ist das?


Diese neuen Features der Schnitstelle, habe ich bislang nur in der API aus dem Handbuch gefunden. Allerdings stürtz die beim verwenden von fsset ab. Zudem gibt es bekannliche andere Probleme, die bereits von anderen verbessert wurden, diese haben aber die neuen Features nicht implementiert. Daher habe ich meine eigene API geschrieben die die neuen Features implementiert und relativ robust läuft. Ihr könnt sie euch hier anschauen und holen: https://github.com/Yojo83/AnotherStwSimAPI. Es handelt sich dabei um eine .jar lib, die wie die aus dem Handbuch benutzt werden kann.

Zu schluss noch ein Problem mit der neuen Schnitstelle: Der fsset befehlt ist etwas komisch. Zum einen steht im Handbuch immnoch, dass ein solcher Befehl nie kommen soll (weshalb ich es auch gut finde, dass man keine Rangiersignale damit setzten kann), aber er existiert und funktioniert. Zum anderen sind die responses komisch: In der Doku von der Handbuch API steht, dass es eine Response gibt, die sich aber verzögern kann, wegen dem Fahrstraßenspeicher. Wenn die FS nicht gestzt werden kann funktioniert das zwar auch alles, und es gibt eine passende Fehlermeldung, aber wenn die FS sofort gestzt wird, kommen zwei SUCCESS Messages (bevor und nachdem die weichen gestellt wurden; evt. auch gleichzeitig), aber wenn die FS im Fahrstraßenspeicher landet wird gar keine Response resendet, auch wenn die FS dann gesetzt wird. Hat das noch jemand bemerckt? Ist das absicht?

Soo viele verschiedene Themen in einem Post, aber das lag mir grad auf dem Herzen.
Yojo

[DevonFrosch]

Moin,

nun, es gibt durchaus Funktionen, die absichtlich nicht dokumentiert sind, weil sie nie so richtig funktioniert haben oder prinzipbedingt nie so richtig funktionieren. <setfs> ist genau so eine Funktion.

Das mit der Hitze ist so ein Ding (wenn du im Forum mal nach Hitze suchst, wirst du ein paar Treffer zu einer Android-App finden - das ist genau das) - die funktioniert grundsätzlich, wie sie soll, hat aber eine echt begrenzte Aussagekraft und hat es daher nie über die (inzwischen eingestellte) App hinaus zu einem Anwendungszweck gefunden.

<stitz> sollte stabil genug sein, es zu dokumentieren - es gibt dir die Telefonnummer des Regionsraums und die Nummer des Spieler-Quasselraums (siehe https://www.stellwerksim.de/stitz-rooms.php - die Seite läd aktuell leider relativ lange). Da habe ich ein wenig die Formulierung angepasst, aber ansonsten ist das in Ordnung.

Gruß,
DevonFrosch

[Yojo]

Hi DevonFrosch,

vielen Dank für die Antworten.
Ich lass die Funktionen in der API zwar drinnen, aber ich hab sie entsprechend markiert.

Grüße
Yojo