32Bit !ARM_Deb32 Release Notes for RPi and Risc OS 5.

1.99 Beta Testing Release

Changes from Theo's 1.33 release:
--------------------------------

1. Renamed application to !ARM_Deb32. Allows the 26bit
!ARM_Debug to co-exist. Original version should still run
on Aemultor etc. (i.e. for '26bit' code).

2. MODE 31 4bpp is not currently supported on RO5. I have hacked
Theo's MODE 31 graphics code to make it work on RO5.

Original Mode 15 graphics code unchanged and largely untested.

3. Updated ARM code to use the CPSR etc. instead of R15. All the
usual changes for converting from 26bit->32bit. SPSRs not
currently supported.

4. Added some extra functionality: 

a). Can now output current instruction and 16 registers with
PSR to text log file.

b). Output log file size limit removed.  

c). Address on module 'page' now shown as an offset (e.g. +10BC)
instead of a module address (e.g. 201FF074). Note: Offset to
a particular instruction remains constant, whereas on RO5 the
module addresses change slightly each time the RPi is reset.

5. Only USR and SVC modes are supported (same as Theo's version).

6. Log file now closed when a processor abort is detected.

7. Application break now inserts a single 'SWI' instruction
instead of the 'B' instruction (not enough bits for 32-bit
jumps). New SWI breaks into application code (e.g. 8000->
onwards) and seems to work. 

Future Plans:
------------

1. Add an auto-config file for setting breakpoints. At present
each time you reset your RPi you have to re-configure all the
breakpoints using the menus provided. This takes ages if you
have multiple incarnations of !ARM_Debug in use.

2. At present the usual RO5 error vectors are trapped and
a suitably error message is produced on the screen. Pressing
escape allows you to exit gracefully. Plan to add a 
configuration method so that the new-style RO5 debugger crash-
dump file can be outputted instead. 

These new RO5 debugger crash-dumps can be very useful especially
when they show SVC stack details etc.

3. Add support for instructions that use SPSR_usr and SPSR_svc.

4. Add support for some other 32bit instructions e.g.
co-processor instructions etc.

Known Bugs
----------

I believe that !ARM_Deb32 works well enough to be useful, so I'm
giving it a limited release even though I'm still working on
some bugs. Bugs that I'm currently investigating are:

1. Return from CTRL-SHFT-minus causes an abort in the kernel.

2. Module 'Find' function is not finding anything.

3. There's also probably other stuff that I've not even
looked at yet!
