← Back to branch summary

~pmdj/ubuntu/trusty/qemu/2.9+applesmc+fadtv3

« back to all changes in this revision

Viewing changes to roms/u-boot/doc/README.generic_usb_ohci

  • Committer: Phil Dennis-Jordan
  • Date: 2017-07-21 08:03:43 UTC
  • mfrom: (1.1.1)
  • Revision ID: phil@philjordan.eu-20170721080343-2yr2vdj7713czahv
New upstream release 2.9.0.

Show diffs side-by-side

added added

removed removed

Lines of Context:
roms/u-boot/doc/README.generic_usb_ohci
 
1
Notes on the the generic USB-OHCI driver
 
2
========================================
 
3
 
 
4
This driver (drivers/usb/usb_ohci.[ch]) is the result of the merge of
 
5
various existing OHCI drivers that were basically identical beside
 
6
cpu/board dependant initalization. This initalization has been moved
 
7
into cpu/board directories and are called via the hooks below.
 
8
 
 
9
Configuration options
 
10
----------------------
 
11
 
 
12
        CONFIG_USB_OHCI_NEW: enable the new OHCI driver
 
13
 
 
14
        CONFIG_SYS_USB_OHCI_BOARD_INIT: call the board dependant hooks:
 
15
 
 
16
                  - extern int usb_board_init(void);
 
17
                  - extern int usb_board_stop(void);
 
18
                  - extern int usb_cpu_init_fail(void);
 
19
 
 
20
        CONFIG_SYS_USB_OHCI_CPU_INIT: call the cpu dependant hooks:
 
21
 
 
22
                  - extern int usb_cpu_init(void);
 
23
                  - extern int usb_cpu_stop(void);
 
24
                  - extern int usb_cpu_init_fail(void);
 
25
 
 
26
        CONFIG_SYS_USB_OHCI_REGS_BASE: defines the base address of the OHCI
 
27
                                registers
 
28
 
 
29
        CONFIG_SYS_USB_OHCI_SLOT_NAME: slot name
 
30
 
 
31
        CONFIG_SYS_USB_OHCI_MAX_ROOT_PORTS: maximal number of ports of the
 
32
                                     root hub.
 
33
 
 
34
 
 
35
Endianness issues
 
36
------------------
 
37
 
 
38
The USB bus operates in little endian, but unfortunately there are
 
39
OHCI controllers that operate in big endian such as ppc4xx and
 
40
mpc5xxx. For these the config option
 
41
 
 
42
        CONFIG_SYS_OHCI_BE_CONTROLLER
 
43
 
 
44
needs to be defined.
 
45
 
 
46
 
 
47
PCI Controllers
 
48
----------------
 
49
 
 
50
You'll need to define
 
51
 
 
52
        CONFIG_PCI_OHCI
 
53
 
 
54
If you have several USB PCI controllers, define
 
55
 
 
56
        CONFIG_PCI_OHCI_DEVNO: number of the OHCI device in PCI list
 
57
 
 
58
If undefined, the first instance found in PCI space will be used.
 
59
 
 
60
PCI Controllers need to do byte swapping on register accesses, so they
 
61
should to define:
 
62
 
 
63
        CONFIG_SYS_OHCI_SWAP_REG_ACCESS