Streamboard Wiki - Benutzerbeiträge [de-at]

OSCam/en/Config/oscam.server

2020-08-25T12:11:34Z

W33d:

[[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 [[OSCam/en/examples/Reader|example configurations]]

{{OSCamServerParameter}}

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

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

name for reader

Example:
label = easymouse2

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

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

description = text

description of reader, default: [blank] none

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

reader protocol
protocol = mouse (local cardreader)
= internal (all cardreader with "device=/dev/sciX", and internal Coolstream-Reader)
= camd35|cs357x (cascading - camd 3.5-compatible remote server - udp)
= mp35
= smartreader
= serial
= cs378x (camd 3.5-compatible remote server - tcp)
= gbox
= newcamd|newcamd525
= newcamd524
= cccam
= radegast
= pcsc
= constcw
= sc8in1
= smargo

==== device ====
{{required}}

CHANGE svn8057+8059:01/04/2013

CHANGE svn8096:01/13/2013

CHANGE svn8911:09/10/2013

define local or remote reader

device = [<readertype>;]serial:serialnum|bus:device|<device|device:slot>|<ip|hostname>,<port>[,<lport>]|pcsc|<0|1>>|constantcw

set reader type

readertype:
SR: Smartreader+ (default)
SRv2: Smartreader V2
Infinity: Infinity USB
TripleP1: Smargo Triple Reader port 1
TripleP2: Smargo Triple Reader port 2
TripleP3: Smargo Triple Reader port 3

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

serialnum: Serial-Nummer des Smartreader+ or Ininity USB (get the serial number while starting OSCam)

device: device name

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

ip|hostname: IP address or host name

port: TCP/IP port

lport: remapping to local TCP/IP port

PCSC: number of PCSC reader, starting with 0
As an alternative it is possible to select via reader name (part), e.g. "-1:SCR 3310" (names of detected readers are shown by "oscam -d 32")

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

constantcw: constant CW file name

CW-File-Format:
'''Standard'''
CAID:Provider ID:Service ID:PMT ID:ECM PID::key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456::00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

'''Extended OSCam-Format'''
CAID:Provider ID:Service ID:PMT ID:ECM PID:Video PID:key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456:7890:00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

Examples for device parameters
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 ====
{{Depends/en}}

card status (inserted or removed) is detected via a serial device (UART /SCI) handshake input line, called cd, cts, dsr or ring.

detect = cd (default) | cts | dsr | ring | none

* "none" means: no detection line connected to the card reader. The card is always detected as being inside cardreader.

* Inverse detect signal = prefix "!"(eg "detect = !cts")

If '''use_gpio = 1''' is set:

detect = gpio1...gpio7 - Card status detected via a gpio. GPIO means "general purpose input output".

example easymouse 2:
[reader]
label = mymouse
description = mymouse xxx
protocol = mouse
device = /dev/ttyUSB0
services = xxx
boxkey = 1122334455667788
force_irdeto = 1
'''detect = cd'''
mhz = 1000
cardmhz = 600
group = 1,2,3
emmcache = 1,3,2

==== use_gpio ====
{{Depends/en}}
use gpio as card detect/reset
use_gpio = 0 off (default)
use gpio = 1 on

==== cardmhz ====
{{Depends/en}}
CHANGE svn7046:06/12/12

set standard SC frequency in units of 10 kHz, for Irdeto SC set to 600, refer to [[OSCam/en/examples/Overclocking|Overclocking]]
Example:
cardmhz = 600 # Irdeto card
= # [blank] 357 (default)

'''INTERNAL READERS'''

If you use cardmhz >2000 OScam will switch to PLL clocking. Internal readers of boxes from Dream Multimedia GmbH can be clocked more precise with it.

The used cardmhz should reflect the highest frequency of the PLL crystal in the internal cardreader. OSCam will calculate the best PLL divider that comes nearest to the wanted user card speed specified in cardmhz.

Use the following settings:

Models with PPC-CPU (DM500/DM600/DM7000/DM7020) use "cardmhz = 3150"

Models with MIPS-CPU (DM500HD/DM800/DM800SE/DM8k/DM7020HD etc.) use "cardmhz = 2700"

DM7025 is special, use "cardmhz = 8300"

'''If only the parameter cardmhz is set (without mhz = xxx) then Oscam clocks the card automatically with the ATR! '''

E.G. You have a dream 800 HD PVR, thats a mips so you should set cardmhz to 2700. We got a nagra card that should run on 5 MHz. If

you want to clock the card ok just use cardmhz = 2700 an mhz = 500. If you want to overclock it use cardmhz = 2700 and mhz = 900.

Now your card will start to run 9 Mhz. Better monitor it! An overclocked card could run hot or crash suddenly!

Keep in mind that most internal readers of non-dreamboxes clock the cards automatically and copletely ignore any user clockspeed setting. But you should set cardmhz and mhz anyway, as its still used to calculate the correct timings in OSCam. If you set cardmhz/mhz correct the timings will better match with the actual (automatically) clockspeed of the internal card reader. As for a result slighly better ecm responses or more stable functioning.

Dont expect magic here, only overclocking the cardspeed can reduce the ecm response time. Bad timings can only delay it or make the card responses instable!
[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== mhz ====
{{Optional/en}}
CHANGE svn 9064:12/13/2013

set reader frequency in units of 10 kHz, if mhz > cardmhz you are in overclocking mode, refer to [[OSCam/en/examples/Overclocking|Overclocking]]

Example:
# Default 357
cardmhz = 600 # ( 6000 KHz = 6 MHz)
mhz = 1000 # (10000 KHz = 10 MHz)

auto clock speed in '''Dreambox mode''' set to -1. Further Informations about the various (Dream)Boxes can be found [http://www.streamboard.tv/oscam/wiki/ReaderClocks here].

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== autospeed ====
{{Optional/en}}
NEW svn9064:12/01/2013

autospeed = 0|1

autospeed = 0 disabled
autospeed = 1 (default) Sets mhz according to ATR. Currently only used for smartreader, smargo protocol and Dreambox-readers internal protocol. Other readers will be adapted to use this
parameter as well. In webif checked means 1. If you want to overclock your card set autospeed to 0.

==== 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

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

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

CHANGE svn8013:12/29/2012

set endpoint address for FTDI chips
device_out_endpoint = 0x81 # Smargo Triple Reader port 1
= 0x82 # Smartreader+ (default)
= 0x83 # Smargo Triple Reader port 2
= 0x85 # Smargo Triple Reader port 3

==== 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

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

cool_timeout_init = timeout in milli seconds, default = 0

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

==== 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 in milli seconds, default = 0

set read/transmit timeout after SC init in milli-seconds for Coolstream internal reader only, default:150

==== ins2e06 ====
{{Optional}}
NEW svn9568:03/16/2014
add check control for pin payload (4 hex bytes) for NDS Videoguard 2 SCs
ins2e06 = Payload
= # none [blank] (default)
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
http://www.streamboard.tv/oscam/changeset/9568

==== 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
= 11 # 0001 FI + 0001 DI (1 x)
= 13 # 0001 FI + 0011 DI (4 x)
= 14 # 0001 FI + 0100 DI (8 x)
= 15 # 0001 FI + 0101 DI (16 x)

Add TA1 Byte for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
 
==== fix07 ====
NEW svn9884:09/30/2014
{{Optional/en}}
enable 0x07 fix for NDS Viedeoguard 2 SCs
fix07 = 1 # enabled (default)
= 0 # disabled
[[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}}
CHANGE svn7046:06/12/12

RSA key for Nagravision/Tiger SCs / CAM key data for Irdeto SCs, Conax SCs, default = none

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

fix9993 = 0|1

enabled fix for 9993 error with CAID 0919 SCs.

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

==== readtiers ====
{{Optional/en}}
NEW svn10376:02/02/15

readtiers = 0|1|2

method to get tiers of NDS Videoguard SCs

readtiers = 0 # disabled (default)
readtiers = 1 # ins70 (new) method
readtiers = 2 # ins76 (old) method

==== boxkey ====
{{Optional/en}}
box key for Nagravision SCs / CAM key for Irdeto SCs / sessionkey for Seca SCs / CamID for Viaccess

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

pincode for '''Conax, Cryptoworks an Viaccess''' SCs
pincode = pincode
= # [blank] 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

==== 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 = 0500@012345:000102030405060708090a0b0c0d0e0f;0500@543210:0,0,0f0e0d0c0b0a090807060504030201
aeskeys = 0500@012345;key0,key1,key2,key3,key4,key5,...;0500@543210:key0,key1,key2,key3,key4,key5,...
if keys are unknown replace them with 0 exemple: 0500@012345;key0,key1,0,0,key4,key5,...

==== showcls ====
OBSOLETE svn6624:04/23/2012
{{Optional/en}}

number of classes subscriptions to show for '''Viacces-SCs'''
schowcls = quantity
= 0 # (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

==== 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

==== 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)

==== 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'''! 
This parameter is only used for EMM and then it is not used for ECM. So you cannot force ECM to be sent to the card using this parameter. 

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)

==== localcards ====
{{Optional/en}}

Use this reader (for defined CAIDs only) as "local" in LB/reader selection.
It will be handle as a local reader per LB and preferlocalcards settings. In this way, we can consider a network reader as local, like we had a cardreader.

localcards = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]....

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

define '''Irdeto ChID''' for reader

Example:
chid = 0100:12
chid = 0100:12;0604:0000BA,000101,00010E,000141
= # [blank] 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)

==== 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

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

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

inactivitytimeout = seconds
= -1 # reconnect on network failure for '''newcamd''' based readers, even in idle
= 0 # default

==== reconnecttimeout ====
{{Optional/en}}

CHANGE svn7244:08/07/2012

Reconnect from a remote reader, if missing answers in seconds

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

==== connectoninit ====
{{Optional/en}}
NEW svn8235:01/29/2013

connectoninit = 0|1

1 = allow newcamd connections to be established on starup although there isn't a request yet
0 = default

==== keepalive ====
{{Optional/en}}
NEW svn9810:07/22/2014

keepalive = 0|1

1 = allow cs378x TCP socket to be always connected
0 = always on if cacheex reader type

==== 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)

==== fallback_percaid ====
{{Optional/en}}
NEW svn8896:09/04/2013

fallback_percaid = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]...

use reader as fallback for defined CAIDs only, two digit wildcards CAIDs are possible, fallback_percaid overrules fallback. Def.=none

example:
fallback_percaid = 1234:234567;10:345678

==== 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>,<stb-emm>'''''

* <usecache> 0 = # disable usage of emmcache and emmstats (default)
* <usecache> 1 = # enable emmcache, emmstats and save to file if oscam is stopped
* <usecache> 2 = # enable emmcache, emmstats but dont save to file if oscam is stopped

* <rewrite> n = # determines how often one and the same EMM is written. '''only if <usecache> = 1 or 2'''

* <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

* <stb-emm> 0 = # EMM for STB are ignored (default)
* <stb-emm> 1 = # EMM for STB are sent to the reader (very specific usage)

Sumarizing this values is possible. 31 shows all kinds of messages.

Example:
emmcache = 1,3,10,0 # Cache on, write 3 x, log written (2) and blocked (8) = 10 , don't send stb-emm
emmcache = 1,2,6,1 # Cache on, write 2 x, log written (2) and skipped (4) = 6, send stb-emm

'''stb-emm''': is only handy for specific usage (Viaccess: see commit [http://www.streamboard.tv/oscam/changeset/10584 #10584] ) In Viaccess we saw some EMM-G that are for the STB and not for the card. That's why we call it EMM-STB (Set Top Box). Those EMMs are, for exemple, used to define overencryption key (AES) into the STB to encrypt STB-Card dialog.
 

==== emmreassembly ====
{{Optional/en}}
NEW svn8493:03/06/2013

OBSOLETE svn8591:04/01/2013 parameter now in oscam.user!

emmreassembly = 0|1

1 = enable EMM reassembly, default
0 = disable EMM reassembly

should be set for Viaccess and Cryptoworks readers if the client that you are using to send EMMs is reassembling than instead of just sending them to OSCam for processing

 

==== 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

==== cacheex_maxhop ====
{{Optional/en}}
NEW svn6691:05/07/2012

cacheex_maxhop = hops
= default = 10 hops

define maximum hops for cach exchange

==== cacheex_maxhop_lg ====
{{Optional/en}}
NEW svn11588:08/23/20

define a maxhop for lg-flagged cws for push/receive, to allow a higher maxhop than for non-flagged cws

cacheex_maxhop_lg = 0 (default) use value of cacheex_maxhop
= 1 to 10 = set maxhop (if value is lower than cacheex_maxhop, value of cacheex_maxhop is used)

==== cacheex_allow_maxhop ====
{{Optional/en}}
NEW svn11588:08/23/20

set maxhop-settings remote, if remote reader/user has cacheex_allow_maxhop = 1 (default: 0 /opt-in)

cacheex_allow_maxhop = 0|1 (default: 0 /opt-in)

==== cacheex_nopushafter ====
{{Optional/en}}
NEW svn11588:08/23/20

don't forward CWs from local/proxy-reader via CacheEx, if the defined time_in_ms for the CAID is reached

cacheex_nopushafter = CAID:time_in_ms[,n]

==== cacheex_lg_only_remote_settings ====
{{Optional/en}}
NEW svn11588:08/23/20

possibility to deny cacheex-receiver/client(cx2: user / cx3: reader) to overwrite the following settings @ cacheex-sending-instance
cacheex_localgenerated_only
cacheex_lg_only_tab

it makes sense if you want to force your local settings.
if the user/reader isnt allowed to overwrite your values,
* it is still possible for the cacheex-receiver to set cacheex_localgenerated_only=1, if the user/reader define cacheex_localgenerated_only_in=1 ; but it is only @ cacheex-sending-instance possible to disable it
* it is still possible for the cacheex-receiver to add cacheex_lg_only_tab, if the user/reader define cacheex_lg_only_in_tab=1234,1337 ; but it is only merged to the sender-instance cacheex_lg_only_tab values

if cacheex_lg_only_remote_settings @oscam.conf is enabled, the user/reader-settings are ignored.
if cacheex_lg_only_remote_settings @oscam.conf is disabled, the user/reader-settings are used.

cacheex_lg_only_remote_settings = 0|1 (default: 0 /opt-out)

==== cacheex_localgenerated_only ====
{{Optional/en}}
NEW svn11588:08/23/20

forward only CWs which are flagged as localgenerated

cacheex_localgenerated_only = 0|1 (default: 0 /opt-in)

==== cacheex_lg_only_tab ====
{{Optional/en}}
NEW svn11588:08/23/20

forward only CWs which are lg-flagged for these list of caid/provid(s)

if provid FFFFFE is set, all provids for this caid are valid!

cacheex_lg_only_tab = caid1:provid1[,provid2];caid2:provid1;

==== cacheex_localgenerated_only_in ====
{{Optional/en}}
NEW svn11588:08/23/20

drop incoming CWs which are NOT flagged as localgenerated

cacheex_localgenerated_only_in = 0|1 (default: 0 /opt-in)

==== cacheex_lg_only_in_tab ====
{{Optional/en}}
NEW svn11588:08/23/20

allow incoming CWs only if they are lg-flagged for these list of caid/provid(s)

if provid FFFFFE is set, all provids for this caid are valid!

cacheex_lg_only_in_tab = caid1:provid1[,provid2];caid2:provid1;

==== cacheex_lg_only_in_aio_only ====
{{Optional/en}}
NEW svn11588:08/23/20

use drop lg-only settings (cacheex_localgenerated_only_in & cacheex_lg_only_in_tab) only if peer is detected as cx-aio-patched or svn >= 11588

cacheex_lg_only_in_aio_only = 0|1 (default: 0 /opt-in)

==== cacheex_cw_check_for_push ====
{{Optional/en}}
NEW svn11588:08/23/20

push only when cacheex_cw_check counter reached
localgenerated-flagged CWs are always pushed out

cacheex_cw_check_for_push = 0|1 (default: 0 /opt-in)

==== 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)

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

ecmwhitelist = [CAID[@provid]:]length[,length]...[;[CAID[@provid]:]length[,length]...]...

define valid ECM length in '''hex''' and provid for physical reader

example
ecmwhitelist = 10,20,30,0a,0b,0c
= 0100:10,20;0200@12345:0a,4b
[blank] = none (default) and provid 000000

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

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/ECMLengthList|List of ECM lengths]]'''

==== ecmheaderwhitelist ====
{{Optional/en}}
NEW svn7480:09212012

ecmheaderwhitelist = [CAID[@provid]:]header[,header...[;[@provid]:]header[,header]...]...

set valid ECM header per CAID and provid '''in hex'''

default: none, provid = 000000

thread [[Streamboard-Thread:34748|here]]

[[Streamboard:oscam/wiki/HeaderWhitelist|HeaderWhitelist]] here

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

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

==== ecmnotfoundlimit ====
{{Optional/en}}
NEW svn8313:02/07/2013

ecmnotfoundlimit = count

number of ECMs with "not found" answer until the reader will be restarted, 0 = no limit (default)

==== resetcycle ====
{{Optional/en}}
NEW svn5820: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

==== ratelimittime ====
{{Optional/en}}
NEW svn9078:09/12/2013

interval for rate limit in milliseconds
ratelimittime = # milliseconds
= 0 # (default)
 

==== ecmunique ====
{{Optional/en}}
NEW svn8491:03/06/2013

ecmunique = 0|1

1 = enable check for matching ECM hash in ratelimit slot
0 = default

Remark: parameter ratelimitecm must be set to be able to enable this option!

 

==== srvidholdtime ====
{{Optional/en}}
NEW svn9078:09/12/2013

srvidholdtime = milliseconds

time to keep service ID in ratelimit slot, during this time checking for ecmunique ist disabled.
0 = default
 

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

cooldown = delay, duration

define cooldown:
delay = delay in milliseconds for which the reader is allowed to do more
ECM requests then defined by parameter "ratelimitecm"
default: [blank] none
duration = duration in milliseconds the reader needs to cooldown
default: [blank] none

Both parameters are mandatory when used.

'''parameter "ratelimitecm" and "ratelimittime" 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}}

