diff --git a/docs/debugger.html b/docs/debugger.html index f04704cd3..37491ee5a 100644 --- a/docs/debugger.html +++ b/docs/debugger.html @@ -89,7 +89,7 @@ feature that no other 2600 debugger has; it's completely cross-platform.<
This is a spreadsheet-like GUI for inspecting and changing the contents -of the 2600's RAM. You can view 128 bytes of RAM at a time, starting with -the RAM built in to the console (zero-page RAM). If a cartridge contains -extended RAM, a scrollbar will be activated, allowing to scroll in -sequence through each 128 byte 'bank' of RAM. The address in the upper left -corner indicates the offset (in terms of the read port) for the bank -currently being displayed.
+of the 2600's zero-page RAM.You can navigate with either the mouse or the keyboard arrow keys. To change a RAM location, either double-click on it or press Enter while it's highlighted. Enter the new value (hex only for now, sorry), then @@ -914,13 +913,6 @@ press Enter to make the change. If you change your mind, press Escape and the original value will be restored. The currently selected RAM cell can also be changed by using the Data operations buttons/associated shortcut keys (J).
-Note: Many extended RAM schemes involve different addresses for -reading versus writing RAM (read port vs. write port). The UI takes care -of this for you; although the addresses shown are for the read port, -modifying a cell will use the write port. Also, some bankswitching -schemes can swap RAM and ROM dynamically during program execution. In -these cases, the values shown may not always be for RAM, and may point -to ROM instead. In the latter case, the data cannot be modified.
The 'Undo' button in the upper right should be self-explanatory; it will undo the most previous operation to one cell only. The 'Revert' button is @@ -934,7 +926,7 @@ The remaining buttons to the right are further explained in section (L).
The RAM widget also lets you search memory for values such as lives or remaining energy, but it's also very useful when debugging to determine which memory location holds which quantity.
@@ -1142,6 +1134,30 @@ An example of both 4K (non-bankswitched) and DPC (Pitfall II) is as follows: Go ahead and try to change something! + +If applicable, this area shows a detailed breakdown of any extra RAM supported by +the bankswitching scheme. Since the bankswitch schemes can greatly vary in operation, +this tab will be different for each scheme, but its specific functionality should be +self-explanatory. An example of both F8SC (8K Atari + ram) and DPC (Pitfall II) is +as follows:
+ +The RAM is shown in a grid similar to how zero-page RAM is shown in M6532/RIOT RAM +(K) and (L). See those sections for a description of usage. + +
In the cases where RAM is always mapped into the same place in the cartridge
+address space (such as Sara-chip), the RAM addresses are labeled as such. In other
+cases, such as when the RAM is either quiescent (and mapped in at different places),
+or not viewable by the 6507 at all, the RAM addresses are labeled as the cart sees them.
+In the examples above, F8SC RAM is labeled starting at its read port, or $F080. However,
+the RAM in the DPC scheme is not viewable by the 6507, so its addresses start from $0.
+
+
Note that these EEPROM files will be created when necessary, and initialized as a real EEPROM would be (containing all $FF). The files can be manually deleted, which is very useful in testing - cases where a ROM is accessing the EEPROM for the first time.
+ cases where a ROM is accessing the EEPROM for the first time. You can also + use the debugger to reset the EEPROM to a clean state.