source/RELEASENOTE.txt

   1 ** Qt porting and FM-7/77/AV/AV40/EX for Common Source Code Project **
   2
   3                                                        August 16, 2019
   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_20190816
  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 f. Needs ffmpeg.See https://ffmpeg.org/ .
  48
  49 g. FFMpeg has bundled only for Win32.Please install for other OSs if not working.
  50
  51 h. Built with Qt5.5 (for Ubuntu 16.04LTS) or Qt 5.10 (for Win32 and Debian/Sid).
  52
  53 i. Now, changed default drawing infrastructure to OpenGL ES2.You can change --opengl option via comman line (or GUI).
  54
  55 * 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).
  56
  57
  58 3.How to build:
  59
  60 After extracting (or git pulled) sourcecodes:
  61
  62 $ cd {srctop}/source/build-cmake/{Machine name}/
  63
  64 $ mkdir build
  65
  66 $ cd build
  67
  68 To configure:
  69
  70 $ cmake ..
  71
  72 or
  73
  74 $ ccmake ..
  75
  76 To build:
  77
  78 $ make
  79
  80 To install:
  81
  82 $ sudo make install
  83
  84 4.Qt specified notice:
  85
  86    ・Config file (scancode.cfg and foo.ini) has placed (moved) to
  87      "~/.config/CommonSourceCodeProject/emufoo/"
  88      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  89
  90    ・BIOS, WAVS, BINS and SAVED STATES have placed (moved) to
  91      "~/CommonSourceCodeProject/emufoo/"
  92      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  93
  94    ・All of recorded products (PNG Screenshots, MOVIES, SOUNDS)
  95      have *temporally* written to "~/.config/CommonSourceCodeProject/emufoo/"
  96      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  97
  98    ・Added ToolTips and Japanese translations.(2017-01-24)
  99
 100    ・Place R@Ms under $HOME/CommonSourceCodeProject/emu{Machine Name}/ , this directory has made
 101      after first using.
 102
 103    ・Config file, {foo}.ini is written on $HOME/.config/CommonSourceCodeProject/emu{Machine Name}/ .
 104
 105    ・Saved state file, {foo}.sta is written on $HOME/CommonSourceCodeProject/emu{Machine Name}/ .
 106
 107    ・Key code conversion file is written on $HOME/.config/CommonSourceCodeProject/emu{Machine Name}/scancode.cfg .
 108
 109      This file contains comma separated fields, written at hex-decimal (not decimal),
 110        first is M$ Virtual Key Code,
 111        second is Qt's scan code.
 112
 113    ・Common UI components (at src/qt/gui ) are moved to shared lib. libCSPgui.so .
 114
 115    ・Installer (bash) script is available now; src/tool/installer_unix.sh .
 116
 117    ・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.
 118
 119 5.Status
 120
 121 a. I tested to build only under Debian GNU/Linux "sid",Ubuntu Linux 16.04LTS "Xenial" for AMD64 (x86_64)
 122 and MinGW with GCC6 (Windows 32bit).
 123
 124    But, perhaps, will succed to build another GNU/Linux OSs or BSD OS variants.
 125
 126    * On windows, using MinGW is already okay, but not tested drawing.
 127
 128    * Cross building with GNU/Linux's MinGW32 and Qt5.5.1 (for MinGW) is available.
 129      Modify and use build-cmake/config_build_cross_win32.sh and related *.cmake files.
 130
 131    * And, you can also build with M$ Visual Studio 2013 or 2015.
 132
 133 b. Now, I using Qt5 as toolkit, because authors of Qt announced "Qt4 is obsolete, will be updated no longer".
 134
 135 c. All of virtual machines are already ported to Qt (On Oct 29, 2015).
 136
 137 d. Now using GCC-6.1 with Link Time Optimize to build for distrubuted binaries.
 138
 139 e. Implemented socket, networking for MZ-2500, but, not tested yet (；´Д｀)
 140
 141 Repositry:
 142
 143    https://github.com/Artanejp/common_source_project-fm7
 144
 145    https://osdn.net/projects/csp-qt/scm/git/common_source_project-fm7
 146
 147
 148 Project Page:
 149
 150    https://osdn.jp/projects/csp-qt/
 151
 152 Upstream (Takeda Toshiya San's original code):
 153
 154    http://takeda-toshiya.my.coocan.jp/
 155
 156 Special thanks to:
 157    Ryu Takegami-san, to assist debugging FM-7/77/AV/40/EX .
 158    Haserin-san, to assist debugging FM-7/77/AV/40/EX .
 159    Developers of Ootake, give hints of emuPCEngine (from source code).
 160
 161 Changes:
 162
 163 * To see older changes, read ChangeLog and 000_gitlog.txt.
 164
 165 * SNAPSHOT Aug 16, 2019
 166   * Upstream 2019-04-30.
 167   * This is point release, still exists some issues (i.e.EMM386(NEC/PC98) and FreeBSD(98) don't work) for PC-9801 and PC-Engine and some VMs, will fix them.
 168   * [UI/Qt] DEBUGGER: Add history for debugger command line.
 169   * [UI/Qt] DEBUGGER: Add auto-completion for command-line.
 170   * [VM/DEVICE] Use __FASTCALL with interfaces, read_*() ,write_*(), fetch_op() and some functions.Make this faster emulation (i.e.PC-9801RA and EMM386 under FreeDOS).
 171   * [VM/PC9801] Separate EGC functions.
 172   * [VM/PC9801] Add V30@8.0MHz with some I286/I386 machines.
 173   * [VM/PC9801] Check differnt of system work area (0000:0400-0000:05FF) both mame(pc9801rs) and emupc9801ra .
 174   * [VM/PC9801] Add "UPPER_I386" flag for detect using later than HAS_I386.
 175   * [VM/PC9801] CPUREG: (Maybe) improve changing cpu sequence around I/O 00F0h.
 176   * [VM/PC9801] CPUREG: Redirect interrupt signal via CPUREG:: .VMs with V30 sub CPU (i.e.PC9801RA) work with V30.
 177   * [VM/PC9801] Fix wrong initialize SYS_PORT_B.
 178   * [VM/PC9801] Fix wrong initialize memory switch.
 179   * [VM/PC9801] Add DIPSWITCH object.
 180   * [VM/PC9801] Fix different value at [0000:0501].
 181   * [VM/PC9801] MEMBUS: Split update_bios() to functions.
 182   * [VM/FP1100] Fix lacking some key symbols.Thanks to https://matsuri.5ch.net/test/read.cgi/i4004/1526806551/540 .
 183   * [VM/AY_3_891X] Fix not supported defines, replace flags.
 184   * [VM/AY_3_891X] Add feature ; dump/set register via debugger.
 185   * [VM/YM2151] Add feature ; dump/set register via debugger.
 186   * [VM/YM2203] Add feature ; dump/set register via debugger.
 187   * [VM/SN74689AN] Add feature ; dump/set register via debugger.
 188   * [VM/BEEP] Add feature ; dump register via debugger.
 189   * [VM/PCM1BIT] Add feature ; dump register via debugger.
 190   * [VM/I80x86/V30] Start debugger even halting.
 191   * [VM/I80x86/8088/V30] Make i86/186/88/286 and V30 to common_vm.
 192   * [VM/I386] Fix WRONG flag mask at LMSW.
 193   * [VM/I386] MOV CR0 EyX : Fix wrong flags handling.
 194   * [VM/I386] Exitable when falling into infinite TRAP-Loop.
 195   * [VM/I386] mov CRx,R32/mov r32,CRx : Adjusting.
 196   * [VM/i8259] Add PIC HACKing flag for PC9801.
 197   * [VM/uPD7810/uPD7907] PC2001: Include uPD7810 variants and uPD7907 to libCSP_common_VM.
 198   * [VM/MB8877] Fix buffer overflow with logging.
 199   * [VM/Z80DMA] TODO/WIP: Workaround for https://tablacus.github.io/LSX-Dodgers/ .This still be not resolved issue.
 200   * [VM/EVENT] Add remove_context_cpu().This may not effect to MAIN_CPU(id==0).
 201   * [DOC/FM7] Fix typo (*ﾉω・*)てへぺろ
 202   * [Qt/LOGGER] Improve locking.
 203   * [UI/Qt] OOPs: Fix LACK of DATARECORDER BUTTONS(abolish of USE_TAPE_BUTTON): Lack of merging UPSTREAM 2018/10/07.
 204   * [UI/Qt] MENU: Split some methods (of Ui_MainMenuBase::) to menu_emulator.cpp and menu_machine.cpp .
 205   * [UI/Qt] MENU: Simplify menu creation.
 206   * [CONFIG/Qt] Fix bit order of logging configure.
 207   * [BUILD/CMAKE] Add CPU affinity mask when compiling.This may work only with GNU/Linux host.
 208   * [BUILD/CMAKE] Improve build message with finished.
 209   * [BUILD/MINGW] Update optimize parameter.
 210   * [BUILD] Separate definitions of archtecture flags.
 211   * [BUILD] Add ARM32/64 definitions (initial).Still not testing.
 212   * Built with 0810a8f8b9ba44cedc19bf6b8e903c9c1b5d6f04 (or later).
 213
 214 -- Aug 16, 2019 20:38:06 +0900 K.Ohta <whatisthis.sowhat@gmail.com>
 215
 216 Upstream changes:
 217 * To see older upstream's changes, read history.txt.
 218
 219 4/30/2019
 220
 221 [VM/DEVICE] add is_primary_cpu() and update_extra_event()
 222 [VM/EVENT] support to udpate event while cpu is running one opecode
 223 [VM/I8259] fix reading isr register (thanks Mr.rednow)
 224 [VM/SCSI_HOST] fix to raise irq at command/message phase
 225 [VM/Z80] improve to update event in every read/write cycle
 226
 227 [CEFUCOM21] support Hino Electronics CEFUCOM-21 (not work)
 228 [MZ2500/CRTC] apply crtc patch (thanks Mr.Koucha-Youkan)
 229 [PC8801MA] improve to enable/disable cmdsing and pcg
 230 [PC8801MA] improve to enable/disable changing palette for each scan line
 231
 232 -----
 233
 234
 235 Have fun!
 236 -- Ohta.
 237