rom/usb/pciusb/ehcichip.h

   1 #ifndef EHCICHIP_H
   2 #define EHCICHIP_H
   3
   4 /*
   5  *----------------------------------------------------------------------------
   6  *             Includes for EHCI USB Controller
   7  *----------------------------------------------------------------------------
   8  *                   By Chris Hodges <chrisly@platon42.de>
   9  */
  10
  11 #include <exec/types.h>
  12 #include "hccommon.h"
  13
  14 /*
  15  * --------------------- EHCI registers ------------------------
  16  * Warning: These are BYTE offsets!
  17  */
  18
  19 #define EHCI_CAPLENGTH      0x000 /* Offset for operational registers */
  20 #define EHCI_HCIVERSION     0x002 /* HC Version Number */
  21 #define EHCI_HCSPARAMS      0x004 /* HC Structural Parameters */
  22 #define EHCI_HCCPARAMS      0x008 /* HC Capability Parameters */
  23 #define EHCI_HCSPPORTROUTE  0x00c /* HC Companion Port Route Description */
  24
  25 /* EHCI_HCSPARAMS defines */
  26 #define EHSB_PORTPOWERCTRL   4    /* Support for Port Power Control */
  27 #define EHSB_EXTPORTROUTING  7    /* Routing to companion ports via HCSSPORTROUTE array */
  28 #define EHSB_PORTINDICATORS 16    /* Support for Port Indicators */
  29
  30 #define EHSS_NUM_PORTS       0    /* Number of ports */
  31 #define EHSS_PORTS_PER_COMP  8    /* Ports per companion controller */
  32 #define EHSS_NUM_COMPANIONS 12    /* Number of companion controllers */
  33
  34 #define EHSF_PORTPOWERCTRL  (1UL<<EHSB_PORTPOWERCTRL)
  35 #define EHSF_EXTPORTROUTING (1UL<<EHSB_EXTPORTROUTING)
  36 #define EHSF_PORTINDICATORS (1UL<<EHSB_PORTINDICATORS)
  37
  38 #define EHSM_NUM_PORTS      (((1UL<<4)-1)<<EHSS_NUM_PORTS)
  39 #define EHSM_PORTS_PER_COMP (((1UL<<4)-1)<<EHSS_PORTS_PER_COMP)
  40 #define EHSM_NUM_COMPANIONS (((1UL<<4)-1)<<EHSS_NUM_COMPANIONS)
  41
  42 /* EHCI_HCCPARAMS defines */
  43 #define EHCB_64BITS          0    /* Use 64 Bit pointers and structures */
  44 #define EHCB_PROGFRAMELIST   1    /* Programmable Frame list size */
  45 #define EHCB_ASYNCSCHEDPARK  2    /* Park feature for highspeed QH supported */
  46
  47 #define EHCF_64BITS         (1UL<<EHCB_64BITS)
  48 #define EHCF_PROGFRAMELIST  (1UL<<EHCB_PROGFRAMELIST)
  49 #define EHCF_ASYNCSCHEDPARK (1UL<<EHCB_ASYNCSCHEDPARK)
  50
  51 /* Operational Registers */
  52 #define EHCI_USBCMD         0x000 /* USB Command (r/w) */
  53 #define EHCI_USBSTATUS      0x004 /* USB Status (r/wc) */
  54 #define EHCI_USBINTEN       0x008 /* USB Interrupt enable (r/w) */
  55 #define EHCI_FRAMECOUNT     0x00c /* Frame Number (r/w) */
  56 #define EHCI_CTRLDSSEGMENT  0x010 /* Upper 32 bits in 64 Bit mode */
  57 #define EHCI_PERIODICLIST   0x014 /* Periodic Frame List Base Address Register (4K aligned) */
  58 #define EHCI_ASYNCADDR      0x018 /* Asynchronous List Address Register (32 byte aligned) */
  59 #define EHCI_CONFIGFLAG     0x040 /* Configure flag (r/w) */
  60 #define EHCI_PORTSC1        0x044 /* Port Status & Control 1 (r/w) */
  61
  62 /* EHCI_USBCMD defines */
  63 #define EHUB_RUNSTOP         0    /* 1=Run, 0=Stop */
  64 #define EHUB_HCRESET         1    /* Host Controller Reset */
  65 #define EHUB_PERIODICENABLE  4    /* Enable Periodic Schedule */
  66 #define EHUB_ASYNCENABLE     5    /* Enable Async Schedule */
  67 #define EHUB_ASYNCDOORBELL   6    /* Cause interrupt on next Async schedule advance */
  68 #define EHUB_LIGHTHCRESET    7    /* Light Host Controller Reset */
  69 #define EHUB_ASYNCSCHEDPARK 11    /* Park Asynchroneous schedule */
  70
  71 #define EHUS_FRAMELISTSIZE   2    /* Size of framelist (divisor) */
  72 #define EHUS_ASYNCPARKCOUNT  8    /* Number of successive transactions before continuing async */
  73 #define EHUS_INTTHRESHOLD   16    /* Interrupt threshold control */
  74
  75 #define EHUF_RUNSTOP        (1UL<<EHUB_RUNSTOP)
  76 #define EHUF_HCRESET        (1UL<<EHUB_HCRESET)
  77 #define EHUF_PERIODICENABLE (1UL<<EHUB_PERIODICENABLE)
  78 #define EHUF_ASYNCENABLE    (1UL<<EHUB_ASYNCENABLE)
  79 #define EHUF_ASYNCDOORBELL  (1UL<<EHUB_ASYNCDOORBELL)
  80 #define EHUF_LIGHTHCRESET   (1UL<<EHUB_LIGHTHCRESET)
  81 #define EHUF_ASYNCSCHEDPARK (1UL<<EHUB_ASYNCSCHEDPARK)
  82
  83 #define EHUM_FRAMELISTSIZE  (((1UL<<2)-1)<<EHUS_FRAMELISTSIZE)
  84 #define EHUM_ASYNCPARKCOUNT (((1UL<<2)-1)<<EHUS_ASYNCPARKCOUNT)
  85 #define EHUM_INTTHRESHOLD   (((1UL<<8)-1)<<EHUS_INTTHRESHOLD)
  86
  87 /* EHCI_USBSTS and EHCI_USBINTEN (0-5) defines */
  88 #define EHSB_TDDONE          0    /* Transfer descriptor done */
  89 #define EHSB_TDERROR         1    /* Some TD has errored */
  90 #define EHSB_PORTCHANGED     2    /* Port Change detected */
  91 #define EHSB_FRAMECOUNTOVER  3    /* Frame List Rollover */
  92 #define EHSB_HOSTERROR       4    /* Host System Error */
  93 #define EHSB_ASYNCADVANCE    5    /* Async Schedule has advanced */
  94 #define EHSB_HCHALTED       12    /* Host controller halted */
  95 #define EHSB_RECLAMATION    13    /* Empty asynchrous schedule */
  96 #define EHSB_PERIODICACTIVE 14    /* Periodic schedule is running */
  97 #define EHSB_ASYNCACTIVE    15    /* Async schedule is running */
  98
  99 #define EHSF_TDDONE         (1UL<<EHSB_TDDONE)
 100 #define EHSF_TDERROR        (1UL<<EHSB_TDERROR)
 101 #define EHSF_PORTCHANGED    (1UL<<EHSB_PORTCHANGED)
 102 #define EHSF_FRAMECOUNTOVER (1UL<<EHSB_FRAMECOUNTOVER)
 103 #define EHSF_HOSTERROR      (1UL<<EHSB_HOSTERROR)
 104 #define EHSF_ASYNCADVANCE   (1UL<<EHSB_ASYNCADVANCE)
 105 #define EHSF_HCHALTED       (1UL<<EHSB_HCHALTED)
 106 #define EHSF_RECLAMATION    (1UL<<EHSB_RECLAMATION)
 107 #define EHSF_PERIODICACTIVE (1UL<<EHSB_PERIODICACTIVE)
 108 #define EHSF_ASYNCACTIVE    (1UL<<EHSB_ASYNCACTIVE)
 109
 110 #define EHSF_ALL_INTS       (EHSF_TDDONE|EHSF_TDERROR|EHSF_PORTCHANGED|EHSF_FRAMECOUNTOVER|EHSF_HOSTERROR|EHSF_ASYNCADVANCE)
 111
 112 /* EHCI_CONFIGFLAG defines */
 113 #define EHCB_CONFIGURED      0
 114 #define EHCF_CONFIGURED     (1UL<<EHCB_CONFIGURED)
 115
 116 /* EHCI_PORTSC defines */
 117 #define EHPB_PORTCONNECTED   0    /* Port Connection status */
 118 #define EHPB_CONNECTCHANGE   1    /* Port Connection change */
 119 #define EHPB_PORTENABLE      2    /* Enable Port */
 120 #define EHPB_ENABLECHANGE    3    /* Port eanbled status changed */
 121 #define EHPB_OVERCURRENT     4    /* OVer current condition detected */
 122 #define EHPB_OVERCURRENTCHG  5    /* Over current condition changed */
 123 #define EHPB_RESUMEDTX       6    /* Resume detected */
 124 #define EHPB_PORTSUSPEND     7    /* Port is suspended */
 125 #define EHPB_PORTRESET       8    /* Port is in reset state */
 126 #define EHPB_LINESTATUS_DM  10    /* Line Status D- */
 127 #define EHPB_LINESTATUS_DP  11    /* Line Stauts D+ */
 128 #define EHPB_PORTPOWER      12    /* Depends on PortPowerControl */
 129 #define EHPB_NOTPORTOWNER   13    /* Inverse of CONFIGURED (0=Owner) */
 130 #define EHPB_WAKECONNECT    20    /* Wake on Connect */
 131 #define EHPB_WAKEDISCONNECT 21    /* Wake on Disconnect */
 132 #define EHPB_WAKEOCENABLE   22    /* Wake on Over Current Condition */
 133
 134 #define EHPS_PORTINDICATOR  14    /* Port indicator leds (0=off, 1=amber, 2=green) */
 135
 136 #define EHPF_PORTCONNECTED  (1UL<<EHPB_PORTCONNECTED)
 137 #define EHPF_CONNECTCHANGE  (1UL<<EHPB_CONNECTCHANGE)
 138 #define EHPF_PORTENABLE     (1UL<<EHPB_PORTENABLE)
 139 #define EHPF_ENABLECHANGE   (1UL<<EHPB_ENABLECHANGE)
 140 #define EHPF_OVERCURRENT    (1UL<<EHPB_OVERCURRENT)
 141 #define EHPF_OVERCURRENTCHG (1UL<<EHPB_OVERCURRENTCHG)
 142 #define EHPF_RESUMEDTX      (1UL<<EHPB_RESUMEDTX)
 143 #define EHPF_PORTSUSPEND    (1UL<<EHPB_PORTSUSPEND)
 144 #define EHPF_PORTRESET      (1UL<<EHPB_PORTRESET)
 145 #define EHPF_LINESTATUS_DM  (1UL<<EHPB_LINESTATUS_DM)
 146 #define EHPF_LINESTATUS_DP  (1UL<<EHPB_LINESTATUS_DP)
 147 #define EHPF_PORTPOWER      (1UL<<EHPB_PORTPOWER)
 148 #define EHPF_NOTPORTOWNER   (1UL<<EHPB_NOTPORTOWNER)
 149 #define EHPF_WAKECONNECT    (1UL<<EHPB_WAKECONNECT)
 150 #define EHPF_WAKEDISCONNECT (1UL<<EHPB_WAKEDISCONNECT)
 151 #define EHPF_WAKEOCENABLE   (1UL<<EHPB_WAKEOCENABLE)
 152
 153 #define EHPM_PORTINDICATOR  (((1UL<<2)-1)<<EHPS_PORTINDICATOR)
 154 #define EHPF_PORTIND_OFF    (0UL<<EHPS_PORTINDICATOR)
 155 #define EHPF_PORTIND_AMBER  (1UL<<EHPS_PORTINDICATOR)
 156 #define EHPF_PORTIND_GREEN  (2UL<<EHPS_PORTINDICATOR)
 157
 158 /* data structures */
 159
 160 #define EHCI_FRAMELIST_SIZE      1024
 161 #define EHCI_FRAMELIST_ALIGNMENT 0x0fff
 162
 163 #define EHCI_PAGE_SIZE           4096
 164 #define EHCI_PAGE_MASK           0xfffff000
 165 #define EHCI_OFFSET_MASK         0x00000fff
 166
 167 #define EHCI_TDQH_ALIGNMENT      0x001f
 168
 169 #define EHCI_QH_POOLSIZE         128
 170 #define EHCI_TD_POOLSIZE         512
 171
 172 #define EHCI_TD_BULK_LIMIT       (128<<10) // limit for one batch of BULK data TDs
 173
 174 struct EhciTD
 175 {
 176     struct EhciTD  *etd_Succ;
 177     ULONG           etd_Unused0;
 178     //struct EhciTD  *etd_Pred;
 179     ULONG           etd_Self;       /* LE PHYSICAL pointer to self */
 180     ULONG           etd_Length;     /* Number of bytes to transfer within this */
 181     ULONG           etd_Unused[4];
 182
 183     /* aligned to 32 bytes */
 184     ULONG           etd_NextTD;     /* LE PHYSICAL pointer to next qTD */
 185     ULONG           etd_AltNextTD;  /* LE PHYSICAL alternate pointer to next qTD on short packet */
 186     ULONG           etd_CtrlStatus; /* LE Control and Status word */
 187     ULONG           etd_BufferPtr[5]; /* LE Buffer Pointers */
 188 };
 189
 190 struct EhciQH
 191 {
 192     struct EhciQH  *eqh_Succ;
 193     struct EhciQH  *eqh_Pred;
 194     ULONG           eqh_Self;       /* LE PHYSICAL pointer to self + UHCI_QHSELECT */
 195     struct IOUsbHWReq *eqh_IOReq;   /* IO Request this belongs to */
 196
 197     struct EhciTD  *eqh_FirstTD;    /* First TD */
 198     ULONG           eqh_Actual;     /* Number of bytes for successful completion in this QH */
 199     ULONG           eqh_Unused0;
 200     ULONG           eqh_Unused1;
 201
 202     /* aligned to 32 bytes */
 203     ULONG           eqh_NextQH;     /* LE PHYSICAL horizontal pointer to next QH */
 204     ULONG           eqh_EPCaps;     /* LE Endpoint Capabilities/Characteristics word */
 205     ULONG           eqh_SplitCtrl;  /* LE Split and Int control stuff */
 206     ULONG           eqh_CurrTD;     /* LE PHYSICAL current TD pointer */
 207
 208     /* Transaction working space for host controller */
 209     ULONG           eqh_NextTD;     /* LE PHYSICAL pointer to next qTD */
 210     ULONG           eqh_AltNextTD;  /* LE PHYSICAL alternate pointer to next qTD on short packet */
 211     ULONG           eqh_CtrlStatus; /* LE Control and Status word */
 212     ULONG           eqh_BufferPtr[5]; /* LE Buffer Pointers */
 213
 214     ULONG           eqh_Unused[4];
 215 };
 216
 217 /* pointer defines */
 218
 219 #define EHCI_PTRMASK        0xffffffe0 /* frame list pointer mask */
 220 #define EHCI_TERMINATE      0x00000001 /* terminate list here */
 221 #define EHCI_ISOTD          0x00000000 /* isochronous TD */
 222 #define EHCI_QUEUEHEAD      0x00000002 /* pointer is a queue head */
 223 #define EHCI_SPLITISOTD     0x00000004 /* split transaction isochronous TD */
 224 #define EHCI_FRAMESPAN      0x00000006 /* frame span traversal node */
 225
 226 /* TD control and status word defines */
 227
 228 #define ETSB_PING            0    /* PING state instead of OUT */
 229 #define ETSB_SPLITERR        0    /* periodic split transaction error handshake */
 230 #define ETSB_COMPLETESPLIT   1    /* In complete-split state */
 231 #define ETSB_MISSEDCSPLIT    2    /* Missed Micro-frame for complete-split */
 232 #define ETSB_TRANSERR        3    /* Transaction error (Timeout, CRC, PID) */
 233 #define ETSB_BABBLE          4    /* Babble detected on the bus */
 234 #define ETSB_DATABUFFERERR   5    /* Data Buffer Error (Overrun / Underrun) */
 235 #define ETSB_HALTED          6    /* TD has been halted */
 236 #define ETCB_ACTIVE          7    /* TD is active / enable TD */
 237 #define ETCB_READYINTEN     15    /* Interrupt on Complete enable */
 238 #define ETCB_DATA1          31    /* Data toggle bit */
 239
 240 #define ETCS_PIDCODE         8    /* PID code */
 241 #define ETCS_ERRORLIMIT     10    /* how many errors permitted */
 242 #define ETSS_CURRENTPAGE    12    /* current page offset */
 243 #define ETSS_TRANSLENGTH    16    /* bytes to transfer */
 244
 245 #define ETSF_PING           (1UL<<ETSB_PING)
 246 #define ETSF_SPLITERR       (1UL<<ETSB_SPLITERR)
 247 #define ETSF_COMPLETESPLIT  (1UL<<ETSB_COMPLETESPLIT)
 248 #define ETSF_MISSEDCSPLIT   (1UL<<ETSB_MISSEDCSPLIT)
 249 #define ETSF_TRANSERR       (1UL<<ETSB_TRANSERR)
 250 #define ETSF_BABBLE         (1UL<<ETSB_BABBLE)
 251 #define ETSF_DATABUFFERERR  (1UL<<ETSB_DATABUFFERERR)
 252 #define ETSF_HALTED         (1UL<<ETSB_HALTED)
 253 #define ETCF_ACTIVE         (1UL<<ETCB_ACTIVE)
 254 #define ETCF_READYINTEN     (1UL<<ETCB_READYINTEN)
 255 #define ETCF_DATA1          (1UL<<ETCB_DATA1)
 256
 257 #define ETCM_PIDCODE        (((1UL<<2)-1)<<ETCS_PIDCODE)
 258 #define ETCF_PIDCODE_OUT    (0UL<<ETCS_PIDCODE)
 259 #define ETCF_PIDCODE_IN     (1UL<<ETCS_PIDCODE)
 260 #define ETCF_PIDCODE_SETUP  (2UL<<ETCS_PIDCODE)
 261
 262 #define ETCM_ERRORLIMIT     (((1UL<<2)-1)<<ETCS_ERRORLIMIT)
 263 #define ETCF_NOERRORLIMIT   (0UL<<ETCS_ERRORLIMIT)
 264 #define ETCF_1ERRORLIMIT    (1UL<<ETCS_ERRORLIMIT)
 265 #define ETCF_2ERRORSLIMIT   (2UL<<ETCS_ERRORLIMIT)
 266 #define ETCF_3ERRORSLIMIT   (3UL<<ETCS_ERRORLIMIT)
 267
 268 #define ETSM_CURRENTPAGE    (((1UL<<3)-1)<<ETSS_CURRENTPAGE)
 269 #define ETSM_TRANSLENGTH    (((1UL<<15)-1)<<ETSS_TRANSLENGTH)
 270
 271 /* QH EP Capabilitities */
 272
 273 #define EQEB_INACTIVATENEXT  7    /* Inactivate on next transaction for periodic schedule (FS/LS) */
 274 #define EQEB_LOWSPEED       12    /* Lowspeed transaction */
 275 #define EQEB_HIGHSPEED      13    /* Highspeed transaction */
 276 #define EQEB_TOGGLEFROMTD   14    /* Data toggle comes from TD */
 277 #define EQEB_RECLAMHEAD     15    /* Head Of Reclamation List Flag */
 278 #define EQEB_SPLITCTRLEP    27    /* For Fullspeed/Lowspeed, signal Control Endpoint */
 279
 280 #define EQES_DEVADDR         0    /* Device Address */
 281 #define EQES_ENDPOINT        8    /* Endpoint number */
 282 #define EQES_MAXPKTLEN      16    /* Maximum Packet Length */
 283 #define EQES_RELOAD         28    /* 0=Ignore NAKCOUNT, NAKCOUNT is loaded with this */
 284
 285 #define EQEF_INACTIVATENEXT (1UL<<EQEB_INACTIVATENEXT)
 286 #define EQEF_LOWSPEED       (1UL<<EQEB_LOWSPEED)
 287 #define EQEF_HIGHSPEED      (1UL<<EQEB_HIGHSPEED)
 288 #define EQEF_TOGGLEFROMTD   (1UL<<EQEB_TOGGLEFROMTD)
 289 #define EQEF_RECLAMHEAD     (1UL<<EQEB_RECLAMHEAD)
 290 #define EQEF_SPLITCTRLEP    (1UL<<EQEB_SPLITCTRLEP)
 291
 292 #define EQEM_DEVADDR        (((1UL<<7)-1)<<EQES_DEVADDR)
 293 #define EQEM_ENDPOINT       (((1UL<<4)-1)<<EQES_ENDPOINT)
 294 #define EQEM_MAXPKTLEN      (((1UL<<11)-1)<<EQES_MAXPKTLEN)
 295 #define EQEM_RELOAD         (((1UL<<4)-1)<<EQES_RELOAD)
 296
 297 /* QH Split Ctrl */
 298 #define EQSS_MUSOFACTIVE     0    /* µSOF Active */
 299 #define EQSS_MUSOFCSPLIT     8    /* When to send the complete split */
 300
 301 #define EQSS_HUBADDRESS     16    /* Hub Device Address for Split Transaction */
 302 #define EQSS_PORTNUMBER     23    /* Port Number of hub for Split Transaction */
 303 #define EQSS_MULTIPLIER     30    /* Multiplier, how many successive packets are sent */
 304
 305 #define EQSM_MUSOFACTIVE    (((1UL<<8)-1)<<EQSS_MUSOFACTIVE)
 306 #define EQSM_MUSOFCSPLIT    (((1UL<<8)-1)<<EQSS_MUSOFCSPLIT)
 307 #define EQSM_HUBADDRESS     (((1UL<<7)-1)<<EQSS_HUBADDRESS)
 308 #define EQSM_PORTNUMBER     (((1UL<<7)-1)<<EQSS_PORTNUMBER)
 309
 310 #define EQSM_MULTIPLIER     (((1UL<<2)-1)<<EQSS_MULTIPLIER)
 311 #define EQSF_MULTI_1        (1UL<<EQSS_MULTIPLIER)
 312 #define EQSF_MULTI_2        (2UL<<EQSS_MULTIPLIER)
 313 #define EQSF_MULTI_3        (3UL<<EQSS_MULTIPLIER)
 314
 315 #endif /* EHCICHIP_H */