CHANGE svn8615:04/12/2013

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

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

example:
blockemm-bylen = 1-10,11-

 

==== via_emm_global ====
{{Optional/en}}

NEW svn9843:09/05/2014

via_emm_global == 0|1

enables global emm filter for '''viacces'''

'''only for camd35 (cs357x) protocol!'''

0 = default

 

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

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 ====
{{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)

==== use-ssl ====
{{Optional/en}}

NEW svn8725:06/25/20113

use_ssl = 0|1

use_ssl = 1 # use SSL for ghttp protocol
= 0 # default

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

CHANGE svn5992:10/22/2011

dropbadcws = 0|1

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

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

NEW svn6004:10/26/2011

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

====disablecrccws_only_for====
{{Optional/en}}

NEW svn11292:12/21/2016

disablecrccws_only_for = CAID:PROVID;CAID:PROVID

Example :

disablecrccws_only_for = 0500:032830;098C:000000

==== 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]]

==== lb_whitelist_services ====
NEW svn8656:05/22/2013
{{Optional/en}}

lb_whitelist_services = <services>,<services>....

reader assignement to service group for channels which may never be blocked by the loadbalancer to the reader , default=none 
 
 
==== lb_force_fallback ====
{{Optional/en}}

NEW - svn9739:05/19/2014

lb_force_fallback = 0|1

1 = set the reader always as fallback for load blancing without considering the readers statistics 

0 = default
 
 

==== ccc ====

===== 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}}

CHANGE svn8607:04/10/2013

Define reader's CCcam reshare hop

cccreshare = -1 # no resharing
= 0 # reshare for direct peer only
= 1 # reshare for direct peer and next level
= 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}}

cccreconnect = timeout (milli-seconds)

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

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

Filters all readers with hops smaller than number
cccmindown = # number
= 0 # default

 
 

==== '''gbox''' ====
NEW svn8350:02/15/2013
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M: { 192.168.1.101 { A123BCDE }}
D: { 192.168.1.123 { 3820 3819 { 98AF3E25 { 3 3 }}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
[reader]
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client_1

'''oscam.user:'''
[account]
user = gbox_client_1
group = 1

 
 
===== device =====
{{required}}

device = Comma-separated list of values:

peer's IP or hostname
peer's port

example:
device = 192.168.1.101,3820

 

===== password =====
{{required}}

password provided by peer (4 bytes, 8 hex chars)

example:
password = A123BCDE

do not use passwords like AAAAAAAA or AAAABBBB.

 

===== user =====
{{required}}

user name of oscam gbox

example
user = gbox_willy

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''the gbox user must also be set-up in oscam.user [account]'''

'''It is strongly recommended to use for each gbox reader a different (unique) user account,
'''in order to clearly identify the peer tasks and responses

'''You can add to the user account in oscam.user 'caid = caid_1,caid_2,..' to filter cards for a specific peer
'''In this case the user (peer) will get only cards with these CAIDs.
'''Attention: The CAID filter is applied for both Local- and Peer-Cards

'''Set suitable filters (services=, caid=, ident=) in [reader] section
'''to prevent gbox instability by overflooding with too many cards

 

===== gbox_reshare =====
{{Optional/en}}

Share-Level of local card(s)

gbox_reshare = 0|1|...|5 , default = 2, max = 5

examples:

gbox_reshare = 0 - none of your local crds send to peer
gbox_reshare = 1 - local crds send to direct peer only
gbox_reshare = 2 - local crds send to direct peer and his direct peer(s)
etc

 

===== gbox_max_distance =====
{{Optional/en}}

gbox_max_distance = max distance to receive peer cards, default = 2

 

===== gbox_max_ecm_send =====
{{Optional/en}}

gbox_max_ecm_send = send ecm to max <gbox_max_ecm_sen> peer cards, default = 5

 

===== force_remm =====
{{Optional/en}}

Force remote emm

force_remm = 0|1|... , default = 0 (disabled)

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''use only to activate a card or if card entitlements are expired'''

 

===== cccam_reshare =====
{{Optional/en}}

reshare level of ccc proxy cards to be send into gbox network

cccam_reshare = level default = -1

cccam_reshare = -1 # no resharing
= 0 # reshare for direct peer only
= 1 # reshare for direct peer and next level
= x # resharing for direct peer and share level x

 

==== '''DRE''' ====
===== exec_cmd_file =====
{{Optional/en}}

exec_cmd_file = path_to_a_script

===== stmkeys =====
{{Optional/en}}

stmkeys = path_to_a_key_file

===== force_ua =====
{{Optional/en}}

force_ua = 4 Bytes or 8 chars (expressed in hexa)

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.services

2020-08-25T11:54:28Z

W33d:

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

== oscam.services ==
[[Datei:WarningS.png|text-bottom]] '''Attention:''' The number of services that will be considered based reader in oscam.server is limited to 64, or 64 times [[service-name][CAID][provid][srvid]]!

definition of services for OSCam

[service name] =
caid =
provid =
srvid =

=== [service name] ===
{{required}}

Start of a new provider section named ''service name''. Service name sections may appear multiple times; one for each service.

The service name must be unique!

=== caid ===
{{required}}

listing of CAIDs in hex

Format:
CAID[,CAID]...

=== provid ===
{{required}}

Listing of provider IDs in hex. Multiple provider ID's must be separated by a comma (,).

Format:
provider ID[,provider ID]...

=== srvid ===
{{required}}

listing of service IDs in hex

Format:
service ID[,service ID]...

Example:
[myservice]
CAID=0100,0200,000A
provid=000001,ABCDEF
srvid=0001,0002,000A,000B

=== disablecrccws_only_for_exception ===
{{Optional/en}}
NEW svn11588:08/23/20

define a service(caid/s, provid/s, srvid/s) as a exception for disablecrccws_only_for-settings
you dont have to assign this service any user/reader

disablecrccws_only_for_exception = 0|1 (default: 0 /opt-in)

=== no_wait_time ===
{{Optional/en}}
NEW svn11588:08/23/20

define a service(caid/s, provid/s, srvid/s) as a wait_time exception
you dont have to assign this service any user/reader

no_wait_time = 0|1 (default: 0 /opt-in)

=== lg_only_exception ===
{{Optional/en}}
NEW svn11588:08/23/20

define a service(caid/s, provid/s, srvid/s) as a localgenerated-only exception.
so you are able to push/receive non-flagged CWs also when cacheex_localgenerated_only(_in) & cacheex_lg_only(_in)_tab are set
you dont have to assign this service any user/reader

lg_only_exception = 0|1 (default: 0 /opt-in)

An extensive list you find here: '''[[Services|oscam.services]]'''

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.server

2020-08-25T11:52:17Z

W33d:

[[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 [[OSCam/en/examples/Reader|example configurations]]

{{OSCamServerParameter}}

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

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

name for reader

Example:
label = easymouse2

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

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

description = text

description of reader, default: [blank] none

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

reader protocol
protocol = mouse (local cardreader)
= internal (all cardreader with "device=/dev/sciX", and internal Coolstream-Reader)
= camd35|cs357x (cascading - camd 3.5-compatible remote server - udp)
= mp35
= smartreader
= serial
= cs378x (camd 3.5-compatible remote server - tcp)
= gbox
= newcamd|newcamd525
= newcamd524
= cccam
= radegast
= pcsc
= constcw
= sc8in1
= smargo

==== device ====
{{required}}

CHANGE svn8057+8059:01/04/2013

CHANGE svn8096:01/13/2013

CHANGE svn8911:09/10/2013

define local or remote reader

device = [<readertype>;]serial:serialnum|bus:device|<device|device:slot>|<ip|hostname>,<port>[,<lport>]|pcsc|<0|1>>|constantcw

set reader type

readertype:
SR: Smartreader+ (default)
SRv2: Smartreader V2
Infinity: Infinity USB
TripleP1: Smargo Triple Reader port 1
TripleP2: Smargo Triple Reader port 2
TripleP3: Smargo Triple Reader port 3

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

serialnum: Serial-Nummer des Smartreader+ or Ininity USB (get the serial number while starting OSCam)

device: device name

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

ip|hostname: IP address or host name

port: TCP/IP port

lport: remapping to local TCP/IP port

PCSC: number of PCSC reader, starting with 0
As an alternative it is possible to select via reader name (part), e.g. "-1:SCR 3310" (names of detected readers are shown by "oscam -d 32")

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

constantcw: constant CW file name

CW-File-Format:
'''Standard'''
CAID:Provider ID:Service ID:PMT ID:ECM PID::key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456::00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

'''Extended OSCam-Format'''
CAID:Provider ID:Service ID:PMT ID:ECM PID:Video PID:key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456:7890:00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

Examples for device parameters
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 ====
{{Depends/en}}

card status (inserted or removed) is detected via a serial device (UART /SCI) handshake input line, called cd, cts, dsr or ring.

detect = cd (default) | cts | dsr | ring | none

* "none" means: no detection line connected to the card reader. The card is always detected as being inside cardreader.

* Inverse detect signal = prefix "!"(eg "detect = !cts")

If '''use_gpio = 1''' is set:

detect = gpio1...gpio7 - Card status detected via a gpio. GPIO means "general purpose input output".

example easymouse 2:
[reader]
label = mymouse
description = mymouse xxx
protocol = mouse
device = /dev/ttyUSB0
services = xxx
boxkey = 1122334455667788
force_irdeto = 1
'''detect = cd'''
mhz = 1000
cardmhz = 600
group = 1,2,3
emmcache = 1,3,2

==== use_gpio ====
{{Depends/en}}
use gpio as card detect/reset
use_gpio = 0 off (default)
use gpio = 1 on

==== cardmhz ====
{{Depends/en}}
CHANGE svn7046:06/12/12

set standard SC frequency in units of 10 kHz, for Irdeto SC set to 600, refer to [[OSCam/en/examples/Overclocking|Overclocking]]
Example:
cardmhz = 600 # Irdeto card
= # [blank] 357 (default)

'''INTERNAL READERS'''

If you use cardmhz >2000 OScam will switch to PLL clocking. Internal readers of boxes from Dream Multimedia GmbH can be clocked more precise with it.

The used cardmhz should reflect the highest frequency of the PLL crystal in the internal cardreader. OSCam will calculate the best PLL divider that comes nearest to the wanted user card speed specified in cardmhz.

Use the following settings:

Models with PPC-CPU (DM500/DM600/DM7000/DM7020) use "cardmhz = 3150"

Models with MIPS-CPU (DM500HD/DM800/DM800SE/DM8k/DM7020HD etc.) use "cardmhz = 2700"

DM7025 is special, use "cardmhz = 8300"

'''If only the parameter cardmhz is set (without mhz = xxx) then Oscam clocks the card automatically with the ATR! '''

E.G. You have a dream 800 HD PVR, thats a mips so you should set cardmhz to 2700. We got a nagra card that should run on 5 MHz. If

you want to clock the card ok just use cardmhz = 2700 an mhz = 500. If you want to overclock it use cardmhz = 2700 and mhz = 900.

Now your card will start to run 9 Mhz. Better monitor it! An overclocked card could run hot or crash suddenly!

Keep in mind that most internal readers of non-dreamboxes clock the cards automatically and copletely ignore any user clockspeed setting. But you should set cardmhz and mhz anyway, as its still used to calculate the correct timings in OSCam. If you set cardmhz/mhz correct the timings will better match with the actual (automatically) clockspeed of the internal card reader. As for a result slighly better ecm responses or more stable functioning.

Dont expect magic here, only overclocking the cardspeed can reduce the ecm response time. Bad timings can only delay it or make the card responses instable!
[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== mhz ====
{{Optional/en}}
CHANGE svn 9064:12/13/2013

set reader frequency in units of 10 kHz, if mhz > cardmhz you are in overclocking mode, refer to [[OSCam/en/examples/Overclocking|Overclocking]]

Example:
# Default 357
cardmhz = 600 # ( 6000 KHz = 6 MHz)
mhz = 1000 # (10000 KHz = 10 MHz)

auto clock speed in '''Dreambox mode''' set to -1. Further Informations about the various (Dream)Boxes can be found [http://www.streamboard.tv/oscam/wiki/ReaderClocks here].

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== autospeed ====
{{Optional/en}}
NEW svn9064:12/01/2013

autospeed = 0|1

autospeed = 0 disabled
autospeed = 1 (default) Sets mhz according to ATR. Currently only used for smartreader, smargo protocol and Dreambox-readers internal protocol. Other readers will be adapted to use this
parameter as well. In webif checked means 1. If you want to overclock your card set autospeed to 0.

==== 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

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

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

CHANGE svn8013:12/29/2012

set endpoint address for FTDI chips
device_out_endpoint = 0x81 # Smargo Triple Reader port 1
= 0x82 # Smartreader+ (default)
= 0x83 # Smargo Triple Reader port 2
= 0x85 # Smargo Triple Reader port 3

==== 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

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

cool_timeout_init = timeout in milli seconds, default = 0

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

==== 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 in milli seconds, default = 0

set read/transmit timeout after SC init in milli-seconds for Coolstream internal reader only, default:150

==== ins2e06 ====
{{Optional}}
NEW svn9568:03/16/2014
add check control for pin payload (4 hex bytes) for NDS Videoguard 2 SCs
ins2e06 = Payload
= # none [blank] (default)
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
http://www.streamboard.tv/oscam/changeset/9568

==== 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
= 11 # 0001 FI + 0001 DI (1 x)
= 13 # 0001 FI + 0011 DI (4 x)
= 14 # 0001 FI + 0100 DI (8 x)
= 15 # 0001 FI + 0101 DI (16 x)

Add TA1 Byte for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
 
==== fix07 ====
NEW svn9884:09/30/2014
{{Optional/en}}
enable 0x07 fix for NDS Viedeoguard 2 SCs
fix07 = 1 # enabled (default)
= 0 # disabled
[[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}}
CHANGE svn7046:06/12/12

RSA key for Nagravision/Tiger SCs / CAM key data for Irdeto SCs, Conax SCs, default = none

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

fix9993 = 0|1

enabled fix for 9993 error with CAID 0919 SCs.

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

==== readtiers ====
{{Optional/en}}
NEW svn10376:02/02/15

readtiers = 0|1|2

method to get tiers of NDS Videoguard SCs

readtiers = 0 # disabled (default)
readtiers = 1 # ins70 (new) method
readtiers = 2 # ins76 (old) method

==== boxkey ====
{{Optional/en}}
box key for Nagravision SCs / CAM key for Irdeto SCs / sessionkey for Seca SCs / CamID for Viaccess

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

pincode for '''Conax, Cryptoworks an Viaccess''' SCs
pincode = pincode
= # [blank] 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

==== 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 = 0500@012345:000102030405060708090a0b0c0d0e0f;0500@543210:0,0,0f0e0d0c0b0a090807060504030201
aeskeys = 0500@012345;key0,key1,key2,key3,key4,key5,...;0500@543210:key0,key1,key2,key3,key4,key5,...
if keys are unknown replace them with 0 exemple: 0500@012345;key0,key1,0,0,key4,key5,...

==== showcls ====
OBSOLETE svn6624:04/23/2012
{{Optional/en}}

number of classes subscriptions to show for '''Viacces-SCs'''
schowcls = quantity
= 0 # (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

==== 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

==== 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)

==== 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'''! 
This parameter is only used for EMM and then it is not used for ECM. So you cannot force ECM to be sent to the card using this parameter. 

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)

==== localcards ====
{{Optional/en}}

Use this reader (for defined CAIDs only) as "local" in LB/reader selection.
It will be handle as a local reader per LB and preferlocalcards settings. In this way, we can consider a network reader as local, like we had a cardreader.

localcards = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]....

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

