opt_yaps fr fli4l
==================

!!!!!!!! Wichtig!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!                                                              !
! Yaps funktioniert nicht ber DSL oder Internet!              !
! Yaps bentigt auf jeden Fall eine ISDN Karte oder ein Modem! !
!                                                              !
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!


Mit dem opt_yaps knnen ber die ISDN Karte des Fli4L Routers SMS an Handys geschickt 
werden, wobei je nach Provider weniger Kosten entstehen, als beim SMS Versand mit 
einem Handy. Auerdem ist das Eintippen der SMS an der PC-Tastatur angenehmer.

Das Paket opt_yaps beruht auf dem Linux Programm Ypas von Uli Dessauer und war 
ursprnglich von Stefan Rupprecht. Ich habe es etwas ausgebaut und die Anleitung 
geschrieben.

Das Paket wurde mit Fli4L 2.1.2 erstellt und getestet.


Das opt_yaps bentigt nur einen Fli4l mit installierter ISDN Karte.
Konfiguriert wird yaps ber die Datei yaps.rc im Verzeichnis opt\etc. Die Datei kann
nicht mit dem Windows/Dos Editor bearbeitet werden, da sie im Linux format gespeichert
werden mu!
Die wichtigsten Einstellungen hab ich aber ber die Datei /config/yaps.txt einstellbar 
gemacht, so da ein ndern der yaps.rc eigentlich nicht ntig sein sollte. Die Datei 
yaps.rc wird beim Booten des Fli4l vom Skript rc500.yaps erstellt.

Fr Deutschland sind folgende Services sind fr den SMS Versand eingerichtet:
D1 mit den Vorwahlen 0151, 0160, 0161, 0170, 0171, 0175
D2 mit den Vorwahlen 0152, 0162, 0172, 0173, 0174
E+ mit den Vorwahlen 0163, 0177, 0178

Viag Interkomm bzw. O2 bot lange Zeit gar keinen SMS Gateway an und hat jetzt nur einen
schlecht funktionierenden und langsamen Gateway, deshalb habe ich O2 so konfiguriert, da
ber den D2 Gateway gesendet wird. Die Vorwahlen sind 0176 und 0179.


Peter Egli hat opt_yaps fr die Schweiz um folgende Dienste erweitert:
Swisscom, Orange, Sunrise und Tele2 (ber Swisscom).
Vielen Dank dafr Peter!

Ich habe opt_yaps ohne internationale Vorwahlen konfiguriert, so da deutsche und
schweizer User direkt ohne weitere Konfiguration jeweils ihre landeseigenen Netze 
erreichen knnen. 
Sollte jemand aus Deutschland in ein Schweizer Netz senden wollen oder umgekehrt, mssen
in der rc500.yaps bzw. ind der rc.yaps noch die jeweiligen internationalen Vorwahlen fr 
die jeweiligen Netze ergnzt werden.



Kosten:
=======

Hier mal eine Beispielrechnung mit dem Call-by-Call Provider Interoute (www.interoute.de),
Preise laut Preisliste von Interoute vom 13.10.2002.

Bei Interoute zahlt man eine Einwahlgebhr von 3 Cent, eine Minute ins Mobilfunknetz kostet
tagsber 30 Cent, abends/nachts 25 Cent (sekundengenaue Abrechnung). Das Versenden einer
SMS dauert zw. 3 und 15 Sekunden, je nach Auslastung des Call-by-Call Providers und des
SMS-Gateway. Bei meinen Tests waren es fast immer zw. 3 und 5 Sekunden.

SMS tagsber 3 Sekunden:	3Cent+(30Cent/60)*3=  4,5 Cent
SMS tagsber 15 Sekunden:	3Cent+(30Cent/60)*15= 10,5 Cent
SMS abends 3 Sekunden:		3Cent+(25Cent/60)*3=  4,25 Cent


Leider gibt es Interroute nicht mehr. Bin selber auch noch auf der Suche nach einem anderen
CbC Provider. Das Problem dabei ist, da es einer sein sollte, der sekundengenau abrechnet
und der die Nummern fr die SMS Gateway nicht gesperrt hat.


Installation:
=============

Einfach die Zip-Datei ins Fli4l Verzeichnis entpacken und die Datei /config/yaps.txt
anpassen, wie bei den anderen Fli4l-Paketen auch. 


Optionen der yaps.txt
=====================

OPT_YAPS	yes/no
		yaps installieren?

YAPS_USE_CID	True/False
		Caller ID verwenden? Die Caller-ID ist die Absendernummer, die auf dem
		Handy, das die SMS empfngt, angezeigt wird. Leider funktioniert das
		scheinbar nur bei D2, bei D1 wird immer die Telefonnummer (MSN)
		angezeigt, von der aus die SMS verschickt wurde. Bei E+ wird immer die
		Nummer der SMS Zentrale angezeigt. 

