BOSWatch/BW3-Core
1
0
Fork 0
mirror of https://github.com/BOSWatch/BW3-Core.git synced 2025-12-06 07:12:04 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity
BW3-Core/plugins
History
Bastian Schroll 48ecdd666c add msg mode to plugin
2018-02-22 08:28:02 +01:00
..
template add msg mode to plugin 2018-02-22 08:28:02 +01:00
readme.md little edits 2018-01-15 21:45:58 +01:00

readme.md

Eigene Plugins schreiben

Um ein eigenes Plugin zu schreiben, sollte man sich am besten zuerst einmal das Plugin template ansehen. Dies kann als Vorlage für das eigene Plugin genutzt werden.

1.) Informationen anpassen

  • Dateikopf anpassen
  • Namen des Plugins vergeben in der init Methode super().__init__("template")

2.) Benötigte Methode überschreiben

Die Plugin Basisklasse bietet einige Methoden, welche vom Plugin überschrieben werden können.

  • onLoad() wird direkt beim Import des Plugins ausgeführt
  • setup() wird vor jeder Ausführung gerufen
  • fms(bwPacket) wird bei einem FMS Paket ausgeführt
  • pocsag(bwPacket) wird bei einem POCSAG Paket ausgeführt
  • zvei(bwPacket) wird bei einem ZVEI Packet ausgeführt
  • teardown() wird nach jeder Ausführung gerufen
  • onUnload() wird beim Zerstören der Plugin Instanz zum Programmende ausgeführt

3.) Zugriff auf Config Datei

Wenn sich im Ordner des Plugins eine ini-Datei befindet, welche exakt so wie das Plugin heißt, kann deren Inhalt über die lokale Config-Reader Instanz

  • self.config.getBool(SECTION, KEY)
  • self.config.getInt(SECTION, KEY)
  • self.config.getStr(SECTION, KEY)

abgerufen werden.

4.) Daten aus dem BOSWatch Paket lesen

An die Alarm Funktionen FMS, POCSAG und ZVEI wird eine Instanz eines BOSWatch-Packet Objekts übergeben.

Aus dieser kann mittels bwPacket.get(FELDNAME) das entsprechende Feld ausgelesen werden. Eine Auflistung der bereitgestellten Informationen findet sich im entsprechenden BOSWatch-Packet Dokument.