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