Czytniki kart inteligentnych dla CCcam& OScam: Przewodnik konfiguracji 2026

Jeśli pracujesz zczytnikiem kart inteligentnychcccam oscam 2026 konfiguracją, prawdopodobnie napotkałeś przynajmniej jedną z trzech przeszkód: system operacyjny nie widzi czytnika, OScam widzi czytnik, ale nie może zainicjować karty, lub karta się inicjuje, a następnie dekodowanie ECM kończy się niejasnymi błędami. Ten przewodnik obejmuje wszystkie trzy, w kolejności.

Zakładając, że twój CCcam lubOScam binarka jest już zainstalowana. Skupiamy się tutaj na identyfikacji sprzętu, konfiguracji sterowników na poziomie jądra oraz pisaniu poprawnych bloków czytnika w oscam.server — części, którą większość przewodników pomija lub robi źle.

Sprzęt czytnika kart inteligentnych kompatybilny z CCcam i OScam

Istnieją trzy rodziny protokołów, z którymi mogą komunikować się CCcam i OScam. Którego użyjesz, zależy od twojego sprzętu. Błędne określenie tego na poziomie sprzętu oznacza, że nic w konfiguracji cię nie uratuje.

Wyjaśnienie trybów PC/SC, Phoenix i SmartReader

PC/SC (protokół = pcsc) przechodzi przez demona Linux pcscd i stos sterowników libccid. Czytnik pojawia się jako terminal karty inteligentnej dla systemu operacyjnego. OScam odnosi się do niego za pomocą indeksu slotu — numeru, który widzisz w wyjściu pcsc_scan. ACS ACR38U-I1 i ACR39U dominują w tej kategorii i są dobrze wspierane pod pcscd od 2026 roku.

Tryb Phoenix (protokół = mouse) jest protokołem szeregowym. Czytnik łączy się przez FTDI lub podobny USB-do-szeregowego i pojawia się jako /dev/ttyUSB0 lub podobny. Nazwa "mouse" pochodzi ze starej terminologii, ale oznacza sygnalizację Phoenix: czytnik napędza kartę za pomocą bezpośredniego zegara szeregowego, zazwyczaj 3,57 MHz lub 6,00 MHz. Klony Argolis i Smargo w tym trybie są nadal najbardziej niezawodną opcją do pracy w stylu CCcam.

Tryb SmartReader+ (protokół = smartreader) całkowicie omija sterownik jądra FTDI i komunikuje się bezpośrednio z chipem USB za pomocą libusb. Adresowanie to bus:device z lsusb — coś w stylu 001:004. Daje to lepszą kontrolę czasową, co ma znaczenie dla kart wymagających wyższych częstotliwości zegara.

Typowe układy scalone, które działają

Po stronie PC/SC: Infineon SLE 9635, OmniKey 3021/6121, ACS ACR38U-I1, ACS ACR39U. Wszystkie te urządzenia mają wpisy libccid i działają od razu na Debianie 12 i Raspberry Pi OS (bookworm). Szczególnie ACS ACR38U-I1 od lat jest standardem dla tego przypadku użycia.

Dla trybów Phoenix i SmartReader+: czytniki oparte na FTDI FT232RL działające na 3,579 MHz i 3,68 MHz mają najdłuższy okres użytkowania. Czytniki marki Phoenix działające na 6,00 MHz są preferowane dla kart, które potrzebują szybszych prędkości zegara. Sprzęt marki Argolis i klony Smargo zbudowane na tych samych chipach FTDI dobrze działają pod protokołem smartreader OScam.

Dlaczego tanie czytniki z eBay zawodzą z nowszymi kartami

Problem zazwyczaj dotyczy częstotliwości kryształu. Ogólny czytnik z eBay, lutowany z kryształem 3,57 MHz, nie może obsługiwać karty, która potrzebuje 6,00 MHz lub 8,00 MHz. Niektóre czytniki reklamują się jako "6 MHz", ale wysyłane są z oscylatorem 3,579 MHz — zmierz to lub kup od znanego dostawcy. Inną powszechną przyczyną awarii jest napięcie: karty ISO 7816 działają na 3V lub 5V, a tańsze czytniki nie negocjują poprawnie, co powoduje, że karta resetuje się wielokrotnie, nie produkując nigdy czystego ATR.

Czytniki USB vs szeregowe (DB9) w 2026 roku