YAPS_CID	Absendernummer, ohne Leerstellen oder sonstige Trennzeichen eingeben.

YAPS_USE_SIG	True/False
		Soll eine Signatur an die SMS angehngt werden?

YAPS_SIG	Die zu verwendende Signatur, dabei bitte die max. Lnge von 160 Zeichen
		pro SMS beachten. Ist die Signatur 50 Zeichen lang, bleiben nur noch
		110 Zeichen fr die SMS. Ist eine SMS (inkl. Sig) lnger als 160 Zeichen,
		zerlegt yaps sie in mehrere SMS zu je max. 160 Zeichen, d.h. wenn man 
		z.B. einen 500 Zeichen langen Text eingibt, schickt yaps einfach 4 SMS
		hintereinander.

YAPS_CBC	Vorwahl eines Call-by-Call Providers
		Will man einen Call-by-Call Provider nutzen, kann man hier dessen Vor-
		wahl eintragen.
		Da die Telekom im Minutentakt abrechnet, ist ein CbC Provider schon 
		sinnvoll, wenn man einen hat, der bei Mobilfunknummern im Sekundentakt
		abrechnet, da eine SMS normalerweise in 3 bis 5 Sek. verschickt wird.
		Ich hatte vorher die Vorwahl von 3U fest in die yaps.rc eingetragen,
		doch leider hat dieser Provider scheinbar die Nummern der SMS Gateways
		gesperrt, da er wahrscheinlich an den 3 Sekunden Verbindungen keinen
		Gewinn machen konnte.

YAPS_MSN	Hier muss die MSN des eigenen Telefonanschlusses eingetragen werden.
		(Nur die MSN, ohne Vorwahl) Das Feld darf nicht leer bleiben, wenn
		eine falsche Nummer angegeben wird ist das aber nicht schlimm, da die
		Vermittlungsstelle dann einfach eine der verfgbaren MSN des 
		Anschlusses setzt.

YAPS_VERBOSE	Debuglevel 1-4
		Der Debuglevel gibt an, wieviele Infos yaps zurckgibt. Normalerweise
		sollte 1 hier ausreichen, wenn etwas nicht funktioniert, kann man einen
		hheren angeben, um zu sehen, waran es liegt.

YAPS_LOG	/var/log/yaps.log
		Pfad und Name der Log-Datei, die von yaps angelegt wird.
		/var/log liegt in der Ramdisk und ist daher nur solange verfgbar, wie
		der Router luft, nach einem Reboot z.B. ist sie weg. Soll die Logdatei
		nicht gelscht werden, mu hier ein anderer Pfad z.B. auf der Festplatte
		oder der Diskette angegeben werden.

YAPS_ALIAS{1-5}	Hier knnen Aliase festgelegt werden, dies ist nur ntig, wenn yaps aus der
		Console aufgerufen wird, bei der Verwendung von yapsgui sind sie unntig, da
		yapsgui ein Telefonbuch hat. Die Alias mssen in der Form NAME NUMMER eingetragen
		werden, ohne Leer- und Sonderzeichen. Also z.B.: YAPS_ALIAS1='ralf 0175xxxxxx'
		Danach kann dann z.B. mit yaps ralf "Hallo" eine SMS an die Nummer 0175xxxxxx
		geschickt werden. Beim Namen bitte keine Leer- oder Sonderzeichen verwenden und
		auf Gross- u. Kleinschreibung achten. Ich habe mal 5 Aliase reingeschrieben,
		denke das sollte gengen, aber falls nicht, knnte man noch welche ergnzen,
		dazu mssen die Dateien /config/yaps.txt, /check/yaps.txt und /opt/etc/rc.d/rc.yaps
		entsprechend gendert werden. Da es sich bei der rc.yaps um ein Skript handelt,
		sollte das unter Linux gendert werden, oder mit einem Editor der es im Linux Format
		abspeichert (gibt es sowas fr Windows? Ich wei es nicht.).



Bedienung
=========

Yaps kann ber die Konsole oder ber Telnet/SSH aufgerufen werden:

	yaps <nummer> "<text>"

z.B.	yaps 0171xxx "Hallo, wie gehts?"


Ruft man yaps ohne weitere Parameter auf, wird eine kleine Hilfe zu mglichen 
Parametern angezeigt.

Es gibt auch eine Eingabeoberflche fr den MiniHTTPD von Fli4l. Diese wurde von Felix
Eckhofer geschrieben -> http://fli4l.tribut.de/




Bei Fehlern oder Verbesserungsvorschlgen, schickt mir ne mail:
Ralf Dausend 		dausend-ralf@gmx.de


