EMUTools

 by Marat Fayzullin, AmigaOS 4.0 compile by Spot / Up Rough

 What is EMUTools?

 EMUTools is a set of simple utilities which I wrote to handle various ROM 
 images, play and convert soundtrack files, disassemble programs, and perform 
 other small but helpful tasks. EMUTools are available from
 


 http://www.komkon.org/fms/EMUL8/


 All programs will automatically unpack GZIPped files when compiled with #define
 ZLIB. You can find out whether your copy of a program can do that by typing its

 name without parameters: there should be an explicit mention of this feature in

 the help text printed by a program.


Copyright Notice

Both EMUTools and EMULib source code and documentation are copyrighted by me, 
Marat Fayzullin. Following restrictions apply to these materials:
You can use this software for any non-profit purposes as long as you make a 
proper reference to me.
You cannot use this software to gain any kind of profit. This includes putting 
the software onto CDROMs, using it or its parts in your own commercial or 
shareware projects, and so on.
You cannot distribute this software yourself, even if it is not done for profit.
Do not put it to any WWW or FTP sites of your own, make a link to my site
instead.


 How To Compile EMUTools

If you've obtained the source code version of EMUTools, check the Makefile for 
compilation options first. Your actual Makefile may differ from the original one
as "make" utilities behave differently on various platforms. You may need
additional
modules from EMULib, available at the same WWW site as EMUTools.


How To Use EMUTools?
 BDIFF [-as] file1 file2

BDIFF will compare two binary files and print out the differences side by side,
in 
hexadecimal and ASCII formats. Options:

  -a  - Use ANSI color sequences to highlight differing bytes.
  -s  - Show complete hexadecimal dumps, not only the differences.


 UNDOUBLE infile >outfile 

UNDOUBLE will check whether the given file contains doubled (quadrupled, etc.)
copies
of the same data and if so, write out a single copy of this data into the output
file. 
It will use the standard output if the output filename is not given.



 BEHEAD bytes infile >outfile

BEHEAD will cut a given number of bytes off the head of the input file and write
the 
result into given output file. It will use standard input and output if
corresponding 
filenames are omitted.



 DASM6502 [-o<origin>] [-h] <file>

This is a little 6502 disassembler. It will output disassembled code of a given 
binary file. Don't expect anything fancy though. If you are using DASM6502 to 
disassemble a NES/Famicom program, be aware that .NES ROM images contain a
16-byte 
header in the beginning, so you probably want to use -o-7FF0 option on them.
Options:

  -o  - Count addresses from a given origin (in hexadecimal form,
        can be negative).
  -h  - Show original hexadecimal data beside disassembled code.

Example usage DASM6502 infile >outfile.src



 DASMZ80 [-o<origin>] [-h] <file>

This is a little Z80 disassembler. It will output disassembled code of a given
binary file. Don't expect anything fancy though. Options:

  -o  - Count addresses from a given origin (in hexadecimal form,
        can be negative).
  -h  - Show original hexadecimal data beside disassembled code.

Example usage DASMZ80 infile >outfile.src



 GBDASM [-o<origin>] [-hi] <file>

This is a little GameBoy disassembler. It will output disassembled code of a
given binary file. Don't expect anything fancy though. GBDASM is almost
identical to DASMZ80, but recognizes special GameBoy opcodes and cartridge
headers. Options:

  -o  - Count addresses from a given origin (in hexadecimal form,
        can be negative).
  -h  - Show original hexadecimal data beside disassembled code.
  -i  - Show information from the GameBoy cartridge header.

Example usage GBDASM infile >outfile.src


 GBLIST [-acfhp] file1.GB file2.GB ...

GBLIST is a tool to process GameBoy ROM images (.GB files). It extracts and 
verifies cartridge information from the images and may fix invalid images if 
requested. It will also list the images in an easy to read format, either as 
ASCII or as HTML text. GBLIST understands wildcards. Options:

  -a  - Use ANSI color sequences to highlight errors.
  -c  - Check CMP/CRC and file sizes.
  -f  - Fix CMP/CRC and file sizes. The fixed image will be written
        into a file with extension .FIX.
  -h  - Output results in HTML format.
  -p  - Show supposed producer.

 The cartridge attributes which GBLIST shows in its output deserve some 
 additional explanation:

   G  - Cartridge is compatible with the "normal" GameBoy.
   S  - Cartridge is compatible with the Super GameBoy.
   C  - Cartridge is compatible with the GameBoy Color.
   J  - Cartridge produced for Japan only.
   T  - Cartridge contains a timer (MBC3).
   U  - Cartirdge is a rumble pack (MBC5).
   R  - Cartridge contains ROM (i.e. [R]eadable).
   W  - Cartridge contains RAM (i.e. [W]ritable).
   B  - Cartridge contains battery-backed RAM.
 The last attribute is the memory bank controller (MBC) type:
   1  - Cartridge contains MBC1 chip.  
   2  - Cartridge contains MBC2 chip.  
   3  - Cartridge contains MBC3 chip.  
   5  - Cartridge contains MBC5 chip.  
   A  - Cartridge contains HuC1 chip.  
   B  - Cartridge contains HuC3 chip.  



 NESLIST [-ahcpd] file1.NES file2.NES ...

NESLIST is a tool to process NES ROM images (.NES files). It extracts and 
verifies header information from the images, and may fix invalid images by 
truncating the unnecessary data and modifying the headers. Additionally, NESLIST
will generate separate header files (.HDR) and try to write out 
Pasofami-compatible files, although the latter feature does not work very well.
NESLIST understands wildcards. Options:

  -a  - Use ANSI color sequences to highlight errors.
  -h  - Write headers into separate .HDR files.
  -c  - Check file sizes.
  -p  - Generate PASOFAMI files: .PRM,.PRG,.CHR.
  -d  - Check ROMs for doubling and truncate.

 The cartridge attributes which NESLIST shows in its output deserve some 
 additional explanation:

   V  - Uses two screen buffers with vertical mirroring.
   H  - Uses two screen buffers with horizontal mirroring.
   4  - Cartridge has all four screen buffers.
   B  - Cartridge contains battery-backed RAM.
   T  - There is a 512-byte trainer.
   S  - This is a VS-System game.



 GBALIST [-acfhp] file1.GBA file2.GBA ...

GBALIST is a tool to process GameBoy Advance ROM images (.GBA files). 
It extracts and verifies header information from the images. GBALIST understands
wildcards. Options:

  -a  - Use ANSI color sequences to highlight errors.
  -c  - Check CMP.
  -f  - Fix CMP. The fixed image will be written into a file
        with extension .FIX.
  -h  - Output results in HTML format.
  -p  - Show supposed producer.



 FDSLIST file.FDS

FDSLIST is a tool to list contents of the Famicom DiskSystem disk images 
(.FDS files). It prints a directory of files contained in one or more disk
images 
stored in the given .FDS file. Each disk image is 65000 bytes long and 
corresponds to a single side of an FDS disk. There may be multiple images in a 
single .FDS file.

 FAM2FDS file.FAM >file.FDS


FAM2FDS will convert Famicom DiskSystem disk images from .FAM format to the .FDS

format supported by iNES. Simply supply the program with names of the source
.FAM 
file and the destination .FDS file.

©2001 Copyright by Marat Fayzullin