define '''Irdeto ChID''' for reader

Example:
chid = 0100:12
chid = 0100:12;0604:0000BA,000101,00010E,000141
= # [blank] 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)

==== 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

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

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

inactivitytimeout = seconds
= -1 # reconnect on network failure for '''newcamd''' based readers, even in idle
= 0 # default

==== reconnecttimeout ====
{{Optional/en}}

CHANGE svn7244:08/07/2012

Reconnect from a remote reader, if missing answers in seconds

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

==== connectoninit ====
{{Optional/en}}
NEW svn8235:01/29/2013

connectoninit = 0|1

1 = allow newcamd connections to be established on starup although there isn't a request yet
0 = default

==== keepalive ====
{{Optional/en}}
NEW svn9810:07/22/2014

keepalive = 0|1

1 = allow cs378x TCP socket to be always connected
0 = always on if cacheex reader type

==== 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)

==== fallback_percaid ====
{{Optional/en}}
NEW svn8896:09/04/2013

fallback_percaid = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]...

use reader as fallback for defined CAIDs only, two digit wildcards CAIDs are possible, fallback_percaid overrules fallback. Def.=none

example:
fallback_percaid = 1234:234567;10:345678

==== 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>,<stb-emm>'''''

* <usecache> 0 = # disable usage of emmcache and emmstats (default)
* <usecache> 1 = # enable emmcache, emmstats and save to file if oscam is stopped
* <usecache> 2 = # enable emmcache, emmstats but dont save to file if oscam is stopped

* <rewrite> n = # determines how often one and the same EMM is written. '''only if <usecache> = 1 or 2'''

* <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

* <stb-emm> 0 = # EMM for STB are ignored (default)
* <stb-emm> 1 = # EMM for STB are sent to the reader (very specific usage)

Sumarizing this values is possible. 31 shows all kinds of messages.

Example:
emmcache = 1,3,10,0 # Cache on, write 3 x, log written (2) and blocked (8) = 10 , don't send stb-emm
emmcache = 1,2,6,1 # Cache on, write 2 x, log written (2) and skipped (4) = 6, send stb-emm

'''stb-emm''': is only handy for specific usage (Viaccess: see commit [http://www.streamboard.tv/oscam/changeset/10584 #10584] ) In Viaccess we saw some EMM-G that are for the STB and not for the card. That's why we call it EMM-STB (Set Top Box). Those EMMs are, for exemple, used to define overencryption key (AES) into the STB to encrypt STB-Card dialog.
 

==== emmreassembly ====
{{Optional/en}}
NEW svn8493:03/06/2013

OBSOLETE svn8591:04/01/2013 parameter now in oscam.user!

emmreassembly = 0|1

1 = enable EMM reassembly, default
0 = disable EMM reassembly

should be set for Viaccess and Cryptoworks readers if the client that you are using to send EMMs is reassembling than instead of just sending them to OSCam for processing

 

==== 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

==== cacheex_maxhop ====
{{Optional/en}}
NEW svn6691:05/07/2012

cacheex_maxhop = hops
= default = 10 hops

define maximum hops for cach exchange

==== cacheex_maxhop_lg ====
{{Optional/en}}
NEW svn11588:08/23/20

define a maxhop for lg-flagged cws for push/receive, to allow a higher maxhop than for non-flagged cws

cacheex_maxhop_lg = 0 (default) use value of cacheex_maxhop
= 1 to 10 = set maxhop (if value is lower than cacheex_maxhop, value of cacheex_maxhop is used)

==== cacheex_nopushafter ====
{{Optional/en}}
NEW svn11588:08/23/20

don't forward CWs from local/proxy-reader via CacheEx, if the defined time_in_ms for the CAID is reached

cacheex_nopushafter = CAID:time_in_ms[,n]

==== cacheex_lg_only_remote_settings ====
{{Optional/en}}
NEW svn11588:08/23/20

possibility to deny cacheex-receiver/client(cx2: user / cx3: reader) to overwrite the following settings @ cacheex-sending-instance
cacheex_localgenerated_only
cacheex_lg_only_tab

it makes sense if you want to force your local settings.
if the user/reader isnt allowed to overwrite your values,
* it is still possible for the cacheex-receiver to set cacheex_localgenerated_only=1, if the user/reader define cacheex_localgenerated_only_in=1 ; but it is only @ cacheex-sending-instance possible to disable it
* it is still possible for the cacheex-receiver to add cacheex_lg_only_tab, if the user/reader define cacheex_lg_only_in_tab=1234,1337 ; but it is only merged to the sender-instance cacheex_lg_only_tab values

if cacheex_lg_only_remote_settings @oscam.conf is enabled, the user/reader-settings are ignored.
if cacheex_lg_only_remote_settings @oscam.conf is disabled, the user/reader-settings are used.

cacheex_lg_only_remote_settings = 0|1 (default: 0 /opt-out)

==== cacheex_localgenerated_only ====
{{Optional/en}}
NEW svn11588:08/23/20

forward only CWs which are flagged as localgenerated

cacheex_localgenerated_only = 0|1 (default: 0 /opt-in)

==== cacheex_lg_only_tab ====
{{Optional/en}}
NEW svn11588:08/23/20

forward only CWs which are lg-flagged for these list of caid/provid(s)

if provid FFFFFE is set, all provids for this caid are valid!

cacheex_lg_only_tab = caid1:provid1[,provid2];caid2:provid1;

==== cacheex_localgenerated_only_in ====
{{Optional/en}}
NEW svn11588:08/23/20

drop incoming CWs which are NOT flagged as localgenerated

cacheex_localgenerated_only_in = 0|1 (default: 0 /opt-in)

==== cacheex_lg_only_in_tab ====
{{Optional/en}}
NEW svn11588:08/23/20

allow incoming CWs only if they are lg-flagged for these list of caid/provid(s)

if provid FFFFFE is set, all provids for this caid are valid!

cacheex_lg_only_in_tab = caid1:provid1[,provid2];caid2:provid1;

==== cacheex_lg_only_in_aio_only ====
{{Optional/en}}
NEW svn11588:08/23/20

use drop lg-only settings (cacheex_localgenerated_only_in & cacheex_lg_only_in_tab) only if peer is detected as cx-aio-patched or svn >= 11588

cacheex_lg_only_in_aio_only = 0|1 (default: 0 /opt-in)

==== cacheex_cw_check_for_push ====
{{Optional/en}}
NEW svn11588:08/23/20

push only when cacheex_cw_check counter reached
localgenerated-flagged CWs are always pushed out

cacheex_cw_check_for_push = 0|1 (default: 0 /opt-in)

==== 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)

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

ecmwhitelist = [CAID[@provid]:]length[,length]...[;[CAID[@provid]:]length[,length]...]...

define valid ECM length in '''hex''' and provid for physical reader

example
ecmwhitelist = 10,20,30,0a,0b,0c
= 0100:10,20;0200@12345:0a,4b
[blank] = none (default) and provid 000000

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

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/ECMLengthList|List of ECM lengths]]'''

==== ecmheaderwhitelist ====
{{Optional/en}}
NEW svn7480:09212012

ecmheaderwhitelist = [CAID[@provid]:]header[,header...[;[@provid]:]header[,header]...]...

set valid ECM header per CAID and provid '''in hex'''

default: none, provid = 000000

