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

U-Boot for a Musenki M-3/M-1 board
---------------------------

Musenki M-1 and M-3 have two banks of flash of 4MB or 8MB each.

In board's notation, bank 0 is the one at the address of 0xFF800000
and bank 1 is the one at the address of 0xFF000000.

On power-up the processor jumps to the address of 0xFFF00100, the last
megabyte of the bank 0 of flash.

Thus, U-Boot is configured to reside in flash starting at the address of
0xFFF00000.  The environment space is located in flash separately from
U-Boot, at the address of 0xFF800000.

There is a Davicom 9102A on-board, but I don't have it working yet.

U-Boot test results
--------------------

x.x Operation on all available serial consoles

x.x.x CONFIG_CONS_INDEX 1


U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)

CPU:   MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
Board: MUSENKI Local Bus at 100 MHz
DRAM:  32 MB
FLASH:  4 MB
In:    serial
Out:   serial
Err:   serial
Hit any key to stop autoboot:  0
=> help
base    - print or set address offset
bdinfo  - print Board Info structure
bootm   - boot application image from memory
bootp   - boot image via network using BootP/TFTP protocol
bootd   - boot default, i.e., run 'bootcmd'
cmp     - memory compare
coninfo - print console devices and informations
cp      - memory copy
crc32   - checksum calculation
dcache  - enable or disable data cache
echo    - echo args to console
erase   - erase FLASH memory
flinfo  - print FLASH memory information
go      - start application at address 'addr'
help    - print online help
icache  - enable or disable instruction cache
iminfo  - print header information for application image
loadb   - load binary file over serial line (kermit mode)
loads   - load S-Record file over serial line
loop    - infinite loop on address range
md      - memory display
mm      - memory modify (auto-incrementing)
mtest   - simple RAM test
mw      - memory write (fill)
nm      - memory modify (constant address)
printenv- print environment variables
protect - enable or disable FLASH write protection
rarpboot- boot image via network using RARP/TFTP protocol
reset   - Perform RESET of the CPU
run     - run commands in an environment variable
saveenv - save environment variables to persistent storage
setenv  - set environment variables
source  - run script from memory
tftpboot- boot image via network using TFTP protocol
	       and env variables ipaddr and serverip
version - print monitor version
?       - alias for 'help'


x.x.x CONFIG_CONS_INDEX 2

**** NOT TESTED ****

x.x Flash Driver Operation


Boot 1.1.1 (Nov 20 2001 - 15:55:32)

CPU:   MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
Board: MUSENKI Local Bus at 100 MHz
DRAM:  32 MB
FLASH:  4 MB
*** Warning - bad CRC, using default environment

In:    serial
Out:   serial
Err:   serial
Hit any key to stop autoboot:  0
=>
=> md ff800000
ff800000: 46989bf8 626f6f74 636d643d 626f6f74    F...bootcmd=boot
ff800010: 6d204646 38323030 30300062 6f6f7464    m FF820000.bootd
ff800020: 656c6179 3d350062 61756472 6174653d    elay=5.baudrate=
ff800030: 39363030 00636c6f 636b735f 696e5f6d    9600.clocks_in_m
ff800040: 687a3d31 00737464 696e3d73 65726961    hz=1.stdin=seria
ff800050: 6c007374 646f7574 3d736572 69616c00    l.stdout=serial.
ff800060: 73746465 72723d73 65726961 6c006970    stderr=serial.ip
ff800070: 61646472 3d313932 2e313638 2e302e34    addr=192.168.0.4
ff800080: 32007365 72766572 69703d31 39322e31    2.serverip=192.1
ff800090: 36382e30 2e380000 00000000 00000000    68.0.8..........
ff8000a0: 00000000 00000000 00000000 00000000    ................
ff8000b0: 00000000 00000000 00000000 00000000    ................
ff8000c0: 00000000 00000000 00000000 00000000    ................
ff8000d0: 00000000 00000000 00000000 00000000    ................
ff8000e0: 00000000 00000000 00000000 00000000    ................
ff8000f0: 00000000 00000000 00000000 00000000    ................
=> protect off ff800000 ff81ffff
Un-Protected 1 sectors
=> erase ff800000 ff81ffff
Erase Flash from 0xff800000 to 0xff81ffff
 done
