Re: [Freemint-discuss] Disassembly of TOS 1.00 with Ghidra

[Vincent R. <vin...@fr...>]

On 12/01/2025 at 21:42, Thorsten Otto via Freemint-discuss wrote:
> Had partly success with my patched processor definition. The decompiler now 
> atleast does not barf on the linef-call anymore. A simple function now looks 
> like this:

Hats off! That's really cool.

I haven't tried the 68000mshort patch myself, yet. But you should try to 
contribute it upstream. I quickly saw it was only a new configuration file, 
so it shouldn't hurt other targets.

Regarding to Line-F calls, of course it's Atari specific. But it's the same 
problematic for Lisa/Mac Line-A calls, so some global solution should be 
found. I.e. some optional settings, or even a new "language" specific to Atari.

On my side, I wrote a script named EnhancedDisassemble:
https://github.com/disastos/tos100fr/blob/main/ghidra_scripts/EnhancedDisassemble.java

Basically, it's the same as 'D' (disassemble), but it also handles Line-F as 
"dw" + reference (my other script). It was very useful, as I managed to 
easily and quickly disassemble the whole ROM. The result is pretty clean in 
the Listing (disassembly) view. Of course, this is only a workaround, as 
this doesn't fix the decompile view (unlike your language patch). I pushed 
the result.

Another hint, not sure if it is well-known.
This is about the book "Atari ST Intern" from Data Becker.

I've got some French version named "Le livre du développeur sur Atari ST" 
(Micro Application, 1989). This edition includes, at the end, a full 
disassembly of the BIOS for German TOS 1.00 and TOS 1.02. Comments are 
translated to French. But for some functions, labels are mentioned. It seems 
that the authors had somehow access to the original labels. So this seems to 
be a good source for original BIOS labels.

The English translation is "Atari ST Internals", by Abacus Software.
The 3rd edition is on the Atari Document Archive.
https://docs.dev-docs.org/
See "Out of Print Books" on the left, then "Atari ST - Internals (Abacus #2, 
3rd edition) [Jan 1988]".
At the end, there is the disassembly of German TOS 1.0, with English 
comments. And some original labels, as I said.

The code before the keyboard handler matches perfectly with tos100fr.img. 
But as Thorsten said, the code after is shifted by a few bytes, due to 
language differences. Anyway, it's a good thing to be able to find multiple 
sources of information.

-- 
Vincent Rivière