GSMS-Adapter für ioBroker
SMS senden und empfangen mit GSM-Hardware.
Hardware
Jegliche GSM-Hardware (Shield, Surfstick usw.), die an einen seriellen Port Ihres ioBroker-Geräts angeschlossen ist. GSM-Module/Sticks benötigen viel Strom. Bitte stellen Sie eine ausreichende Stromversorgung sicher.
Bei einigen Geräten muss der richtige Modus für die serielle Kommunikation eingestellt werden (siehe 'usb_modeswitch').
Einstellungen
Port- und Verbindungseinstellungen
Pfad zur seriellen Schnittstelle - erforderlich.
z.B/dev/ttyUSB0 oder/dev/serial/by-id/xxxxxxxxxxx (by-id ist stabiler, ttyUSBx kann sich bei einem Neustart ändern)
Manche Geräte verfügen über mehrere USB-Anschlüsse, daher müssen Sie diese möglicherweise ausprobieren. Der erste Anschluss funktioniert höchstwahrscheinlich, zeigt aber unter Umständen keine Benachrichtigungen über eingehende Nachrichten an. Versuchen Sie es dann mit einem anderen Anschluss und senden Sie eine SMS. Prüfen Sie, ob diese einige Sekunden später ankommt (bei Huawei ist dies beispielsweise der dritte Anschluss).
Ihre SIM-PIN
Wenn Ihre SIM-Karte durch eine PIN geschützt ist, geben Sie die PIN an. Diese wird während der Initialisierung zum Entsperren der SIM-Karte verwendet (leer bedeutet: „Es ist keine PIN auf der SIM-Karte vorhanden“).
GSM-Einstellungen
Um Speicherplatz auf der SIM-Karte zu sparen, werden alle SMS nach Zustellung/Lesen von der SIM-Karte gelöscht. Nutzen Sie beispielsweise den „Verlauf“-Adapter oder eine andere geeignete Lösung, um Ihre Nachrichten zu speichern.
| Name | Typ | Standard | Beschreibung |
|---|---|---|---|
| Anzeige für eingehende SMS | boolescher Wert | WAHR | Ermöglicht es dem Modem, über den Empfang einer neuen SMS zu informieren. |
| Verkettung aktivieren | boolescher Wert | WAHR | Zusammengefasste Nachrichten werden als eine einzige Nachricht empfangen. |
| Benutzerdefinierter Iinit-Befehl | Zeichenkette | Falls Ihr Gerät einen benutzerdefinierten Initialisierungsbefehl benötigt, kann dieser angegeben werden und wird nach der PIN-Prüfung verwendet. Beispielsweise benötigen manche Geräte „AT+CPMS="SM","SM","SM"“, um den richtigen Speichersatz zu erhalten. Der Befehl sollte einen bestimmten Wert zurückgeben.'OK' (Leer bedeutet „kein benutzerdefinierter Befehl für init“). Bitte beachten Sie die Spezifikationen Ihres GSM-Geräts. | |
| CNMI bei geöffnetem/geschlossenem Modem | Zeichenkette | '2,1,0,2,0' / '2,0,2,2,1' | Legt fest, ob Nachrichten auf der SIM-Karte gespeichert oder sofort zugestellt werden. Bitte beachten Sie die Spezifikationen Ihres GSM-Geräts. |
SerialPort-Einstellungen
Bitte konsultieren Sie die Spezifikationen Ihres GMS-Geräts (Google hilft in den meisten Fällen weiter).
| Name | Typ | Standard | Beschreibung |
|---|---|---|---|
| Baudrate | Nummer | 19200 | Die Baudrate des Ports. |
| Datenbits | Nummer | 8 | Muss eine der folgenden Zahlen sein: 8, 7, 6 oder 5. |
| Stoppbits | Nummer | 1 | Muss eine der folgenden sein: 1 oder 2. |
| Parität | Zeichenkette | "keiner" | Muss eines der folgenden sein: 'none', 'even', 'mark', 'odd', 'space'. |
| rtscts | boolescher Wert | FALSCH | Durchflussregelungseinstellung |
| xon | boolescher Wert | FALSCH | Durchflussregelungseinstellung |
| xoff | boolescher Wert | FALSCH | Durchflussregelungseinstellung |
| xany | boolescher Wert | FALSCH | Durchflusssteuerungseinstellungen |
Weitere Einstellungen und Empfehlungen
Als Adapterobjekte anzugeben (admin.x )
- Ihr Name (Standardwert ist
ownNumberDie maximale Länge beträgt 16 Zeichen. - Ihre Telefonnummer.
- SMS-Betriebsmodus (
PDUoderSMS,PDU(ist die Standardeinstellung und empfohlen).
Alle Eingaben müssen mit ack=false erfolgen!
Posteingang/Postausgang – Verlauf
Durch Aktivieren des Verlaufsadapters für deninbox.messageRaw - Objekt und dassendSMS.messageRaw - Sie erhalten einen vollständigen Überblick über den Posteingang und Postausgang Ihres SMS-Verkehrs.
Funktionalitäten
SMS empfangen
Eingehende SMS werden geschrieben aninbox.* - Objekte.inbox.messageRaw kann als Auslöser für weitere Operationen verwendet werden (z. B. Weiterleitung eingehender SMS über den E-Mail-Adapter).
SMS senden
Um eine SMS zu senden, füllen Sie bitte das Formular aus.sendSMS.recipient, sendSMS.message und optionalsendSMS.alert und schiebensendSMS.send - Schaltfläche. Oder stellen Sie diesendSMS.messageRaw - Objekt mit einer Zeichenkette in folgender Form und ack=false:{"recipient": "Number", "message":"Yourtext", "alert":"false"} Die
Dieser Adapter bietet außerdem einen Kommunikationsblock für Blockly und SendTo-Funktionalitäten für andere Skripte (sendTo(" gsmsms.InstanceNo ", "send", {text: ' yourText ',recipient: ' phonenumber ', alert: ' false/true '});).
AT+-Befehle ausführen
Bitte achten Sie darauf, was Sie beim Einstellen von AT+-Befehlen tun, da es sich um Ihre SIM-Karte bzw. Ihr Gerät handelt.
AT+-Befehle werden durch Einstellen gesendetadmin.atCommandSLR im FormatAT+XXXXy Sie können einen beliebigen Befehl senden, aber beachten Sie, dass Sie nur die letzte Zeile der Antwort sehen werden.
Serialport-gsm
Dieser Adapter basiert auf dem SerialPort-GSM-Plugin zur Kommunikation mit GSM-Modems, vorwiegend für SMS.
Credits
Dieser Adapter wäre ohne die großartige Arbeit von @forelleblau ( https://github.com/forelleblau ), der frühere Versionen dieses Adapters entwickelt hat, nicht möglich gewesen.
Changelog
WORK IN PROGRESS
- (copilot) Adapter requires node.js >= 22 now
1.1.0 (2026-03-08)
- (copilot) Adapter requires admin >= 7.7.22 now
- (copilot) Adapter requires js-controller >= 6.0.11 now
- (mcm1957) Dependencies have been update
1.0.0 (2024-11-23)
- (mcm1957) Adapter requires node.js 20 now.
- (mcm1957) Adapter requires js-controller 5.0.19 and admin 6.17.14 now.
- (mcm1957) Adapter has been moved to iobroker-community-adapters organization
- (mcm1957) Some issues reported by adapter checker have been fixed.
- (mcm1957) Dependencies have been update
0.0.6
- (forelleblau) jsonConfig.json, notifications-manager
0.0.5
- (forelleblau) bug fixed (adapter set "undefined" into state values)
0.0.4
- (Apollon77) Optimizations, brush up to comply with ioBroker.repositories requirements
License
MIT License
Copyright (c) 2023-2026 iobroker-community-adapters iobroker-community-adapters@gmx.de
Copyright (c) 2022-2023 forelleblau mailto:marceladam@gmx.ch
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.