1. Einleitung Nachdem es immer wieder zahlreiche Fragen hinsichtlich Oscam gibt, versuche ich euch in diesem Tutorial den Umgang mit der genannten Softcam etwas nher zu bringen. Neben der Installation soll das Betreiben von Oscam 1.20 (es wird nur ber diese Version gesprochen) als allein stehendes Cam beschrieben werden. Auch gibt es noch ein paar Tipps zum Tunen der Oscam-Konfigurationen bzw. das Aufspielen einer neuen Version.
Ich habe auch versucht, die wichtigsten Punkte zu verlinken, so dass ihr mglichst schnell in den richtigen Bereich des Nachtfalke-Forums geleitet werdet. Hier stehen auch noch ergnzende Beschreibungen zur Verfgung. Die hier angefhrten Daten sind auf die Anwendung mit einer Dreambox abgestimmt, knnen aber natrlich auch fr den Gebrauch mit anderen Boxen heran genommen werden.
Wichtig, nach jeder nderung der Konfigurations-Dateien ist ein Neustart von Oscam 1.20 notwendig, um diese auch verfgbar zu machen.
Um Probleme zu vermeiden wird empfohlen, eine aktuelle Version von Oscam (ab Build 9127) zu verwenden. Wie eine Aktualisierung von Oscam funktioniert, wird unter Punkt 8 beschrieben.
Seite 3 von 14
2. Installation Fr das hier vorgestellte Beispiel wurde eine Dreambox DM8000 herangenommen. Natrlich ist die bernahme der Konfigurations-Dateien auch fr jede andere Box mglich. Sollten hierzu nderungen notwendig sein, so werden diese unter den einzelnen Punkten erwhnt.
Die beste Mglichkeit Oscam auf die Box zu bringen, ist natrlich die Installation des Cams ber die Addons. Nachdem aber einige Image-Builder diesbezglich einen Rckzug gemacht haben, bedarf es hier manchmal einen kleinen Umweg zu gehen. Wer sich z. B. fr ein original Image von DMM bzw. OoZooN entscheidet, kann dies durch verschiedene Mglichkeiten tun, die ber den gesetzten Link erreichbar sind. Gleiches gilt auch fr Merlin, whrend bei Newenigma2 noch alles beim Alten ist. Natrlich gibt es auch eine Variante fr Nutzer des GP 3.2 Plugins, die ja bei fast allen Images mit eingebunden werden kann. Wer den verschiedenen Links folgt wird feststellen, dass meistens eine sog. Cam-Feed Lsung angeboten wird. Diese sollte gerade von Anfngern gegenber einer manuellen Installation vorgezogen werden, da sich so weniger der Fehlerteufel einschleichen wird.
Nachdem ihr Oscam installiert habt, msst ihr euch auch noch die entsprechenden Konfigurations- Dateien aufspielen, die ebenfalls ber die Addons bzw. den angelegten cam-Feed abrufbar sind. Die Konfigurations-Dateien sind in der Regel unter /var/tuxbox/config bzw. /etc/tuxbox/config zu finden. Mittels eines FTP-Programmes, wie z. B. DCC habt ihr nun die Mglichkeit, diese Dateien zu bearbeiten.
Dies ist auch notwendig, da ohne Anpassung der Konfigurations-Dateien bei Oscam nichts luft. Bei einem ersten Aufrufen des genannten Ordners werdet ihr feststellen, dass zahlreiche Oscam- Konfigurationsdateien vorhanden sind, von denen aber zuerst mal nur drei bentigt werden. Hierbei handelt es sich um oscam.conf, oscam.server und oscam.user. Die weiteren Dateien sichert ihr auf eurem PC, lscht sie aber aus dem Ordner der Dreambox. Unter Punkt 7 erklre ich euch, was es mit den gelschten Konfigurations-Dateien auf sich hat und wie diese gezielt fr das Tuning von Oscam eingesetzt werden knnen.
Wurde alles richtig installiert, so kann Oscam 1.20 ber das Softcam-Men gestartet werden. Leider wird noch keine Karte hell, da noch die drei zuvor genannten Konfigurations-Dateien bearbeitet werden mssen. Hierzu lscht ihr zuerst mal den kompletten, aktuellen Inhalt aus oscam.conf, oscam.server und oscam.user heraus. Was in diese drei Dateien alles hinein muss, wird unter Punkt 3 5 beschrieben.
Seite 4 von 14
3. oscam.conf Die oscam.conf legt grundlegende Dinge bei Oscam fest. So werden in dieser globale Einstellungen, wie z. B. den Speicherort der Logdatei, Zugangsdaten des Webinterface und Erstellung einer Verbindung zum u.a. oscam.user festgelegt. Um diese mglichst einfach zu halten, habe ich in die oscam.conf nur die wichtigsten Daten erfasst, welche sich nicht an die eh schon vorhandenen Defaultwerte richten. Somit sollte in die oscam.conf folgendes eingefgt werden:
[gl obal] l ogfile = /var/cache/oscam.log di sableuserfile = 0 cl i enttimeout = 15000 # (fr Kartenaktivierung evtl. nderung des Wertes ntig) fal lbacktimeout = 4900 cl i entmaxidle = 60 bi ndwait = 20 netpri o = 0 ni ce = -1 maxl ogsize = 100 preferlocalcards = 1
[dvbapi] enabled = 1 au = 1 boxtype = dreambox # (nderung des Wertes bei anderen Boxen evtl. mglich) user = l ocal pmt_mode = 0 decodeforever = 1
[webif] httpport = 20000 httpuser = userif httppwd = passif httprefresh = 10 httpallowed = 127.0.0.1,192.168.1.1-192.168.255.255 # (bei Nutzung einer dyndns 0.0.0.0-255.255.255.255) httpdyndns = durch Ei ngabe einer eigenen DYNDNS kann auch von Unterwegs in Webif
[cache] Del ay = 120
Der Bereich [global] regelt die allgemeinen Einstellungen fr Oscam. So wird z. B. der Speicherort des logfiles festgelegt, der fr die Fehleranalyse von Bedeutung sein knnte.
Einen wichtigen Wert stellt auch clienttimeout dar. Bei der im Beispiel genannten Einstellung ist dieser auf 15000 gesetzt, was bedeutet, dass sich der [reader] (Beschreibung siehe Seite 5) bei fehlenden EMMs (Werte die auf den PayTV-Karten eingetragen werden, um deren Freischaltung zu ermglichen) nach 15 Sekunden abschaltet. Gerade bei der Aktivierung von neuen Karten kann es aber wichtig sein, diesen Wert kurzfristig zu erhhen. So sollte er z. B. bei einer neuen Sky V13 auf 900000 gesetzt werden. So frgt der [reader] ber 15 Minuten die EMMs ab ohne in den Ruhezustand zu gehen. In dieser Zeitspanne drfte die V13 auch mit den notwendigen Entitlements bestckt sein. Anschlieend kann dieser Wert wieder zurck auf die ursprnglichen 15000 gesetzt werden.
Seite 5 von 14
Die [dvbapi] regelt den Kontakt zum oscam.user. Hierbei wird auch der boxtyp festgelegt, der in unserem Falle ja eine Dreambox DM8000 ist. Hier ist eine Angleichung fr weitere Boxen (z. B. dbox2, ufs910, coolstream usw.) mglich. Mit dem Wert decodeforever wird der dauerhafte Versuch des Freischaltens eines Senders geregelt. Dies ist insbesondere dann von Bedeutung, wenn man PayPerView Events bestellen und schauen bzw. eine neue Smartcard freischalten will. Um die entsprechende Option zu ermglichen, sollte dieser Wert auf 1 stehen.
[webif] ermglicht den Zugriff auf das Webinterface von Oscam zu regeln. Hierbei sind der Port, User und Password frei whlbar. Der Wert httprefresh legt die Zeitspanne der Aktualisierung fest. In unserem Falle steht sie auf 10 Sekunden. Das Webinterface knnt ihr bei laufender Oscam ber euren Browser abrufen. Wichtig hierzu ist es aber auch die entsprechende Erlaubnis zu erteilen. Deshalb muss im Wert httpallowed ein Rahmen gesetzt werden. Hier sollten User von IPv6 zwingend darauf achten, diesen Eintrag mit ,::1 enden zu lassen. Mit Gebt hierzu die IP eurer Box:festgelegter Port ein, was in unserem Beispiel dann so aussieht:
192.168.1.10:20000
Bei einem Aufruf des Webinterfaces kommt ihr direkt auf die Statusangaben, die euch eine bersicht ber die verwendeten Karten und bestehenden Verbindungen geben. Ferner knnt ihr ber weitere Writer alle von euch angelegten Konfigurationen einsehen. Im Bereich Readers ist es z. B. mglich, die Entitlemens (wie lange ist meine Karte noch gltig) zu betrachten.
Man kann das Webif auch mittels einer DYNDNS von unterwegs aus aufrufen. Hierzu muss jedoch der erlaubte http-Bereich erweitert werden. Diese Option ist allerdings mit Vorsicht zu genieen, da ihr so von auen natrlich auch leichter angreifbarer werdet.
[cache] regelt die Verzgerung der Antwortzeit zum Client. Dies kann manchmal recht hilfreich sein, da eine zu schnelle Anfrage zu Fehlern fhren kann. Aus diesem Grund wurde mit dem Wert delay die Verzgerung auf 120 Millisekunden. geregelt.
Seite 6 von 14
4. oscam.server Der oscam.server ist das Herz fr eure Pay-TV Karten. Hier ist es wichtig, dass diese richtig, in sog. [reader] angelegt werden, da diese sonst gegebenenfalls nicht hell werden. Nachdem die DM8000 zwei Kartenslots hat, werde ich dementsprechend auch diese mit zwei Karten befllen. Hierzu nehme die V13 von Sky Deutschland und die HD02 (schwarze Karte) von HD+ her, da diese im deutschsprachigen Raum wohl die gngigsten sein drften. Zustzlich schlieen wir noch einen Smargo mit einer ORF ICE-Karte im Irdeto-Modus (wichtig fr Austria HD) an, um auch den Umgang mit diesem Kartenleser, der brigens der gleiche wie bei der Easymouse sein wird, zu erklren. Deshalb befllen wir den oscam.server folgendermaen:
[reader] l abel = skydeV13 enable = 1 protocol = i nternal devi ce = /dev/sci1 cai d = 09C4 boxi d = 12345678 detect = cd cardmhz = 2700 # bei mipsel Version 2700, fr ppc 3150 (nur fr i nterne Reader anwenden) autospeed = 1 group = 1 emmcache = 1,3,2 l b_weight = 100 i ns7e11 = 13
[reader] l abel = hdpl us enable = 1 protocol = i nternal devi ce = /dev/sci0 cai d = 1843 rsakey = Googl e hilft boxkey = Google hilft detect = cd cardmhz = 2700 autospeed = 1 group = 2 emmcache = 1,3,2 l b_weight = 100
[reader] l abel = ORFI rdeto enable = 1 protocol = mouse detect = cd devi ce = /dev/ttyUSB0 group = 3 cai d = 0648 cardmhz = 600 autospeed = 1 force_i rdeto = 1 rsakey = di e Nachtfalke Database hilft boxkey = di e Nachtfalke Database hilft boxi d = 12345678 deprecated = 1 emmcache = 1,3,2 l b_weight = 100
Seite 7 von 14
Der label kann frei definiert werden und erklrt im Normalfall die Karte.
Das protocol zeigt, wo sich die jeweilige Karte befindet. Internal steht hierbei fr die Kartenslots der Box, whrend mouse fr einen Smargo bzw. Easymouse hergenommen wird.
Das device ist die genaue Zuweisung des Slots der Box bzw. Smargos. In unserem Falle ist sci1 der obere Slot der DM8000, whrend sci0 den unteren markiert. An dieser Stelle sei darauf hingewiesen, dass es bei der DM800SE und DM7020HD seitens Dream Multimedia eine nderung bei der Benennung der Devices gegeben hat. Hier wird mit sci0 der obere und mit sci1 der untere Slot benannt. Also zur Sicherheit nochmals nachsehen, ob sich eure Karten auch im richtigen Slot befinden. ttyUSB0 ist der zugewiesene USB-Port des Smargos/Easymouse. Diese Werte knnen sich natrlich je nach Box variieren.
Die cardmhz setzt ihr bei den internen Reader eurer E2 Box auf 2700. Fr E1 Boxen lautet der Wert 3150. Wichtig, dies gilt nur fr die internen Reader. Fr externe Kartenleser, wie z. B. Smargo oder Easymouse, setzt ihr den fr die Karte entsprechend gltigen Wert.
Der Wert autospeed regelt bei Setzung auf 1 automatisch die Geschwindigkeit der Karte.
Group ist ein absolut wichtiger Wert. Es ist zwingend erforderlich jeden [reader] eine eigene Gruppe zuzuweisen. Der einfachste Weg ist hier wohl bei 1 zu beginnen und fortlaufend durch zu nummerieren. Die einzelnen groups spielen im weiteren Verlauf im oscam.user noch eine Rolle.
Alle weiteren Werte sind spezifisch fr die einzelnen Karten. So kann es sein, dass ein [reader] auch nur 6 Zeilen an Werten enthlt, wobei andere, wie z. B. der [reader] der ORF-ICE im Irdeto-Modus mit 16 Zeilen bestckt werden sollte.
Seite 8 von 14
5. oscam.user In den oscam.user werden, wie der Name schon sagt, die Benutzer der Karten mit eingetragen. In diesem Beispiel ist das nur die DM8000, um das Homesharing kmmern wir uns unter Punkt 7. Der oscam.user sollte wie folgt befllt werden:
[account] user = l ocal group = 1,2,3 au = 1
Bei der Anlage des [account] greifen wir wieder auf die oscam.conf zurck. Dort habt ihr in der [dvbapi] den user festgelegt. Dieser Wert muss mit dem user im [account] identisch sein.
Mit dem Wert group wenden wir uns an den oscam.server. Dort haben wir ja drei Karten angelegt, denen wir verschiedene groups zugewiesen haben. Damit die Karten auch zur Entschlsselung der Programme beitragen, mssen diese hier eingetragen werden. Tragt ihr hier z. B. nur 1,2 ohne die 3 ein, so bleiben die ORF-Kanle dunkel.
Seite 9 von 14
6. Zustzliche Karten einfgen Natrlich knnen nach Belieben noch weitere Karten in Oscam 1.20 eingebunden werden. Hierzu muss aber immer ein neuer [reader] mit eigener group angelegt werden, welcher einfach unten in den oscam.server angefgt wird. Diesbezglich gibt es hier noch einige Beispiele gngiger Karten:
[reader] l abel = skyuk enable = 1 protocol = i nternal devi ce = /dev/sci1 cai d = 0963 boxi d = Hex-Wert der Box detect = cd cardmhz = 2700 autospeed = 1 group = ei genstndige group benennen emmcache = 1,3,2 bl ockemm-g = 1 bl ockemm-u = 0 bl ockemm-s = 0 l b_weight = 100
[reader] l abel = srg enable = 1 protocol = i nternal devi ce = /dev/sci1 cai d = 0500 detect = cd cardmhz = 2700 autospeed = 1 group = ei genstndige group benennen emmcache = 1,3,2 l b_weight = 100 deprecated = 1
[reader] l abel = mtv enable = 1 protocol = mouse detect = CD devi ce = /dev/ttyUSB1 group = ei genstndige group benennen cai d = 0B00 emmcache = 1,3,2 l b_weight = 100
Die Aufzhlung der [reader] wre mit zahlreichen Beispielen erweiterbar. Einen Sammelthread mit weiteren [reader] findet ihr im Dreambox Forum von Nachtfalke.
Seite 10 von 14
7. Tuning Wie zu Beginn der Einrichtung von Oscam 1.20 erwhnt, gibt es neben den drei von uns benutzten Konfigurations-Dateien noch weitere im Angebot, die ein gewisses Tuning ermglichen. Wir werden uns diesbezglich vier dieser zustzlichen Konfigurations-Dateien mal nher betrachten.
7.1 oscam.dvbapi Bei der Verwendung bestimmter Karten, wie z. B. der Sky-V13 oder der ORF-ICE im Irdeto-Modus, kann es bei den Umschaltzeiten zu Problemen kommen. Da sowohl Sky als auch ORF verschiedene Kartenvarianten in Betrieb haben, werden auch auf den entsprechenden Sendern mehrere caids verwendet, von denen Oscam nicht wei, welche die richtige fr die, von uns verwendete Karte ist. Deshalb probiert Oscam alle caids durch, womit bis zur tatschlichen Erhellung des Programmes mehrere Sekunden vergehen knnen. Hier hilft nun die oscam.dvbapi, welche Prioritten setzt bzw. caids ignorieren kann. Der folgende Inhalt der Datei zeigt, wie beide Varianten funktionieren:
P: 09C4 P: 0648 P: 1843 I: 0
Das P: (fr Priority) zeigt, dass ich fr bestimmte Sender von Sky die V13 bevorzuge. Dies geht aus der 09C4 hervor, welche die Caid der V13 darstellt. Die Caid 0648 steht fr die ORF ICE und die Caid 1843 fr die HD+ Karte (schwarz), fr die gleiches gilt.
Natrlich kann ich mit I: (fr Ignore) nun auch die restlichen Caids, die meine Karte nicht verwendet, ausschlieen. Mit dem Wert 0 mache ich dies fr alle Caids, die nicht als Priority von mir genannt werden. Natrlich kann ich auch hier Einzelwerte setzen.
Die Liste kann brigens ohne Probleme selbst ergnzt werden. Ihr findet alle dafr notwendigen Daten im Status des Web-Interface. Wenn ihr hier auf einen Pay-TV Kanal zappt erscheint im unteren Bereich folgende Zeile:
2011/04/28 7:33:31 XXXXXXXX buero (1722&000000/C615/93:1CE6): found (519 ms) by XXX (of 1 avai l 1)
Mit dieser Zeile habe ich nun gengend Werte, die es mir sogar ermglichen nur einzelne Sender zu priorisieren bzw. zu ignorieren. Die in Rot kenntlich gemachte Zahl benennt die caid, whrend die grne Kombi die ecmpid angibt. Achtet darauf, dass ein Sender bei Verwendung mehrerer caids auch die entsprechende Anzahl von Zeilen mit caid + ecmpid hat. Will ich nun dies fr einen einzelnen Sender machen, so sieht die entsprechende Zeile bei einer Priority in der oscam.dvbapi so aus:
P: 1722:::1CE6
Bitte achtet darauf, dass zwischen Caid und ECMPID drei Doppelpunkte gesetzt sind.
Seite 11 von 14
7.2 oscam.provid Die oscam.provid hat eher kosmetische Zwecke und dient dazu, die Provider bersichtlich im Web- Interface darzustellen. Hierzu folgendes Beispiel:
09C4:000000|SKY D|Astra 19.2E|Deutsch
Dargestellt ist hier der Provider Sky mit seiner V13-Karte. Die ersten vier Stellen benennen die caid der Karte. Nach dem Doppelpunkt kommt das sog. Provider-Ident. SKY D ist der Name des Providers und kann frei gewhlt werden. Auch Astra sowie die bevorzugte Sprache des Providers drften klar sein. Beide Begriffe knnen ebenfalls frei eingetragen werden.
7.3 oscam.services Mit oscam.services habe ich die Mglichkeit, allen oder einzelnen [accounts] nur bestimmte Sender zuzuweisen. Dies macht vor allem dann Sinn, wenn Kinder im Haus mit eigenem TV sind und diese nur fr sie geeignete Sender empfangen sollen. So kann ich z. B. bei Sky alle Spielfilmsender fr das Kinderzimmer ausklammern, obwohl ich eigentlich das Vollpaket abonniert habe. Eine angelegte oscam.services sieht ungefhr so aus:
[skyfi l m] cai d = 1702 srvi d = 0008,0009,000A,000B,0014,0019,0029,002B,0203,0204
[skyfilm] ist der Name der Servicegruppe und ist frei whlbar. Die caid steht in diesem Falle fr eine S02 von Sky. Die srvid sind die jeweiligen Senderkennungen der einzelnen Filmkanle.
Damit die Sender im Kinderzimmer nicht empfangen werden knnen, muss ich in dem entsprechenden [account] des oscam.user noch folgende Zeile ergnzen:
servi ces = !skyfi l m
Das Ausrufezeichen verdeutlicht Oscam, dass diese Sender dem [account] nicht zugefhrt werden sollen. Natrlich kann ich es auch anders herum machen. Durch Herausnahme des Ausrufezeichens bekommt der entsprechende [account] das Recht, die NUR skyfilm zu sehen.
Eine aktuelle Sammlung von Services findet ihr HIER.
Seite 12 von 14
7.4 oscam.srvid Die oscam.srvid dient hauptschlich dafr, das Webinterface kosmetisch aufzubessern. Durch die entsprechenden Eintrge in diese Datei, werden im Webinterface die Sendernamen sichtbar. Die Befllung der Datei sieht so aus:
# Sky Deutschl and # 1702:0008|SKY Germany|Sky Comedy[BC 02]|TV|
Die erste Ziffernfolge zeigt die caid sowie nach dem Doppelpunkt die Senderkennung. Die restlichen Daten ergeben sich von selbst und knnen frei gewhlt werden. Eine aktuelle Sammlung von srvids findet ihr HIER.
Seite 13 von 14
8. Aufspielen einer neuen Oscam-Version (Buildvernderung) Gelegentlich kommt es vor, dass Oscam auf den aktuellen Stand gebracht werden und deshalb ein neues Build aufgespielt werden muss. Um dies zu erleichtern, findet ihr unter diesem Punkt eine entsprechende Beschreibung der dazu notwendigen Vorgehensweise.
Zuerst mssen die notwendigen Voraussetzungen geschaffen werden. Ihr bentigt ein FTP- Programm, wie z. B. DCC, sowie natrlich ein aktuelles Build, welches ihr unter folgenden Link runterladen knnt:
http://downl oad.oscam.cc
Die Builds haben eine fortlaufende Nummer, wobei die hchste immer die aktuellste ist. Ebenso werdet ihr dort zu Beginn mit 1.10 tagged und 1.20 trunk zwei Ordner vorfinden, wobei 1.10 fr die stable Variante und 1.20 fr unstable steht. Wir greifen zur 1.20, die immer auf dem aktuellsten Stand ist.
Bei Klicken auf 1.20 trunk findet ihr nun einen neuen Ordnerbaum, wobei wir nach den mips-tuxbox Varianten schauen. Je nach eurem Image whlt ihr OE1.6 oder OE2.0. Auch die alten Boxen blieben mit powerpc-tuxbox nicht auen vor.
Der Auswahl nicht genug findet ihr nach der von euch bevorzugten Variante nun eine Reihe von Builds mit der gleichen Nummer. Auch hier msst ihr nun nochmals entscheiden, was fr eure Belange wichtig ist. Wer keine exotischen Karten am Start hat, kann getrost zur webif-light Variante greifen, die alle Parameter fr die gngigen verwendeten Karten enthlt. Wer mehrere Karten am Start hat und dazu mittels USB Kartenleser an die Box angeschlossen hat, greift zur Version webif- libusb.
Nicht wundern, wenn an manchen Tagen gleich mehrere Builds erscheinen. Das liegt daran, dass jeder auch noch so kleiner verbesserter Bug mit einem neuen Build belohnt wird.
Habt ihr eure Version gefunden, so msst ihr diese in oscam_1.20 umbenennen. Nun stellt ihr ber das FTP-Programm Kontakt zu der Dreambox her.
Auf der Dreambox msst ihr die alte Version von Oscam lschen. Diese findet ihr in den meisten Fllen unter /usr/bin bzw. /etc/bin. Die alte Version hat ebenfalls den Namen oscam_1.20 und MUSS gelscht werden, ein reines Ersetzen der Datei reicht in der Regel nicht aus. Die Konfigurations- Dateien brauchen NICHT mit gelscht und knnen einfach auf der Box belassen werden.
Nach dem Lschen spielt ihr die neue Version, die ihr ja zuvor umbenannt habt, wieder auf die Dreambox in den gleichen Ordner, in dem sich auch die Vorversion befand, auf. Nun mssen noch die Attribute der neuen Version auf 755 gesetzt werden. Dies ist mittels eines Rechtsklicks auf oscam_1.20 mglich.
Seite 14 von 14
Ist dies erledigt, msst ihr nur noch Oscam neu starten und schon habt ihr das aktuelle Build am Laufen.
9. Schlusswort Ich hoffe, die Beschreibung hat euch beim Installieren und Konfigurieren von Oscam geholfen. Natrlich werden immer wieder mal Fragen zu dem Thema auftauchen, wofr ihr aber im Nachtfalke-Forum einen entsprechenden Platz zur Problemlsung finden werdet. Nun aber viel Spa beim Probieren und Installieren.