78 lines
2.1 KiB
ReStructuredText
78 lines
2.1 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
Digital TV Conditional Access Interface
|
|
=======================================
|
|
|
|
|
|
.. note::
|
|
|
|
This documentation is outdated.
|
|
|
|
This document describes the usage of the high level CI API as
|
|
in accordance to the Linux DVB API. This is a not a documentation for the,
|
|
existing low level CI API.
|
|
|
|
.. note::
|
|
|
|
For the Twinhan/Twinhan clones, the dst_ca module handles the CI
|
|
hardware handling. This module is loaded automatically if a CI
|
|
(Common Interface, that holds the CAM (Conditional Access Module)
|
|
is detected.
|
|
|
|
ca_zap
|
|
~~~~~~
|
|
|
|
A userspace application, like ``ca_zap`` is required to handle encrypted
|
|
MPEG-TS streams.
|
|
|
|
The ``ca_zap`` userland application is in charge of sending the
|
|
descrambling related information to the Conditional Access Module (CAM).
|
|
|
|
This application requires the following to function properly as of now.
|
|
|
|
a) Tune to a valid channel, with szap.
|
|
|
|
eg: $ szap -c channels.conf -r "TMC" -x
|
|
|
|
b) a channels.conf containing a valid PMT PID
|
|
|
|
eg: TMC:11996:h:0:27500:278:512:650:321
|
|
|
|
here 278 is a valid PMT PID. the rest of the values are the
|
|
same ones that szap uses.
|
|
|
|
c) after running a szap, you have to run ca_zap, for the
|
|
descrambler to function,
|
|
|
|
eg: $ ca_zap channels.conf "TMC"
|
|
|
|
d) Hopefully enjoy your favourite subscribed channel as you do with
|
|
a FTA card.
|
|
|
|
.. note::
|
|
|
|
Currently ca_zap, and dst_test, both are meant for demonstration
|
|
purposes only, they can become full fledged applications if necessary.
|
|
|
|
|
|
Cards that fall in this category
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
At present the cards that fall in this category are the Twinhan and its
|
|
clones, these cards are available as VVMER, Tomato, Hercules, Orange and
|
|
so on.
|
|
|
|
CI modules that are supported
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The CI module support is largely dependent upon the firmware on the cards
|
|
Some cards do support almost all of the available CI modules. There is
|
|
nothing much that can be done in order to make additional CI modules
|
|
working with these cards.
|
|
|
|
Modules that have been tested by this driver at present are
|
|
|
|
(1) Irdeto 1 and 2 from SCM
|
|
(2) Viaccess from SCM
|
|
(3) Dragoncam
|