OSCam/en/Config/oscam.server
OSCam Übersicht OSCam Home OSCam Accueil OSCam Home
oscam.server
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. Examples for reader configuation you will find here OSCam/en/examples/Reader
[reader] label = enable = description = protocol = device = # ÄNDERUNG - CHANGE - MODIFICATIONS - MODIFICA svn8057+8059:01/04/2013 detect = use_gpio = cardmhz = # ÄNDERUNG - CHANGE - MODIFICATIONS - MODIFICA svn7046:06/12/12 mhz = # ÄNDERUNG - CHANGE - MODIFICATIONS - MODIFICA svn7045-47:06/12-14/12 autospeed = # NEU - NEW - NOUVEAU - NUOVO svn9064:12/01/2013 deprecated = mode = device_out_endpoint = # ÄNDERUNG - CHANGE - MODIFICATIONS - MODIFICA svn8013:12/29/2012 smargopatch = # NEU - NEW - NOUVEAU - NUOVO svn6402:02/16/2012 sc8in1_dtrrts_patch = # NEU - NEW - NOUVEAU - NUOVO svn6402:02/16/2012 cool_timeout_init = # NEU - NEW - NOUVEAU - NUOVO svn6286:01/23/2012 cool_timeout_after_init= # NEU - NEW - NOUVEAU - NUOVO svn6253:01/17/2011 ins7e = # NEU - NEW - NOUVEAU - NUOVO svn5959:09/22/2011 ins7e11 = # NEU - NEW - NOUVEAU - NUOVO svn6064:12/06/2011 fix07 = # NEU - NEW - NOUVEAU - NUOVO svn9884:09/30/2014 force_irdeto = nagra_read = rsakey = # ÄNDERUNG - CHANGE - MODIFICATIONS - MODIFICA svn7043:06/12/12 fix9993 = boxkey = pincode = boxid = ndsversion = aeskeys = showcls = # VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO svn6624:04/23/2012 key = account = # VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO svn8131:01/20/2013 user = password = services = caid = ident = class = chid = group = audisabled = auprovid = disableserverfilter = inactivitytimeout = reconnecttimeout = # ÄNDERUNG - CHANGE - MODIFICATIONS - MODIFICA svn7244:08/07/2012 connectoninit = # NEU - NEW - NOUVEAU - NUOVO svn8235:01/29/2013 # ÄNDERUNG - CHANGE - MODIFICATIONS - MODIFICA svn 9810:07/22/2014 keepalive = # NEU - NEW - NOUVEAU - NUOVO svn9810:07/22/2014 fallback = fallback_percaid = # NEU - NEW - NOUVEAU - NUOVO svn8896:09/04/2013 emmcache = emmreassembly = # NEU - NEW - NOUVEAU - NUOVO svn8493:0/06/2013 = # VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO svn8591:04/01/2013 cacheex = # NEU - NEW - NOUVEAU - NUOVO svn6039:11/26/2011 cacheex_maxhop = # NEU - NEW - NOUVEAU - NUOVO svn6691:05/07/2012 logport = ecmwhitelist = ecmheaderwhitelist = # NEU - NEW - NOUVEAU - NUOVO svn7480:09/21/2012 ratelimitecm = ecmnotfoundlimit = # NEU - NEW - NOUVEAU - NUOVO svn8315:02/07/2013 resetcycle = # NEU - NEW - NOUVEAU - NUOVO svn5821:08/12/2011 ratelimitseconds = # VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO svn9078:09/12/2013 ratelimitime = # NEU - NEW - NOUVEAU - NUOVO svn9078:09/12/2013 ecmunique = # NEU - NEW - NOUVEAU - NUOVO svn8491:03/06/2013 srvidholdseconds = # VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO svn9078:09/12/2013 srvidholdtime = # NEU - NEW - NOUVEAU - NUOVO svn9078:09/12/2013 cooldowndelay = # NEU - NEW - NOUVEAU - NUOVO svn5946:09/09/2011 blocknano = blockemm-u = blockemm-s = blockemm-g = blockemm-unknown = blockemm-bylen = # ÄNDERUNG - CHANGE - MODIFICATIONS - MODIFICA svn8615:04/12/2013 via_emm_global = # NEU - NEW - NOUVEAU - NUOVO svn9843:09/05/2014 saveemm-u = # NEU - NEW - NOUVEAU - NUOVO svn5947:09/09/2011 saveemm-s = # NEU - NEW - NOUVEAU - NUOVO svn5947:09/09/2011 saveemm-g = # NEU - NEW - NOUVEAU - NUOVO svn5947:09/09/2011 saveemm-unknown = # NEU - NEW - NOUVEAU - NUOVO svn5947:09/09/2011 savenano = # VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO svn5947:09/09/2011 readnano = use_ssl = # NEU - NEW - NOUVEAU - NUOVO svn8725:06/25/2013 dropbadcws = # ÄNDERUNG - CHANGE - MODIFICATIONS - MODIFICA svn11292:12/21/2016 disablecrccws = # NEU - NEW - NOUVEAU - NUOVO svn6004:10/26/2011 disablecrccws_only_for = # NEU - NEW - NOUVEAU - NUOVO svn11292:12/21/2016 lb_weight = lb_whitelist_services = # NEU - NEW - NOUVEAU - NUOVO svn8656:05/22/2013 lb_force_fallback = # NEU - NEW - NOUVEAU - NUOVO svn9739:05/19/2014 cccversion = cccmaxhops = ccchop = cccreshare = # ÄNDERUNG - CHANGE - MODIFICATIONS - MODIFICA svn8607:04/10/2013 cccwantemu = ccckeepalive = cccreconnect = # VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO svn6441:02/23/2012 cccmindown = Gbox device = password = gbox_reshare = # NEU - NEW - NOUVEAU - NUOVO svn8350:02/15/2013 gbox_max_distance = # NEU - NEW - NOUVEAU - NUOVO svn8350:02/15/2013 gbox_max_ecm_send = # NEU - NEW - NOUVEAU - NUOVO svn8350:02/15/2013 user = # NEU - NEW - NOUVEAU - NUOVO svn8662:05/24/2013
[reader]
Define local or remote reader
label
name for reader
Example:
label = easymouse2
enable
deactivate reader
0 = off 1 = On (default)
description
description = text
description of reader, default: [blank] none
protocol
reader protocol
protocol = mouse (local cardreader) = internal (all cardreader with "device=/dev/sciX") = camd35|cs357x (cascading - camd 3.5-compatible remote server) = mp35 = smartreader = serial = cs378x = gbox = newcamd|newcamd525 = newcamd524 = cccam = radegast = pcsc = constcw = sc8in1
device
<device|bus:device|device:slot>|Serial:Reader serial|<ip|hostname>,<port>[,<lport>]|pcsc|<0|1>|constantcw
device: device name (eg myreader) 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 or MCR [1-8] 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 separated by spaces)
eg: 1234:123456:1234:1234:1234::00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
Examples
device = /dev/ttyS0 # (Reader on COM1 (Linux i386 and Windows)) device = /dev/tts/1 # (Reader on COM2 (Linux dbox2 with multicam)) device = /dev/ttyUSB0 # (Reader on USB (Linux i386)) device = /dev/ttyUSB0:1 # Slot 1 SC8in1 or MCR 4/8 (Linux i386)
Attention: Counting begins with 0, that means number of device is one less than number of COM-Port! Eg ttyS0 = COM1, tts/1 = COM2.
detect
status detect of card is in
Detect = CD (Carrier Detect) - default - Detect = DSR (Data Set Ready) Detect = CTS (Clear To Send) Detect = RING (Ring Indicator) Detect = NONE (detect switched off, but signal "card is in" Detect = gpio1 ... gpio7 (neu für mipsel-uclibc)
- Inverse = prefix "!"(eg "detect=!CTS")
cardmhz
CHANGE svn7046:06/12/12
set standard SC frequency in units of 10 kHz, for Irdeto SC set to 600, refer to Overclocking Example:
cardmhz = 600 # Irdeto card = # [blank] 357 (default)
auto clock speed in Dreambox mode set to -1
List of default and overclocking card frequencies
mhz
CHANGE svn 7045+7047:06/12-14/12
set reader frequency in units of 10 kHz, if mhz > cardmhz you are in overclocking mode, refer to Overclocking
Example:
# Default 357 cardmhz = 600 # ( 6000 KHz = 6 MHz) mhz = 1000 # (10000 KHz = 10 MHz)
For cardmhz switching to MIPSEL Dreambox mode set to 2700, for cardmhz switching to PPC Dreambox mode set to 3150.
List of default and overclocking card frequencies
deprecated
First 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 normal ATR speed of 9600 baud.
deprecated = 1 use deprecated SC mode only = 0 default
mode
set card init mode for AzBox reader
mode = 1 # AzBox-Reader = 0 # none (default)
device_out_endpoint
set endpoint address for FTDI chips
0x81: Infinity USB Smart 0x82: Smartreader+ (default)
smargopatch
NEW svn6402:02/16/2012
smargopatch = 0|1
enable workaround for smartreader+ and reader until native mode works, default = 0
sc8in1_dtrrts_patch
NEW svn6402:02/16/2012
sc8in1_dtrrts_patch = 0|1
enable fix for SC8in1/MCR DTR/RTS kernel bug, default = 0
cool_timeout_init
NEW svn6286:01/23/2012
cool_timeout_init = timeout
set card init mode for AZBox internal reader
cool_timeout_after_init
NEW svn6253:01/17/2012
Attention: only for Coolstream!
cool_timeout_after_init = timeout
set read/transmit timeout after SC init in milli-seconds for Coolstream internal reader only, default:150
ins7e
NEW svn5959:09/22/2011
ins7e = payload = [none] default
Add 26 hex-bytes payload for NDS Videoguard 2 SCs
Attention: valid for physical readers only
ins7e11
NEW svn6064:12/06/2011
ins7e11 = TA1 Byte = [none] default
Add TA1 Byte for NDS Videoguard 2 SCs
Attention: valid for physical readers only
force_irdeto
force Irdeto SC mode even if RSA key is set for Irdeto tunneled Nagravion SC
force_irdeto = 1 # yes = 0 # no (default)
nagra_read
read Nagravison records (on NCMED cards only):
nagra_read = 0 # disabled (default) = 1 # read all records with expired rights = 2 # read records with valid rights only
rsakey
CHANGE svn7046:06/12/12
RSA key for Nagravision/Tiger SCs / CAM key data for Irdeto SCs, Conax SCs, default = none
fix9993
fix9993 = 0|1
enabled fix for 9993 error with CAID 0919 SCs.
fix9993 = 1 # enabled = 0 # disabled (default)
boxkey
box key for Nagravision SCs / CAM key for Irdeto SCs
pincode
pincode for Conax and Cryptoworks SCs
pincode = pincode = # [blank] default
boxid
NDS receiver box id
boxid = NDS box ID
ndsversion
set NDS Videoguard version
0 = # autodetection (default) 1 = # NDS Videoguard 1 12 = # NDS Videoguard 1+ 2 = # NDS Videoguard 2
aeskeys
multiple 16 bytes AES keys for Viaccess SCs (the used postprocessing AES key is specified through the D2 nano of the ECM)
CAID #ident:AES key #0 CAID #0[,AES key #1 CAID #0],...[;CAID #1@ident::AES key #0 CAID #1[,AES key #1 CAID #1],...]...
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 = 0100@012345:000102030405060708090a0b0c0d0e0f;0200@543210:0,0,0f0e0d0c0b0a090807060504030201
showcls
OBSOLETE svn6624:04/23/2012
number of classes subscriptions to show for Viacces-SCs
schowcls = quantity = 0 # (default)
key
key for newcamd remote reader encryption
key = DES key
user
user for remote reader (name)
password
password for remote reader
mg-encrypted
mgcamd encrypted gbox line
format:
{ <IP|hostname> { <local port> <remote port> { <password> { <level> <level> } address> }
default:
MAC address=eth0
services
Attention: If loadbalancing is enabled in oscam.conf [global] among lb_mode, then there may be no entries!
Attention: The number of services that will be considered based reader, is limited to 64, or 64 times [[service-name][CAID][provid][srvid]]!
What services can the reader. This requires a oscam.services be present. The logic here is as follows (in this order):
- If the field is empty (or invalid), the request is allowed.
- When a negative service (ie, those with "!") is applicable, the request is rejected.
- If a positive service is applicable or there is no positive service, the request is allowed.
- If none of the previous points, the request is rejected.
This means that negative Services are only necessary in individual cases. Namely, if and when services has positive, but it wants to exclude some back. This is not recommended, because here comes quickly to misconfigurations. Instead, an additional service to be created that contains all the relevant channels.
[de]assignment to service group
services = [!]services[,[!]<services>]... = [blank] is default
caid
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)
ident
Attention: If in oscam.conf [global] loadbalancing is enabled among lb_mode, then there may be no entries!
define CAID and ident SC specific for reader:
ident 0 <CAID>:<ident>[,ident]...[;<CAID>:<ident>[,ident]...]...
Example
ident = # 0100:123456,234567;0200:345678,456789 = # [blank] no definition (default)
class
define class in hex SC specific for reader:
class = 01,02,!1b,!2b # 01 and 01 yes, 1b and 2b no = # [blank] no definition (default)
chid
define Irdeto ChID for reader
Example:
chid = 0100:12 chid = 0100:12;0604:0000BA,000101,00010E,000141 = # [blank] default
group
CHANGE svn6103:12/21/2011
Reader assingment to group. Each reader must be listed in one or more groups. This will determine, which client has access on what reader. Valid values 1-64
group = 1....64[,1....64]....
set required = [blank] default not allowed!
Example:
Group = 1 # (one group) Group = 1,4,5 # (more groups)
audisabled
exclude reader from auto AU (auto update)
audisabled = 1 # excludet = 0 # not excludet (default)
auprovid
set provider ID to use the right reader for auto AU
Example
auprovid = # 123456 = # [blank] default
disableserverfilter
ignore caid and ident settings of reader due faulty clients
disableserverfilter = 1 # ignore = 0 # not ignore (default)
inactivitytimeout
inactivity timeout in seconds
inactivitytimeout = 2 # timeout in 2 seconds = 0 # default
reconnecttimeout
TCP reconnect, if missing answers in seconds
Example
reconnecttimeout = 20 # after 20 seconds new connection = # [blank] default
fallback
Define reader as fallback, standard and fallback reader must have the same group, see group!
fallback = 1 # fallbackreader = 0 # no fallbackreader (default)
emmcache
set EMM cache of local reader
Without this parameter, no EMM are shown in the log!
Format:
emmcache = <usecache>,<rewrite>,<logging>
* <usecache> 0 = # disabled EMM caching (default) * <usecache> 1 = # enabled EMM caching
* <rewrite> n = # determines how often one and the same EMM is written. only if <usecache> = 1
* <logging> 0 = # EMM logging disabled * <logging> 1 = # logging EMM errors * <logging> 2 = # logging written EMMs * <logging> 4 = # logging skipped EMMs * <logging> 8 = # logging blocked EMMs * <logging> 16 = # logging audisabled EMMs
Sumarizing this values is possible. 31 shows all kinds of messages
Example
emmcache = 1,3,10 # Cache on, write 3 x, log written (2) and blocked (8) = 10 emmcache = 1,2,6 # Cache on, write 2 x, log written (2) and skipped (4) = 6
cacheex
NEW svn6044:11/27/2011
cacheex = 0|1|2|3
1 = enable cache exchange pull mode 2 = enable cache exchange push mode 3 = enable cache exchange reversepush mode 0 = default for camd 3.5x and CCcam protocol
see also on oscam.user!
Identical cache exchange modes must be set on local OSCam server and remote OSCam user account!
cacheex-modes
cacheex = 1 - cachepull
Situation:
OSCam A reader1 has cacheex = 1
OSCam B account1 has cacheex = 1
OSCam A gets a ECM request, reader1 send this request to OSCam B,
OSCam B checks his cache:
- Not found in cache: return NOK
- Found in cache: return OK+CW
- Not found in cache, but found pending request: wait cacheexwaittime in oscam.conf [global] and check again. OSCam B never requests new EMMs.
CW-flow = B ---> A
cacheex = 2 - cachepush
Situation:
OSCam A reader1 has cacheex = 2
OSCam B account1 hastcacheex = 2
If OSCam B gets a CW, its pushed to OSCam A, reader has normal functionality and can request ECMs.
- Problem: OSCAM can only push CW's if OSCam A is connected
- Problem or feature?: OSCam A reader can request ECMs from OSCam B
CW-flow = B ---> A
cacheex = 3 - reversecachepush
Situation:
OSCam A reader 1 has cacheex = 3
If OSCam A gets a CW, its pushed to OSCam B. OSCam A never requests new ECMs.
CW-flow = A ---> B
cacheex_maxhop
NEW svn6691:05/07/2012
cacheex_maxhop = hops
= default = 10 hops
define maximum hops for cach exchange
logport
Camd 3.x reader logport, camd 3.x UDP must be activated, only works if there's no camd 3.x cascading
logport = # port number = 0 # disabled (default)
ecmwhitelist
ecmwhitelist = [CAID[@ident]:]lenght[,lengtht]...[;[CAID[@ident]:]lenght[,lengtht]...]...
define valid ECM length in hex and ident for physical reader
example
ecmwhitelist = 10,20,30,0a,0b,0c = 0100:10,20;0200@12345:0a,4b [blank] = none (default) and ident 000000
In normal operation mode this parameter ist not required!
ratelimitecm
number of different SIDs in ECMs allowed for an interval
ratelimitecm = # number = 0 # (default)
resetcycle
NEW svn5821:08/12/2011
resetcycle = count
number of ECMs until SC reset ist performerd
Hint: Valid for physical readers only!
example:
resetcycle = 0 # disabled [default] = 5 # reset after 5 ECM's
ratelimitseconds
interval for rate limit in seconds
ratelimitseconds = # seconds = 0 # (default)
cooldown
NEW svn5946:09/09/2011
cooldown = delay, duration = [blank] none (default)
activate ratelimitecm and ratelimitseconds parameters after specified delay for specified duration in seconds. ratelimitecm and ratelimitseconds are required!
blocknano
list of EMM-nanos to block (in hex w/o 0x) or all EMM-nanos, only valid for physical readers!
Example:
blocknano = 45,93,7a,ff = all = # [blank] (default)
blockemm-u
block unique EMMs
blockemm-u = 0 # (no block) default blockemm-u = 1 # (block EMMs, which are addressed to card immediatly) )
blockemm-s
block shared EMMs
blockemm-s = 0 # (no block) default blockemm-s = 1 # (block EMMs, which are addressed to certain groups of cards)
blockemm-g
block global EMMs
blockemm-g = 0 # (no block) default blockemm-g = 1 # (block EMMs, which are addressed to all cards)
blockemm-unknown
block unknown types of EMMs
blockemm-unknown = 0 # (no block) default blockemm-unknown = 1 # (block all unknown kinds of EMMs)
blockemm-bylen
blockemm-bylen = [length,length]... (decimal)
block all types of EMMs by length, maximum 10 values, default: none
saveemm-u
NEW svn5947:09/09/2011
saveemm-u = 0 (default) = 1
save unique EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).
saveemm-s
NEW svn5947:09/09/2011
saveemm-s = 0 (default) = 1
save shared EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).
saveemm-g
NEW svn5947:09/09/2011
saveemm-g = 0 (default) = 1
save global EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).
saveemm-unknown
NEW svn5947:09/09/2011
saveemm-unknown = 0 (default) = 1
save unkown EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).
savenano
OBSOLETE svn5947:09/09/2011
list of EMM-nanos (in hex w/o 0x) to save or all EMM-nanos. Only valid for physical readers. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).
Format
nano[,nano]....|all
Beispiel
savenano = 45,93,7a,ff = all = # [blank] default
readnano
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!
Example:
readnano = write.emm = /var/oscam/write.emm = # [blank] (default)
dropbadcws
CHANGE svn5992:10/22/2011
dropbadcws = 0|1
dropbadcws = 1 # reject bad CWs, send "not found" instaed of bad CWs = 0 # default
disablecrccws
NEW svn6004:10/26/2011
disablecrccrws = 1 # disable cw checksum test = 0 # enable (default)
lb_weight
The higher the value the higher the probability for reader selection. It's an divider for the average responstime.
lb_weight = weight = # [blank] Default-Wert 100
ccc
cccversion
Only for CCcam
define CCcam version
<mainversion>,<version>,<sub version>
Example
cccversion = 1.2.34
cccmaxhops
define CCcam maximum SC distance hops
0 = local SCs only 1 = local SCs and + 1 hop 2 = local SCs and + 2 hops and so on default = 10
ccchop
ccchop = hop
Set hop for non CCCam readers
default = 0
Define reader's CCcam reshare hop
cccreshare = -1 # use reshare level defined in oscam.conf - default cccreshare = x # resharing for direct peer and share level x
reshare could be defined on 2 ways:
- reader ("cccreshare")
- user-account ("cccreshare")
A cards reshare value is set to the smallest value of the 2 parameters !
cccwantemu
Request to provide emu from CCCam server, too.
cccwantemu = 1 # yes = 0 # no (default)
ccckeepalive
Send keepalive messages to keep connection to remote CCCam server up
ccckeepalive = 1 # yes = 0 # no (default)
cccreconnect
OBSOLET svn6441:02/23/2012
cccreconnect = timeout (milli-seconds)
reconnect again after ECM request timeout in milli-secons, default = 4000 milliseconds
cccmindown
cccmindown = # number = 0 # default
Filters all readers with hops smaller than number
Diese Seite in anderen Sprachen - This page in other languages - Cette page dans d'autres langues - Queste pagine in altre Lingue
[[OSCam/de/{{#titleparts:OSCam/en/Config/oscam.server|3|3}}|Deutsch]] [[OSCam/en/{{#titleparts:OSCam/en/Config/oscam.server|3|3}}|English]] [[OSCam/fr/{{#titleparts:OSCam/en/Config/oscam.server|3|3}}|Français]] [[OSCam/it/{{#titleparts:OSCam/en/Config/oscam.server|3|3}}|Italiano]]