Erased 1 sectors
=> md ff800000
ff800000: ffffffff ffffffff ffffffff ffffffff    ................
ff800010: ffffffff ffffffff ffffffff ffffffff    ................
ff800020: ffffffff ffffffff ffffffff ffffffff    ................
ff800030: ffffffff ffffffff ffffffff ffffffff    ................
ff800040: ffffffff ffffffff ffffffff ffffffff    ................
ff800050: ffffffff ffffffff ffffffff ffffffff    ................
ff800060: ffffffff ffffffff ffffffff ffffffff    ................
ff800070: ffffffff ffffffff ffffffff ffffffff    ................
ff800080: ffffffff ffffffff ffffffff ffffffff    ................
ff800090: ffffffff ffffffff ffffffff ffffffff    ................
ff8000a0: ffffffff ffffffff ffffffff ffffffff    ................
ff8000b0: ffffffff ffffffff ffffffff ffffffff    ................
ff8000c0: ffffffff ffffffff ffffffff ffffffff    ................
ff8000d0: ffffffff ffffffff ffffffff ffffffff    ................
ff8000e0: ffffffff ffffffff ffffffff ffffffff    ................
ff8000f0: ffffffff ffffffff ffffffff ffffffff    ................

x.x.x Information


U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)

CPU:   MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
Board: MUSENKI Local Bus at 100 MHz
DRAM:  32 MB
FLASH:  4 MB
*** Warning - bad CRC, using default environment

In:    serial
Out:   serial
Err:   serial
Hit any key to stop autoboot:  0
=> flinfo

Bank # 1: Intel 28F320J3A (32Mbit = 128K x 32)
  Size: 4 MB in 32 Sectors
  Sector Start Addresses:
    FF800000 (RO) FF820000      FF840000      FF860000      FF880000
    FF8A0000      FF8C0000      FF8E0000      FF900000      FF920000
    FF940000      FF960000      FF980000      FF9A0000      FF9C0000
    FF9E0000      FFA00000      FFA20000      FFA40000      FFA60000
    FFA80000      FFAA0000      FFAC0000      FFAE0000      FFB00000
    FFB20000      FFB40000      FFB60000      FFB80000      FFBA0000
    FFBC0000      FFBE0000

Bank # 2: missing or unknown FLASH type
=>


x.x.x Flash Programming


U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)

CPU:   MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
Board: MUSENKI Local Bus at 100 MHz
DRAM:  32 MB
FLASH:  4 MB

In:    serial
Out:   serial
Err:   serial
Hit any key to stop autoboot:  0
=>
=>
=>
=> protect off ff800000 ff81ffff
Un-Protected 1 sectors
=> cp 0 ff800000 20
Copy to Flash... done
=> md ff800000
ff800000: 37ce33ec 33cc334c 33c031cc 33cc35cc    7.3.3.3L3.1.3.5.
ff800010: 33ec13ce 30ccb3ec b3c833c4 31c836cc    3...0.....3.1.6.
ff800020: 33cc3b9d 31ec33ee 13ecf3cc 338833ec    3.;.1.3.....3.3.
ff800030: 234c33ec 32cc22cc 33883bdc 534433cc    #L3.2.".3.;.SD3.
ff800040: 33cc30c8 31cc32ec 338c33cc 330c33dc    3.0.1.2.3.3.3.3.
ff800050: 33cc13dc 334c534c b1c433d8 128c13cc    3...3LSL..3.....
ff800060: 37ec36cd 33dc33cc bbc9f7e8 bbcc77cc    7.6.3.3.......w.
ff800070: 314c0adc 139c30ed 33cc334c 33c833ec    1L....0.3.3L3.3.
ff800080: ffffffff ffffffff ffffffff ffffffff    ................
ff800090: ffffffff ffffffff ffffffff ffffffff    ................
ff8000a0: ffffffff ffffffff ffffffff ffffffff    ................
ff8000b0: ffffffff ffffffff ffffffff ffffffff    ................
ff8000c0: ffffffff ffffffff ffffffff ffffffff    ................
ff8000d0: ffffffff ffffffff ffffffff ffffffff    ................
ff8000e0: ffffffff ffffffff ffffffff ffffffff    ................
ff8000f0: ffffffff ffffffff ffffffff ffffffff    ................


x.x.x Storage of environment variables in flash


U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)

CPU:   MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
Board: MUSENKI Local Bus at 100 MHz
DRAM:  32 MB
FLASH:  4 MB
In:    serial
Out:   serial
Err:   serial
Hit any key to stop autoboot:  0
=> printenv
bootcmd=bootm FF820000
bootdelay=5
baudrate=9600
clocks_in_mhz=1
stdin=serial
stdout=serial
stderr=serial

Environment size: 106/16380 bytes
=> setenv myvar 1234
=> saveenv
Un-Protected 1 sectors
Erasing Flash...
 done
Erased 1 sectors
Saving Environment to Flash...
Protected 1 sectors
=> reset


