0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 Digital TV Conditional Access Interface
0004 =======================================
0005
0006
0007 .. note::
0008
0009 This documentation is outdated.
0010
0011 This document describes the usage of the high level CI API as
0012 in accordance to the Linux DVB API. This is a not a documentation for the,
0013 existing low level CI API.
0014
0015 .. note::
0016
0017 For the Twinhan/Twinhan clones, the dst_ca module handles the CI
0018 hardware handling. This module is loaded automatically if a CI
0019 (Common Interface, that holds the CAM (Conditional Access Module)
0020 is detected.
0021
0022 ca_zap
0023 ~~~~~~
0024
0025 A userspace application, like ``ca_zap`` is required to handle encrypted
0026 MPEG-TS streams.
0027
0028 The ``ca_zap`` userland application is in charge of sending the
0029 descrambling related information to the Conditional Access Module (CAM).
0030
0031 This application requires the following to function properly as of now.
0032
0033 a) Tune to a valid channel, with szap.
0034
0035 eg: $ szap -c channels.conf -r "TMC" -x
0036
0037 b) a channels.conf containing a valid PMT PID
0038
0039 eg: TMC:11996:h:0:27500:278:512:650:321
0040
0041 here 278 is a valid PMT PID. the rest of the values are the
0042 same ones that szap uses.
0043
0044 c) after running a szap, you have to run ca_zap, for the
0045 descrambler to function,
0046
0047 eg: $ ca_zap channels.conf "TMC"
0048
0049 d) Hopefully enjoy your favourite subscribed channel as you do with
0050 a FTA card.
0051
0052 .. note::
0053
0054 Currently ca_zap, and dst_test, both are meant for demonstration
0055 purposes only, they can become full fledged applications if necessary.
0056
0057
0058 Cards that fall in this category
0059 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0060
0061 At present the cards that fall in this category are the Twinhan and its
0062 clones, these cards are available as VVMER, Tomato, Hercules, Orange and
0063 so on.
0064
0065 CI modules that are supported
0066 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0067
0068 The CI module support is largely dependent upon the firmware on the cards
0069 Some cards do support almost all of the available CI modules. There is
0070 nothing much that can be done in order to make additional CI modules
0071 working with these cards.
0072
0073 Modules that have been tested by this driver at present are
0074
0075 (1) Irdeto 1 and 2 from SCM
0076 (2) Viaccess from SCM
0077 (3) Dragoncam
