BGPVR Operator guide
Български
Operator guide

Softcam Enterprise

Needs a Enterprise licence or higher.

Conditional Access: choose between hardware CI, a local OSCam, or your own OSCam on another server; set up physical smart card readers and static keys you are entitled to use; and watch live descrambling diagnostics (ECM timing, scrambled sessions, OSCam log). Use it only with smart cards and keys you may use for redistribution under a written agreement with the content provider: card sharing and descrambling without the content provider's permission are not allowed. The nav item is "Softcam"; the page heading is "Conditional Access".

On this page
  1. Choose the CA path
  2. Set up card readers
  3. Load static keys
  4. Diagnose descrambling
  5. Restart the descrambler
  6. Watch out

Choose the CA path

In "CA Integration Settings" set Conditional Access Mode to Disabled, "Hardware CI / CI+ only", "Local OSCam on this BGPVR server" or "Remote / Network CAM (OSCam elsewhere)". Tick "Enable CAPMT / camd.socket" to have DVBlast pass -K and route ECM requests through the local camd.socket. Fill Remote OSCam Host/Port only for Network CAM mode, plus camd.socket path and OSCam WebIF URL, then press "Save CA Settings".

Set up card readers

Plug a physical smart card into a PC/SC or USB card reader on this server, then under "Card readers" press "Show and edit", add a [reader] section for it (the shipped oscam.server has a commented PC/SC example) and save with the save bar. Only use a card you may use for redistribution under a written agreement with the content provider; a consumer viewing card is for one household. Saving the readers file restarts OSCam automatically. A reader that takes control words from another server over the network (any network sharing protocol) is refused until an admin presses "Confirm agreement…" and ticks "I hold a written agreement from the content provider allowing redistribution of the channels these readers decrypt."; the name, time and text are logged, and "Withdraw confirmation" ends it.

Load static keys

Only for keys the content provider issued to you in writing, such as a BISS key for a contribution feed. Under "Static keys" press "Show and edit", paste the lines into the SoftCam.Key editor or use "Load from a file…" (the file is read into the editor; it is not saved until you save with the save bar). Saving keys does not restart OSCam.

Diagnose descrambling

"Live Diagnostics" shows status cards for Mode, CAPMT, OSCam (Running/Stopped), DVBlast (Available/Missing), camd.socket (Active / Present (idle) / Missing) and Scrambled Sessions, a Runtime Summary (WebIF URL, dvbapi port, PMT mode, socket path, DVBlast binary), the "Active Scrambled Sessions" table (adapter, network, frequency, CA mode with a coloured dot for camd.socket vs hardware CI vs no wiring, service count, CA systems, names), "ECM Statistics" (total, successful, errors, timeouts, avg/last/min/max ms) and the recent OSCam log. "Refresh" reloads it.

Restart the descrambler

"Force Restart OSCam" restarts the process and refreshes the status badge (OSCam Running · PID N, or OSCam Stopped) and diagnostics.

Watch out

  • OSCam web page is local only (2.9.454): it now answers only on the server itself (127.0.0.1), and OSCam's internal account bgpvr has this install's own password (BGPVR_DATA/.oscam_password, or OSCAM_PASSWORD in the environment) instead of the shipped bgpvr/bgpvr. Existing installs are switched over at the next start; the old files are kept as oscam.conf.pre-2.9.454 and oscam.user.pre-2.9.454. Descrambling is unchanged: the dvbapi link does not use the password. To open the web page from another computer, use an SSH tunnel: ssh -L 8888:127.0.0.1:8888 <server>, then http://127.0.0.1:8888 on that computer. If you set your own WebIF login (httpuser + httppwd in oscam.conf) or your own password for bgpvr, the suite leaves them alone. If Settings → Softcam → OSCam web page or Settings → AI → AI service URL names this server's LAN address, change it to http://127.0.0.1:8888 / http://127.0.0.1:18097: the suite reaches both on 127.0.0.1 only now.
  • The entire module is licence-gated: every /api/softcam/* call is refused with 403 "Conditional Access requires an Enterprise license" on Free/Pro/Business, so on those tiers the page loads but every panel fails.
  • Saving the readers file triggers an OSCam restart — in-flight descrambling drops. Saving static keys does not restart.
  • camd.socket showing "Present (idle)" is normal when nothing scrambled is playing; only "Missing" is a wiring fault.
  • The page's own Operator Notes state that hardware CI keeps priority on CI-enabled adapters and that "Hardware CI / CI+ only" mode keeps softcam out of the path entirely — the mode dropdown is not the only thing deciding what descrambles a service.
  • Network CAM mode is for your own OSCam on another server: it only stores that target for the next CAPMT pass; setting it does not by itself prove connectivity to the remote OSCam.
  • ECM statistics auto-refresh every 10 seconds while the panel is on screen.