Stare czytniki szeregowe DB9 przez prawdziwe porty RS-232 praktycznie zniknęły z nowoczesnego sprzętu. Jeśli masz jeden, uruchamiasz go przez adapter USB-do-szeregowego. To dodaje warstwę złożoności sterowników — szczególnie w zakresie obsługi linii DTR/RTS. Niektóre adaptery nie aktywują DTR poprawnie, co psuje aktywację karty dla czytników w trybie Phoenix. Adaptery oparte na CH340G mają znane problemy w tej kwestii; adaptery FTDI FT232RL są lepsze dla tego przypadku użycia. Czytniki natywne USB (PC/SC i SmartReader+) pomijają to wszystko.

Konfiguracja sterownika i poziomu systemu operacyjnego (Linux, Debian/Ubuntu, Raspberry Pi OS)

Ta sekcja zakłada Debian 12 lub Raspberry Pi OS bookworm. Nazwy pakietów są takie same w Ubuntu LTS. Zachowanie jądra 6.x zmieniło kilka rzeczy w zakresie ładowania modułów FTDI — więcej na ten temat poniżej.

Instalacja pcscd, libccid, libusb-1.0-0

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

To zapewnia ci demona PC/SC, sterownik CCID dla czytników USB, narzędzia testowe pcsc-tools oraz nagłówki libusb potrzebne, jeśli kompilujesz OScam z obsługą SmartReader+. Na Raspberry Pi OS zainstaluj również:

apt install libpcsclite-dev

Weryfikacja wykrywania za pomocą lsusb, pcsc_scan, dmesg

Podłącz czytnik i uruchomlsusb najpierw. Powinieneś zobaczyć coś takiego:

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

Jeśli widzisz urządzenie w lsusb, ale nie wpcsc_scan, prawdopodobnie pcscd nie działa. Uruchom go:systemctl start pcscd. Działający wynik pcsc_scan wygląda jak:

Skanowanie dostępnych czytników...

Brak ATR oznacza, że karta nie jest poprawnie włożona lub zegar jest nieprawidłowy. "Stan karty: Karta nie włożona" przy fizycznie obecnej karcie zazwyczaj oznacza uszkodzony czytnik lub odwróconą logikę detekcji (zobaczdetect = !cd w sekcji OScam).

Reguły udev dla dostępu bez uprawnień roota

Utwórz/etc/udev/rules.d/99-smartreader.rules:

# FTDI SmartReader/Phoenix

Następnie przeładuj:udevadm control --reload-rules&& udevadm trigger

Konflikty modułu FTDI ftdi_sio

To najczęstszy powód, dla którego tryb SmartReader+ nie działa w jądrze 6.x. Gdy podłączysz czytnik oparty na FTDI, jądro automatycznie ładuje ftdi_sio i przejmuje urządzenie jako /dev/ttyUSB0. Protokół SmartReader+ OScam wymaga dostępu libusb-direct i nie może go uzyskać, gdy ftdi_sio trzyma urządzenie.

Odładuj moduły przed uruchomieniem OScam:

rmmod ftdi_sio usbserial

Aby to było trwałe, dodaj moduły do czarnej listy:

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

Uwaga: dodanie ftdi_sio do czarnej listy oznacza, że żadne /dev/ttyUSB0 nie pojawi się dla tego urządzenia. Tryb Phoenix (który używa /dev/ttyUSB0) nie będzie działał po dodaniu do czarnej listy. Wybierz jedno: tryb Phoenix z załadowanym ftdi_sio lub tryb SmartReader+ z dodanym do czarnej listy.

Uprawnienia: Dodanie użytkownika OScam do dialout/plugdev

usermod -aG dialout,plugdev oscam

A dla kolejności pcscd przy użyciu PC/SC — dodaj to do swojej jednostki systemd OScam:

[Unit]

Konfiguracja czytnika OScam: Przykłady oscam.server

Oto trzy kompletne bloki czytników, które możesz skopiować i dostosować. To są konfiguracje, które większość przewodników pomija całkowicie lub pokazuje w niekompletnej formie — uzyskanie wszystkich trzech protokołów w jednym miejscu to to, co odróżnia działającyczytnik kart smartcccam oscam 2026 konfiguracja od tej, którą wciąż debugujesz tydzień później.

Blok czytnika w trybie Phoenix/Mysz

[reader]

mhz = 600 oznacza, że czytnik działa z częstotliwością 6.00 MHz.cardmhz = 357 informuje OScam, że karta sama oczekuje 3,57 MHz — czytnik podkręca, a OScam zajmuje się kompensacją czasową. Dla karty, która działa natywnie przy 6 MHz, ustawcardmhz = 600.

