OSDN Git Service

[VM][DEVICE] Add set_device_name() and out_debug_log() to DEVICE class. These aim...
[csp-qt/common_source_project-fm7.git] / source / readme_fm7.txt
1 ** FM-7 series  emulator for common source code project. **
2                                                May 23, 2016
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 implement, but not tested enough.
23      I implemented bubble casette, but not complete implement.
24      Seems to be working, but not completed.
25      But, I still not implement 8"FDD.
26   d. FM77AV is mostly working.
27   e. FM77AV40/EX is mostly working.
28   f. Implemented hidden message of FM77AV's keyboard [3].
29   g. Implemented saving/loading state feature, mostly working.
30   h. Include printer support without inteligent commands.
31      Also inmplement Dempa Shimbun-sha's Joystick (sold with XEVIOUS).
32   i. Add also FM77AV's hidden buzzer.
33   j. Support connect/disconnect FDDs. Please check "Connect 320KB FDD" at first.
34   k. Support auto input "8" or "5" when using ten-key as moving characters at games for FM-8 and FM-7.
35   If you need more informations, see RELEASENOTE and reame_by_artane.txt .
36      
37   [3] I implemented hidden message faster than XM7 :-)
38   
39 3.How to Work
40   You Need these R@M images to work FM-7.
41   If you don't have these images, you can get substitution R@Ms
42   from : http://retropc.net/apollo/download/xm7/romset/index.htm .
43   
44   At least for FM-7 or later:
45   BOOT_BAS.ROM : 512 bytes, To boot as BASIC mode.
46   BOOT_DOS.ROM : 512 bytes, To boot as DOS(NOT MS-DOS) mode.
47   FBASIC302.ROM
48   FBASIC300.ROM
49   FBASIC30.ROM : 31744 bytes, F-BASIC 3.0 code,
50                  Dummy (only BIOS) rom if you use substitution ROMS.
51   SUBSYS_C.ROM : 10240 bytes, Monitor of SUBCPU.
52
53   Optionally ROMS:
54   KANJI.ROM
55   KANJI1.ROM   : 131072 bytes, Kanji JIS class 1 patterns.
56   BOOT_MMR.ROM : 512 bytes, hidden boot ROM for FM-77 (only).
57
58   You need belows if you try to work FM77AV:
59   INITIATE.ROM : 8192 bytes, initiator ROM.
60                  You must use *pure* FM77AV's Initiator ROM.
61   SUBSYSCG.ROM : 8192 bytes, character data for subsystem.
62   SUBSYS_A.ROM : 8192 bytes, monitor type A for sub system.
63   SUBSYS_B.ROM : 8192 bytes, monitor type B for sub system.
64
65   Optionally ROMS (For FM77AV20/40):
66   KANJI2.ROM   : 131072 bytes, Kanji JIS class 2 patterns.
67   DICROM.ROM   : 262144 bytes, Dictionary data for Kana-Kanji conversion.
68   EXTSUB.ROM   : 49152 bytes, extra monitor for subsystem (77AV20 or later?)
69   
70   If you use emufm77av40ex, you must use FM-77AV40EX/SX's initiator ROM.
71
72   Making if you use DICROM :
73   USERDIC.DAT  : 8192 bytes, learning data of Kana-Kanji conversion.
74
75
76 4. Upstream repositry:
77       https://github.com/Artanejp/common_source_project-fm7
78
79
80 Enjoy!
81 -- K.Ohta.