[people/ms/u-boot.git] / board / cogent / README

Cogent Modular Architecture configuration
-----------------------------------------

As the name suggests, the Cogent platform is a modular system where
you have a motherboard into which plugs a cpu module and one or more
i/o modules. This provides very nice flexibility, but makes the
configuration task somewhat harder.

The possible Cogent motherboards are:

Code		Config Variable		Description
----		---------------		-----------

CMA101		CONFIG_CMA101		32MB ram, 2 ser, 1 par, rtc, dipsw,
					2x16 lcd, eth(?)
CMA102		CONFIG_CMA102		32MB ram, 2 ser, 1 par, rtc, dipsw,
					2x16 lcd
CMA111		CONFIG_CMA111		32MB ram, 1MB flash, 4 ser, 1 par,
					rtc, ps/2 kbd/mse, 2x16 lcd, 2xPCI,
					10/100TP eth
CMA120		CONFIG_CMA120		32MB ram, 1MB flash, 4 ser, 1 par,
					rtc, ps/2 kbd/mse, 2x16 lcd, 2xPCI,
					10/100TP eth, 2xPCMCIA, video/lcd-panel
CMA150		CONFIG_CMA150		8MB ram, 1MB flash, 2 ser, 1 par, rtc,
					ps/2 kbd/mse, 2x16 lcd

The possible Cogent PowerPC CPU modules are:

Code		Config Variable		Description
----		---------------		-----------

CMA278-603EV	CONFIG_CMA278_603EV	PPC603ev CPU, 66MHz clock, 512K EPROM,
					JTAG/COP
CMA278-603ER	CONFIG_CMA278_603ER	PPC603er CPU, 66MHz clock, 512K EPROM,
					JTAG/COP
CMA278-740	CONFIG_CMA278_740	PPC740 CPU, 66MHz clock, 512K EPROM,
					JTAG/COP
CMA280-509	CONFIG_CMA280_509	MPC505/509 CPU, 50MHz clock,
					512K EPROM, BDM
CMA282		CONFIG_CMA282		MPC8260 CPU, 66MHz clock, 512K EPROM,
					JTAG, 16M RAM, 1 x ser (SMC2),
					1 x 10baseT PHY (SCC4), 1 x 10/100 TP
					PHY (FCC1), 2 x 48pin DIN (FCC2 + TDM1)
CMA285		CONFIG_CMA285		MPC801 CPU, 33MHz clock, 512K EPROM,
					BDM
CMA286-21	CONFIG_CMA286_21	MPC821 CPU, 66MHz clock, 512K EPROM,
					BDM, 16M RAM, 2 x ser (SMC1 + SMC2),
					1 x 10baseT PHY (SCC2)
CMA286-60-OLD	CONFIG_CMA286_60_OLD	MPC860 CPU, 33MHz clock, 128K EPROM,
					BDM
CMA286-60	CONFIG_CMA286_60	MPC860 CPU, 66MHz clock, 512K EPROM,
					BDM, 16M RAM, 2 x ser (SMC1 + SMC2),
					1 x 10baseT PHY (SCC2)
CMA286-60P	CONFIG_CMA286_60P	MPC860P CPU, 66MHz clock, 512K EPROM,
					BDM, 16M RAM, 2 x ser (SMC1 + SMC2),
					1 x 10baseT PHY (SCC2)
CMA287-23	CONFIG_CMA287_23	MPC823 CPU, 33MHz clock, 512K EPROM,
					BDM
CMA287-50	CONFIG_CMA287_50	MPC850 CPU, 33MHz clock, 512K EPROM,
					BDM