Blok czytnika w trybie SmartReader+

[reader]

Wartość urządzenia to bus:device z lsusb. Uruchomlsusb i znajdź swój czytnik Smargo/Argolis — użyj tych dokładnych numerów. Mogą się zmienić po ponownym uruchomieniu, jeśli masz wiele urządzeń USB; więcej na ten temat w sekcji przypadków brzegowych.

Blok czytnika w trybie PC/SC

[reader]

Wartość urządzenia tutaj to indeks slotu z wyjścia pcsc_scan (indeksowane od 0). Jeśli masz jeden czytnik, to 0. pcscd musi działać przed uruchomieniem OScam.

Kluczowe pola: device, mhz, cardmhz, protocol, detect, group, caid

mhz to częstotliwość oscylatora czytnika w dziesiątych częściach MHz (600 = 6,00 MHz).cardmhz to zegar, którego oczekuje karta. Niezgodność między tymi dwoma jest najczęstszą przyczyną "nie udało się zainicjować karty" — ATR sam w sobie ulega uszkodzeniu, ponieważ czas jest nieprawidłowy.

detect = cd używa sprzętowego pinu wykrywania karty. Niektóre czytniki klonów mają to odwrócone — jeśli OScam zgłasza "karta usunięta", gdy karta jest włożona, zmień nadetect = !cd.group łączy czytnik z określonymi grupami użytkowników lub udostępnieniami CCcam.caid ogranicza, które systemy dostępu warunkowego ten czytnik będzie próbował obsługiwać.

Linie Boxkey, RSA i Constant CW

Niektóre karty wymagają boxkey lub klucza RSA do uwierzytelnienia, zanim odpowiedzą na ECM. Te wpisy są w bloku czytnika:

boxkey = 0102030405060708

Karty z niestandardowym ATR, które OScam nie może automatycznie wykryć, mogą wymagać ręcznych wpisów CAID i boxkey. Jeśli pcsc_scan pokazuje ATR, ale OScam nadal nie może zdekodować, sprawdź bazę danych kart OScam i dodaj jawne parametry. Wartość ATR z pcsc_scan jest twoim odniesieniem — nie zgaduj.

Konfiguracja CCcam dla lokalnych czytników kart (CCcam.cfg)

Jeśli uruchamiasz binarkę CCcam bezpośrednio, składnia czytnika w /etc/CCcam.cfg wygląda następująco:

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

Pola to: ścieżka urządzenia, typ protokołu (Phoenix lub Mouse), częstotliwość w dziesiątych częściach MHz, opcjonalny klucz RSA, opcjonalny boxkey.

Linie SERIAL READER i PHOENIX_READER

CCcam rozróżnia czytniki szeregowe według ścieżki urządzenia. Jeśli twój czytnik pojawia się jako /dev/ttyUSB1, użyj tego. Dla czytników Phoenix szczególnie:

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

Częstotliwość tutaj ma znaczenie z tego samego powodu, co w OScam — błędna częstotliwość oznacza brak ATR.

Pola DEVICE/CAID/IDENT/RSA

Możesz ograniczyć czytnik CCcam do określonych CAID i identyfikatorów dostawcy:

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

Para CAID:ident ogranicza to, co CCcam próbuje dekodować przez ten czytnik.

Dlaczego większość nowoczesnych konfiguracji używa CCcam przez OScam zamiast bezpośrednio

Binarna wersja CCcam nie była znacząco rozwijana od lat. OScam jest aktywnie utrzymywany, obsługuje więcej typów kart i daje szczegółowe logi, których CCcam nie ma. W 2026 roku standardowe podejście to OScam, który posiada fizyczny czytnik i udostępnia swoje karty przez protokół CCcam na lokalnym porcie. Klienci CCcam łączą się z tym portem zamiast rozmawiać bezpośrednio z czytnikiem.

Łączenie OScam (Czytnik) + CCcam (Protokół udostępniania) na tym samym urządzeniu

W /etc/oscam/oscam.conf dodaj sekcję [cccam]:

[cccam]

Następnie w bloku czytnika w oscam.server upewnij się, żegroup = 1jest ustawione, a w oscam.user twoi klienci CCcam są przypisani do grupy 1. OScam obsługuje kartę, a klienci CCcam łączą się z portem 12000. Binarna wersja CCcam jest opcjonalna.

Rozwiązywanie problemów: Karta wykryta, ale nie dekoduje

ATR (Odpowiedź na reset) to twój punkt wyjścia do diagnostyki. Każdy problem sprowadza się do poprawnego odczytu ATR lub jego poprawnej interpretacji.

