Name:        AuroraShell Enhanced (ASE) with TI-82/85 Emulation
Author:      Bill Nagel
Version:     1.3
Machine:     TI-86
Released:    January 19, 1998
Description: An advanced shell that allows execution of TI-86 assembly
             and basic programs AND TI-85 ZShell/PhatOS/Rigel/Usgard
             programs! AND TI-82 CrASH & ASH programs!

Version 1.3:
   Removed bugs!

Version 1.2:
   Improved emulation, displaying numbers and inverse text
   ASE no longer detects modules in add-on applets

Version 1.1:
   Added Usgard Interrupt support and VAT support
      -Andreas Ess' Balloon now works
   Found and fixed a string saving problem

Version 1.0
   Big update!
   Added:
      Usgard emulation!
      TI-82 CrASH & ASH emulation!
      Rigel emulation
      Program grouping
      Password protection
      Manual Power Down (MPD)
      Emulated games are now written back to save high scores
      Displays program type
      Support for TI-86 program descriptions
      Improved ZShell emulation
      
Version 0.90
   First public release
   Less than 1500 bytes!
   Features:
      CoolShell+ style GUI
      Automatic detection progs,
      Runs TI-86 Assembly, TI-86 Basic, TI-85 ZShell/PhatOS, and TI-85 BASIC!
      Lists programs in two columns, 16 progs can fit on one screen
      Columns scroll up & down to display more programs
      Free memory and program size displayed
      ZShell/PhatOS Program Descriptions!
      Automatic Power Down (APD)
      Contrast Changing

Installation:

1) Clear your memory!
2) Copy ase.86g to your calc
3) Run AShell
4) MineSeek.86p has been included in the .zip file
   It is a CrASH game that has already been converted with conv.bat

Keys:
   [UP]/[DOWN]/[LEFT]/[RIGHT] - Select a program
   [2ND]/[ENTER] - Run highlighted program
   [EXIT] - Exit shell
   [+]/[-] - Change contrast
   [STO->] - Move a program to a new group
   [MORE] - Display function menu

Function Menu:
   [F1] - Shutdown
   [F2] - Chang the password
        - If no password is set, you are prompted for a new one.
        - If a password is already set, you are asked to enter the old one.
        - If you don't want a password, just press enter at
             the "New Password:" prompt.
   [F3] - Delete Program

Grouping Programs:
   Highlight the program you wish to move.
   Press [STO->]
   Press the function key that correspondes to the destination group.
   That's it!

Renaming Groups:
   From the homescreen, press [PRGM] [F2]
   Select AShell
   At the end you'll find
 
 :Goto A
 :"Games:Math:Utils:Mi
 sc:Other:"

   You can change these names to whatever you like.
   Be sure you do not remove the quotations and that there
   is a colon after every group name.


TI-85 ZShell/PhatOS/Rigel/Usgard Emulation:
  You can either rename a .85s assembly program to .86s
     or send the .85s to the 86 directly from Winlink or a TI-85
  So far I know that these programs work under ASE:

ZShell:
  Asteroids 2042
  Black Jack
  Bone Yard
  Insane Game
  JezzBall
  Mutiny2
  Organise 2.1
  Othello
  Pacman 2.2
  PlainJump
  PlainJump 2
  Slippy
  Space Invaders
  TexaNoid
  ZCasino

PhatOS:
  Meister Mind
  Flip Tile
  Galaxian

Rigel:
  Drug Wars
  DStar
  Orzunoid
  Solytare

Usgard:
  Balloon
  Drug Wars
  DStar
  Flip Tile
  Galaxian
  Ishido
  Mario
  Mega Racers 2
  Orzunoid
  Pacman 98
  Plane Jump
  Sokoban
  Solytare
  Stones
  Tunnels
  Vexed
  Wak-A-Skeeter
  ZTetris

TI-82 CrASH/ASH emulation:
   There are a number of problems that arise in 82 emulation,
   I will try to improve emulation as time progresses, but
   CrASH programs have a higher probability of working.
   Programs larger than 12K will not work, like FFX4
   If you can't seem to get YOUR TI-82 asm game to work under ASE,
   email me, I could probably help you out.

   To convert .82p into .86p, type at DOS prompt:

      conv program    (without .82p extension)

   The files devbac83.com prgm86.exe and conv.bat are needed,
   And they should be placed in the same directory.
   This would convert MineSeeker:

      conv mineseek

CrASH:
 MineSeeker
 Tunnels

Ash:
 Brickmaze
 Diamonds
 Frawg Guts
 Lunar Lander 

 I'm sure that a lot more games work with ASE, so please email me
 to add to the list!  Please note that games larger than 12K will
 most likely crash your calculator.  There really is no point to
 emulate Usgard TSR's because the 86 already has counterparts
 that will do the same things (like screen captures and greyscale
 backgrounds), so it would be a waste a space.  Also, please send
 in any bug reports!

TI-86 Assembly:
   Programs are executed with %100 compatability with Asm(
   That means programs are not written back as they were in AShell v1.1
   and Iridus v.91

Program Descriptions:
 TI-82/85:  Standard program descriptions are displayed
 TI-86:
   This had been implemented in the original AShell, but was removed
   from ASE.  After recieving numerous requests for support for
   program descriptions in ASE, I decided to put it back in.
   ASE checks for a special table at the beginning of an asm prog
   to look for a program description.  Here is what the basic format of
   Nibbles v2.0 looks like:

   nop         ;Identifies the table
   jp Start
   .dw $0000   ;Version # of Table
   .dw Title   ;Absolute pointer to program description
Start:
               ;ASM program code goes here
Title:
   .db "Nibbles v2.0",0
.End  

TI-86 Modules:
   As you may have noticed, the TI-86 has built in support for modules,
   which are basically single function libraries.  ASE will automatically
   NOT detect any modules on your calculator if this code is placed at
   the beginning of your module:

   bit ex_asm_module,(iy+anumeditflgs)
   jp z,_errInvalid

   This will also prevent your module from being executed by Asm(
   using the same method that the Statistics add-on uses.
   Here are the corresponding equates:

   anumeditflgs    equ       31
   ex_asm_module   equ       2           ; 1 = ASM module ok

   _errInvalid                      equ            416Ch


Program Types (Displayed next to "Type:" in the far right column)
 A = TI-86 Asm
 B = TI-BASIC
 C = CrASH / Ash
 P = PhatOS
 R = Rigel
 U = Usgard
 Z = ZShell

Visit my homepage for the latest versions:
   http://www.tou.com/host/tiasm/

There are probably some bugs, email any reports!
Send comments/suggestions to:
   Bill Nagel <penguin@your-house.com>
              <b.nagel@usa.net>

Special Thanks:
        Pat Milheron - Great Help!
        Movax - Wrote Devbac83!
        Jimmy M. - Author of Usgard!
        Martin Hock - made PhatOS and Insane Game!
        Matthew Shepcar - worked with me to find some new rom calls
        Alan Bailey - Wrote prgm86
        CrashMan   \ the creators
        Jeff Mears /   of CrASH
        Joseph Gaffney
        Ahmed El-Helw
        Andreas Ess
        Alex Sedeno
        Brian Bock
        Harper Maddox
        Alex Highsmith
        Chad Palmer
        Andy Straube
        Dan Eble
        Jareth
        And anyone else I forgot to mention

Do not separate this document for ASE!

Copyright (C) 1997 Bill Nagel
Do not disassemble or change any part of ASE!
I am not responisble for any damage this program may cause.