thread [[Streamboard-Thread:34748|here]]

[[Streamboard:oscam/wiki/HeaderWhitelist|HeaderWhitelist]] here

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

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

==== ecmnotfoundlimit ====
{{Optional/en}}
NEW svn8313:02/07/2013

ecmnotfoundlimit = count

number of ECMs with "not found" answer until the reader will be restarted, 0 = no limit (default)

==== resetcycle ====
{{Optional/en}}
NEW svn5820: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

==== ratelimittime ====
{{Optional/en}}
NEW svn9078:09/12/2013

interval for rate limit in milliseconds
ratelimittime = # milliseconds
= 0 # (default)
 

==== ecmunique ====
{{Optional/en}}
NEW svn8491:03/06/2013

ecmunique = 0|1

1 = enable check for matching ECM hash in ratelimit slot
0 = default

Remark: parameter ratelimitecm must be set to be able to enable this option!

 

==== srvidholdtime ====
{{Optional/en}}
NEW svn9078:09/12/2013

srvidholdtime = milliseconds

time to keep service ID in ratelimit slot, during this time checking for ecmunique ist disabled.
0 = default
 

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

cooldown = delay, duration

define cooldown:
delay = delay in milliseconds for which the reader is allowed to do more
ECM requests then defined by parameter "ratelimitecm"
default: [blank] none
duration = duration in milliseconds the reader needs to cooldown
default: [blank] none

Both parameters are mandatory when used.

'''parameter "ratelimitecm" and "ratelimittime" 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}}

CHANGE svn8615:04/12/2013

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

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

example:
blockemm-bylen = 1-10,11-

 

==== via_emm_global ====
{{Optional/en}}

NEW svn9843:09/05/2014

via_emm_global == 0|1

enables global emm filter for '''viacces'''

'''only for camd35 (cs357x) protocol!'''

0 = default

 

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

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 ====
{{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)

==== use-ssl ====
{{Optional/en}}

NEW svn8725:06/25/20113

use_ssl = 0|1

use_ssl = 1 # use SSL for ghttp protocol
= 0 # default

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

CHANGE svn5992:10/22/2011

dropbadcws = 0|1

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

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

NEW svn6004:10/26/2011

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

====disablecrccws_only_for====
{{Optional/en}}

NEW svn11292:12/21/2016

disablecrccws_only_for = CAID:PROVID;CAID:PROVID

Example :

disablecrccws_only_for = 0500:032830;098C:000000

==== 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]]

==== lb_whitelist_services ====
NEW svn8656:05/22/2013
{{Optional/en}}

lb_whitelist_services = <services>,<services>....

reader assignement to service group for channels which may never be blocked by the loadbalancer to the reader , default=none 
 
 
==== lb_force_fallback ====
{{Optional/en}}

NEW - svn9739:05/19/2014

lb_force_fallback = 0|1

1 = set the reader always as fallback for load blancing without considering the readers statistics 

0 = default
 
 

==== ccc ====

===== 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}}

CHANGE svn8607:04/10/2013

Define reader's CCcam reshare hop

cccreshare = -1 # no resharing
= 0 # reshare for direct peer only
= 1 # reshare for direct peer and next level
= 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}}

cccreconnect = timeout (milli-seconds)

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

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

Filters all readers with hops smaller than number
cccmindown = # number
= 0 # default

 
 

==== '''gbox''' ====
NEW svn8350:02/15/2013
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M: { 192.168.1.101 { A123BCDE }}
D: { 192.168.1.123 { 3820 3819 { 98AF3E25 { 3 3 }}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
[reader]
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client_1

'''oscam.user:'''
[account]
user = gbox_client_1
group = 1

 
 
===== device =====
{{required}}

device = Comma-separated list of values:

peer's IP or hostname
peer's port

example:
device = 192.168.1.101,3820

 

===== password =====
{{required}}

password provided by peer (4 bytes, 8 hex chars)

example:
password = A123BCDE

do not use passwords like AAAAAAAA or AAAABBBB.

 

===== user =====
{{required}}

user name of oscam gbox

example
user = gbox_willy

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''the gbox user must also be set-up in oscam.user [account]'''

'''It is strongly recommended to use for each gbox reader a different (unique) user account,
'''in order to clearly identify the peer tasks and responses

'''You can add to the user account in oscam.user 'caid = caid_1,caid_2,..' to filter cards for a specific peer
'''In this case the user (peer) will get only cards with these CAIDs.
'''Attention: The CAID filter is applied for both Local- and Peer-Cards

'''Set suitable filters (services=, caid=, ident=) in [reader] section
'''to prevent gbox instability by overflooding with too many cards

 

===== gbox_reshare =====
{{Optional/en}}

Share-Level of local card(s)

gbox_reshare = 0|1|...|5 , default = 2, max = 5

examples:

gbox_reshare = 0 - none of your local crds send to peer
gbox_reshare = 1 - local crds send to direct peer only
gbox_reshare = 2 - local crds send to direct peer and his direct peer(s)
etc

 

===== gbox_max_distance =====
{{Optional/en}}

gbox_max_distance = max distance to receive peer cards, default = 2

 

===== gbox_max_ecm_send =====
{{Optional/en}}

gbox_max_ecm_send = send ecm to max <gbox_max_ecm_sen> peer cards, default = 5

 

===== force_remm =====
{{Optional/en}}

Force remote emm

force_remm = 0|1|... , default = 0 (disabled)

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''use only to activate a card or if card entitlements are expired'''

 

===== cccam_reshare =====
{{Optional/en}}

reshare level of ccc proxy cards to be send into gbox network

cccam_reshare = level default = -1

cccam_reshare = -1 # no resharing
= 0 # reshare for direct peer only
= 1 # reshare for direct peer and next level
= x # resharing for direct peer and share level x

 

==== '''DRE''' ====
===== exec_cmd_file =====
{{Optional/en}}

exec_cmd_file = path_to_a_script

===== stmkeys =====
{{Optional/en}}

stmkeys = path_to_a_key_file

===== force_ua =====
{{Optional/en}}

force_ua = 4 Bytes or 8 chars (expressed in hexa)

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.user

2020-08-25T11:43:51Z

W33d:

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

== oscam.user ==
The user configuration file for OSCam contains user definitions. [account] sections in oscam.user are recurring (more than one account).

=== [account] ===
{{OSCamUserParameter}}

==== user ====
{{required}}

account name

Example:
user = user1

Default:
user =

==== pwd ====
{{required}}

password for account

[[Datei:WarningS.png|text-bottom]] '''Gbox Protocol:''' pwd is not required

Example:
pwd = pwuser1

Default:
pwd =

==== description ====
{{Optional/en}}
description of user account (text)

Описание аккаунта пользователя (текст)

==== disabled ====
{{Optional/en}}

account disabled

Beispiel:
disabled = 0 # (account enabled)
disabled = 1 # (account disabled)

Default:
disabled = 0

==== hostname ====
{{Optional/en}}
host from which user connection is allowed

Example:
hostname = client.dyndns.org

Default:
hostname =

==== expdate ====
{{Optional/en}}

expiration date for account

Format:
<year>-<month>-<day>|<year>/<month>/<day>

Example:
expdate = 2001-11-21
expdate = 2002/12/22

Default:
expdate = none

==== allowedprotocols ====
{{Optional/en}}

allowedprotocols = [protocol1][,][protocol2][,][protocol3][,]...

allowed protocols for user

protocols
camd33
camd35
cs357x
cs378x
newcamd
cccam
gbox
radegast

example
allowedprotocols = cs357x,gbox # only cs357x and gbox protocols are allowed
= [blank] # all protocols are allowed (default)

==== allowedtimeframe ====
{{Optional/en}}

account enabled from - to for specified day(s)

Format:
DAY@HH:MM-HH:MM[,HH:MM-HH:MM][,HH:MM-HH:MM][;DAY@HH:MM-HH:MM[,HH:MM-HH:MM][,HH:MM-HH:MM]]
where DAY=SUN,MON,TUE,WED,THU,FRI,SAT or ALL (for all possible days)

comma (,) to separate times and semicolon(;) to separate the different days.
You can use ALL@ if you want the same time frames for everyday.

Day starts at 00:00 and end at 24:00, so to cover a full day use: DAY@00:00-24:00

Example:
allowedtimeframe = ALL@10:00-22:00;MON@00:00-02:00,02:45-04:37;FRI@00:00-10:00,22:00-24:00;SAT@00:00-24:00

If you use: XXX@22:00-05:00 this will be turned into XXX@00:00-05:00,22:00-24:00 
ALL@ is always checked and used, so you can watch TV the whole day on FRIday in this exemple. There is no problem to overlap ALL@ in a day definition, like for SAT@ definition.

Default:
allowedtimeframe =

==== uniq ====
{{Optional/en}}

Example:
uniq = 0 # disabled, default
uniq = 1 # only one connection per user is allowed
uniq = 2 # set user to fake if source ip is different
(e.g. for newcamd clients with different CAIDs and ports)
uniq = 3 # only one connection per user, but only the last login will survive (old mpcs behavior)
uniq = 4 # set user only to fake if source ip is different, but only the last login will survive

Default:
uniq = 0

==== numusers ====
{{Depends/en}}

used only '''if anticascading''' is enabled!

numusers = # quantity

user per account

Example:
numusers = -1 # (global value from oscam.conf, default)
numusers = 5 # (maximal 5 user)
numusers = 0 # (anticascading disabled)

==== penalty ====
{{Depends/en}}

used only if '''anticascading''' is enabled!

level of penalty:
'''penalty = -1''' # use value of [[OSCam/en/Config/oscam.conf#penalty|penalty]] defined in oscam.conf ('''default''')
penalty = 0 # only logging
penalty = 1 # send fake DWs
penalty = 2 # ban user temporary
penalty = 3 # send DWs with delay ([[OSCam/en/Config/oscam.conf#fakedelay|fakedelay]])

==== fakedelay ====
{{Optional/en}}
NEW svn7785:10/22/2012

fakedelay = milli seconds or 0|-1

se fake delay time individually for user

0 = fake delay disabled
-1 = fake delay of oscam.conf[global] (default)
= fake delay in milli seconds for user

==== failban ====
{{Optional}}

CHANGE svn 7772:10/21/2012

mask for IP based blocking:

failban = 0|2|4|8

failban = 0 # ignore (default)
failban = 2 # block IP address of a disabled account on connecting
failban = 4 # block IP address of a sleeping account while sleeping comes up
failban = 8 # block duplicate IP address
 
 

==== acosc_max_active_sids ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014 

acosc_max_active_sids = count

maximum active SIDs with anti-cascading over SID
 
0 = unlimited, default
-1 = use global setting from oscam.conf [global]
 
 

==== acosc_zap_limit ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_zap_limit = count
 
zap-limit for anticascading over SID
 
0 = unlimited, default
-1 = use global setting from oscam.conf.[global]
 
 
==== acosc_penalty ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_penalty = 0|1|2|3|-1
 
level of penalty with anti-cascading over SID
 
0 = only logging, default
1 = send fake CW's
2 = temporary user ban
3 = send delayed CW's
-1 = use global setting from oscam.conf [global]
 
 
==== acosc_penalty_duration ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_penalty_duration = seconds
 
penalty duration for anti-cascading over SID
 
0 = mone, default
-1 = use global setting from oscam.conf[global]
 
 
==== acosc_delay ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_delay = milli-seconds
 
Dauer des delay für anti-cascading über SID
 
0 = none, default
-1 = use global setting Oscam.conf[global]
 
 

==== lb_nbest_readers ====
{{Optional/en}}
NEW svn8642:05/10/2013

lb_nbest_readers = count

set count of best readers for load balancing

-1 = use global lb_nbest_readers in oscam.conf
1 = default

==== lb_nbest_percaid ====
{{Optional/en}}
NEW svn8642:05/10/2013

lb_nbest_percaid = CAID1:count1[,CAID2:count2]...

set count of best readers per CAIDs for load balancing, wildcards CAIDs with two-digit CAIDs possible.
default = none

example
lb_nbest_percaid = 0100:4,0200:3,03:2,04:1
(wildcards CAIDs 03xx and 04xx)

==== preferlocalcards ====
{{Optional/en}}

NEW svn 10050:11/30/2014

preferlocalcards = 0|-1|1|2

-1 = global value from oscam.sonf[global] (default)
0 = local SCs used like a remote reader
1 = prefer call exchange based SCs
2 = prefer local SCs

==== cwc_disable ====
{{Optional/en}}
NEW svn 10049:11/30/2014

cwc_disable = 0|1

1 = disable cw cycle check
0 = default

==== cacheex ====
{{Optional/en}}
NEW svn6039:11/26/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.server!

Identical cache exchange modes must be set on local OSCam user account and remote OSCam server!

===== 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 ECMs.

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 ====
{{Optional/en}}
NEW svn6691:05/07/2012

cacheex_maxhop = hops
= defaolt = 10 hops

define maximum hops for cache exchange

==== sleep ====
{{Optional/en}}

time waiting for inactive user in minutes

Example:
sleep = 5

Default:
sleep =

==== sleepsend ====
{{Optional/en}}
0|255

255 = '''OSCam client''' only: stopping requests until next zap,

255 = '''camd 3.x''' only: stopping requests until restart of camd3 client

Examples:
sleepsend = 0
sleepsend = 255

Default:
sleepsend =

==== suppresscmd08 ====
{{Optional/en}}

switches suppress of CMD08

suppresscmd08 = 0 # CMD08 for camd3 3.57x/3.78x clients '''enabled'''
suppresscmd08 = 1 # CMD08 for camd3 3.57x/3.78x clients '''disabled'''

Default:
suppresscmd08 = 0

==== keepalive ====
{{Optional/en}}

