DeepBrainActivity proudly presents,       

TI92DASM for TI89/92+ DoorsOS program under DOS

by Kty & Fred (c)1998-1999

TABLE OF CONTENTS

    We can't be held responsible for whatever could happen( or not!) to your TI92+/89. That is to say there is no warranty that our system will recover data in any cases and that it won't damage your calculator. But keep in mind that it would be extremely unlikely that software could damage hardware...

    TI92dasm is a very powerfull disassembler for DoorsOS/PlusShell programs for TI92+ and TI89.

It features :

• Automatic distinction between codes and data (but if not sure, parts from the executable are considered as data).
• Automatic labels naming (Lxxx) for labels that are not _main, _comment, _exit and not listed in DB92 symbollic information.
• Run time commands given in a file having for exemple the same name as the disassembled file but ending with .nfo and given as an optionnal second parameter to TI92dasm. Commands are among :  EntryPoint and StopPoint to help the disassembler choose between data and code and FindStrings to make it try to find data that could be strings.
• Recompilable output file... You can even compare original executable and reassembled one (e.g. : using fc) and find no difference (if you use the same version of DoorsOS/PlusShell that has been originally used) but things that does not matter (e.g. : some ROM_CALLs calls that are erased at runtime by the kernel during the relocation process may contain non nulls values...). That's why binary code is stored at the end of the disassembled line after a ";".

It recognizes :

• ROM_CALLs
• RAM_CALLs
• Import table (library calls)
• Export table (for programs that export symbols or for libraries)
• BSS
• DB92's symbolic information

• TI92DASM.exe        THE disassembler.
• \Source                       The source code to TI92DASM
• \Examples                    Three examples from DoorsOS distribution. Thanks to Xavier Vassor for his authorization.

Using the program

The disassembler is called this way : TI92dasm <file to disassemble> [<.nfo file>].

Note that it disassembles to stdout so that you need to put ">name.asm" at the end of the line if you want the disassembled text to be stored in the file name.asm.

See examples for how to use .nfo.

You cannot disassemble big files.

Some instruction may be badly disassembled including movem (we'll try to correct this because it's very anoying, but you can replace bad disassembled code with dc.w).

Branches (Bcc and BRA and BSR) that have a word relative offset are disassembled but after a ";" and replaced by dc.w ... because of a bug in a68k which optimizes branches to .s (rather than .w) even if .w specified. But as the offset is calculated at recompilation time, you can add instructions in the disasembled file between such branches and labels.