oscam.server(5) 																			  oscam.server(5)



NAME
       oscam.server - reader configuration file for OSCam

SYNOPSIS
       The  server  configuration  file  for OSCam contains reader parameters.	sections in oscam.server are recurring (more than one reader possible).  At least one [reader] section is
       required.

DESCRIPTIONS
   The [reader] section
       device = <device|bus:device>|<ip|hostname>,<port>[,<lport>]|pcsc
	  define local or remote reader

	   device:	device name
	   bus:devivce: bus name and device name of the Smartreader+
			(get the names with lsusb 'Bus' and 'Device')
	   lport:	remapping to local port
	   PCSC:	number of PCSC readers, starting with 0

       enable = 0|1
	  0 = deactivate reader, default=1

       key = DES key
	  key for newcamd remote reader encryption

       password = password
	  password for remote gbox reader

       premium = ???
	  for gbox reader

       account = user,password
	  user and password for remote reader

       pincode = pincode
	  pincode for Conax and Cryptoworks SCs

       services = [!]services[,[!]<services>]...
	  reader [de]assingment to service group, default=none

       inactivitytimeout = minutes
	  inactivity timeout for newcamd reader, default:none

       reconnecttimeout = minutes
	  TCP reconnect, if missing answers, default:none

       disableserverfilter = 0|1
	  1 = ignore caid and ident settings of reader due faulty clients, default=0

       label = name
	  name for reader, required

       fallback = 0|1
	  1 = define reader as fallback, standard and fallback reader must have the same group, default:0

       logport = 0|port
	  camd3 reader logport, camd3 UDP must be activated, only works if there's no camd3 cascading, 0=disabled, default=0

       caid = CAID[&<mask>][,CAID[&<mask>]]...
	  define CAID for reader, some protocols only support one CAID, default:mask=FFFF

	  example: CAID=0100,0200&FFDF

       boxid = NDS box ID
	  NDS receiver box id

       aeskey = AES key
	  AES key for Viaccess SCs

       detect = CD|DSR|CTS|RING|NONE|gpio[1-7]
	  status detect of card (NONE = no detection), default:CD

       cardmhz = mhz
	  set standard SC frequency in units of 10 kHz, for Irdeto SC set to 600, refer to OVERCLOCKING, default:357

       mhz = frequency
	  set reader frequency in units of 10 kHz, if mhz > cardmhz you are in overclocking mode, refer to OVERCLOCKING, default:357

       deprecated = 0|1
	  Frist the SC will be initialized in normal mode. If it fails, the SC will be automatically reverted to deprecated mode, so that the SC speed will not be changed and the commu‐
	  nication will remain on normal ATR speed of 9600 baud.

	  1 = use deprecated SC mode only, default:0

       protocol = reader protocol
	  reader protocol, required:
	   mouse
	   smartreader
	   internal
	   serial
	   camd35|cs357x
	   cs378x
	   gbox
	   newcamd|newcamd525
	   newcamd524
	   cccam
	   radegast
	   pcsc

       cccversion = <main version>.<version>.<sub version>
	  define CCcam version, default:none

	  example: cccversion = 1.2.34

       cccbuild = <4-digit number>
	  define CCcam build, default:none

	  example: cccbuild = 5678

       cccmaxhop = hops
	  define CCcam maximum SC distance, default:10

       ident = <CAID>:<ident>[,ident]...[,<CAID>:<ident>[,ident]...]...
	  define CAID and ident for reader

	  example: ident = 0100:123456,234567;0200:345678,456789

       provid = ID
	  define provider ID for reader

       class = [!]class[,[!]class]...
	  define class in hex for reader

	  example: class = 01,02,!1b,!2b

       chid = CAID:ChID
	  define Irdeto ChID for reader

	  example: chid = 0100:12

       showcls = quantity
	  number of classes subscriptions to show for Viaccess SCs, default=10

       maxqlen = size
	  size of request queue for reader, default:128

       group = groupname
	  reader assingment to group, required

       emmcache = usecache,rewrite,logging
	  set EMM cache of local reader:
	   usecache = 0|1 1 = enable EMM caching, default:0
	   rewrite  = determines how often one and the same EMM is written
	   logging  = EMM logging mask:
		      0 = EMM logging disabled
		      1 = logging EMM errors
		      2 = logging written EMMs
		      4 = logging skipped EMMs
		      8 = logging blocked EMMs

	   example: emmcache = 1,3,10
		    emmcache = 1,2,6

	   types of caching: cache1 = ECM and CW in cache already
			     cache2 = ECM and checksum in the cache already

       ecmcache = 0|1
	  1 = enable ECM caching, default:1

       blocknano = nano[,nano]...|all
	  list of EMM-nanos to block (in hex w/o 0x) or all EMM-nanos, only valid for physical readers, default:none

	   example: blocknano = 45,93,7a,ff
		    blocknano = all

       blockemm-u = 0|1
	  1 = block unique EMMs, default:0

       blockemm-s = 0|1
	  1 = block shared EMMs, default:0

       blockemm-g = 0|1
	  1 = block global EMMs, default:0

       blockemm-unknown = 0|1
	  1 = block unknown types of EMMs, default:0

       savenano = nano[,nano]....|all
	  list of EMM-nanos to save (in hex w/o 0x) or all EMM-nanos, only valid for physical readers, default:none

	   example: savenano = 45,93,7a,ff
		    savenano = all

       readnano = [path]filename
	  write  file  (usually  a  copy of a file saved by savenano) to your smartcard, if no path is specified, the specified file is searched for in the configuration directory, only
	  valid for physical readers, default:none

	   example: readnano = write.emm
		    readnano = /var/oscam/write.emm

       force_irdeto = 0|1
	  1 = force Irdeto SC mode even if RSA key is set for Irdeto tunnled Nagravion SC, default:0

       n3_rsakey|rsakey = RSA key
	  RSA key for Nagravision SCs / CAM key data for Irdeto SCs

       n3_boxkey|boxkey = box key
	  box key for Nagravision SCs / CAM key for Irdeto SCs

       tiger_rsakey = RSA key
	  RSA key for Tiger Nagravision SCs

       tiger_ideakey = IDEA key
	  IDEA key for Tiger Nagravision SCs

       cccdisableretryecm = 0|1
	  0 = enables ECM retrying: When an ECM request is denied from an CCCam server, OSCam immediatelly sends a new ECM request, 1= disables ECM retrying:  When  an  ECM  request  is
	  denied from an CCCam server, OSCam sends no new ECM request, default:0

       cccdisableautoblock = 0|1
	  0  =	enables  auto block: When an ECM request is send to an CCCam server, it tries the SC with the lowest hop. If it is denied, the SID is blocked on this SC. When all SC are
	  blocked, the CAID:PROV:SID information is stored in a auto block list and is newer send again, 1= disabled auto block, default: 1

