1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
|
/*
en50221 encoder An implementation for libdvb
an implementation for the en50221 transport layer
Copyright (C) 2004, 2005 Manu Abraham <abraham.manu@gmail.com>
Copyright (C) 2005 Julian Scheel (julian at jusst dot de)
Copyright (C) 2006 Andrew de Quincey (adq_dvb@lidskialf.net)
This library is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 2.1 of
the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#ifndef __EN50221_APPLICATION_smartcard_H__
#define __EN50221_APPLICATION_smartcard_H__
#ifdef __cplusplus
extern "C" {
#endif
#include <stdlib.h>
#include <stdint.h>
#include <libdvben50221/en50221_app_utils.h>
#define SMARTCARD_COMMAND_ID_CONNECT 0x01
#define SMARTCARD_COMMAND_ID_DISCONNECT 0x02
#define SMARTCARD_COMMAND_ID_POWERON_CARD 0x03
#define SMARTCARD_COMMAND_ID_POWEROFF_CARD 0x04
#define SMARTCARD_COMMAND_ID_RESET_CARD 0x05
#define SMARTCARD_COMMAND_ID_RESET_STATUS 0x06
#define SMARTCARD_COMMAND_ID_READ_ANSW_TO_RESET 0x07
#define SMARTCARD_REPLY_ID_CONNECTED 0x01
#define SMARTCARD_REPLY_ID_FREE 0x02
#define SMARTCARD_REPLY_ID_BUSY 0x03
#define SMARTCARD_REPLY_ID_ANSW_TO_RESET 0x04
#define SMARTCARD_REPLY_ID_NO_ANSW_TO_RESET 0x05
#define SMARTCARD_STATUS_CARD_INSERTED 0x01
#define SMARTCARD_STATUS_CARD_REMOVED 0x02
#define SMARTCARD_STATUS_CARD_IN_PLACE_POWEROFF 0x03
#define SMARTCARD_STATUS_CARD_IN_PLACE_POWERON 0x04
#define SMARTCARD_STATUS_CARD_NO_CARD 0x05
#define SMARTCARD_STATUS_CARD_UNRESPONSIVE_CARD 0x06
#define SMARTCARD_STATUS_CARD_REFUSED_CARD 0x07
#define EN50221_APP_SMARTCARD_RESOURCEID(DEVICE_NUMBER) MKRID(112, ((DEVICE_NUMBER)& 0x0f), 1)
/**
* Type definition for command - called when we receive a command.
*
* @param arg Private argument.
* @param slot_id Slot id concerned.
* @param session_number Session number concerned.
* @param command_id One of the SMARTCARD_COMMAND_ID_* values
* @return 0 on success, -1 on failure.
*/
typedef int (*en50221_app_smartcard_command_callback) (void *arg,
uint8_t slot_id,
uint16_t session_number,
uint8_t command_id);
/**
* Type definition for command - called when we receive a send command.
*
* @param arg Private argument.
* @param slot_id Slot id concerned.
* @param session_number Session number concerned.
* @param CLA CLA value.
* @param INS INS value.
* @param P1 P1 value.
* @param P2 P2 value.
* @param in Data to send to the card
* @param in_length Number of bytes to send.
* @param out_length Number of bytes expected.
* @return 0 on success, -1 on failure.
*/
typedef int (*en50221_app_smartcard_send_callback) (void *arg,
uint8_t slot_id,
uint16_t session_number,
uint8_t CLA,
uint8_t INS,
uint8_t P1,
uint8_t P2,
uint8_t *in,
uint32_t in_length,
uint32_t out_length);
/**
* Opaque type representing a smartcard resource.
*/
struct en50221_app_smartcard;
/**
* Create an instance of the smartcard resource.
*
* @param funcs Send functions to use.
* @return Instance, or NULL on failure.
*/
extern struct en50221_app_smartcard *
en50221_app_smartcard_create(struct en50221_app_send_functions *funcs);
/**
* Destroy an instance of the smartcard resource.
*
* @param smartcard Instance to destroy.
*/
extern void en50221_app_smartcard_destroy(struct en50221_app_smartcard *smartcard);
/**
* Register the callback for when we receive a comms command.
*
* @param smartcard smartcard resource instance.
* @param callback The callback. Set to NULL to remove the callback completely.
* @param arg Private data passed as arg0 of the callback.
*/
extern void en50221_app_smartcard_register_command_callback(struct en50221_app_smartcard *smartcard,
en50221_app_smartcard_command_callback callback,
void *arg);
/**
* Register the callback for when we receive data to send.
*
* @param smartcard smartcard resource instance.
* @param callback The callback. Set to NULL to remove the callback completely.
* @param arg Private data passed as arg0 of the callback.
*/
extern void en50221_app_smartcard_register_send_callback(struct en50221_app_smartcard *smartcard,
en50221_app_smartcard_send_callback callback,
void *arg);
/**
* Send a command response to the CAM.
*
* @param smartcard smartcard resource instance.
* @param session_number Session number to send it on.
* @param reply_id One of the SMARTCARD_REPLY_ID_* values.
* @param status One of the SMARTCARD_STATUS_* values.
* @param data Data to send when it is a SMARTCARD_REPLY_ID_ANSW_TO_RESET.
* @param data_length Length of data to send.
* @return 0 on success, -1 on failure.
*/
extern int en50221_app_smartcard_command_reply(struct en50221_app_smartcard *smartcard,
uint16_t session_number,
uint8_t reply_id,
uint8_t status,
uint8_t * data,
uint32_t data_length);
/**
* Send data received from a smartcart to the CAM.
*
* @param smartcard smartcard resource instance.
* @param session_number Session number to send it on.
* @param data Data to send when it is a SMARTCARD_REPLY_ID_ANSW_TO_RESET.
* @param data_length Length of data to send.
* @param SW1 SW1 value.
* @param SW2 SW2 value.
* @return 0 on success, -1 on failure.
*/
extern int en50221_app_smartcard_receive(struct en50221_app_smartcard *smartcard,
uint16_t session_number,
uint8_t * data,
uint32_t data_length,
uint8_t SW1, uint8_t SW2);
/**
* Pass data received for this resource into it for parsing.
*
* @param smartcard smartcard instance.
* @param slot_id Slot ID concerned.
* @param session_number Session number concerned.
* @param resource_id Resource ID concerned.
* @param data The data.
* @param data_length Length of data in bytes.
* @return 0 on success, -1 on failure.
*/
extern int en50221_app_smartcard_message(struct en50221_app_smartcard *smartcard,
uint8_t slot_id,
uint16_t session_number,
uint32_t resource_id,
uint8_t * data,
uint32_t data_length);
#ifdef __cplusplus
}
#endif
#endif
|