source/readme_fm7.txt

   1 ** FM-7 series  emulator for common source code project. **
   2                                                December 18, 2018
   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://takeda-toshiya.my.coocan.jp/
  16
  17 2.Status
  18   a. FM-7 is working now.
  19   b. FM-77 is working now (but some features are wrong).
  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   l. Z80 Card (Only with FM-7/77 and FM-8) works.But not tested enough.
  36   m. Japanese Communication board works for FM-7/NEW7/77/L4.
  37   n. Start to implement RS-232C/MODEM/MIDI feature.(WIP)
  38   o. Start to implement FM-77L4's 400 lines board.But imcomplete.(WIP)Still WIP (2018-05-16)
  39   If you need more informations, see RELEASENOTE and reame_by_artane.txt .
  40
  41   [3] I implemented hidden message faster than XM7 :-)
  42
  43 3.How to Work
  44   You Need these R@M images to work FM-7.
  45   If you don't have these images, you can get substitution R@Ms
  46   from : http://retropc.net/apollo/download/xm7/romset/index.htm .
  47
  48   At least for FM-7 or later:
  49   BOOT_BAS.ROM : 512 bytes, To boot as BASIC mode.
  50   BOOT_DOS.ROM : 512 bytes, To boot as DOS(NOT MS-DOS) mode.
  51   FBASIC302.ROM
  52   FBASIC300.ROM
  53   FBASIC30.ROM : 31744 bytes, F-BASIC 3.0 code,
  54                  Dummy (only BIOS) rom if you use substitution ROMS.
  55   SUBSYS_C.ROM : 10240 bytes, Monitor of SUBCPU.
  56
  57   Optionally ROMS:
  58   KANJI.ROM
  59   KANJI1.ROM   : 131072 bytes, Kanji JIS class 1 patterns.
  60   BOOT_MMR.ROM : 512 bytes, hidden boot ROM for FM-77 (only).
  61
  62   Optional ROMS (Only for FM77L4):
  63   SUBSYS_L4.ROM : 18432 bytes. System ROM of 400 lines board.
  64   ANKCG16.ROM   : 4096 bytes.  Character data of 400 lines board.
  65
  66    You need belows if you try to work FM77AV:
  67   INITIATE.ROM : 8192 bytes, initiator ROM.
  68                  You must use *pure* FM77AV's Initiator ROM.
  69   SUBSYSCG.ROM : 8192 bytes, character data for subsystem.
  70   SUBSYS_A.ROM : 8192 bytes, monitor type A for sub system.
  71   SUBSYS_B.ROM : 8192 bytes, monitor type B for sub system.
  72
  73   Optionally ROMS (For FM77AV20/40):
  74   KANJI2.ROM   : 131072 bytes, Kanji JIS class 2 patterns.
  75   DICROM.ROM   : 262144 bytes, Dictionary data for Kana-Kanji conversion.
  76   EXTSUB.ROM   : 49152 bytes, extra monitor for subsystem (77AV20 or later?)
  77
  78   If you use emufm77av40ex, you must use FM-77AV40EX/SX's initiator ROM.
  79
  80   Making if you use DICROM :
  81   USERDIC.DAT  : 8192 bytes, learning data of Kana-Kanji conversion.
  82
  83
  84 4. Upstream repositry:
  85       https://github.com/Artanejp/common_source_project-fm7
  86       https://osdn.jp/projects/csp-qt/
  87
  88 Enjoy!
  89 -- K.Ohta.