disable keepalive between newcamd-server and client connection

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

==== umaxidle ====
{{Optional/en}}

NEW svn8929:09/25/2013

CHANGE svn 9801:07/17/2014

umaxidle = seconds

value for user being idle before disconnect.

-1 = use clientmaxidle in [global]-section
0 = idle disconnect 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)

==== au ====
{{Optional/en}}

Format:
label of reader[,label of reader]...|1

AU settings:
au = [label of reader] # sending EMMs to specified reader
(security issue: clients can see SC data!)
au = 1 # auto AU is sending EMMs to all readers
(security issue: clients can see SC data!)
Default:
au = [blank] # none

Sometimes only global emm's update '''same caid cards''':

- check if you blocked unique/shared in READER Blockemm

- don't use au = 1, use au = [label of reader]

- if still troublesome use '''in house''' different user to update each card by [label of reader]

example: cd__nl and tv__vl have a common provider: m7 group sa and share updates on shared channels.

user 1: AU: cd__nl,sky_uk

user 2: AU: tv__vl

==== group ====
{{required}}
CHANGE svn6103:12/21/2011

user assingment to reader group. Valid 64 groups

Format:
group = 1....64[,1....64]....
default = none

==== betatunnel ====
{{Optional/en}}

define Betacrypt tunneling (max. see CS_MAXTUNTAB in globals.h). The ServiceID can also be used for wildcarded CAIDs.

Format:
<CAID>.<ServiceID>:<target CAID>[,<CAID>.<ServiceID>: <target CAID>]...

Example:
betatunnel = 0100.0001:0200,0300.0004:0500
betatunnel = 0600.FFFF:0700

Default:
betatunnel =
 

==== emmreassembly ====
{{Optional/en}}

NEW svn8591:01/04/2013

emmreassembly = 0|1||2

EMM reassembly, should be set for Viaccess and Cryptoworks readers if the client that you are using to send EMMs is reassembling them instead of just sending them to OSCam for processing.

0: disabled
1: enabled for DVB API
2: enabled (default)

==== services ====
{{Optional/en}}

What services may use the User.? 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, exactly, then if you have a positive service, 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.

Example:
services = service1,!service2 # (client may receive service1, but not service2)
services = [!]services

Default:
services =

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

user assingment to SC specific idents

Format:
<CAID>:<ident>[,<ident>,...][;<CAID>:<ident>[,<ident>,...]]...

default = none

==== class ====
{{Optional/en}}

user [de]assingment to SC specific classes

Format:
[!]class[,[!]class]...

Example:
class = 01,02,!03,!04

default = none

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

user assingment to SC specific ChID

Format:
chid = <CAID>:<ChID>[,<ChID>,...][;<CAID>:<ChID>[,<ChID>,...]]...
= [blank] default

==== monlevel ====
{{Optional/en}}

monitor level:
monlevel = 0 # no access to monitor
monlevel = 1 # only server and own procs
monlevel = 2 # all procs, but viewing only, default
monlevel = 3 # all procs, reload of oscam.user possible
monlevel = 4 # complete access

==== ccc ====

===== cccmaxhops =====
{{Depends/en}}
only if '''CCcam proxies or CCcam server''' are used!

maximum hops limit for CCcam clients

cccmaxhops = -1 # CCcam disbled for this user
0 # local SCs only
1 # local SCs + 1 hop
2 # local SCs + 2 hops
# and so on

Default:
cccmaxhops = 10 # local SC's + 10 hops

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

CHANGE svn8608:04/10/2013

reshare level for CCcam clients

Example:
cccreshare = -1 # use [[OSCam/en/Config/oscam.conf#reshare|reshare]] level defined in oscam.conf - default
= 0 # reshare for direct peer only
= 1 # resharing for direct peer and next level

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 !

===== cccignorereshare =====
{{Depends/en}}

only if '''CCcam proxies or CCcam server''' are used!

CCcam ignore reshare settings

cccignorereshare = -1 # use ignore reshare level of oscam.conf [ccc] - default
= 0 # use ignore reshare level of server
= 1 # use ignore reshare level of reader or user

===== cccstealth =====
{{Depends/en}}

cccstealth = -1|0|1

-1 = # use CCcam stealth of oscam.conf [ccc] - default
0 = # use extendet OSCam-CCcam-protocol
1 = # behaviour like the original CCcam-protocol, no activate partner detection and extendet
OSCam-CCcam-protocol, prevent other OSCam to detect the server as OSCam-server

==== cacheex_nopushafter ====
{{Optional/en}}
NEW svn11588:08/23/20

don't forward CWs from local/proxy-reader via CacheEx, if the defined time_in_ms for the CAID is reached

cacheex_nopushafter = CAID:time_in_ms[,n]

==== cacheex_lg_only_remote_settings ====
{{Optional/en}}
NEW svn11588:08/23/20

possibility to deny cacheex-receiver/client(cx2: user / cx3: reader) to overwrite the following settings @ cacheex-sending-instance
cacheex_localgenerated_only
cacheex_lg_only_tab

it makes sense if you want to force your local settings.
if the user/reader isnt allowed to overwrite your values,
* it is still possible for the cacheex-receiver to set cacheex_localgenerated_only=1, if the user/reader define cacheex_localgenerated_only_in=1 ; but it is only @ cacheex-sending-instance possible to disable it
* it is still possible for the cacheex-receiver to add cacheex_lg_only_tab, if the user/reader define cacheex_lg_only_in_tab=1234,1337 ; but it is only merged to the sender-instance cacheex_lg_only_tab values

if cacheex_lg_only_remote_settings @oscam.conf is enabled, the user/reader-settings are ignored.
if cacheex_lg_only_remote_settings @oscam.conf is disabled, the user/reader-settings are used.

cacheex_lg_only_remote_settings = 0|1 (default: 0 /opt-out)

==== cacheex_localgenerated_only ====
{{Optional/en}}
NEW svn11588:08/23/20

forward only CWs which are flagged as localgenerated

cacheex_localgenerated_only = 0|1 (default: 0 /opt-in)

==== cacheex_lg_only_tab ====
{{Optional/en}}
NEW svn11588:08/23/20

forward only CWs which are lg-flagged for these list of caid/provid(s)

if provid FFFFFE is set, all provids for this caid are valid!

cacheex_lg_only_tab = caid1:provid1[,provid2];caid2:provid1;

==== cacheex_localgenerated_only_in ====
{{Optional/en}}
NEW svn11588:08/23/20

drop incoming CWs which are NOT flagged as localgenerated

cacheex_localgenerated_only_in = 0|1 (default: 0 /opt-in)

==== cacheex_lg_only_in_tab ====
{{Optional/en}}
NEW svn11588:08/23/20

allow incoming CWs only if they are lg-flagged for these list of caid/provid(s)

if provid FFFFFE is set, all provids for this caid are valid!

cacheex_lg_only_in_tab = caid1:provid1[,provid2];caid2:provid1;

==== cacheex_lg_only_in_aio_only ====
{{Optional/en}}
NEW svn11588:08/23/20

use drop lg-only settings (cacheex_localgenerated_only_in & cacheex_lg_only_in_tab) only if peer is detected as cx-aio-patched or svn >= 11588

cacheex_lg_only_in_aio_only = 0|1 (default: 0 /opt-in)

==== cacheex_maxhop_lg ====
{{Optional/en}}
NEW svn11588:08/23/20

define a maxhop for lg-flagged cws for push/receive, to allow a higher maxhop than for non-flagged cws

cacheex_maxhop_lg = 0 (default) use value of cacheex_maxhop
= 1 to 10 = set maxhop (if value is lower than cacheex_maxhop, value of cacheex_maxhop is used)

==== cacheex_allow_maxhop ====
{{Optional/en}}
NEW svn11588:08/23/20

set maxhop-settings remote, if remote reader/user has cacheex_allow_maxhop = 1 (default: 0 /opt-in)

cacheex_allow_maxhop = 0|1 (default: 0 /opt-in)

==== cacheex_cw_check_for_push ====
{{Optional/en}}
NEW svn11588:08/23/20

push only when cacheex_cw_check counter reached
localgenerated-flagged CWs are always pushed out

cacheex_cw_check_for_push = 0|1 (default: 0 /opt-in)

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2020-08-25T11:23:27Z

W33d:

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

==oscam.conf==

=== The [global] section ===

The main configuration file for OSCam contains global parameters such as debugging, logging, monitor, protocols and anti-cascading. Sections in oscam.conf are nonrecurring. The [global] section is required. All other sections are optional.

{{OSCamConfGlobalParameter}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If a parameter is empty or is not listed in config-file, then apply the default values !

==== nice ====
{{Optional/en}}

'''Systempriority'''

OSCam requires almost no CPU-power. But if CPU-power is required, it should be available immediatly. Values between 20 and -20 are possible. 20 = low, -20 = very high. If this parameter is commented out (#), this function is not called. Important for example for dbox2[http://de.wikipedia.org/wiki/DBOX2], if the error messages "''relocation error:setpriority''". See [http://de.wikipedia.org/wiki/Prioritätsscheduling Prioritätsscheduling]

Example:
nice = -1

Default:
nice = 99

==== Log ====
Format:
CAID&ProviderID/ECMPID/ServiceID/length:checksum

Debug-Level:
0 = no debugging (default)
1 = detailed error messages
2 = ATR parsing info, ECM dumps, CW dumps
4 = traffic from/to the reader
8 = traffic from/to the clients
16 = traffic to the reader-device on IFD layer
32 = traffic to the reader-device on I/O layer
64 = EMM logging
128 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== logfile =====
{{optional/en}}

Logging target
logfile = [filename][;syslog][;stdout]

You can define a maximum of one filename (not more!) and additionally to log to stdout or syslog (you can also only log to stdout or syslog and omit the filename).

Opportunities:

logfile = /var/log/oscam.log # file or linux device (for example /dev/tty)
logfile = syslog # log to syslogd
logfile = stdout # showing the log on the console

Example:
logfile = /etc/oscam/logs/oscam.log;stdout

Default:
logfile = /var/log/oscam.log

Format logfile:
CAID&ident/provider/length:checksum

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

===== loghistorysize =====
{{optional/en}}

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== maxlogsize =====
{{required}}

Here the maximum size of logfiles are set in KBytes. This is especially important for server with only a small amount of memory (dbox2). Therefore it is strongly recomended to determine carefully that size at such servers. Not infrequently a system "bursting" because the logfile uncontrolled large scale adopted!

Example
maxlogsize = 20 # Logfile reaches to 20 KBytes
= 0 # Logfile '''unlimited'''

Default:
maxlogsize = 10 # Logfile reaches to 10 KBytes (default)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = default

===== disablelog =====
{{optional/en}}

switches logfile '''off'''
1 = '''no log'''
0 = '''log'''

Example:
disablelog = 1 # '''no''' log

Default:
disablelog = 0 # '''log'''

===== cwlogdir =====
{{Optional/en}}

A path for cw logging can be configured here. The path is relative to the work directory and must exist. Otherwise no logs are created and no errors are reported.

CWs (control words) are the answers of the card which decrypts a certain channel for some seconds before the next cw is transmitted. The CW log file can be used for delayed decoding of this channel. This is also called offline decoding. Watch this [http://www.youtube.com/watch?v=-K--PEFYBng]

Oscam creates a new *.cwl file for each channel and each day. The file name contains the date, service ID and service name, e.g. 110808_I000B_Sky_Cinema_+1.cwl with this contents:

<syntaxhighlight lang="bash">
# OSCam cardserver v0.99.4 - http://streamboard.gmc.to:8001/oscam/wiki
# control word log file for use with tsdec offline decrypter
# DATE 2011-08-08, TIME 23:49:10, TZ CEST
# CAID 0x1702, SID 0x000B, SERVICE "Sky_Cinema_+1"
1 9E E3 BB 3C A4 C3 BE 25 # 23:49:10
0 D0 24 B3 A7 95 82 3B 52 # 23:49:17
1 A9 76 35 54 37 38 F3 62 # 23:49:23
0 55 70 87 4C 22 26 C4 0C # 23:49:30
1 F0 16 22 28 36 3A 03 73 # 23:49:38
0 5D 83 44 24 8F C7 5D B3 # 23:49:44
</syntaxhighlight>

All cws are logged if at least one user watches the channel. Please choose a path with enough space, since per day and channel some 10KB of data are created. A script that moves/deletes the log files regularly is recommended.

Example:
cwlogdir = /var/log/

Default:
cwlogdir = # [blank] no path for cw-log, logging disabled

===== emmlogdir =====
{{Optional/en}}

Setting a path for emm-log. You can define with the "saveemm-*"-Parameters in oscam.server which EMMs should be logged.

Example:
emmlogdir = /var/log/

Default:
emmlogdir = # [blank] the config folder will be used for emm logging

===== usrfile =====
{{Optional/en}}

Set a name für userfile

Format of the userfile:
date
time
CWs per second
username
IP address of client
TCP/IP port
CWs found
CWs from cache
CWs not found
CWs ignored
CWs timeout
CWs tunneled
login time in UNIX/POSIX format
logout time in UNIX/POSIX format
protocol

Example:
usrfile = userfile

Default:
usrfile = 0

===== disableuserfile =====
{{Optional/en}}

Now it is crazy: Even if a logfile is switched on (see logfile), the userfile can be turned off!

Example:
disableuserfile = 1 # '''no''' userfile
= 0 # '''userfile'''

Default:
disableuserfile = 0

===== usrfileflag =====
{{Optional/en}}

Setting the logging-modus
0 = Only login and logout will be logged
1 = Each zapping from client will be logged
Default is 0

Example:
usrfileflag = 1 # All will be logged

Default:
usrfileflag = 0 # Only login und logout will be logged

===== saveinithistory =====
{{Optional/en}}

OBSOLETE svn7128:07/02/2012

Save SC init history to /tmp/.oscam/reader<number>. Needed to show entitlements.

Example:
saveinithistory = 1 # save to /tmp/.oscam/reader<number>

Default:
saveinithistory = 0 # no save

===== mailfile =====
{{Optional/en}}

mailfile = file

define file saving NDS Videogard mail messages from provider. Default: [blank] none

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

===== disablemail =====
{{Optional/en}}

disablemail = 0|1

disable saving NDS Videogard mail messages form provider. Default = 1 (disabled)

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

===== enableled =====
{{Optional/en}}

NEW svn6285:01/23/2012

LED-Support

enableled = 0|1|2

0 = LED support disabled (default)
1 = LED support enabled for routers
2 = LED support enabled for Qbox HD

===== serialreadertimeout =====
{{Optional/en}}

OBSOLETE svn8541:03/13/2013

'''Only using Serialreader!'''

timeout for serial reader in milli-seconds

Example:
serialreadertimeout = 1200 # Timeout after 1200 milli-seconds

Default:
serialreadertimeout = 1500 # Timeout after 1500 milli-seconds

===== waitforcards =====
{{Optional/en}}

wait for local SCs on startup before opening network ports

Example:
waitforcards = 0 # don't wait

Default:
waitforcards = 1 # wait

===== waitforcards_extra_delay =====
{{Optional/en}}

waitforcards_extra_delay = milli seconds

additional delay in milli seconds after waiting for local SCs on startup before opening nework ports

default = 500

===== preferlocalcards =====
{{Optional/en}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== readerrestartseconds =====
{{Optional/en}}

waiting time in seconds beetween restarts

Example:
readerrestartseconds = 10 # waiting time 10 seconds
= 0 # '''no restarts!'''

Default:
readerrestartseconds = 5 # waiting time 5 seconds

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

maximum wait time for a cache entry in milli seconds, default:50

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

[[Datei:WarningS.png|text-bottom]] '''Warning:''' Please consider memory consumption!

==== Client ====

===== clienttimeout =====
{{Optional/en}}

value in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== clientmaxidle =====
{{Optional/en}}

value for client process being idle before disconnect in seconds

Example:
clientmaxidle = 200 # Disconnect after 200 seconds
= 0 # idle disconnect disabled

Default:
clientmaxidle = 120 # Disconnect after 120 seconds

===== suppresscmd08 =====
{{Optional/en}}

suppresscmd08 = 0|1

0 = tell camd35[cs3.57x]-clients not to request again for rejected CAID, service ID and provider ID combination (default)
1 = disabled

Can be overwritten in oscam.user!

More here:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== fallbacktimeout ====
{{Depends/en}}

At several readers (see Chapter [reader] in oscam.server) one reader can be defined to them, for example in case of failure of the other readers, the traffic falls back.
Maximum waiting time of the [[Cardserver]]s in milliseconds for primary [[Reader]], before [[Fallback]]-Reader (if any!) are questioned.

Example:
fallbacktimeout = 1500

Default:
fallbacktimeout = 2500

[[Datei:WarningS.png|text-bottom]] '''Attention:''' The value must be greater than the value in "serialreadertimeout", otherwise the default is used.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== sleep ====
{{Optional/en}}

time waiting for inactive users in minues, can be overwritten per user in oscam.user

Example:
sleep = 5 # waiting time 5 minutes

Default:
sleep = # [blank] no waiting time

==== serverip ====
{{optional/en}}

Bind service to specified IP-address

Example:
serverip = 192.168.178.1

Default:
serverip =

OSCam listen to all IP's

==== bindwait ====
{{Optional/en}}

value in seconds to wait for bind request to complete. If OSCam within this time can not bind, he finished with "Bind Request failed".

Causes may include:
* Double assignment of ports
* "crashed" OSCam has not released the ports again
* OSCam was started serveral times while

Example:
bindwait = 20 # waiting time 20 seconds

Default:
bindwait = 120 # waiting time 120 seconds

==== netprio ====
{{Optional/en}}

network priority - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

==== resolvegethostbyname ====
{{Optional/en}}

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
0 = getadressinfo (default)
1 = gethostbyname

Example:
resolvegethostbyname = 1 # gethostbyname

Default:
resolvegethostbyname = 0 # adressinfo system given

==== failbantime ====
{{Optional/en}}

time for IP based blocking for clients with an invalid login attempt in minutes

Beispiel:
failbantime = 5
# IP will be blocked for 5 minutes. New logins are denied.
# no clientthread will be created.

Default:
failbantime = 0 # failban off (default)

==== failbancount ====
{{Optional/en}}

Failbancount = Number of allowed failed attempts with incorrect data
= 0 (default) IP is now blocked on the first try with incorrect data!

If within '''failbantime''' more than in '''failbancount''' allowed trials to be registered, the IP for the remainder failbantime is locked. After a period of failbantime are again full failbancount available. Failbancount is thus a relaxation of rules!

==== dropdups ====
{{Optional/en}}

mode for duplicate client connections

0 = mark client as duplicate, but don't disconnect them (default)
1 = drop duplicate connections instead of marking as duplicate

==== unlockparental ====
{{Optional/en}}
CHANGE svn7289:08/27/2012

'''Only Seca and Viaccess'''

unlock parental mode option to disable pin code request for adult movie.
In order to work properly, this option may required that you define the card PIN code in your card reader configuration.

Example:
unlockparental = 1 # parental lock mode disabled

Default:
unlockparental = 0 # parental lock mode enabled

==== double_check ====
{{Optional/en}}

ECM will be send to two or more readers with the same SC and the CWs will be verified against each other, lb_nbest_readers must be set to 2 or higher

Example:
double_check = 1 # on

Default:
double_check = 0 # off

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

ECM will be send to two or more readers with the same SC and the CWs will be verified against each other for defined CAID or first two bytes of CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== Loadbalancer ====

===== lb_mode =====
{{Optional/en}}

'''loadbalance mode'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If load balancing is activated here, it may in oscam.server among services and ident are '''no entries'''!

If there are 2 or more of the same SC, the load can be distributed evenly on the cards. For more see [[OSCam/en/Loadbalancing|Loadbalancing]]

Example:
lb_mode = 0 loadbalance disabled, ECMs go to all readers
lb_mode = 1 fastest reader first, after 5 ECMs the reader with the fastest response time will be selected
lb_mode = 2 oldest reader first, reader with the longest no answer
lb_mode = 3 lowest usage level, the usage level will be calculated by the sum of 5 ECMS response times, the higher a reader is busy, the higher is usage level
lb_mode = 10 LB is switched off, but statistics are build

Default:
lb_mode = 0 # disabled

===== lb_save =====
{{Optional/en}}

Save autoloadbalance statistics (counts). To save CPU power a minimum counts of 100 is recommended.

Example:
lb_save = 100 # counts of ECM's after statistics are saved

Default:
lb_save = 0 # no svae

===== lb_nbest_readers =====
{{Optional/en}}

set count of best readers for loadbalancing.

Example:
lb_nbest_readers = 2 # requests always go to two reader

Default:
lb_nbest_readers = 1 # requests go to one reader

===== lb_nfb_readers =====
{{Optional/en}}

set count of fallback readers for loadbalancing

Example:
lb_nfb_readers = 2 # two fallbackreader

Default:
lb_nfb_readers = 1 # one fallbackreader

===== lb_reopen_mode =====
{{Optional/en}}

OBSOLETE svn8642:05/10/2013

lb_reopen_mode = 0|1

loadbalancing reopen readers mode:
= 0 # standard late reopening of blocker readers (default)
= 1 # fast reopening of blocker readers

===== lb_nbest_percaid =====
{{Optional/en}}

CHANGE svn 5893:08/19/2011

Set count of best readers per CAIDs for loadbalancing, wildcard CAIDs with two-digit CAIDs possible

lb_nbest_percaid = # number
= [blank] # none (default)

example:
lb_nbest_percaid = 0100:4,0200:3,03:2,04:1
(wildcard CAIDs 03xx and 04xx)

===== lb_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== lb_min_ecmcount =====
{{Optional/en}}

minimal ECM count to evaluate loadbalancing values

Example:
lb_min_ecmcount = 2 # 2 counts

Default:
lb_min_ecmcount = 5 # 5 counts

===== lb_max_ecmcount =====
{{Optional/en}}

Maximum ECM count before resetting loadbalancing values.

Example:
lb_max_ecmcount = 200 # 200 counts

Default:
lb_max_ecmcount = 500 # 500 counts

===== lb_reopen_seconds =====
{{Optional/en}}

time in seconds between retrying failed readers/CAIDs/providers/services

Example:
lb_reopen_seconds = 500 # retry after 500 seconds

Default:
lb_reopen_seconds = 900 # retry after 900 seconds

===== lb_retrylimit =====
{{Optional/en}}

Retry next readers '''only''' if response time is higher then lb_retrylimit in '''milli seconds'''.

Example:
lb_retrylimit = 500 # retry next reader only, if response time is higher than 500 ms

Default:
lb_retrylimit = 800

===== lb_savepath =====
{{Optional/en}}

Filenanme for saving loadbalancing statistics

default = /tmp/.oscam/stat

===== lb_stat_cleanup =====
{{Optional/en}}

hours after the loadbalancing statistics will be deleted

default = 336

===== lb_use_locking =====
{{Optional/en}}
OBSOLETE svn6166:12/28/2011

disable parallel and identical ECM requests

1 = on
0 = off # default:0
 
'''Schlocke:'''
* You should choose this option only if:
** slow system
** high load
** the same ECM requests come not from the cache, but will continue to the confirmed reader.

* Adventages, if activated:
** By synchronizing, an ECM request made by one. The identification of cache or request and assignment of the reader by loadbalancer is always successful.

* Disadventages, if activated:
** The synchronisation prevents multithreading and the probability of higher response times.

* Adventages, if NOT activated:
** Faster transit times for ECM requests

* Disadventages, if NOT activated:
** May have dual (n-fold) possible requests to the readers.
 

===== lb_retrylimits =====
{{Optional/en}}

CHANGE svn:5754:07/31/2011

lb_retrylimits = CAID1:time1[,Caid2:time2]...

loadbalancing retry limit time per CAID in milliseconds, wilcard CAIDs with 2-digit Caids possible

default = none

example:
lb_retrylimits = 12:0100,34:0200,5678:0300
(wildcard CAIDs 12xx and 34xx)

===== lb_noproviderforcaid =====
{{Optional/en}}

CHANGE svn 5758:08/01/2011

lb_noproviderforcaid = CAID1[,CAID2]...

ignore provider information CAIDs to reduce statistic date, wildcard CAIDs with two-digit CAIDs possible

example:
lb_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== lb_max_readers =====
{{Optional/en}}

lb_max_readers = limit (number)

restrict the reader count to limit during learning

0 = unlimited (default)
x = restrict loadbalancer readers to limit x (number)

===== lb_auto_betatunnel =====
{{Optional/en}}

lb_auto_betatunnel = 0|1

enable automatic Betacrypt tunneling for CAIDs 1801, 1833, 1834 and 1835 in loadbalancing mode
lb_auto_betatunnel = 0 # disabled
= 1 # enabled (default)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Betacrypt definition in oscam.user with betatunnel will be prefered [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

===== lb_auto_betatunnel_prefer_beta =====
{{Optional/en}}

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== Monitor ===
'''Only if monitor is used!'''

{{OSCamConfMonitorParameter}}

==== port ====
{{Optional/en}}
UDP port for monitor
port = 0 # monitor disabled
= # port number

Beispiel:
port = 24480 # monitor on, port = 24480

==== serverip ====
{{Optional/en}}

bind service to specified IP address
serverip = # IP adress
= # [blank] all IP's (default)

==== nocrypt ====
{{Optional/en}}

unsecured monitor connection
[,IP address|IP address range]...

Possible
* one or more IP adresses
* one or more IP adress ranges
* mixture of IP adresses and IP adress ranges

Example
nocrypt = 127.0.0.1,192.168.0.0-192.168.255.255
= Host 127.0.0.1 and IP range 192.168.0.0 to 192.168.255.255

Default
nocrypt = # [blank] no secured monitor connection

==== aulow ====
{{Optional/en}}

time no EMM occurs so that client is set to low in minutes

Example
aulow = 30 # After 30 minutes whithout EMM client will be switched from "active" to "on" (default).

==== monlevel ====
{{Optional/en}}

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
3 = all procs, reload of oscam.user possible
4 = complete access

Example
monlevel = 4 # complete access

monlevel can be overwritten per user in oscam.user!

==== appendchaninfo ====
{{Optional/en}}

OBSOLETE svn8546:03/13/2013


Append channel name on log messages. Very useful when using [webif]!
appendchaninfo = 1 # append chanel name
= 0 # no append chanel name (default)

=== lcd ===
{{OSCamConfLCDParameter}}

==== enablelcd ====
{{Optional/en}}

NEW svn6285:01/23/2012

enablelcd = 0|1

0 = default
1 = enable LCD

==== lcd_outputpath ====
{{Optional/en}}

Path for LCD output

Default:
lcd_outputpath = [blank] /tmp

==== lcd_hideidle ====
{{Optional/en}}

hide reader in LCD output if reader idle > 20 seconds, default:0

==== lcd_writeinterval ====
{{Optional/en}}

LCD refresh interval (minimum 5), default:10

=== WebIf ===
'''Only if WebIf is used!'''

{{OScamConfWebIfParameter}}

==== File format to send EMMs via the webinterface ====
(by Bit)

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

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== httpport ====
{{Optional}}

default is 8888 if no httpport is set
port for web interface,
0 = disabled, praefix + = enable SSL

Example
httpport = 83 # Webinterface listening on '''http-port 83'''
= +83 # Webinterface listening on '''https-port 83''' (SSL)
0 # Webinterface disabled

==== httpcert ====
{{Optional/en}}

file for http SSL certificate
httpcert = oscam.cert # (look there)
= # [blank] file oscam.pem (embedded) is used

==== httpforcesslv3 ====
{{Optional/en}}
NEW svn:6321/01/30/2012

httpforcesslv3 = 0|1

example
httpforcesslv3 = 0 none (default)
= 1 force using SSLV3

==== httpuser ====
{{Optional/en}}

Username for password protection. [blank] is default, of which is strongly discouraged!
httpuser = # xyxyxy (all characters and figures are allowed)

==== httppwd ====
{{Optional/en}}

Password for password protection. It is the same as for httpuser.
httppwd = # 123456

'''The ''user'' and ''pwd'' parameters are queried when connecting to the webinterface in a messagebox. If they are missing ore corrupted a message ''Forbidden'' appears and the connection is aborted!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

