README for TRSI Kernal for DTV 1.0 (formerly known as Peiselulli's Kernal)
----------------------------------

Written by Ulrich Schulz <peiselulli@t-online.de>

"Peiselulli's Kernal" is a kernal that adds some new features to the DTV Kernal.
It is only tested on PAL DTV (DTV3).

There are two versions included in this zip file:

Kernal.prg   : this kernal stays at 0x1fc000-0x200000 in RAM and a hook
               is installed at 0x018000-0x018100 in RAM to make it possible to
               execute it while pressing the left joystick button after
               releasing reset. First start with "run"

Kernal.flash : this kernal is for flashing at 0x1fc000-0x200000 in flash.
               It can be run with DTVMON/DTVBOOT 0.7 or higher installed.
               See "http://www.kahlin.net/daniel/dtv/dtvmon.php" for more
               details.
               FLASH IT ONLY IF YOU KNOW WHAT YOU ARE DOING !!!
               
Both kernals use 0x1f8000-0x1fc000 in RAM while saving or loading.

Features:
    - ZEE colorfix 
    - fast load : based on "dtv speed load" (thanks to TLR !)
                  25x load speed, but works only with device 8 !
                  Only tested with 1541 (I + II), 1571 and 1541 Ultimate.
                  loads everything into ram under the roms and the IO.
                  can load up to 254 block programs !
    - fast save : based on hypra-save (??)
                  (don't know how fast is it compared to original)
                  works with any device.
                  Only tested with 1541 (I + II) and 1541 Ultimate.
                  saves everything from ram under the roms and the IO.
                  can save up to 254 block programs !
    - list directory from disk without loosing loaded programs.
                  replaces "PRG" with ",8,1" for easier loading (see function
                  keys)
    - list the *REAL* content of the flash directory.
                  The format of each content is the following:
             <loading start address> "<name>",1,1:<flash start address in hex> 
    - default device from basic is 8, not 1
    - "load" without filename loads the directory of device 8
    - "save" prompts with a small dialog to enter the filename if no parameter
                  is given.
                  This is very useful for saving large files without getting
                  the infamous "out of memory" error because basic cannot store
                  the filename. The filename is stored on the stack.
    - function keys:
            F1 : list directory in empty line, loads a program if a filename is
                 following. Easy to be used with listed directories 
                 (try it and you understand it what I mean).
            F2 : run
            F3 : sys 4096* 8 (cursor is placed on the "8" to edit)
            F4 : save
            F5 : submit a floppy command
            F6 : read floppy status
            F7 : list (is the right button of the DTV)
            F8 : tool menu
     - shift+run/stop (=esc) starts the first program on drive 8
     - loading and saving addresses are printed in hex
     
   features of the tool menu:
        -change work device with F1 : this device is used for saving or all other
                                      disk operations
        -disable / enable fast load:
                      : enable or disable the fast loader (and saver) for incompatible
                        devices. "filecopy" in the menu is still using the fast loader
        -filecopy     : can copy files from device 8 and the device 1 (the flash).
                        uses extra memory.
                        toggling the source device is done with F3
                        files are copied to work device
                        select files with space, return to start                        
        -format       : normal format (original from zipper of collision does not work very well)
        -validate     : to validate disks selected by work device
        -scratch      : scratch multiple files on work device
                        select files with space, return to start
        -rename       : rename file on work device
                        select file with return
        -initialize   : initialize command submitted to work device
        -floppy reset : resets the floppy and display the version number of the dos
        -re-new       : simple old command for basic programs. prints the end of the basic program
                        in hex.
        -jmp ($8000)  : because of the kernal does not recognize the "CBM80" code
                        at 0x8004, this function is included to run some
                        old games that uses the reset vector for starting.
                        "CBM80" is checked before at 0x8004
        -CPU turbo on : enables the CPU turbo mode of the DTV (burst mode, no BAD line,
                        shorter execution time for instructions)
                        caution : some programs don't work with this (especially 
                                  programs that uses the IEC bus), but normal basic save
                                  and load works with turbo mode now.
        -CPU turbo off:
                        disable CPU turbo mode
        -mount d64 (ultimate only) :
                        mount a D64 image from the 1541 ultimate.
                        selection with return, abort with run/stop (=esc)
                        can be used to change directory too if the selection
                        will be aborted with run/stop
        -mount and kill (ultimate only) :
                        like "mount d64", but kills the SD2IEC channel afterwards.
                        This is useful for working fast loaders (like the internal
                        one included in this kernal)
        -kill SD2IEC (ultimate only):
                        kills the SD2IEC channel for using fast loaders
        -make d64 (ultimate only) :
                        creates a blank d64 image on ultimate
        -fill whole mem:
                        Fill the complete memory from 0x000800 to 0x1f8000 with
                        a selectable byte to fill the memory with.
        -reenter to TMP-PTV :
                        if you program with the Turbo Macro Pro Assembler (version
                        is called "TMP PTV" then  you have sometimes the following
                        problem :
                        your own code messed up the computer and the callback to get
                        back into the TMP is lost after reset. This menu entry does
                        enter to the TMP if it is recognized.
                         

============================================================
Changelog:
V1.0 :  renamed to TRSI kernal
        scratch menu can select "d64", "usr" and "seq" files, too
        fast formatter removed (does not work very well)
        ultimate functions added
        fill whole mem added
        renew function now works
        basic function load and save are working now in turbo mode
        floppy status function fixed
        
V0.4 :  added new features
        ZEE colorfix added
        drive 8 is selected per default only if no drive was used before
        disable fast load possible
        new colors for menu
        work device from menu set as active device in normal kernal mode, too 
V0.3 :  many changes done for make it more compatible
        tool menu added
V0.2 :
        printing loading and saving addresses is added
V0.1 :
        initial version

============================================================
            
Have fun ...