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

    Last Updated 24th December 2017

    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
    --------------

    * Cycle accurate CPU/DMA/SMP/DSP
    * 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, NTT Controller Nintendo Scope and Mouse
    * Coprocessor 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

    Sega Master System
    ------------------

    * Cycle accurate CPU/VDP
    * SEGA and Codemasters Memory Mapping
    * Support for Standard Controller

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

    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 functions are pre-defined. These can be re-assigned in the
    hotkey editor.

    F10             Pause (Scope)
    F11             Turbo (Scope)
    F12             Save Screenshot (PNG)
    Shift-Esc       Restore windowed mode
    Shift-F2        Save State
    Shift-F3        Load State
    Alt-Enter	Fullscreen mode
    Ctrl-Del        Reset
    Pause		Pause

    Famicom Keyboard (keyboard.map)

    Backspace       Stop
    Del             Delete
    PgUp            Grph
    PgDn            Kana
    ~               @

    TV-NET Controller

    0..9		0..9
    Esc		End
    Enter		Go
    Left		Left
    Right		Right
    *		*
    .		.
    F1..F5		F1..F5

    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