==== httpcss ====
{{Optional/en}}

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

Example
httpcss = # /etc/oscam/harvest_round_Firefox.css
= # [blank] embedded style is used (default)

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

==== httptpl ====
{{Optional/en}}

CHANGE svn 7083:06/25/2012

path for external templates and picons
httptpl =
= # [blank] No external templates

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

==== httprefresh ====
{{Optional/en}}

status refresh in seconds

httprefresh = 7 # status will be refreshed after 7 seconds
= # [blank] no refreshing

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

==== httphideidleclients ====
{{Optional/en}}

Enables hiding clients after idle time set with parameter ''' hideclient_to''' in section [monitor].
httphideidleclients = 1 # hide
= 0 # hide not (default)

==== hideclient_to ====
{{Optional/en}}

Time to hide clients in the monitor if not sending requests. See also parameter '''httphideidleclienst''' in section [webif].
hideclient_to = 1 # hide clients
= 0 # no hide

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

==== httpscript ====
{{Optional/en}}

Path to an executable script which you wish to start from web interface
httpscript = # path
= # [blank] no path

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

==== httpallowed ====
{{required}}

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

http web interface connections allowed. [blank] is allowed (default), but that makes no sense! If the webinterface to be used, then there must be a way to connect with him. Therefore we declare this parameter as '''mandatory'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== httpdyndns ====
{{Optional/en}}
CHANGE svn6558:03/21/12

http web interface connections allowed

httpdyndns = hostname [,hostnahme][,hostname]

Example
httpdyndns = host1.example.com,host2.example.com

==== httpsavefullcfg ====
{{Optional/en}}

write config:
0 = all not empty parameters, all not default parameters, all parameters not containing the same value as the same parameter in global configuration (default)
1 = all parameters

==== httpreadonly ====
{{Optional/en}}

read only modus for web interface

httpreadonly = 1 # only read
= 0 # all is possible (default)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

====httphelplang====
{{required}}

set right language for wiki entry point
de|en|fr <available wiki languages>

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

==== httpshowloadinfo ====
{{Optional/en}}

httpshowloadinfo = 0|1
1 = display load average and CPU usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

'''cw_cache - info''' 
cache of CWs which are saved to detect/drop old CWs arriving via CacheEx

to enable this feature, you have to define cw_cache_size or cw_cache_memory to set the cache-size
and cw_cache_settings to define for what CWs which action is taken.

if cw_cache_size or cw_cache_memory is defined, the default is, that incoming known CWs older then 15 seconds are dropped, cause they are useless.

'''ecm_cache - info''' 

cache of ECMs which are saved to detect/drop old ECMs

if you are facing problems with getting old ECMs, with this feature you are able to drop known ECMs
to enable this feature, you have to define ecm_cache_size or ecm_cache_memory to set the cache-size

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== cw_cache_settings ====
{{Optional/en}}
NEW svn11588:08/23/20

cw_cache_settings = caid[&mask][@provid][$servid]:mode:timediff_old_cw[,n]
= [blank] disabled

* mode:
1 = just write logs @ log-level 8192
2 = drop CWs which match this rule & write logs @ log-level 8192

* timediff_old_cw:
time = time in miliseconds after a known CW is detected/dropped

Example:

cw_cache_settings = 0:2:1500,BEEF@012345:2:620,1337:1:170
* for all CWs not matching any other rule => drop if the CW is known for more then 1500ms
* drop CWs of caid BEEF with provid 012345, if they are known for more then 620ms
* log CWs of caid 1337 with all provids, if they are known for more then 170ms

==== cw_cache_size ====
{{Optional/en}}
NEW svn11588:08/23/20

cw_cache_size = count of max. CWs for cw_cache
= 0 (default)

==== cw_cache_memory ====
{{Optional/en}}
NEW svn11588:08/23/20

cw_cache_memory = size (in MB) of the cw_cache
= 0 (default)

==== ecm_cache_size ====
{{Optional/en}}
NEW svn11588:08/23/20

ecm_cache_size = count of max. ECMs for ecm_cache
= 0 (default)

==== ecm_cache_memory ====
{{Optional/en}}
NEW svn11588:08/23/20

ecm_cache_memory = size (in MB) of the ecm_cache
= 0 (default)

==== ecm_cache_droptime ====
{{Optional/en}}
NEW svn11588:08/23/20

ecm_cache_droptime = time in seconds after a known ECM is dropped with return-code E_INVALID
= 0 (default)

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

==== wait_time ====
{{Optional/en}}
NEW svn 6142:12/25/2011

CHANGE svn 8077:01/06/2013

wait_time = milli-seconds
= [blank] none (default)

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== waittime_block_start ====
{{Optional/en}}
NEW svn11588:08/23/20
waittime_block_start = number of (dyn)wait_time timeouts to start blocking the use of (dyn)wait_time for this service(caid:provid:srvid)
= 0 (default)

==== waittime_block_time ====
{{Optional/en}}
NEW svn11588:08/23/20
waittime_block_time = seconds the (dyn)wait_time isn't used and ECMs are forwarded to the reader/s
= 0 (default)

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

[[Datei:WarningS.png|text-bottom]] '''Warning:''' Please consider memory consumption!

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

==== cacheex_dropdiffs ====
{{Optional/en}}
NEW svn11588:08/23/20

cacheex_dropdiffs = 1 drop incoming not-localgenerated-flagged CWs which differ from the first CW
= 0 (default)

==== cacheex_nopushafter ====
{{Optional/en}}
NEW svn11588:08/23/20

don't forward CWs from local/proxy-reader via CacheEx, if the defined time_in_ms for the CAID is reached 
here in oscam.conf this setting is for evaluating the response-time for local/proxy-readers and is used for CacheEx2-reader/CacheEx3-user as default, when no reader/user cacheex_nopushafter is set.

cacheex_nopushafter = CAID:time_in_ms[,n]

==== cacheex_lg_only_remote_settings ====
{{Optional/en}}
NEW svn11588:08/23/20

possibility to deny cacheex-receiver/client(cx2: user / cx3: reader) to overwrite the following settings @ cacheex-sending-instance
cacheex_localgenerated_only
cacheex_lg_only_tab

it makes sense if you want to force your local settings.
if the user/reader isnt allowed to overwrite your values,
* it is still possible for the cacheex-receiver to set cacheex_localgenerated_only=1, if the user/reader define cacheex_localgenerated_only_in=1 ; but it is only @ cacheex-sending-instance possible to disable it
* it is still possible for the cacheex-receiver to add cacheex_lg_only_tab, if the user/reader define cacheex_lg_only_in_tab=1234,1337 ; but it is only merged to the sender-instance cacheex_lg_only_tab values

if cacheex_lg_only_remote_settings @oscam.conf is enabled, the user/reader-settings are ignored.
if cacheex_lg_only_remote_settings @oscam.conf is disabled, the user/reader-settings are used.

cacheex_lg_only_remote_settings = 0|1 (default: 0 /opt-out)

==== cacheex_localgenerated_only ====
{{Optional/en}}
NEW svn11588:08/23/20

forward only CWs which are flagged as localgenerated 
here in oscam.conf, the default value is set; user/reader-settings are prioritized

cacheex_localgenerated_only = 0|1 (default: 0 /opt-in)

==== cacheex_lg_only_tab ====
{{Optional/en}}
NEW svn11588:08/23/20

forward only CWs which are lg-flagged for these list of caid/provid(s) 
here in oscam.conf, the default value is set; user/reader-settings are prioritized

if provid FFFFFE is set, all provids for this caid are valid!

cacheex_lg_only_tab = caid1:provid1[,provid2];caid2:provid1;

==== cacheex_localgenerated_only_in ====
{{Optional/en}}
NEW svn11588:08/23/20

drop incoming CWs which are NOT flagged as localgenerated 
here in oscam.conf, the default value is set; user/reader-settings are prioritized

cacheex_localgenerated_only_in = 0|1 (default: 0 /opt-in)

==== cacheex_lg_only_in_tab ====
{{Optional/en}}
NEW svn11588:08/23/20

allow incoming CWs only if they are lg-flagged for these list of caid/provid(s) 
here in oscam.conf, the default value is set; user/reader-settings are prioritized

if provid FFFFFE is set, all provids for this caid are valid!

cacheex_lg_only_in_tab = caid1:provid1[,provid2];caid2:provid1;

==== cacheex_lg_only_in_aio_only ====
{{Optional/en}}
NEW svn11588:08/23/20

use drop lg-only settings (cacheex_localgenerated_only_in & cacheex_lg_only_in_tab) only if peer is detected as cx-aio-patched or svn >= 11588
here in oscam.conf, the default value is set; user/reader-settings are prioritized

cacheex_lg_only_in_aio_only = 0|1 (default: 0 /opt-in)

==== cacheex_ecm_filter ====
{{Optional/en}}
NEW svn11588:08/23/20

set a global cacheex_ecm_filter 
here in oscam.conf, the default value is set; user/reader-settings are prioritized

cacheex_ecm_filter = [caid][&mask][@provid][$servid],n

==== cacheex_ecm_filter_aio ====
{{Optional/en}}
NEW svn11588:08/23/20

set a global cacheex_ecm_filter which is used if peer is detected as cx-aio-patched or svn >= 11588
the default limit of 15/30 (camd3/cccam) filters is obsolete

here in oscam.conf, the default value is set; user/reader-settings(cacheex_ecm_filter) are prioritized

cacheex_ecm_filter_aio = [caid][&mask][@provid][$servid],n

==== cacheex_push_lg_groups ====
{{Optional/en}}
NEW svn11588:08/23/20

push all lg-flagged CWs to this/these group/s, without checking the groupmembership of the peer

cacheex_push_lg_groups = [blank] (default)
= 1[,n]

 
 

 

=== csp (UDP) ===
Section only needed if using cache exchange

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

==== port ====
{{required}}
NEW svn6124:12/23/2011

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

==== serverip ====
{{required}}
NEW svn 6124:12/23/2011

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== Camd 33 (TCP) ===
Section required only if camd33 will be used as client protocol!

{{OSCamConfCamd33Parameter}}

==== port ====
{{required}}

TCP/IP port for camd 3.3x clients, 0 = disabled, default:0

Example:
port = 15000
= 0 # disabled (default)

==== serverip ====
{{Optional/en}}

bind service to specified IP address

Example:
serverip = 192.168.178.1

Default:
serverip = # listenig to all

==== nocrypt ====
{{Optional/en}}

unsecured camd 3.3x client connection
IP address|IP address range[,IP address|IP address range]...

Example:
nocrypt = 127.0.0.1,192.168.0.0-192.168.255.255

Default:
nocrypt = [none]

==== passive ====
{{Optional/en}}

force passive camd 3.3x client

Camd3.3x protocol generally has aktive clients. In certain circumstances the client must switched on only "passive" mode.

Example:
passive = 1

Default:
passive = 0

==== key ====
{{Optional/en}}
128 bit key

key for camd 3.3x client encryption

Example:
key = 01020304050607080910111213141516

Default:
key = # (blank] none (default)

=== cs357x (UDP) ===
Section required only if cs357x will be used as client protocol! These protocols principle encrypt and build the key from user name.

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''cs357x''' was also known as '''camd35''' designated. Both terms mean the same protocol with the same functions and parameters. In the future, to avoid confusion '''only cs357x''' is used.

