Provided by: scmxx_0.9.0-2.3_amd64 
NAME
scmxx - Datenaustausch mit einem Siemens-Handy
SYNOPSIS
scmxx [--device Gerätedatei] [--baud Baudrate] [--quiet] [--verbose] [--reset] {--info |
--set-time | --mem-info | --lock-info | --lock lock {--enable | --disable} | --set-smsc
--number {Nummer | Name} }
scmxx [--device Gerätedatei] [--baud Baudrate] [--quiet] [--verbose] [--reset] [--out
Datei] [--pipe Pipe] {--remove | --send | --get} [--binary] [--mem Speicher] [--slot
Speicherplatz] [Datei...]
scmxx [--device Gerätedatei] [--baud Baudrate] [--quiet] [--verbose] [--reset] [--out
Datei] [--pipe Pipe] [--pin PIN] {--remove | --send | --get} [--pbook] [--mem Speicher]
[--slot Speicherplatz] [--text Text] [ --number {Nummer | Name} ] [Datei...]
scmxx [--device Gerätedatei] [--baud Baudrate] [--quiet] [--verbose] [--reset] [--out
Datei] [--pipe Pipe] {--remove | --send | --get} [--sms] [--mem Speicher] [--slot
Speicherplatz] [--text Text] [ --number {Nummer | Name} ] [--direct] [--flash] [--srr]
[--unicode] [Datei...]
scmxx [--help] [--version]
BESCHREIBUNG
SCMxx kann bestimmte Dateien zu und von einem Siemens-Handy übertragen und dort
gespeicherte löschen. Die Daten werden aus einer Datei oder von der Standardeingabe
gelesen, geschrieben wird in eine Datei oder auf die Standardausgabe. Kurznachrichten
(SMS) können direkt gesendet und empfangen werden, also ohne daß sie auf dem Handy
gespeichert werden. SCMxx wurde mit mehreren Handys von Siemens getestet (nur S25 und
später).
OPTIONEN
--device (-d)
definiert eine Gerätedatei. Diese wird statt der in der Umgebungsvariable SCMXX_TTY
und dem einkompilierten Wert verwendet. Für Linux-Systeme kann dies /dev/ttyS0 für
eine serielle Verbindung, /dev/ircomm0 für eine Infrarot-Verbingung und
/dev/rfcomm0 for eine Bluetooth-Verbingung sein. Wenn native
Bluetooth-Unterstützung einkompiliert wurde, können zusätzlich die Formen
bt://[xx:xx:xx:xx:xx:xx]:n oder bluetooth://[xx:xx:xx:xx:xx:xx]:n benutzt werden,
um eine Bluetooth-Adresse xx:xx:xx:xx:xx:xx und einen Kanal n (Vorgabewert ist 1)
anzugeben. Die Angabe des Kanals is optional, in diesem Fall muss aber auch der
Doppelpunkt weggelassen werden.
--baud (-b)
definiert ein Baudrate, mit der zum Gerät verbunden wird. Die gültigen Werte sind
abhängig vom System, typische sind jedoch 9600, 19200, 38400, 57600 oder 115200.
Der Standardwert ist 19200. Das S25 und die *35i arbeiten nur bei 19200, alle
späteren Modelle arbeiten auch bei voller serieller Geschwindigkeit.
Infrarotverbindungen können, abhängig vom IrDA-Modul, eine Ausnahme sein. Dies
übergeht die SCMXX_BAUD-Variable und den einkompilierten Wert.
--out (-o)
definiert eine zu benutzende Datei. Wenn man Binärdatein mit "all" holt, werden die
Speicherplatznummer und der Dateityp angehängt. Wenn man sendet oder löscht, hat
dieser Parameter keine Wirkung aber die letzten Parameter sollten beim Senden
gültige Dateien sein. Die Standardausgabe muß explizit mittel einem Bindestrich
('-') angegeben werden, sonst wird nichts auf diese geschrieben. Wenn '-' angegeben
wurde, wird nicht an diesen Wert, auch beim holen von mehereren Dateien, angehängt.
--pipe (-p)
definiert eine Pipe zu einem anderen Programm. Wenn man mit "all" Daten holt, wird
jede Datei in eine eigene Pipe geschickt (nur mit --binary und --sms).
--quiet (-q)
verringert die Menge der Ausgaben um 1
--pin die Option kann man benutzen, wenn ein PIN-Code zum Zugriff erforderlich ist
--verbose (-v)
erhöht die Menge der Ausgaben um 1
--reset
versucht, das Handy zurückzusetzen, sodaß man wieder darauf zugreifen kann. Es kann
passieren, daß das Handy nicht mehr auf der seriellen Schnittstelle antwortet,
besonders nach einem vom Benutzer unterbrochenen Dateitransfer. Dies sendet einfach
blind ein paar besondere Zeichen.
--help (-h)
gibt die Hilfeseite aus
--version
gibt die Version aus
--remove (-r)
löscht einen Eintrag vom Handy Wenn --sms und --get mit angegeben werden, holt und
löscht dies. Wenn --sms und --send mit angegeben werden, sendet und löscht dies.
--get (-g)
holt einen Eintrag und Speichert ihn in eine Datei Wenn --sms und --remove mit
angegeben werden, holt und löscht dies. Wenn --sms und --send mit angegeben werden,
holt und sendet dies.
--send (-s)
sendet eine Datei zum Handy Beim Senden vom Kurznachrichten könnte die Option
--direct ebenfalls von Interesse sein. Wenn --sms und --remove mit angegeben
werden, sendet und löscht dies. Wenn --sms und --get mit angegeben werde, holt und
sendet dies.
--info (-i)
sammelt Informationen vom Handy, --mem-info kann als Schalter benutzt werden und
eine komplexere Tabelle über die verfügbaren Speicher auszugeben.
--mem-info
zeigt Informationen über verfügbare Speicher und deren Speicherplätze und andere
Informationen an. Es benutzt dasselbe Format wie --mem=? und kann als Schalter für
--info dienen, um die kurze Speicherauflistung zu ersetzen.
--lock-info
zeigt den Status der Zugriffssperren (locks) an. Es kann als Schalter für --info
dienen, um die kurze Speicherauflistung zu ersetzen.
--lock wählt die ein-/auszuschaltende Sperre aus. Für einige Sperren wird ein Passwort
benötigt (siehe --pin).
--enable
einschalten z.B. einer Sperre
--disable
ausschalten z.B. einer Sperre
--dial wählt eine Nummer (erforder --number). Das Programm beendet sich entweder nach 10
Sekunden oder wenn der Anruf die angerufene Seite erreicht hat.
--hangup
beendet alle, momentan aktiven Gespräche
--set-time
gleicht die Zeit des Handy mit der des Rechners ab. Der Einsatz eines Programms wie
ntpdate wird vor der Nutzung dieses Parameters empfohlen.
--set-smsc
setzt eine neue SMSC nummber (erfordert --number)
--binary (-N)
wählt den Binärdateiübertragungsmodus
--pbook (-P)
wählt den Telefonbuchübertragungsmodus
--sms (-S)
wählt den Kurznachrichtenübertragungsmodus
--mem wählt den Speicher aus, der benutzt werden soll. Speicherplatznummern hängen von
dieser Wahl ab. Die Ausgabe von --info zeigt unterstützte Speicher an. Wird diese
Optioen nicht benutzt, wird eine eventuell vorhandene Vorgabe benutzt. Es gibt den
besonderen Wert "?", der die selbe Ausgabe wie --mem-info hat, nur daß es auf den
gewählten Modus eingeschränkt wird.
--slot wählt die zu benutzende Speicherplatznummer aus. (siehe Ausgabe von --mem-info oder
--mem=?). Wird diese Optioen nicht benutzt, wird eine eventuell vorhandene Vorgabe
benutzt. Der besondere Wert "all" definiert the alle verfügbaren
Speicherplatznummern für den gewählten Speicher und Modus (mit der Ausnahme von
--sms mit --send). Für den Kurznachrichtenübertragungsmodus gibt es die besonderen
Werte "read" (gelesen), "unread" (ungelesen), "sent" (bereits gesendet) und
"unsent" (noch nicht gesendet). Die letzteren beiden können mit --sms und --send
benutzt werden. Für den Telefonbuchmodus gibt es zusätzlich den Wert "last"
(letzter). Wenn diese Option nicht angegeben wird, versucht scmxx einen leeren
Speicherplatz zu finden (je nachdem kann dies auch länger dauern). Wenn ein Wert
angegeben wurde und meherere Datei gesendet werden, ist die angebene
Speicherplatznummer der Startpunkt für die Suche nach leeren Speicherplätzen.
Mehere, nicht-leere Speicherplätze zu überscheiben wird noch nicht unterstützt,
außer für den Spezialfall "all" (alle).
--text (-t)
definiert den Inhalt einer Kurzmitteilung oder eine Telefonbucheintrags. Bei
Telefonbucheinträgen hängt die Länge vom gewählten Telefonbuch ab (siehe Ausgabe
von --mem-info oder --mem=?).
--number (-n)
definiert die Nummber beim Senden einer Kurznachricht oder die Nummer bei einem
Telefonbucheintrag. Die Nummer kann ein Prefix '+' für internationale Nummern haben
und ist normalerweise auf 20 Ziffern (ohne das '+') limitiert, was genug sein
sollte.
--direct
sendet/holt Kurznachrichten ohne sie auf dem Handy zu speichern. Dies ist kein
Standardwert, weil man für das Senden von Kurznachrichten normalerweise Geld
bezahlen muß. Beim direkten Holen werden Kurznachrichten, die nicht vom Type
SMS-DELIVER sind trotzdem auf dem Handy gespeichert, da diese noch nicht dekodiert
werden können.
--unicode
sendet Kurznachrichten als UCS-2 (16bit-Unicode-Zeichensatz). Dieser Parameter muß
nicht angegeben werden, um Unicode-Kurznachrichten zu dekodieren.
--flash
dies setzt das Class0-Bit im DCS-Feld, was beim Empfänger normalerweise als
"immediate display" (unmittelbar anzeigen) interpretiert wird. Nicht alle
Empfangsgeräte unterstützen das. Man muß außerdem beachten, daß eine zweite
Kurznachricht mit dieser Einstellung eine vorherige ohne Nachfrage überschreibt!
Die Nutzung wirde deshalb nicht empfohlen.
--srr dies setzt das Bit StatusReportRequest (Statusreport anfordern) im pdutype-Feld der
SMS-PDU. Es hängt von der SMSC ab, ob dieses Bit beachtet wird. Bei manchen
Providern kosten StatusReports extra.
--sort sortiert die Kurznachrichten bei der Ausgabe. Mögliche Sortiermethoden sind "type",
"slot" und "type,slot". "type" sortiert nach dem Nachrichtentyp mit einer internen
Rangfolge: erst die nicht unterstützten Typen, dann SMS-SUBMIT, SMS-STATUS-REPORT
und SMS-DELIVER. "slot" sortiert nach dem Speicherplatz der Kurzmitteilung.
"type,slot" sortiert erst wie "type" und dann jeden Typen wie "slot". Die Vorgabe
ist keine Sortierung (Reihenfolge hängt vom Handy ab).
--pin ermöglichst die Nutzung einer PIN. Diese Option sollte nur benutzt werden, wenn
nach eine Fehlermeldung erscheint, die nach einer PIN oder PUK verlangt. Für eine
PIN ist dies die erwartete "<PIN>", für eine PUK ist dies die erwartete "<PUK>,<new
PIN>". Der Wert wird nur ein einziges Mal benutzt. Die Pin-Datei sollte, wenn
möglich, stattdessen benutzt werden (siehe unten).
--system-charset
definiert den Systemzeichensatz anstatt den Rückgabewert von nl_langinfo(CODESET)
zu nutzen. Das ist eine Behelf für Systeme, die keine Unicode-Locales wie UTF-8
unterstützen oder wenn Daten von einem anderen System mit einer anderen Locale als
Eingabe benutzt werden soll. Normalerweise wird diese Option nicht benötigt.
BEISPIELE
Senden einer Bitmapdatei an das Handy (Logo):
scmxx --send --binary --mem="bmp" --slot=0 myfile.bmp
Holen eines Logos vom Handy und speichern in eine neue Datei:
scmxx --get --binary --mem="bmp" --slot=0 --out=myfile.bmp
Holen aller ungelesenen (Vorhabe beim holen) Kurznachrichten und Ausgabe auf die
Standardausgabe:
scmxx --get --sms --slot=unread --out=-
scmxx -gS -o-
Direkten empfangen einer Kurznachricht:
scmxx --send --sms --direct --number=123 --text="test"
Holen eines Telefonbuchs und speichern in eine Datei:
scmxx --get --pbook --mem=SM --out=SM.pb
Änders des Speicherplatzes 33 im Telefonbuch SM:
scmxx -sP --mem=SM --slot=33 --number=123 --text="test"
BESONDERHEITEN
Die Ausgabe von Text (Telefonbuch und SMS) hängt von dem Zeichensatz der gewählten
Systemlocale ab, ebenso für die Eingabe. Das hat den Vorteil der Lokalisation aber auch
den Nachteil, daß alle nicht von der Locale unterstützten Zeichen mit einer Sequenz \XXXX
eingegeben werden müssen, wobei X ein Hexadezimalzeichen ist (z.B. \20ac für das
Eurozeichen). Das ist der 16bit-Unicode-Wert. Die \XXXX-Ausgabe wird nur für Ausgaben
benutzt, die normalerweise auch wieder als Eingabe dienen können. Für alle anderen Ausgabe
wird ein Fragezeichen ('?') als Platzhalter genommen. Mit einer UTF-8-locale kann man
sicherstellen, daß alle Zeichen konvertiert und angezeigt werden können. Das Zeichen für
das Zeilenende kann als das übliche \n eingegeben werden und '\' muß sich selbst
vorangestellt werden. In der bash kann dies sogar in einem "\\\\" enden.
VERBINDUNGSPROBLEME
Es gibt die zusätzlichen Parameter --ignore-serial-bits (serielle Bits ignorieren,
Vorgabe) und --keep-serial-bits (serielle Bits beibehalten). Diese sollte man nur
probieren, wenn das Handy keine Antwort zu geben scheint. Welchen Einstellung die richtig
ist, hängt vom Kabel und vom seriellen Port ab und kann nicht automatisch bestimmt werden.
Wenn Timeouts beim ersten Kommando kommen, kann man außerdem die Option
--start-delay=<seconds> (Anfangsverzögerung in Sekunden) probieren.
Eine weitere Option --device-timeout=<seconds> (Gerätetimeout in Sekunden) gibt es für den
Fall, daß es das Handy nicht schafft, auf ein Kommando innerhalb von 10 Sekunden zu
antworten. Eigentlich sollte dies mehr als genug sein, aber man weiß ja nie. Der minimal
erlaubte Wert ist 1, der höchste von 25 bedeutet "unendlich lange".
SICHERHEIT
Die --pin Option sollte man mit Vorsicht benutzen. Diese Option mitsamt Wert ist in der
Prozesslist sichtbar.
UMGEBUNGSVARIABLEN
SCMXX_TTY
siehe --device für eine Beschreibung
SCMXX_BAUD
siehe --baud für eine Beschreibung
DATEIEN
~/.scmxx/cache.pb
Diese Datei dient als Telefonbuch (für Nummer von Empfänger/Sender) während der
Ausgabe von Kurznachrichten und als Alias für --number beim Senden von
Kurznachrichten. Das Format ist dasselbe wie eine Telefonbuchdatei (die
Speicherplatznummern sind nicht wichtig, müssen aber vorhanden sein).
~/.scmxx/config
Diese Datei kann Option in der langen Form (aber ohne die --) enthalten. Der Wert
is von der Option durch ein '=' getrennt. Eine beliebige Anzahl von Leerzeichen ist
am Anfang der Zeile, vor und nach dem Trennzeichen erlaubt. Ein '#' am Anfang der
Zeile markiert diese Zeile als Kommentar. Beispiele:
#eine andere Gerätedatei festlegen
device = /dev/ttyS0
#SMS immer als UCS-2 senden
unicode
~/.scmxx/pin
Diese Datei wird als Alternative zur --pin Kommandozeilenoption benutzt. Die Datei
DARF NICHT gruppenlesbar/-schreibbar oder weltlesbar/-schreibbar sein! Es MUSS auch
eine reguläre Datei sein, kein SymLink. SCMxx wird sonst die Nutzung der Datei
verwehren. Wenn ein PUK-Wert vom Gerät angefordert wird, muß ein zugehöriger
PIN-Wert ebenfalls definiert sein. Die einzig nötigen Formatelemente sind '{', '=',
';' und '}'. Leerzeichen und Zeilenumbrüche werden ignoriert. Die Datei hat das
folgende Format:
sim 262031234567890 {
pin = 1234
puk = 12345678;
pin2 = 4321;
puk2 = 87654321;
}
device 350123456789012 {
type SIM {
pin = 0000;
puk = 0000;
}
}
"sim"-Sektionen benutzen die IMSI als Variable, "device"-Sektionen benutzen die
IMEI als Variable (siehe Ausgabe von --info). Da die IMSI benötigt wird, können sie
hiermit nicht das Handy einschalten. Die "type"-Untersektion in der device-Sektion
hat folgende Variablen:
SIM Gerätecode (Diebstahlsicherung)
FSIM die zuallererst eingelegte SIM
NET Netwerk-Personalisierung
NETSUB Netwerk-Subset-Personalisierung
SP Service-Provider-Personalisierung
CORP Corporate-Personalisierung
AUTOR
Hendrik Sattler post@hendrik-sattler.de