source/RELEASENOTE.txt

   1 ** Qt porting and FM-7/77/AV/AV40/EX for Common Source Code Project **
   2
   3                                                        February 16, 2018
   4                             K.Ohta  (whatisthis.sowhat _at_ gmail.com)
   5
   6 1.About
   7
   8 This package is Qt5 porting of Common Source Code Project (CSP)
   9 and built with Qt5, for Windows, built with MinGW(32bit).
  10
  11 Source Code:
  12
  13    https://github.com/Artanejp/common_source_project-fm7/releases/tag/SNAPSHOT_20180216_FM7_TEST1
  14
  15 Additional INFO:
  16
  17    Binaries will be available, distibute from osdn.net.
  18
  19    See, https://osdn.net/projects/csp-qt/  and
  20         https://osdn.net/projects/csp-qt/releases/ .
  21
  22    Released at:
  23
  24
  25 2.Background
  26
  27 Common Source Code Project (CSP) is good emulator writing.
  28 It also distributed with GPLv2, this is good for me.
  29
  30 But codes are specified to M$ Visual C.
  31 I'm using GNU/Linux, and I starting to apply FM-7(or later).
  32
  33 So, I start to port to GNU/Linux and using Qt4/Qt5.
  34
  35 What you need at least:
  36
  37 a. Qt5 (neither Qt3 and Qt4) toolkit: Qt5.3 or later.
  38
  39 b. Some OpenGL implementation, maybe at leaset OpenGL v2.x .
  40
  41 c. gcc / g++ (5.0 or later? ) or llvm clang / clang++ (3.5 or later?) toolchain.
  42
  43 d. SDL2 (not SDL1.x).
  44
  45 e. CMake 2.8 or later.
  46
  47 * TIPS: If emufoo.exe don't show screen drawing, set environment variable QT_OPENGL to software (i.e. Using Windows as VirtualBox's gueat OS).
  48
  49
  50 3.How to build:
  51
  52 After extracting (or git pulled) sourcecodes:
  53
  54 $ cd {srctop}/source/build-cmake/{Machine name}/
  55
  56 $ mkdir build
  57
  58 $ cd build
  59
  60 To configure:
  61
  62 $ cmake ..
  63
  64 or
  65
  66 $ ccmake ..
  67
  68 To build:
  69
  70 $ make
  71
  72 To install:
  73
  74 $ sudo make install
  75
  76 4.Qt specified notice:
  77
  78    ・Config file (scancode.cfg and foo.ini) has placed (moved) to
  79      "~/.config/CommonSourceCodeProject/emufoo/"
  80      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  81
  82    ・BIOS, WAVS, BINS and SAVED STATES have placed (moved) to
  83      "~/CommonSourceCodeProject/emufoo/"
  84      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  85
  86    ・All of recorded products (PNG Screenshots, MOVIES, SOUNDS)
  87      have *temporally* written to "~/.config/CommonSourceCodeProject/emufoo/"
  88      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  89
  90    ・Added ToolTips and Japanese translations.(2017-01-24)
  91
  92    ・Place R@Ms under $HOME/CommonSourceCodeProject/emu{Machine Name}/ , this directory has made
  93      after first using.
  94
  95    ・Config file, {foo}.ini is written on $HOME/.config/CommonSourceCodeProject/emu{Machine Name}/ .
  96
  97    ・Saved state file, {foo}.sta is written on $HOME/CommonSourceCodeProject/emu{Machine Name}/ .
  98
  99    ・Key code conversion file is written on $HOME/.config/CommonSourceCodeProject/emu{Machine Name}/scancode.cfg .
 100
 101      This file contains comma separated fields, written at hex-decimal (not decimal),
 102        first is M$ Virtual Key Code,
 103        second is Qt's scan code.
 104
 105    ・Common UI components (at src/qt/gui ) are moved to shared lib. libCSPgui.so .
 106
 107    ・Installer (bash) script is available now; src/tool/installer_unix.sh .
 108
 109    ・When you place specified WAV files(differ per VM) same directory as ROMs, you can sound sounds: i.e. FDD seek, CMT relay and buttons.
 110
 111 5.Status
 112
 113 a. I tested to build only under Debian GNU/Linux "sid",Ubuntu Linux 16.04LTS "Xenial" for AMD64 (x86_64)
 114 and MinGW with GCC6 (Windows 32bit).
 115
 116    But, perhaps, will succed to build another GNU/Linux OSs or BSD OS variants.
 117
 118    * On windows, using MinGW is already okay, but not tested drawing.
 119
 120    * Cross building with GNU/Linux's MinGW32 and Qt5.5.1 (for MinGW) is available.
 121      Modify and use build-cmake/config_build_cross_win32.sh and related *.cmake files.
 122
 123    * And, you can also build with M$ Visual Studio 2013 or 2015.
 124
 125 b. Now, I using Qt5 as toolkit, because authors of Qt announced "Qt4 is obsolete, will be updated no longer".
 126
 127 c. All of virtual machines are already ported to Qt (On Oct 29, 2015).
 128
 129 d. Now using GCC-6.1 with Link Time Optimize to build for distrubuted binaries.
 130
 131 e. Implemented socket, networking for MZ-2500, but, not tested yet (；´Д｀)
 132
 133 Repositry:
 134
 135    https://github.com/Artanejp/common_source_project-fm7
 136
 137    https://osdn.net/projects/csp-qt/scm/git/common_source_project-fm7
 138
 139
 140 Project Page:
 141
 142    https://osdn.jp/projects/csp-qt/
 143
 144 Upstream (Takeda Toshiya San's original code):
 145
 146    http://takeda-toshiya.my.coocan.jp/
 147
 148 Special thanks to:
 149    Ryu Takegami-san, to assist debugging FM-7/77/AV/40/EX .
 150    Haserin-san, to assist debugging FM-7/77/AV/40/EX .
 151
 152 Changes:
 153
 154 * To see older changes, read ChangeLog and 000_gitlog.txt.
 155
 156 * SNAPSHOT Feb 16, 2018 FM7 TEST1
 157   * Upstream 2017-12-27 .
 158   * This is test release. Will re-write articles in this entry to next official release.
 159   * [VM] Add eFMNEW7.
 160   * [VM/FM7][UI/FM7] MAINMEM: Re-order bank of bulk BOOTROMs.Thanks to HASERIN.
 161                      IMPORTANT: Re-order boot entries within MENU dynamically.
 162                                 This is compatibility with older settings.
 163                                 GUI's menu (for eFM8/eFMNEW7/eFM7*) must change order of boor menu entry.
 164   * [VM/FM77]   Add ON/OFF extra RAM.
 165   * [VM/FM77AV] Add to use dictionary board for FM77AV/20/EX.
 166   * [VM/FM77] BUG: I mistaken to connect motor line for 2HD FDD, I connected 2D FDD (；´Д｀)
 167   * [VM/FM77] 2HD: Fix DRQ->FIRQ handling.Wish to BOOT 2HD OSs.
 168   * [VM/FM77AV] DISPLAY: Do not reset interrupt masks at reset on sub-system.Thanks to Ryu Takegami.
 169   * [VM/FM77AV] MAINMEM: More simple inside structure for PAGE2.
 170   * [VM/FM8] Change default frequency to 1.0MHz.Thanks to Haserin.
 171   * [VM/FM8] Fix RS232C #1(COM0:) can't remove from maim board.Thanks to Haserin.
 172   * [VM/FM7/JCOMMCARD] Use bulk rom (or DICTIONARY + KANJI) for DICTIONARY ROM AREA.
 173   * [VM/FM7/JCOMMCARD] Abndon use JIS78 emulation.
 174   * [VM/FM7/KANJIROM] Abndon use JIS78 emulation.
 175   * [VM/BUBBLECASETTE] Improve status register.Thanks to Haserin and Ryu Takegami.
 176   * Special thanks to Ryu Takegami, to assist debugging FM-7/77/AV/40/EX/8 .
 177   * Special thanks to Haserin, to assist debugging FM-7/77.AV/40/EX/8.
 178   * Built with commit bc517f5638b4f5612cc075e0f4d9278220eab4fc or later.
 179
 180 -- Feb 16, 2018 06:02:49 +0900 K.Ohta <whatisthis.sowhat@gmail.com>
 181
 182 Upstream changes:
 183 * To see older upstream's changes, read history.txt.
 184
 185 12/27/2017
 186
 187 [EMU] support to restore sound frequency/latency settings when load state
 188
 189 [VM/DISK] support T98-NEXT nfd r0 floppy disk image
 190 [VM/DISK] support BKDSK hdm/hd5/hd4/hdb/dd9/dd6 floppy disk image
 191
 192
 193 12/15/2017
 194
 195 [COMMON/FILEIO] add Fcompare function
 196
 197 [VM/*] improve save/load state function to check device class name
 198 [VM/YM2151] fix save/load state function
 199
 200
 201 12/14/2017
 202
 203 [RESOURCE] change accelerators for switching full speed and roman/kana input
 204 [WINMAIN] fix to call ImmAssociateContext() in WM_ACTIVATE (thanks PC8801MA改)
 205
 206 [VM/HD46505] fix to force update event timing when R0-R9 are modified
 207 [VM/HUC6280] support to show clocks since starting scanline in debugger
 208 [VM/I286] support to show clocks since starting scanline in debugger
 209 [VM/I386] support to show clocks since starting scanline in debugger
 210 [VM/M6502] support to show clocks since starting scanline in debugger
 211 [VM/MC6800] support to show clocks since starting scanline in debugger
 212 [VM/MC6809] support to show clocks since starting scanline in debugger
 213 [VM/MCS48] support to show clocks since starting scanline in debugger
 214 [VM/TMS9995] support to show clocks since starting scanline in debugger
 215 [VM/UPD7220] fix to force update event timing when sync are modified
 216 [VM/UPD7801] support to show clocks since starting scanline in debugger
 217 [VM/UPD7810] support to show clocks since starting scanline in debugger
 218 [VM/Z80] support to show clocks since starting scanline in debugger
 219
 220 [X1TURBOZ/DISPLAY] fix pcg/analog palette access wait again (thanks Mr.Sato)
 221
 222
 223 12/12/2017
 224
 225 [VM/DISK] fix crc in id/data field (thanks Mr.Sato)
 226 [VM/HD46505] fix not to raise DISPTMG signal if bit2,3 of R8 are 11
 227
 228 [X1TURBOZ/DISPLAY] fix pcg/analog palette access wait (thanks Mr.Sato)
 229 [X1TURBOZ/DISPLAY] fix to draw each line at start of hblank (thanks Mr.Sato)
 230
 231
 232 -----
 233
 234
 235 Have fun!
 236 -- Ohta.
 237