--------------------------------------------------------------------------------
kindred v1.07 Preview Build 1
Video Game System Emulator
Copyright (C) 1998-2015 Kris Bleakley 
email: kindred@crazysmart.net.au
--------------------------------------------------------------------------------


Last Updated 19th May 2015


Table of Contents

i.  Disclaimer
1.  Introduction
2.  System Requirements
3.  Getting Started
4.  Input Devices
5.  Famicom Disk System
6.  Game Boy
7.  Enhancement Chips
8.  Special Thanks
9.  Copyrights


/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\

i. Disclaimer (Please read before operating software)

This product is provided free of charge and therefore on an "AS IS" basis, 
without warranty of any kind, express or implied, including without limitation 
the warranties that it is free of defects, virus free, able to operate on an 
uninterrupted basis, merchantable, fit for a particular purpose or 
non-infringing. This Disclaimer of warranty constitutes an essential part of 
this agreement. No use of the product is authorised hereunder except under this 
disclaimer. This product is for non-commercial use only and shall not be 
packaged with any commercially licensed software.


/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\

1. Introduction

kindred is an Emulator designed to aid in the development of software 
intended for use on a home video computer. While a number of years have been
spent perfecting the software, it is not guaranteed to be 100% compatible. 

Features include:

* Screen Capture in PNG format (F12)

Super Nintendo
--------------

* 128KB Backup RAM support (Support for various backup units)
* Support for various ROM formats (Max 64Mbit Cartridge Mode, 96Mbit Game Doctor Mode)
* Support for Standard Controller, Nintendo Scope and Mouse
* DSP Support (including DSP-1, DSP-2, DSP-3, CX4, OBC-1 and S-DD1)


Nintendo Entertainment System
-----------------------------

* Cycle accurate APU/CPU/PPU
* Support for various Cartridge Types (including C*ROM, U*ROM, B*ROM, A*ROM, G*ROM,
    S*ROM, P*ROM, T*ROM, F*ROM, H*ROM)
* Support for Standard Controller, Famicom Keyboard
* NINA Header Support


Nintendo Game Boy
-----------------

* Cycle accurate CPU
* Mapping support for MBC1, MBC2, MBC3, MBC5, MMMO1, HUC1, HUC3, TAMA5, Pocket Camera

/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\

2. System Requirements

It is recommended that you limit the number of programs running in the background
as this software uses a lot of CPU time while running. 


Minimum System Required

* Intel Core 2 Duo 2.4GHz or equivalent processor
* 64MB Available System Memory
* 20MB Available HDD space
* Microsoft Compatible Mouse and Keyboard
* Microsoft Windows 7
* Microsoft Direct-X 8


/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\

3. Getting Started

kindred has been designed to be as user friendly as humanly possible, while
retaining its purpose as a powerful development tool. To take advantage 
of a number of key development systems there are a few important details you 
will need to know before operating the software. For this software to be of any 
use, you will need ROM files. Under no circumstances will any ROM files be 
packaged with this software unless specified in this readme file.

It is recommended that you run kindred from a harddisk drive rather than 
from a read-only media such as a CD-ROM. On startup the in-built debug system 
will create a trace log file in the startup directory of the software. Failure 
to create this log file will result in the debugger not being able to trace CPU 
instructions. Also be aware that continual tracing of the system CPU will 
eventuate in the trace log growing rapidly in size.

Loading a ROM file is simple, just select open from the file menu. A list of 
recently loaded (re-open) files is also available from the file menu. 
Alternatively, ROM files may also be loaded by dropping a file from windows 
explorer onto the main window. If for any reason a ROM file does not load 
correctly try converting the file using a conversion tool (various conversion
tools are available for download from the internet).

Each time a ROM file is loaded information about the ROM will be available on 
the Properties window. Information will also be written to the terminal window 
as well as the trace log (if tracing is available). Please note that there is 
no implemented feature to periodically save BackupRAM, however BackupRAM maybe
saved manually from the file menu.


/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\

4. Input Devices

The Preferences window allows the user to customize the buttons for five standard 
control devices. 

Assign a joystick button to a user device
1. Open the Preferences window from the Input menu
2. Hold down desired joystick button
3. Click on the target controller input to assign a virtual key
4. Repeat until all inputs are assigned 
5. Click Ok 

The following key functions are pre-defined:

F10             Pause (Super Scope)
F11             Turbo (Super Scope)
F12             Save Screenshot (PNG)
Esc             Restore windowed mode
Shift-F2        Save State
Shift-F3        Load State

Menu Shortcuts (not available in full-screen mode)

Ctrl-O          Open
Ctrl-Enter      Hide/Show Properties Window
Ctrl-S          Save BackupRAM
Ctrl-Del        Reset

Famicom Keyboard (keyboard.map)

Backspace       Stop
Del             Delete
PgUp            Grph
PgDn            Kana
~               @

Famicom Disk System

1               Insert Disk 1 (A)
2               Insert Disk 1 (B)
3               Insert Disk 2 (A)
4               Insert Disk 2 (B)

Only two control devices are supported in this release, however future versions 
may support third party devices such as the Super Multi-tap for up to 8 connected 
control devices.

/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\

5. Famicom Disk System

Famicom Disk software will not work without the required RAM Adapter (2C33) 
internal ROM. The ROM should be renamed to "DISKSYS.ROM" and must be located in 
the application\nes directory.     

The disk system should be operated in NTSC mode. Failure to comply will result in 
disk errors.

/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\

6. Game Boy

Nintendo Game Boy software may not operate properly without the Gameboy's internal
boot ROM. This ROM should be renamed to "DMG.ROM" and must be located in the 
application working directory.

The included boot rom does not guarentee operation on a real system.  

/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\

7. Enhancement Chips

While an effort has been made to add support for enhancement chips, not all chips
are fully supported.


/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\

8. Special Thanks

In no particular order I would like to thank the following people for their help
and contributions to the emulation scene.

Y0shi, Gary Henderson, Jerremy Koot, zsknight, _Demo_, Eric Pearson, Rob Bohms,
Charles Bilyue', Brad Jorsch, Cowering, Nach, Andreas Naive, John Weidman, 
Kevin Mantey, Evan Gowan, Byuu, Shay Green, bootgod


/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\

9. Copyrights

"Microsoft Windows" is a trademark of Microsoft Corporation.
"Nintendo Entertainment System", "Famicom", "Super Nintendo Entertainment System",
"Super NES", and "Super Famicom" are trademarks of Nintendo Co.,Ltd.
"Super Wildcard" is a trademark of Front Fareast Industrial Corporation.
"Game Doctor" is a trademark of Bung Enterprises.

http://www.crazysmart.net.au/kindred/readme.html