Tvheadend

Ok this is how I installed Oscam:

Install tools 
    apt-get install apt-utils dialog usbutils gcc g++ wget build-essential subversion libpcsclite1 libpcsclite-dev libssl-dev cmake make libusb-1.0-0-dev nano

Get oscam source
    cd /usr/src 
    svn checkout http://www.streamboard.tv/svn/oscam/trunk oscam-svn

Configure, build and install oscam
    cd oscam-svn
Configure options
    make config
Compile Oscam
    make OSCAM_BIN=./build/oscam
Copy Oscam to destination and set permissions
    cp /usr/src/oscam-svn/build/oscam /var/local/oscam
    chmod 755 /var/local/oscam

Copy example config file 
     cp /usr/src/oscam-svn/Distribution/doc/example/oscam.conf /usr/local/etc/

Edit the config file and enable webif
    nano /usr/local/etc/oscam.conf 

This is what my file looks like:

####################
#
# main configuration
[global]
logfile                       = /var/log/oscam/oscam.log
pidfile                       = /var/run/oscam.pid
disableuserfile               = 0
nice                          = 20
maxlogsize                    = 10240
cacheexenablestats            = 1
usrfile                       = /var/log/oscam/oscamuser.log
cwlogdir                      = /var/log/oscam/cw/
emmlogdir                     = /var/log/oscam/emm/
ecmfmt                        = c:s/w

# logging

logfile       = /var/log/oscam/oscam.log
usrfile       = /var/log/oscam/oscamuser.log
cwlogdir      = /var/log/oscam/cw

# monitor

[monitor]
port          = 988
aulow          = 120
monlevel      = 1

# web interface

[webif]
httpport      = 8888
httpuser      = xxxxx
httppwd       = xxxxx
httpallowed   = 127.0.0.1,192.168.1.0-192.168.1.255

####################

Make sure to change httpuser,httppwd to a username and password to your liking and httpallowed the the ip's you want to give access the the webif.

We want to start oscam on boot so create a init script
    nano /etc/init.d/oscam

(add everything between the two ==== lines in this file:

=================
#! /bin/sh
### BEGIN INIT INFO
# Provides:          Oscam
# Required-Start:    $remote_fs $syslog
# Required-Stop:     $remote_fs $syslog
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Oscam init script
# Description:       Launch oscam at startup
### END INIT INFO

DAEMON=/var/local/oscam
DEAMON_OPTS="-b -r 2" 
PIDFILE=/var/run/oscam.pid

test -x ${DAEMON} || exit 0

. /lib/lsb/init-functions

case "$1" in
    start)
log_daemon_msg "Starting OScam" 
start-stop-daemon --start --quiet –user- --background --pidfile ${PIDFILE} --make-pidfile --exec ${DAEMON} -- ${DAEMON_OPTS}
log_end_msg $?
    ;;
    stop)
log_daemon_msg "Stopping OScam" 
start-stop-daemon --stop --exec ${DAEMON}
log_end_msg $?
    ;;
    force-reload|restart)
    $0 stop
    $0 start
    ;;
  *)
    echo "Usage: /etc/init.d/oscam {start|stop|restart|force-reload}" 
    exit 1
    ;;
esac

exit 0

=================

Set the permissions
    chmod 755 /etc/init.d/oscam

Make the init file actually start on boot
    update-rc.d oscam defaults

