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|host‐
       name>,<port>[,<lport>]|pcsc|<0|1>|constantcw
	  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  dig‐
	  its):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

       services = [!]services[,[!]<services>]...
	  reader [de]assignment 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

       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

       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 communication will remain on  nor‐
	  mal 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 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

       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

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

       ratelimitseconds = seconds
	  interval for rate limit, default:0

       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

       lb_weight = weight
	  the higher the value the higher the probability  for	reader	selec‐
	  tion, 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
	   0 = local SCs only
	   1 = local SCs and + 1 hop
	   2 = local SCs and + 2 hops
	   and so on

       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

       pincode = pincode
	  pincode for Conax and Cryptoworks SCs

       chid = CAID:ChID
	  define Irdeto ChID for reader

	  example: chid = 0100:12

       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

       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 clock‐
	  rate 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 set‐
	  ting 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	effec‐
       tive 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
	   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

       ·  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
	   device   = host.example.com,4567
	   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)
