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|device:slot>|Serial:Reader   serial|<ip|hostname>,<port>[,<lport>]|pcsc|<0|1>|con‐
       stantcw
	  define local or remote reader

	   device:	device name

	   bus:device:	bus name and device name of the Smartreader+
			(get the names with lsusb 'Bus' and 'Device')

	   device:slot: device name and slot number sc8in1 [1-8]
			(only one SC8in1 reader supported)

	   serial	serial number of Smartreader+
			(get the serial number while starting OSCam)

	   lport:	remapping to local port

	   PCSC:	number of PCSC reader, starting with 0

	   0|1: 	for Coolstream HD-1 STB only: select reader 0 or
			reader 1

	   constantcw:	constant CW file name

	  constant  CW	file  format: CA (4 digits):ID (6 digits):SID (4 digits):PMT PID (4 digits):ECM PID (4 digits)::
	  key (16 Bytes seperated by spaces)

	  example: 1234:123456:1234:1234:1234::00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

       device_out_endpoint = address
	  set endpoint address for FTDI chips,default:0x82

	   0x81: Infinity USB Smart
	   0x82: Smartreader+ (default)

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

       key = DES key
	  key for newcamd remote reader encryption

       account = user,password (delimiter not allowed, obsolete)
	  user and password for remote reader, overrides password of password, first come first serve

       user = name
	  user for remote reader, overrides user of account, first come first serve

       password = password
	  password for remote reader, overrides password of account, first come first serve

       mg-encrypted = D: { <IP|hostname> { <local port> <remote port> { <password> { <level>  <level>  }}}}[,<local  MAC
       address>]
	  mgcamd encrypted gbox line, default MAC address = eth0

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

       inactivitytimeout = minutes
	  inactivity timeout for all TCP based remote readers, default:none

       reconnecttimeout = minutes
	  reconnect if missing answers for all TCP based remote readers, default:30

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

       label = name
	  name for reader, required

       description = text
	  description of reader, default:none

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

       logport = 0|port
	  camd 3.x reader logport, camd 3.x UDP must be activated, only works if there's no camd 3.x cascading, 0 = dis‐
	  abled, default=0

       caid = <CAID>[&<mask>][:<target CAID>][,<CAID>[&<mask>][:target <CAID>]]...
	  define and mapping of CAIDs for reader, default:all CAIDs with mask FFFF

	  example: caid = 0100
		   caid = 0200&ffee:0300
		   caid = 0400&ff00:0500,0600
		   caid = 0702,0722
		   caid = 0702&ffdf (shortcut for the example above)

       audisabled = 0|1
	  1 = exclude reader from auto AU, default:0

       auprovid = provider ID
	  set provider ID to use the right reader for auto AU

	  example: auprovid = 123456

       ecmwhitelist = [CAID[@ident]:]length[,length]...[;[CAID[@ident]:]length[,length]...]...
	  define valid ECM length per CAID and ident in hex, default:none,ident=000000

	  example: ecmwhitelist = 10,20,0a,0b
		   ecmwhitelist = 0100:10,20;0200@123456:0a,4b

	  In normal operation mode this parameter is not required.

       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
	  First  the SC will be initialized in normal mode. If it fails, the SC will be automatically reverted to depre‐
	  cated mode, so that the SC speed will not be changed and the communication will remain on normal ATR speed  of
	  9600 baud.

	  1 = use deprecated SC mode only, default:0

       mode = mode
	  set card init mode for AzBox reader, default:none

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

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

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

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

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

       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, default:0

	   logging  = EMM logging mask:

		       0 = EMM logging disabled (default)
		       1 = logging EMM errors
		       2 = logging written EMMs
		       4 = logging skipped EMMs
		       8 = logging blocked EMMs
		      16 = logging disabled AU

	   example: emmcache = 1,3,2

       ratelimitecm = count
	  number of different SIDs in ECMs allowed for an interval, default:0

       resetcycle = count
	  number of ECMs until SC reset is performed, 0 = disabled, valid for physical readers only, default:0

       ratelimitseconds = seconds
	  interval for rate limit, default:0

       cooldown = delay,duration
	  activate ratelimitecm and ratelimitseconds parameters after specified delay for specified duration in seconds,
	  ratelimitecm and ratelimitseconds are required, default:none

       blocknano = nano[,nano]...|all
	  list of EMM-nanos to block (in hex w/o 0x) or all EMM-nanos, valid for physical readers only, 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

       blockemm-bylen = [length,length]...
	  block all types of EMMs by lenght, maximum 10 values, default:none

       saveemm-u = file name
	  save unique EMMs to file, default:none

       saveemm-s = file name
	  save shared EMMs to file, default:none

       saveemm-g = file name
	  save global EMMs to file, default:none

       saveemm-unknown = file name
	  save unknown types of EMMs to file, default:none

       savenano = nano[,nano]....|all (obsolete)
	  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

       dropbadcws = 0|1
	  1 = reject bad CWs, default:0

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

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

       lb_weight = weight
	  the higher the value the higher the probability for reader selection, default:100

	   It's an divider for the average responstime.

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

	  example: cccversion = 1.2.34

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

	   -1 = disabled
	    0 = remote local SCs only
	    1 = remote local SCs and + 1 hop
	    2 = remote local SCs and + 2 hops
	   and so on

	  After reading this SC hop will be incremented by one.

       ccchop = hop
	  set hop for non CCCam readers, default:0

       cccreshare = hop
	  define reader's CCcam reshare hop, default:0

	   -1 = no resharing
	    x = resharing for direct peer and share level x

       cccwantemu = 0|1
	  1 = request to provide emu from CCCam server, too, default:0

       ccckeepalive = 0|1
	  1 = send keepalive messages to keep connection to remote CCCam server up, default:0

       cccmindown = number
	  filters all readers with hops smaller than number, default:0

       pincode = pincode
	  pincode for Conax and Cryptoworks SCs, default:none

       chid = CAID:ChID
	  define SC specific ChIDs for reader, default:none

	  example: chid = 0100:12

       ins7e = payload
	  Add 26 hex-bytes payload for NDS Videoguard 2 SCs, valid for physical readers only, default:none

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

       nagra_read = 0|1|2
	  read Nagravison records (on NCMED cards only):

	    0 = disabled (default)
	    1 = read all records with expired rights
	    2 = read records with valid rights only

       rsakey = RSA key
	  RSA key for Nagravision/Tiger SCs / CAM key data for Irdeto SCs

       fix9993 = 0|1
	  1 = enable fix for 9993 error with CAID 0919 SCs, default:0

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

       aeskeys = CAID #0@ident:AES key #0 CAID #0[,AES key #1 CAID #0],...[;CAID #1@ident:AES key #0 CAID #1[,AES key #1
       CAID #1],...]...
	  multiple 16 bytes AES keys for Viaccess SCs (the used postprocessing AES key is specified through the D2  nano
	  of the ECM)

	  special AES keys:

	   00 = do not return any CW, no AES key specified
	   FF = return CW received from the S, no AES key specified

	  example:

	   aeskeys												       =
	  0500@012345:000102030405060708090a0b0c0d0e0f;0500@543210:000102030405060708090a0b0c0d0e0f,0,0f0e0d0c0b0a090807060504030201

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

       boxid = NDS box ID
	  NDS receiver box id

       ndsversion = 0|1|12|2
	  set NDS Videoguard version

	    0 = autodetection (default)
	    1 = NDS Videoguard 1
	   12 = NDS Videoguard 1+
	    2 = NDS Videoguard 2

OVERCLOCKING
       ·  Dreambox and other internal readers

	  For  Dreambox and other internal readers the highest possible clockrate will be auto detected. The mhz parame‐
	  ter 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 over‐
       clocking  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
	   user     = user1
	   password = password1
	   group    = 3

       ·  newcamd reader

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

       ·  CCcam reader

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

       ·  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

       ·  sc8in1 reader

	   [reader]
	   label    = mysc8in1reader
	   protocol = sc8in1
	   device   = /dev/ttyUSB0:1
	   group    = 9
	   caid     = 0900

       ·  constant CW

	   [reader]
	   label    = myconstantcw
	   protocol = constcw
	   device   = /var/keys/constant.cw
	   group    = 10

       ·  gbox reader

	   [reader]
	   label	= mygboxreader
	   protocol	= gbox
	   mg-encrypted = D: { hostname { 1234 5678 { ABCD1234 { 9 9 }}}}
	   group	= 11
	   caid 	= 1100

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



													 oscam.server(5)
