ci.rst 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677
  1. .. SPDX-License-Identifier: GPL-2.0
  2. Digital TV Conditional Access Interface
  3. =======================================
  4. .. note::
  5. This documentation is outdated.
  6. This document describes the usage of the high level CI API as
  7. in accordance to the Linux DVB API. This is a not a documentation for the,
  8. existing low level CI API.
  9. .. note::
  10. For the Twinhan/Twinhan clones, the dst_ca module handles the CI
  11. hardware handling. This module is loaded automatically if a CI
  12. (Common Interface, that holds the CAM (Conditional Access Module)
  13. is detected.
  14. ca_zap
  15. ~~~~~~
  16. A userspace application, like ``ca_zap`` is required to handle encrypted
  17. MPEG-TS streams.
  18. The ``ca_zap`` userland application is in charge of sending the
  19. descrambling related information to the Conditional Access Module (CAM).
  20. This application requires the following to function properly as of now.
  21. a) Tune to a valid channel, with szap.
  22. eg: $ szap -c channels.conf -r "TMC" -x
  23. b) a channels.conf containing a valid PMT PID
  24. eg: TMC:11996:h:0:27500:278:512:650:321
  25. here 278 is a valid PMT PID. the rest of the values are the
  26. same ones that szap uses.
  27. c) after running a szap, you have to run ca_zap, for the
  28. descrambler to function,
  29. eg: $ ca_zap channels.conf "TMC"
  30. d) Hopefully enjoy your favourite subscribed channel as you do with
  31. a FTA card.
  32. .. note::
  33. Currently ca_zap, and dst_test, both are meant for demonstration
  34. purposes only, they can become full fledged applications if necessary.
  35. Cards that fall in this category
  36. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  37. At present the cards that fall in this category are the Twinhan and its
  38. clones, these cards are available as VVMER, Tomato, Hercules, Orange and
  39. so on.
  40. CI modules that are supported
  41. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  42. The CI module support is largely dependent upon the firmware on the cards
  43. Some cards do support almost all of the available CI modules. There is
  44. nothing much that can be done in order to make additional CI modules
  45. working with these cards.
  46. Modules that have been tested by this driver at present are
  47. (1) Irdeto 1 and 2 from SCM
  48. (2) Viaccess from SCM
  49. (3) Dragoncam