Smart-Card-Lesegeräte für CCcam& OScam: Setup-Guide 2026

Wenn du mit einemSmart-Card-Lesegerätcccam oscam 2026 Setup arbeitest, bist du wahrscheinlich schon auf mindestens eine von drei Hürden gestoßen: Das OS erkennt das Lesegerät nicht, OScam erkennt das Lesegerät, kann die Karte aber nicht initialisieren, oder die Karte initialisiert sich und dann schlägt die ECM-Dekodierung mit kryptischen Fehlern fehl. Dieser Guide behandelt alle drei, der Reihe nach.

Gehe davon aus, dass dein CCcam oderOScam Binary bereits installiert ist. Der Fokus liegt hier auf der Hardware-Identifikation, dem Kernel-Level-Treiber-Setup und dem Schreiben korrekter Reader-Blöcke in oscam.server — der Teil, den die meisten Guides überspringen oder falsch machen.

Smart-Card-Lesegerät-Hardware kompatibel mit CCcam und OScam

Es gibt drei Protokollfamilien, mit denen CCcam und OScam kommunizieren können. Welche du verwendest, hängt von deiner Hardware ab. Einen Fehler auf Hardware-Ebene zu machen bedeutet, dass nichts in der Konfiguration dich retten wird.

PC/SC vs. Phoenix vs. SmartReader-Modi erklärt

PC/SC (protocol = pcsc) läuft über den Linux pcscd-Daemon und den libccid-Treiber-Stack. Das Lesegerät erscheint dem OS als Smart-Card-Terminal. OScam adressiert es über den Slot-Index — die Nummer, die du in der pcsc_scan-Ausgabe siehst. ACS ACR38U-I1 und ACR39U dominieren diese Kategorie und werden seit 2026 gut unter pcscd unterstützt.

Phoenix-Modus (protocol = mouse) ist ein serielles Protokoll. Das Lesegerät verbindet sich über FTDI oder ähnliche USB-zu-Seriell-Adapter und erscheint als /dev/ttyUSB0 oder ähnliches. Der Name "mouse" stammt aus alter Terminologie, bedeutet aber Phoenix-Signalisierung: Das Lesegerät treibt die Karte über einen direkten seriellen Takt bei typischerweise 3,57 MHz oder 6,00 MHz an. Argolis- und Smargo-Klone sind in diesem Modus nach wie vor die zuverlässigste Option für CCcam-ähnliche Arbeiten.

SmartReader+-Modus (protocol = smartreader) umgeht den FTDI-Kerneltreiber vollständig und kommuniziert direkt über libusb mit dem USB-Chip. Die Adressierung erfolgt über bus:device aus lsusb — etwa 001:004. Dies ermöglicht eine präzisere Timing-Kontrolle, was bei Karten wichtig ist, die höhere Taktfrequenzen benötigen.

Gängige Chipsätze, die funktionieren

Auf der PC/SC-Seite: Infineon SLE 9635, OmniKey 3021/6121, ACS ACR38U-I1, ACS ACR39U. Diese haben alle libccid-Einträge und funktionieren unter Debian 12 und Raspberry Pi OS (bookworm) sofort. Der ACS ACR38U-I1 ist insbesondere seit Jahren der Standard für diesen Anwendungsfall.

Für Phoenix- und SmartReader+-Modi: FTDI FT232RL-basierte Lesegeräte bei 3,579 MHz und 3,68 MHz haben die längste Erfolgsbilanz. Phoenix-Marken-Lesegeräte mit 6,00 MHz sind die erste Wahl für Karten, die schnellere Taktfrequenzen benötigen. Argolis-Marken-Hardware und Smargo-Klone, die auf denselben FTDI-Chips basieren, funktionieren gut unter OScams smartreader-Protokoll.

Warum billige eBay-Lesegeräte bei neueren Karten versagen

