Konfiguration über SMS-Befehle

Aktion

Befehl

Beschreibung

IPG Status abfragen

STATUS?

Der Befehl „STATUS?“ liefert eine Übersicht der folgenden
Parameter:

• Firmwareversion des IPGs

• Objektkennung

• Signalqualität des 4G Netzes

• Zustand der Voice over LTE Anbindung

• verwendeter APN

• IP-Adresse

Beispielantwort:
IPG 141 v1.04.0XX TG
object ID:
signal quality: -63 dBm OOOO-
VoLTE: active
swt07.m2m.at
172.27.165.15

IPG Version abfragen

VERSION?

Dieser Befehl erzeugt eine SMS mit dem Namen des Produkts,
der Firmwareversion des Mikrocontrollers (MCU), der Version des Bootloaders, der ID der MCU, der Hardwarerevision und der Firmwareversion des LTE-Moduls.

Beispielantwort:
IPG 141 A
MCU: 1.04.0XX TG
MCU Boot: 0.05.009
MCU ID: AMZZGM4DIOKRB4AEUABP
HWrev: 01.0
LTE: EC21EFAR06A03M4G_01.003.01.003

Mobilfunknetz Informationen abfragen

PIN=«Eingabe PIN»
NWINFO?

Mit diesem Befehl wird eine SMS erzeugt, die Informationen zur SIM-Karte und zum Mobilfunknetz enthält. Zurückgegeben werden:

• CCID (Chipkarten-Identifikationsnummer)

• IMEI (Geräte-Identnummer)

• Cell-ID (Kennung der Funkzelle)

• MCC (Mobile Country Code – Ländercode)

• MNC (Mobile Network Code – Netzbetreiber-Code)

• TAC (Tracking/Location Area Code – Bereichscodes im Mobilfunknetz)

Beispielantwort:
CCID: 89490200001716288652
IMEI: 867962046405505
cellID: 1EC4103
MCC/MNC/TAC: 262/01/63A0

IP-Adresse abfragen

PIN=«Eingabe PIN»
IP?

Mit diesem Befehl kann die aktuelle IP Adresse und der verwendete DNS, mit der die SIM Karte online ist, abgerufen
werden.

Beispielantwort:
LTE IP: 172.25.86.89
LTE prim. DNS: 10.128.10.10

Akku-Informationen abfragen

BATTERY?

Dieser Befehl erzeugt eine SMS mit Statusinformationen des Blei-Gel-Akkus.
Zurückgegeben werden der Batteriestatus, der Ladestatus und die Batterie-/ Ladespannung.

Beispielantwort:
battery state: BAT_READY
charging state: CS_CHARGED
battery voltage: 13.6 V

SMS-Zielnummer abfragen

PIN=«Eingabe PIN»
SMS?

Abfrage der Zielrufnummer an welche Alarmnachrichten per SMS gesendet werden.

Beispielantwort:
Zielrufnummer Alarm SMS:
+4915169318384

SMS-Ereignisse abfragen

MSG?

Als Antwort wird eine Liste gesendet, welche Ereignisse eine
Alarm SMS auslösen und welche nicht.

Beispielantwort:
Objekt:
alert battery: DEAKTIVIERT
alert power: DEAKTIVIERT
alert NRT: DEAKTIVIERT
alert OUT1: DEAKTIVIERT

Netzwerkmodus abfragen

PIN=«Eingabe PIN»
ACT?

Mit diesem Befehl lässt sich die aktuell verwendete Netzwerkmodus abfragen.

Beispielantworten:
ACT: LTE
configured ACT: 4G
Netzwerkmodus 4G ist aktiviert (Werkseinstellung).

ACT: GSM
configured ACT: 2G
Netzwerkmodus 2G (GSM) ist aktiviert. Daten und Sprache
werden über 2G übertragen.

ACT: AUTO
configured ACT: automatisch
Die Auswahl des Netzwerkmodus ist auf automatische Auswahl konfiguriert. Aktuell wird 4G (LTE) verwendet. Sprachanrufe könnten auch über 2G aufgebaut werden (z.B. wenn die verwendete SIM kein VoLTE unterstützt).

APN-Konfiguration abfragen

PIN=«Eingabe PIN»
APN?

Abfrage der aktuellen APN-Konfiguration.

Beispielantwort:
APN verwendet:
APN standard: siwaltec.ic.m2mportal.de
APN alternativ: internet.m2mportal.de

Status der Eingänge abfragen

PIN=«Eingabe PIN» IO?

Fragt den Zustand der Ein- und Ausgänge des IPGs ab. Der Wert 0 steht für nicht aktiv/geöffnet und der Wert 1 für aktiv/ geschlossen.

Beispielantwort:
ALARM/ OUT1: inaktiv
OUT2: 0
IN1: 0
IN2: 1

Im obigen Beispiel ist der Alarm-Ausgang (Alarm/ out1) und Ausgang 2 (Out2) nicht geschaltet. Eingang 1 (IN1) ist geöffnet und Eingang 2 (IN2) geschlossen.

Aktion

Befehl

Beschreibung

Werkseinstellung herstellen

PIN=«Eingabe PIN»
FORM4TIEREN!

Sämtliche Konfigurationsparameter werden auf ihre Standardwerte zurückgesetzt. Anschließend wird das System neu gestartet.
Sie erhalten keine Antwort auf diesen Befehl.

Neustart IPG