(there are a lot of other cpu modules with ARM, MIPS and M-CORE CPUs,
but we'll worry about those later).

The possible Cogent CMA I/O Modules are:

Code		Config Variable		Description
----		---------------		-----------

CMA302		CONFIG_CMA302		up to 16M flash, ps/2 keyboard/mouse
CMA352		CONFIG_CMA352		CMAbus <=> PCI

Currently supported:

	Motherboards:	CMA102
	CPU Modules:	CMA286-60-OLD
	I/O Modules:	CMA302 I/O module

To configure, perform the usual U-Boot configuration task of editing
"include/config_cogent_mpc8xx.h" and reviewing all the options and
settings in there. In particular, check the chip select values
installed into the memory controller's various option and base
registers - these are set by the defines CONFIG_SYS_CMA_CSn_{BASE,SIZE} and
CONFIG_SYS_{B,O}Rn_PRELIM. Also be careful of the clock settings installed
into the SCCR - via the define CONFIG_SYS_SCCR. Finally, decide whether you
want the serial console on motherboard serial port A or on one of the
8xx SMC ports, and set CONFIG_8xx_CONS_{SMC1,SMC2,NONE} accordingly
(NONE means use Cogent motherboard serial port A).

Then edit the file "cogent/config.mk". Firstly, set CONFIG_SYS_TEXT_BASE to be
the base address of the EPROM for the CPU module. This should be the
same as the value selected for CONFIG_SYS_MONITOR_BASE in
"include/config_cogent_*.h" (in fact, I have made this automatic via
the -CONFIG_SYS_TEXT_BASE=... option in CPPFLAGS).

Finally, set the values of the make variables $(CMA_MB) and $(CMA_IOMS).

$(CMA_MB) is the name of the directory that contains support for your
motherboard. At this stage, only "cma10x" exists, which supports the
CMA101 and CMA102 motherboards - but only selected devices, namely
serial, lcd and dipsw.

$(CMA_IOMS) is a list of zero or more directories that contain
support for the i/o modules you have installed. At this stage, only
"cma302" exists, which supports the CMA302 flash i/o module - but
only the flash part, not the ps/2 keyboard and mouse interfaces.

There should be a make variable for each of the above directories,
which is the directory name with "_O" appended. This make variable is
a list of object files to compile from that directory and include in
the library.

	e.g. cma10x_O = serial.o ...

That's it. Good Luck.

Murray.Jensen@cmst.csiro.au
August 31, 2000.
Commit	Line	Data
7ebf7443 WD	1	Cogent Modular Architecture configuration
	2	-----------------------------------------
	3
	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.
	8
	9	The possible Cogent motherboards are:
	10
	11	Code Config Variable Description
	12	---- --------------- -----------
	13
	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
	26
	27	The possible Cogent PowerPC CPU modules are:
	28
	29	Code Config Variable Description
	30	---- --------------- -----------
	31
	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
	61
	62	(there are a lot of other cpu modules with ARM, MIPS and M-CORE CPUs,
	63	but we'll worry about those later).
	64
65	The possible Cogent CMA I/O Modules are:
66
67	Code Config Variable Description
68	---- --------------- -----------
69
70	CMA302 CONFIG_CMA302 up to 16M flash, ps/2 keyboard/mouse
71	CMA352 CONFIG_CMA352 CMAbus <=> PCI
72
73	Currently supported:
74
75	Motherboards: CMA102
76	CPU Modules: CMA286-60-OLD
77	I/O Modules: CMA302 I/O module
78
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
6d0f6bcf JCPV	83	registers - these are set by the defines CONFIG_SYS_CMA_CSn_{BASE,SIZE} and
	84	CONFIG_SYS_{B,O}Rn_PRELIM. Also be careful of the clock settings installed
	85	into the SCCR - via the define CONFIG_SYS_SCCR. Finally, decide whether you
7ebf7443 WD	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).
	89
14d0a02a	90	Then edit the file "cogent/config.mk". Firstly, set CONFIG_SYS_TEXT_BASE to be
7ebf7443	91	the base address of the EPROM for the CPU module. This should be the
6d0f6bcf	92	same as the value selected for CONFIG_SYS_MONITOR_BASE in
7ebf7443	93	"include/config_cogent_*.h" (in fact, I have made this automatic via
14d0a02a	94	the -CONFIG_SYS_TEXT_BASE=... option in CPPFLAGS).
7ebf7443 WD	95
	96	Finally, set the values of the make variables $(CMA_MB) and $(CMA_IOMS).
	97
	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.
	102
	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.
	107
	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.
	112
	113	e.g. cma10x_O = serial.o ...
	114
	115	That's it. Good Luck.
	116
	117	Murray.Jensen@cmst.csiro.au
	118	August 31, 2000.