Create files and directories for oscam and set permissions (these are defined in the config file so if you change them there make sure to change the location of where you create these files aswell.
    mkdir /var/log/oscam
    touch /var/log/oscam/oscam.log
    chmod 755 /var/log/oscam/oscam.log
    touch /var/log/oscam/oscamuser.log
    chmod 755 /var/log/oscam/oscamuser.log
    mkdir /var/log/oscam/cw
    chmod 755 /var/log/oscam/cw

Start oscam
    /etc/init.d/oscam start

Now point your browser to http://ip-of-your-oscam-server:8888/ login, configure newcamd, add a user and add a reader (your cccam server). Finally configure TVheadend to connect to Oscam and you should be able to start watching encrypted TV channels.

p.s. im on debian and logged in as root for this. If your under ubuntu you might need to use sudo infront of some of the commands in this guide.

Great guide Franklyn - could you provide a bit more guidance about the newcamd, user and reader configs ?

I think there are a couple of typos as well :

Instead of : chmod 755 /var/local oscam I think you need chmod 755 /var/local/oscam

and instead of : nano /etc/init.d/osam I think you need nano /etc/init.d/oscam

Thanks again though - really useful.

I have a CCCAM share from a card in my DM800 that I'd like to use within TV Headend, and I think Oscam is the key.

Yeh your right those where typos indeed. Thanks for the headsup. I have edited my post so it should be ok now.

As far as I know there is no way to let tvheadened communicate directly to cccam. So it will need to go like: tvheadend – Oscam – CCcam.

First off make a f-line in your cccam config for Oscam.

Connect Oscam to CCcam

In oscam go to

Reader
At the bottom fill in the name of your reader and click the "Add" button next to it.

Fill in these fields:
Description:
Enable: Tick it to make this reader active
Device: Fill in the ip address of you dreambox followed by a comma and then the port. Example 192.168.1.100,18500
Group: Just fill in any number here. Example: 1
CAID: Fill in the CAID of the providers the cccam server will be handling. Add a comma in between multiple CAID's. Example: 0100,0604,0B00 (These are my providers and unless you’re in the Netherlands like me, these are not gonna work for you. So don't just copy this.)
User: The user name you made for oscam in your cccam config.
Password: Password for the above user.
Hit "Save"

Make a User for Tvheadend in Oscam

Go to Users
Click the “Add User” link on the top
On the bottom a new input field will appear. Fill in the user name here and click the “Add User” button next to it.

Fill in these fields:
Password
Description
Disabled – Change to “No”
Group - Add the user to the same group(s) as the reader is in. ("1" in our example)
Hit "Save"

Both the configuration for user and reader have loads more options. You can play around if you like. For more info just click the parameter name and it will take you to the Oscam wiki and the appropriate article for that parameter. Note that the above options should be enough to get it working so just try to get it working first before you go crazy with all the options.

Configure Newcamd in Oscam

Go to Configuration and then Newcamd.

Fill in these fields:
Port:
Syntax: port@caid:ident
Every CAID needs to have a separate port. So in my case I will need to make 3 ports for Newcamd, one for 0100, one for 0B00 and one for 0604.
You can pick any free port. Keep in mind that ports between 0 through 1023 are used by most well-known services so don’t use these, use anything between 1024 and 65535. I use 15000 and up for Newcamd.
Adding a port for CAID 0604 would look like: 15000@0604:000000. Where 15000 is the port, 0604 the CAID and 000000 the ident. (Don’t bother about the ident just fill in 000000 there)

Multiple entries are separated by an semicolon. So for me this is what is in the ports field: 15000@0604:000000;15001@0B00:000000;15002@0100:000000

Key: Fill in any 28 digit number you like. This DES key will be used for Newcamd client encryption. Example: 0102030405060708091011121314

Allowed: This one doesn’t need to be specified. But here you can enter ip’s that you want to allow to connect to Oscam via Newcamd on the above specified ports. If you leave this empty all address will be allowed to connect.
Hit "Save"

You are all done now in Oscam. Just go to shutdown and click restart to make the changes for Newcamd active. After this Oscam should be ready. Check the status page to be sure that Oscam is connected to your cccam server. The connection should appear under proxies.

Connect TVheadend to Oscam

Go to TVheadend -> Configuration -> Code Word Client.
Click “Add Entry”

Fill in these fields:
Hostname: Fill in the ip address of your Oscam server
Port: The Newcamd port you made in Oscam. So in my example: 15000, 15001 or 15002
Username and Password: The ones you made in Oscam under Users.
DES key: The 28 digit number you specified in the Newcamd configuration. In the example case: 0102030405060708091011121314.
Click “Save Entry”

If you done everything right TVheadend should connect to Oscam. And it should be able to decode any encrypted channel your cccam server can provide the keys for.

Thanks Franklyn

Thanks Franklyn, Worked a treat