Odczyt ATR i dopasowanie go do typu karty

Włącz logowanie debugowania OScam dla operacji czytnika. Dodaj do oscam.conf:

[global]

Poziom debugowania 64 to logowanie specyficzne dla czytnika. Poziom 4 dodaje analizę ATR. Uruchomienie obu (ustawdebuglevel = 68) pokazuje surowy ATR i jak OScam go interpretuje.

ATR3F FF 95 00 FF 91 81...to Irdeto. ATR zaczynający się od3B 78 13zwykle oznacza Conax. Jeśli twój ATR wygląda na uszkodzony — zła długość, przesunięte bajty — to jest to niezgodność zegara. Naprawmhz/cardmhznajpierw, a następnie odczytaj ponownie.

Błędy ECM: 'karta nie włożona', 'odrzucona', 'brak pasującego czytnika'

"Karta nie włożona" z OScam mimo obecności karty prawie zawsze oznacza, że sygnał wykrywania jest błędny. Spróbujdetect = !cd. "Odrzucona" oznacza, że karta odpowiedziała na ECM, ale zwróciła błąd — albo niezgodność CAID/dostawcy, albo karta potrzebuje uprawnień, których nie ma. "Brak pasującego czytnika" oznacza, że twoja grupa lub filtr CAID w bloku czytnika nie pasuje do tego, czego żąda ECM.

Niezgodności prędkości zegara i zgadywanie Irdeto

Karty Irdeto są szczególnie wrażliwe na częstotliwość zegara. OScam ma mechanizm zgadywania dla Irdeto, w którym próbuje wielu prędkości zegara, jeśli ATR nie jest czysto dekodowany. To jest wolne i niepewne. Ustawmhzicardmhzwyraźnie na podstawie częstotliwości kryształu twojego czytnika. Jeśli nie znasz częstotliwości kryształu, sprawdź sprzęt — zazwyczaj jest oznaczony na płycie.

Wybór protokołu T=0 vs T=14

ISO 7816 definiuje protokoły transmisji T=0 (ukierunkowany na bajty) i T=1 (ukierunkowany na bloki). Niektóre karty używają niestandardowego protokołu T=14. OScam zazwyczaj negocjuje automatycznie na podstawie ATR, ale jeśli widzisz "negocjacja protokołu nie powiodła się" w logach, może być konieczne wymuszenie tego. Sprawdź dokumentację OScam dla CAID twojej karty, aby znaleźć odpowiedni parametr protokołu.

Poziomy logów: maski debugowania cs_log dla wyjścia tylko z czytnika

Uruchamianie-d 255 rejestruje wszystko, co zalewa log. Dla debugowania tylko do odczytu:debuglevel = 64 dla zdarzeń czytnika, dodaj 4 do analizy ATR, dodaj 8 do dekodowania ECM. Więcdebuglevel = 76 daje ci skoncentrowane wyjście czytnika bez rejestrowania każdego połączenia klienta. Plik logu w /var/log/oscam/oscam.log jest twoim podstawowym narzędziem diagnostycznym — czytaj go linia po linii, gdy coś się psuje.

Wydajność, Stabilność i Długoterminowa Praca

Aczytnik kart inteligentnychcccam oscam 2026 urządzenie, które działa przez godzinę, ale psuje się w nocy, ma inny problem niż takie, które nigdy nie działa. Większość problemów ze stabilnością wynika z dostarczania energii, a nie oprogramowania.

Dlaczego huby USB i długie kable psują synchronizację kart inteligentnych

Czas ISO 7816 jest napięty. Sygnał zegara karty musi być czysty i stabilny — spadek napięcia z niepodłączonego huba lub 2-metrowego kabla USB wprowadza szumy, które powodują resetowanie ECM w trakcie. Logi karty pokazują "rozłączenie karty" lub "reset karty", mimo że jest fizycznie osadzona. To problem sprzętowy, którego żadne zmiany w konfiguracji nie naprawią.

Huby z zasilaniem vs bezpośrednie porty na Raspberry Pi 4/5

Raspberry Pi 4 i 5 dzielą budżet energetyczny między porty USB. Pod obciążeniem (uruchomienie OScam, sieć, pamięć jednocześnie), szyna zasilania USB spada na tyle, aby powodować objawy rozłączenia karty. Zasilany hub USB 2.0 — nie USB 3.0, który dodaje szumy przełączania — między Pi a czytnikiem rozwiązuje ten problem. Nie używaj tanich, nieznanych hubów. Hub 5V/2A marki Anker lub podobnej jakości wystarczy.

