2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 2014 Leon Dang <ldang@nahannisys.com>
5 * Copyright 2018 Joyent, Inc.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
37 #include <sys/linker_set.h>
43 #define USB_MAX_XFER_BLOCKS 8
45 #define USB_XFER_OUT 0
51 struct usb_device_request
;
54 /* Device emulation handlers */
56 const char *ue_emu
; /* name of device emulation */
57 int ue_usbver
; /* usb version: 2 or 3 */
58 int ue_usbspeed
; /* usb device speed */
60 /* instance creation */
61 void *(*ue_init
)(struct usb_hci
*hci
, nvlist_t
*nvl
);
64 int (*ue_request
)(void *sc
, struct usb_data_xfer
*xfer
);
65 int (*ue_data
)(void *sc
, struct usb_data_xfer
*xfer
, int dir
,
67 int (*ue_reset
)(void *sc
);
68 int (*ue_remove
)(void *sc
);
69 int (*ue_stop
)(void *sc
);
71 #define USB_EMUL_SET(x) DATA_SET(usb_emu_set, x);
74 * USB device events to notify HCI when state changes
83 /* usb controller, ie xhci, ehci */
85 int (*hci_intr
)(struct usb_hci
*hci
, int epctx
);
86 int (*hci_event
)(struct usb_hci
*hci
, enum hci_usbev evid
,
88 void *hci_sc
; /* private softc for hci */
90 /* controller managed fields */
96 * Each xfer block is mapped to the hci transfer block.
97 * On input into the device handler, blen is set to the lenght of buf.
98 * The device handler is to update blen to reflect on the residual size
99 * of the buffer, i.e. len(buf) - len(consumed).
101 struct usb_data_xfer_block
{
102 void *buf
; /* IN or OUT pointer */
103 int blen
; /* in:len(buf), out:len(remaining) */
104 int bdone
; /* bytes transferred */
105 uint32_t processed
; /* device processed this + errcode */
106 void *hci_data
; /* HCI private reference */
109 uint64_t trbnext
; /* next TRB guest address */
112 struct usb_data_xfer
{
113 struct usb_data_xfer_block data
[USB_MAX_XFER_BLOCKS
];
114 struct usb_device_request
*ureq
; /* setup ctl request */
115 int ndata
; /* # of data items */
130 #define USB_DATA_GET_ERRCODE(x) (x)->processed >> 8
131 #define USB_DATA_SET_ERRCODE(x,e) do { \
132 (x)->processed = ((x)->processed & 0xFF) | (e << 8); \
135 #define USB_DATA_OK(x,i) ((x)->data[(i)].buf != NULL)
137 #define USB_DATA_XFER_INIT(x) do { \
138 memset((x), 0, sizeof(*(x))); \
139 pthread_mutex_init(&((x)->mtx), NULL); \
142 #define USB_DATA_XFER_RESET(x) do { \
143 memset((x)->data, 0, sizeof((x)->data)); \
145 (x)->head = (x)->tail = 0; \
148 #define USB_DATA_XFER_LOCK(x) do { \
149 pthread_mutex_lock(&((x)->mtx)); \
152 #define USB_DATA_XFER_UNLOCK(x) do { \
153 pthread_mutex_unlock(&((x)->mtx)); \
156 #define USB_DATA_XFER_LOCK_HELD(x) MUTEX_HELD(&((x)->mtx))
159 struct usb_devemu
*usb_emu_finddev(const char *name
);
161 struct usb_data_xfer_block
*usb_data_xfer_append(struct usb_data_xfer
*xfer
,
162 void *buf
, int blen
, void *hci_data
, int ccs
);
165 #endif /* _USB_EMUL_H_ */