Crawly Crypt Collection 1

home *** CD-ROM | disk | FTP | other *** search

/ Crawly Crypt Collection 1 / crawlyvol1.bin / program / compiler / reass_us / document / reassemb.doc

Wrap

Text File | 1994-04-18 | 18.1 KB | 489 lines

************************************ * 8-bit CPU Reassembler package * * incl. PurePASCAL GEM source code * ************************************ Program author : Jens Schulz Rosenstrasse 5 D-25368 Kiebitzreihe Germany **************************************************************************** Reassembler package for these 8-bit CPU processors : ---------------------------------------------------- - INTEL 8051/52/252/535 microcontroller - INTEL 8048 microcontroller series - Zilog Z-80 CPU - Mostek/Rockwell 6502-CPU - Motorola 68HC11 microcontroller - INTEL 8080/85-CPU ***************************************************************************** System: ATARI ST/TT/FALCON GEM / MultiTOS screen resolution independent > 640*400 dots requires 1 MB RAM **************************************************************************** These programs are Freeware You can copy and swap these programs freely without any charge. Sale or use in any other software for profit is strict forbidden. It's free for BBS downloading and PD collections. *************************************************************************** What's a reassembler ? ---------------------- First, let's talk about the PurePASCAL GEM source code. If you are a GFA- or OMIKRON BASIC programmer, you can learn GEM programming under PurePASCAL. I've put the complete PurePASCAL 1.1 GEM source code of the 8080/85 reassemb- ler in the folder SOURCE85.PAS. The source code is very useful for learning the main aspects of screen resolution independent GEM programming. The source code shows you the handling of dialogues, GEM redraws, VDI 109 and dynamic memory allocations. I've programmed in many programming languages GEM programs. PurePASCAL is the easiest way to learn GEM. Forget all these 'damned' BASIC POKES and use the power of PP GEM-handling. PP GEM programming is easier than C GEM handling. Reassembler ----------- Reassembler are very useful for decoding machine language programs. If you've never programmed 8-bit CPU's in assembler, you don't need these programs. You can only use the PP source code for your own programs. Next chapters are only for assembler experts : ---------------------------------------------- A reassembler is an extended disassembler. It can decode machine programs with mnemonics and labels. Reassemblers insert labels of jumps or absolute addresses in the disassembler listing. Reassembler listing are address independent. You can use the generated ASCII outputs for your assembler programs. The Z80- and 6502 reassembler additional support the symbolic reassembling. Normally the reassemblers produce automatic labels, like LXXXX. XXXX is the hexadecimal address of the label. Symbolic reassemblers can exchange these automatic labels with symbolic names. Symbolic reassemblers need a symbol table. These symbol tables exist often for the standard home computers (C64, Amstrad CPC 464 etc.). These home computers use 6502 or Z 80 CPU's. Who uses a reassembler ? ------------------------ 1.) very rare use : You believe, that your high level compiler codes ineffective or wrong code. 2.) rare use : You've formatted or lost your assembler source code of your last machine control board programming. 3.) normal use : You've got a program from a programming competitor. You will do all for cracking his 'Hyperpokes'. 4.) worst case : The competitor uses self modifying code or the microcontroller allows the the locking of the ROM, like 68HC11. That's the worst case for reassembler use. **************************************************************************** General handling of the reassemblers ------------------------------------ The six reassemblers have only a few differences in their programming handling. The most menu entries are equal. Special functions of each reassembler is described in a separate info file. 1. Max. code size for the reassemblers --------------------------------------- The max. size of a code block is restricted to 8 KByte, why ? 8 KB machine code produces thousands of reassembler lines. The reassembler label handling allows the addition of code segments. Additional, you can concat the ASCII outputs with a standard ASCII editor. 2. Reassembling of the code --------------------------- - load your max. 8 KB code file (.BIN) from disc (Menu File) - reassemble the code with the key F1 or the menu entry 'Reassemble' - the reassembler decodes the whole binary code segment with all machine command and symbolic labels. - you can scroll the output listing with mouse or cursor keys and change the output window size. 3. Set of the start address (ORG) --------------------------------- Normally, the reassembler uses the base address $0000 for the code start. This code start address is called the origin address (ORG). You can set this ORG address on a new value, for example $1000. -> Menu File, Set start address 4. Set of a file offset ----------------------- Normally, the reassembler starts at the first byte of your binary code file. You can change the reassembler start in your file. For example, you set this file offset to $100. Now, the reassembler ignores the first 256 bytes of your binary code file. The second way is the split of your code file with a debugger. -> menu File, set start address 5. Reduction of the reassembler ASCII output -------------------------------------------- The reassembler produces an enormous number of output lines. You can limit the number of bytes for decode. You must set to max. reassembler decode length in the menu File (Set start address). Normally, the reassembler decodes the whole code block. For example, you can limit the max. reassembler decode length to 100 bytes. 6. Jump to a code address ------------------------- You can use the cursor keys or the mouse for the scrolling of the reassembler output. Additional, you can jump to a specified code address. -> Menu file, Jump to address Please input the hexadecimal address of the new output listing start. 7. Hiding of code and addresses ------------------------------- Normally, the reassembler output includes code, addresses, mnemonics and label. Code and addresses aren't needed for assemblers. Assemblers only use label und mnemonics for new compilations. -> Set hiding of code and addresses (Menu File, Show code/addresses) 8. Reassembler output as ASCII file or printer output ----------------------------------------------------- You can store or print reassembler outputs. -> Menu Output, Printer or File After the selection of printer or file, you must reassemble the code. ************************************************************************** Label handling / Symbolic reassembling -------------------------------------- 1. Label handling ----------------- The reassembler uses a 64 KB array for storing label positions. This label list is normally cleared by every reassembler start. The menu entry 'Clear automat. label' sets or resets the automatic clear of this label list. You can disable the automatic clearing of this list. Now, you can add several other code blocks to the label list. This option is very useful for the detection of jumps from other code segments in the actual code segment. 2. Save label file ------------------ You can save the actual label list on disc for later analysis of the code. Label list files have the file extension .LAB. 3. Load label file ------------------ You can load the 64 KB label list file from disc. The clear of the label list will be disabled. Symbolic reassembling --------------------- Symbolic reassembling is only supported by the Z-80 and 6502 reassembler. Z80 and 6502 processor are often used for home computers, like C64 or Amstrad CPC 464. For these home computers exist symbol tables of important ROM and port addresses. Main differences between disassembler and reassembler decoding : ---------------------------------------------------------------- - Disassembler : generates jumps/absolute addresses in hexadecimal terms, like LDA $12AE - Standard reassembler : generates jumps/absolute addresses in auto- matic labels, like LDA L12AE. Reassembler outputs are address independent for assemblers. - Symbolic reassembler : generates jumps/absolute addresses with your symbols, like LDA VALUE_1. You can find important ROM and port addresses much easier. 1. Definition of symbols ------------------------ - max. 2000 symbols are allowed - max. symbol length = 8 characters All symbols are written with a standard ASCII editor in an ASCII file. The ASCII file has the file extension .LBI. The symbol addresses must be specified in hexadecimal form. Symbol file example (6502.LBI): ------------------------------- POS_1=203 LOOP=20D LOOP_1=214 SET_TST=219 PROC_1=223 PROC_2=22E VALUE_1 = 68 VALUE_2 = 69 2. Import of ASCII symbols : ---------------------------- -> Menu Symbols, Import symbols Symbol file has the file extension .LBI. The reassembler imports this file and sort it by address. Now you can use this symbols for your next reassembler run. 3. Generating of a symbol file ------------------------------ After the import of a symbol file, you can generate a compact label file. This label file stores all symbolic informations in a compact and sorted form. This label file will be loaded faster than a ASCII symbol list. Label symbol files has the file extension .SYM. 4. Load a symbol file --------------------- The menu entry loads compact label symbol files with the file extension .SYM. *************************************************************************** Colors of reassembler lines --------------------------- If you use the reassembler with color monitor (min. 640*400 16 colors), then the reassembler use colored lines for extra informations. - Red color : address has a label - Black color : mnemonic has absolute address/jump - Blue color : no label/absolute information The color red has the main priority. It can overwrite black informations with red informations. *************************************************************************** Special control und port addresses ---------------------------------- The INTEL 8051-series and the Motorola 68HC11 have special function registers. The reassembler use this SFR names instead of automatic labels. The 68HC11 reassemblers allows the disabling of this register name display. Keyboard shortcuts ------------------ Overview of the standard keyboard shortcuts of all reassemblers. Menu File --------- Load code Control L Set start address Control S Jump to address Control A Reassemble Key F1 Exit program Control Q Menu Output ----------- Screen Control B Printer Control P File Control F Menu Label ---------- Load label file Control T Save label file Control N Clear autom. label Control C ***************************************************************************** Source code of the 8080/85 reassembler -------------------------------------- The 8085 reassembler source code is available in the folder SOURCE85.PAS. You can use this source code free for your own Pure PASCAL GEM or reassembler experiments. All other reassembler source codes aren't free and not available for programmers. Files of the source code : -------------------------- Compilation: only compiler flag Z is set, stack size 16384 bytes REASS_85.PAS - Source code of 8080/85 reassembler REASS_85.RSC - Resource file of 8080/85 reassembler REASS_85.I - Resource file constants (Interface 2.2 RCS PASCAL output) REASS_85.HRD - RCS Interface 2.2 RCS info file GEMINIT.PAS - Include file for GEM init GEMINIT.PPU - GEM-Init as UNIT ****************************************************************************** Other free PD-/Shareware assemblers ----------------------------------- The german Computer Club Elmshorn has collected a lot PD-/Shareware assemblers. You can get these assemblers without any charge. Select the disc number and send me the empty discs and the postage costs for return. Short information about the PD list codes : X = runs on every ATARI system (min. 1 MB) S = runs only on ST/STE G = GEM program N = TOS/TTP programm A = screen resolution independent M = only in monochrome ST-High HD = needs 1.44 MB disc Asterix : quality level ------------------------------- (Assembler) ------------------------------- 31 68000-ASSEMBLER-Package MXN * 58 Disassembler 68000 AXN 95 Disassembler 68000 AXN 98 Turbo-Ass 1.72 & Debugger BSP ** 143 Assembler 6303 AXN * 143 Assembler 65c02 AXG * 146 Z-80 Crossassembler MSN * 220 Sharp Pocket Assembler MSN * 263 68000-Assembler (incl. ASM-Source) AXN * 263 8048-Assembler/Disassembler (Incl. ASM-Source) AXN * 300 Assembler NEC 78310/312 AXN * 300 Assembler MCS 48 AXN * 300 Assembler 8051 AXN * 341 Desert Drain 1.1 680xx-Reassembler AXG * 380 Desert Drain 1.3 680XX-Reassembler AXG ** 450 6502-Emulator-Demo AXG ** 457 GNU-Assembler 1.38 AXN ** 505 TurboAss & Debugger 1.77 AXP ** 580 MIT2MOT-Konverter GNU68000-Syntax to Motorola AXN * 611 6502-Disassembler AXN * 721 Crossassembler 6800/02/04/05/6303 AXN ** 721 Crossassembler 6809/6811 AXN ** 721 Crossassembler Z80/HD64180 AXN ** 721 Crossassembler 8080/85 AXN ** 721 Disassembler 68000 AXN 721 Assembler HP-48 0.99b AXN ** 748 FAS Crossassembler RCA 1805 HD AXN ** 748 FAS Crossassembler 2650 SC/MP II HD AXN ** 748 FAS Crossassembler 6301 HD AXN ** 748 FAS Crossassembler 6805 HD AXN ** 748 FAS Crossassembler 6809 HD AXN ** 748 FAS Crossassembler 6811 HD AXN ** 748 FAS Crossassembler Zilog Z8 HD AXN ** 748 FAS Crossassembler Zilog Z80 HD AXN ** 748 FAS Crossassembler TI 7000 HD AXN ** 748 FAS Crossassembler 6502 HD AXN ** 748 FAS Crossassembler Intel 8048 HD AXN ** 748 FAS Crossassembler Intel 8051 HD AXN ** 748 FAS Crossassembler Intel 8096 HD AXN ** 748 FAS Source codes (.LZH) HD AXN ** ------------------------------ Assembler (DSP 56001) ----------------------- 502 DSP-56000/01-ASSEMBLER AXN ** 682 DSP-Shell 1.0 for DSP-ASSEMBLER AXG ** 756 DSP 56001-Disassembler (.LOD) AXN ** 756 DSP converter .OUT to .LOD AXN * *************************************************************************** Bug reports ----------- The coding of reassemblers is a very hard work. Thousands of bit combina- tions must be checked. These 6 reassemblers was designed and checked in 1 month ! That's a every short developing time. If you find some bugs in the reassemblers, please inform me. I will send you an update. ************************************************************************** Soft- and hardware system ------------------------- The reassemblers were programmed with : - ATARI TT 4MB/105MB HD and Proscreen TT/PTC 1526 - PurePASCAL 1.1 Application Systems Heidelberg - Interface 2.2 RCS ************************************************************************* Epilogue -------- ATARI systems need new software ideas. We must enter in the classic areas of PC software. ATARI programs must have the lower price and the better quality as PC applications. Please, don't write the REVERSI number 1000. Take your programming power for new application areas. Have a lot fun with the reassemblers ! Jens Schulz 18th april 1994