--------------------------------------------------------------
			TI-Explorer 
	               ver 0.92 Beta

	     (c) 1999,  Sebastiaan Roodenburg
--------------------------------------------------------------

Table of Contents
=-=-=-=-=-=-=-=-=

1. What is TI-Explorer
2. Basic info
3. The files included with TI-Explorer
4. Support
5. Credits
6. What to do...
7. History
8. Developer info


1 What is TI-Explorer?
=-=-=-=-=-=-=-=-=-=-=-

TI-Explorer is a GUI(graphical user interface) & SHELL for the TI83.
It allows you to start programs or open files with an attached viewer, 
just like Windows for the PC (Yeah! You can view a file just by pressing
[Enter] on the file, the shell will search for a viewer). 
TI-Explorer runs all AShell, SOS and ION programs (I hope ;).


2 Basic info
=-=-=-=-=-=-

***********
WARNING!
THIS BETA VERSION MAY CONTAIN SOME BUGS. ALWAYS BACKUP YOUR CALC BEFORE 
INSTALLING: IT SOMETIMES CRASHES. DO NOT TRY TO TURN OF THE CALCULATOR
FROM THE INTRO. DO NOT TRY TO SEND/RECEIVE FILES WHILE RUNNING THIS SHELL. 
IF A PROGRAM DOESN'T RUN, YOU'VE PROBABLY NOT INSTALLED A REQUIRED LIBRARY.
***********

Instalation:
- Read this document before starting
- Back up your calc
- Copy all the requierd files (see section below) to your calc
- run prgmEXPLORER
- Press a key (NO [2nd]+[On]!!!!!) while viewing the intro
  to enter the shell

Keys:
[Up] & [Down] 	- Select file/program
[+] 		- Down 1 folder
[-]		- Up 1 folder
[2nd]+[MODE] 	- Quit the shell and return to the TI-OS
([2nd]+)[On]	- Shut down the calc
[2nd]+[Up]	- Contrast up
[2nd]+[Down]	- Contrast down

Folders:
My TI83		- A control-pannel
LINKS		- does not work in this version - is always empty
PROGS		- all executable programs
FILES		- all files which are not listed in 'PROGS'
ALL		- all files & programs

Features:
- Runs all AShell, SOS, ION and Explorer (see section below) programs
- File types: open a file with an accotiated viewer, there are up to 247 
  filetypes supported. Files and viewers are automaticly detected.
- SOS Library support
- Supports SOS moudules (is not 100% SOS compatible, so some modules can
  freeze your calc)
- Automatic file & program detection
- Programs can have their own icon
- Files get a icon from a accotiated viewer
- Program write back for assembly programs
- Contrast changing from within the shell
- Can show free memory (see section below)
- Battery indicator (see section bellow)
- Allows 'unlimeted' programs to be on the calc 
- APD (Auto power down)
- The GUI runs in low-power mode
- There are a few folders for showing differend types of files/programs


3 The files included with TI-Explorer
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

,---------------+--------------+---+------------------------------------.
| Name(on calc) | Name(PC)     |REQ| Discription   			|
+---------------+--------------+---+------------------------------------+
| EXPLORER      | EXPLORER.83P | X | Run this file to start TI-Explorer |
| ZEXPLOL	| ZEXPLOL.83P  | X | Intro				|
| ZEXPLO	| ZEXPLO.83P   | X | The GUI				|
| ZEXPFTT	| EXPFTT.83P   |   | A data-file witch links viewers    | 
|               |              |   | to file-types			|
| ZIONLIB       | ZIONLOB.83P  |(X)| Library with ION-lib routines.     |
|		|	       |   | COPY THIS FILE TO YOUR CALC IF YOU |
|               |              |   | WANT TO RUN ION PROGRAMS!!!	|
| BATTERY	| XBATTERY.83P |   | A battery indicator		|
| MEMORY	| XMEMORY.83P  |   | Memory check: shows amount of free |
|               |              |   | memory				|
| PICVIEW	| PICVIEW.83P  |   | A programming example		|
| ExploI	| PICTURE.83P  |   | A picture which can be viewed with |
|               |              |   | PICVIEW				|
`---------------+--------------+---+------------------------------------'

The X in the column 'REQ' indicates that the file is required to run the
shell. All other files can be deleted in case of low memory.
Without ZEXPFTT, there is no file-type support.


4 Support
=-=-=-=-=

Please report bugs!
If you are a developer and need some info (no source), or have discoverd a bug
mail me at sebastiaan@rimsystems.nl or contact me with ICQ: 5533889

I'm planning to set up a support-website somewhere in the future...


5 Credits
=-=-=-=-=

I want to thank the folowing people:

Joe Wingbermeuhle for creating SOS, ION, ZGFXL, ZLIB, releasing some source and helping me with some bugs!
J. Matthews for his ASMGuru, this was a great help!
Movax for his sprite routine, i've used some parts of it for creating a fast and small icon routine
The people of TiCalc.org for setting up a great website (http://www.ticalc.org) and an very usefull
  mailinglist (see their site for info)
Everyone else who helped me
You for using my Shell & GUI!


6 What to do...
=-=-=-=-=-=-=-=

There are a few things that I want to do:
- Make the LINKS folder work (I need to know how to resize a file, help me!)
- Make a modules to do some file-stuff (delete, copy and rename files)
- Move some of my file detecting/loading rotines into a kernel (not sure... would be a lot of work)
- Write a send and receive routine, to send files (most of the file-types can 
  not be sent with the TI-OS)
- Better folders
- Make it a lot smaller


7 History
=-=-=-=-=

Version 0.82 Beta:
 * First release
 * Automatic program detection (detects and runs SOS, AShell and Basic 
   programs)
 * File types
Version 0.84 Beta:
 * Added module support
Version 0.92 Beta:
 * Fixed a small bug (i think it was a bug ;)
 * Added ION support


8 Developer info
=-=-=-=-=-=-=-=-

Basic:
A Ti-Basic program will be detected as a program if it starts with an ':':

 PROGRAM:BASIC
 ::ClrHome
 :Disp "THIS IS BASIC"


Assembly:
All AShell, SOS and ION programs will be detected, but to use some extra TI-Explorer functionality 
(file-type support, Icon & libs) use the following 'template':

	xor a	; every 1-byte instruction will work, use a 'NOP' for AShell compatabilety
	jr start
	.dw libs-9327h   ; pointer to libs, 0000 if no libs used
	.dw description  ; pointer to a description
	.dw icon	 ; pointer to an 8x8 icon	
start:
;---- Your program starts here
	ret

LoadPic:
	; Open a file, OP1=filename, hl=pointer to file
	ret
;---- Some Shell-vars
descripton:
	.db "Test program",0	; 0-terminated string
	.db 0F0h		; file is an Explorer program

	.db 07h			; Can open files of type '07h' (picture)	
	.dw LoadPic		; pointer to load-routine for this filetype
icon:	.db 00000000b		; A 8x8 icon for this filetype
	.db 11111110b	
	.db 10000010b
	.db 10111010b
	.db 10101010b
	.db 10111010b
	.db 10000010b
	.db 11111110b
	.db 0ffh		; no more supported file-types for this program
libs:
	.db "ZLIB",0,0,0,0,libF,vec1	; Libraries, see SOS-doc. for more info
	.db 0FFh

If programmers want their programs to create a file of a certain type: just write
the value of the type to the 1st byte of the TIOS-filename. There are still 7 bytes 
for the filename.