xref: /trueos/sys/boot/usb/bsd_kernel.h (revision 99bc25a1685ca34d8638e41c44477ff59a2dc490)
1 /* $FreeBSD$ */
2 /*-
3  * Copyright (c) 2011 Hans Petter Selasky. All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  */
26 
27 #ifndef _BSD_KERNEL_H_
28 #define	_BSD_KERNEL_H_
29 
30 #define	_KERNEL
31 #define	__FreeBSD_version 1000000
32 
33 #include <sys/cdefs.h>
34 #include <sys/queue.h>
35 #include <sys/errno.h>
36 
37 #define	isalpha(x) (((x) >= 'a' && (x) <= 'z') || ((x) >= 'A' && (x) <= 'Z'))
38 #define	isdigit(x) ((x) >= '0' && (x) <= '9')
39 #define	panic(...) do { printf("USB PANIC: " __VA_ARGS__); while (1) ; } while (0)
40 #define	rebooting 0
41 #define	M_USB 0
42 #define	M_USBDEV 0
43 #define	USB_PROC_MAX 3
44 #define	USB_BUS_GIANT_PROC(bus) (usb_process + 2)
45 #define	USB_BUS_NON_GIANT_PROC(bus) (usb_process + 2)
46 #define	USB_BUS_EXPLORE_PROC(bus) (usb_process + 0)
47 #define	USB_BUS_CONTROL_XFER_PROC(bus) (usb_process + 1)
48 #define	SYSCTL_DECL(...)
49 #define	SYSCTL_NODE(name,...) struct { } name __used
50 #define	SYSCTL_INT(...)
51 #define	TUNABLE_INT(...)
52 #define	MALLOC_DECLARE(...)
53 #define	MALLOC_DEFINE(...)
54 #define	EVENTHANDLER_DECLARE(...)
55 #define	EVENTHANDLER_INVOKE(...)
56 #define	KASSERT(...)
57 #define	SCHEDULER_STOPPED(x) (0)
58 #define	PI_SWI(...) (0)
59 #define	UNIQ_NAME(x) x
60 #define	UNIQ_NAME_STR(x) #x
61 #define	DEVCLASS_MAXUNIT 32
62 #define	MOD_LOAD 1
63 #define	MOD_UNLOAD 2
64 #define	DEVMETHOD(what,func) { #what, (void *)&func }
65 #define	DEVMETHOD_END {0,0}
66 #define	DRIVER_MODULE(name, busname, driver, devclass, evh, arg)	\
67   static struct module_data bsd_##name##_##busname##_driver_mod = {	\
68 	evh, arg, #busname, #name, #busname "/" #name,			\
69 	&driver, &devclass, { 0, 0 } };					\
70 SYSINIT(bsd_##name##_##busname##_driver_mod, SI_SUB_DRIVERS,		\
71   SI_ORDER_MIDDLE, module_register,					\
72   &bsd_##name##_##busname##_driver_mod)
73 #define	SYSINIT(uniq, subs, order, _func, _data)	\
74 const struct sysinit UNIQ_NAME(sysinit_##uniq) = {	\
75 	.func = (_func),				\
76 	.data = __DECONST(void *, _data)		\
77 };							\
78 SYSINIT_ENTRY(uniq##_entry, "sysinit", (subs),		\
79     (order), "const struct sysinit",			\
80     UNIQ_NAME_STR(sysinit_##uniq), "SYSINIT")
81 
82 #define	SYSUNINIT(uniq, subs, order, _func, _data)	\
83 const struct sysinit UNIQ_NAME(sysuninit_##uniq) = {	\
84 	.func = (_func),				\
85 	.data = __DECONST(void *, _data)		\
86 };							\
87 SYSINIT_ENTRY(uniq##_entry, "sysuninit", (subs),	\
88     (order), "const struct sysuninit",			\
89     UNIQ_NAME_STR(sysuninit_##uniq), "SYSUNINIT")
90 #define	MODULE_DEPEND(...)
91 #define	MODULE_VERSION(...)
92 #define	NULL ((void *)0)
93 #define	BUS_SPACE_BARRIER_READ 0x01
94 #define	BUS_SPACE_BARRIER_WRITE 0x02
95 #define	hz 1000
96 #define	PAGE_SIZE 4096
97 #define	MIN(a,b) (((a) < (b)) ? (a) : (b))
98 #define	MAX(a,b) (((a) > (b)) ? (a) : (b))
99 #define	MTX_DEF 0
100 #define	MTX_SPIN 0
101 #define	MTX_RECURSE 0
102 #define	SX_DUPOK 0
103 #define	SX_NOWITNESS 0
104 #define	WITNESS_WARN(...)
105 #define	cold 0
106 #define	BUS_PROBE_GENERIC 0
107 #define	CALLOUT_RETURNUNLOCKED 0x1
108 #define	va_list __builtin_va_list
109 #define	va_size(type) __builtin_va_size(type)
110 #define	va_start(ap, last) __builtin_va_start(ap, last)
111 #define	va_end(ap) __builtin_va_end(ap)
112 #define	va_arg(ap, type) __builtin_va_arg((ap), type)
113 #define	DEVICE_ATTACH(dev, ...) \
114   (((device_attach_t *)(device_get_method(dev, "device_attach")))(dev,## __VA_ARGS__))
115 #define	DEVICE_DETACH(dev, ...) \
116   (((device_detach_t *)(device_get_method(dev, "device_detach")))(dev,## __VA_ARGS__))
117 #define	DEVICE_PROBE(dev, ...) \
118   (((device_probe_t *)(device_get_method(dev, "device_probe")))(dev,## __VA_ARGS__))
119 #define	DEVICE_RESUME(dev, ...) \
120   (((device_resume_t *)(device_get_method(dev, "device_resume")))(dev,## __VA_ARGS__))
121 #define	DEVICE_SHUTDOWN(dev, ...) \
122   (((device_shutdown_t *)(device_get_method(dev, "device_shutdown")))(dev,## __VA_ARGS__))
123 #define	DEVICE_SUSPEND(dev, ...) \
124   (((device_suspend_t *)(device_get_method(dev, "device_suspend")))(dev,## __VA_ARGS__))
125 #define	USB_HANDLE_REQUEST(dev, ...) \
126   (((usb_handle_request_t *)(device_get_method(dev, "usb_handle_request")))(dev,## __VA_ARGS__))
127 #define	USB_TAKE_CONTROLLER(dev, ...) \
128   (((usb_take_controller_t *)(device_get_method(dev, "usb_take_controller")))(dev,## __VA_ARGS__))
129 
130 enum {
131 	SI_SUB_DUMMY = 0x0000000,
132 	SI_SUB_LOCK = 0x1B00000,
133 	SI_SUB_KLD = 0x2000000,
134 	SI_SUB_DRIVERS = 0x3100000,
135 	SI_SUB_PSEUDO = 0x7000000,
136 	SI_SUB_KICK_SCHEDULER = 0xa000000,
137 	SI_SUB_RUN_SCHEDULER = 0xfffffff
138 };
139 
140 enum {
141 	SI_ORDER_FIRST = 0x0000000,
142 	SI_ORDER_SECOND = 0x0000001,
143 	SI_ORDER_THIRD = 0x0000002,
144 	SI_ORDER_FOURTH = 0x0000003,
145 	SI_ORDER_MIDDLE = 0x1000000,
146 	SI_ORDER_ANY = 0xfffffff	/* last */
147 };
148 
149 struct uio;
150 struct thread;
151 struct malloc_type;
152 struct usb_process;
153 
154 typedef unsigned char uint8_t;
155 typedef signed char int8_t;
156 
157 typedef unsigned short uint16_t;
158 typedef signed short int16_t;
159 
160 typedef unsigned int uint32_t;
161 typedef signed int int32_t;
162 
163 typedef unsigned long long uint64_t;
164 typedef signed long long int64_t;
165 
166 typedef unsigned long bus_addr_t;
167 typedef unsigned long bus_size_t;
168 
169 typedef unsigned long size_t;
170 typedef unsigned long u_long;
171 
172 typedef void *bus_dmamap_t;
173 typedef void *bus_dma_tag_t;
174 
175 typedef void *bus_space_tag_t;
176 typedef uint8_t *bus_space_handle_t;
177 
178 typedef uint16_t uid_t;
179 typedef uint16_t gid_t;
180 typedef uint16_t mode_t;
181 
182 typedef uint8_t *caddr_t;
183 typedef unsigned long __uintptr_t;
184 typedef unsigned long uintptr_t;
185 
186 /* SYSINIT API */
187 
188 #include <sysinit.h>
189 
190 struct sysinit {
191 	void    (*func) (void *arg);
192 	void   *data;
193 };
194 
195 /* MUTEX API */
196 
197 struct mtx {
198 	int	owned;
199 	struct mtx *parent;
200 };
201 
202 #define	mtx_assert(...) do { } while (0)
203 void	mtx_init(struct mtx *, const char *, const char *, int);
204 void	mtx_lock(struct mtx *);
205 void	mtx_unlock(struct mtx *);
206 #define	mtx_lock_spin(x) mtx_lock(x)
207 #define	mtx_unlock_spin(x) mtx_unlock(x)
208 int	mtx_owned(struct mtx *);
209 void	mtx_destroy(struct mtx *);
210 
211 extern struct mtx Giant;
212 
213 /* SX API */
214 
215 struct sx {
216 	int	owned;
217 };
218 
219 #define	sx_assert(...) do { } while (0)
220 #define	sx_init(...) sx_init_flags(__VA_ARGS__, 0)
221 void	sx_init_flags(struct sx *, const char *, int);
222 void	sx_destroy(struct sx *);
223 void	sx_xlock(struct sx *);
224 void	sx_xunlock(struct sx *);
225 int	sx_xlocked(struct sx *);
226 
227 /* CONDVAR API */
228 
229 struct cv {
230 	int	sleeping;
231 };
232 
233 void	cv_init(struct cv *, const char *desc);
234 void	cv_destroy(struct cv *);
235 void	cv_wait(struct cv *, struct mtx *);
236 int	cv_timedwait(struct cv *, struct mtx *, int);
237 void	cv_signal(struct cv *);
238 void	cv_broadcast(struct cv *);
239 
240 /* CALLOUT API */
241 
242 typedef void callout_fn_t (void *);
243 
244 extern volatile int ticks;
245 
246 struct callout {
247 	LIST_ENTRY(callout) entry;
248 	callout_fn_t *func;
249 	void   *arg;
250 	struct mtx *mtx;
251 	int	flags;
252 	int	timeout;
253 };
254 
255 void	callout_init_mtx(struct callout *, struct mtx *, int);
256 void	callout_reset(struct callout *, int, callout_fn_t *, void *);
257 void	callout_stop(struct callout *);
258 void	callout_drain(struct callout *);
259 int	callout_pending(struct callout *);
260 void	callout_process(int timeout);
261 
262 /* DEVICE API */
263 
264 struct driver;
265 struct devclass;
266 struct device;
267 struct module;
268 struct module_data;
269 
270 typedef struct driver driver_t;
271 typedef struct devclass *devclass_t;
272 typedef struct device *device_t;
273 typedef void (driver_intr_t)(void *arg);
274 typedef int (driver_filter_t)(void *arg);
275 #define	FILTER_STRAY		0x01
276 #define	FILTER_HANDLED		0x02
277 #define	FILTER_SCHEDULE_THREAD	0x04
278 
279 typedef int device_attach_t (device_t dev);
280 typedef int device_detach_t (device_t dev);
281 typedef int device_resume_t (device_t dev);
282 typedef int device_shutdown_t (device_t dev);
283 typedef int device_probe_t (device_t dev);
284 typedef int device_suspend_t (device_t dev);
285 
286 typedef int bus_child_location_str_t (device_t parent, device_t child, char *buf, size_t buflen);
287 typedef int bus_child_pnpinfo_str_t (device_t parent, device_t child, char *buf, size_t buflen);
288 typedef void bus_driver_added_t (device_t dev, driver_t *driver);
289 
290 struct device_method {
291 	const char *desc;
292 	void   *const func;
293 };
294 
295 typedef struct device_method device_method_t;
296 
297 struct device {
298 	TAILQ_HEAD(device_list, device) dev_children;
299 	TAILQ_ENTRY(device) dev_link;
300 
301 	struct device *dev_parent;
302 	const struct module_data *dev_module;
303 	void   *dev_sc;
304 	void   *dev_aux;
305 	driver_filter_t *dev_irq_filter;
306 	driver_intr_t *dev_irq_fn;
307 	void   *dev_irq_arg;
308 
309 	uint16_t dev_unit;
310 
311 	char	dev_nameunit[64];
312 	char	dev_desc[64];
313 
314 	uint8_t	dev_res_alloc:1;
315 	uint8_t	dev_quiet:1;
316 	uint8_t	dev_softc_set:1;
317 	uint8_t	dev_softc_alloc:1;
318 	uint8_t	dev_attached:1;
319 	uint8_t	dev_fixed_class:1;
320 	uint8_t	dev_unit_manual:1;
321 };
322 
323 struct devclass {
324 	device_t dev_list[DEVCLASS_MAXUNIT];
325 };
326 
327 struct driver {
328 	const char *name;
329 	const struct device_method *methods;
330 	uint32_t size;
331 };
332 
333 struct module_data {
334 	int     (*callback) (struct module *, int, void *arg);
335 	void   *arg;
336 	const char *bus_name;
337 	const char *mod_name;
338 	const char *long_name;
339 	const struct driver *driver;
340 	struct devclass **devclass_pp;
341 	TAILQ_ENTRY(module_data) entry;
342 };
343 
344 device_t device_get_parent(device_t dev);
345 void   *device_get_method(device_t dev, const char *what);
346 const char *device_get_name(device_t dev);
347 const char *device_get_nameunit(device_t dev);
348 
349 #define	device_printf(dev, fmt,...) \
350 	printf("%s: " fmt, device_get_nameunit(dev),## __VA_ARGS__)
351 device_t device_add_child(device_t dev, const char *name, int unit);
352 void	device_quiet(device_t dev);
353 void	device_set_interrupt(device_t dev, driver_filter_t *, driver_intr_t *, void *);
354 void	device_run_interrupts(device_t parent);
355 void	device_set_ivars(device_t dev, void *ivars);
356 void   *device_get_ivars(device_t dev);
357 const char *device_get_desc(device_t dev);
358 int	device_probe_and_attach(device_t dev);
359 int	device_detach(device_t dev);
360 void   *device_get_softc(device_t dev);
361 void	device_set_softc(device_t dev, void *softc);
362 int	device_delete_child(device_t dev, device_t child);
363 int	device_delete_children(device_t dev);
364 int	device_is_attached(device_t dev);
365 void	device_set_desc(device_t dev, const char *desc);
366 void	device_set_desc_copy(device_t dev, const char *desc);
367 int	device_get_unit(device_t dev);
368 void   *devclass_get_softc(devclass_t dc, int unit);
369 int	devclass_get_maxunit(devclass_t dc);
370 device_t devclass_get_device(devclass_t dc, int unit);
371 devclass_t devclass_find(const char *classname);
372 
373 #define	bus_get_dma_tag(...) (NULL)
374 int	bus_generic_detach(device_t dev);
375 int	bus_generic_resume(device_t dev);
376 int	bus_generic_shutdown(device_t dev);
377 int	bus_generic_suspend(device_t dev);
378 int	bus_generic_print_child(device_t dev, device_t child);
379 void	bus_generic_driver_added(device_t dev, driver_t *driver);
380 
381 /* BUS SPACE API */
382 
383 void	bus_space_write_1(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset, uint8_t data);
384 void	bus_space_write_2(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset, uint16_t data);
385 void	bus_space_write_4(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset, uint32_t data);
386 
387 uint8_t	bus_space_read_1(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset);
388 uint16_t bus_space_read_2(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset);
389 uint32_t bus_space_read_4(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset);
390 
391 void	bus_space_read_multi_1(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset, uint8_t *datap, bus_size_t count);
392 void	bus_space_read_multi_2(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset, uint16_t *datap, bus_size_t count);
393 void	bus_space_read_multi_4(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset, uint32_t *datap, bus_size_t count);
394 
395 void	bus_space_write_multi_1(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset, uint8_t *datap, bus_size_t count);
396 void	bus_space_write_multi_2(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset, uint16_t *datap, bus_size_t count);
397 void	bus_space_write_multi_4(bus_space_tag_t t, bus_space_handle_t h, bus_size_t offset, uint32_t *datap, bus_size_t count);
398 
399 void	bus_space_read_region_1(bus_space_tag_t space, bus_space_handle_t handle, bus_size_t offset, uint8_t *datap, bus_size_t count);
400 void	bus_space_write_region_1(bus_space_tag_t space, bus_space_handle_t handle, bus_size_t offset, uint8_t *datap, bus_size_t count);
401 void	bus_space_read_region_4(bus_space_tag_t space, bus_space_handle_t handle, bus_size_t offset, uint32_t *datap, bus_size_t count);
402 void	bus_space_write_region_4(bus_space_tag_t space, bus_space_handle_t handle, bus_size_t offset, uint32_t *datap, bus_size_t count);
403 
404 void	bus_space_barrier(bus_space_tag_t space, bus_space_handle_t handle, bus_size_t offset, bus_size_t length, int flags);
405 
406 void	module_register(void *);
407 
408 /* LIB-C */
409 
410 void   *memset(void *, int, size_t len);
411 void   *memcpy(void *, const void *, size_t len);
412 int	printf(const char *,...) __printflike(1, 2);
413 int	snprintf(char *restrict str, size_t size, const char *restrict format,...) __printflike(3, 4);
414 size_t	strlen(const char *s);
415 
416 /* MALLOC API */
417 
418 #define	malloc(s,x,f) usb_malloc(s)
419 void   *usb_malloc(size_t);
420 
421 #define	free(p,x) usb_free(p)
422 void	usb_free(void *);
423 
424 #define	strdup(p,x) usb_strdup(p)
425 char   *usb_strdup(const char *str);
426 
427 /* ENDIANNESS */
428 
429 /* Assume little endian */
430 
431 #define	htole64(x) ((uint64_t)(x))
432 #define	le64toh(x) ((uint64_t)(x))
433 
434 #define	htole32(x) ((uint32_t)(x))
435 #define	le32toh(x) ((uint32_t)(x))
436 
437 #define	htole16(x) ((uint16_t)(x))
438 #define	le16toh(x) ((uint16_t)(x))
439 
440 #define	be32toh(x) ((uint32_t)(x))
441 #define	htobe32(x) ((uint32_t)(x))
442 
443 /* USB */
444 
445 typedef int usb_handle_request_t (device_t dev, const void *req, void **pptr, uint16_t *plen, uint16_t offset, uint8_t *pstate);
446 typedef int usb_take_controller_t (device_t dev);
447 
448 void	usb_idle(void);
449 void	usb_init(void);
450 void	usb_uninit(void);
451 
452 /* set some defaults */
453 
454 #ifndef USB_POOL_SIZE
455 #define	USB_POOL_SIZE (1024*1024)	/* 1 MByte */
456 #endif
457 
458 int	pause(const char *, int);
459 void	DELAY(unsigned int);
460 
461 /* OTHER */
462 
463 struct selinfo {
464 };
465 
466 /* SYSTEM STARTUP API */
467 
468 extern const void *sysinit_data[];
469 extern const void *sysuninit_data[];
470 
471 #endif					/* _BSD_KERNEL_H_ */
472