OVERCLOCKING
       ·  Dreambox and other internal readers

	  For Dreambox and other internal readers the highest possible clockrate will be auto detected. The mhz parameter lets you override the values chosen by  OSCam,  if  it  differs
	  from 357 and 358, but usually you will not set any value for mhz.

	  For certain Dreamboxes (especially PPC clones) the default mhz parameter leads to slow ECM times and/or "not found" ECMs. By setting mhz to values like 200, 300, 400, ... 1600
	  you can find a value that works for your receiver and your card. The higher the mhz value, the slower the ECM time (strange enough).

	  If you choose the value too low, your card is not recognized (no ATR or "card not supported"). If you choose the value too high, you get slow ECM times. Our experience is that
	  either no mhz line, or a line mhz = 1000 works best.

       ·  Phoenix / Smartmouse reader

	  Overclocking does not work with Windows and Mac OS X.  Set mhz equivalent to the frequency of the reader.  OSCam can not set the frequency of the reader.

       ·  Smargo Smartreader+

	  Set the reader frequency with the native Smargo Smartreader+ tool (srp_tools).  Do not set mhz and cardmhz.

       OSCam  tries to set the baudrate automatically.	A standard serial port has limited baudrate settings, so SC overclocking might not work.  When using a serial reader the best way
       for overclocking is connecting it to a FTDI based USB to serial port adapter.

       If overclocking does not work, verify the effective baudrate in the logfile.  If it deviates too much from the requested baudrate, the SC will not be recognized (no ATR) and  the
       value for mhz should be adjusted again.	The higher the baudrate, the more accurate the effective baudrate can be.

EXAMPLES
       ·  serial mouse compatible reader

	   [reader]
	   label    = myserialmousereader
	   detect   = cd
	   protocol = mouse
	   device   = /dev/ttyS1
	   group    = 1
	   caid     = 0100
	   services = myservice,!thisservice

       ·  USB mouse compatible reader

	   [reader]
	   label    = myusbmousereader
	   detect   = cd
	   protocol = mouse
	   device   = /dev/ttyUSB0
	   aeskey   = 0102030405060708090a0b0c0d0e0f10
	   group    = 2
	   caid     = 0200

       ·  camd 3.78x reader

	   [reader]
	   label    = mycamd378xreader
	   protocol = cs378x
	   device   = 192.168.0.1,1234
	   account  = user,password
	   group    = 3

       ·  newcamd reader

	   [reader]
	   label    = mynewcamdreader
	   protocol = newcamd
	   key	    = 0102030405060708091011121314
	   device   = 192.168.0.2,2345
	   account  = user,password
	   group    = 4

       ·  CCcam reader

	   [reader]
	   label = mycccamreader
	   protocol = cccam
	   device = 192.168.0.3,3456
	   account = user,password
	   group = 5
	   caid = 0300,0400,0500
	   cccversion = 1.2.3
	   cccbuild = 4567

       ·  PCSC reader

	   [reader]
	   label    = mypcscreader
	   protocol = pcsc
	   device   = 0
	   aeskey   = 0102030405060708090a0b0c0d0e0f10
	   group    = 6
	   caid     = 0600

       ·  Smargo Smartreader+

	   [reader]
	   label    = mysmartreader
	   protocol = smartreader
	   device   = 001:002
	   aeskey   = 0102030405060708090a0b0c0d0e0f10
	   group    = 7
	   caid     = 0700

       ·  internal reader

	   [reader]
	   label    = myinternalreader
	   protocol = internal
	   device   = /dev/sci0
	   group    = 8
	   caid     = 0800

SEE ALSO
       list_smargo(1), oscam(1), oscam.ac(5), oscam.cert(5), oscam.conf(5), oscam.guess(5), oscam.ird(5), oscam.provid(5), oscam.services(5), oscam.srvid(5), oscam.user(5)



																					  oscam.server(5)
