source/RELEASENOTE.txt

   1 ** Qt porting and FM-7/77/AV/AV40/EX for Common Source Code Project **
   2
   3                                                        February 22, 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_20190222
  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 February 22, 2019
 166   * Upstream 2019-02-19.
 167   * [VM] Fix crash when end of emulation at various(!) VMs.
 168   * [DEBUGGER/EMU] Some functions at debugger.cpp moved (and modified) to emu.cpp. This workaround needed by libCSPcommon .
 169   * [EMUUTIL/WIN32] Temporally disable SSE2.
 170   * [VM/I8080] I8085: Fix around SID instruction.FP200 works.
 171   * [VM/MSM5205] Add new API: pause_w().
 172   * [VM/MSM5205] Adjust ADPCM's sound level due to be too small sound.
 173   * [VM/UPD71071] Add 16bits transfer mode (needs to emulate FM-Towns).
 174   * [VM/PCENGINE] Separate around ADPCM from pce.cpp.
 175   * [VM/PCENGINE] Mostly works CD-ROM^2 softwares, excepts (at least) Valis2 and R-TYPE. Some softwares still contain wrong working.
 176   * [VM/SCSI_CDROM] CDDA: Fix interpreting cue sheet.Lasersoft's brand softwares may works.
 177   * [VM/SCSI_CDROM] CDDA:Don't update track when setting end position.
 178   * [OSD/Sound] Update OSD API, initialize_sound() has 4 args, not 2.
 179   * [OSD/Sound] SDL_MixAudioFormat() *MUST* use for SDL2, shouldn't use SDL_MixAudio for SDL2.
 180   * [Qt/OpenGL] Asynchronous pixel transfer with OpenGL 4.5 (and Core profile renderer).
 181   * [Qt/OpenGL] Now, core profile needs less than OpenGL 4.5.
 182   * [Qt/OpenGL] Fix not save screenshot with OpenGL renderers.(This issue didn't happen with OpenGL ES).
 183   * [Qt/AVIO] Fix wrong color at one-board-computers.
 184   * Built with 7574bd8b47c65e32c4f4a41ec593db71cc375230 (or later).
 185
 186 -- February 22, 2019 04:44:44 +0900 K.Ohta <whatisthis.sowhat@gmail.com>
 187
 188 Upstream changes:
 189 * To see older upstream's changes, read history.txt.
 190
 191 2/19/2019
 192
 193 [VM/DEVICE] add is_primary_cpu() and update_extra_event()
 194 [VM/EVENT] support to udpate event while cpu is running one opecode
 195 [VM/Z80] improve to update event in every read/write cycle
 196
 197 [MZ2500/MEMORY] improve pcgram wait in display timing
 198
 199
 200 2/16/2019
 201
 202 [EMU/DEBUGGER] improve to enumerate devices that is debugger available
 203 [EMU/DEBUGGER] improve to show all breaked reasons
 204 [EMU/DEBUGGER] support breakpoint of cpu selected by "! device" command
 205 [EMU/*] simplify code for debugger
 206 [VM/*] simplify code for debugger
 207
 208 [VM/I8237] support break point for direct memory access
 209 [VM/MB8877] fix not to wait 60ms to start read/write after seek is finished
 210 [VM/MC6844] support break point for direct memory access
 211 [VM/TMS9918A] support break point for registers and vram access
 212 [VM/UPD71071] support break point for direct memory access
 213 [VM/Z80DMA] support break point for direct i/o and memory access
 214
 215
 216 2/14/2019
 217
 218 [EMU/DEBUGGER] support break point for non-cpu device
 219 [EMU/DEBUGGER] change command length from 64 to 1024
 220
 221 [VM/AY_3_891X] support break point
 222 [VM/DEVICE] add get_debug_data_addr_space()
 223 [VM/DEVICE] change type of get_debug_regs_info() from void to bool
 224 [VM/MB8877] fix to decrease first seek time by 500us (2D/2DD) or 250us (2HD)
 225 [VM/TMS9918A] support break point
 226 [VM/YM2151] support break point
 227 [VM/YM2203] support break point
 228 [VM/Z80CTC] fix to reset interrupt req/in service by bit2 of control register
 229 [VM/Z80DMA] fix to reset interrupt req/in service by reset command
 230
 231 [X1TURBO/EMM] support to access vram as memory space from debugger
 232 [X1TURBO/IOBUS] support to access vram as memory space from debugger
 233 [X1TURBO/IOBUS] support break point
 234
 235
 236 2/9/2019
 237
 238 [EMU/DEBUGGER] enlarge text buffer size
 239
 240 [VM/DEVICE] add get_context_child() to enumerate daisy-chained devices
 241 [VM/DISK] add get_sector_info()
 242 [VM/MB8877] improve debugger to show current head position and disk geometry
 243 [VM/MB8877] fix not to abort command when eject disk in unselected drive
 244 [VM/UPD765A] improve debugger to show current head position and disk geometry
 245 [VM/Z80*] add get_context_child() to enumerate daisy-chained devices
 246
 247 [X1TURBO] fix to force clear iei/oei of z80 family devices when reset vm
 248 [X1TURBO/DISPLAY] fix to check bit0/2 of port 0x1fd0 in draw_text()
 249
 250
 251 2/8/2019
 252
 253 [EMU/*] simplify code to draw screen while debugging cpu
 254 [OSD/*] simplify code to draw screen while debugging cpu
 255 [VM/*] simplify code to draw screen while debugging cpu
 256
 257 [BUBCOM80/DISPLAY] improve dmac
 258 [HC80/IO] fix slave-cpu command 0x27 and 0x29 (thanks Mr.Stefano Bodrato)
 259
 260
 261 2/7/2019
 262
 263 [EMU/DEBUGGER] improve to draw screen while debugging cpu
 264 [EMU] add override/restore/run_wndproc() for debugger
 265 [EMU] add create_bank_floppy_disk()
 266 [OSD/WIN32] add override/restore/run_wndproc() for debugger
 267
 268 [VM/315_5124] improve draw_screen() for debugger
 269 [VM/H6280] improve to run window procedure while suspending for debugger
 270 [VM/I286] improve to run window procedure while suspending for debugger
 271 [VM/I386] improve to run window procedure while suspending for debugger
 272 [VM/I8080] improve to run window procedure while suspending for debugger
 273 [VM/M6502] improve to run window procedure while suspending for debugger
 274 [VM/MC6800] improve to run window procedure while suspending for debugger
 275 [VM/MC6809] improve to run window procedure while suspending for debugger
 276 [VM/MCS48] improve to run window procedure while suspending for debugger
 277 [VM/TMS9918A] improve draw_screen() for debugger
 278 [VM/TMS9995] improve to run window procedure while suspending for debugger
 279 [VM/UPD7801] improve to run window procedure while suspending for debugger
 280 [VM/UPD7810] improve to run window procedure while suspending for debugger
 281 [VM/V9938] improve draw_screen() for debugger
 282 [VM/V99X8] improve draw_screen() for debugger
 283 [VM/Z80] improve to run window procedure while suspending for debugger
 284
 285 [BUBCOM80/DISPLAY] improve draw_screen() for debugger
 286 [FAMILYBASIC/PPU] improve draw_screen() for debugger
 287 [MZ80K/DISPLAY] improve draw_screen() for debugger
 288 [MZ1500/MEMORY] improve draw_screen() for debugger
 289 [PC8801/PC88] improve draw_screen() for debugger
 290 [PCENGINE/PCE] improve draw_screen() for debugger
 291 [SMC777/MEMORY] improve draw_screen() for debugger
 292 [X1/DISPLAY] improve draw_screen() for debugger
 293
 294
 295 1/29/2019
 296
 297 [MZ80K/MEMORY] support COLOR GAL 5 (thanks Mr.Suga)
 298 [PC8001/PC88] fix issue that cursor is mistakenly hidden
 299
 300
 301 1/18/2019
 302
 303 [PC8001/PC88] clear ram[0xff33] for DEMPA Galaxian
 304 [SMC777/MEMORY] improve to render screen in each scan line
 305
 306
 307 1/16/2019
 308
 309 [EMU] improve to reinitialize vm in reset when dipswitch is changed
 310
 311 [VM/UPD765A] fix st3 in sence devstat command to set two-side bit (temporary)
 312
 313 [PC8801] support GSX-8800
 314 [PC8801] support to enable/disable PC-8801-11/GSX-8800/PCG-8100
 315 [PC8801] fix some degradations
 316
 317 -----
 318
 319
 320 Have fun!
 321 -- Ohta.
 322