| 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 | |
|---|