{{OSCamConfCs357xParameter}}

==== port ====
{{required}}
UDP port for camd 3.5x|cs357x clients. Port must be opened at router!

Example:
port = 15000
= 0 # disabled (default)

==== serverip ====
{{Optional/en}}

bind service to specified IP address

Example:
serverip = 192.168.178.1

Default:
serverip = # [blank] all (default)

==== suppresscmd08 ====
{{Optional/en}}

suppresscmd08 = 0|1

0 = tell camd35|cs3.57x-clients not to request again for rejected CAID, service ID and provider ID combination (default)
1 = disabled

Can be overwritten in oscam.user!

More here:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== cs378x (TCP) ===
Section required only if cs378x (camd 3.5x in TCP) will be used as client protocol!

{{OSCamConfCs378xParameter}}

==== port ====
{{required}}

Port(s) TCP for Cs378x clients (camd 3.5x in TCP mode). Port(s) must be opened at router!

port@CAID[:ident][,ident]...[;port@CAID[:ident][,ident]...]...

Example:
port = 15000@0500:030B00;22764@0648

==== serverip ====
{{Optional/en}}

bind service to specified IP address

Example:
serverip = 192.168.178.1

Default:
serverip = # [blank] all (default)

==== suppresscmd08 ====
{{Optional/en}}

suppresscmd08 = 0|1

0 = tell cs3.78x clients not to request again for rejected CAID, service ID and provider ID combination (default)
1 = disable