Das Problem ist meist die Kristallfrequenz. Ein generisches eBay-Lesegerät, das mit einem 3,57-MHz-Kristall gelötet wurde, kann keine Karte betreiben, die 6,00 MHz oder 8,00 MHz benötigt. Einige Lesegeräte werben mit "6 MHz", werden aber mit einem 3,579-MHz-Oszillator geliefert — messe es nach oder kaufe bei einem bekannten Anbieter. Ein weiterer häufiger Fehler ist die Spannung: ISO 7816-Karten laufen bei 3V oder 5V, und günstigere Lesegeräte verhandeln das nicht korrekt, was dazu führt, dass die Karte wiederholt zurückgesetzt wird, ohne jemals ein sauberes ATR zu produzieren.

USB vs. Seriell (DB9)-Lesegeräte in 2026

Alte DB9-Seriell-Lesegeräte über echte RS-232-Ports sind bei moderner Hardware im Wesentlichen verschwunden. Wenn du eines hast, betreibst du es über einen USB-zu-Seriell-Adapter. Das fügt eine Ebene an Treiberkomplexität hinzu — besonders rund um die DTR/RTS-Leitungssteuerung. Einige Adapter setzen DTR nicht korrekt durch, was die Kartenaktivierung für Phoenix-Modus-Lesegeräte unterbricht. CH340G-basierte Adapter haben hier bekannte Probleme; FTDI FT232RL-Adapter sind für diesen Anwendungsfall besser geeignet. USB-native Lesegeräte (PC/SC und SmartReader+) umgehen all das.

Treiber- und OS-Level-Setup (Linux, Debian/Ubuntu, Raspberry Pi OS)

Dieser Abschnitt setzt Debian 12 oder Raspberry Pi OS bookworm voraus. Die Paketnamen sind auf Ubuntu LTS identisch. Das Verhalten von Kernel 6.x hat einige Dinge rund um das Laden des FTDI-Moduls verändert — dazu mehr weiter unten.

Installation von pcscd, libccid, libusb-1.0-0

apt install pcscd pcsc-tools libccid libusb-1.0-0-dev

Damit erhalten Sie den PC/SC-Daemon, den CCID-Treiber für USB-Lesegeräte, die pcsc-tools-Testdienstprogramme und die libusb-Header, die benötigt werden, wenn Sie OScam mit SmartReader+-Unterstützung kompilieren. Unter Raspberry Pi OS ebenfalls installieren:

apt install libpcsclite-dev

Erkennung überprüfen mit lsusb, pcsc_scan, dmesg

Stecken Sie das Lesegerät ein und führen Sie auslsusb zuerst. Sie sollten etwas Ähnliches sehen:

Bus 001 Device 004: ID 072f:b100 Advanced Card Systems, Ltd ACR38 SmartCard Reader

Wenn Sie das Gerät in lsusb sehen, aber nicht inpcsc_scan, läuft pcscd wahrscheinlich nicht. Starten Sie es:systemctl start pcscd. Eine funktionierende pcsc_scan-Ausgabe sieht folgendermaßen aus:

Scanning present readers...

Kein ATR bedeutet, dass die Karte nicht richtig sitzt oder die Taktrate falsch ist. Ein „card state: Card not inserted" bei physisch eingelegter Karte bedeutet in der Regel ein defektes Lesegerät oder invertierte Erkennungslogik (siehedetect = !cd im OScam-Abschnitt).

udev-Regeln für Nicht-Root-Zugriff

Erstellen Sie/etc/udev/rules.d/99-smartreader.rules:

# FTDI SmartReader/Phoenix

Dann neu laden:udevadm control --reload-rules&& udevadm trigger

FTDI ftdi_sio Modulkonflikte

Dies ist der häufigste Grund, warum der SmartReader+-Modus unter Kernel 6.x nicht funktioniert. Wenn Sie ein FTDI-basiertes Lesegerät anschließen, lädt der Kernel automatisch ftdi_sio und belegt das Gerät als /dev/ttyUSB0. Das SmartReader+-Protokoll von OScam benötigt direkten libusb-Zugriff und kann diesen nicht erhalten, solange ftdi_sio das Gerät belegt.

Entladen Sie die Module vor dem Start von OScam:

rmmod ftdi_sio usbserial

Um dies dauerhaft zu machen, setzen Sie die Module auf die Blacklist:

echo "blacklist ftdi_sio">> /etc/modprobe.d/oscam-smartreader.conf>> /etc/modprobe.d/oscam-smartreader.conf

