1 /* 1 /*
2 * dvb_ca.h: generic DVB functions for EN50221 2 * dvb_ca.h: generic DVB functions for EN50221 CA interfaces
3 * 3 *
4 * Copyright (C) 2004 Andrew de Quincey 4 * Copyright (C) 2004 Andrew de Quincey
5 * 5 *
6 * This program is free software; you can redi 6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser 7 * modify it under the terms of the GNU Lesser General Public License
8 * as published by the Free Software Foundatio 8 * as published by the Free Software Foundation; either version 2.1
9 * of the License, or (at your option) any lat 9 * of the License, or (at your option) any later version.
10 * 10 *
11 * This program is distributed in the hope tha 11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details 14 * GNU General Public License for more details.
15 */ 15 */
16 16
17 #ifndef _DVB_CA_EN50221_H_ 17 #ifndef _DVB_CA_EN50221_H_
18 #define _DVB_CA_EN50221_H_ 18 #define _DVB_CA_EN50221_H_
19 19
20 #include <linux/list.h> 20 #include <linux/list.h>
21 #include <linux/dvb/ca.h> 21 #include <linux/dvb/ca.h>
22 22
23 #include <media/dvbdev.h> 23 #include <media/dvbdev.h>
24 24
25 #define DVB_CA_EN50221_POLL_CAM_PRESENT 1 25 #define DVB_CA_EN50221_POLL_CAM_PRESENT 1
26 #define DVB_CA_EN50221_POLL_CAM_CHANGED 2 26 #define DVB_CA_EN50221_POLL_CAM_CHANGED 2
27 #define DVB_CA_EN50221_POLL_CAM_READY 27 #define DVB_CA_EN50221_POLL_CAM_READY 4
28 28
29 #define DVB_CA_EN50221_FLAG_IRQ_CAMCHANGE 29 #define DVB_CA_EN50221_FLAG_IRQ_CAMCHANGE 1
30 #define DVB_CA_EN50221_FLAG_IRQ_FR 30 #define DVB_CA_EN50221_FLAG_IRQ_FR 2
31 #define DVB_CA_EN50221_FLAG_IRQ_DA 31 #define DVB_CA_EN50221_FLAG_IRQ_DA 4
32 32
33 #define DVB_CA_EN50221_CAMCHANGE_REMOVED 33 #define DVB_CA_EN50221_CAMCHANGE_REMOVED 0
34 #define DVB_CA_EN50221_CAMCHANGE_INSERTED 34 #define DVB_CA_EN50221_CAMCHANGE_INSERTED 1
35 35
36 /** 36 /**
37 * struct dvb_ca_en50221- Structure describing 37 * struct dvb_ca_en50221- Structure describing a CA interface
38 * 38 *
39 * @owner: the module owning this 39 * @owner: the module owning this structure
40 * @read_attribute_mem: function for reading a 40 * @read_attribute_mem: function for reading attribute memory on the CAM
41 * @write_attribute_mem: function for writing 41 * @write_attribute_mem: function for writing attribute memory on the CAM
42 * @read_cam_control: function for reading t 42 * @read_cam_control: function for reading the control interface on the CAM
43 * @write_cam_control: function for reading t 43 * @write_cam_control: function for reading the control interface on the CAM
44 * @read_data: function for reading d 44 * @read_data: function for reading data (block mode)
45 * @write_data: function for writing d 45 * @write_data: function for writing data (block mode)
46 * @slot_reset: function to reset the 46 * @slot_reset: function to reset the CAM slot
47 * @slot_shutdown: function to shutdown a 47 * @slot_shutdown: function to shutdown a CAM slot
48 * @slot_ts_enable: function to enable the 48 * @slot_ts_enable: function to enable the Transport Stream on a CAM slot
49 * @poll_slot_status: function to poll slot 49 * @poll_slot_status: function to poll slot status. Only necessary if
50 * DVB_CA_FLAG_EN50221_IR 50 * DVB_CA_FLAG_EN50221_IRQ_CAMCHANGE is not set.
51 * @data: private data, used by 51 * @data: private data, used by caller.
52 * @private: Opaque data used by th 52 * @private: Opaque data used by the dvb_ca core. Do not modify!
53 * 53 *
54 * NOTE: the read_*, write_* and poll_slot_sta 54 * NOTE: the read_*, write_* and poll_slot_status functions will be
55 * called for different slots concurrently and 55 * called for different slots concurrently and need to use locks where
56 * and if appropriate. There will be no concur 56 * and if appropriate. There will be no concurrent access to one slot.
57 */ 57 */
58 struct dvb_ca_en50221 { 58 struct dvb_ca_en50221 {
59 struct module *owner; 59 struct module *owner;
60 60
61 int (*read_attribute_mem)(struct dvb_c 61 int (*read_attribute_mem)(struct dvb_ca_en50221 *ca,
62 int slot, in 62 int slot, int address);
63 int (*write_attribute_mem)(struct dvb_ 63 int (*write_attribute_mem)(struct dvb_ca_en50221 *ca,
64 int slot, i 64 int slot, int address, u8 value);
65 65
66 int (*read_cam_control)(struct dvb_ca_ 66 int (*read_cam_control)(struct dvb_ca_en50221 *ca,
67 int slot, u8 a 67 int slot, u8 address);
68 int (*write_cam_control)(struct dvb_ca 68 int (*write_cam_control)(struct dvb_ca_en50221 *ca,
69 int slot, u8 69 int slot, u8 address, u8 value);
70 70
71 int (*read_data)(struct dvb_ca_en50221 71 int (*read_data)(struct dvb_ca_en50221 *ca,
72 int slot, u8 *ebuf, i 72 int slot, u8 *ebuf, int ecount);
73 int (*write_data)(struct dvb_ca_en5022 73 int (*write_data)(struct dvb_ca_en50221 *ca,
74 int slot, u8 *ebuf, 74 int slot, u8 *ebuf, int ecount);
75 75
76 int (*slot_reset)(struct dvb_ca_en5022 76 int (*slot_reset)(struct dvb_ca_en50221 *ca, int slot);
77 int (*slot_shutdown)(struct dvb_ca_en5 77 int (*slot_shutdown)(struct dvb_ca_en50221 *ca, int slot);
78 int (*slot_ts_enable)(struct dvb_ca_en 78 int (*slot_ts_enable)(struct dvb_ca_en50221 *ca, int slot);
79 79
80 int (*poll_slot_status)(struct dvb_ca_ 80 int (*poll_slot_status)(struct dvb_ca_en50221 *ca, int slot, int open);
81 81
82 void *data; 82 void *data;
83 83
84 void *private; 84 void *private;
85 }; 85 };
86 86
87 /* 87 /*
88 * Functions for reporting IRQ events 88 * Functions for reporting IRQ events
89 */ 89 */
90 90
91 /** 91 /**
92 * dvb_ca_en50221_camchange_irq - A CAMCHANGE 92 * dvb_ca_en50221_camchange_irq - A CAMCHANGE IRQ has occurred.
93 * 93 *
94 * @pubca: CA instance. 94 * @pubca: CA instance.
95 * @slot: Slot concerned. 95 * @slot: Slot concerned.
96 * @change_type: One of the DVB_CA_CAMCHANGE_* 96 * @change_type: One of the DVB_CA_CAMCHANGE_* values
97 */ 97 */
98 void dvb_ca_en50221_camchange_irq(struct dvb_c 98 void dvb_ca_en50221_camchange_irq(struct dvb_ca_en50221 *pubca, int slot,
99 int change_t 99 int change_type);
100 100
101 /** 101 /**
102 * dvb_ca_en50221_camready_irq - A CAMREADY IR 102 * dvb_ca_en50221_camready_irq - A CAMREADY IRQ has occurred.
103 * 103 *
104 * @pubca: CA instance. 104 * @pubca: CA instance.
105 * @slot: Slot concerned. 105 * @slot: Slot concerned.
106 */ 106 */
107 void dvb_ca_en50221_camready_irq(struct dvb_ca 107 void dvb_ca_en50221_camready_irq(struct dvb_ca_en50221 *pubca, int slot);
108 108
109 /** 109 /**
110 * dvb_ca_en50221_frda_irq - An FR or a DA IRQ 110 * dvb_ca_en50221_frda_irq - An FR or a DA IRQ has occurred.
111 * 111 *
112 * @ca: CA instance. 112 * @ca: CA instance.
113 * @slot: Slot concerned. 113 * @slot: Slot concerned.
114 */ 114 */
115 void dvb_ca_en50221_frda_irq(struct dvb_ca_en5 115 void dvb_ca_en50221_frda_irq(struct dvb_ca_en50221 *ca, int slot);
116 116
117 /* 117 /*
118 * Initialisation/shutdown functions 118 * Initialisation/shutdown functions
119 */ 119 */
120 120
121 /** 121 /**
122 * dvb_ca_en50221_init - Initialise a new DVB 122 * dvb_ca_en50221_init - Initialise a new DVB CA device.
123 * 123 *
124 * @dvb_adapter: DVB adapter to attach the new 124 * @dvb_adapter: DVB adapter to attach the new CA device to.
125 * @ca: The dvb_ca instance. 125 * @ca: The dvb_ca instance.
126 * @flags: Flags describing the CA device (DVB 126 * @flags: Flags describing the CA device (DVB_CA_EN50221_FLAG_*).
127 * @slot_count: Number of slots supported. 127 * @slot_count: Number of slots supported.
128 * 128 *
129 * @return 0 on success, nonzero on failure 129 * @return 0 on success, nonzero on failure
130 */ 130 */
131 int dvb_ca_en50221_init(struct dvb_adapter *dv 131 int dvb_ca_en50221_init(struct dvb_adapter *dvb_adapter,
132 struct dvb_ca_en50221 132 struct dvb_ca_en50221 *ca, int flags,
133 int slot_count) 133 int slot_count);
134 134
135 /** 135 /**
136 * dvb_ca_en50221_release - Release a DVB CA d 136 * dvb_ca_en50221_release - Release a DVB CA device.
137 * 137 *
138 * @ca: The associated dvb_ca instance. 138 * @ca: The associated dvb_ca instance.
139 */ 139 */
140 void dvb_ca_en50221_release(struct dvb_ca_en50 140 void dvb_ca_en50221_release(struct dvb_ca_en50221 *ca);
141 141
142 #endif 142 #endif
143 143
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.