1*4882a593Smuzhiyun.. SPDX-License-Identifier: GPL-2.0 2*4882a593Smuzhiyun 3*4882a593SmuzhiyunDigital TV Conditional Access Interface 4*4882a593Smuzhiyun======================================= 5*4882a593Smuzhiyun 6*4882a593Smuzhiyun 7*4882a593Smuzhiyun.. note:: 8*4882a593Smuzhiyun 9*4882a593Smuzhiyun This documentation is outdated. 10*4882a593Smuzhiyun 11*4882a593SmuzhiyunThis document describes the usage of the high level CI API as 12*4882a593Smuzhiyunin accordance to the Linux DVB API. This is a not a documentation for the, 13*4882a593Smuzhiyunexisting low level CI API. 14*4882a593Smuzhiyun 15*4882a593Smuzhiyun.. note:: 16*4882a593Smuzhiyun 17*4882a593Smuzhiyun For the Twinhan/Twinhan clones, the dst_ca module handles the CI 18*4882a593Smuzhiyun hardware handling. This module is loaded automatically if a CI 19*4882a593Smuzhiyun (Common Interface, that holds the CAM (Conditional Access Module) 20*4882a593Smuzhiyun is detected. 21*4882a593Smuzhiyun 22*4882a593Smuzhiyunca_zap 23*4882a593Smuzhiyun~~~~~~ 24*4882a593Smuzhiyun 25*4882a593SmuzhiyunA userspace application, like ``ca_zap`` is required to handle encrypted 26*4882a593SmuzhiyunMPEG-TS streams. 27*4882a593Smuzhiyun 28*4882a593SmuzhiyunThe ``ca_zap`` userland application is in charge of sending the 29*4882a593Smuzhiyundescrambling related information to the Conditional Access Module (CAM). 30*4882a593Smuzhiyun 31*4882a593SmuzhiyunThis application requires the following to function properly as of now. 32*4882a593Smuzhiyun 33*4882a593Smuzhiyuna) Tune to a valid channel, with szap. 34*4882a593Smuzhiyun 35*4882a593Smuzhiyun eg: $ szap -c channels.conf -r "TMC" -x 36*4882a593Smuzhiyun 37*4882a593Smuzhiyunb) a channels.conf containing a valid PMT PID 38*4882a593Smuzhiyun 39*4882a593Smuzhiyun eg: TMC:11996:h:0:27500:278:512:650:321 40*4882a593Smuzhiyun 41*4882a593Smuzhiyun here 278 is a valid PMT PID. the rest of the values are the 42*4882a593Smuzhiyun same ones that szap uses. 43*4882a593Smuzhiyun 44*4882a593Smuzhiyunc) after running a szap, you have to run ca_zap, for the 45*4882a593Smuzhiyun descrambler to function, 46*4882a593Smuzhiyun 47*4882a593Smuzhiyun eg: $ ca_zap channels.conf "TMC" 48*4882a593Smuzhiyun 49*4882a593Smuzhiyund) Hopefully enjoy your favourite subscribed channel as you do with 50*4882a593Smuzhiyun a FTA card. 51*4882a593Smuzhiyun 52*4882a593Smuzhiyun.. note:: 53*4882a593Smuzhiyun 54*4882a593Smuzhiyun Currently ca_zap, and dst_test, both are meant for demonstration 55*4882a593Smuzhiyun purposes only, they can become full fledged applications if necessary. 56*4882a593Smuzhiyun 57*4882a593Smuzhiyun 58*4882a593SmuzhiyunCards that fall in this category 59*4882a593Smuzhiyun~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 60*4882a593Smuzhiyun 61*4882a593SmuzhiyunAt present the cards that fall in this category are the Twinhan and its 62*4882a593Smuzhiyunclones, these cards are available as VVMER, Tomato, Hercules, Orange and 63*4882a593Smuzhiyunso on. 64*4882a593Smuzhiyun 65*4882a593SmuzhiyunCI modules that are supported 66*4882a593Smuzhiyun~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 67*4882a593Smuzhiyun 68*4882a593SmuzhiyunThe CI module support is largely dependent upon the firmware on the cards 69*4882a593SmuzhiyunSome cards do support almost all of the available CI modules. There is 70*4882a593Smuzhiyunnothing much that can be done in order to make additional CI modules 71*4882a593Smuzhiyunworking with these cards. 72*4882a593Smuzhiyun 73*4882a593SmuzhiyunModules that have been tested by this driver at present are 74*4882a593Smuzhiyun 75*4882a593Smuzhiyun(1) Irdeto 1 and 2 from SCM 76*4882a593Smuzhiyun(2) Viaccess from SCM 77*4882a593Smuzhiyun(3) Dragoncam 78