1 /* SPDX-License-Identifier: LGPL-2.1+ WITH Linux-syscall-note */
2 /*
3 * ca.h
4 *
5 * Copyright (C) 2000 Ralph Metzler <ralph@convergence.de>
6 * & Marcus Metzler <marcus@convergence.de>
7 * for convergence integrated media GmbH
8 */
9
10 #ifndef _DVBCA_H_
11 #define _DVBCA_H_
12
13 /**
14 * struct ca_slot_info - CA slot interface types and info.
15 *
16 * @num: slot number.
17 * @type: slot type.
18 * @flags: flags applicable to the slot.
19 *
20 * This struct stores the CA slot information.
21 *
22 * @type can be:
23 *
24 * - %CA_CI - CI high level interface;
25 * - %CA_CI_LINK - CI link layer level interface;
26 * - %CA_CI_PHYS - CI physical layer level interface;
27 * - %CA_DESCR - built-in descrambler;
28 * - %CA_SC -simple smart card interface.
29 *
30 * @flags can be:
31 *
32 * - %CA_CI_MODULE_PRESENT - module (or card) inserted;
33 * - %CA_CI_MODULE_READY - module is ready for usage.
34 */
35
36 struct ca_slot_info {
37 int num;
38 int type;
39 #define CA_CI 1
40 #define CA_CI_LINK 2
41 #define CA_CI_PHYS 4
42 #define CA_DESCR 8
43 #define CA_SC 128
44
45 unsigned int flags;
46 #define CA_CI_MODULE_PRESENT 1
47 #define CA_CI_MODULE_READY 2
48 };
49
50
51 /**
52 * struct ca_descr_info - descrambler types and info.
53 *
54 * @num: number of available descramblers (keys).
55 * @type: type of supported scrambling system.
56 *
57 * Identifies the number of descramblers and their type.
58 *
59 * @type can be:
60 *
61 * - %CA_ECD - European Common Descrambler (ECD) hardware;
62 * - %CA_NDS - Videoguard (NDS) hardware;
63 * - %CA_DSS - Distributed Sample Scrambling (DSS) hardware.
64 */
65 struct ca_descr_info {
66 unsigned int num;
67 unsigned int type;
68 #define CA_ECD 1
69 #define CA_NDS 2
70 #define CA_DSS 4
71 };
72
73 /**
74 * struct ca_caps - CA slot interface capabilities.
75 *
76 * @slot_num: total number of CA card and module slots.
77 * @slot_type: bitmap with all supported types as defined at
78 * &struct ca_slot_info (e. g. %CA_CI, %CA_CI_LINK, etc).
79 * @descr_num: total number of descrambler slots (keys)
80 * @descr_type: bitmap with all supported types as defined at
81 * &struct ca_descr_info (e. g. %CA_ECD, %CA_NDS, etc).
82 */
83 struct ca_caps {
84 unsigned int slot_num;
85 unsigned int slot_type;
86 unsigned int descr_num;
87 unsigned int descr_type;
88 };
89
90 /**
91 * struct ca_msg - a message to/from a CI-CAM
92 *
93 * @index: unused
94 * @type: unused
95 * @length: length of the message
96 * @msg: message
97 *
98 * This struct carries a message to be send/received from a CI CA module.
99 */
100 struct ca_msg {
101 unsigned int index;
102 unsigned int type;
103 unsigned int length;
104 unsigned char msg[256];
105 };
106
107 /**
108 * struct ca_descr - CA descrambler control words info
109 *
110 * @index: CA Descrambler slot
111 * @parity: control words parity, where 0 means even and 1 means odd
112 * @cw: CA Descrambler control words
113 */
114 struct ca_descr {
115 unsigned int index;
116 unsigned int parity;
117 unsigned char cw[8];
118 };
119
120 #define CA_RESET _IO('o', 128)
121 #define CA_GET_CAP _IOR('o', 129, struct ca_caps)
122 #define CA_GET_SLOT_INFO _IOR('o', 130, struct ca_slot_info)
123 #define CA_GET_DESCR_INFO _IOR('o', 131, struct ca_descr_info)
124 #define CA_GET_MSG _IOR('o', 132, struct ca_msg)
125 #define CA_SEND_MSG _IOW('o', 133, struct ca_msg)
126 #define CA_SET_DESCR _IOW('o', 134, struct ca_descr)
127
128 #if !defined(__KERNEL__)
129
130 /* This is needed for legacy userspace support */
131 typedef struct ca_slot_info ca_slot_info_t;
132 typedef struct ca_descr_info ca_descr_info_t;
133 typedef struct ca_caps ca_caps_t;
134 typedef struct ca_msg ca_msg_t;
135 typedef struct ca_descr ca_descr_t;
136
137 #endif
138
139
140 #endif
141
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.