******************************************************************* * RRRRRRR PPPPPPPPP N N 88888888 99999999 * * R R P P NN N 8 8 9 9 * * R R P P N N N 8 8 9 9 * * R R P P N N N 8 8 9 9 * * R R P P N N N 8 8 9 9 * * RRRRRRRR PPPPPPPPPP N N N 88888888 999999999 * * R R P N N N 8 8 9 * * R R P N N N 8 8 9 * * R R P N N N 8 8 9 * * R R P N NN 8 8 9 9 * * R R P N N 88888888 99999999 * ******************************************************************* V 1.2 for the TI-89 In memory of the brave crews of the Apollo 1, Columbia, and Challenger spacecraft JPEW Development RPN89 is a no-stub Reverse Polish Notation calculator for your TI-89. it was written 100% in C using the TIGCC compiler. It has been tested with AMS 1.05 & AMS 2.05. RPN89 requires approximatly 12k of ram for the program file. The size of the INF file can vary greatly, depending on which options you have set, and the size of the stack upon exit. The ammount of ram require to run depends on how much you push on the stack, but I have yet to fill my ram with this program's stack. this read-me assumes you know basic RPN. please note: I am not a very good read-me file writer. If you cannot understand anything, please email me at JPEWdev@delorean.com INSTALLATION: send "rpn.89z" to your calculator type "rpn()" on the command line to run USAGE: RPN89 functions like a normal RPN calculator. The screen is basically divided into 2 parts. The larger box shows the expressions stack with 5 visible memory slots (A0 - A4). The thinner box below this is the entry line. Data is entered through the enrty line, then pushed onto the expressions stack. To push "5.76" onto the stack, type 5.76 then hit enter. This number will now be in memory slot A0. Commands such as +, -, * ect. are read from the keyboard (see below). In most cases, the line (if it is a valid expression) will be used as a command parameter before A0 example: your stack looks like this: . . A2: A1: 6 A0: 2 4 if you press "+" on the keyboard, you will get this . . A2: A1: 6 A0: 6 because the line is a valid expression, the command automatically pushes it. if the line were blank, however, the stack would look like this . . A2: A1: A0: 8 the result of a command will always be in A0, never the line (except for the negative command). COMMANDS: the following is a list of command keys, the number of parameters they require, and what they do. In a commands where order of the parameters matters, a symbol (such as x - y) will be show in parenthesis. x represents the higher memory slot (the one higher on the stack), and y represents the lower one. all commands will clear the line unless marked with a #. items marked with an @ are affected by the Push Line option (see below). All basic math and trig functions automatically push the line if it is valid. key : parameters : function basic math: + : 2 : add - : 2 : subtract (x - y) / : 2 : divides (x / y) * : 2 : multiplies 2nd + ^ (pi) : 0 : pushes pi on the stack 2nd + * (sqrt): 1 : calculates square root ^ : 2 : raises x to the y power (x ^ y) EE : 2 : multiplies x times ten to the y power (x * 10 ^ y) trig functions: 2nd + Y (sin): 1 : calculates sin 2nd + Z (cos): 1 : calculates cos 2nd + T (tan): 1 : calculates tan diamond + Y (sin^-1): 1 : calculates arcsin diamond + Z (cos^-1): 1 : calculates arccos diamond + T (tan^-1): 1 : calculates arctan functions (see FUNCTIONS MENU below): abs : 1 : absolute value truncate : 1 : rounds down round : 1 : rounds normally ceiling : 1 : rounds up mod : 2 : calculates remainder of x/y (x mod y) stack functions: diamond + clear : 0 : clears the entire stack diamond + backspace (del) : 0 : pops A0 off the stack ( : 0 : rotates the stack up @ ) : 0 : rotates the stack down @ | (the with operator) : 2 : flips A0 with A1 @ line function (these require no parameters): any character 0 - 9 plus the character "." will clear : clears the line backspace : takes the last character off the line # 2nd + EE : types the character 'e' into the line (for scientific notation) # misc. (these require no parameters): mode : brings up the mode menu # F1 : bring up options menu # F2 : run a program # F3 : bring up function menu # (-) (negative key): toggles negative sign on the line. if the line is not a valid expression, it multiplies A0 by -1. # 2nd + esc (quit) : exit RPN89 @ 2nd + on (off) : turn the calculator off # on (only during program execution) : emegerency break of program execution. Stops program and exits RPN89 THE OPTIONS MENU Angle Memory: this is how RPN89 determines what the angle mode (rad or deg) will be when it is run again. "Copy from system" (default) takes the mode from the TIOS. "Save to File" stores the setting in the rpninf.INF file. Exp. Format: this is how RPN89 determines what the exponential format will be when it is run, and how it affects the system setting when closed. "Copy from System" reads the setting from the TIOS. If this is set when RPN89 exits, it will change the TIOS setting to match the RPN89 one. "Save to File" saves the setting to the rpninf.INF file. If selected when RPN89 exits, the TIOS setting will be restored to what it was when RPN89 started. Archive INF: determines weather or not to archive the rpninf.INF file. Push Line: determines weather or not to push the contents of the line on the stack before executing a stack command (flip, rotate), exiting RPN89, or running a program. If not, the line will be cleared before these actions are executed. Commands that are affected are marked above with a @ Show Program: determines weather or not to show the program pushing and popping the stack during execution. Turn off for faster execution. Stack Memory: determines what part of the stack will be remembered for next time RPN89 is run. "None" (default) does not save the stack. "Normal" saves A0 - A4. "Extended" saves A0 - A4 plus the extended stack. THE MODE MENU Degree Mode: allows you to change between Radian and Degree Mode Exp. Format: allows you to chnage how numbers are displayed on the stack. The choices are Normal, Scientific, and Engineering. Each one correspondes to the ones in the TIOS Mode dialog box. RUNNING A PROGRAM To run a program, press F2 then select the folder and file you wish to execute. See the read-me file for the RPN89 compiler for information about writing a program. THE FUNCTIONS MENU the functions menu contains several functions that are not mapped on the keyboard. They act as any other math command. See the COMMANDS lising under the "functions" heading for the functions. LEGAL Since you did not pay me anything for the right to use this software, there is no warranty of any kind. This software has been tested, and at the time of release the author was not aware of any problems with it. However, there is still a possibility of unforeseen problems. If you do encounter any problems with this program, please inform me ASAP This software is in the public domain, which means that it is not copyrighted at all. Thus you may use, copy, or modify it any way you want. If you would like a copy of the source code for this program, please e-mail me at JPEWdev@delorean.com