Hinweis: Das Blacklisten von ftdi_sio bedeutet, dass für dieses Gerät kein /dev/ttyUSB0 erscheint. Der Phoenix-Modus (der /dev/ttyUSB0 verwendet) funktioniert nach dem Blacklisten nicht mehr. Wählen Sie eine Option: Phoenix-Modus mit geladenem ftdi_sio, oder SmartReader+-Modus mit auf die Blacklist gesetztem ftdi_sio.

Berechtigungen: Den OScam-Benutzer zu dialout/plugdev hinzufügen

usermod -aG dialout,plugdev oscam

Und für die pcscd-Reihenfolge bei Verwendung von PC/SC — fügen Sie dies zu Ihrer OScam systemd-Unit hinzu:

[Unit]

OScam-Reader-Konfiguration: oscam.server Beispiele

Hier sind drei vollständige Reader-Blöcke, die Sie kopieren, einfügen und anpassen können. Dies sind die Konfigurationen, die die meisten Anleitungen entweder vollständig überspringen oder in unvollständiger Form zeigen — alle drei Protokolle an einem Ort richtig zu konfigurieren ist das, was ein funktionierendesSmartcard-Lesegerätcccam oscam 2026 Setup von einem unterscheidet, an dem Sie noch eine Woche später debuggen.

Phoenix/Mouse-Modus Reader-Block

[reader]

mhz = 600 bedeutet, dass der Reader mit 6,00 MHz betrieben wird.cardmhz = 357 teilt OScam mit, dass die Karte selbst 3,57 MHz erwartet — der Reader übertaktet und OScam übernimmt die Timing-Kompensation. Für eine Karte, die nativ mit 6 MHz läuft, setzen Siecardmhz = 600.

SmartReader+-Modus Reader-Block

[reader]

Der device-Wert ist bus:device aus lsusb. Führen Sielsusb aus und finden Sie Ihren Smargo/Argolis-Reader — verwenden Sie genau diese Nummern. Sie können sich nach einem Neustart ändern, wenn Sie mehrere USB-Geräte haben; mehr dazu im Abschnitt zu Sonderfällen.

PC/SC-Modus Reader-Block

[reader]

Der Gerätewert hier ist der Slot-Index aus der pcsc_scan-Ausgabe (0-indiziert). Wenn Sie ein Lesegerät haben, ist es 0. pcscd muss laufen, bevor OScam startet.

Schlüsselfelder: device, mhz, cardmhz, protocol, detect, group, caid

mhz ist die Oszillatorfrequenz des Lesegeräts in Zehntel-MHz (600 = 6,00 MHz).cardmhz ist der Takt, den die Karte erwartet. Eine Abweichung zwischen diesen beiden ist die häufigste Ursache für „card initializing failed" — der ATR selbst wird beschädigt, weil das Timing falsch ist.

detect = cd verwendet den Hardware-Kartenerkennungspin. Einige Clone-Lesegeräte haben diesen invertiert — wenn OScam „card removed" meldet, obwohl eine Karte eingesteckt ist, ändern Sie es zudetect = !cd.group verknüpft das Lesegerät mit bestimmten Benutzergruppen oder CCcam-Freigaben.caid begrenzt, welche Conditional-Access-Systeme dieses Lesegerät zu verarbeiten versucht.

Boxkey-, RSA- und Constant-CW-Zeilen

Einige Karten benötigen einen Boxkey oder RSA-Schlüssel zur Authentifizierung, bevor sie auf ECM reagieren. Diese gehören in den Reader-Block:

boxkey = 0102030405060708

Karten mit nicht standardmäßigem ATR, den OScam nicht automatisch erkennen kann, benötigen möglicherweise manuelle CAID- und Boxkey-Einträge. Wenn pcsc_scan den ATR anzeigt, OScam ihn aber dennoch nicht dekodieren kann, überprüfen Sie die OScam-Kartendatenbank und fügen Sie die expliziten Parameter hinzu. Der ATR-Wert aus pcsc_scan ist Ihre Referenz — raten Sie nicht.

CCcam-Konfiguration für lokale Kartenlesegeräte (CCcam.cfg)

