OSDN Git Service

[VM][General] Merge updtream 2015-11-18.
[csp-qt/common_source_project-fm7.git] / readme_fm7.txt
1 ** FM-7 series  emulator for common source code project. **
2                                                Oct 29, 2015
3                    K.Ohta <whatisthis.sowhat _at_ gmail.com>
4
5 1.Background
6   Major FM-7 series emulator, XM7 is closed source code, not FOSS.
7   But, I was porting to SDL/Agar toolkit.[1]
8   This has many of bugs inheritated from Agar Toolkit.
9   And, I wish to distribute FM-7 emulator with FOSS license,
10   cause of copyright violation issue by MESS.
11   So, I decided to build FM-7 emulator to Common Source Code
12   Project [2], this is distributed with GPLv2.
13
14   [1] https://github.com/Artanejp/XM7-for-SDL
15   [2] http://homepage3.nifty.com/takeda-toshiya/
16   
17 2.Status
18   a. FM-7 is working now.
19   b. FM-77 is working now.
20      Especially 400 line card and 2HD FDDs are still not implement,
21      because I don't have these boards.
22   c. FM-8 is *not* implement, I have no document, now.
23      I'll implement this.
24   d. FM77AV is mostly working.
25   e. FM77AV40/EX is mostly working.
26   f. Implemented hidden message of FM77AV's keyboard [3].
27   g. Implemented saving/loading state feature, mostly working.
28   
29   If you need more informations, see RELEASENOTE and reame_by_artane.txt .
30      
31   [3] I implemented hidden message faster than XM7 :-)
32   
33 3.How to Work
34   You Need these R@M images to work FM-7.
35   If you don't have these images, you can get substitution R@Ms
36   from : http://retropc.net/apollo/download/xm7/romset/index.htm .
37   
38   At least for FM-7 or later:
39   BOOT_BAS.ROM : 512 bytes, To boot as BASIC mode.
40   BOOT_DOS.ROM : 512 bytes, To boot as DOS(NOT MS-DOS) mode.
41   FBASIC302.ROM
42   FBASIC300.ROM
43   FBASIC30.ROM : 31744 bytes, F-BASIC 3.0 code,
44                  Dummy (only BIOS) rom if you use substitution ROMS.
45   SUBSYS_C.ROM : 10240 bytes, Monitor of SUBCPU.
46
47   Optionally ROMS:
48   KANJI.ROM
49   KANJI1.ROM   : 131072 bytes, Kanji JIS class 1 patterns.
50   BOOT_MMR.ROM : 512 bytes, hidden boot ROM for FM-77 (only).
51
52   You need belows if you try to work FM77AV:
53   INITIATE.ROM : 8192 bytes, initiator ROM.
54                  You must use *pure* FM77AV's Initiator ROM.
55   SUBSYSCG.ROM : 8192 bytes, character data for subsystem.
56   SUBSYS_A.ROM : 8192 bytes, monitor type A for sub system.
57   SUBSYS_B.ROM : 8192 bytes, monitor type B for sub system.
58
59   Optionally ROMS (For FM77AV20/40):
60   KANJI2.ROM   : 131072 bytes, Kanji JIS class 2 patterns.
61   DICROM.ROM   : 262144 bytes, Dictionary data for Kana-Kanji conversion.
62   EXTSUB.ROM   : 49152 bytes, extra monitor for subsystem (77AV20 or later?)
63   
64   If you use emufm77av40ex, you must use FM-77AV40EX/SX's initiator ROM.
65
66   Making if you use DICROM :
67   USERDIC.DAT  : 8192 bytes, learning data of Kana-Kanji conversion.
68
69
70 4. Upstream repositry:
71       https://github.com/Artanejp/common_source_project-fm7
72
73
74 Enjoy!
75 -- K.Ohta.