U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)

CPU:   MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
Board: MUSENKI Local Bus at 100 MHz
DRAM:  32 MB
FLASH:  4 MB
In:    serial
Out:   serial
Err:   serial
Hit any key to stop autoboot:  0
=> printenv
bootcmd=bootm FF820000
bootdelay=5
baudrate=9600
clocks_in_mhz=1
myvar=1234
stdin=serial
stdout=serial
stderr=serial

Environment size: 117/16380 bytes

x.x Image Download and run over serial port


U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)

CPU:   MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
Board: MUSENKI Local Bus at 100 MHz
DRAM:  32 MB
FLASH:  4 MB
In:    serial
Out:   serial
Err:   serial
Hit any key to stop autoboot:  0
=> loads
## Ready for S-Record download ...

## First Load Addr = 0x00040000
## Last  Load Addr = 0x00050177
## Total Size      = 0x00010178 = 65912 Bytes
## Start Addr      = 0x00040004
=> go 40004
## Starting application at 0x00040004 ...
Hello World
argc = 1
argv[0] = "40004"
argv[1] = "<NULL>"
Hit any key to exit ...

## Application terminated, rc = 0x0


x.x Image download and run over ethernet interface

untested (not working yet, actually)
Commit	Line	Data
e2211743 WD	1	U-Boot for a Musenki M-3/M-1 board
	2	---------------------------
	3
	4	Musenki M-1 and M-3 have two banks of flash of 4MB or 8MB each.
	5
	6	In board's notation, bank 0 is the one at the address of 0xFF800000
	7	and bank 1 is the one at the address of 0xFF000000.
	8
	9	On power-up the processor jumps to the address of 0xFFF00100, the last
	10	megabyte of the bank 0 of flash.
	11
	12	Thus, U-Boot is configured to reside in flash starting at the address of
	13	0xFFF00000. The environment space is located in flash separately from
	14	U-Boot, at the address of 0xFF800000.
	15
	16	There is a Davicom 9102A on-board, but I don't have it working yet.
	17
	18	U-Boot test results
	19	--------------------
	20
	21	x.x Operation on all available serial consoles
	22
	23	x.x.x CONFIG_CONS_INDEX 1
	24
	25
	26	U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)
	27
	28	CPU: MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
	29	Board: MUSENKI Local Bus at 100 MHz
	30	DRAM: 32 MB
	31	FLASH: 4 MB
	32	In: serial
	33	Out: serial
	34	Err: serial
	35	Hit any key to stop autoboot: 0
	36	=> help
e2211743 WD	37	base - print or set address offset
	38	bdinfo - print Board Info structure
	39	bootm - boot application image from memory
	40	bootp - boot image via network using BootP/TFTP protocol
	41	bootd - boot default, i.e., run 'bootcmd'
	42	cmp - memory compare
	43	coninfo - print console devices and informations
	44	cp - memory copy
	45	crc32 - checksum calculation
	46	dcache - enable or disable data cache
	47	echo - echo args to console
	48	erase - erase FLASH memory
	49	flinfo - print FLASH memory information
	50	go - start application at address 'addr'
	51	help - print online help
	52	icache - enable or disable instruction cache
	53	iminfo - print header information for application image
	54	loadb - load binary file over serial line (kermit mode)
	55	loads - load S-Record file over serial line
	56	loop - infinite loop on address range
	57	md - memory display
	58	mm - memory modify (auto-incrementing)
	59	mtest - simple RAM test
	60	mw - memory write (fill)
	61	nm - memory modify (constant address)
	62	printenv- print environment variables
	63	protect - enable or disable FLASH write protection
	64	rarpboot- boot image via network using RARP/TFTP protocol
	65	reset - Perform RESET of the CPU
	66	run - run commands in an environment variable
	67	saveenv - save environment variables to persistent storage
	68	setenv - set environment variables
3202d331	69	source - run script from memory
e2211743	70	tftpboot- boot image via network using TFTP protocol
8bde7f77	71	and env variables ipaddr and serverip
e2211743 WD	72	version - print monitor version
	73	? - alias for 'help'
	74
	75
