Dit artikel beschetft de stappen voor het handmatig installeren van een OSCam server op Linux set-top boxes (STB). OSCam is een software die gebruikt wordt om televisiezenders te ontsleutelen op een ontvanger. Sommige STB-images ondersteunen de OSCam server niet standaard. In zulke gevallen is een handmatige installatie noodzakelijk.
Belangrijke opmerking: Alle handelingen worden op eigen risico uitgevoerd. Mogelijk ontbrekende mappen moeten handmatig worden aangemaakt. Voer alle commando's uit als root gebruiker.
Stap 1: Voorbereiding en Identificatie
Voordat u begint met de installatie, is het essentieel om de juiste OSCam binary te verkrijgen die compatibel is met de architectuur van uw set-top box. Dit kan worden achterhaald door de CPU-architectuur te identificeren.
Identificeren van de CPU Architectuur
U kunt de chipset/CPU-architectuur van uw set-top box achterhalen met behulp van de volgende commando's in de shell (commandoregel):
- uname -m
- Of, indien van toepassing: [ -d /etc/dpkg ] && dpkg --print-architecture || opkg print-architecture
Veelvoorkomende architecturen zijn mipsel, arm_v7, aarch64, en sh4.
Stap 2: Verkrijgen en Plaatsen van de OSCam Binary
Nadat de architectuur bekend is, downloadt u de corresponderende OSCam binary. Als het bestand is gecomprimeerd (bijvoorbeeld .rar, .zip, .7z, .tar.gz), dient u het eerst uit te pakken.
Vervolgens uploadt u het uitgepakte binaire bestand via een FTP-verbinding naar de volgende map op uw set-top box: /usr/bin/.
Als de naam van het binaire bestand niet simpelweg oscam is, hernoem het dan naar oscam.
Stap 3: Configuratiebestanden en Scripts
Na het plaatsen van de binary, moeten de configuratiebestanden en een startscript worden aangemaakt en correct geconfigureerd.
Configuratiebestanden
Kopieer of maak de volgende OSCam configuratiebestanden aan in de map /etc/tuxbox/config/oscam/ op uw set-top box:
- oscam.conf
- oscam.dvbapi
- oscam.server
- oscam.srvid
- oscam.user
Voor deze configuratiebestanden is autorisatie 644 voldoende.
Auto-start Script
Creëer een scriptbestand genaamd softcam.oscam in de map /etc/init.d/ met de volgende inhoud:
#!/bin/sh## OSCam server script## Start/Stop OSCam## chkconfig: 345 90 10# description: OSCam serverOSCAM_BIN=/usr/bin/oscamOSCAM_CFG=/etc/tuxbox/config/oscam/OSCAM_LOG=/var/log/oscam.logcase "$1" in start) echo "Starting OSCam..." start-stop-daemon --start --quiet --pidfile /var/run/oscam.pid --exec $OSCAM_BIN -- -c $OSCAM_CFG >> $OSCAM_LOG 2>&1 ;; stop) echo "Stopping OSCam..." start-stop-daemon --stop --quiet --pidfile /var/run/oscam.pid ;; restart) $0 stop $0 start ;; status) start-stop-daemon --status --pidfile /var/run/oscam.pid exit $? ;; *) echo "Usage: $0 {start|stop|restart|status}" exit 1 ;;esacexit 0U kunt eventueel het versienummer in het script aanpassen, maar dit is niet verplicht.
Zorg ervoor dat het bestand softcam.oscam de autorisatie 755 of 777 heeft.
Stap 4: Testen en Debuggen
Na het instellen van de configuratiebestanden en het startscript, is het tijd om de installatie te testen.
Testen van de OSCam Start
Open een Telnet-console en voer het volgende commando uit:
/etc/init.d/softcam.oscam start
Als OSCam succesvol start, ziet u geen foutmeldingen. Indien u een foutmelding ontvangt zoals "/usr/bin/oscam: error while loading shared libraries: libusb-1.0.so.0: cannot open shared", dient u de bibliotheek libusb te installeren. Raadpleeg de documentatie voor de specifieke procedure voor uw systeem.
Waarschuwing: Een waarschuwing zoals "Warning: Using a stub executable, this will not grant you access to any channels." is normaal en hoeft geen zorgen te baren.
Stap 5: Automatisch Starten van OSCam
Om ervoor te zorgen dat OSCam automatisch start bij het opstarten van de set-top box, moeten symbolische links worden aangemaakt in de rc.d-mappen.
Symbolische Links Maken
Maak eerst een symbolische link naar het softcam.oscam-script:
cd /etc/init.d/
ln -s softcam.oscam softcam
Vervolgens maakt u de symbolische links aan in de rc.d-directories om OSCam automatisch te laten starten:
cd /etc/init.d/
update-rc.d -n softcam defaults 50 50
Alternatieve methode voor auto-start:
Als het commando update-rc.d niet werkt, kunt u de volgende commando's gebruiken:
- Om te starten: ln -sf /etc/init.d/softcam /etc/rc3.d/S90softcam
- Om te verwijderen: rm -f /etc/rc3.d/S90softcam
De standaard run-level in de meeste Enigma-edities is 3. De map /etc/rc3.d/ wordt dan gebruikt.
Specifieke gevallen: OpenATV / OpenPLi
Voor systemen zoals OpenATV of OpenPLi met ingebouwde Softcam-ondersteuning, downloadt u het softcam-bestand met de extensie .oscam naar de map /etc/init.d/ met het wget commando. In dit geval wordt de update-rc.d tool niet gebruikt; de softcam wordt via de GUI van Enigma geactiveerd.
Stap 6: Configureren van OSCam
Nu OSCam is geïnstalleerd, is het tijd om de configuratiebestanden aan te passen aan uw specifieke situatie.
oscam.conf Aanpassen
Begin met het aanpassen van het oscam.conf-bestand. Een belangrijk punt hier is de sectie [newcamd]. Hier vindt u de poort waarop TVHeadEnd (of een andere client) met OSCam kan communiceren. Daarachter staat het kaart-ID (bijvoorbeeld 0602) en een waarde die aangeeft welke kanalen ontsleuteld kunnen worden.
Zet deze waarde in eerste instantie op 000000, wat betekent "alles ontsleutelen". Later kunt u dit aanpassen om alleen sleutels voor uw specifieke zenderpakket te verwerken, wat zorgt voor sneller zappen.
oscam.user Aanpassen
Pas daarna het oscam.user-bestand aan. Hier worden de gebruikers geconfigureerd waarmee uw client (bijvoorbeeld TVHeadEnd) kan communiceren. Eén tuner vereist één gebruiker; twee tuners vereisen twee gebruikers, enzovoort.
Stap 7: Logbestanden Analyseren
Na het herstarten van OSCam (bijvoorbeeld via het Synology package center indien van toepassing, of via het eerder aangemaakte script), kunt u de laatste regels van het OSCam logbestand bekijken om informatie te verkrijgen.
Gebruik het volgende Linux-commando:
tail -n50 /var/packages/oscam/target/var/log/oscam.log (pas het pad aan indien nodig)
Als uw smartcard correct is herkend, vindt u in de log ergens een caid (kaart-ID). Als dit afwijkt van uw verwachte ID (bijvoorbeeld 0602), moet u dit aanpassen in de verschillende OSCam-configuratiebestanden.
Zoek naar een regel zoals "entitlements for provider: 1, id 046EDD". Dit is de code die u op verschillende plaatsen in de configuratiebestanden moet invoeren in plaats van 000000. Dit zorgt ervoor dat alleen sleutels voor zenders uit uw beschikbare pakket worden verwerkt.
U ziet mogelijk ook diverse chid's (codes van vier karakters). Noteer deze (of maak een screenshot) en bewerk het oscam.server-bestand opnieuw. Vervang de optie chid door uw kaartnummer, gevolgd door een dubbele punt en vervolgens de chid's, gescheiden door komma's en met telkens twee nullen ervoor.
Stap 8: PUtty en SSH/Telnet Verbinding
PuTTY is een populaire SSH- en Telnet-client voor Windows, oorspronkelijk ontwikkeld door Simon Tatham. Met PuTTY kunt u verbinding maken met de commandoregel (Shell) van uw set-top box.
Na het verbinden via SSH/Telnet met uw set-top box, bent u nu verbonden met de shell en kunt u de hierboven beschreven handmatige installatiestappen uitvoeren.
CI+ Ondersteuning en Gerelateerde Technologieën
De discussie rondom CI+ (Conditional Access Module Plus) is complex. CI+ is een softwarematige aanpassing op de standaard CI. De hardware is grotendeels gelijk, maar CI+ vereist extra functies voor correcte werking, zoals de pairing van de module met de box en gecodeerde communicatie tussen de CI+ module en de box.
CIPlusHelpers bieden deze extra functies, maar zijn vaak geen standaard plugins en zijn specifiek toegesneden voor bepaalde images of boxen. TechniSat levert bijvoorbeeld CI+ ontvangers, maar deze draaien vaak gesloten Linux-systemen zonder Enigma2.
Er wordt gewerkt aan het toevoegen van CI+ functionaliteit aan Enigma2-systemen, zoals OpenPLi 9. De implementatie ervan kan vergelijkbaar zijn met die van softcams. Hoewel de softcam-software zelf niet illegaal is, wordt het gebruik ervan illegaal wanneer er illegale keys aan worden toegevoegd.
Voor gebruikers die momenteel kijken via een losse smartcard zonder illegale keys, blijft de softcam-implementatie legaal. Dit geldt niet voor gepatchte OSCam-emu's die gebruikt worden voor illegale Pay-TV toegang.
De Ziggo RSA key is bijvoorbeeld ook vindbaar, wat duidt op de beschikbaarheid van bepaalde informatie.
CanalDigitaal Anti-Cardsharing Beveiliging
Vanaf 10 januari 2012 heeft CanalDigitaal de anti-cardsharing beveiliging ingevoerd. Het delen van abonnementen van één smartcard is beperkt tot vier clients. Standaard geldt een limiet van twee clients.
Kaartversie Updaten
Om vier clients te kunnen aansturen, moet de CanalDigitaal smartcard worden opgewaardeerd naar kaartversie I4A. In alle andere gevallen zijn slechts twee clients toegestaan.
Gebruikers met CanalDigitaal Gecertificeerde Ontvangers
Indien u een door CanalDigitaal gecertificeerde satellietontvanger bezit, hoeft u niets te doen. De benodigde software is reeds naar uw kaart gestuurd en de werking zal niet veranderen.
Gebruikers met Linux Satellietontvangers (Dreambox, VU+, etc.)
Als u een Linux satellietontvanger gebruikt, dient u deze te voorzien van de laatste firmwareversie (bijvoorbeeld OpenPLi). Vervolgens moet u de softcam CCcam versie 2.3.0 installeren. Alleen hiermee wordt uw smartcard voorzien van de nieuwe kaartversie.
De kaartversie kan worden opgevraagd in OpenPLi via Blauwe toets / PPanels / CCcam / Smartcard Info.
Als uw smartcard meerdere kaartupdates heeft gemist, moet u de smartcard enige seconden uit de lezer halen en weer terugplaatsen. Herhaal dit totdat de kaartversie I4A wordt weergegeven.
Om de kaartupdate te ontvangen, dient de satellietontvanger op een van de Nederlandse zenders te zijn afgestemd.
Let op: Oude Mediaguard2 smartcards ondersteunen geen CCcam versie 2.3.0.
Gebruikers met OSCam Softcam
Indien u een Linux satellietontvanger gebruikt met de OSCam softcam, installeer dan de laatste firmwareversie en gebruik de OSCam Experimental softcam. OSCam kan het versienummer niet altijd weergeven.
Als de kaartversie nog niet I4A is, kunt u deze updaten door de ontvanger enige tijd met de smartcard in de interne lezer op een Nederlandse zender af te stemmen. Met OSCam Experimental hoeft u de smartcard niet meerdere keren te verwijderen.
Met kaartversie I4A kunt u maximaal vier clients aansturen.
Client Definitie in Linux Ontvangers
Bij gebruik van Linux satellietontvangers wordt elk opgenomen programma als één client beschouwd, omdat opgenomen programma's ongecodeerd op de harde schijf worden geplaatst.
Gecertificeerde satellietontvangers tellen opgenomen programma's niet als clients, omdat deze programma's gecodeerd worden opgeslagen. U kunt dus zoveel programma's opnemen als de hardware toelaat, mits u ze binnen 2 dagen na opname decodeert via de satellietontvanger.
Opnames en Snel Zappen
Overlappende opnames zijn mogelijk. Als ingesteld, kunnen programma's voor en na de geplande tijd doorlopen.
Bij gebruik van softcams zoals CCcam in uw Linux ontvanger is het aan te raden om interne limietinstellingen (bijvoorbeeld 4 per 10 seconden) niet te activeren, aangezien dit het aantal beschikbare clients kan beïnvloeden en het zappen kan vertragen.
Gecertificeerde ontvangers hebben geen problemen met snel zappen. De meeste Linux ontvangers hebben een hardwarematige limiet van 4 simultaan te demuxen zenders.
Hardware en Software Keuzes
Bij de keuze van een ontvanger is het belangrijk te letten op de prijs en de mogelijkheden. Dreambox receivers worden vaak als duur beschouwd, met klonen die goedkoper zijn. Xtrend receivers, zoals de ET4000 (single tuner) en ET9500 (dual tuner), bieden een goede prijs-kwaliteitverhouding.
Bij de installatie van een "image" (besturingssysteem) op de receiver, kunt u kiezen voor een door de producent vrijgegeven image of een "hobby" image, vaak onder de noemer OpenPLi. Enigma2 is de Linux kernel waarop OpenPLi gebaseerd is.
Hobby images zijn niet alleen gericht op normaal tv-kijken, maar ook op cardsharing. Door het gebruik van softcams vervalt de noodzaak voor een Common Interface module.
Cardsharing Principe
Cardsharing is het delen van een smartcard onder meerdere receivers. Eén receiver fungeert als server en deelt de kaartdata met andere receivers (clients). Dit kan intern (binnen één huis) of extern (niet toegestaan).
De server-receiver heeft een kaart van de provider en een softcam. Clients hebben ook een softcam nodig, die compatibel moet zijn met de softcam op de server. Veelgebruikte softcams zijn CCcam, OSCam, en mgcamd, elk met eigen voor- en nadelen en configuratievereisten.
Configuratie CCcam
Bij een standaard installatie van OpenPLi 3.0 kunt u via het menu naar systeeminstellingen -> plugins gaan om CCcam en andere handige plugins (zoals epgrefresh) te installeren.
Vervolgens moet u de CCcam configuratie op de server-receiver aanpassen. In het bestand /etc/CCcam.cfg definieert u een F-line (bijvoorbeeld: F: user_BoxA pw_BoxA) voor elke client.
Clients ontvangen een C-line in hun CCcam.cfg bestand, die de verbindingsgegevens naar de server definieert:
C: <server_ip> <port> <user> <password> <want_to_receive_emus_from_server>
Voorbeeld:
BoxA C: 192.168.0.10 12000 user_BoxA pw_BoxA no
BoxB C: 192.168.0.10 12000 user_BoxB pw_BoxB n0
Na het opslaan van de CCcam.cfg zou de verbinding moeten werken.