====== Cardserver ======
Cardserver je software, který slouží ke komunikaci mezi SoftCAM jádrem a přístupovou čipovou kartou. Je jej potřeba použít, pokud máme čtečku karet, která není přímo kompatibilní se sériovým protokolem opensasc-ng.

===== Oscam =====
[[http://streamboard.gmc.to:8001/|OsCAM]] je jeden z mála opensource cardserverů. Podporuje velké množství čteček čipových karet a také velké množství CAM klientů. Proto je jeho konfigurace složitější.

==== Ukázková konfigurace oscam ====
Zde je příklad minimální funkční konfigurace pro kartu Skylink (dříve CzechLink). Pro jiné karty bude zřejmě potřeba změnit hodnoty CAID z 0d03 na jinou. Cardserver totiž na základě těchto hodnot provádí něco jako routing, pokud je připojeno víc kartiček.

Nejjednodušší způsob, jak číslo CAID naší kartičky zjistit, je podívat se do logu oscamu, poté co kartičku načte (v tu chvíli může být caid nastaveno libovolně):<code>
402 r02 card detected
402 r02 ATR: 3B 78 12 00 00 47 C4 03 00 8F F1 90 00 
402 r02 Maximum frequency for this card is formally 5 Mhz, clocking it to 3.57 Mhz
402 r02 type: CryptoWorks, caid: 0D03, ascii serial: *********, hex serial: *******
402 r02 issuer: Trade&Technology, id: 04, bios: v3, pin: unknown, mfid: ****
402 r02 providers: 2 (04,08)
</code>

=== oscam.conf ===
Hlavní konfigurační soubor. Obsahuje mimo jiné definice všech možných sdílecích protokolů. Já zvolil pro komunikaci s opensasc-ng protokol newcamd na portu 15050. **Důležité:** Chcete-li oscam provozovat bez rootovského oprávnění (což byste měli chtít), musí být všechna čísla portů vyšší než 1024. Což v [[http://streamboard.gmc.to/svn/oscam/trunk/Distribution/doc/example/|example konfiguraci]] není splněno pro položku monitor.
<file>
#
# main configuration
#

[global]
nice	      = 0
WaitForCards  = 0

# logging

pidfile	      = ./run/oscam.pid
logfile	      = ./log/oscam/oscam.log
usrfile	      = ./log/oscam/oscamuser.log
cwlogdir      = ./log/oscam/cw

# monitor

[monitor]
port	      = 9988
aulow	      = 120
monlevel      = 4
nocrypt = 127.0.0.1

# protocols

[newcamd]
key           = 0102030405060708091011121314
port          = 15050@0d03:000000
# tady POZOR: pro kartu od UPC musite zadat konkretni cisla providera ( daji se zjistit z logu oscam )
# napr: port = 15050@0d02:00008C,0000A0,0000A4,0000A8
</file>

=== oscam.server ===
V tomto souboru jsou definovány čtečky karet.
Následuje příklad pro [[http://www.sat-servis.cz/eshop/50.tevii/TeVii-Phoenix-ctecka-karet/|USB Phoenix čtečku TeVii s můstkem pl2303]]:
<file>
#
# reader configuration
#

# USB serial reader

[reader]
label    = myphoenix
group    = 1
protocol = mouse
detect   = CD
deprecated = 1
device   = /dev/ttyUSB0
caid     = 0d03
</file>

=== oscam.user ===
Definuje uživatele cardserveru. V našem případě vystačíme s dummy uživatelem. Za zmínku stojí volba au, která by měla dotyčnému uživateli povolit update dané kartičky pomocí EMM zpráv.
<file>
#
# user configuration
#

[account]
user = dummy
pwd = dummy
group = 1
au = myphoenix
caid = 0D03
ident = 0D03:000000
</file>

==== opensasc-ng jako newcamd klient ====
Aby se opensasc-ng mohl spojit s oscamem, je třeba vytvořit v cestě zadané parametrem ''--cam-dir'' konfigurační soubor ''cardclient.conf'':
<file>
# newcamd client
# 'cfgkey' is the config key (28bytes)
newcamd:localhost:15050:1/0d03/ffff:dummy:dummy:0102030405060708091011121314
</file>