e2211743 WD	76	x.x.x CONFIG_CONS_INDEX 2
	77
	78	** NOT TESTED **
	79
	80	x.x Flash Driver Operation
	81
	82
	83	Boot 1.1.1 (Nov 20 2001 - 15:55:32)
	84
	85	CPU: MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
	86	Board: MUSENKI Local Bus at 100 MHz
	87	DRAM: 32 MB
	88	FLASH: 4 MB
	89	*** Warning - bad CRC, using default environment
	90
	91	In: serial
	92	Out: serial
	93	Err: serial
	94	Hit any key to stop autoboot: 0
	95	=>
	96	=> md ff800000
	97	ff800000: 46989bf8 626f6f74 636d643d 626f6f74 F...bootcmd=boot
	98	ff800010: 6d204646 38323030 30300062 6f6f7464 m FF820000.bootd
	99	ff800020: 656c6179 3d350062 61756472 6174653d elay=5.baudrate=
	100	ff800030: 39363030 00636c6f 636b735f 696e5f6d 9600.clocks_in_m
	101	ff800040: 687a3d31 00737464 696e3d73 65726961 hz=1.stdin=seria
	102	ff800050: 6c007374 646f7574 3d736572 69616c00 l.stdout=serial.
	103	ff800060: 73746465 72723d73 65726961 6c006970 stderr=serial.ip
	104	ff800070: 61646472 3d313932 2e313638 2e302e34 addr=192.168.0.4
	105	ff800080: 32007365 72766572 69703d31 39322e31 2.serverip=192.1
	106	ff800090: 36382e30 2e380000 00000000 00000000 68.0.8..........
	107	ff8000a0: 00000000 00000000 00000000 00000000 ................
	108	ff8000b0: 00000000 00000000 00000000 00000000 ................
	109	ff8000c0: 00000000 00000000 00000000 00000000 ................
	110	ff8000d0: 00000000 00000000 00000000 00000000 ................
	111	ff8000e0: 00000000 00000000 00000000 00000000 ................
	112	ff8000f0: 00000000 00000000 00000000 00000000 ................
	113	=> protect off ff800000 ff81ffff
	114	Un-Protected 1 sectors
	115	=> erase ff800000 ff81ffff
	116	Erase Flash from 0xff800000 to 0xff81ffff
	117	done
	118	Erased 1 sectors
	119	=> md ff800000
	120	ff800000: ffffffff ffffffff ffffffff ffffffff ................
	121	ff800010: ffffffff ffffffff ffffffff ffffffff ................
	122	ff800020: ffffffff ffffffff ffffffff ffffffff ................
	123	ff800030: ffffffff ffffffff ffffffff ffffffff ................
	124	ff800040: ffffffff ffffffff ffffffff ffffffff ................
	125	ff800050: ffffffff ffffffff ffffffff ffffffff ................
	126	ff800060: ffffffff ffffffff ffffffff ffffffff ................
	127	ff800070: ffffffff ffffffff ffffffff ffffffff ................
	128	ff800080: ffffffff ffffffff ffffffff ffffffff ................
	129	ff800090: ffffffff ffffffff ffffffff ffffffff ................
	130	ff8000a0: ffffffff ffffffff ffffffff ffffffff ................
	131	ff8000b0: ffffffff ffffffff ffffffff ffffffff ................
	132	ff8000c0: ffffffff ffffffff ffffffff ffffffff ................
	133	ff8000d0: ffffffff ffffffff ffffffff ffffffff ................
	134	ff8000e0: ffffffff ffffffff ffffffff ffffffff ................
	135	ff8000f0: ffffffff ffffffff ffffffff ffffffff ................
	136
	137	x.x.x Information
	138
	139
