                        ===================
                        BOTBIOS version 1.0
                        ===================

Sample source code provided with BOTBIOS
========================================

This is a brief description of each of the source files provided with
BOTBIOS.  Files prefixed with 'BB' are generic BOTBIOS files whereas
those prefixed with 'V25' are specific to the V25 processor running
BOTBIOS.

WARNING!!!  DO NOT RUN any of these COM file on your PC!  With the
exception of BBHELLO, they will likely crash your PC!  Or possibly
worse!


The following are utilities that are part of BOTBIOS:
-----------------------------------------------------

V25BLINK.ASM - This sample, renamed to BLINK by the ROMMAKER build
file, demonstrates how to use V25.INC to provide the offsets of the
various special function registers (SFR's), and int 40h func 0, which
retrieves the segment of the SFR's, to access hardware specific to
the V25.  This sample writes an incrementing 8-bit value to Port 2
(P2) which will blink an LED connected to Port 2 bit 7.

BBDIR.ASM
BBFILES.ASM - These utilities use the FTD scan system to locate files
stored in memory.  Both samples start with int 40h function 12h to
initialize the FTD scan system.  

BBDIR, renamed to DIR by the ROMMAKER build file, then uses int 40h
func 13h to locate FTD headers followed by int 40h func 14h to locate
individual files referred to in this FTD header.  On reaching the
last file in the FTD header, a scan made for the next FTD header
until all of the files have been identified.  Information in the FTD
header is displayed followed by a listing of each file in that header
for every FTD header found.

BBFILES, renamed to FILES by the ROMMAKER build file, uses int 40h
func 15h to scan for files displaying information about each file
without regard to the FTD headers involved.

BBMEM.ASM - This utility, renamed to MEM by the ROMMAKER build file,
uses int 40h func 0 and func 1 to obtain and report memory status of
BOTBIOS.

BBGO.ASM - This utility, renamed to GO by the ROMMAKER build file, 
is used to transfer control to the location targeted by an Intel HEX
file download, an address of <lofreesegmentptr>:0100.

BBCLEAR.ASM - This utility, renamed to CLEAR by the ROMMAKER build
file,  writes 0FFh to all of RAM to clear it.  In its current form it
is necessary to reset the V25 processor to restart BOTBIOS.


The following are supplementary samples:
----------------------------------------

BBHELLO.ASM - This is a simple 'hello world' sample that uses
standard interrupt calls to display a string.  It is used primarily
to test the Intel HEX file download capability of BOTBIOS.  Use the
command:

IHEX BBHELLO.COM

will convert it to Intel HEX.  Once BBHELLO.HEX is downloaded, use
the GO command to execute it.  Alternatively, use the same
instructions as provided for V25HOOK, below, on BBHELLO.BLD to create
and convert to Intel HEX the FTD file.  Download it and the DIR
command will then show it which can be executed by typing HELLO.

V25HOOK.ASM = This sample demonstrates hooking the BOTBIOS timer tick
dividing the 1 kHz timer tick rate by 500 to blink the Port 2 bit 7
LED at a visible rate.  The sample installs an interrupt handler and
terminates remaining resident with int 21h func 31h.  Control is
return to the command processor while the influence (blinking LED) of
the TSR remains.  This sample has to be put in the FTD file system
with ROMMAKER so that it is properly loaded by BOTBIOS when executed.
 Use the commands:

ROMMAKER V25HOOK.BLD
IHEX /seg 1800 V25HOOK.BIN

to create the FTD file and to convert it to Intel HEX to be
downloaded to 1800:0000 (requires 128k).  Once V25HOOK.HEX is
downloaded, HOOK can then be seen with the DIR command.  Typing HOOK
will install the TSR.

Experiment by creating your own BLD file that contains both BBHELLO
and V25HOOK.  Create the FTD file, convert it to Intel HEX, and
download it.  You will then see both files in the FTD file system.


Bill Bailey
16 May 96