Watchdog i automatyczne ponowne uruchamianie procesu czytnika

Dodaj jednostkę watchdog w /etc/systemd/system/oscam-watchdog.service:

[Unit]

To jest bezpośrednie, ale działa. Odpowiednia implementacja monitoruje kolejne zdarzenia "reader idle", a nie jakiekolwiek wystąpienie, ale dla urządzenia 24/7 zapobiega to wielogodzinnym stanom bezczynności.

Ciepło, Niedobór Napięcia i Objawy Rozłączenia Karty

Na Pi 4/5 sprawdź throttling:vcgencmd get_throttled. Wynik różny od zera oznacza, że Pi osiągnął limity termiczne lub niedoboru napięcia i został spowolniony. Objawia się to jako przekroczenia czasu czytnika. Użyj odpowiedniego radiatora i zasilacza 5V/3A (nie 5V/2A dla Pi 4). Oficjalny zasilacz Pi 5 to 5.1V/5A — użyj go.

Kopia zapasowa aktualizacji EMM karty

EMM (Wiadomości Zarządzania Uprawnieniami) to sposób, w jaki dostawca aktualizuje uprawnienia subskrypcyjne twojej karty. OScam przetwarza je automatycznie za pomocąemu_auprovid i powiązanych ustawień. Zła jakość zasilania podczas zapisu EMM może uszkodzić kartę. Jeśli działasz 24/7 na Pi bez UPS, rozważ zakup akcesorium UPS LiPo — kosztują około 15-20 € i zapewniają wystarczający czas pracy, aby przetrwać krótką przerwę w zasilaniu bez przerywania EMM.

Dla kart, które wymagają aktualizacji EMM w określonym oknie czasowym, w przeciwnym razie desynchronizują się z systemem dostawcy, włącz flagi automatycznej aktualizacji w bloku czytnika i upewnij się, że urządzenie jest online podczas okna aktualizacji dostawcy (zwykle między północą a 6:00 czasu lokalnego dla większości europejskich dostawców).

Sytuacje Krawędziowe, Które Warto Znać

Wielu czytników na jednym urządzeniu potrzebuje unikalnych etykiet i stabilnych ścieżek urządzeń. Adresy Bus:device z lsusb zmieniają się po ponownym uruchomieniu, jeśli urządzenia są enumerowane w innej kolejności. Użyj symlinków udev, aby stworzyć stabilne ścieżki:

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

Następnie odwołaj się do/dev/smartreader_1 w oscam.server. Atrybut serial pochodzi zudevadm info -a -n /dev/ttyUSB0 | grep serial.

Złożone urządzenia USB (czytniki, które enumerują jako dwa interfejsy USB) powodują, że OScam wybiera niewłaściwy interfejs. Sprawdźlsusb -v aby zobaczyć, który interfejs ma punkt końcowy karty inteligentnej i określ go wyraźnie w swojej ścieżce urządzenia.

Wyścig warunków wyścigu serwera bezgłowego — pcscd uruchamia się przed zakończeniem enumeracji USB — jest naprawiony za pomocą opóźnienia systemd lub uruchomienia wyzwalanego przez udev. W /etc/systemd/system/pcscd.service.d/override.conf:

[Usługa]

Brzydkie, ale skuteczne. Odpowiednia poprawka to użycie reguły wyzwalacza udev, która uruchamia pcscd dopiero po pojawieniu się czytnika na magistrali.

Karty odwrócone nie produkują ATR lub produkują uszkodzone. Czytnik nie zgłosi wyraźnego błędu — po prostu nie będzie czytać. Niektóre czytniki mają prowadnicę, która temu zapobiega; tańsze nie. Zużyte styki powodują przerywane odczyty ATR: karta inicjalizuje się czasami, a czasami nie. Jeśli widzisz ATR pojawiający się i znikający w logach bez usuwania karty, wyczyść styki izopropylowym alkoholem na waciku.

Uzyskaniestabilnej konfiguracji czytnika kart inteligentnych cccam oscam 2026 od końca do końca wymaga przejścia przez warstwy sprzętowe, jądra i konfiguracji w kolejności. Pomiń jakąkolwiek warstwę, a będziesz debugować niewłaściwą rzecz. ATR to sygnał prawdy — jeśli jest czysty, większość innych problemów leży w konfiguracji. Jeśli jest uszkodzony lub nieobecny, wróć do sprzętu i sterowników.