Rick's b.log - entry 2018/04/28

Easy tea

If you don't have a suitable T-Disc to take the barcode from, here is one:

More to do with Zap

All was fine, but I didn't fancy taking over maintaining Zap; what with it's licence status mostly "undefined" (such things were not a big issue in the mid '90s). The licence says:

Copyright of the application `Zap' is held by its authors 1992-2002.
No guarantee is made as to the reliability/stability of any part of Zap.
You may distribute Zap freely; however we request that you do not distribute Zap, except as you received it. This request is made in order to try to ensure that the options remain in their default state, and all help text is included. This should help make Zap easier to use for subsequent receivers of the program.

I am breaking this licence, since those who used to maintain Zap have moved on, and - well - where's the official "works on my Pi" release? ☺
That said, tank has made releases of Zap (mostly work to bring it up to speed on a real 32 bit system), then André Timmermans (fixing zero page issues), then me (some other fixes).

So, at this point, we have:

• The official release
• Extras to make the official release work on modern machines
• Extras to make the extras work
• Extras to make the extras of the extras work

So I've held off doing anything with Zap.

Until this week.

When a peculiar bug turned up.

You see, back in the 26 bit days, we had two Debuggers. We had the standard Acorn Debugger module that was functional but rather crap. Then we had Darren Salt's enhanced Debugger (many extra features, understands stuff like ADRL, NOP, LDRL, fixed some of the weird issues with Debugger, etc etc).
While Debugger these days is a lot more powerful (plus up to date), it is still lacking the flexibility of Darren's one. For instance, ADRL is now flagged as a Long ADR, but it appears in the disassembly as:

   ADR    R1,&00000580        ; Long ADR
   ADD    R1,R1,#&10          ; =16

   ADR    R1,&00000580        ; Long ADR
   ADRL   R1,&00000560        ; Long ADR target

Anyway, I digress. Darren made a Debugger, and he gave it version number 2.something to distinguish it from the standard Debugger.

Zap used the version number to detect which Debugger was loaded. And, well, with RISC OS 5.25 and the various enhancements to Debugger along the way, it has itself incremented to version 2.00.

At which point a useful feature of Zap, the ability to modify an instruction in-situ, suddenly stopped working.

Now Zap predates DADebug, so I had to "debug" (term used loosely) by using the time honoured tradition of dropping in SWI 256+7, which is essentially a VDU7 command. Then I'd put on headphones and run the code, waiting for the BEEP!. After a few times, I turned the volume down a tad. ☺

The problem was somewhere in the ASSEMBLE command, which is embedded directly into Zap in the Mode4 handler (that which handles the disassembly), but as it turns out, the command is not provided by Zap itself, but by the ZapBASIC extension.

Part of the code that builds the content of the minibuffer (the part that appears at the bottom of the window) is (this has been tidied):

prompt$l
 BL loaddisasm
 MOV R0,#0                  ; blat cache
 MOV R1,#0                  ; blat cache
 SWI XDebugger_Disassemble  ; blat cache
 BLVC carefully_getdisasmdata
 STRVC R0,local_disasmdata
 LDRVC R0,localrfive
 FNLDR R1,buf_detoken,VC
 MOVVC R2,#&100
 SWIVC XOS_ConvertHex8      ; start off with the address in hex
 FNLDR R0,buf_detoken,VC
 FNcallc Zap_MiniPrompt,VC  ; prompt = address + colon
 MOVVC R0,R6
 FNcallc Zap_ReadWord,VC    ; get the instruction
 LDRVC R1,localrfive
 MOVVC R7,R0
 BLVC like_Debugger_Disassemble
 FNRTS VS
 FNLDR R2,buf_detoken		; buffer to copy detokenised line

carefully_getdisasmdata
 FNJSR
 BL      checkseeifdisasmloaded
 BVS     gracefully_do_nothing
 MOV     R0,#0
 MOV     R1,#0
 SWI     XDebugger_63
 FNRTS

gracefully_do_nothing
 SUBS R14,R14,R14
 FNRTS

Now look at the first block of code again. It's pretty much all conditional on V being clear, until we fall out on the FNRTS in the penultimate line.

That is why the minibuffer was failing. The code incorrectly believed DebuggerPlus was present, issued a SWI not understood by regular Debugger, and the V set meant everything else would just not happen.

My fix was to do this:

carefully_getdisasmdata
 FNJSR
 FNRTS ; ##RICK##

 ; ##RICK## This appears to do something unusual if DebuggerPlus
 ;          is loaded, and it has the side effect of setting V
 ;          if not which messes up the rest of the Assemble function.
 ;          Fixes bug where the minibuffer doesn't work in RISC OS 5.25.

 BL      checkseeifdisasmloaded
 BVS     gracefully_do_nothing
 MOV     R0,#0
 MOV     R1,#0
 SWI     XDebugger_63
 FNRTS

gracefully_do_nothing
 SUBS R14,R14,R14
 FNRTS

You can pick up my latest tweaks here (version "rick-02").

For the hell of it, I built Zed, the Zap font editor. It's a bit crashy-crashy with UCS fonts, but otherwise seems to mostly work.

I have also disabled the DELWORDSTART and DELWORDEND commands (mapped in as Shift keypad * and #). These delete from the cursor position to the start/end of the current word, only it doesn't work. Crashes.

An outstanding problem is that the helper programs "MakeMenus" and "MenuConf" are not 32 bit. They appear to require "libgnu" and "coopt" - neither of which I have been able to find.
I have some source for "libgnu", but it won't build with the older AOF-compatible version of GCC because that isn't ARMv7 friendly; and I have no idea what the hell is going on with the current ELF version of GCC - can it even create AOF libraries? But, then, without coopt (whatever that is), I'm really no further forward.
The moral of this story - if your code depends upon some weirdo libraries, ensure that they (plus source) are available, or have some way of being found! [just tried Arcade, isn't there either!]

So that, I guess, is the status of Zap...

Your comments:

Please note that while I check this page every so often, I am not able to control what users write; therefore I disclaim all liability for unpleasant and/or infringing and/or defamatory material. Undesired content will be removed as soon as it is noticed. By leaving a comment, you agree not to post material that is illegal or in bad taste, and you should be aware that the time and your IP address are both recorded, should it be necessary to find out who you are. Oh, and don't bother trying to inline HTML. I'm not that stupid! ☺ ADDING COMMENTS DOES NOT WORK IF READING TRANSLATED VERSIONS.
 
You can now follow comment additions with the comment RSS feed. This is distinct from the b.log RSS feed, so you can subscribe to one or both as you wish.

No comments yet...

Add a comment (v0.11) [help?] . . . try the comment feed!
		Your name
		Your email	(optional)
		Validation	Are you real? Please type 57392 backwards.
		Your comment