Wenn Sie das CCcam-Binary direkt ausführen, sieht die Lesegerät-Syntax in /etc/CCcam.cfg folgendermaßen aus:

SERIAL READER : /dev/ttyUSB0 ; Phoenix ; 600 ; ; ;

Felder sind: Gerätepfad, Protokolltyp (Phoenix oder Mouse), Frequenz in Zehntel-MHz, optionaler RSA-Schlüssel, optionaler Boxkey.

SERIAL READER- und PHOENIX_READER-Zeilen

CCcam unterscheidet zwischen seriellen Lesegeräten anhand des Gerätepfads. Wenn Ihr Lesegerät als /dev/ttyUSB1 erscheint, verwenden Sie diesen. Für Phoenix-Lesegeräte speziell:

PHOENIX READER : /dev/ttyUSB0 ; Phoenix ; 357 ; ; ;

Die Frequenz ist hier aus demselben Grund wichtig wie in OScam — falsche Frequenz bedeutet kein ATR.

DEVICE/CAID/IDENT/RSA-Felder

Sie können ein CCcam-Lesegerät auf bestimmte CAIDs und Anbieter-Identifikatoren beschränken:

SERIAL READER : /dev/ttyUSB0 ; Phoenix ; 600 ; ; ; 0604:000000

Das nachgestellte CAID:ident-Paar begrenzt, was CCcam über dieses Lesegerät zu dekodieren versucht.

Warum die meisten modernen Setups CCcam über OScam weiterleiten

Das CCcam-Binary hat seit Jahren keine nennenswerte Weiterentwicklung erfahren. OScam wird aktiv gepflegt, unterstützt mehr Kartentypen und liefert detailliertes Logging, das CCcam nicht bietet. Im Jahr 2026 ist der Standardansatz, dass OScam den physischen Reader verwaltet und seine Karten über das CCcam-Protokoll auf einem lokalen Port bereitstellt. Alle CCcam-Clients verbinden sich mit diesem Port, anstatt direkt mit dem Reader zu kommunizieren.

OScam (Reader) + CCcam (Sharing-Protokoll) auf derselben Box kombinieren

In /etc/oscam/oscam.conf einen [cccam]-Abschnitt hinzufügen:

[cccam]

Dann im Reader-Block in oscam.server sicherstellen, dassgroup = 1 gesetzt ist, und in oscam.user werden Ihre CCcam-Clients der Gruppe 1 zugewiesen. OScam verwaltet die Karte, und CCcam-Clients verbinden sich mit Port 12000. CCcam-Binary optional.

Fehlerbehebung: Karte erkannt, aber keine Entschlüsselung

Der ATR (Answer To Reset) ist Ihr diagnostischer Ausgangspunkt. Jedes Problem lässt sich entweder auf das korrekte Lesen oder die korrekte Interpretation des ATR zurückführen.

Den ATR lesen und dem Kartentyp zuordnen

OScam-Debug-Logging für Reader-Operationen aktivieren. Zu oscam.conf hinzufügen:

[global]

Debug-Level 64 ist Reader-spezifisches Logging. Level 4 fügt ATR-Parsing hinzu. Beide zusammen ausführen (setzen Siedebuglevel = 68) zeigt Ihnen den rohen ATR und wie OScam ihn interpretiert.

ATR3F FF 95 00 FF 91 81... ist Irdeto. ATR beginnend mit3B 78 13 ist typischerweise Conax. Wenn Ihr ATR beschädigt aussieht — falsche Länge, verschobene Bytes — ist das ein Taktfrequenzfehler. Zuerstmhz/cardmhz korrigieren, dann erneut einlesen.

ECM-Fehler: 'card not inserted', 'rejected', 'no matching reader'

„Card not inserted" von OScam, obwohl die Karte eingesteckt ist, bedeutet fast immer, dass das Erkennungssignal falsch ist. Versuchen Siedetect = !cd. „Rejected" bedeutet, dass die Karte auf das ECM geantwortet hat, aber einen Fehler zurückgegeben hat — entweder CAID/Provider-Diskrepanz oder die Karte verfügt nicht über die erforderlichen Berechtigungen. „No matching reader" bedeutet, dass Ihre Gruppe oder Ihr CAID-Filter im Reader-Block nicht mit dem übereinstimmt, was das ECM anfordert.