Mor here: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== Newcamd (TCP) ===
Section required only if newcamd will be used as client protocol!

{{OSCamConfNewcamdParameter}}

==== key ====
{{required}}
DES key
Default key for newcamd client encryption.

Example:
key = 0102030405060708091011121314

Default:
key =

==== port ====
{{required}}
TCP port/DES key/CAID/ident definitions. Each CAID requires a separate port. If you don't specify a DES key for a port, the default DES Key will be used!

port[{DES key}]@CAID[:ident][,ident]...[;port[{DES key}]@CAID[:ident][,ident]...]...

Example:
port = 15000@1234:000000 # (CAID 1234 connected with port 15000)
port = 15000@1234:000000;15001@5678:000000 # (CAID 1234 connected with port 15000. CAID 5678 with port 15001)

Default:
port = port@caid:ident

==== serverip ====
{{Optional/en}}

bind service to specified IP address

Example:
serverip = 192.168.178.1

Default:
serverip = [blank]

==== allowed ====
{{Optional/en}}

client connections allowed from
IP address|IP address range[,IP address|IP address range]...

!! Dyn DNS Addresses are not forseen here and won't work !!

Example:
allowed = 127.0.0.1,192.168.0.0-192.168.255.255

Default:
allowed = [blank]

==== keepalive ====
{{Optional/en}}

Example:
keepalive = 1 # (enabled)
keepalive = 0 # (disabled)

Default:
keepalive = 0

==== mgclient ====
{{Optional/en}}

Enable mgcamd extended newcamd protocol, allowing for a single connection to work with mutliple providers, default:0

Example:
mgclient = 1 # (enabled)
mgclient = 0 # (disabled)

Default:
mgclient = 0

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

==== port ====
{{required}}

port = port

UDP port for scam server, default = 0

==== serverip ====
{{Optional/en}}
bind service to specified IP address

Example:
serverip = 192.162.9.1
= [blank] alle IP'as allowed (default)!

==== allowed ====
{{Optional/en}}

client connections allowed from
IP addres|IP range[,IP address|IP range]...

Example:
127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
 
 

=== Radegast ===
Section required only if radegast will be used as client protocol!

{{OSCamConfRadegastParameter}}
==== port ====
{{required}}

TCP/IP port for radegast clients (enables radegast)
port =
= 0 (default)

==== serverip ====
{{Optional/en}}
bind service to specified IP address

Example:
serverip = 192.162.9.1
= [blank] alle IP'as allowed (default)!

==== allowed ====
{{Optional/en}}

client connections allowed from
IP addres|IP range[,IP address|IP range]...

Example:
127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed

==== user ====
{{required}}

user name for radegast client
user = username

=== Serial ===
Section required only if seral interface will be used!

{{OSCamConfSerialParameter}}

==== device ====
{{Optional/en}}

Parameter of device
device = <user>@<device>[:baud][?option1=value1][?option2=value2]

Parameter
user = account
device = name of Serial Device
option = timeout = milli seconds timeout for connection default: 50
= delay milli seconds additive between 2 characters

supported serial devices
HSIC Humax Sharing Interface Client
SSSP Simple Serial Sharing Protocol
bomba BOMBA Firmware
dsr9500 DSR 9500

=== Cccam (TCP) ===
Section required only if Cccam will be used as client protocol!
{{OSCamConfCccamParameter}}

==== port ====
{{required}}
CHANGE svn6206:01/07/2012

Port = 0|port[,port...]

TCP/IP-Ports for CCcam clients, enables Cccam protocol!

port =
= 0 # CCcam-Protokoll disabled (default)

==== version ====
{{Optional/en}}

define CCcam version, minimum CCcam version 2.0.11, used with original CCcam only, default:none

<nowiki><main version>,<version>,</nowiki>

Example:
version = 2.0.11

==== reshare ====
{{Optional/en}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = resharing for direct peer and next level
x = resharing for direct peer and next x level (x for number of level)
10 = (default)

Example:
reshare = 1 resharing only for direct peer and next level

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 !

==== reshare_mode ====
{{Optional/en}}

CCcam reshare mode
0 = reader reshares only received SCs for CCcam readers,
defined filters/CAIDs/idents on other readers (default)
1 = reader reshares received SCs (like=0) and defined services
2 = reader reshares only defined reader services as virtual SCs
3 = reader reshares only defined user services as virtual SCs
4 = reader reshares only received cards

Every server is shared as hop=0 and with defined reshare values.

Service reshare only works if positive services defined: no service - no reshare!

==== ignorereshare ====
{{Optional/en}}

CCcam reshare setting:
0 = use reshare setting of server (default)
1 = use reshare setting of reader or user

Example:
ignorereshare = 1 reshare settings of reader or user are used

==== stealth ====
{{Optional/en}}

Behaviour like the original CCcam: no activate partner detection and extended OSCam-CCcam protocol, prevent other OSCam to detect the server as OSCam server.

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

==== minimizecards ====
{{Optional/en}}

mode how to provide CCcam servers to CCcam clients:
0 = no aggregation, remove duplicates only (default)
1 = based on minimum hop: two SCs with different hops are summarized, new SCs get a smaller hop

==== updateinterval ====
{{Optional/en}}

interval to provide share list update to CCcam clients in seconds
0 = update based on server updates, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

==== keepconnected ====
{{Optional/en}}

set CCcam keepalive modus:
0 = disconnect client when max idle time is reached
1 = keep client connected (default)

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== forward_origin_card ====
{{Optional/en}}

forward_origin_card = 0|1

1 = forward ECM request to reader holding this card, loadbalancer, fallback and caching will be disabled
0 = default

==== nodeid ====
{{Optional/en}}

nodeid = ID

set CCcam node ID in hex, default:none

example
nodeid = 0a0b0c0d0e0f1011
 
=== Pandora ===
{{OSCamConfPandoraParameter}}

==== pand_skip_send_dw ====

pand_skip_send_dw = dummy

==== pand_allowed ====

pand_aloowed = dummy

==== pand_usr ====

pand_user = dummy

==== pand_pass ====

pand_pass = dummy

==== pand_ecm ====

pand_ecm = dummy

==== pand_port ====

pand_port = dummy

==== pand_srvid ====

pand_srvid = dummy

 
 

=== GBox ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M: { 192.168.1.101 { A123BCDE }}
D: { 192.168.1.123 { 3820 3819 { 98AF3E25 {3 3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
[reader]
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client_1

'''oscam.user:'''
[account]
user = gbox_client_1
group = 1

 
 

==== hostname ====
{{required}}

hostname = my IP or ddns

examples:
hostname = 192.168.1.120
hostname = willy.noip.org

 

==== my_password ====
{{required}}

my_password = 4 hex bytes, 8 chara

example:
my_password = 98AF3E25

 

==== port ====
{{required}}

port= define incoming UDP port(s) used by Gbox protocol

port= port#1[[,port#2]...[,port#32]]

Maximum 32 ports.

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy reader card(s) to be reshared into gbox network, default = none

proxy_card = <CAID><provid>[,<CAID><provid>]...

example:

proxy_card = 18300000,0D950400,05050F00

 

==== ccc_reshare ====
{{Optional/en}}

ccc_reshare = 0|1

1 = enable cccam-cards to be reshared into gbox network, default = 0 (global setting)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' must set up caids to be reshared in 'ccc_gbx_caid ='

[[Datei:WarningS.png|text-bottom]] '''Attention:''' unique peer reshare level to be set in oscam.server [reader]-> cccam_reshare

 

==== ccc_gbx_caid ====
{{Optional/en}}

ccc_gbx_caid = caid_1,caid_2,...

[[Datei:WarningS.png|text-bottom]] '''Attention:''' 'ccc_reshare' must be set as well

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version hexadecimal low byte

default = 2A

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send hello message to peers in seconds, default:180, min:60, max:300

 

==== accept_remm_peer ====
{{Optional/en}}
NEW svn11399:29/01/2018

Accept to send Remote EMMs to specified Server Peer-IDs

accept_remm_peer = peer#1[[,peer#2]...[,peer#8]]

 

==== dis_attack_txt ====
{{Optional/en}}
NEW svn11360:16/02/2017

Disable creation of attack.txt

dis_attack_txt = 0|1 - default: 0

 

==== log_hello ====
{{Optional/en}}
NEW svn11231:20/04/2016

Display hello messages in debug log

log_hello = 0|1 - default: 1

 

==== ignore_peer ====
{{Optional/en}}
NEW svn11290:19/12/2016

Ignore specific peer ID(s) totally. Login rejected.

ignore_peer = peer#1[[,peer#2]...[,peer#16]]

 

==== block_ecm ====
{{Optional/en}}
NEW svn11290:19/12/2016

Block ECM for specific peer ID(s).

block_ecm = peer#1[[,peer#2]...[,peer#16]]

 

==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

gbox tempory directory

tmp_dir = /path/to/dir

default: /tmp/.oscam

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

0 - Gbox Short Message Service (GSMS) is enabled 
1 - disable gbox short message service (GSMS) 

default = 1

 
 

==== gbox_save_gsms ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_save_gsms=0|1

0 = don't save GSMS in configuration 
1 = save all GSMS field in configuration

You need to press save button to really save it!
 
 

==== gbox_msg_type ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_type=0|1

0 = normal text message 
1 = normal text message + OSD (On Screen Display)
 
 

==== gbox_dest_peers ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_dest_peers = [BOXID[,BOXID]...[,BOXID]]

Maximum 16 * 2 bytes (4 hexa digits), comma-separated. For broadcast to all use FFFF.
 
 

==== gbox_msg_txt ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_txt=Your text to send to peers.

From 6 to 127 alphanumerical characters.
 
 

=== DVBapi ===
{{Optional/en}}

Section required only if OSCam will also be used as client!

{{OSCamConfDVBapiParameter}}

==== enabled ====
{{Optional/en}}

DVB API enabled

Example:
enabled = 0 # disabled (default)
enabled = 1 # enabled

==== user ====
{{required}}
user name for DVB API client
Example:
user = # user1

Default:
enabled = # anonymous

==== au ====
{{Optional/en}}

AU mode for dvbapi:
au = 0 # disable AU (default)
au = 1 # enable AU

==== pmt_mode ====
{{Optional/en}}
PMT mode:
pmt_mode = 0 # use camd.socket and PMT file (default)
pmt_mode = 1 # disable reading PMT file
pmt_mode = 2 # disable camd.socket
pmt_mode = 3 # read PMT file on startup only
pmt_mode = 4 # do not use signal handler for monitoring /tmp
pmt_mode = 5 # do not use signal handler to monitor /tmp & disable camd.socket
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

==== request_mode ====
{{Optional/en}}
CAID request mode:
0 = try all possible CAIDs one by one (default)
1 = try all CAIDs simultaneously

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== boxtype ====
{{required}}
set boxtype, auto detection of DVB API will be aspired:
boxtype = dbox2|dreambox|dm7000|duckbox|ufs910|ipbox|ipbox-pmt|qboxhd|coolstream|neumo|pc

Default:
boxtype = dreambox

ipbox with camd.socket support, currently only with PGI image version 0.6 or above, verified on HD models only

ipbox-pmt can be used on any DGS based images (with or without camd.socket support), verified on HD models only

pc is for generic pc support (currently supported on VDR with vdr-plugin-dvbapi)

==== cw_delay ====
{{Optional/en}}
NEW svn4348:02/05/2012

cw_delay = milli-seconds

delay of CW writing, default = none

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

==== reopenonzap ====
{{Optional/en}}
NEW svn4348:02/05/2012

OBSOLETE svn9072:12/08/2013

reopenonzap = 0|1
= 1 reopen demux devices in each channel switching,
= 0 default

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== Anticasc ===
Section is needed if anticascading will be used to protect against unauthorized forwarding CardSharing.
{{OSCamConfAnticascParameter}}

==== enabled ====
{{required}}

enabled anti-cascading:
enabled = 1 # enabled
= 0 # disabled (default)

==== numusers ====
{{Optional/en}}
anti-cascading: user per account (number)
numusers = 0 # anticascading disabled (default)
= 1 # cascading for 1 user allowed ==> (1*100+80)/(10*100/60) = 11 ecms allowed per minute
= 2 # cascading for 2 users allowed ==> (2*100+80)/(10*100/60) = 17 ecms allowed per minute 
10 = number you have put in oscam.ac. Default value is 10

==== sampletime ====
{{Optional/en}}
duration of sample in minutes:
sampletime = 5 # duration 5 minutes
= # [blank] duration 2 minutes (default)

Ex: numusers = 1 ==> 11 ecms * 5 minutes ==> 55 ecms allowed in 5 minutes
numusers = 2 ==> 17 ecms * 5 minutes ==> 85 ecms allowed in 5 minutes

==== samples ====
{{Optional/en}}

number of additionnal ecms allowed (possible values between 2 and 10)
samples = 7 # 7 additional ecms allowed
= # [blank] 10 additional ecms allowed (default)

==== penalty ====
{{Optional/en}}
Level of the penalty if the user exceeds the result shown in Ex on Sampletime
0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay ([[OSCam/en/Config/oscam.conf#fakedelay|fakedelay]])

penalty can be overwritten per user in oscam.user

==== aclogfile ====
{{Optional/en}}
file for anti-cascading logging
aclogfile =
= # [blank] no logfile (default)

==== fakedelay ====
{{Optional/en}}

fake delay time in milli seconds (possible values between 100 and 3000)
fakedelay = 500 # delay 500 milli seconds
= # [blank] 1000 milli seconds (default)

==== denysamples ====
{{Optional/en}}

How many samples should be penalized?
denysamples = 10 # 10 samples will be penalized
= # [blank] 8 Samples will penalized (default)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}