xref: /f-stack/freebsd/mips/cavium/usb/octusb.h (revision 22ce4aff)
1 /* $FreeBSD$ */
2 
3 /*-
4  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
5  *
6  * Copyright (c) 2010 Hans Petter Selasky. All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
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.
16  *
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
27  * SUCH DAMAGE.
28  */
29 
30 #ifndef _OCTUSB_H_
31 #define	_OCTUSB_H_
32 
33 #define	OCTUSB_MAX_DEVICES MIN(USB_MAX_DEVICES, 64)
34 #define	OCTUSB_MAX_PORTS	2	/* hardcoded */
35 #define	OCTUSB_MAX_FIXUP	4096	/* bytes */
36 #define	OCTUSB_INTR_ENDPT	0x01
37 
38 struct octusb_qh;
39 struct octusb_td;
40 struct octusb_softc;
41 
42 typedef uint8_t (octusb_cmd_t)(struct octusb_td *td);
43 
44 struct octusb_td {
45 	struct octusb_qh *qh;
46 	struct octusb_td *obj_next;
47 	struct usb_page_cache *pc;
48 	octusb_cmd_t *func;
49 
50 	uint32_t remainder;
51 	uint32_t offset;
52 
53 	uint8_t	error_any:1;
54 	uint8_t	error_stall:1;
55 	uint8_t	short_pkt:1;
56 	uint8_t	alt_next:1;
57 	uint8_t	reserved:4;
58 };
59 
60 struct octusb_qh {
61 	uint64_t fixup_phys;
62 
63 	struct octusb_softc *sc;
64 	struct usb_page_cache *fixup_pc;
65 	uint8_t *fixup_buf;
66 
67 	cvmx_usb_iso_packet_t iso_pkt;
68 
69 	uint32_t fixup_off;
70 
71 	uint16_t max_frame_size;
72 	uint16_t max_packet_size;
73 	uint16_t fixup_actlen;
74 	uint16_t fixup_len;
75 	uint16_t ep_interval;
76 
77 	uint8_t	dev_addr;
78 	uint8_t	dev_speed;
79 	uint8_t	ep_allocated;
80 	uint8_t	ep_mult;
81 	uint8_t	ep_num;
82 	uint8_t	ep_type;
83 	uint8_t	ep_toggle_next;
84 	uint8_t	root_port_index;
85 	uint8_t	fixup_complete;
86 	uint8_t	fixup_pending;
87 	uint8_t	hs_hub_addr;
88 	uint8_t	hs_hub_port;
89 
90 	int	fixup_handle;
91 	int	ep_handle;
92 };
93 
94 struct octusb_config_desc {
95 	struct usb_config_descriptor confd;
96 	struct usb_interface_descriptor ifcd;
97 	struct usb_endpoint_descriptor endpd;
98 } __packed;
99 
100 union octusb_hub_desc {
101 	struct usb_status stat;
102 	struct usb_port_status ps;
103 	uint8_t	temp[128];
104 };
105 
106 struct octusb_port {
107 	cvmx_usb_state_t state;
108 	uint8_t	disabled;
109 };
110 
111 struct octusb_softc {
112 	struct usb_bus sc_bus;		/* base device */
113 	union octusb_hub_desc sc_hub_desc;
114 
115 	struct usb_device *sc_devices[OCTUSB_MAX_DEVICES];
116 
117 	struct resource *sc_irq_res[OCTUSB_MAX_PORTS];
118 	void   *sc_intr_hdl[OCTUSB_MAX_PORTS];
119 
120 	struct octusb_port sc_port[OCTUSB_MAX_PORTS];
121 	device_t sc_dev;
122 
123 	struct usb_hub_descriptor_min sc_hubd;
124 
125 	uint8_t	sc_noport;		/* number of ports */
126 	uint8_t	sc_addr;		/* device address */
127 	uint8_t	sc_conf;		/* device configuration */
128 	uint8_t	sc_isreset;		/* set if current port is reset */
129 
130 	uint8_t	sc_hub_idata[1];
131 };
132 
133 usb_bus_mem_cb_t octusb_iterate_hw_softc;
134 usb_error_t octusb_init(struct octusb_softc *);
135 usb_error_t octusb_uninit(struct octusb_softc *);
136 void	octusb_interrupt(struct octusb_softc *);
137 
138 #endif					/* _OCTUSB_H_ */
139