PIN=«Eingabe PIN»
NEUSTART!

Startet das System neu.
Sie erhalten keine Antwort auf diesen Befehl.

Zugriff Webinterface über Mobilfunk aktivieren

PIN=«Eingabe PIN»
HTTPoLTE!«Eingabe Zeit in Sek.»

Der Zugriff auf das Webinterface über die LTE-Verbindung ist standardmäßig gesperrt. Über diesen SMS-Befehl kann dieser Zugriff temporär freigeschaltet werden:

• Wird der Befehl ohne zusätzliche Zeitangabe gesendet, wird die Freischaltung für die im Webinterface festgelegte Standarddauer aktiviert.

• Durch Anhängen einer Zeit in Sekunden lässt sich die Freischaltdauer individuell bestimmen (z. B. 3600 steht für eine Stunde).

• Mit dem Parameter 0 wird das Webinterface über LTE sofort wieder gesperrt.

Einleiten Firmwareupdate

PIN=«Eingabe PIN»
Update!

Führt ein Firmwareupdate des IPG durch. Es wird die aktuellste Version geladen und installiert. Nach Abschluss des Updates wird das Gerät automatisch neu gestartet.

Schalten von
OUT 2

PIN=«Eingabe PIN» IO!

Setzt den Ausgang OUT2.
Der Wert darf die Zustände «0» und «1» haben. Der Alarm-Ausgang (OUT1) kann über diesen Befehl nicht gesteuert werden.
OUT2 kann über diesen Befehl nur gesteuert werden, wenn die Konfiguration des Ausgangs auf «unabhängig» eingestellt wurde.
Kann der Befehl nicht ausgeführt werden, wird mit einer SMS geantwortet.

Beispiel SMS:
PIN=00000000
IO!out2=1

Im Beispiel wird der Ausgang OUT2 dauerhaft geschaltet.

Einstellungen

Befehl

Beschreibung

PIN für SMS ändern

PIN=PIN alt,PIN neu

Der PIN-Befehl ändert die werksseitig vor eingestellten Standard-PIN (00000000).

Beispiel:
Der PIN soll auf den Wert „1234“ geändert werden.
SMS:
PIN=00000000,1234

Zierufnummer für SMS-Nachrichten

PIN=«Eingabe PIN»
SMS=«Eingabe Rufnummer»

Eingabe der Zielrufnummer an welche Alarmnachrichten per SMS gesendet werden. Die Rufnummer muss im Internationalen Format angegeben werden.
Kann die Rufnummer nicht übernommen werden, wird mit einer entsprechenden SMS geantwortet.

Beispiel SMS:
Es sollen Alarmnachrichten an die Rufnummer
015112345678 geschickt werden.

PIN=000000000
SMS=+4915112345678

Objektkennung und SMS-Meldungen
aktivieren

PIN=«Eingabe PIN»
MSG=«Kennung,Batterie,Netz, NRT,Alarm,Gateway,PPP»

Eingabe der Objektkennung und welche Ereignisse eine Alarm SMS auslösen.

Bei diesem Befehl müssen immer alle Parameter angegeben werden.

• Eingabe Objektkennung
  Muss eine Zeichenkette von 0 bis 16 Zeichen sein. Es dürfen keine Sonderzeichen, Umlaute oder Satzzeichen enthalten sein. Dient zur Identifizierung des Objekts.

• Parameter (jeweils „1“=SMS senden, „0“=keine SMS):

  • Batterie – SMS bei Batteriestörung

  • Netz – SMS bei Stromausfall oder Netzrückkehr

  • NRT – SMS bei ungewöhnlich langer Belegung der a/b-Schnittstelle

  • Alarm – SMS bei Schalten von OUT1

  • Gateway – SMS bei neuem PDP-Kontext (nur für Support, i.d.R. deaktiviert)

  • PPP – SMS bei Neuaufbau der PPP-Verbindung (nur für Support, i.d.R. deaktiviert)

Falls eine SMS nicht korrekt verarbeitet wird, sendet das IPG eine Fehlermeldung zurück.

Beispiel SMS:
Es soll eine Benachrichtigung mit der Kennung „Testaufzug0815” erfolgen. Es soll nur eine SMS versendet werden bei Problemen mit der Batterie und bei Stromausfall.

PIN=00000000
MSG=Testaufzug0815,1,1,0,0,0

Netzwerkmodus einstellen

PIN=«Eingabe PIN»
ACT!«Netzwerkmodus»

Konfiguration des Netzwerkmodus.
Befehl:
ACT=«Netzwerkmodus», wobei «Netzwerkmodus» durch 4G,
2G, oder auto ersetzt wird.
Falls die SMS nicht richtig verarbeitet wurde oder die angegebenen Einstellungen nicht angewendet wurden, sendet das IPG eine Fehlermeldung zurück.

Beispiel SMS:

PIN=00000000
ACT!4G
Setzt den Netzwerkmodus auf 4G (LTE). Daten und Sprache
werden über 4G übertragen.

PIN=00000000
ACT!2G
Setzt den Netzwerkmodus auf 2G (GSM).
Daten und Sprache werden über 2G übertragen.

PIN=00000000
ACT!auto
Die Auswahl des Netzwerkmodus erfolgt automatisch.

APN setzen

PIN=«Eingabe PIN»
APN!«APN Name»

Setzt einen neuen Standard-APN.

Beispiel SMS:

PIN=00000000
APN!internet.telekom