| 1 | Release 4 (TBD)\r |
| 2 | ---------------\r |
| 3 | Git commit: TBD\r |
| 4 | -\r |
| 5 | 0) The zoom value setting has been fixed in the registry\r |
| 6 | 1) Debugger mode now shares the same alpine rom path setting\r |
| 7 | 2) Local variables window displays register name now\r |
| 8 | 3) Switch to Zlib 1.2.11 static library 64bits for VS 2017\r |
| 9 | 4) Switch to SDL 1.2.15 static library 64bits for VS 2017\r |
| 10 | 5) Local variables window displays values from function's parameters\r |
| 11 | 6) Fixed the typedef's name display in Local and Watch variables window\r |
| 12 | 7) Breakpoint may now occur in case of a ROM cartridge writing\r |
| 13 | -- ROM cartridge writing detection follow the alpine "allow writes to cartridge rom"'s flag check\r |
| 14 | -- 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\r |
| 15 | 8) Local variables window detects now if a variable is used or not by the code\r |
| 16 | 9) The address provided in the memory window is now verified to prevent crash\r |
| 17 | -- Wrong address will be displayed in red\r |
| 18 | 10) UI changes \r |
| 19 | -- Added new icons for the exit and status features\r |
| 20 | -- Modified icons for the SP (Stack) browser\r |
| 21 | -- Unified icons sizes depend on their usage (drop down menu and main menu)\r |
| 22 | -- Underline the active M68K line in the disassembly window\r |
| 23 | -- Allow the up/down navigation on the SP (Stack) browser\r |
| 24 | -- Restart function cleans-up the SP (Stack) browser and the heap allocator system\r |
| 25 | -- Fixed the up navigation on the memory window\r |
| 26 | 11) Added some log information for the emulator initialisations\r |
| 27 | 12) Breakpoint will happen in case of writing at unknown memory location\r |
| 28 | -- Alert box will display a message and then the code will stop\r |
| 29 | 13) Added the DRAM size in the emulator status window\r |
| 30 | 14) Debugger sources code clean-up\r |
| 31 | 15) Added a call stack feature\r |
| 32 | 16) Follow platform requirement to prevent source file reading issue\r |
| 33 | 17) UI modifications\r |
| 34 | -- Modified icon for the memory window to make a distinction with the memory browser\r |
| 35 | -- The all watch, and Exception Vector Table windows, can be closed using keyboard\r |
| 36 | -- Renamed the debugger dedicated icons to make a distinction\r |
| 37 | -- Added the call stack window\r |
| 38 | 18) Fixed a crash in the all watch window after loading a new binary without ELF/DWARF information\r |
| 39 | -- Previously used ELF/DWARF information was still accessible\r |
| 40 | 19) Fixed slash/backslash issue, in the Alpine tab, to follow platform requirement\r |
| 41 | 20) Heap allocation window uses the DRAM size limit option and detect if heap allocation shares space with SP (Stack)\r |
| 42 | 21) Added a Jaguar model and BIOS configuration tab\r |
| 43 | 22) Jaguar model and BIOS configuration integration\r |
| 44 | 23) Added LEB128 decoding functions\r |
| 45 | -- It is used for the DWARF decoding information\r |
| 46 | 24) Debugger support improvement\r |
| 47 | -- DWARF support for the enum type (partial), and subroutine type\r |
| 48 | -- Debugger can report variable's unsigned char value\r |
| 49 | 25) UI modifications\r |
| 50 | -- Added a status bar, better status report & information display for the heap allocation window\r |
| 51 | -- Added a status bar, better status report & information display for the local variables window\r |
| 52 | -- Added better information display for the exception vectors table window, and added some missing vectors\r |
| 53 | -- Added a status bar, better status report & information display for the call stack window\r |
| 54 | -- Added a status bar, better status report & information display for the all watches window\r |
| 55 | \r |
| 56 | Release 3 (13th November 2017)\r |
| 57 | ------------------------------\r |
| 58 | Git commit: b1b673a3b0d19e3c2c45b6590b773b11e45bced7\r |
| 59 | -\r |
| 60 | 0) Fixed the windows respawning in the next emulator launch within --alpine or --debugger options\r |
| 61 | 1) Added an Exception Vector Table window\r |
| 62 | 2) Modified the About window to update the credits list in a more appropriate way\r |
| 63 | -- Updated the emulator application credits line\r |
| 64 | 3) Added 'Rx' word to the emulator name\r |
| 65 | 4) Fixed a crash when reading the DWARF information in the case of the DWARF2 format has not been used\r |
| 66 | 5) Added ui, alpine and debugger groups in the settings\r |
| 67 | 6) Added the possibility to erase settings\r |
| 68 | 7) Added the --es-all, --es-ui, --es-alpine and --es-debugger options to erase specific settings\r |
| 69 | 8) Added a keybindings tab and adapted the configuration dialog tabs\r |
| 70 | -- User can modify the keybindings where appropriate\r |
| 71 | -- Keybindings UI is displayed based on the option used (--debugger, -- alpine)\r |
| 72 | 9) Fixed a crash, in Release mode, when the HW labels setting is turn on\r |
| 73 | 10) Solved an interference between the HW labels setting and the one used by the debugger\r |
| 74 | -- The setting is now only the reference used\r |
| 75 | 11) Fixed the SP (Stack) browser UI potential missing data\r |
| 76 | 12) Create a directory for EEPROMs (based on the EEPROMs setting) if it doesn't already exist\r |
| 77 | 13) Keep the scrollbar position in accordance of the M68K PC pointer\r |
| 78 | -- UI displays the source without the need to move down/up the scrollbar\r |
| 79 | 14) Fixed a crash when DWARF information report a source line number exceeding the number of lines present in a source file\r |
| 80 | -- This may come from the linker vlink\r |
| 81 | 15) Improved the .heap section detection to avoid a detection error\r |
| 82 | -- Depend vlink version, .heap section may have an Alloc flag\r |
| 83 | 16) Fixed a crash when DWARF information does references to missing source code files\r |
| 84 | 17) Added a local variables window\r |
| 85 | 18) Project has switched to Visual Studio 2017 and QT 5.9.1 library\r |
| 86 | \r |
| 87 | Release 2 (3rd September 2017)\r |
| 88 | ------------------------------\r |
| 89 | 0) Added some error detections when reading the ELF executable file\r |
| 90 | 1) Added all hardware labels (based on the document scans from the Version 2.4 - June 7, 1995)\r |
| 91 | 2) "Step Over" code function for BSR/JSR functions\r |
| 92 | 3) Added the .debug_ranges detection to avoid a detection error\r |
| 93 | 4) DWARF support\r |
| 94 | -- TAG: Compilation Unit, Subprogram, Variables, Types\r |
| 95 | -- Line numbers, symbols, functions\r |
| 96 | 5) Added an All Watch window for non-local variables\r |
| 97 | 6) Added a heap allocator window based on my own memory allocation functions\r |
| 98 | 7) Added additional 4 memory windows with address input based on hexa, decimal or symbol name\r |
| 99 | 8) Windows refreshing executed only if windows is visible\r |
| 100 | 9) Added a restart function\r |
| 101 | -- Restart only the 68000 program counter to his original set\r |
| 102 | 10) Modified the icons color backgound for the "Step In" and "Step Over" functions\r |
| 103 | 11) Updated the About window to update the credits list\r |
| 104 | 12) 64 bits Release executable\r |
| 105 | 13) Fixed (hacking) the display of the SP (Stack) browser\r |
| 106 | 14) Set the emulator in Halt mode when launched in alpine debug mode without a loaded rom\r |
| 107 | -- Otherwise the 68000 program counter will have a 0 value and will execute the code at this address\r |
| 108 | 15) Added some information in the --help/-h/-? option\r |
| 109 | 16) --debugger option no longer force the log file\r |
| 110 | 17) Added a --dram-max option to extend the DRAM size to 8MB\r |
| 111 | 18) Added the "enter" key support when setting the BPM (Breapoint)\r |
| 112 | 19) Save the windows positions, size and visibilities (show or hide) status\r |
| 113 | -- Such windows will automatically respawn in the next emulator launch\r |
| 114 | \r |
| 115 | Release 1 (12th February 2017)\r |
| 116 | ------------------------------\r |
| 117 | 0) BPM (Breapoint) now stop at the designated address and no longer stop after executing the code\r |
| 118 | 1) Clean-up the tracing / no-tracing flags for better U.I understanding\r |
| 119 | 2) Added SP (Stack) browser\r |
| 120 | 3) User can change now the number of lines of disassembly displayed in the tracing window\r |
| 121 | 4) User can turn on/off the op-codes associated in the disassembly lines displayed in the M68K tracing window\r |
| 122 | 5) Added an emulator status window (GPU status, M68K debugger and tracking status)\r |
| 123 | 6) Added a GPU disassembly tracing window - Display the current PC pointer\r |
| 124 | 7) Added a DSP disassembly tracing window - Display the current PC pointer\r |
| 125 | 8) Added possibility to change refresh rate of browsers when emulation is launched\r |
| 126 | 9) Display partial hardware labels (Internal Memory and Graphics sub-system address space) in the disassembly lines displayed in the M68K tracing window\r |
| 127 | -- Display first the hardware labels (based from the Jag V8 dev. PDF) and then the ones possibly found in the ELF debug symbol\r |
| 128 | 10) Minor U.I cosmetic changes\r |
| 129 | 11) User can turn on/off the hardware labels associated in the disassembly lines displayed in the M68K tracing window\r |
| 130 | -- It doesn't apply to the hardware labels possibly found in the ELF debug symbol\r |
| 131 | \r |
| 132 | Release 0 (5th January 2017)\r |
| 133 | ----------------------------\r |
| 134 | 0) New option --debugger\r |
| 135 | 1) ELF format support\r |
| 136 | 2) ELF debug symbol support\r |
| 137 | 3) "Step Into" code function\r |
| 138 | 4) Menus layout dedicated to the debugger\r |
| 139 | 5) Added a dedicated main window for tracing (M68K)\r |
| 140 | 6) Added a Debugger tab in the config tab\r |
| 141 | 7) Visual Studio 2015 project support\r |
| 142 | 8) libelf-0.8.13 library support\r |
| 143 | 9) 64 bits debug executable only\r |
| 144 | \r |
| 145 | \r |
| 146 | Known issues\r |
| 147 | ============\r |
| 148 | 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\r |
| 149 | 2) The BPM (Breapoint) remains stuck on his address when user wants to continue the code execution\r |
| 150 | -- Need to trace over the BPM or unset the BPM\r |
| 151 | -- The issue can be prevented if the code doesn't set IRQ, otherwise the IRQ will need to be traced to get back control\r |
| 152 | 3) To support DWARF 2 with GCC, the code must be compiled with the -gdwarf-2 option\r |
| 153 | 4) The Local and Watch variables window may display not available type information or empty information\r |
| 154 | -- Such missing information may be included in future release\r |
| 155 | -- The 'const' type may not be reported correctly in the DWARF information \r |
| 156 | 5) The 2MB mirroring is no longer applied in case of --dram-max option usage\r |
| 157 | 6) Stack must reflect the --dram-max option usage otherwise the stack may be corrupted\r |
| 158 | -- The application needs to set the SP (Stack) in accordance\r |
| 159 | 7) The Exception Vector Table window displays only 65 vectors\r |
| 160 | -- Missing vectors may be added in future release\r |
| 161 | 8) User needs to manualy check if the Atari Jaguar executable match his source code files\r |
| 162 | -- Otherwise, source code and assembly may not match or leads to instabilities\r |
| 163 | 9) The emulator needs to be restarted in case of the following actions occur\r |
| 164 | -- Keybindings changes\r |
| 165 | -- BIOS selection changes and without new executable load\r |
| 166 | 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\r |
| 167 | 11) Emulator will crash in case of wrong address value provided in the memory browser\r |
| 168 | 12) The RAM access log is limited to the 2MB\r |
| 169 | \r |
| 170 | Cosmetic / UX issues\r |
| 171 | ====================\r |
| 172 | 1) The SP (Stack) icon color backgound doesn't look similar with the other ones\r |
| 173 | 2) The SP (Stack) browser size always open at a forced size no matter if the size has been changed\r |
| 174 | 3) Not every features have associated keybindings\r |
| 175 | \r |
| 176 | Legacy issues/hints\r |
| 177 | ===================\r |
| 178 | 1) Emulator seems to have easter egg(s)\r |
| 179 | -- The option --yarrr displays a single message and end the application\r |
| 180 | -- Pressing F8, while in the main window, will create an extra message in the log file\r |
| 181 | 2) The --alpine option force the log file but it can be override if --no-log option is set after the --alpine option\r |
| 182 | \r |
| 183 | Project information\r |
| 184 | ===================\r |
| 185 | 1) Code based on the Shamus Hammons source code available via Gethub by the 12th September 2017 (2.1.3 Final)\r |
| 186 | 2) Visual Studio 2015/2017 project support for 64 bits\r |
| 187 | 3) libelf 0.8.13 library 64bits for VS 2015/2017\r |
| 188 | 4) libdwarf 1.41 library 64bits for VS 2015, cygwin64 and Msys2/MinGW64\r |
| 189 | 5) QT 5.5.1 library 64bits for VS 2015\r |
| 190 | 6) QT 5.9.1 library 64bits for VS 2017\r |
| 191 | 7) Zlib 1.2.8 library 64bits for VS 2015\r |
| 192 | 7) Zlib 1.2.11 library 64bits for VS 2017\r |
| 193 | 8) SDL 1.2.15 library 64bits for VS 2015/2017\r |
| 194 | 9) The original make files have been modified to follow the requirements and modifications\r |
| 195 | 10) The 'Rx' word has been added to the emulator name to make distinction with the official version\r |
| 196 | 11) The project source is set at https://github.com/djipi/Virtual-Jaguar-Rx\r |
| 197 | 12) GPLv3 file document has been renamed as LICENSE, to fit better the GitHub requirements\r |
| 198 | -- Text / License terms are the same\r |
| 199 | \r |
| 200 | \r |
| 201 | Download statistics\r |
| 202 | -------------------\r |
| 203 | jaguar64eu : 15 downloads for the Release 0 on the 12th Feb, 2017\r |
| 204 | jaguar64eu : 18 downloads for the Release 1 on the 21st May, 2017\r |
| 205 | No downloads statistics available for the Release 2\r |
| 206 | No downloads statistics available for the Release 3\r |