_________ ________ _________
/\ _____\ / ____ \ /\ _____\
\ \ \____/ /\ \ \ \ \ \ \____/
\ \ \_____ \ \ \ \ \ \ \ \_____
\ \_____ \ \ \ \ \ \ \ \_____ \
\/____/\ \ \ \ \ \ \ \/____/\ \
____\_\ \ \ \ \___\ \ ____\_\ \
/\_________\ \ \________/ /\_________\
\/_________/ \/_______/ \/_________/ v2.0
-------->by Joe Wingbermuehle 19990618<--------
>What is it?
SOS is an assembly language shell for the TI-83.
SOS stands for "Swapping Operating System."
Here is a list of features:
-Basic Shell Features
-Allows for libraries containing commonly used routines.
-Allows for modules to add and customize SOS features.
-Automatically detects assembly langauge and Basic programs.
-Assembly language programs can run with less than 1k of free ram.
-Program write back for assembly language programs.
-Requires very little memory.
-Runs all AShell and SOS programs.
-Interface Features
-Allows for contrast changing.
-Shows program size and free memory (actual amount free for programs).
-Navigational Features
-Allows up to 254 programs to be on your calculator at a time.
-Eight programs are visible at a time.
-Saves the highlighted program while in SOS.
-Power Saving Features
-Allows power down from within the shell.
-Consumes little power while in the shell.
-Supports APD (Auto Power Down).
**************>READ THIS!!! **********************************************************
Please do not complain to me without fully reading the online SOS information.
http://joewing.calc.org/loadsos.html
If you see a name at the bottom, then you are missing a library required to run the
highlighted program. The name is that of the required library.
If SOS refuses to start, then you probably do not have any SOS-compatible programs
loaded in memory (also, you may not have enough memory to run SOS).
DO NOT attempt to run an SOS program outside of SOS!
DO NOT attempt to send/recieve a program to the calculator while running SOS!
DO NOT attempt to run SOS by entering "Send(9prgmZSOSL" from the home screen!
For information regarding SOS programming, see the online information.
**************************************************************************************
>Installation
Copy sos.83g to your TI-83 (Do NOT open or ungroup this file! Simply select [Send...] from
the [Link] menu and send sos.83g).
Run A.
>Keys
The keys for using SOS should be familiar to most TI-83 users. They have been
selected to match as close as possible the keys used for normal calculator
function while allowing ease of use.
-Run program: [Y=] or [ENTER]
-Exit SOS: [2nd]+[MODE]
-Move cursor: [(up)] or [(down)]
-Next list: [(right)]
-Contrast: [2nd]+[(up)] or [2nd]+[(down)]
-Shut down: [2nd]+[ON]
Note that SOS will shut down the calculator after about 6 minutes of no activity.
Press [ON] to get it back (this will only happen while no programs are running).
>Included Files
Here is a list of files contained in sos.83g:
-prgmA - The program you run, you may rename and/or edit this if you like (required).
-prgmZSOS - The compressed program file (required).
-prgmZSOSL - The SOS loader program (required).
-prgmZMWEL - A self-deleting welcome message. This is a sample SOS module (optional).
>More Information
See my home page (http://joewing.calc.org) for more information on SOS as well as the
latest news concerning SOS and all my programs!
>History:
Non-public releases will not be documented.
Version 0.5 <> ?
-First public beta release! Let me know what you find!
Version 1.0 <> 19980428
-No longer supports BASIC programs.
-Fixed a minor bug.
-Program size has been greatly reduced.
-Keys have been changed (see ">Keys").
Version 1.1 <> 19980514
-Fixed a few bugs.
-[2nd]+[ON] has been disabled.
Version 1.2 <> 19980522
-SOS is much smaller (needs only 815 bytes to run).
-[2nd]+[ON] now shuts down the calculator.
-The start program prgmSOS has been renamed to prgmA.
-I took out the "Description:" label (it was useless).
-SOS now tells what library is missing rather than "Lib Error!"
Version 1.3 <> 19980603
Size: 882 bytes (782 needed to run)
-Smaller
-Shows how much memory is free for memory allocation rather
than user memory.
Version 1.4 <> 19980629
Size: 974 bytes
-Now supports BASIC programs (again).
-Slightly larger due to BASIC support.
Version 1.5 <> 19980905
Size: 941 bytes (823 needed to run)
-Smaller
-Displays the name of a BASIC program rather than the SOS
title for the description.
-The description is now displayed better.
-Doesn't flicker when you press [(right)].
-Should work on all rom versions!
Version 1.6 <> 19981021
Size: 775 bytes (needs 697 bytes to run)
-New and improved interface!
-Optimized!
-New way of running BASIC programs.
-prgmA can be renamed to anything you want and even edited!
-No longer displays the graph after execution.
-Now saves the highlighted program even when you run a BASIC program.
Version 1.7 <> 19990103
Size: 794 bytes (needs 716 bytes to run)
-Improved BASIC program support.
-Keys have been changed.
Version 2.0 <> 19990618
Size: 898 bytes (needs 800 bytes to run)
-Added module support; now programs can be made to improve the SOS interface.
-Improved shutdown feature (should work on all rom versions).
-Fixed the APD bug.
-Made a few changes to the interface.
-As always, a few more optimizations.
-Bumped the version number up to 2.0 because of module support and the
extensive testing this version has gone through.
>Concluding Comments
Thanks to everyone who gave me ideas!
Hannes Edfeldt -gave me ideas for the interface and gave me some helpful hints.
Dan Englender - tested SOS countless times and gave me many good ideas, including
module support!
James Mathews - demonstrated the new way of running BASIC programs (asm83guru.hlp).
Bill Nagel - created AShell which is what SOS is modeled after.
Tim Redmond - told me what was good/bad and gave me ideas.
Matthew Shepcar - gave me some helpful hints.
Everyone else I forgot to mention, including many beta testers and idea givers.
Lastly, a special thanks to you for using SOS!
Joe Wingbermuehle
Home Page: joewing.calc.org
Email: joewing@calc.org
