X-Git-Url: http://git.hcoop.net/clinton/Virtual-Jaguar-Rx.git/blobdiff_plain/3d4ceeee9b7ec0cf84751b7ce3d24f31aaa81f66..a8c13b4d8cfc7a20452e25000028d5e87b24e454:/docs/vj_ReleaseNotes.txt diff --git a/docs/vj_ReleaseNotes.txt b/docs/vj_ReleaseNotes.txt index d083f92..db03424 100644 --- a/docs/vj_ReleaseNotes.txt +++ b/docs/vj_ReleaseNotes.txt @@ -1,112 +1,175 @@ -Release 3 (TBC) ---------------- -0) Fixed the windows respawning in the next emulator launch without --alpine or --debugger options -1) Added an Exception Vector Table browser window -2) Modified the About window to update the credits list in a more appropriate way --- Updated the emulator application credits line -3) Added 'Rx' word to the emulator name to make distinction with the original version - -Release 2 (3rd September 2017) ------------------------------- -0) Added some error detections when reading the ELF executable file -1) Added all hardware labels (based on the document scans from the Version 2.4 - June 7, 1995) -2) "Step Over" code function for BSR/JSR functions -3) Added the .debug_ranges detection to avoid a detection error -4) DWARF support --- TAG: Compilation Unit, Subprogram, Variables, Types --- Line numbers, symbols, functions -5) Added an All Watch browser window for non-local variables -6) Added a heap allocator browser window based on my own memory allocation functions -7) Added additional 4 memory browser windows with address input based on hexa, decimal or symbol name -8) Windows refreshing executed only if windows is visible -9) Added a restart function --- Restart only the 68000 program counter to his original set -10) Modified the icons color backgound for the "Step In" and "Step Over" functions -11) Updated the About window to update the credits list -12) 64 bits Release executable -13) Fixed (hacking) the display of the SP (Stack) memory browser -14) Set the emulator in Halt mode when launched in alpine debug mode without a loaded rom --- Otherwise the 68000 program counter will have a 0 value and will execute the code at this address -15) Added some information in the --help/-h/-? option -16) --debugger option no longer force the log file -17) Added a --dram-max option to extend the DRAM size to 8MB -18) Added the "enter" key support when setting the BPM (Breapoint) -19) Save the windows positions, size and visibilities (show or hide) status --- Such windows will automatically respawn in the next emulator launch - -Release 1 (12th February 2017) ------------------------------- -0) BPM (Breapoint) now stop at the designated address and no longer stop after executing the code -1) Clean-up the tracing / no-tracing flags for better U.I understanding -2) Added SP (Stack) memory browser -3) User can change now the number of lines of disassembly displayed in the tracing window -4) User can turn on/off the op-codes associated in the disassembly lines displayed in the M68K tracing window -5) Added an emulator status window (GPU status, M68K debugger & tracking status) -6) Added a GPU disassembly tracing window - Display the current PC pointer -7) Added a DSP disassembly tracing window - Display the current PC pointer -8) Added possibility to change refresh rate of browser windows when emulation is launched -9) Display partial hardware labels (Internal Memory & Graphics sub-system address space) in the disassembly lines displayed in the M68K tracing window --- Display first the hardware labels (based from the Jag V8 dev. PDF) and then the ones possibly found in the ELF debug symbol -10) Minor U.I cosmetic changes -11) User can turn on/off the hardware labels associated in the disassembly lines displayed in the M68K tracing window --- It doesn't apply to the hardware labels possibly found in the ELF debug symbol - -Release 0 (5th January 2017) ----------------------------- -0) New option --debugger -1) ELF format support -2) ELF debug symbol support -3) "Step Into" code function -4) Menus layout dedicated to the debugger -5) Added a dedicated main window for tracing (M68K) -6) Added a Debugger tab in the config tab -7) Visual Studio 2015 project support -8) libelf-0.8.13 library support -9) 64 bits debug executable only - - -Known issues -============ -1) Video output is not displayed due to OpenGL / QT5 integration problems with VS 2015 -2) The BPM (Breapoint) remains stuck on his address when user wants to continue the code execution --- Need to trace over the BPM or unset the BPM -3) To handle DWARF 2 issues with GCC, the code must be compiled with the -gdwarf-2 option -4) The Watch variables list may display not available (N/A) type information --- Such missing information may be included in future release -5) The 2MB mirroring is no longer applied in case of --dram-max option usage -6) Stack must reflect the --dram-max option usage otherwise the stack may be corrupted --- The application needs to set the SP (Stack) in accordance -7) The Exception Vector Table broswer window displays only 65 vectors --- Missing vectors may be added in future release - -Cosmetic / UX issues -==================== -1) The SP (Stack) icon color backgound doesn't look similar with the other ones -2) The emulator status option has no icon -3) The SP (Stack) window size always open at a forced size no matter if the size has been changed - -Legacy issues/hints -=================== -1) Emulator seems to have easter egg(s) --- The option --yarrr displays a single message and end the application -2) The --alpine option force the log file but it can be override if --no-log option is set after the --alpine option - -Project information -=================== -1) Code based on the Shamus Hammons source code available via Gethub by the 13th June 2016 -2) Visual Studio 2015 project support for 64 bits -3) libelf 0.8.13 library 64bits for VS 2015 -4) libdwarf 1.41 library 64bits for VS 2015, cygwin64 & Msys2/MinGW64 -5) QT 5.5.1 library 64bits for VS 2015 -6) Zlib 1.2.8 library 64bits for VS 2015 -7) SDL 1.2.15 library 64bits for VS 2015 -8) The original make files have been modified to follow the requirements and modifications -9) The 'Rx' word has been added to the emulator name to make distinction with the original version -10) The project source is set at https://github.com/djipi/Virtual-Jaguar-Rx - - -Download statistics -------------------- -jaguar64eu : 15 downloads for the Release 0 on the 12th Feb, 2017 -jaguar64eu : 18 downloads for the Release 1 on the 21st May, 2017 -No downloads available for the Release 2 \ No newline at end of file +Release 4 (TBD) +--------------- +0) The zoom value setting has been fixed in the registry +1) Debugger mode now shares the same alpine rom path setting +2) Local variables window displays register name now +3) Switch to Zlib 1.2.11 static library 64bits for VS 2017 +4) Switch to SDL 1.2.15 static library 64bits for VS 2017 +5) Local variables window displays values from function's parameters +6) Fixed the typedef's name display in Local and Watch variables window +7) Breakpoint may now occur in case of a ROM cartridge writing +-- ROM cartridge writing detection follow the alpine "allow writes to cartridge rom"'s flag check +-- Alert box will display a message with possibility to pass or not the breakpoint only if this is related to a 8 or 16 bits ROM access +8) Local variables window detects now if a variable is used or not by the code +9) The address provided in the memory window is now verified to prevent crash +-- Wrong address will be displayed in red +10) Cosmetic changes on UI +-- Added new icons for the exit and status features +-- Modified icons for the SP (Stack) browser +-- Unified icons sizes depend on their usage (drop down menu and main menu) +-- Underline the active M68K line in the disassembly window +-- Allow the up/down navigation on the SP (Stack) browser +-- Restart function cleans-up the SP (Stack) browser and the heap allocator system +11) Fixed the up navigation on the memory window +12) Added some log information for the emulator initialisations +13) Breakpoint will happen in case of writing at unknown memory location +-- Alert box will display a message and then code will stop + +Release 3 (13th November 2017) +------------------------------ +Git commit: b1b673a3b0d19e3c2c45b6590b773b11e45bced7 +- +0) Fixed the windows respawning in the next emulator launch within --alpine or --debugger options +1) Added an Exception Vector Table window +2) Modified the About window to update the credits list in a more appropriate way +-- Updated the emulator application credits line +3) Added 'Rx' word to the emulator name +4) Fixed a crash when reading the DWARF information in the case of the DWARF2 format has not been used +5) Added ui, alpine and debugger groups in the settings +6) Added the possibility to erase settings +7) Added the --es-all, --es-ui, --es-alpine and --es-debugger options to erase specific settings +8) Added a keybindings tab and adapted the configuration dialog tabs +-- User can modify the keybindings where appropriate +-- Keybindings UI is displayed based on the option used (--debugger, -- alpine) +9) Fixed a crash, in Release mode, when the HW labels setting is turn on +10) Solved an interference between the HW labels setting and the one used by the debugger +-- The setting is now only the reference used +11) Fixed the SP (Stack) browser UI potential missing data +12) Create a directory for EEPROMs (based on the EEPROMs setting) if it doesn't already exist +13) Keep the scrollbar position in accordance of the M68K PC pointer +-- UI displays the source without the need to move down/up the scrollbar +14) Fixed a crash when DWARF information report a source line number exceeding the number of lines present in a source file +-- This may come from the linker vlink +15) Improved the .heap section detection to avoid a detection error +-- Depend vlink version, .heap section may have an Alloc flag +16) Fixed a crash when DWARF information does references to missing source code files +17) Added a local variables window +18) Project has switched to Visual Studio 2017 and QT 5.9.1 library + +Release 2 (3rd September 2017) +------------------------------ +0) Added some error detections when reading the ELF executable file +1) Added all hardware labels (based on the document scans from the Version 2.4 - June 7, 1995) +2) "Step Over" code function for BSR/JSR functions +3) Added the .debug_ranges detection to avoid a detection error +4) DWARF support +-- TAG: Compilation Unit, Subprogram, Variables, Types +-- Line numbers, symbols, functions +5) Added an All Watch window for non-local variables +6) Added a heap allocator window based on my own memory allocation functions +7) Added additional 4 memory windows with address input based on hexa, decimal or symbol name +8) Windows refreshing executed only if windows is visible +9) Added a restart function +-- Restart only the 68000 program counter to his original set +10) Modified the icons color backgound for the "Step In" and "Step Over" functions +11) Updated the About window to update the credits list +12) 64 bits Release executable +13) Fixed (hacking) the display of the SP (Stack) browser +14) Set the emulator in Halt mode when launched in alpine debug mode without a loaded rom +-- Otherwise the 68000 program counter will have a 0 value and will execute the code at this address +15) Added some information in the --help/-h/-? option +16) --debugger option no longer force the log file +17) Added a --dram-max option to extend the DRAM size to 8MB +18) Added the "enter" key support when setting the BPM (Breapoint) +19) Save the windows positions, size and visibilities (show or hide) status +-- Such windows will automatically respawn in the next emulator launch + +Release 1 (12th February 2017) +------------------------------ +0) BPM (Breapoint) now stop at the designated address and no longer stop after executing the code +1) Clean-up the tracing / no-tracing flags for better U.I understanding +2) Added SP (Stack) browser +3) User can change now the number of lines of disassembly displayed in the tracing window +4) User can turn on/off the op-codes associated in the disassembly lines displayed in the M68K tracing window +5) Added an emulator status window (GPU status, M68K debugger and tracking status) +6) Added a GPU disassembly tracing window - Display the current PC pointer +7) Added a DSP disassembly tracing window - Display the current PC pointer +8) Added possibility to change refresh rate of browsers when emulation is launched +9) Display partial hardware labels (Internal Memory and Graphics sub-system address space) in the disassembly lines displayed in the M68K tracing window +-- Display first the hardware labels (based from the Jag V8 dev. PDF) and then the ones possibly found in the ELF debug symbol +10) Minor U.I cosmetic changes +11) User can turn on/off the hardware labels associated in the disassembly lines displayed in the M68K tracing window +-- It doesn't apply to the hardware labels possibly found in the ELF debug symbol + +Release 0 (5th January 2017) +---------------------------- +0) New option --debugger +1) ELF format support +2) ELF debug symbol support +3) "Step Into" code function +4) Menus layout dedicated to the debugger +5) Added a dedicated main window for tracing (M68K) +6) Added a Debugger tab in the config tab +7) Visual Studio 2015 project support +8) libelf-0.8.13 library support +9) 64 bits debug executable only + + +Known issues +============ +1) Video output is not displayed due to my OpenGL / QT5 5.5.1 integration with VS 2015 but solved when using the QT 5.9.1 package for VS 2017 +2) The BPM (Breapoint) remains stuck on his address when user wants to continue the code execution +-- Need to trace over the BPM or unset the BPM +-- The issue can be prevented if the code doesn't set IRQ, otherwise the IRQ will need to be traced to get back control +3) To support DWARF 2 with GCC, the code must be compiled with the -gdwarf-2 option +4) The Local and Watch variables window may display not available (N/A) type information +-- Such missing information may be included in future release +5) The 2MB mirroring is no longer applied in case of --dram-max option usage +6) Stack must reflect the --dram-max option usage otherwise the stack may be corrupted +-- The application needs to set the SP (Stack) in accordance +7) The Exception Vector Table window displays only 65 vectors +-- Missing vectors may be added in future release +8) User needs to manualy check if the Atari Jaguar executable match his source code files +-- Otherwise, source code and assembly may not match or leads to instabilities +9) The emulator needs to be restarted in case of keybindings changes +10) In the case of a ROM cartridge writing, and with occuring breakpoint, the PC pointer will point at the next instruction and not at the instruction causing the breakpoint +11) Emulator will crash in case of wrong address value provided in the memory browser +12) The RAM access log is limited to the 2MB + +Cosmetic / UX issues +==================== +1) The SP (Stack) icon color backgound doesn't look similar with the other ones +2) The SP (Stack) browser size always open at a forced size no matter if the size has been changed +3) Not every features have associated keybindings + +Legacy issues/hints +=================== +1) Emulator seems to have easter egg(s) +-- The option --yarrr displays a single message and end the application +-- Pressing F8, while in the main window, will create an extra message in the log file +2) The --alpine option force the log file but it can be override if --no-log option is set after the --alpine option + +Project information +=================== +1) Code based on the Shamus Hammons source code available via Gethub by the 12th September 2017 (2.1.3 Final) +2) Visual Studio 2015/2017 project support for 64 bits +3) libelf 0.8.13 library 64bits for VS 2015/2017 +4) libdwarf 1.41 library 64bits for VS 2015, cygwin64 and Msys2/MinGW64 +5) QT 5.5.1 library 64bits for VS 2015 +6) QT 5.9.1 library 64bits for VS 2017 +7) Zlib 1.2.8 library 64bits for VS 2015 +7) Zlib 1.2.11 library 64bits for VS 2017 +8) SDL 1.2.15 library 64bits for VS 2015/2017 +9) The original make files have been modified to follow the requirements and modifications +10) The 'Rx' word has been added to the emulator name to make distinction with the official version +11) The project source is set at https://github.com/djipi/Virtual-Jaguar-Rx +12) GPLv3 file document has been renamed as LICENSE, to fit better the GitHub requirements +-- Text / License terms are the same + + +Download statistics +------------------- +jaguar64eu : 15 downloads for the Release 0 on the 12th Feb, 2017 +jaguar64eu : 18 downloads for the Release 1 on the 21st May, 2017 +No downloads statistics available for the Release 2 +No downloads statistics available for the Release 3