source/RELEASENOTE.txt

   1 ** Qt porting and FM-7/77/AV/AV40/EX for Common Source Code Project **
   2
   3                                                        February 11, 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_20180211
  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
 157 * SNAPSHOT Feb 11, 2018
 158   * Upstream 2017-12-27 .
 159   * [CONFIG] IMPORTANT: Now, "~/emufoo/" moved to "~/CommonSourceCodeProject/emufoo/"
 160                         (or ".\CommonSourceCodeProject\emufoo\" ).
 161              Please move settings to here.
 162   * [CONFIG] IMPORTANT: Now, "~/emufoo/foo.ini" has moved to "~/.config/CommonSourceCodeProject/emufoo/"
 163                               (or ".\CommonSourceCodeProject\emufoo\ at Windows").
 164              Please move ini and scancode.conf to new place.
 165   * [VM/MB8877] Enable to boot FLEX/FM-8.
 166                 Thanks to https://matsuri.5ch.net/test/read.cgi/i4004/1483504365/800- .
 167   * [UI/Qt] Add option: Emulate cursor keys as "2468" or "1235".
 168   * [UI/KEYBOARD] Add option, "Numpad's Enter is Fullkey's".Useful for FM-77AV series, etc.
 169   * [UI/VM] MB8877/T3444/uPD765A: Add ON/OFF debug logging for FDCs.
 170   * [Qt/EMU] Seriarize queueing both KEY_DOWN and KEY_UP.
 171              Expect to fix  key-in issues with slower host machine.
 172              See https://matsuri.5ch.net/test/read.cgi/i4004/1483504365/841 .
 173   * [UI/Qt] BUG: Fix crash with BOOT_MODEs >= 8.
 174   * [UI/Qt] FM7: Extend boot menu.
 175   * [UI/KEYBOARD] Update VM table.
 176   * [UI/KEYBOARD] Fix load/save sequence of scancode.cfg.
 177   * [UI/Qt] Update translate for menu.Split section per menu-bar-entry.
 178   * [MENU/Qt] DISK: Fix not affect of some entries:"Correct disk timing","Ignore CRC error" and "Immediate transfer".
 179   * [Draw/OpenGL] FM77AV: Fix blinking with some situation.
 180   * [VM/MC6809] Fix around CWAI with interrupts.
 181   * [VM/MC6809] Make set/reset E flag at interrupt.
 182   * [VM/MC6809] More accurate emulation(maybe).
 183   * [VM/MC6809] Fix clock count with some situation, FM-8/7/77/AV don't need dummycpu.
 184   * [VM/FM7] Remove DUMMY CPU.Reduce host-cpu usage a lot.
 185              Related to commit a4e1a7cfef59e08f31675c6608871068d3f2c4ef.
 186   * [EMU/FM7] emu.cpp : No longer use hack with some VMs.
 187   * [VM/FM7] KEYBOARD: Keep BREAK key when special reset (hot start).
 188   * [VM/FM7] MAINIO: Reduce hitting PCM1BIT:: when not sound buzzer.
 189   * [VM/FM7] DISK: Fix RPM value of 2D/2DD drive to 300rpm.
 190   * [VM/FM7] Read some (bulk) roms for FM-8/7/NEW7/77.This is WORK-IN-PROGRESS.
 191   * [VM/FM8/FM77] Add delay FIRQ/NMI from 2HD/SFD FDC.This is temporally implement.
 192   * [VM/FM8] MAINIO: Move FM-8 specified features to FM8_MAINIO:: .
 193   * [VM/FM77] Add initial support of 2HD (for FM-77).
 194   * [VM/FM77] Fix access around BOOT-RAM.Thanks to Ryu Takegami.
 195   * [VM/FM77] Extra memories should start $00000, not $10000.Thanks to Ryu Takegami.
 196   * [VM/FM77] Fix wrong answer at $FD04.Thanks to Ryu Takegami.
 197   * [VM/FM77AV] DISPLAY: Separate event process around VSYNC/HSYNC.
 198   * [VM/FM77AV40] Fix FTBFS with Fedora linux.
 199   * [VM/FM77AV40EX] Do not effect offset registers to VRAM-ACTIVE-BLOCK 1.Thanks to Ryu Takegami.
 200   * [VM/MB8877] No need to hack with PSY-O-BLADE for FM77AV.This is test delete.
 201   * [VM/MB8877] Force down DRQ when LOST-DATA happens.
 202   * [VM/MB8877] Fix not read status data at the endof SEEK and verifying.
 203   * [VM/MB8877] Update structure of MB8877->fdc.
 204   * [VM/MB8877] Try: Improbe result quality of FORCE_INTERRUPT command.
 205                  I expect to boot OS-9 Level1 for FM-77 with 2HD drive.Thanks to Haserin-san.
 206   * [VM/DISK] Fix default value ignore_crc_error and correct_disk_timing (mostly "to false").
 207   * [DOC] Add README.md (written in Japanese) and README.en.md (written in English) for GITHUB's cover page.
 208   * Special thanks to Ryu Takegami, to assist debugging FM-7/77/AV/40/EX/8 .
 209   * Special thanks to Haserin, to assist debugging FM-7/77.AV/40/EX/8.
 210   * Built with commit 221fcef002f101b8dffd2a63edfc11a86e2c688a or later.
 211
 212 -- Feb 11, 2018 02:29:55 +0900 K.Ohta <whatisthis.sowhat@gmail.com>
 213
 214 Upstream changes:
 215 * To see older upstream's changes, read history.txt.
 216
 217 12/27/2017
 218
 219 [EMU] support to restore sound frequency/latency settings when load state
 220
 221 [VM/DISK] support T98-NEXT nfd r0 floppy disk image
 222 [VM/DISK] support BKDSK hdm/hd5/hd4/hdb/dd9/dd6 floppy disk image
 223
 224
 225 12/15/2017
 226
 227 [COMMON/FILEIO] add Fcompare function
 228
 229 [VM/*] improve save/load state function to check device class name
 230 [VM/YM2151] fix save/load state function
 231
 232
 233 12/14/2017
 234
 235 [RESOURCE] change accelerators for switching full speed and roman/kana input
 236 [WINMAIN] fix to call ImmAssociateContext() in WM_ACTIVATE (thanks PC8801MA改)
 237
 238 [VM/HD46505] fix to force update event timing when R0-R9 are modified
 239 [VM/HUC6280] support to show clocks since starting scanline in debugger
 240 [VM/I286] support to show clocks since starting scanline in debugger
 241 [VM/I386] support to show clocks since starting scanline in debugger
 242 [VM/M6502] support to show clocks since starting scanline in debugger
 243 [VM/MC6800] support to show clocks since starting scanline in debugger
 244 [VM/MC6809] support to show clocks since starting scanline in debugger
 245 [VM/MCS48] support to show clocks since starting scanline in debugger
 246 [VM/TMS9995] support to show clocks since starting scanline in debugger
 247 [VM/UPD7220] fix to force update event timing when sync are modified
 248 [VM/UPD7801] support to show clocks since starting scanline in debugger
 249 [VM/UPD7810] support to show clocks since starting scanline in debugger
 250 [VM/Z80] support to show clocks since starting scanline in debugger
 251
 252 [X1TURBOZ/DISPLAY] fix pcg/analog palette access wait again (thanks Mr.Sato)
 253
 254
 255 12/12/2017
 256
 257 [VM/DISK] fix crc in id/data field (thanks Mr.Sato)
 258 [VM/HD46505] fix not to raise DISPTMG signal if bit2,3 of R8 are 11
 259
 260 [X1TURBOZ/DISPLAY] fix pcg/analog palette access wait (thanks Mr.Sato)
 261 [X1TURBOZ/DISPLAY] fix to draw each line at start of hblank (thanks Mr.Sato)
 262
 263
 264 -----
 265
 266
 267 Have fun!
 268 -- Ohta.
 269