C.167. SMS()

C.167. `SMS()`

Sendet oder empfängt SMS-Nachrichten.

SMS(Warteschlange[,Optionen])

Regelt den Austausch von SMS-Nachrichten mit einem SMS-fähigen Telefon oder über ein SMS-Service-Center nach dem Protokoll ETSI ES 201 912 auf analogen oder ISDN-Leitungen. Das Shell-Programm smsq verwendet dazu FSK^[210] – dass ein Austausch über komprimierte Codecs wie GSM funktioniert, ist daher unwahrscheinlich.

Optionen:

a: Als antwortende Seite agieren.
s: Als Service-Center agieren, das mit einem Telefon kommuniziert.

Alle Sende-/Empfangswarteschlangen werden in /var/spool/asterisk/sms/ gespeichert: die Nachrichten vom Service-Center zum Telefon in sc-me.Schlange/, die Nachrichten vom Telefon zum SMSC in me-sc.Schlange/. In /var/log/asterisk/sms wird ein Log geschrieben.

Beim Verbinden als Client (a) werden alle im Verzeichnis me-sc.Schlange/ wartenden Nachrichten gesendet und dann gelöscht; die empfangenen werden in sc-me.Schlange/ mit einem Timestamp im Dateinamen gespeichert. Wenn wir uns als Service-Center verbinden (s), ist das genau umgekehrt.

Die Nachrichten-Dateien haben folgendes Format, wobei ausgelassene Parameter Default-Werte haben:

oa=Originating Address (Absendernummer)

Nationale Telefonnummer oder internationale mit vorangehendem + (z. B. +49).

da=Destination Address (Empfängernummer)

Nationale Telefonnummer oder internationale mit vorangehendem +.

scts=Service Centre Time Stamp (Zeitstempel vom SC)

Im Format YYYY-MM-DD HH:MM:SS

pid=Protocol Identifier (decimal octet value)

dcs=Data coding scheme (decimal octet value)

mr=Message reference (decimal octet value)

ud=Der Nachrichtentext

Wenn andere Zeichen als 10, 13, 32–126, 128–255 (dezimal) in der Nachricht vorkommen, wird ud= durch ud# ersetzt, und die Zeichen folgen hexadezimal kodiert.

srr=Status Report Request (0|1)

rp=Return Path (0|1)

vp=Validity Period (Gültigkeitsdauer in Minuten)

Beim Senden an ein SMSC müssen nur da und ud verwendet werden, oa wird ignoriert; beim Senden an ein Telefon sind nur oa und ud nötig, da wird ignoriert.

Eine Extension zum Empfangen von Nachrichten könnte so aussehen (wenn 01930100 die Nummer des für uns zuständigen SMSC – hier T-Com – ist):

[incoming]
exten => _X.,1,GotoIf($["${CALLERIDNUM}" = "01930100"]?sms-me-in,${EXTEN},1) 
; oder so:
;exten => _X./_0193010.,1,Goto(sms-me-in,${EXTEN},1)

[sms-me-in]
exten => _X.,1,Wait(1)
exten => _X.,n,SMS(me-eingang,a)
exten => _X.,n,System(handleincomingsms)
exten => _X.,n,Hangup()

Dabei könnte handleincomingsms z. B.

smsq
  --process=befehl --queue=me-eingang

sein, was für jede eingegangene Nachricht einen Befehl ausführt.

Ausgehende Nachrichten sollten als Dateien geschrieben werden, können aber auch mit folgendem (veralteten) Aufruf erzeugt werden (0193010 ist die Nummer des SMSC – hier T-Com):

[outgoing]
exten = 0193010,1,Goto(sms-me-out,${CALLERIDNUM},1)

[sms-me-out]
exten => _X.,1,Set(CDR(accountcode)=SMS)
exten => _X.,n,Set(smsFrom=${CALLERIDNUM})
exten => _X.,n,SMS(${smsFrom},s,${EXTEN},${smsText})  ; SMS erzeugen
exten => _X.,n,SMS(${smsFrom},s)                       ; senden
exten => _X.,n,Hangup()

Weitere Informationen und viele Beispiele auf http://www.voip-info.org/wiki/view/Asterisk+cmd+Sms und http://www.pi4tel.de/asterisk/sms.shtml. Man kann jedoch nicht erwarten, dass SMS() „out of the box“ sofort funktioniert.

Asterisk-Versionen:

————————| 1.2 |————————| 1.4 |————————| 1.6 |————————

Interner Hilfetext zu dieser Applikation in Asterisk 1.4:

  -= Info about application 'SMS' =-

[Synopsis]
Communicates with SMS service centres and SMS capable analogue phones

[Description]
  SMS(name|[a][s]):  SMS handles exchange of SMS data with a call to/from SMS capabale
phone or SMS PSTN service center. Can send and/or receive SMS messages.
Works to ETSI ES 201 912 compatible with BT SMS PSTN service in UK
Typical usage is to use to handle called from the SMS service centre CLI,
or to set up a call using 'outgoing' or manager interface to connect
service centre to SMS()
name is the name of the queue used in /var/spool/asterisk/sms
Arguments:
 a: answer, i.e. send initial FSK packet.
 s: act as service centre talking to a phone.
Messages are processed as per text file message queues.
smsq (a separate software) is a command to generate message
queues and send messages.

Differenz des internen Hilfetexts von Asterisk 1.2 zu 1.4:

— keine —

Differenz des internen Hilfetexts von Asterisk 1.4 zu 1.6:

--- in Asterisk 1.4
+++ in Asterisk 1.6
@@ -4,16 +4,26 @@
   Communicates with SMS service centres and SMS capable analogue phones

   [Description]
-    SMS(name|[a][s]):  SMS handles exchange of SMS data with a call to/from SMS capabale
+    SMS(name,[a][s][t][p(d)][r][o],addr,body):
+  SMS handles exchange of SMS data with a call to/from SMS capable
   phone or SMS PSTN service center. Can send and/or receive SMS messages.
-  Works to ETSI ES 201 912 compatible with BT SMS PSTN service in UK
-  Typical usage is to use to handle called from the SMS service centre CLI,
+  Works to ETSI ES 201 912; compatible with BT SMS PSTN service in UK
+  and Telecom Italia in Italy.
+  Typical usage is to use to handle calls from the SMS service centre CLI,
   or to set up a call using 'outgoing' or manager interface to connect
   service centre to SMS()
   name is the name of the queue used in /var/spool/asterisk/sms
   Arguments:
-   a: answer, i.e. send initial FSK packet.
-   s: act as service centre talking to a phone.
+   a  - answer, i.e. send initial FSK packet.
+   s  - act as service centre talking to a phone.
+   t  - use protocol 2 (default used is protocol 1).
+   p(N)  - set the initial delay to N ms (default is 300).
+           addr and body are a deprecated format to send messages out.
+   r  - set the Status Report Request (SRR) bit.
+   o  - the body should be coded as octets not 7-bit symbols.
   Messages are processed as per text file message queues.
   smsq (a separate software) is a command to generate message
   queues and send messages.
+  NOTE: the protocol has tight delay bounds. Please use short frames
+  and disable/keep short the jitter buffer on the ATA to make sure that
+  respones (ACK etc.) are received in time.

Frequency Shift Keying, FSK