Taktfrequenzfehler und Irdeto-Rateversuche

Irdeto-Karten reagieren besonders empfindlich auf die Taktfrequenz. OScam hat einen Ratemechanismus für Irdeto, bei dem es mehrere Taktgeschwindigkeiten ausprobiert, wenn der ATR nicht sauber dekodiert wird. Das ist langsam und unzuverlässig. Setzemhz undcardmhz explizit basierend auf der Kristallfrequenz deines Lesers. Wenn du die Kristallfrequenz nicht kennst, überprüfe die Hardware — sie ist normalerweise auf der Platine beschriftet.

T=0 vs T=14 Protokollauswahl

ISO 7816 definiert Übertragungsprotokolle T=0 (byteorientiert) und T=1 (blockorientiert). Einige Karten verwenden ein nicht standardmäßiges T=14-Protokoll. OScam verhandelt normalerweise automatisch basierend auf dem ATR, aber wenn du „Protokollaushandlung fehlgeschlagen" in den Logs siehst, musst du es möglicherweise manuell erzwingen. Überprüfe die OScam-Dokumentation für die CAID deiner Karte, um den richtigen Protokollparameter zu finden.

Log-Level: cs_log Debug-Masken für Reader-only-Ausgabe

Ausführen von-d 255 protokolliert alles, was das Log überflutet. Für das Debuggen nur des Readers:debuglevel = 64 für Reader-Ereignisse, addiere 4 für ATR-Parsing, addiere 8 für ECM-Dekodierung. Alsodebuglevel = 76 gibt dir eine fokussierte Reader-Ausgabe, ohne jede Client-Verbindung zu protokollieren. Die Log-Datei unter /var/log/oscam/oscam.log ist dein primäres Diagnosewerkzeug — lies sie Zeile für Zeile, wenn etwas nicht funktioniert.

Leistung, Stabilität und Langzeitbetrieb

Einesmart card reader cccam oscam 2026 Box, die eine Stunde lang funktioniert, aber über Nacht ausfällt, hat ein anderes Problem als eine, die überhaupt nicht funktioniert. Die meisten Stabilitätsprobleme lassen sich auf die Stromversorgung zurückführen, nicht auf die Software.

Warum USB-Hubs und lange Kabel das Smart-Card-Timing stören

Das ISO 7816-Timing ist präzise. Das Kartentaktsignal muss sauber und stabil sein — Spannungsabfall durch einen ungespeisten Hub oder ein 2-Meter-USB-Kabel erzeugt Rauschen, das zu Resets mitten im ECM führt. Die Kartenlogs zeigen „Kartenverbindung getrennt" oder „Karten-Reset", obwohl die Karte physisch eingesteckt ist. Das ist ein Hardwareproblem, das keine Konfigurationsänderung beheben kann.

Aktive Hubs vs. direkte Ports am Raspberry Pi 4/5

Raspberry Pi 4 und 5 teilen sich das Leistungsbudget über USB-Ports. Unter Last (gleichzeitiger Betrieb von OScam, Netzwerk, Speicher) sinkt die USB-Stromschiene genug, um Symptome der Kartenverbindungsunterbrechung zu verursachen. Ein aktiver USB-2.0-Hub — kein USB 3.0, das zusätzliches Schaltgeräusch erzeugt — zwischen dem Pi und dem Leser löst das Problem. Verwende keine billigen No-Name-Hubs. Ein Anker oder ein ähnlich qualitativ hochwertiger Marken-Hub mit 5V/2A ist ausreichend.

Watchdog und automatischer Neustart für den Reader-Prozess

Füge eine Watchdog-Unit unter /etc/systemd/system/oscam-watchdog.service hinzu:

[Unit]

Das ist simpel, funktioniert aber. Eine ordnungsgemäße Implementierung überwacht aufeinanderfolgende „Reader idle"-Ereignisse statt jedes Vorkommen, aber für einen 24/7-Betrieb verhindert dies stundenlange Totzeiten.

Hitze, Unterspannung und Symptome der Kartenverbindungsunterbrechung

