MWconn Anleitung

MWconn, Version 5.9, Bedienungsanleitung Seite 46 von 60
MWconn-Logo und stumme Installation
Für den Fall, dass Sie die Anzeige des MWconn-Logos beim Start nicht wünschen, übergeben Sie das Wort
NOSPLASH als Parameter beim Programmstart. Diese Einstellung kann leider nicht in die MWconn-
Konfiguration integriert werden, weil die Initialisierungsdatei MWconn.ini erst wenige Sekunden nach dem
Start des Programms ausgewertet wird.
Wenn Sie MWconn automatisch installieren lassen und keine Rückfrage für das Anlegen der
Wählverbindung "Internet" haben wollen, nutzen Sie dazu den Parameter SILENTINSTALL.
Die Tonausgabe lässt sich abschalten durch eine entsprechende Auswahl im Kontextmenü (rechte
Maustaste aufs Programmfenster) oder durch die Übergabe des Parameters MUTE beim Programmstart.
Lokale Programmsteuerung per Dateisystem
Sobald gestartet, können die an MWconn übergebenen Einstellungen nicht mehr abgeändert werden. Sie
müssen zuerst MWconn beenden und nach dem Verändern der Einstellungen neu starten.
Trotzdem haben Sie die Möglichkeit, in begrenztem Umfang in den regulären Programmlauf einzugreifen.
MWconn kennt verschiedene Sonderkommandos, die Sie jeweils in Form einer entsprechend benannten
leeren Datei an das Programm übergeben können: MWCONN_CONNECT, MWCONN_DISCONNECT,
MWCONN_RECONNECT und MWCONN_END.
Dadurch ist es möglich, die wichtigsten Funktionen von einem fremden Programm aus zu steuern:
Verbindungsaufbau, Verbindungsabbau und das Programmende von MWconn.
Die eher unelegante Form der Kommandoübergabe per Datei wurde gewählt, weil sie sich am einfachsten in
fremde Programme einbauen lässt. In praktisch jeder Programmiersprache gibt es die Möglichkeit, auf sehr
einfache Weise Dateien zu erstellen. Falls Sie eine Windows-Batch-Datei verwenden (*.bat), reicht
beispielsweise folgende Zeile:
echo x > C:\Ihr_MWconn-Ordner\MWCONN_CONNECT
Die als Kommando übergebene Datei wird von MWconn gelöscht, sobald sie als Kommando erkannt wurde.
Um nicht versehentlich wertvolle Daten zu verlieren, verweigert MWconn das Löschen von Dateien, die
größer sind als 30 Bytes. Erzeugen Sie für den Zweck der Programmsteuerung also am besten nur leere
oder fast leere Dateien.
Lokale Programmsteuerung per Shared Memory
Falls Sie selbst Software-Entwickler sind und MWconn von einem anderen Programm aus steuern möchten,
können Sie dafür auch einen direkteren Weg nutzen: die Parameterübergabe per Shared Memory. Über
diesen Weg lassen sich ebenfalls alle Ausgaben von MWconn lesen (Signalstärke, Datenvolumen usw.).
Dazu sind allerdings fundierte Programmierkenntnisse erforderlich. Im Folgenden finden Sie die dafür
notwendige Strukturbeschreibung und ein Stück Beispiel-Programmcode (Programmiersprache C).
typedef struct { // Struktur für Datenaustausch mit externen Programmen
unsigned long len; // Länge dieser Struktur in Bytes
unsigned short structure_version; // Version dieser Struktur: 3
unsigned short program_version; // Version des MWconn-Programms
// (Hauptversion*256+Nebenversion)
unsigned long res1[3]; // reserviert
// Datenrichtung extern->MWconn
char command[100]; // von MWconn auszuführendes Kommando;
// "MWCONN_CONNECT": verbinden;
// "MWCONN_DISCONNECT": trennen;
// "MWCONN_RECONNECT": neu verbinden;
// "MWCONN_END": Programm beenden;
// ":::ATI": AT-Kommando an Gerät senden (hier "ATI");
// bei Novatel-Geräten nur mit Novatel-DLL;
// ":250:4000:ATI": desgleichen, jedoch mit
// Wartezeitangaben, 250ms nach dem Senden
// beginnt der Empfang, welcher maximal 4 weitere
// Sekunden später abgeschlossen sein muss;
// "MWCONN_PATH": aktuellen Programmpfad zurückgeben;
// Datenrichtung MWconn->extern
// Hinweis: nicht alle Modems unterstützen alle Informationen;
unsigned long process_counter; // dieser Zähler wird von MWconn
// inkrementiert, sobald neue Daten zur Verfügung stehen;
unsigned long volume; // summiertes Datenvolumen in kBytes
unsigned long time; // summierte Onlinezeit in Minuten
unsigned long online_time; // aktuelle Onlinezeit in Sekunden; ==0: offline
© 16.12.2013 Markus B. Weber, Nürnberg