Merge branch 'master' of git://www.denx.de/git/u-boot-fdt
[u-boot-openmoko.git] / board / cogent / README
blobe6eef662c9bbe04781832625f24c2a16dc64558b
1 Cogent Modular Architecture configuration
2 -----------------------------------------
4 As the name suggests, the Cogent platform is a modular system where
5 you have a motherboard into which plugs a cpu module and one or more
6 i/o modules. This provides very nice flexibility, but makes the
7 configuration task somewhat harder.
9 The possible Cogent motherboards are:
11 Code            Config Variable         Description
12 ----            ---------------         -----------
14 CMA101          CONFIG_CMA101           32MB ram, 2 ser, 1 par, rtc, dipsw,
15                                         2x16 lcd, eth(?)
16 CMA102          CONFIG_CMA102           32MB ram, 2 ser, 1 par, rtc, dipsw,
17                                         2x16 lcd
18 CMA111          CONFIG_CMA111           32MB ram, 1MB flash, 4 ser, 1 par,
19                                         rtc, ps/2 kbd/mse, 2x16 lcd, 2xPCI,
20                                         10/100TP eth
21 CMA120          CONFIG_CMA120           32MB ram, 1MB flash, 4 ser, 1 par,
22                                         rtc, ps/2 kbd/mse, 2x16 lcd, 2xPCI,
23                                         10/100TP eth, 2xPCMCIA, video/lcd-panel
24 CMA150          CONFIG_CMA150           8MB ram, 1MB flash, 2 ser, 1 par, rtc,
25                                         ps/2 kbd/mse, 2x16 lcd
27 The possible Cogent PowerPC CPU modules are:
29 Code            Config Variable         Description
30 ----            ---------------         -----------
32 CMA278-603EV    CONFIG_CMA278_603EV     PPC603ev CPU, 66MHz clock, 512K EPROM,
33                                         JTAG/COP
34 CMA278-603ER    CONFIG_CMA278_603ER     PPC603er CPU, 66MHz clock, 512K EPROM,
35                                         JTAG/COP
36 CMA278-740      CONFIG_CMA278_740       PPC740 CPU, 66MHz clock, 512K EPROM,
37                                         JTAG/COP
38 CMA280-509      CONFIG_CMA280_509       MPC505/509 CPU, 50MHz clock,
39                                         512K EPROM, BDM
40 CMA282          CONFIG_CMA282           MPC8260 CPU, 66MHz clock, 512K EPROM,
41                                         JTAG, 16M RAM, 1 x ser (SMC2),
42                                         1 x 10baseT PHY (SCC4), 1 x 10/100 TP
43                                         PHY (FCC1), 2 x 48pin DIN (FCC2 + TDM1)
44 CMA285          CONFIG_CMA285           MPC801 CPU, 33MHz clock, 512K EPROM,
45                                         BDM
46 CMA286-21       CONFIG_CMA286_21        MPC821 CPU, 66MHz clock, 512K EPROM,
47                                         BDM, 16M RAM, 2 x ser (SMC1 + SMC2),
48                                         1 x 10baseT PHY (SCC2)
49 CMA286-60-OLD   CONFIG_CMA286_60_OLD    MPC860 CPU, 33MHz clock, 128K EPROM,
50                                         BDM
51 CMA286-60       CONFIG_CMA286_60        MPC860 CPU, 66MHz clock, 512K EPROM,
52                                         BDM, 16M RAM, 2 x ser (SMC1 + SMC2),
53                                         1 x 10baseT PHY (SCC2)
54 CMA286-60P      CONFIG_CMA286_60P       MPC860P CPU, 66MHz clock, 512K EPROM,
55                                         BDM, 16M RAM, 2 x ser (SMC1 + SMC2),
56                                         1 x 10baseT PHY (SCC2)
57 CMA287-23       CONFIG_CMA287_23        MPC823 CPU, 33MHz clock, 512K EPROM,
58                                         BDM
59 CMA287-50       CONFIG_CMA287_50        MPC850 CPU, 33MHz clock, 512K EPROM,
60                                         BDM
62 (there are a lot of other cpu modules with ARM, MIPS and M-CORE CPUs,
63 but we'll worry about those later).
65 The possible Cogent CMA I/O Modules are:
67 Code            Config Variable         Description
68 ----            ---------------         -----------
70 CMA302          CONFIG_CMA302           up to 16M flash, ps/2 keyboard/mouse
71 CMA352          CONFIG_CMA352           CMAbus <=> PCI
73 Currently supported:
75         Motherboards:   CMA102
76         CPU Modules:    CMA286-60-OLD
77         I/O Modules:    CMA302 I/O module
79 To configure, perform the usual U-Boot configuration task of editing
80 "include/config_cogent_mpc8xx.h" and reviewing all the options and
81 settings in there. In particular, check the chip select values
82 installed into the memory controller's various option and base
83 registers - these are set by the defines CFG_CMA_CSn_{BASE,SIZE} and
84 CFG_{B,O}Rn_PRELIM. Also be careful of the clock settings installed
85 into the SCCR - via the define CFG_SCCR. Finally, decide whether you
86 want the serial console on motherboard serial port A or on one of the
87 8xx SMC ports, and set CONFIG_8xx_CONS_{SMC1,SMC2,NONE} accordingly
88 (NONE means use Cogent motherboard serial port A).
90 Then edit the file "cogent/config.mk". Firstly, set TEXT_BASE to be
91 the base address of the EPROM for the CPU module. This should be the
92 same as the value selected for CFG_MONITOR_BASE in
93 "include/config_cogent_*.h" (in fact, I have made this automatic via
94 the -DTEXT_BASE=... option in CPPFLAGS).
96 Finally, set the values of the make variables $(CMA_MB) and $(CMA_IOMS).
98 $(CMA_MB) is the name of the directory that contains support for your
99 motherboard. At this stage, only "cma10x" exists, which supports the
100 CMA101 and CMA102 motherboards - but only selected devices, namely
101 serial, lcd and dipsw.
103 $(CMA_IOMS) is a list of zero or more directories that contain
104 support for the i/o modules you have installed. At this stage, only
105 "cma302" exists, which supports the CMA302 flash i/o module - but
106 only the flash part, not the ps/2 keyboard and mouse interfaces.
108 There should be a make variable for each of the above directories,
109 which is the directory name with "_O" appended. This make variable is
110 a list of object files to compile from that directory and include in
111 the library.
113         e.g. cma10x_O = serial.o ...
115 That's it. Good Luck.
117 Murray.Jensen@cmst.csiro.au
118 August 31, 2000.