Auf einem Pi 4/5 prüfe das Throttling:vcgencmd get_throttled. Ein Wert ungleich null bedeutet, dass der Pi thermische Grenzen oder Unterspannungsgrenzen erreicht hat und die Taktfrequenz gedrosselt wurde. Dies äußert sich als Lesegerät-Timeouts. Verwende einen geeigneten Kühlkörper und ein 5V/3A-Netzteil (nicht 5V/2A für Pi 4). Das offizielle Pi 5-Netzteil ist 5,1V/5A — verwende es.

Backup von Karten-EMM-Updates

EMM (Entitlement Management Messages) sind die Methode, mit der der Anbieter die Abonnementberechtigungen deiner Karte aktualisiert. OScam verarbeitet diese automatisch mitemu_auprovid und verwandten Einstellungen. Schlechte Stromversorgung während eines EMM-Schreibvorgangs kann die Karte beschädigen. Wenn du rund um die Uhr auf einem Pi ohne USV läufst, erwäge einen LiPo-USV-Hat — sie kosten etwa 15–20 € und bieten genug Laufzeit, um einen kurzen Stromausfall ohne Unterbrechung mitten in einem EMM-Schreibvorgang zu überstehen.

Bei Karten, die EMM-Updates innerhalb eines Zeitfensters benötigen, da sie sonst aus dem System des Anbieters desynchronisiert werden, aktiviere die Auto-Update-Flags im Reader-Block und stelle sicher, dass die Box während des Update-Fensters des Anbieters online ist (normalerweise zwischen Mitternacht und 6 Uhr morgens Ortszeit für die meisten europäischen Anbieter).

Wichtige Sonderfälle

Mehrere Lesegeräte an einer Box benötigen eindeutige Labels und stabile Gerätepfade. Bus:Gerät-Adressen von lsusb ändern sich nach einem Neustart, wenn Geräte in einer anderen Reihenfolge aufgelistet werden. Verwende udev-Symlinks, um stabile Pfade zu erstellen:

SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{serial}=="A1B2C3D4", SYMLINK+="smartreader_1"

Verweise dann auf/dev/smartreader_1 in oscam.server. Das Serienattribut stammt vonudevadm info -a -n /dev/ttyUSB0 | grep serial.

Zusammengesetzte USB-Geräte (Lesegeräte, die als zwei USB-Schnittstellen aufgelistet werden) veranlassen OScam, die falsche Schnittstelle auszuwählen. Prüfelsusb -v um zu sehen, welche Schnittstelle den Smart-Card-Endpunkt hat, und gib sie explizit in deinem Gerätepfad an.

Die Race-Condition beim Boot eines headless Servers — pcscd startet, bevor die USB-Auflistung abgeschlossen ist — wird mit einer systemd-Verzögerung oder einem udev-ausgelösten Start behoben. In /etc/systemd/system/pcscd.service.d/override.conf:

[Service]

Hässlich, aber effektiv. Die eigentliche Lösung ist eine udev-Trigger-Regel, die pcscd erst dann startet, wenn das Lesegerät auf dem Bus erscheint.

Falsch eingelegte Karten (verkehrt herum) liefern keinen ATR oder einen beschädigten. Das Lesegerät gibt keinen eindeutigen Fehler aus — es liest einfach nicht. Einige Lesegeräte haben eine Führungskerbe, die dies verhindert; günstigere nicht. Abgenutzte Kontakte führen zu sporadischen ATR-Lesungen: Die Karte initialisiert sich manchmal und manchmal nicht. Wenn ATR in den Logs erscheint und verschwindet, ohne dass die Karte entfernt wird, reinige die Kontakte mit Isopropylalkohol auf einem Wattestäbchen.

Ein stabilessmart card reader cccam oscam 2026 Setup von Ende zu Ende einzurichten erfordert das schrittweise Durcharbeiten der Hardware-, Kernel- und Konfigurations-Schichten. Überspringst du eine Schicht, debuggst du das Falsche. Das ATR ist das Wahrheitssignal — ist es sauber, liegen die meisten anderen Probleme in der Konfiguration. Ist es korrumpiert oder fehlt es ganz, gehe zurück zu Hardware und Treibern.