OSCam/en/Config/oscam.server

2012-02-16T23:08:14Z

Irata: small sc8in1 changes

[[Kategorie:OSCam]]
{{OSCamHomeLinks}}

== 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 [[http://streamboard.gmc.to/wiki/OSCam/en/examples/Reader]]

{{OSCamServerParameter}}

=== [reader] ===
Define local or remote reader

==== device ====
{{required}}
<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.

==== device_out_endpoint ====
{{Depends/en}}

set endpoint address for FTDI chips
0x81: Infinity USB Smart
0x82: Smartreader+ (default)

==== enable ====
{{Optional/en}}
deactivate reader
0 = off
1 = On (default)

==== key ====
{{Depends/en}}
key for newcamd remote reader encryption
key = DES key

==== user ====
{{Optional/en}}
user for remote reader (name)

==== password ====
{{Optional/en}}
password for remote reader

==== mg-encrypted ====
{{Optional/en}}

mgcamd encrypted '''gbox line'''

format:

{ <IP|hostname> { <local port> <remote port> { <password> { <level> <level> } address> }

default:
MAC address=eth0

==== services ====
{{Optional}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If loadbalancing is enabled in oscam.conf [global] among lb_mode, then there may be '''no entries'''!

[[Datei:WarningS.png|text-bottom]] '''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

==== inactivitytimeout ====
{{Depends/en}}
inactivity timeout in seconds

inactivitytimeout = 2 # timeout in 2 seconds
= # [blank] default

==== reconnecttimeout ====
{{Optional/en}}
TCP reconnect, if missing answers in seconds

Example
reconnecttimeout = 20 # after 20 seconds new connection
= # [blank] default

==== disableserverfilter ====
{{Optional/en}}
ignore caid and ident settings of reader due faulty clients
disableserverfilter = 1 # ignore
= 0 # not ignore (default)

==== smargopatch ====
{{Optional/en}}
NEW svn6402:02/16/2012

smargopatch = 0|1

enable workaround for smartreader+ and reader until native mode works, default = 0

==== sc8in1_dtrrts_patch ====
{{Optional/en}}
NEW svn6402:02/16/2012

sc8in1_dtrrts_patch = 0|1

enable fix for SC8in1/MCR DTR/RTS kernel bug, default = 0

==== label ====
{{required}}

name for reader

Example:
label = easymouse2

==== description ====
{{Optional/en}}

description = text

description of reader, default: [blank] none

==== fallback ====
{{Optional/en}}

Define reader as fallback, standard and fallback reader must have the same group, see '''group'''!
fallback = 1 # fallbackreader
= 0 # no fallbackreader (default)

==== cacheex ====
{{Optional/en}}
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

==== logport ====
{{Optional/en}}

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)

==== caid ====
{{Optional/en}}

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 ====
{{Optional/en}}

exclude reader from auto AU (auto update)
audisabled = 1 # excludet
= 0 # not excludet (default)

==== auprovid ====
{{Optional/en}}
set provider ID to use the right reader for auto AU

Example
auprovid = # 123456
= # [blank] default

==== ecmwhitelist ====
{{Optional/en}}

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

[[Datei:WarningS.png|text-bottom]] '''In normal operation mode this parameter ist not required!'''

[[Datei:MessageS.png|text-bottom]] '''[http://streamboard.gmc.to:8001/wiki/ECMLengthList List of ECM lengths]'''

==== detect ====
{{Depends/en}}

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 ====
{{Depends/en}}

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)

==== mhz ====
{{Optional/en}}

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)

==== deprecated ====
{{Optional/en}}
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

==== cool_timeout_init ====
{{Optional/en}}
NEW svn6286:01/23/2012

cool_timeout_init = timeout

set card init mode for '''AZBox''' internal reader

==== resetcycle ====
{{Optional/en}}
NEW svn5821:08/12/2011

resetcycle = count

number of ECMs until SC reset ist performerd

[[Datei:WarningS.png|text-bottom]] '''Hint:''' Valid for physical readers only!

example:
resetcycle = 0 # disabled [default]
= 5 # reset after 5 ECM's

==== mode ====
{{Depends/en}}
set card init mode for '''AzBox''' reader
mode = 1 # AzBox-Reader
= 0 # none (default)

==== cool_timeout_after_init ====
{{Optional/en}}
NEW svn6253:01/17/2012

[[Datei:WarningS.png|text-bottom]] '''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

==== protocol ====
{{required}}

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

==== ident ====
{{Optional/en}}

[[Datei:WarningS.png|text-bottom]] '''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 ====
{{Optional/en}}

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)

==== group ====
{{required}}
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)

==== emmcache ====
{{Optional/en}}

set EMM cache of local reader

[[Datei:WarningS.png|text-bottom]] '''Attention:'''

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

==== ratelimitecm ====
{{Optional/en}}

number of different SIDs in ECMs allowed for an interval
ratelimitecm = # number
= 0 # (default)

==== ratelimitseconds ====
{{Optional/en}}

interval for rate limit in seconds
ratelimitseconds = # seconds
= 0 # (default)

==== cooldown ====
{{Optional/en}}

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 ====
{{Optional/en}}
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 ====
{{Optional/en}}

block unique EMMs
blockemm-u = 0 # (no block) default
blockemm-u = 1 # (block EMMs, which are addressed to card immediatly) )

==== blockemm-s ====
{{Optional/en}}

block shared EMMs
blockemm-s = 0 # (no block) default
blockemm-s = 1 # (block EMMs, which are addressed to certain groups of cards)

==== blockemm-g ====
{{Optional/en}}

block global EMMs
blockemm-g = 0 # (no block) default
blockemm-g = 1 # (block EMMs, which are addressed to all cards)

==== blockemm-unknown ====
{{Optional/en}}

block unknown types of EMMs
blockemm-unknown = 0 # (no block) default
blockemm-unknown = 1 # (block all unknown kinds of EMMs)

==== blockemm-bylen ====
{{Optional/en}}

blockemm-bylen = [length,length]... (decimal)

block all types of EMMs by length, maximum 10 values, default: none

====saveemm-u ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-u = file name
= 0 (default)

save unique EMMs to file

====saveemm-s ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-s = file name
= 0 (default)

save shared EMMs to file

====saveemm-g ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-g = file name
= 0 (default)

save global EMMs to file

====saveemm-unknown ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-unknown = file name
= 0 (default)

save unkown EMMs to file

==== savenano ====
{{Optional/en}}

OBSOLETE svn5947:09/09/2011

list of EMM-nanos to save to emmlogdir (in hex w/o 0x) or all EMM-nanos, only valid for physical readers

Format
nano[,nano]....|all

Beispiel
savenano = 45,93,7a,ff
= all
= # [blank] default

==== dropbadcws ====
{{Optional/en}}

CHANGE svn5992:10/22/2011

dropbadcws = 0|1

dropbadcws = 1 # reject bad CWs, send "not found" instaed of bad CWs
= 0 # default

==== readnano ====
{{Optional/en}}
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)

==== disablecrccws ====
{{Optional/en}}

NEW svn6004:10/26/2011

disablecrccrws = 1 # disable cw checksum test
= 0 # enable (default)

==== lb_weight ====
{{Optional/en}}

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

See here
[[Datei:Lb_weight_calc2.png]]

==== cccversion ====
{{Depends/en}}

'''Only for CCcam'''

define CCcam version
<nowiki><mainversion>,<version>,</nowiki>

Example
cccversion = 1.2.34

==== cccmaxhops ====
{{Depends/en}}

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 ====
{{Depends/en}}

ccchop = hop

Set hop for '''non''' CCCam readers

default = 0

==== cccreshare ====
{{Depends/en}}

Define reader's CCcam reshare hop

cccreshare = -1 # use [[OSCam/en/Config/oscam.conf#reshare|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 ====
{{Depends/en}}

Request to provide emu from CCCam server, too.
cccwantemu = 1 # yes
= 0 # no (default)

==== ccckeepalive ====
{{Depends/en}}

Send keepalive messages to keep connection to remote CCCam server up
ccckeepalive = 1 # yes
= 0 # no (default)

==== cccreconnect ====
{{Optional/en}}
NEW svn6370:02/10/2012

cccreconnect = timeout (milli-seconds)

reconnect again after ECM request timeout in milli-secons, default = 4000 milliseconds

==== cccmindown ====
{{Depends/en}}

cccmindown = # number
= 0 # default

Filters all readers with hops smaller than number

==== pincode ====
{{Optional/en}}

pincode for '''Conax and Cryptoworks''' SCs
pincode = pincode
= # [blank] default

==== chid ====
{{Optional/en}}

define '''Irdeto ChID''' for reader

Example:
chid = 0100:12
chid = 0100:12;0604:0000BA,000101,00010E,000141
= # [blank] default

==== ins7e ====
{{Optional/en}}
NEW svn5959:09/22/2011

ins7e = payload
= [none] default
Add 26 hex-bytes payload for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

==== ins7e11 ====
{{Optional/en}}
NEW svn6064:12/06/2011

ins7e11 = TA1 Byte
= [none] default
Add TA1 Byte for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

==== force_irdeto ====
{{Optional/en}}

force Irdeto SC mode even if RSA key is set for Irdeto tunneled Nagravion SC
force_irdeto = 1 # yes
= 0 # no (default)

==== nagra_read ====
{{Optional/en}}

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 ====
{{Optional/en}}

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

 

==== fix9993 ====
{{Optional/en}}

fix9993 = 0|1

enabled fix for 9993 error with CAID 0919 SCs.

fix9993 = 1 # enabled
= 0 # disabled (default)

==== boxkey ====
{{Optional/en}}
box key for Nagravision SCs / CAM key for Irdeto SCs

==== aeskeys ====
{{Optional/en}}

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 ====
{{Optional/en}}

number of classes subscriptions to show for '''Viacces-SCs'''
schowcls = quantity
= 0 # (default)

==== boxid ====
{{Optional/en}}

NDS receiver box id
boxid = NDS box ID

==== ndsversion ====
{{Optional/en}}

set NDS '''Videoguard''' version
0 = # autodetection (default)
1 = # NDS Videoguard 1
12 = # NDS Videoguard 1+
2 = # NDS Videoguard 2

{{OSCamTranslatedLinks}}

Streamboard Wiki - Benutzerbeiträge [de-at]

OSCam/en/Config/oscam.server