/[gxemul]/trunk/README
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Annotation of /trunk/README

Parent Directory Parent Directory | Revision Log Revision Log

Revision 40 - (hide annotations)
Mon Oct 8 16:22:11 2007 UTC (16 years, 6 months ago) by dpavlin
File size: 3333 byte(s) 
++ trunk/HISTORY	(local)
$Id: HISTORY,v 1.1539 2007/05/01 04:03:51 debug Exp $
20070415	Landisk PCLOCK should be 33.33 MHz, not 50 MHz. (This makes
		the clock run at correct speed.)
		FINALLY found and fixed the bug which caused OpenBSD/landisk
		to randomly bug out: an &-sign was missing in the special case
		handling of FPSCR in the 'LDS.L @Rm+,FPSCR' instruction.
		Adding similar special case handling for 'LDC.L @Rm+,SR'
		(calling sh_update_sr() instead of just loading).
		Implementing the 'FCNVSD FPUL,DRn' and 'FCNVDS DRm,FPUL'
		SuperH instructions.
		The 'LDC Rm,SR' instruction now immediately breaks out of the
		dyntrans loop if an interrupt is to be triggered.
20070416	In memory_rw.c, if mapping a page as writable, make sure to
		invalidate code translations even if the data access was a
		read.
		Minor SuperH updates.
20070418	Removing the dummy M68K emulation mode.
		Minor SH update (turning unnecessary sts_mach_rn, sts_macl_rn,
		and sts_pr_rn instruction handlers into mov_rm_rn).
20070419	Beginning to add a skeleton for an M88K mode: Adding a hack to
		allow OpenBSD/m88k a.out binaries to be loaded, and disassembly
		of a few simple 88K instructions.
		Commenting out the 'LDC Rm,SR' fix from a few days ago, because
		it made Linux/dreamcast bug out.
		Adding a hack to dev_sh4.c (an extra translation cache
		invalidation), which allows OpenBSD/landisk to boot ok after
		an install. Upgrading the Landisk machine mode to stable,
		updating documentation, etc.
20070420	Experimenting with adding a PCI controller (pcic) to dev_sh4.
		Adding a dummy Realtek 8139C+ skeleton device (dev_rtl8139c).
		Implementing the first M88K instructions (br, or[.u] imm), and
		adding disassembly of some more instructions.
20070421	Continuing a little on dev_rtl8139c.
20070422	Implementing the 9346 EEPROM "read" command for dev_rtl8139c.
		Finally found and fixed an old bug in the log n symbol search
		(it sometimes missed symbols). Debug trace (-i, -t etc) should
		now show more symbols. :-)
