source: trunk/Distribution/doc/txt/oscam.server.txt@ 1273

Last change on this file since 1273 was 1273, checked in by landlord, 11 years ago

Documentation update: extended gpio in 'oscam.server'

File size: 7.2 KB
Line 
1oscam.server(5) oscam.server(5)
2
3
4
5NAME
6 oscam.server - reader configuration file for OSCam
7
8SYNOPSIS
9 The server configuration file for OSCam contains reader parameters.
10 sections in oscam.server are recurring (more than one reader possible).
11 At least one [reader] section is required.
12
13DESCRIPTIONS
14 The [reader] section
15 device = device|<ip|hostname>,<port>[,<lport>]|pcsc
16 define local or remote reader
17 lport: remapping to local port
18 PCSC: number of PCSC readers, starting with 0
19
20 key = DES key
21 key for newcamd remote reader encryption
22
23 password = password
24 password for remote gbox reader
25
26 premium = ???
27 for gbox reader
28
29 account = user,password
30 user and password for remote reader
31
32 pincode = pincode
33 pincode for Conax and Cryptoworks SCs
34
35 services = [!]services[,[!]<services>]...
36 reader [de]assingment to service group, default=none
37
38 inactivitytimeout = minutes
39 inactivity timeout for newcamd reader, default:none
40
41 reconnecttimeout = minutes
42 TCP reconnect, if missing answers, default:none
43
44 disableserverfilter = 0|1
45 1 = ignore caid and ident settings of reader due faulty clients,
46 default=0
47
48 label = name
49 name for reader, required
50
51 fallback = 0|1
52 1 = define reader as fallback, standard and fallback reader must
53 have the same group, default:0
54
55 logport = 0|port
56 camd3 reader logport, camd3 UDP must be activated, only works if
57 theres no camd3 cascading, 0=disabled, default=0
58
59 caid = CAID[&<mask>][,CAID[&<mask>]]...
60 define CAID for reader, some protocols only support one CAID,
61 default:mask=FFFF
62
63 example: CAID=0100,0200&FFDF
64
65 boxid = NDS box ID
66 NDS receiver box id
67
68 aeskey = AES key
69 AES key for Viaccess SCs
70
71 detect = CD|DSR|CTS|RING|NONE|gpio[1-7]
72 status detect of card (NONE = no detection), default:CD
73
74 cardmhz = mhz
75 set standard SC frequency in units of 10 kHz, for Irdeto SC set to
76 600, refer to OVERCLOCKING, default:357
77
78 mhz = frequency
79 set reader frequency in units of 10 kHz, if mhz > cardmhz you are in
80 overclocking mode, refer to OVERCLOCKING, default:357
81
82 protocol = reader protocol
83 reader protocol, required:
84 mouse
85 smartreader
86 internal
87 serial
88 camd35|cs357x
89 cs378x
90 gbox
91 newcamd|newcamd525
92 newcamd524
93 cccam
94 radegast
95 pcsc
96
97 cccversion = <main version>.<version>.<sub version>
98 define CCcam version, default:none
99
100 exmaple: cccversion = 1.2.34
101
102 cccbuild = <4-digit number>
103 define CCcam build, default:none
104
105 exmaple: cccbuild = 5678
106
107 cccmaxhop = hops
108 define CCcam maximum SC distance, default:10
109
110 ident = <CAID>:<ident>[,ident]...[,<CAID>:<ident>[,ident]...]...
111 define CAID and ident for reader
112
113 exmaple: ident = 0100:123456,234567;0200:345678,456789
114
115 provid = ID
116 define provider ID for reader
117
118 class = [!]class[,[!]class]...
119 define class in hex for reader
120
121 example: class = 01,02,!1b,!2b
122
123 chid = CAID:ChID
124 define Irdeto ChID for reader
125
126 example: chid = 0100:12
127
128 showcls = quantity
129 number of classes subscriptions to show for Viaccess SCs, default=10
130
131 maxqlen = size
132 size of request queue for reader, default:128
133
134 group = groupname
135 reader assingment to group, required
136
137 emmcache = usecache,rewrite,logging
138 set EMM cache of local reader:
139 usecache = 0|1 1=enable EMM chaching, default:0
140 rewrite = determines how often one and the same EMM is written
141 logging = 0 = log errors only
142 1 = log all EMMs except the double EMMs
143 2 = log all EMMs
144
145 blocknano = nano[,nano]...|all
146 list of EMM-nanos to block (in hex w/o 0x) or all EMM-nanos, only
147 valid for physical readers, default:none
148
149 example: blocknano = 45,93,7a,ff
150 blocknano = all
151
152 savenano = nano[,nano]....|all
153 list of EMM-nanos to save (in hex w/o 0x) or all EMM-nanos, only
154 valid for physical readers, default:none
155
156 example: savenano = 45,93,7a,ff
157 savenano = all
158
159 readnano = [path]filename
160 write file (usually a copy of a file saved by savenano) to your
161 smartcard, if no path is specified, the specified file is searched
162 for in the configuration directory, only valid for physical readers,
163 default:none
164
165 example: readnano = write.emm
166 readnano = /var/oscam/write.emm
167
168 n3_rsakey|rsakey = RSA key
169 RSA key for Nagravision SCs / CAM key data for Irdeto SCs
170
171 n3_boxkey|boxkey = box key
172 box key for Nagravision SCs / CAM key for Irdeto SCs
173
174 tiger_rsakey = RSA key
175 RSA key for Tiger Nagravision SCs
176
177 tiger_ideakey = IDEA key
178 IDEA key for Tiger Nagravision SCs
179
180OVERCLOCKING
181 Dreambox and other internal readers
182
183 For Dreambox and other internal readers the highest possible clock
184 rate will be auto detected. The mhz parameter will be ignored.
185
186 Phoenix / Smartmouse reader
187
188 Overclocking does not work with Windows and Mac OS X. Set mhz
189 equivalent to the frequency of the reader. OSCam can not set the
190 frequency of the reader.
191
192 Smargo Smartreader+
193
194 Set the reader frequency with the native Smargo Smartreader+ tool
195 (srp_tools). Do not set mhz and cardmhz.
196
197 OSCam tries to set the baudrate automatically. A standard serial port
198 has limited baudrate settings, so SC overclocking might not work. When
199 using a serial reader the best way for overclocking is connecting it to
200 a FTDI based USB to serial port adapter.
201
202 If overclocking does not work, verify the effective baudrate in the
203 logfile. If it deviates too much from the requested baudrate, the SC
204 will not be recognized (no ATR) and the value for mhz should be
205 adjusted again. The higher the baudrate, the more accurate the effec
206 tive baudrate can be.
207
208EXAMPLES
209 serial mouse compatible reader
210
211 [reader]
212 label = myserialmousereader
213 detect = cd
214 protocol = mouse
215 device = /dev/ttyS1
216 group = 1
217 caid = 0100
218 services = myservice,!thisservice
219
220 USB mouse compatible reader
221
222 [reader]
223 label = myusbmousereader
224 detect = cd
225 protocol = mouse
226 device = /dev/ttyUSB0
227 aeskey = 0102030405060708090a0b0c0d0e0f10
228 group = 2
229 caid = 0200
230
231 camd 3.78x reader
232
233 [reader]
234 label = mycamd378xreader
235 protocol = cs378x
236 device = 192.168.0.1,1234
237 account = user,password
238 group = 3
239
240 newcamd reader
241
242 [reader]
243 label = mynewcamdreader
244 protocol = newcamd
245 key = 0102030405060708091011121314
246 device = 192.168.0.2,2345
247 account = user,password
248 group = 4
249
250 CCcam reader
251
252 [reader]
253 label = mycccamreader
254 protocol = cccam
255 device = 192.168.0.3,3456
256 account = user,password
257 group = 5
258 caid = 0300,0400,0500
259 cccversion = 1.2.3
260 cccbuild = 4567
261
262 PCSC reader
263
264 [reader]
265 label = mypcscreader
266 protocol = pcsc
267 device = 0
268 aeskey = 0102030405060708090a0b0c0d0e0f10
269 group = 6
270 caid = 0600
271
272SEE ALSO
273 oscam(1), oscam.conf(5), oscam.user(5), oscam.srvid(5), oscam.guess(5),
274 oscam.cert(5), oscam.services(5), oscam.ird(5), oscam.ac(5)
275
276
277
278 oscam.server(5)
Note: See TracBrowser for help on using the repository browser.