source/RELEASENOTE.txt

   1 ** Qt porting and FM-7/77/AV/AV40/EX for Common Source Code Project **
   2
   3                                                        August 01, 2021
   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_20210801
  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 j. Now for Win32 build, using LLVM CLANG cross toolchains on Docker environment.Because exception handling of MinGW-w64's gcc is very slowly (this cause by *evil* Borland).
  56   See https://github.com/Artanejp/llvm-mingw and https://hub.docker.com/r/artanejp/llvm-mingw64-ubuntu-cosmic for datails.
  57
  58 * 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).
  59
  60 3.How to build:
  61
  62 After extracting (or git pulled) sourcecodes:
  63
  64 $ cd {srctop}/source/build-cmake/{Machine name}/
  65
  66 $ mkdir build
  67
  68 $ cd build
  69
  70 To configure:
  71
  72 $ cmake ..
  73
  74 or
  75
  76 $ ccmake ..
  77
  78 To build:
  79
  80 $ make
  81
  82 To install:
  83
  84 $ sudo make install
  85
  86 4.Qt specified notice:
  87
  88    ・Config file (scancode.cfg and foo.ini) has placed (moved) to
  89      "~/.config/CommonSourceCodeProject/emufoo/"
  90      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  91
  92    ・BIOS, WAVS, BINS and SAVED STATES have placed (moved) to
  93      "~/CommonSourceCodeProject/emufoo/"
  94      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  95
  96    ・All of recorded products (PNG Screenshots, MOVIES, SOUNDS)
  97      have *temporally* written to "~/.config/CommonSourceCodeProject/emufoo/"
  98      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  99
 100    ・Added ToolTips and Japanese translations.(2017-01-24)
 101
 102    ・Place R@Ms under $HOME/CommonSourceCodeProject/emu{Machine Name}/ , this directory has made
 103      after first using.
 104
 105    ・Config file, {foo}.ini is written on $HOME/.config/CommonSourceCodeProject/emu{Machine Name}/ .
 106
 107    ・Saved state file, {foo}.sta is written on $HOME/CommonSourceCodeProject/emu{Machine Name}/ .
 108
 109    ・Key code conversion file is written on $HOME/.config/CommonSourceCodeProject/emu{Machine Name}/scancode.cfg .
 110
 111      This file contains comma separated fields, written at hex-decimal (not decimal),
 112        first is M$ Virtual Key Code,
 113        second is Qt's scan code.
 114
 115    ・Common UI components (at src/qt/gui ) are moved to shared lib. libCSPgui.so .
 116
 117    ・Installer (bash) script is available now; src/tool/installer_unix.sh .
 118
 119    ・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.
 120
 121 5.Status
 122
 123 a. I tested to build only under Debian GNU/Linux "sid",Ubuntu Linux 16.04LTS "Xenial" for AMD64 (x86_64)
 124 and MinGW with GCC6 (Windows 32bit).
 125
 126    But, perhaps, will succed to build another GNU/Linux OSs or BSD OS variants.
 127
 128    * On windows, using MinGW is already okay, but not tested drawing.
 129
 130    * Cross building with GNU/Linux's MinGW32 and Qt5.5.1 (for MinGW) is available.
 131      Modify and use build-cmake/config_build_cross_win32.sh and related *.cmake files.
 132
 133    * And, you can also build with M$ Visual Studio 2013 or 2015.
 134
 135 b. Now, I using Qt5 as toolkit, because authors of Qt announced "Qt4 is obsolete, will be updated no longer".
 136
 137 c. All of virtual machines are already ported to Qt (On Oct 29, 2015).
 138
 139 d. Now using GCC-6.1 with Link Time Optimize to build for distrubuted binaries.
 140
 141 e. Implemented socket, networking for MZ-2500, but, not tested yet (；´Д｀)
 142
 143 Repositry:
 144
 145    https://github.com/Artanejp/common_source_project-fm7
 146
 147    https://osdn.net/projects/csp-qt/scm/git/common_source_project-fm7
 148
 149
 150 Project Page:
 151
 152    https://osdn.jp/projects/csp-qt/
 153
 154 Upstream (Takeda Toshiya San's original code):
 155
 156    http://takeda-toshiya.my.coocan.jp/
 157
 158 Special thanks to:
 159    Ryu Takegami-san, to assist debugging FM-7/77/AV/40/EX .
 160    Haserin-san, to assist debugging FM-7/77/AV/40/EX .
 161    Developers of Ootake, give hints of emuPCEngine (from source code).
 162    Soji Yamakawa-San, author of TOWNS emulater "津軽",
 163                       and advice for my development a lot.
 164
 165 Changes:
 166
 167 * To see older changes, read ChangeLog and 000_gitlog.txt.
 168
 169 * SNAPSHOT August 01, 2021
 170   * Upstream 2021-05-02.
 171   * [BUILD/CMAKE] Add *Very Experimental* C++20 build settings.
 172   * [OSD/EMU][MOUSE/JOYSTICK] Should LOCK/UNLOCK per referring buffers of joystick/mouse.
 173     Note: This is MAJOR API CHANGE around mouse and joystick.
 174   * [CONFIG/FMTOWNS] Add config.machine_features[32] to use machine configuration (w/o DIP SWITCH).Still not be bulidable.
 175     Note: See vm/fmtowns/joystick.cpp, FMTOWNS::JOYSTICK::update_config().
 176   * [FMTOWNS/KEYBOARD] SPECIAL_RESET: Available to boot with special key code (i.e. "CD" "DEBUG").
 177   * [FMTOWNS/CDROM] Re-implement parsing CCD image file.Still ugly.
 178   * [FMTOWNS/VRAM] Add __LIKELY_IF() and __UNLIKELY_IF() to assist compiler's optimization.
 179     See [read|write]_memory_mapped_io32() and read_memory_mapped_io16() at FMTOWNS::TOWNS_VRAM class.
 180   * [VM/I386_NP21] Add hints of branch-prediction whether accessing memory (and some of interrupts) is legal.
 181     This reduces HOST CPU USAGE especially high-VM-clocks.
 182   * [FMTOWNS/VRAM] More faster vram accessing.
 183   * [FMTOWNS/MEMORY/VRAM] Add features around CACHE for after i486.Still be dummy.
 184   * [FMTOWNS/CRTC] Use more SIMDs to be faster rendering.
 185   * [FMTOWNS/KEYBOARD] Implement AUTO REPEAT.
 186   * [FMTOWNS/TIMER] Clear OV and INTR when enabling interval timer.
 187   * [FMTOWNS/VRAM] More faster VRAM access for packed pixel mode.
 188   * [FMTOWNS/CDROM] Even reply without REQ_STATUS bit (0x20) with PAUSE/RESUME CDDA (85h/87h).
 189   * [FMTOWNS/CDROM] Falldown intr even stat_reply_intr (04C2:bit6) == 0 on MCU interrupt.
 190   * [FMTOWNS/CDROM] Reply error when reading beyond track on READ_SECTOR.
 191   * [FMTOWNS/CDROM] Fix around booting from some version(s?) of TOWNS OS.
 192          i.e)AYAYO 4.
 193   * [FMTOWNS/CRTC/TIMER/MEMORY] Improve around I/O.
 194   * [FMTOWNS/DMAC] Remove some variables.Update state save version.
 195   * [FMTOWNS/SCSI] Add a PORT: 0C34h.
 196   * [FMTOWNS/MEMORY] Revert to use primitive_[read|write]. Fix CDROM's some issues (i.e. Crashing Ayayo4).
 197   * [FMTOWNS/MEMORY] Add dma read/write functions with wait.
 198   * [FMTOWNS/ICCARD] Improve logic around open/close.
 199   * [FMTOWNS/JOYSTICK] Fix confused mouse mask.
 200   * [FMTOWNS] Split MOUSE and JOYPADs to separate class.
 201   * [FMTOWNS/FLOPPY] Add support for 1.44MB 2HD (2HC).
 202   * [I286/I86/V30] Separate namespace CPUTYPE ENUMS.
 203   * [I286/I86] Fix weird bitmask default value.
 204   * [VM/UPD71071] Add read_io16(), write_io16() and ACK feature.
 205   * [PC9801/EGC] Fix FTBFS with C++20 ; "error: ISO C++17 does not allow 'register' storage class specifier".
 206   * [BUILD/CMake] Add samplescripts supports GCC-11 initially.
 207   * [BUILD/CMake] Prepare to support LLVM12, but now unable to build Win32 version with llvm12 due to _aligned_alloc() and _aligned_free().
 208   * [Build/Win32] LLVM12/MinGW-w64/Cross : Add libc++abi and others to toolchain.
 209   * [Build/Win32] Update revision of ffmpeg to 4.4.
 210   * [JOY_THREAD/SDL2/GAMECONTROLLER] Fix sample initial value.
 211   * Built with ab2601af3b0de22bd806ce5312ebf06823a16405 (or later).
 212
 213 -- August 01, 2021 22:34:13 +0900 K.Ohta <whatisthis.sowhat@gmail.com>
 214
 215 Upstream changes:
 216 * To see older upstream's changes, read history.txt.
 217
 218 5/2/2021
 219
 220 [VM/DATAREC] fix mixing sound track
 221 [VM/HD46505] support smooth vertical scroll
 222 [VM/MC6843] fix seek command
 223 [VM/MC6844] fix data chain register to consider 2/4 channel select bit
 224 [VM/MC6844] fix to transfer 64K when byte count register is zero
 225 [VM/Z80CTC] fix to apply written time constant just after reset bit is cleared
 226
 227 [BX1] fix memory map around ram
 228 [BX1] support cartridge rom images
 229 [BX1/DISPLAY] add missing font patterns
 230 [BX1/FLOPPY] support i/o ports around fdc
 231 [BX1/KEYBOARD] support PROG.SELECT switch
 232 [BX1/PRINTER] support AUTO PRINT switch
 233 [MZ1500/JOTSTICK] support joystick (thanks Mr.Koucha-Youkan)
 234 [PC6001] remove some codes from iP6 Plus
 235 [X1TURBO/DISPLAY] support smooth vertical scroll
 236
 237
 238 2/7/2021
 239
 240 [WINMAIN] improve WM_KEYDOW/WM_KEYUP events for VK_PROCESSKEY case
 241 [WIN32/CONSLE] improve routine to change console size
 242
 243 [VM/DISK] fix density flag when loading solid image with fm sectors
 244 [VM/MC6843] fix track zero flag in STRA
 245 [VM/MC6843] fix seek error flag in STRB
 246 [VM/MC6843] fix seek command
 247
 248 [BX1/DISPLAY] improve for drawing digitron display
 249 [BX1/KEYBOARD] improve I/O ports for detecting key pressed/released
 250 [BX1/PRINTER] add ugly patch for printer process
 251
 252 1/24/2021
 253
 254 [VM/I8279] support 8279 (based on MAME)
 255
 256 [MP85] support MITEC MP-85
 257
 258
 259 1/17/2021
 260
 261 [VM/UPD765A] improve for the case tc is asserted while reading/writing sector
 262
 263 [PC8801/PC88] improve to render screen with port params at end of disp timing
 264 [X1TURBO/FLOPPY] fix to change type of all drives (thanks Mr.Sato)
 265
 266
 267 1/3/2021
 268
 269 [WINMAIN] improve for pressing shift key and numpad key
 270
 271 [MZ80K] fix roman/kana conversion
 272 [MZ80K/KEYBOARD] improve for pressing right shift key and numpad key
 273
 274
 275 12/31/2020
 276
 277 [PC8801/PC88] improve crtc to refer reverse setting in start display command
 278
 279
 280 12/21/2020
 281
 282 [VM/SCSI_CDROM] fix start frame of CD-DA playing when track number is specified
 283
 284 [PCENGINE/PCE] fix issue that ADPCM is mistakenly looped
 285
 286
 287 12/19/2020
 288
 289 [VM/SCSI_CDROM] fix pre-gap of first track when it is audio track
 290
 291
 292 12/18/2020
 293
 294 [VM/SCSI_CDROM] improve routine to get start/end frame of CD-DA playing
 295
 296 [PC8801/PC88] support 8inch DMA-type floppy drives for PC-8001mkII/SR
 297 [PC9801/DISPLAY] improve EGC (thanks Mr.Ryuji Okamoto)
 298
 299
 300 12/16/2020
 301
 302 [PC8801/DISKIO] improve to read/write files in initial current directory
 303 [PC8801/PC88] support force ready/drq mask register for DMA-type FDD
 304 [PC8801/PC88] fix PC-8001mkIISR hiragana font when PCG-8100 is enabled
 305
 306
 307 12/15/2020
 308
 309 [PC8801/DISKIO] support M88 DiskDrv (thanks Mr.CISC and Mr.apaslothy)
 310 [PC8801/PC88] support PC-8001mkIISR hiragana font
 311 [PC8801/PC88] support to disable 5inch/8inch-FDD interfaces
 312 [PC8801/PC88] support to disable updating scan line setting automatically
 313 [PC8801/PC88] fix mouse data when position is not latched
 314
 315
 316 12/14/2020
 317
 318 [PC8801/PC88] support 8inch DMA-type floppy drives
 319
 320
 321 12/13/2020
 322
 323 [VM/MC6843] support MC6843 (based on MAME)
 324 [[VM/SCSI_CDROM] fix to reset logical block size in Test Unit Ready command
 325
 326 [BX1] support CANON BX-1 (not work)
 327 [MZ1500/QUICKDISK] improve for BSD record (thanks Mr.Motochan1500)
 328 [PC8801/PC88] fix hireso graphic screen when scan line is disabled
 329
 330
 331 12/12/2020
 332
 333 [PC8801/PC88] fix to clear attibutes at starting new frame
 334 [PC8801/PC88] fix to read status of 2nd OPNA
 335
 336
 337 12/11/2020
 338
 339 [PC8801/PC88] fix to run dma from memory to crtc when (rd,wr)=(0,0)
 340 [PC8801/PC88] fix to run dma from scsi to memory only when count > 0
 341
 342
 343 12/8/2020
 344
 345 [COMMON] fix build error on VC++2019 (thanks Mr.Sato)
 346
 347 [VM/Z80CTC] fix not to clear in-service at software reset (thanks Mr.Sato)
 348 [VM/Z80DMA] fix stall cycles at BUSACK in byte mode (thanks Mr.Sato)
 349
 350 [X1TURBOZ/DISPLAY] fix zpalette in 64 colors, 2 screens mode (thanks Mr.Sato)
 351
 352
 353 12/6/2020-2
 354
 355 [MZ1500] fix inp(0xe8) to detect voice board is missing (thanks Mr.kitahei88)
 356 [X1TURBOZ/DISPLAY] fix to update zpalette at vline=0 (thanks Mr.Sato)
 357
 358
 359 12/6/2020
 360
 361 [OSD/WIN32] import Unity plug-in code (thanks Mr.Marukun)
 362
 363 [VM/I386_NP21] update to Neko Project 21/W ver0.86 rev79 beta4
 364 [VM/UPD765A] fix transfer size to 128 << min(N, 7) (thanks Mr.Kugimoto)
 365
 366 [MZ1500/QUICKDISK] improve for QDF format (thanks Mr.kitahei88)
 367 [MZ1500/QUICKDISK] improve for BSD record (thanks Mr.Yuushi)
 368 [PC9801/MEMORY] fix switching BIOS ROM/RAM
 369 [X1/CZ8RB] support CZ-8RB (thanks Mr.Meister)
 370
 371 -----
 372
 373
 374 Have fun!
 375 -- Ohta.
 376