140	U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)
141
142	CPU: MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
143	Board: MUSENKI Local Bus at 100 MHz
144	DRAM: 32 MB
145	FLASH: 4 MB
146	*** Warning - bad CRC, using default environment
147
148	In: serial
149	Out: serial
150	Err: serial
151	Hit any key to stop autoboot: 0
152	=> flinfo
153
154	Bank # 1: Intel 28F320J3A (32Mbit = 128K x 32)
155	Size: 4 MB in 32 Sectors
156	Sector Start Addresses:
157	FF800000 (RO) FF820000 FF840000 FF860000 FF880000
158	FF8A0000 FF8C0000 FF8E0000 FF900000 FF920000
159	FF940000 FF960000 FF980000 FF9A0000 FF9C0000
160	FF9E0000 FFA00000 FFA20000 FFA40000 FFA60000
161	FFA80000 FFAA0000 FFAC0000 FFAE0000 FFB00000
162	FFB20000 FFB40000 FFB60000 FFB80000 FFBA0000
163	FFBC0000 FFBE0000
164
165	Bank # 2: missing or unknown FLASH type
166	=>
167
168
e2211743 WD	169	x.x.x Flash Programming
	170
	171
	172	U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)
	173
	174	CPU: MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
	175	Board: MUSENKI Local Bus at 100 MHz
	176	DRAM: 32 MB
	177	FLASH: 4 MB
	178
	179	In: serial
	180	Out: serial
	181	Err: serial
	182	Hit any key to stop autoboot: 0
	183	=>
	184	=>
	185	=>
	186	=> protect off ff800000 ff81ffff
	187	Un-Protected 1 sectors
	188	=> cp 0 ff800000 20
	189	Copy to Flash... done
	190	=> md ff800000
	191	ff800000: 37ce33ec 33cc334c 33c031cc 33cc35cc 7.3.3.3L3.1.3.5.
	192	ff800010: 33ec13ce 30ccb3ec b3c833c4 31c836cc 3...0.....3.1.6.
	193	ff800020: 33cc3b9d 31ec33ee 13ecf3cc 338833ec 3.;.1.3.....3.3.
	194	ff800030: 234c33ec 32cc22cc 33883bdc 534433cc #L3.2.".3.;.SD3.
	195	ff800040: 33cc30c8 31cc32ec 338c33cc 330c33dc 3.0.1.2.3.3.3.3.
	196	ff800050: 33cc13dc 334c534c b1c433d8 128c13cc 3...3LSL..3.....
	197	ff800060: 37ec36cd 33dc33cc bbc9f7e8 bbcc77cc 7.6.3.3.......w.
	198	ff800070: 314c0adc 139c30ed 33cc334c 33c833ec 1L....0.3.3L3.3.
	199	ff800080: ffffffff ffffffff ffffffff ffffffff ................
	200	ff800090: ffffffff ffffffff ffffffff ffffffff ................
	201	ff8000a0: ffffffff ffffffff ffffffff ffffffff ................
	202	ff8000b0: ffffffff ffffffff ffffffff ffffffff ................
	203	ff8000c0: ffffffff ffffffff ffffffff ffffffff ................
	204	ff8000d0: ffffffff ffffffff ffffffff ffffffff ................
	205	ff8000e0: ffffffff ffffffff ffffffff ffffffff ................
	206	ff8000f0: ffffffff ffffffff ffffffff ffffffff ................
	207
	208
	209	x.x.x Storage of environment variables in flash
	210
	211
	212	U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)
	213
	214	CPU: MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
	215	Board: MUSENKI Local Bus at 100 MHz
	216	DRAM: 32 MB
	217	FLASH: 4 MB
	218	In: serial
	219	Out: serial
	220	Err: serial
	221	Hit any key to stop autoboot: 0
	222	=> printenv
	223	bootcmd=bootm FF820000
	224	bootdelay=5
	225	baudrate=9600
	226	clocks_in_mhz=1
	227	stdin=serial
	228	stdout=serial
	229	stderr=serial
	230
	231	Environment size: 106/16380 bytes
	232	=> setenv myvar 1234
233	=> saveenv
234	Un-Protected 1 sectors
235	Erasing Flash...
236	done
237	Erased 1 sectors
238	Saving Environment to Flash...
239	Protected 1 sectors
240	=> reset
241
242
243	U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)
244
245	CPU: MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
246	Board: MUSENKI Local Bus at 100 MHz
247	DRAM: 32 MB
248	FLASH: 4 MB
249	In: serial
250	Out: serial
251	Err: serial
252	Hit any key to stop autoboot: 0
253	=> printenv
254	bootcmd=bootm FF820000
255	bootdelay=5
256	baudrate=9600
257	clocks_in_mhz=1
258	myvar=1234
259	stdin=serial
260	stdout=serial
261	stderr=serial
262
263	Environment size: 117/16380 bytes
264
265	x.x Image Download and run over serial port
266
267
268	U-Boot 1.1.1 (Nov 20 2001 - 15:55:32)
269
270	CPU: MPC8245 Revision 16.20 at 250 MHz: 16 kB I-Cache 16 kB D-Cache
271	Board: MUSENKI Local Bus at 100 MHz
272	DRAM: 32 MB
273	FLASH: 4 MB
274	In: serial
275	Out: serial
276	Err: serial
277	Hit any key to stop autoboot: 0
278	=> loads
279	## Ready for S-Record download ...
280
281	## First Load Addr = 0x00040000
282	## Last Load Addr = 0x00050177
283	## Total Size = 0x00010178 = 65912 Bytes
284	## Start Addr = 0x00040004
285	=> go 40004
286	## Starting application at 0x00040004 ...
287	Hello World
288	argc = 1
289	argv[0] = "40004"
290	argv[1] = "<NULL>"
291	Hit any key to exit ...
292
293	## Application terminated, rc = 0x0
294
295
296	x.x Image download and run over ethernet interface
297
298	untested (not working yet, actually)