20070423	Continuing a little on M88K disassembly.
20070428	Fixing a memset arg order bug in src/net/net.c (thanks to
		Nigel Horne for noticing the bug).
		Applying parts of a patch from Carl van Schaik to clear out
		bottom bits of MIPS addresses more correctly, when using large
		page sizes, and doing some other minor cleanup/refactoring.
		Fixing a couple of warnings given by gcc with the -W option (a
		few more warnings than just plain -Wall).
		Reducing SuperH dyntrans physical address space from 64-bit to
		32-bit (since SH5/SH64 isn't imlemented yet anyway).
		Adding address-to-symbol annotation to a few more instructions
		in the SuperH instruction trace output.
		Beginning regression testing for the next release.
		Reverting the value of SCIF_DELAYED_TX_VALUE from 1 to 2,
		because OpenBSD/landisk may otherwise hang randomly.
20070429	The ugly hack/workaround to get OpenBSD/landisk booting without
		crashing does NOT work anymore (with the April 21 snapshot
		of OpenBSD/landisk). Strangely enough, removing the hack
		completely causes OpenBSD/landisk to work (!).
		More regression testing (re-testing everything SuperH-related,
		and some other things).
		Cobalt interrupts were actually broken; fixing by commenting
		out the DEC21143s in the Cobalt machine.
20070430	More regression testing.
20070501	Updating the OpenBSD/landisk install instructions to use
		4.1 instead of the current snapshot.
		GAAAH! OpenBSD/landisk 4.1 _needs_ the ugly hack/workaround;
		reintroducing it again. (The 4.1 kernel is actually from
		2007-03-11.)
		Simplifying the NetBSD/evbarm install instructions a bit.
		More regression testing.

==============  RELEASE 0.4.5.1  ==============
1 dpavlin 40 Gavare's eXperimental Emulator -- GXemul 0.4.5.1
2     ====================================================
3 dpavlin 2
4 dpavlin 34 Copyright (C) 2003-2007 Anders Gavare.
5 dpavlin 2
6    
7 dpavlin 24 Overview -- What is GXemul?
8     -----------------------------
9 dpavlin 2
10 dpavlin 14 GXemul is an experimental instruction-level machine emulator. Several
11     emulation modes are available. In some modes, processors and surrounding
12 dpavlin 12 hardware components are emulated well enough to let unmodified operating
13     systems (e.g. NetBSD) run as if they were running on a real machine.
14 dpavlin 2
15 dpavlin 40 Processors (ARM, MIPS, PowerPC, and SuperH) are emulated using dynamic
16 dpavlin 34 translation. Unlike some other dynamically translating emulators, GXemul
17     does not need to generate native code, only a "runnable intermediate
18     representation", and will thus run on any host architecture.
19 dpavlin 2
20 dpavlin 34 The documentation lists the machines and guest operating systems that can
21     be regarded as "working" in GXemul. The best working guest operating
22     systems are probably NetBSD/pmax and NetBSD/cats.
23    
24 dpavlin 24 Possible uses of the emulator include:
25 dpavlin 12
26 dpavlin 24 o) educational purposes, e.g. to learn how to write code for MIPS
27 dpavlin 20
28 dpavlin 24 o) hobby operating system development; the emulator can be used as a
29     complement to testing your code on real hardware
30    
31     o) running guest operating systems in a "sandboxed" environment
32    
33     o) compiling your source code inside a guest operating system which you
34     otherwise would not have access to (e.g. various exotic ports of
35     NetBSD), to make sure that your source code is portable to those
36     platforms
37    
38     o) simulating (ethernet) networks of computers running various
39     operating systems, to study their interaction with each other
40    
41     o) debugging code in general
42    
43     Use your imagination :-)
44    
45    
46     GXemul's limitations
47     --------------------
48    
49     o) GXemul is not (in general) a cycle-accurate simulator, because it does
50     not simulate things smaller than an instruction. Pipe-line stalls,
51     instruction latency effects etc. are more or less completely ignored.
52    
53     o) Hardware devices have been implemented in an ad-hoc and as-needed
54     manner, usually only enough to fool certain guest operating systems
55     (e.g. NetBSD) that the hardware devices exist and function well
56     enough for those guest operating systems to use them.
57    
58     A consequence of this is that a machine mode may be implemented well
59     enough to run NetBSD for that machine mode, but other guest operating
60     systems may not run at all, or behave strangely.
61    
62    
63 dpavlin 2 Quick start
64     -----------
65    
66 dpavlin 4 To compile, type './configure' and then 'make'. This should work on most
67 dpavlin 28 Unix-like systems. If it does not, then please mail me a bug report.
68 dpavlin 2
69 dpavlin 24 You might want to experiment with various CC and CFLAGS environment
70     variable settings, to get optimum performance.
71    
72 dpavlin 10 If you are impatient, and want to try out running a guest operating system
73 dpavlin 22 inside GXemul, read this: doc/guestoses.html#netbsdcatsinstall
74 dpavlin 2
75 dpavlin 10 If you want to use GXemul for experimenting with code of your own,
76     then I suggest you compile a Hello World program according to the tips
77     listed here: doc/experiments.html#hello
78 dpavlin 2
79 dpavlin 10 Please read the rest of the documentation in the doc/ sub-directory for
80     more detailed information on how to use the emulator.
81    
82    
83 dpavlin 2 Feedback
84     --------
85    
86     If you have found GXemul useful in some way, or feel like sending me
87     comments or feedback in general, then mail me at anders(at)gavare.se.
88    
  ViewVC Help
Powered by ViewVC 1.1.26