PERFORCE change 103834 for review

[Oleksandr Tymoshenko]

http://perforce.freebsd.org/chv.cgi?CH=103834

Change 103834 by gonzo at gonzo_hq on 2006/08/14 12:58:36

	o Add link/information for gxemul 0.4.1 patch 
	    that made gxemul work with p4 tree.
	o Add disk image generation/usage information.

Affected files ...

.. //depot/projects/mips2/src/EMULATION#2 edit

Differences ...

==== //depot/projects/mips2/src/EMULATION#2 (text+ko) ====

@@ -22,7 +22,7 @@
 Now you have tool required to cross-compile the kernel. It's how it's done:
 
 	make TARGET_ARCH=mips NO_MODULES=yes \
-		MIPS_LITTLE_ENDIAN=yes buildkernel KERNCONF=QEMU
+		MIPS_LITTLE_ENDIAN=yes buildkernel KERNCONF=MALTA
 
 Each time we bring a change to the tree, you'll be forced to synchronize
 with it (p4 sync command) and rebuild (so repeat last step).
@@ -30,7 +30,24 @@
 Installation of GXemul
 ----------------------
 
-	cd /usr/ports/emulators/gxemul && make && make install clean
+	Get GXemul 0.4.1 from 
+	    http://gavare.se/gxemul/src/gxemul-0.4.1.tar.gz
+
+	Apply following patch (see changes below)
+	    http://gonzo.kiev.ua/mips/freebsd-gxemul-0.4.1.patch
+	    - ATA ERROR register on power up should be 1
+	    - Do not reset ATA ERROR register on read (there is no
+		such requirement in specs).
+	    - Mark ATA device as legacy device with fixed resources
+	        IRQ14, IO ports etc. for gxemul does not report
+		wdc resources.
+	    - Change words order for 4-bytes values of ata identify 
+	        struct. they seemed to be in wrong order.
+	    - Set EPC if in EXCL mode. This is temporary hack till 
+	        we will check it with spec/real hardware though this 
+		change hasn't broken linux/netbsd support.
+
+	./configure && make && ... save gxemul binary somewhere
 
 Running
 -------
@@ -45,5 +62,13 @@
 	-v stands for verbose. 
 
 We're emulating Malta board and 4Kc processor, thus -e malta -C 4Kc is used.
-Image is set with -d /dev/null, since we don't need it at this stage.
-'kernel' is your kernel image.
+
+Also you can create disk image to play with. Something like this commands 
+sequence :
+	dd if=/dev/zero of=mips.img bs=128M count=4
+	mdconfig -a -f mips.img
+	fdisk -I /dev/md0
+	disklabel -w /dev/md0s1 auto
+	newfs /dev/md0s1a
+	mdconfig -d -u 0
+Then just change "-d /dev/null" to "-d i:/path/to/mips.img".