escc: avoid structure holes spotted by pahole
[qemu/mdroth.git] / hw / usb-ccid.c
blob66aeb211af4ba52f8dea593a15149455825862d4
1 /*
2 * Copyright (C) 2011 Red Hat, Inc.
4 * CCID Device emulation
6 * Written by Alon Levy, with contributions from Robert Relyea.
8 * Based on usb-serial.c, see it's copyright and attributions below.
10 * This work is licensed under the terms of the GNU GPL, version 2.1 or later.
11 * See the COPYING file in the top-level directory.
12 * ------- (original copyright & attribution for usb-serial.c below) --------
13 * Copyright (c) 2006 CodeSourcery.
14 * Copyright (c) 2008 Samuel Thibault <samuel.thibault@ens-lyon.org>
15 * Written by Paul Brook, reused for FTDI by Samuel Thibault,
19 * References:
21 * CCID Specification Revision 1.1 April 22nd 2005
22 * "Universal Serial Bus, Device Class: Smart Card"
23 * Specification for Integrated Circuit(s) Cards Interface Devices
25 * Endianness note: from the spec (1.3)
26 * "Fields that are larger than a byte are stored in little endian"
28 * KNOWN BUGS
29 * 1. remove/insert can sometimes result in removed state instead of inserted.
30 * This is a result of the following:
31 * symptom: dmesg shows ERMOTEIO (-121), pcscd shows -99. This can happen
32 * when a short packet is sent, as seen in uhci-usb.c, resulting from a urb
33 * from the guest requesting SPD and us returning a smaller packet.
34 * Not sure which messages trigger this.
37 #include "qemu-common.h"
38 #include "qemu-error.h"
39 #include "usb.h"
40 #include "monitor.h"
42 #include "hw/ccid.h"
44 #define DPRINTF(s, lvl, fmt, ...) \
45 do { \
46 if (lvl <= s->debug) { \
47 printf("usb-ccid: " fmt , ## __VA_ARGS__); \
48 } \
49 } while (0)
51 #define D_WARN 1
52 #define D_INFO 2
53 #define D_MORE_INFO 3
54 #define D_VERBOSE 4
56 #define CCID_DEV_NAME "usb-ccid"
59 * The two options for variable sized buffers:
60 * make them constant size, for large enough constant,
61 * or handle the migration complexity - VMState doesn't handle this case.
62 * sizes are expected never to be exceeded, unless guest misbehaves.
64 #define BULK_OUT_DATA_SIZE 65536
65 #define PENDING_ANSWERS_NUM 128
67 #define BULK_IN_BUF_SIZE 384
68 #define BULK_IN_PENDING_NUM 8
70 #define InterfaceOutClass \
71 ((USB_DIR_OUT | USB_TYPE_CLASS | USB_RECIP_INTERFACE)<<8)
73 #define InterfaceInClass \
74 ((USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_INTERFACE)<<8)
76 #define CCID_MAX_PACKET_SIZE 64
78 #define CCID_CONTROL_ABORT 0x1
79 #define CCID_CONTROL_GET_CLOCK_FREQUENCIES 0x2
80 #define CCID_CONTROL_GET_DATA_RATES 0x3
82 #define CCID_PRODUCT_DESCRIPTION "QEMU USB CCID"
83 #define CCID_VENDOR_DESCRIPTION "QEMU " QEMU_VERSION
84 #define CCID_INTERFACE_NAME "CCID Interface"
85 #define CCID_SERIAL_NUMBER_STRING "1"
87 * Using Gemplus Vendor and Product id
88 * Effect on various drivers:
89 * usbccid.sys (winxp, others untested) is a class driver so it doesn't care.
90 * linux has a number of class drivers, but openct filters based on
91 * vendor/product (/etc/openct.conf under fedora), hence Gemplus.
93 #define CCID_VENDOR_ID 0x08e6
94 #define CCID_PRODUCT_ID 0x4433
95 #define CCID_DEVICE_VERSION 0x0000
98 * BULK_OUT messages from PC to Reader
99 * Defined in CCID Rev 1.1 6.1 (page 26)
101 #define CCID_MESSAGE_TYPE_PC_to_RDR_IccPowerOn 0x62
102 #define CCID_MESSAGE_TYPE_PC_to_RDR_IccPowerOff 0x63
103 #define CCID_MESSAGE_TYPE_PC_to_RDR_GetSlotStatus 0x65
104 #define CCID_MESSAGE_TYPE_PC_to_RDR_XfrBlock 0x6f
105 #define CCID_MESSAGE_TYPE_PC_to_RDR_GetParameters 0x6c
106 #define CCID_MESSAGE_TYPE_PC_to_RDR_ResetParameters 0x6d
107 #define CCID_MESSAGE_TYPE_PC_to_RDR_SetParameters 0x61
108 #define CCID_MESSAGE_TYPE_PC_to_RDR_Escape 0x6b
109 #define CCID_MESSAGE_TYPE_PC_to_RDR_IccClock 0x6e
110 #define CCID_MESSAGE_TYPE_PC_to_RDR_T0APDU 0x6a
111 #define CCID_MESSAGE_TYPE_PC_to_RDR_Secure 0x69
112 #define CCID_MESSAGE_TYPE_PC_to_RDR_Mechanical 0x71
113 #define CCID_MESSAGE_TYPE_PC_to_RDR_Abort 0x72
114 #define CCID_MESSAGE_TYPE_PC_to_RDR_SetDataRateAndClockFrequency 0x73
117 * BULK_IN messages from Reader to PC
118 * Defined in CCID Rev 1.1 6.2 (page 48)
120 #define CCID_MESSAGE_TYPE_RDR_to_PC_DataBlock 0x80
121 #define CCID_MESSAGE_TYPE_RDR_to_PC_SlotStatus 0x81
122 #define CCID_MESSAGE_TYPE_RDR_to_PC_Parameters 0x82
123 #define CCID_MESSAGE_TYPE_RDR_to_PC_Escape 0x83
124 #define CCID_MESSAGE_TYPE_RDR_to_PC_DataRateAndClockFrequency 0x84
127 * INTERRUPT_IN messages from Reader to PC
128 * Defined in CCID Rev 1.1 6.3 (page 56)
130 #define CCID_MESSAGE_TYPE_RDR_to_PC_NotifySlotChange 0x50
131 #define CCID_MESSAGE_TYPE_RDR_to_PC_HardwareError 0x51
134 * Endpoints for CCID - addresses are up to us to decide.
135 * To support slot insertion and removal we must have an interrupt in ep
136 * in addition we need a bulk in and bulk out ep
137 * 5.2, page 20
139 #define CCID_INT_IN_EP 1
140 #define CCID_BULK_IN_EP 2
141 #define CCID_BULK_OUT_EP 3
143 /* bmSlotICCState masks */
144 #define SLOT_0_STATE_MASK 1
145 #define SLOT_0_CHANGED_MASK 2
147 /* Status codes that go in bStatus (see 6.2.6) */
148 enum {
149 ICC_STATUS_PRESENT_ACTIVE = 0,
150 ICC_STATUS_PRESENT_INACTIVE,
151 ICC_STATUS_NOT_PRESENT
154 enum {
155 COMMAND_STATUS_NO_ERROR = 0,
156 COMMAND_STATUS_FAILED,
157 COMMAND_STATUS_TIME_EXTENSION_REQUIRED
160 /* Error codes that go in bError (see 6.2.6) */
161 enum {
162 ERROR_CMD_NOT_SUPPORTED = 0,
163 ERROR_CMD_ABORTED = -1,
164 ERROR_ICC_MUTE = -2,
165 ERROR_XFR_PARITY_ERROR = -3,
166 ERROR_XFR_OVERRUN = -4,
167 ERROR_HW_ERROR = -5,
170 /* 6.2.6 RDR_to_PC_SlotStatus definitions */
171 enum {
172 CLOCK_STATUS_RUNNING = 0,
174 * 0 - Clock Running, 1 - Clock stopped in State L, 2 - H,
175 * 3 - unknown state. rest are RFU
179 typedef struct __attribute__ ((__packed__)) CCID_Header {
180 uint8_t bMessageType;
181 uint32_t dwLength;
182 uint8_t bSlot;
183 uint8_t bSeq;
184 } CCID_Header;
186 typedef struct __attribute__ ((__packed__)) CCID_BULK_IN {
187 CCID_Header hdr;
188 uint8_t bStatus; /* Only used in BULK_IN */
189 uint8_t bError; /* Only used in BULK_IN */
190 } CCID_BULK_IN;
192 typedef struct __attribute__ ((__packed__)) CCID_SlotStatus {
193 CCID_BULK_IN b;
194 uint8_t bClockStatus;
195 } CCID_SlotStatus;
197 typedef struct __attribute__ ((__packed__)) CCID_Parameter {
198 CCID_BULK_IN b;
199 uint8_t bProtocolNum;
200 uint8_t abProtocolDataStructure[0];
201 } CCID_Parameter;
203 typedef struct __attribute__ ((__packed__)) CCID_DataBlock {
204 CCID_BULK_IN b;
205 uint8_t bChainParameter;
206 uint8_t abData[0];
207 } CCID_DataBlock;
209 /* 6.1.4 PC_to_RDR_XfrBlock */
210 typedef struct __attribute__ ((__packed__)) CCID_XferBlock {
211 CCID_Header hdr;
212 uint8_t bBWI; /* Block Waiting Timeout */
213 uint16_t wLevelParameter; /* XXX currently unused */
214 uint8_t abData[0];
215 } CCID_XferBlock;
217 typedef struct __attribute__ ((__packed__)) CCID_IccPowerOn {
218 CCID_Header hdr;
219 uint8_t bPowerSelect;
220 uint16_t abRFU;
221 } CCID_IccPowerOn;
223 typedef struct __attribute__ ((__packed__)) CCID_IccPowerOff {
224 CCID_Header hdr;
225 uint16_t abRFU;
226 } CCID_IccPowerOff;
228 typedef struct __attribute__ ((__packed__)) CCID_SetParameters {
229 CCID_Header hdr;
230 uint8_t bProtocolNum;
231 uint16_t abRFU;
232 uint8_t abProtocolDataStructure[0];
233 } CCID_SetParameters;
235 typedef struct CCID_Notify_Slot_Change {
236 uint8_t bMessageType; /* CCID_MESSAGE_TYPE_RDR_to_PC_NotifySlotChange */
237 uint8_t bmSlotICCState;
238 } CCID_Notify_Slot_Change;
240 /* used for DataBlock response to XferBlock */
241 typedef struct Answer {
242 uint8_t slot;
243 uint8_t seq;
244 } Answer;
246 /* pending BULK_IN messages */
247 typedef struct BulkIn {
248 uint8_t data[BULK_IN_BUF_SIZE];
249 uint32_t len;
250 uint32_t pos;
251 } BulkIn;
253 enum {
254 MIGRATION_NONE,
255 MIGRATION_MIGRATED,
258 typedef struct CCIDBus {
259 BusState qbus;
260 } CCIDBus;
262 #define MAX_PROTOCOL_SIZE 7
265 * powered - defaults to true, changed by PowerOn/PowerOff messages
267 typedef struct USBCCIDState {
268 USBDevice dev;
269 CCIDBus bus;
270 CCIDCardState *card;
271 CCIDCardInfo *cardinfo; /* caching the info pointer */
272 BulkIn bulk_in_pending[BULK_IN_PENDING_NUM]; /* circular */
273 uint32_t bulk_in_pending_start;
274 uint32_t bulk_in_pending_end; /* first free */
275 uint32_t bulk_in_pending_num;
276 BulkIn *current_bulk_in;
277 uint8_t bulk_out_data[BULK_OUT_DATA_SIZE];
278 uint32_t bulk_out_pos;
279 uint64_t last_answer_error;
280 Answer pending_answers[PENDING_ANSWERS_NUM];
281 uint32_t pending_answers_start;
282 uint32_t pending_answers_end;
283 uint32_t pending_answers_num;
284 uint8_t bError;
285 uint8_t bmCommandStatus;
286 uint8_t bProtocolNum;
287 uint8_t abProtocolDataStructure[MAX_PROTOCOL_SIZE];
288 uint32_t ulProtocolDataStructureSize;
289 uint32_t state_vmstate;
290 uint32_t migration_target_ip;
291 uint16_t migration_target_port;
292 uint8_t migration_state;
293 uint8_t bmSlotICCState;
294 uint8_t powered;
295 uint8_t notify_slot_change;
296 uint8_t debug;
297 } USBCCIDState;
300 * CCID Spec chapter 4: CCID uses a standard device descriptor per Chapter 9,
301 * "USB Device Framework", section 9.6.1, in the Universal Serial Bus
302 * Specification.
304 * This device implemented based on the spec and with an Athena Smart Card
305 * Reader as reference:
306 * 0dc3:1004 Athena Smartcard Solutions, Inc.
309 static const uint8_t qemu_ccid_dev_descriptor[] = {
310 0x12, /* u8 bLength; */
311 USB_DT_DEVICE, /* u8 bDescriptorType; Device */
312 0x10, 0x01, /* u16 bcdUSB; v1.1 */
314 0x00, /* u8 bDeviceClass; */
315 0x00, /* u8 bDeviceSubClass; */
316 0x00, /* u8 bDeviceProtocol; [ low/full speeds only ] */
317 0x40, /* u8 bMaxPacketSize0; 8 Bytes (valid: 8,16,32,64) */
319 /* Vendor and product id are arbitrary. */
320 /* u16 idVendor */
321 CCID_VENDOR_ID & 0xff, CCID_VENDOR_ID >> 8,
322 /* u16 idProduct */
323 CCID_PRODUCT_ID & 0xff, CCID_PRODUCT_ID >> 8,
324 /* u16 bcdDevice */
325 CCID_DEVICE_VERSION & 0xff, CCID_DEVICE_VERSION >> 8,
326 0x01, /* u8 iManufacturer; */
327 0x02, /* u8 iProduct; */
328 0x03, /* u8 iSerialNumber; */
329 0x01, /* u8 bNumConfigurations; */
332 static const uint8_t qemu_ccid_config_descriptor[] = {
334 /* one configuration */
335 0x09, /* u8 bLength; */
336 USB_DT_CONFIG, /* u8 bDescriptorType; Configuration */
337 0x5d, 0x00, /* u16 wTotalLength; 9+9+54+7+7+7 */
338 0x01, /* u8 bNumInterfaces; (1) */
339 0x01, /* u8 bConfigurationValue; */
340 0x00, /* u8 iConfiguration; */
341 0xe0, /* u8 bmAttributes;
342 Bit 7: must be set,
343 6: Self-powered,
344 5: Remote wakeup,
345 4..0: resvd */
346 100/2, /* u8 MaxPower; 50 == 100mA */
348 /* one interface */
349 0x09, /* u8 if_bLength; */
350 USB_DT_INTERFACE, /* u8 if_bDescriptorType; Interface */
351 0x00, /* u8 if_bInterfaceNumber; */
352 0x00, /* u8 if_bAlternateSetting; */
353 0x03, /* u8 if_bNumEndpoints; */
354 0x0b, /* u8 if_bInterfaceClass; Smart Card Device Class */
355 0x00, /* u8 if_bInterfaceSubClass; Subclass code */
356 0x00, /* u8 if_bInterfaceProtocol; Protocol code */
357 0x04, /* u8 if_iInterface; Index of string descriptor */
359 /* Smart Card Device Class Descriptor */
360 0x36, /* u8 bLength; */
361 0x21, /* u8 bDescriptorType; Functional */
362 0x10, 0x01, /* u16 bcdCCID; CCID Specification Release Number. */
363 0x00, /*
364 * u8 bMaxSlotIndex; The index of the highest available
365 * slot on this device. All slots are consecutive starting
366 * at 00h.
368 0x07, /* u8 bVoltageSupport; 01h - 5.0v, 02h - 3.0, 03 - 1.8 */
370 0x03, 0x00, /* u32 dwProtocols; RRRR PPPP. RRRR = 0000h.*/
371 0x00, 0x00, /* PPPP: 0001h = Protocol T=0, 0002h = Protocol T=1 */
372 /* u32 dwDefaultClock; in kHZ (0x0fa0 is 4 MHz) */
373 0xa0, 0x0f, 0x00, 0x00,
374 /* u32 dwMaximumClock; */
375 0x00, 0x00, 0x01, 0x00,
376 0x00, /* u8 bNumClockSupported; *
377 * 0 means just the default and max. */
378 /* u32 dwDataRate ;bps. 9600 == 00002580h */
379 0x80, 0x25, 0x00, 0x00,
380 /* u32 dwMaxDataRate ; 11520 bps == 0001C200h */
381 0x00, 0xC2, 0x01, 0x00,
382 0x00, /* u8 bNumDataRatesSupported; 00 means all rates between
383 * default and max */
384 /* u32 dwMaxIFSD; *
385 * maximum IFSD supported by CCID for protocol *
386 * T=1 (Maximum seen from various cards) */
387 0xfe, 0x00, 0x00, 0x00,
388 /* u32 dwSyncProtocols; 1 - 2-wire, 2 - 3-wire, 4 - I2C */
389 0x00, 0x00, 0x00, 0x00,
390 /* u32 dwMechanical; 0 - no special characteristics. */
391 0x00, 0x00, 0x00, 0x00,
393 * u32 dwFeatures;
394 * 0 - No special characteristics
395 * + 2 Automatic parameter configuration based on ATR data
396 * + 4 Automatic activation of ICC on inserting
397 * + 8 Automatic ICC voltage selection
398 * + 10 Automatic ICC clock frequency change
399 * + 20 Automatic baud rate change
400 * + 40 Automatic parameters negotiation made by the CCID
401 * + 80 automatic PPS made by the CCID
402 * 100 CCID can set ICC in clock stop mode
403 * 200 NAD value other then 00 accepted (T=1 protocol)
404 * + 400 Automatic IFSD exchange as first exchange (T=1)
405 * One of the following only:
406 * + 10000 TPDU level exchanges with CCID
407 * 20000 Short APDU level exchange with CCID
408 * 40000 Short and Extended APDU level exchange with CCID
410 * + 100000 USB Wake up signaling supported on card
411 * insertion and removal. Must set bit 5 in bmAttributes
412 * in Configuration descriptor if 100000 is set.
414 0xfe, 0x04, 0x11, 0x00,
416 * u32 dwMaxCCIDMessageLength; For extended APDU in
417 * [261 + 10 , 65544 + 10]. Otherwise the minimum is
418 * wMaxPacketSize of the Bulk-OUT endpoint
420 0x12, 0x00, 0x01, 0x00,
421 0xFF, /*
422 * u8 bClassGetResponse; Significant only for CCID that
423 * offers an APDU level for exchanges. Indicates the
424 * default class value used by the CCID when it sends a
425 * Get Response command to perform the transportation of
426 * an APDU by T=0 protocol
427 * FFh indicates that the CCID echos the class of the APDU.
429 0xFF, /*
430 * u8 bClassEnvelope; EAPDU only. Envelope command for
431 * T=0
433 0x00, 0x00, /*
434 * u16 wLcdLayout; XXYY Number of lines (XX) and chars per
435 * line for LCD display used for PIN entry. 0000 - no LCD
437 0x01, /*
438 * u8 bPINSupport; 01h PIN Verification,
439 * 02h PIN Modification
441 0x01, /* u8 bMaxCCIDBusySlots; */
443 /* Interrupt-IN endpoint */
444 0x07, /* u8 ep_bLength; */
445 /* u8 ep_bDescriptorType; Endpoint */
446 USB_DT_ENDPOINT,
447 /* u8 ep_bEndpointAddress; IN Endpoint 1 */
448 0x80 | CCID_INT_IN_EP,
449 0x03, /* u8 ep_bmAttributes; Interrupt */
450 /* u16 ep_wMaxPacketSize; */
451 CCID_MAX_PACKET_SIZE & 0xff, (CCID_MAX_PACKET_SIZE >> 8),
452 0xff, /* u8 ep_bInterval; */
454 /* Bulk-In endpoint */
455 0x07, /* u8 ep_bLength; */
456 /* u8 ep_bDescriptorType; Endpoint */
457 USB_DT_ENDPOINT,
458 /* u8 ep_bEndpointAddress; IN Endpoint 2 */
459 0x80 | CCID_BULK_IN_EP,
460 0x02, /* u8 ep_bmAttributes; Bulk */
461 0x40, 0x00, /* u16 ep_wMaxPacketSize; */
462 0x00, /* u8 ep_bInterval; */
464 /* Bulk-Out endpoint */
465 0x07, /* u8 ep_bLength; */
466 /* u8 ep_bDescriptorType; Endpoint */
467 USB_DT_ENDPOINT,
468 /* u8 ep_bEndpointAddress; OUT Endpoint 3 */
469 CCID_BULK_OUT_EP,
470 0x02, /* u8 ep_bmAttributes; Bulk */
471 0x40, 0x00, /* u16 ep_wMaxPacketSize; */
472 0x00, /* u8 ep_bInterval; */
476 static bool ccid_has_pending_answers(USBCCIDState *s)
478 return s->pending_answers_num > 0;
481 static void ccid_clear_pending_answers(USBCCIDState *s)
483 s->pending_answers_num = 0;
484 s->pending_answers_start = 0;
485 s->pending_answers_end = 0;
488 static void ccid_print_pending_answers(USBCCIDState *s)
490 Answer *answer;
491 int i, count;
493 DPRINTF(s, D_VERBOSE, "usb-ccid: pending answers:");
494 if (!ccid_has_pending_answers(s)) {
495 DPRINTF(s, D_VERBOSE, " empty\n");
496 return;
498 for (i = s->pending_answers_start, count = s->pending_answers_num ;
499 count > 0; count--, i++) {
500 answer = &s->pending_answers[i % PENDING_ANSWERS_NUM];
501 if (count == 1) {
502 DPRINTF(s, D_VERBOSE, "%d:%d\n", answer->slot, answer->seq);
503 } else {
504 DPRINTF(s, D_VERBOSE, "%d:%d,", answer->slot, answer->seq);
509 static void ccid_add_pending_answer(USBCCIDState *s, CCID_Header *hdr)
511 Answer *answer;
513 assert(s->pending_answers_num < PENDING_ANSWERS_NUM);
514 s->pending_answers_num++;
515 answer =
516 &s->pending_answers[(s->pending_answers_end++) % PENDING_ANSWERS_NUM];
517 answer->slot = hdr->bSlot;
518 answer->seq = hdr->bSeq;
519 ccid_print_pending_answers(s);
522 static void ccid_remove_pending_answer(USBCCIDState *s,
523 uint8_t *slot, uint8_t *seq)
525 Answer *answer;
527 assert(s->pending_answers_num > 0);
528 s->pending_answers_num--;
529 answer =
530 &s->pending_answers[(s->pending_answers_start++) % PENDING_ANSWERS_NUM];
531 *slot = answer->slot;
532 *seq = answer->seq;
533 ccid_print_pending_answers(s);
536 static void ccid_bulk_in_clear(USBCCIDState *s)
538 s->bulk_in_pending_start = 0;
539 s->bulk_in_pending_end = 0;
540 s->bulk_in_pending_num = 0;
543 static void ccid_bulk_in_release(USBCCIDState *s)
545 assert(s->current_bulk_in != NULL);
546 s->current_bulk_in->pos = 0;
547 s->current_bulk_in = NULL;
550 static void ccid_bulk_in_get(USBCCIDState *s)
552 if (s->current_bulk_in != NULL || s->bulk_in_pending_num == 0) {
553 return;
555 assert(s->bulk_in_pending_num > 0);
556 s->bulk_in_pending_num--;
557 s->current_bulk_in =
558 &s->bulk_in_pending[(s->bulk_in_pending_start++) % BULK_IN_PENDING_NUM];
561 static void *ccid_reserve_recv_buf(USBCCIDState *s, uint16_t len)
563 BulkIn *bulk_in;
565 DPRINTF(s, D_VERBOSE, "%s: QUEUE: reserve %d bytes\n", __func__, len);
567 /* look for an existing element */
568 if (len > BULK_IN_BUF_SIZE) {
569 DPRINTF(s, D_WARN, "usb-ccid.c: %s: len larger then max (%d>%d). "
570 "discarding message.\n",
571 __func__, len, BULK_IN_BUF_SIZE);
572 return NULL;
574 if (s->bulk_in_pending_num >= BULK_IN_PENDING_NUM) {
575 DPRINTF(s, D_WARN, "usb-ccid.c: %s: No free bulk_in buffers. "
576 "discarding message.\n", __func__);
577 return NULL;
579 bulk_in =
580 &s->bulk_in_pending[(s->bulk_in_pending_end++) % BULK_IN_PENDING_NUM];
581 s->bulk_in_pending_num++;
582 bulk_in->len = len;
583 return bulk_in->data;
586 static void ccid_reset(USBCCIDState *s)
588 ccid_bulk_in_clear(s);
589 ccid_clear_pending_answers(s);
592 static void ccid_detach(USBCCIDState *s)
594 ccid_reset(s);
597 static void ccid_handle_reset(USBDevice *dev)
599 USBCCIDState *s = DO_UPCAST(USBCCIDState, dev, dev);
601 DPRINTF(s, 1, "Reset\n");
603 ccid_reset(s);
606 static int ccid_handle_control(USBDevice *dev, USBPacket *p, int request,
607 int value, int index, int length, uint8_t *data)
609 USBCCIDState *s = DO_UPCAST(USBCCIDState, dev, dev);
610 int ret = 0;
612 DPRINTF(s, 1, "got control %x, value %x\n", request, value);
613 switch (request) {
614 case DeviceRequest | USB_REQ_GET_STATUS:
615 data[0] = (1 << USB_DEVICE_SELF_POWERED) |
616 (dev->remote_wakeup << USB_DEVICE_REMOTE_WAKEUP);
617 data[1] = 0x00;
618 ret = 2;
619 break;
620 case DeviceOutRequest | USB_REQ_CLEAR_FEATURE:
621 if (value == USB_DEVICE_REMOTE_WAKEUP) {
622 dev->remote_wakeup = 0;
623 } else {
624 goto fail;
626 ret = 0;
627 break;
628 case DeviceOutRequest | USB_REQ_SET_FEATURE:
629 if (value == USB_DEVICE_REMOTE_WAKEUP) {
630 dev->remote_wakeup = 1;
631 } else {
632 goto fail;
634 ret = 0;
635 break;
636 case DeviceOutRequest | USB_REQ_SET_ADDRESS:
637 dev->addr = value;
638 ret = 0;
639 break;
640 case DeviceRequest | USB_REQ_GET_DESCRIPTOR:
641 switch (value >> 8) {
642 case USB_DT_DEVICE:
643 memcpy(data, qemu_ccid_dev_descriptor,
644 sizeof(qemu_ccid_dev_descriptor));
645 ret = sizeof(qemu_ccid_dev_descriptor);
646 break;
647 case USB_DT_CONFIG:
648 memcpy(data, qemu_ccid_config_descriptor,
649 sizeof(qemu_ccid_config_descriptor));
650 ret = sizeof(qemu_ccid_config_descriptor);
651 break;
652 case USB_DT_STRING:
653 switch (value & 0xff) {
654 case 0:
655 /* language ids */
656 data[0] = 4;
657 data[1] = 3;
658 data[2] = 0x09;
659 data[3] = 0x04;
660 ret = 4;
661 break;
662 case 1:
663 /* vendor description */
664 ret = set_usb_string(data, CCID_VENDOR_DESCRIPTION);
665 break;
666 case 2:
667 /* product description */
668 ret = set_usb_string(data, CCID_PRODUCT_DESCRIPTION);
669 break;
670 case 3:
671 /* serial number */
672 ret = set_usb_string(data, CCID_SERIAL_NUMBER_STRING);
673 break;
674 case 4:
675 /* interface name */
676 ret = set_usb_string(data, CCID_INTERFACE_NAME);
677 break;
678 default:
679 goto fail;
681 break;
682 default:
683 goto fail;
685 break;
686 case DeviceRequest | USB_REQ_GET_CONFIGURATION:
687 data[0] = 1;
688 ret = 1;
689 break;
690 case DeviceOutRequest | USB_REQ_SET_CONFIGURATION:
691 /* Only one configuration - we just ignore the request */
692 ret = 0;
693 break;
694 case DeviceRequest | USB_REQ_GET_INTERFACE:
695 data[0] = 0;
696 ret = 1;
697 break;
698 case InterfaceOutRequest | USB_REQ_SET_INTERFACE:
699 ret = 0;
700 break;
701 case EndpointOutRequest | USB_REQ_CLEAR_FEATURE:
702 ret = 0;
703 break;
705 /* Class specific requests. */
706 case InterfaceOutClass | CCID_CONTROL_ABORT:
707 DPRINTF(s, 1, "ccid_control abort UNIMPLEMENTED\n");
708 ret = USB_RET_STALL;
709 break;
710 case InterfaceInClass | CCID_CONTROL_GET_CLOCK_FREQUENCIES:
711 DPRINTF(s, 1, "ccid_control get clock frequencies UNIMPLEMENTED\n");
712 ret = USB_RET_STALL;
713 break;
714 case InterfaceInClass | CCID_CONTROL_GET_DATA_RATES:
715 DPRINTF(s, 1, "ccid_control get data rates UNIMPLEMENTED\n");
716 ret = USB_RET_STALL;
717 break;
718 default:
719 fail:
720 DPRINTF(s, 1, "got unsupported/bogus control %x, value %x\n",
721 request, value);
722 ret = USB_RET_STALL;
723 break;
725 return ret;
728 static bool ccid_card_inserted(USBCCIDState *s)
730 return s->bmSlotICCState & SLOT_0_STATE_MASK;
733 static uint8_t ccid_card_status(USBCCIDState *s)
735 return ccid_card_inserted(s)
736 ? (s->powered ?
737 ICC_STATUS_PRESENT_ACTIVE
738 : ICC_STATUS_PRESENT_INACTIVE
740 : ICC_STATUS_NOT_PRESENT;
743 static uint8_t ccid_calc_status(USBCCIDState *s)
746 * page 55, 6.2.6, calculation of bStatus from bmICCStatus and
747 * bmCommandStatus
749 uint8_t ret = ccid_card_status(s) | (s->bmCommandStatus << 6);
750 DPRINTF(s, D_VERBOSE, "status = %d\n", ret);
751 return ret;
754 static void ccid_reset_error_status(USBCCIDState *s)
756 s->bError = ERROR_CMD_NOT_SUPPORTED;
757 s->bmCommandStatus = COMMAND_STATUS_NO_ERROR;
760 static void ccid_write_slot_status(USBCCIDState *s, CCID_Header *recv)
762 CCID_SlotStatus *h = ccid_reserve_recv_buf(s, sizeof(CCID_SlotStatus));
763 if (h == NULL) {
764 return;
766 h->b.hdr.bMessageType = CCID_MESSAGE_TYPE_RDR_to_PC_SlotStatus;
767 h->b.hdr.dwLength = 0;
768 h->b.hdr.bSlot = recv->bSlot;
769 h->b.hdr.bSeq = recv->bSeq;
770 h->b.bStatus = ccid_calc_status(s);
771 h->b.bError = s->bError;
772 h->bClockStatus = CLOCK_STATUS_RUNNING;
773 ccid_reset_error_status(s);
776 static void ccid_write_parameters(USBCCIDState *s, CCID_Header *recv)
778 CCID_Parameter *h;
779 uint32_t len = s->ulProtocolDataStructureSize;
781 h = ccid_reserve_recv_buf(s, sizeof(CCID_Parameter) + len);
782 if (h == NULL) {
783 return;
785 h->b.hdr.bMessageType = CCID_MESSAGE_TYPE_RDR_to_PC_Parameters;
786 h->b.hdr.dwLength = 0;
787 h->b.hdr.bSlot = recv->bSlot;
788 h->b.hdr.bSeq = recv->bSeq;
789 h->b.bStatus = ccid_calc_status(s);
790 h->b.bError = s->bError;
791 h->bProtocolNum = s->bProtocolNum;
792 memcpy(h->abProtocolDataStructure, s->abProtocolDataStructure, len);
793 ccid_reset_error_status(s);
796 static void ccid_write_data_block(USBCCIDState *s, uint8_t slot, uint8_t seq,
797 const uint8_t *data, uint32_t len)
799 CCID_DataBlock *p = ccid_reserve_recv_buf(s, sizeof(*p) + len);
801 if (p == NULL) {
802 return;
804 p->b.hdr.bMessageType = CCID_MESSAGE_TYPE_RDR_to_PC_DataBlock;
805 p->b.hdr.dwLength = cpu_to_le32(len);
806 p->b.hdr.bSlot = slot;
807 p->b.hdr.bSeq = seq;
808 p->b.bStatus = ccid_calc_status(s);
809 p->b.bError = s->bError;
810 if (p->b.bError) {
811 DPRINTF(s, D_VERBOSE, "error %d", p->b.bError);
813 memcpy(p->abData, data, len);
814 ccid_reset_error_status(s);
817 static void ccid_write_data_block_answer(USBCCIDState *s,
818 const uint8_t *data, uint32_t len)
820 uint8_t seq;
821 uint8_t slot;
823 if (!ccid_has_pending_answers(s)) {
824 abort();
826 ccid_remove_pending_answer(s, &slot, &seq);
827 ccid_write_data_block(s, slot, seq, data, len);
830 static void ccid_write_data_block_atr(USBCCIDState *s, CCID_Header *recv)
832 const uint8_t *atr = NULL;
833 uint32_t len = 0;
835 if (s->card) {
836 atr = s->cardinfo->get_atr(s->card, &len);
838 ccid_write_data_block(s, recv->bSlot, recv->bSeq, atr, len);
841 static void ccid_set_parameters(USBCCIDState *s, CCID_Header *recv)
843 CCID_SetParameters *ph = (CCID_SetParameters *) recv;
844 uint32_t len = 0;
845 if ((ph->bProtocolNum & 3) == 0) {
846 len = 5;
848 if ((ph->bProtocolNum & 3) == 1) {
849 len = 7;
851 if (len == 0) {
852 s->bmCommandStatus = COMMAND_STATUS_FAILED;
853 s->bError = 7; /* Protocol invalid or not supported */
854 return;
856 s->bProtocolNum = ph->bProtocolNum;
857 memcpy(s->abProtocolDataStructure, ph->abProtocolDataStructure, len);
858 s->ulProtocolDataStructureSize = len;
859 DPRINTF(s, 1, "%s: using len %d\n", __func__, len);
863 * must be 5 bytes for T=0, 7 bytes for T=1
864 * See page 52
866 static const uint8_t abDefaultProtocolDataStructure[7] = {
867 0x77, 0x00, 0x00, 0x00, 0x00, 0xfe /*IFSC*/, 0x00 /*NAD*/ };
869 static void ccid_reset_parameters(USBCCIDState *s)
871 uint32_t len = sizeof(abDefaultProtocolDataStructure);
873 s->bProtocolNum = 1; /* T=1 */
874 s->ulProtocolDataStructureSize = len;
875 memcpy(s->abProtocolDataStructure, abDefaultProtocolDataStructure, len);
878 static void ccid_report_error_failed(USBCCIDState *s, uint8_t error)
880 s->bmCommandStatus = COMMAND_STATUS_FAILED;
881 s->bError = error;
884 /* NOTE: only a single slot is supported (SLOT_0) */
885 static void ccid_on_slot_change(USBCCIDState *s, bool full)
887 /* RDR_to_PC_NotifySlotChange, 6.3.1 page 56 */
888 uint8_t current = s->bmSlotICCState;
889 if (full) {
890 s->bmSlotICCState |= SLOT_0_STATE_MASK;
891 } else {
892 s->bmSlotICCState &= ~SLOT_0_STATE_MASK;
894 if (current != s->bmSlotICCState) {
895 s->bmSlotICCState |= SLOT_0_CHANGED_MASK;
897 s->notify_slot_change = true;
900 static void ccid_write_data_block_error(
901 USBCCIDState *s, uint8_t slot, uint8_t seq)
903 ccid_write_data_block(s, slot, seq, NULL, 0);
906 static void ccid_on_apdu_from_guest(USBCCIDState *s, CCID_XferBlock *recv)
908 uint32_t len;
910 if (ccid_card_status(s) != ICC_STATUS_PRESENT_ACTIVE) {
911 DPRINTF(s, 1,
912 "usb-ccid: not sending apdu to client, no card connected\n");
913 ccid_write_data_block_error(s, recv->hdr.bSlot, recv->hdr.bSeq);
914 return;
916 len = le32_to_cpu(recv->hdr.dwLength);
917 DPRINTF(s, 1, "%s: seq %d, len %d\n", __func__,
918 recv->hdr.bSeq, len);
919 ccid_add_pending_answer(s, (CCID_Header *)recv);
920 if (s->card) {
921 s->cardinfo->apdu_from_guest(s->card, recv->abData, len);
922 } else {
923 DPRINTF(s, D_WARN, "warning: discarded apdu\n");
928 * Handle a single USB_TOKEN_OUT, return value returned to guest.
929 * Return value:
930 * 0 - all ok
931 * USB_RET_STALL - failed to handle packet
933 static int ccid_handle_bulk_out(USBCCIDState *s, USBPacket *p)
935 CCID_Header *ccid_header;
937 if (p->iov.size + s->bulk_out_pos > BULK_OUT_DATA_SIZE) {
938 return USB_RET_STALL;
940 ccid_header = (CCID_Header *)s->bulk_out_data;
941 usb_packet_copy(p, s->bulk_out_data + s->bulk_out_pos, p->iov.size);
942 s->bulk_out_pos += p->iov.size;
943 if (p->iov.size == CCID_MAX_PACKET_SIZE) {
944 DPRINTF(s, D_VERBOSE,
945 "usb-ccid: bulk_in: expecting more packets (%zd/%d)\n",
946 p->iov.size, ccid_header->dwLength);
947 return 0;
949 if (s->bulk_out_pos < 10) {
950 DPRINTF(s, 1,
951 "%s: bad USB_TOKEN_OUT length, should be at least 10 bytes\n",
952 __func__);
953 } else {
954 DPRINTF(s, D_MORE_INFO, "%s %x\n", __func__, ccid_header->bMessageType);
955 switch (ccid_header->bMessageType) {
956 case CCID_MESSAGE_TYPE_PC_to_RDR_GetSlotStatus:
957 ccid_write_slot_status(s, ccid_header);
958 break;
959 case CCID_MESSAGE_TYPE_PC_to_RDR_IccPowerOn:
960 DPRINTF(s, 1, "PowerOn: %d\n",
961 ((CCID_IccPowerOn *)(ccid_header))->bPowerSelect);
962 s->powered = true;
963 if (!ccid_card_inserted(s)) {
964 ccid_report_error_failed(s, ERROR_ICC_MUTE);
966 /* atr is written regardless of error. */
967 ccid_write_data_block_atr(s, ccid_header);
968 break;
969 case CCID_MESSAGE_TYPE_PC_to_RDR_IccPowerOff:
970 DPRINTF(s, 1, "PowerOff\n");
971 ccid_reset_error_status(s);
972 s->powered = false;
973 ccid_write_slot_status(s, ccid_header);
974 break;
975 case CCID_MESSAGE_TYPE_PC_to_RDR_XfrBlock:
976 ccid_on_apdu_from_guest(s, (CCID_XferBlock *)s->bulk_out_data);
977 break;
978 case CCID_MESSAGE_TYPE_PC_to_RDR_SetParameters:
979 ccid_reset_error_status(s);
980 ccid_set_parameters(s, ccid_header);
981 ccid_write_parameters(s, ccid_header);
982 break;
983 case CCID_MESSAGE_TYPE_PC_to_RDR_ResetParameters:
984 ccid_reset_error_status(s);
985 ccid_reset_parameters(s);
986 ccid_write_parameters(s, ccid_header);
987 break;
988 case CCID_MESSAGE_TYPE_PC_to_RDR_GetParameters:
989 ccid_reset_error_status(s);
990 ccid_write_parameters(s, ccid_header);
991 break;
992 default:
993 DPRINTF(s, 1,
994 "handle_data: ERROR: unhandled message type %Xh\n",
995 ccid_header->bMessageType);
997 * The caller is expecting the device to respond, tell it we
998 * don't support the operation.
1000 ccid_report_error_failed(s, ERROR_CMD_NOT_SUPPORTED);
1001 ccid_write_slot_status(s, ccid_header);
1002 break;
1005 s->bulk_out_pos = 0;
1006 return 0;
1009 static int ccid_bulk_in_copy_to_guest(USBCCIDState *s, USBPacket *p)
1011 int ret = 0;
1013 assert(p->iov.size > 0);
1014 ccid_bulk_in_get(s);
1015 if (s->current_bulk_in != NULL) {
1016 ret = MIN(s->current_bulk_in->len - s->current_bulk_in->pos,
1017 p->iov.size);
1018 usb_packet_copy(p, s->current_bulk_in->data +
1019 s->current_bulk_in->pos, ret);
1020 s->current_bulk_in->pos += ret;
1021 if (s->current_bulk_in->pos == s->current_bulk_in->len) {
1022 ccid_bulk_in_release(s);
1024 } else {
1025 /* return when device has no data - usb 2.0 spec Table 8-4 */
1026 ret = USB_RET_NAK;
1028 if (ret > 0) {
1029 DPRINTF(s, D_MORE_INFO,
1030 "%s: %zd/%d req/act to guest (BULK_IN)\n",
1031 __func__, p->iov.size, ret);
1033 if (ret != USB_RET_NAK && ret < p->iov.size) {
1034 DPRINTF(s, 1,
1035 "%s: returning short (EREMOTEIO) %d < %zd\n",
1036 __func__, ret, p->iov.size);
1038 return ret;
1041 static int ccid_handle_data(USBDevice *dev, USBPacket *p)
1043 USBCCIDState *s = DO_UPCAST(USBCCIDState, dev, dev);
1044 int ret = 0;
1045 uint8_t buf[2];
1047 switch (p->pid) {
1048 case USB_TOKEN_OUT:
1049 ret = ccid_handle_bulk_out(s, p);
1050 break;
1052 case USB_TOKEN_IN:
1053 switch (p->devep & 0xf) {
1054 case CCID_BULK_IN_EP:
1055 if (!p->iov.size) {
1056 ret = USB_RET_NAK;
1057 } else {
1058 ret = ccid_bulk_in_copy_to_guest(s, p);
1060 break;
1061 case CCID_INT_IN_EP:
1062 if (s->notify_slot_change) {
1063 /* page 56, RDR_to_PC_NotifySlotChange */
1064 buf[0] = CCID_MESSAGE_TYPE_RDR_to_PC_NotifySlotChange;
1065 buf[1] = s->bmSlotICCState;
1066 usb_packet_copy(p, buf, 2);
1067 ret = 2;
1068 s->notify_slot_change = false;
1069 s->bmSlotICCState &= ~SLOT_0_CHANGED_MASK;
1070 DPRINTF(s, D_INFO,
1071 "handle_data: int_in: notify_slot_change %X, "
1072 "requested len %zd\n",
1073 s->bmSlotICCState, p->iov.size);
1075 break;
1076 default:
1077 DPRINTF(s, 1, "Bad endpoint\n");
1078 break;
1080 break;
1081 default:
1082 DPRINTF(s, 1, "Bad token\n");
1083 ret = USB_RET_STALL;
1084 break;
1087 return ret;
1090 static void ccid_handle_destroy(USBDevice *dev)
1092 USBCCIDState *s = DO_UPCAST(USBCCIDState, dev, dev);
1094 ccid_bulk_in_clear(s);
1097 static void ccid_flush_pending_answers(USBCCIDState *s)
1099 while (ccid_has_pending_answers(s)) {
1100 ccid_write_data_block_answer(s, NULL, 0);
1104 static Answer *ccid_peek_next_answer(USBCCIDState *s)
1106 return s->pending_answers_num == 0
1107 ? NULL
1108 : &s->pending_answers[s->pending_answers_start % PENDING_ANSWERS_NUM];
1111 static struct BusInfo ccid_bus_info = {
1112 .name = "ccid-bus",
1113 .size = sizeof(CCIDBus),
1114 .props = (Property[]) {
1115 DEFINE_PROP_UINT32("slot", struct CCIDCardState, slot, 0),
1116 DEFINE_PROP_END_OF_LIST(),
1120 void ccid_card_send_apdu_to_guest(CCIDCardState *card,
1121 uint8_t *apdu, uint32_t len)
1123 USBCCIDState *s = DO_UPCAST(USBCCIDState, dev.qdev,
1124 card->qdev.parent_bus->parent);
1125 Answer *answer;
1127 if (!ccid_has_pending_answers(s)) {
1128 DPRINTF(s, 1, "CCID ERROR: got an APDU without pending answers\n");
1129 return;
1131 s->bmCommandStatus = COMMAND_STATUS_NO_ERROR;
1132 answer = ccid_peek_next_answer(s);
1133 if (answer == NULL) {
1134 abort();
1136 DPRINTF(s, 1, "APDU returned to guest %d (answer seq %d, slot %d)\n",
1137 len, answer->seq, answer->slot);
1138 ccid_write_data_block_answer(s, apdu, len);
1141 void ccid_card_card_removed(CCIDCardState *card)
1143 USBCCIDState *s =
1144 DO_UPCAST(USBCCIDState, dev.qdev, card->qdev.parent_bus->parent);
1146 ccid_on_slot_change(s, false);
1147 ccid_flush_pending_answers(s);
1148 ccid_reset(s);
1151 int ccid_card_ccid_attach(CCIDCardState *card)
1153 USBCCIDState *s =
1154 DO_UPCAST(USBCCIDState, dev.qdev, card->qdev.parent_bus->parent);
1156 DPRINTF(s, 1, "CCID Attach\n");
1157 if (s->migration_state == MIGRATION_MIGRATED) {
1158 s->migration_state = MIGRATION_NONE;
1160 return 0;
1163 void ccid_card_ccid_detach(CCIDCardState *card)
1165 USBCCIDState *s =
1166 DO_UPCAST(USBCCIDState, dev.qdev, card->qdev.parent_bus->parent);
1168 DPRINTF(s, 1, "CCID Detach\n");
1169 if (ccid_card_inserted(s)) {
1170 ccid_on_slot_change(s, false);
1172 ccid_detach(s);
1175 void ccid_card_card_error(CCIDCardState *card, uint64_t error)
1177 USBCCIDState *s =
1178 DO_UPCAST(USBCCIDState, dev.qdev, card->qdev.parent_bus->parent);
1180 s->bmCommandStatus = COMMAND_STATUS_FAILED;
1181 s->last_answer_error = error;
1182 DPRINTF(s, 1, "VSC_Error: %" PRIX64 "\n", s->last_answer_error);
1183 /* TODO: these errors should be more verbose and propagated to the guest.*/
1185 * We flush all pending answers on CardRemove message in ccid-card-passthru,
1186 * so check that first to not trigger abort
1188 if (ccid_has_pending_answers(s)) {
1189 ccid_write_data_block_answer(s, NULL, 0);
1193 void ccid_card_card_inserted(CCIDCardState *card)
1195 USBCCIDState *s =
1196 DO_UPCAST(USBCCIDState, dev.qdev, card->qdev.parent_bus->parent);
1198 s->bmCommandStatus = COMMAND_STATUS_NO_ERROR;
1199 ccid_flush_pending_answers(s);
1200 ccid_on_slot_change(s, true);
1203 static int ccid_card_exit(DeviceState *qdev)
1205 int ret = 0;
1206 CCIDCardState *card = DO_UPCAST(CCIDCardState, qdev, qdev);
1207 CCIDCardInfo *info = DO_UPCAST(CCIDCardInfo, qdev, qdev->info);
1208 USBCCIDState *s =
1209 DO_UPCAST(USBCCIDState, dev.qdev, card->qdev.parent_bus->parent);
1211 if (ccid_card_inserted(s)) {
1212 ccid_card_card_removed(card);
1214 if (info->exitfn) {
1215 ret = info->exitfn(card);
1217 s->card = NULL;
1218 s->cardinfo = NULL;
1219 return ret;
1222 static int ccid_card_init(DeviceState *qdev, DeviceInfo *base)
1224 CCIDCardState *card = DO_UPCAST(CCIDCardState, qdev, qdev);
1225 CCIDCardInfo *info = DO_UPCAST(CCIDCardInfo, qdev, base);
1226 USBCCIDState *s =
1227 DO_UPCAST(USBCCIDState, dev.qdev, card->qdev.parent_bus->parent);
1228 int ret = 0;
1230 if (card->slot != 0) {
1231 error_report("Warning: usb-ccid supports one slot, can't add %d",
1232 card->slot);
1233 return -1;
1235 if (s->card != NULL) {
1236 error_report("Warning: usb-ccid card already full, not adding");
1237 return -1;
1239 ret = info->initfn ? info->initfn(card) : ret;
1240 if (ret == 0) {
1241 s->card = card;
1242 s->cardinfo = info;
1244 return ret;
1247 void ccid_card_qdev_register(CCIDCardInfo *card)
1249 card->qdev.bus_info = &ccid_bus_info;
1250 card->qdev.init = ccid_card_init;
1251 card->qdev.exit = ccid_card_exit;
1252 qdev_register(&card->qdev);
1255 static int ccid_initfn(USBDevice *dev)
1257 USBCCIDState *s = DO_UPCAST(USBCCIDState, dev, dev);
1259 qbus_create_inplace(&s->bus.qbus, &ccid_bus_info, &dev->qdev, NULL);
1260 s->bus.qbus.allow_hotplug = 1;
1261 s->card = NULL;
1262 s->cardinfo = NULL;
1263 s->migration_state = MIGRATION_NONE;
1264 s->migration_target_ip = 0;
1265 s->migration_target_port = 0;
1266 s->dev.speed = USB_SPEED_FULL;
1267 s->dev.speedmask = USB_SPEED_MASK_FULL;
1268 s->notify_slot_change = false;
1269 s->powered = true;
1270 s->pending_answers_num = 0;
1271 s->last_answer_error = 0;
1272 s->bulk_in_pending_start = 0;
1273 s->bulk_in_pending_end = 0;
1274 s->current_bulk_in = NULL;
1275 ccid_reset_error_status(s);
1276 s->bulk_out_pos = 0;
1277 ccid_reset_parameters(s);
1278 ccid_reset(s);
1279 return 0;
1282 static int ccid_post_load(void *opaque, int version_id)
1284 USBCCIDState *s = opaque;
1287 * This must be done after usb_device_attach, which sets state to ATTACHED,
1288 * while it must be DEFAULT in order to accept packets (like it is after
1289 * reset, but reset will reset our addr and call our reset handler which
1290 * may change state, and we don't want to do that when migrating).
1292 s->dev.state = s->state_vmstate;
1293 return 0;
1296 static void ccid_pre_save(void *opaque)
1298 USBCCIDState *s = opaque;
1300 s->state_vmstate = s->dev.state;
1301 if (s->dev.attached) {
1303 * Migrating an open device, ignore reconnection CHR_EVENT to avoid an
1304 * erroneous detach.
1306 s->migration_state = MIGRATION_MIGRATED;
1310 static VMStateDescription bulk_in_vmstate = {
1311 .name = "CCID BulkIn state",
1312 .version_id = 1,
1313 .minimum_version_id = 1,
1314 .fields = (VMStateField[]) {
1315 VMSTATE_BUFFER(data, BulkIn),
1316 VMSTATE_UINT32(len, BulkIn),
1317 VMSTATE_UINT32(pos, BulkIn),
1318 VMSTATE_END_OF_LIST()
1322 static VMStateDescription answer_vmstate = {
1323 .name = "CCID Answer state",
1324 .version_id = 1,
1325 .minimum_version_id = 1,
1326 .fields = (VMStateField[]) {
1327 VMSTATE_UINT8(slot, Answer),
1328 VMSTATE_UINT8(seq, Answer),
1329 VMSTATE_END_OF_LIST()
1333 static VMStateDescription usb_device_vmstate = {
1334 .name = "usb_device",
1335 .version_id = 1,
1336 .minimum_version_id = 1,
1337 .fields = (VMStateField[]) {
1338 VMSTATE_UINT8(addr, USBDevice),
1339 VMSTATE_BUFFER(setup_buf, USBDevice),
1340 VMSTATE_BUFFER(data_buf, USBDevice),
1341 VMSTATE_END_OF_LIST()
1345 static VMStateDescription ccid_vmstate = {
1346 .name = CCID_DEV_NAME,
1347 .version_id = 1,
1348 .minimum_version_id = 1,
1349 .post_load = ccid_post_load,
1350 .pre_save = ccid_pre_save,
1351 .fields = (VMStateField[]) {
1352 VMSTATE_STRUCT(dev, USBCCIDState, 1, usb_device_vmstate, USBDevice),
1353 VMSTATE_UINT8(debug, USBCCIDState),
1354 VMSTATE_BUFFER(bulk_out_data, USBCCIDState),
1355 VMSTATE_UINT32(bulk_out_pos, USBCCIDState),
1356 VMSTATE_UINT8(bmSlotICCState, USBCCIDState),
1357 VMSTATE_UINT8(powered, USBCCIDState),
1358 VMSTATE_UINT8(notify_slot_change, USBCCIDState),
1359 VMSTATE_UINT64(last_answer_error, USBCCIDState),
1360 VMSTATE_UINT8(bError, USBCCIDState),
1361 VMSTATE_UINT8(bmCommandStatus, USBCCIDState),
1362 VMSTATE_UINT8(bProtocolNum, USBCCIDState),
1363 VMSTATE_BUFFER(abProtocolDataStructure, USBCCIDState),
1364 VMSTATE_UINT32(ulProtocolDataStructureSize, USBCCIDState),
1365 VMSTATE_STRUCT_ARRAY(bulk_in_pending, USBCCIDState,
1366 BULK_IN_PENDING_NUM, 1, bulk_in_vmstate, BulkIn),
1367 VMSTATE_UINT32(bulk_in_pending_start, USBCCIDState),
1368 VMSTATE_UINT32(bulk_in_pending_end, USBCCIDState),
1369 VMSTATE_STRUCT_ARRAY(pending_answers, USBCCIDState,
1370 PENDING_ANSWERS_NUM, 1, answer_vmstate, Answer),
1371 VMSTATE_UINT32(pending_answers_num, USBCCIDState),
1372 VMSTATE_UINT8(migration_state, USBCCIDState),
1373 VMSTATE_UINT32(state_vmstate, USBCCIDState),
1374 VMSTATE_END_OF_LIST()
1378 static struct USBDeviceInfo ccid_info = {
1379 .product_desc = "QEMU USB CCID",
1380 .qdev.name = CCID_DEV_NAME,
1381 .qdev.desc = "CCID Rev 1.1 smartcard reader",
1382 .qdev.size = sizeof(USBCCIDState),
1383 .init = ccid_initfn,
1384 .handle_packet = usb_generic_handle_packet,
1385 .handle_reset = ccid_handle_reset,
1386 .handle_control = ccid_handle_control,
1387 .handle_data = ccid_handle_data,
1388 .handle_destroy = ccid_handle_destroy,
1389 .usbdevice_name = "ccid",
1390 .qdev.props = (Property[]) {
1391 DEFINE_PROP_UINT8("debug", USBCCIDState, debug, 0),
1392 DEFINE_PROP_END_OF_LIST(),
1394 .qdev.vmsd = &ccid_vmstate,
1397 static void ccid_register_devices(void)
1399 usb_qdev_register(&ccid_info);
1401 device_init(ccid_register_devices)