1 /* $NetBSD: ohcivar.h,v 1.63 2024/09/22 14:05:47 jmcneill Exp $ */ 2 3 /* 4 * Copyright (c) 1998 The NetBSD Foundation, Inc. 5 * All rights reserved. 6 * 7 * This code is derived from software contributed to The NetBSD Foundation 8 * by Lennart Augustsson (lennart@augustsson.net) at 9 * Carlstedt Research & Technology. 10 * 11 * Redistribution and use in source and binary forms, with or without 12 * modification, are permitted provided that the following conditions 13 * are met: 14 * 1. Redistributions of source code must retain the above copyright 15 * notice, this list of conditions and the following disclaimer. 16 * 2. Redistributions in binary form must reproduce the above copyright 17 * notice, this list of conditions and the following disclaimer in the 18 * documentation and/or other materials provided with the distribution. 19 * 20 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 22 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 23 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 24 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 30 * POSSIBILITY OF SUCH DAMAGE. 31 */ 32 33 #ifndef _OHCIVAR_H_ 34 #define _OHCIVAR_H_ 35 36 #include <sys/pool.h> 37 38 typedef struct ohci_soft_ed { 39 ohci_ed_t *ed; 40 struct ohci_soft_ed *next; 41 ohci_physaddr_t physaddr; 42 usb_dma_t dma; 43 int offs; 44 } ohci_soft_ed_t; 45 46 47 typedef struct ohci_soft_td { 48 ohci_td_t *td; 49 struct ohci_soft_td *nexttd; /* mirrors nexttd in TD */ 50 struct ohci_soft_td *dnext; /* next in done list */ 51 struct ohci_soft_td **held; /* where the ref to this std is held */ 52 ohci_physaddr_t physaddr; 53 usb_dma_t dma; 54 int offs; 55 LIST_ENTRY(ohci_soft_td) hnext; /* next on hash list */ 56 struct usbd_xfer *xfer; 57 uint16_t len; 58 uint16_t flags; 59 #define OHCI_CALL_DONE 0x0001 60 #define OHCI_ADD_LEN 0x0002 61 } ohci_soft_td_t; 62 // #define OHCI_STD_SIZE (roundup(sizeof(struct ohci_soft_td), OHCI_TD_ALIGN)) 63 // #define OHCI_STD_CHUNK 128 64 65 66 typedef struct ohci_soft_itd { 67 ohci_itd_t *itd; 68 struct ohci_soft_itd *nextitd; /* mirrors nexttd in ITD */ 69 struct ohci_soft_itd *dnext; /* next in done list */ 70 struct ohci_soft_itd **held; /* where the ref to this sitd is held */ 71 ohci_physaddr_t physaddr; 72 usb_dma_t dma; 73 int offs; 74 LIST_ENTRY(ohci_soft_itd) hnext;/* next on hash list */ 75 struct usbd_xfer *xfer; 76 uint16_t flags; 77 bool isdone; /* used only when DIAGNOSTIC is defined */ 78 } ohci_soft_itd_t; 79 // #define OHCI_SITD_SIZE (roundup(sizeof(struct ohci_soft_itd), OHCI_ITD_ALIGN)) 80 // #define OHCI_SITD_CHUNK 64 81 82 83 #define OHCI_NO_EDS (2*OHCI_NO_INTRS-1) 84 85 #define OHCI_HASH_SIZE 128 86 87 typedef struct ohci_softc { 88 device_t sc_dev; 89 struct usbd_bus sc_bus; 90 bus_space_tag_t iot; 91 bus_space_handle_t ioh; 92 bus_size_t sc_size; 93 94 kmutex_t sc_lock; 95 kmutex_t sc_intr_lock; 96 void *sc_rhsc_si; 97 98 usb_dma_t sc_hccadma; 99 struct ohci_hcca *sc_hcca; 100 ohci_soft_ed_t *sc_eds[OHCI_NO_EDS]; 101 u_int sc_bws[OHCI_NO_INTRS]; 102 103 uint32_t sc_eintrs; 104 ohci_soft_ed_t *sc_isoc_head; 105 ohci_soft_ed_t *sc_ctrl_head; 106 ohci_soft_ed_t *sc_bulk_head; 107 108 LIST_HEAD(, ohci_soft_td) sc_hash_tds[OHCI_HASH_SIZE]; 109 LIST_HEAD(, ohci_soft_itd) sc_hash_itds[OHCI_HASH_SIZE]; 110 111 TAILQ_HEAD(, ohci_xfer) sc_abortingxfers; 112 113 int sc_noport; 114 115 int sc_endian; 116 #define OHCI_LITTLE_ENDIAN 0 /* typical (uninitialized default) */ 117 #define OHCI_BIG_ENDIAN 1 /* big endian OHCI? never seen it */ 118 #define OHCI_HOST_ENDIAN 2 /* if OHCI always matches CPU */ 119 120 int sc_flags; 121 #define OHCIF_SUPERIO 0x0001 122 123 kcondvar_t sc_abort_cv; 124 125 ohci_soft_ed_t *sc_freeeds; 126 ohci_soft_td_t *sc_freetds; 127 ohci_soft_itd_t *sc_freeitds; 128 129 pool_cache_t sc_xferpool; /* free xfer pool */ 130 131 struct usbd_xfer *sc_intrxfer; 132 133 uint32_t sc_control; /* Preserved during suspend/standby */ 134 uint32_t sc_intre; 135 136 u_int sc_overrun_cnt; 137 struct timeval sc_overrun_ntc; 138 139 struct callout sc_tmo_rhsc; 140 device_t sc_child; 141 char sc_dying; 142 } ohci_softc_t; 143 144 struct ohci_xfer { 145 struct usbd_xfer xfer; 146 uint32_t ox_abintrs; 147 TAILQ_ENTRY(ohci_xfer) ox_abnext; 148 149 /* ctrl */ 150 ohci_soft_td_t *ox_setup; 151 ohci_soft_td_t *ox_stat; 152 union { 153 /* ctrl/bulk/intr */ 154 struct { 155 ohci_soft_td_t **ox_stds; 156 size_t ox_nstd; 157 }; 158 /* isoc */ 159 struct { 160 ohci_soft_itd_t **ox_sitds; 161 size_t ox_nsitd; 162 }; 163 }; 164 }; 165 166 #define OHCI_BUS2SC(bus) ((bus)->ub_hcpriv) 167 #define OHCI_PIPE2SC(pipe) OHCI_BUS2SC((pipe)->up_dev->ud_bus) 168 #define OHCI_XFER2SC(xfer) OHCI_BUS2SC((xfer)->ux_bus) 169 170 #define OHCI_XFER2OXFER(xfer) ((struct ohci_xfer *)(xfer)) 171 #define OHCI_PIPE2OPIPE(pipe) ((struct ohci_pipe *)(pipe)) 172 173 int ohci_init(ohci_softc_t *); 174 int ohci_intr(void *); 175 int ohci_detach(ohci_softc_t *, int); 176 bool ohci_shutdown(device_t, int); 177 void ohci_childdet(device_t, device_t); 178 int ohci_activate(device_t, enum devact); 179 bool ohci_resume(device_t, const pmf_qual_t *); 180 bool ohci_suspend(device_t, const pmf_qual_t *); 181 182 #endif /* _OHCIVAR_H_ */ 183