Attention: The current version is completely for developers.
-- Zodiac ----------------------------------------------------------
Description : MSX emulator
version : 0.8.1 -2002/04/05-
Author : SASAKI `eruchan' Shunsuke <eruchan@users.sourceforge.net>
Primary distribution : http://zodiac.sourceforge.net/
Lisence : GNU GENERAL PUBLIC LICENSE Version 2
--------------------------------------------------------------------
The change point which influences it for the user is mentioned in NEWS.jp.
Be sure to confirm it when it is upgraded.
[] Outline
Zodiac is the MSX emulator whose portability is high
with general-purpose structure.
* Feature
o *BSD, Linux, Windows, Mac, BeOS, and so on work in the
various environments.
#However, the current version Operation by BeOS cannot be checked.
* Environment which checked operation.
o FreeBSD(i386) 4.4-STABLE with MGL2-current
o FreeBSD(i386) 4.4-STABLE with SDL-1.2.3
o Kondara MNU/Linux 2.0 with SDL-1.2.0
o MacOS 9.1 with SDL-1.2.1
o NetBSD/hpcmips
o NetBSD/hpcmips with MGL2-alpha-0.2.0
o NetBSD/i386-current with MGL2-alpha-0.2.0
o NetBSD/i386-current with SDL-1.2.1
o Windows2000 with SDL-1.2.3
* Directory structure
o libmd/
This is the library collected around the code which an environment
depended on.
This is independent of Zodiac, and a license is BSD style.
o src/misc/
This is a miscellaneous tool, code kind.
This is independent of Zodiac, and a license is BSD style.
o src/msx/
These is codes of whole MSX.
And codes, such as a peculiar device, are also contained.
o src/v99x8/
These are V99x8 (VDP) device units.
o src/ym2149/
o src/ym2413/
These is YM2149/AYAY-3-8910(PSG) and YM2413(FM) device units.
We are including a code for MSXplug.
Attention This is not GPL.
****
MSXplug - Copyright (C) 2001 Mitsutaka Okazaki.
http://www.angel.ne.jp/~okazaki/ym2413/
This software is provided 'as-is', without any express or implied
warranty.
Permission is granted to anyone to use this software for any purpose,
including commercial applications.
To alter this software and redistribute it freely, if the origin of
this software is not misrepresented, and this notice is not removed
from any source distribution.
****
o src/z80/
This is Z80(CPU) device units.
[] How to Run
First, please take out required BIOS ROM data from real msx.
A method should look at a description site suitably. (^^;
File name It is the same as that of standard things, such as fMSX.
MSX1: MSX.ROM
MSX2: MSX2.ROM MSX2EXT.ROM
MSX2+: MSX2P.ROM MSX2PEXT.ROM
Disk: DISK.ROM
MSX-MUSIC: FMPAC.ROM
MSX-DOS2: MSXDOS2.ROM
Kanji-BASIC: KNJDRV.ROM
* How to Install
sample% ./configure
sample% make
Generated execution file Please move zodiac to your favorite
directory (folder) . Please put in BIOS ROM / Disk image /
ROM image etc. to the same directory.
And please execute.
I am sorry. We haven't written a code for "make install" and an code
for "Related to the storage directory of the image file" yet.
If you use CVS, I want the item of the following CVS seen.
* How to Execute
sample% zodiac [-a disk][-b disk][-f freq][-s percent][-u uperiod]
-a: Disk image file shown by "disk" It inserts in A drive.
-b: Disk image file shown by "disk" It inserts in B drive.
-f: Frequency with which a sound is sounded It specifies by "freq".
-s: It specifies by "percent" what a speed of operation becomes.
When 0 is specified, it is going to perform at top speed,
without performing synchronous processing.
Default is 100%.
-u: Frame skip (the maximum number) It specifies by "uperiod".
In the usual case, when processing is slow, it skips by being
automatic. However, when not carrying out synchronous processing,
a frame skip is performed at a fixed rate.
-B: Sound buffer size is specified in miliseconds.
Default is 50mS. But, when a CPU is slow, you may have to specify
and so on 100mS.
Default: -f22050 -s100 -u2 -B50
* How to finish zodiac
press down [F12] key
[] CVS
The latest source during the development can be updated with CVS,
the acquisition.
*** Important! *********************************************
As for CVS, the state of a real time developer change is expressed as it is.
Keep in mind that it can add a fatal change frequently.
The source code at each time is not necessarily stable.
It may not be able to compile.
http://zodiac.sourceforge.net/diary/ (Japanese)
************************************************************
* The command which is necessary before compiling the source
which it getting with CVS.
The script (configure) which is necessary for the compilation isn't
managed directly with CVS.
Be sure to carry out the following command when you compile the source
which it got with CVS.
Installation of GNU autoconf and automake is needed for execution of that.
sample% ./autogen.sh
�$B!{�(B �$B=i2s$KI,MW$J$*$^$8$J$$�(B (cvs login)
sample% cvs -d:pserver:anonymous@cvs.zodiac.sf.net:/cvsroot/zodiac login
password: <�$B$=$N$^$^%j%?!<%s�(B(Enter key) �$B$r2!$7$F$/$@$5$$�(B>
�$B4pK\E*$K$O!"$3$N%3%^%s%I$O0lEY<B9T$9$l$P0J8e<B9T$9$kI,MW$O$"$j$^$;$s!#�(B
�$B!{�(B �$B%=!<%9$,L5$$;~$K%=!<%9$r0z$CD%$C$F$/$k�(B (cvs checkout)
sample% cvs -d:pserver:anonymous@cvs.zodiac.sf.net:/cvsroot/zodiac checkout zodiac
�$B%3%^%s%I$r<B9T$7$?;~$N%+%l%s%H$N2<$K�(B zodiac �$B$H$$$&%G%#%l%/%H%j$,7!$i$l!"�(B
�$B$=$3$K�(B zodiac �$B$N:G?7$N%=!<%9%3!<%I$,<}$a$i$l$^$9!#�(B
�$B!{�(B �$B%=!<%9$,<j85$K$"$k>l9g$K%=!<%9$r%"%C%W%G!<%H�(B (cvs update)
sample% make distclean
sample% cvs update -Pd
make disclean �$B$GM>7W$J%4%_$rA]=|$7$J$$$H%3%s%Q%$%k;~$K�(B
�$B<:GT$9$k62$l$,$"$k$N$G!"�(Bcvs update �$B$NA0$K$*A]=|$7$^$9!#�(B
* An explanation about detailed CVS
About CVS
http://www-vox.dj.kit.ac.jp/nishi/cvs/cvs.html (Japanese)
http://www.itojun.org/hack/cvs/tut-kernel.html (Japanese)
http://www.kahori.com/j-cvsbook/j-cvsbook.html (Japanese)
See these sites.
�$B$3$l$i$N%5%$%H$r8+$l$P�(B CVS �$B$NA4MF$,DO$a$k$H;W$$$^$9!#�(B
[] Postscript
* The function which is not implemented
o Various kinds MEGAROM correspondence, Automatic recognition of MEGAROM
o mouse
o printer
o RS-232c
o SCC
o Some VDP commands
o Same Z80 operation
o joystick
* An escape clause
This version is on the way to develop it still.
We may change internal structure greatly.
Even the environment where a movement was confirmed can't
necessarily assure a movement.
As for our emulator, illegal use isn't recommended.
gem-hunter