ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ V9t9: TI Emulator! v6.0 Documentation (c) 1995 Edward Swartz ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÍÍÍÍÍÍÍÍÍÍÍ ORDERING.TXT ÍÍÍÍÍÍÍÍÍÍÍÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ This file tells how to place orders with me for ROMs and module dumps, and how to use them. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ³ ORDERING A MINIMAL SET OF ROMS ³ ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ If the procedure outlined in TRANSFER.TXT for moving 99/4A ROMs over to your PC is too arduous or impossible, you can purchase a minimal set of ROMs from me through my software license with TI. These ROMs will let you run the emulator, without the vocabulary of the speech synthesizer, the RS232/PIO, or 99/4A Disk DSR ROMs (these ROMs are not covered by my license). The fake disk ROM provided with the emulator allows you use to FIAD file access (see DISKS.TXT), perfectly useful for most applications. The fake RS232/PIO ROM is also very useful, except for the lack of the SAVE and LOAD commands. The fake speech ROM is what allows most programs which have their own speech to operate. The archive you receive will contain: þ 99/4A ROM and GROM images þ Three modules (see BINARIES.TXT) This is only $15, and the money goes mostly for royalty fees. You don't have to pay the fairware base fee for this order. This offer is intended for those of you who feel uneasy sending $25+ for something you haven't seen in action (though you needn't worry if the demos satisfy you). Please use the ORDERMIN.TXT order form for this order. I'd prefer to send these orders through e-mail. However, if it's impossible to use e-mail, PLEASE "pool" with your friends and bulk order the ROMs. (I'll send them all on one disk, if possible.) It'll make my shipping and handling fees lower. (Go to the "ordering guidelines" section.) ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ³ ORDERING BEYOND THE "MINIMAL PACKAGE" ³ ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ When not ordering the "minimal package", use the general order form ORDERGEN.TXT. With it, you can get other modules and source code. With the general order, a fairware "base fee" is required. The base fee for first-time customers is $25. Users who have previously sent me money for TI Emulator! v4.0 or v5.0x pay a base fee of $15. Before you make a general order, I prefer that you already have copies of your 99/4A ROMs to use with V9t9 or have ordered the "minimal package" of ROMs from me. This is so that you won't have to pay a base fee, in essence just to use V9t9, which goes against my beliefs about fairware. Also, it shields you from any surprises you may not have anticipated just by watching the demos. :) If you do go ahead and order the "minimal package" and "general package" together, be sure to fill out both order forms (ORDERMIN.TXT and ORDERGEN.TXT) completely. Only send one check, though. I'll keep track of it. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ HOWEVER: Do not, under any condition, advise someone to send me an order for a "general package" if they have not used or seen the emulator. V9t9 is NOT a commercial product that must be purchased before use. (Or that must be purchased at all.) I do NOT want someone to pay me and then possibly be dissatisfied with the product -- because all purchases are final. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ³ ORDERING GUIDELINES ³ ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ þ First of all, this program is NOT SHAREWARE. You do NOT have to pay for using it. Of course, however, like any struggling programmer, I am perfectly willing to accept money for my work. :) Also, there is no "registered" version of this program. That would imply that I'm leaving important features out of -- or "crippling" -- the fairware version, a practice I consider evil. Now, the emulation may be incomplete, but that is simply because I'm not finished with the program. þ I will not make any guarantees about the usefulness or suitability to your purposes for anything you buy. All purchases are final. There is no warranty for the programs I have written. þ I will release a new version of V9t9 every FOUR MONTHS. Any earlier archives are considered to have expired at such time. The NEWEST version's ordering guidelines apply to all orders I receive. This means that the newest guidelines apply even if you do not know about them. To avoid such a situation, be aware of new versions of V9t9 before ordering. I will probably NOT change all the guidelines in every version, of course. So if you send an order, and the relevant ordering guidelines haven't changed, I will still accept it. However, I highly recommend that you look for the latest version first. Or you can e-mail me, and I'll send you the latest version for free. (See DISTRIB.TXT.) If this guideline seems harsh, consider this: I released TI Emulator v4.0 around March 1994. That version was obselete TWO MONTHS later, when I released v5.01. I figured that people would switch to v5.01. But of course, people still ordered v4.0 -- AND THEY'RE STILL TRYING, seventeen months later! V4.0 (and v5.01) had no expiration date, you see. Now, of course, they are absolutely and completely obselete. Hopefully a more aggressive distribution strategy for V9t9, along with this expiration date policy, will lessen my headaches. þ I will no longer accept orders for TI Emulator v4.0 or v5.01, and will reject any order which doesn't appear to be for this program. (Meaning, if you don't use the provided (and recommended) order forms, please use "V9t9 v6.0" somewhere in your letter to let me know that you're not referring to an older version.) þ If you send an order for an old version, and the newest guidelines are similar enough not to void the order, the latest version of V9t9 will also be sent to you, minus the demonstrations (to save space). If you ordered any utilities, they will be compatible with that latest version. The new version, if any, will be the fairware archive. It will not be a "registered version" or a privileged upgrade. þ Users who send me money are NOT considered to be "registered for life" (this applies to v4.0 and v5.01 customers too). If, in the future, I provide some new things to order, or make some special offers, it doesn't mean a customer of this version is entitled to free copies. The same goes for archives of V9t9. I will not send the new archive to all the customers of the previous version. This is a matter of manpower and money. I'm the only person doing all this mailing and programming and college-studenting, and it is simply impossible for me to maintain such a service. If I charged a lot more for the program, or had a company, I could do this, but I don't right now. Sorry. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ þ If you want to buy any module dumps, please consult the list in BINARIES.TXT in making your order and use the three-letter codes on the order form. This will allow me to quickly archive and record your order. Although some modules come with disks (such as TI Writer and Editor/Assembler), my license doesn't allow me to distribute them. In any case, each module costs one dollar. þ You can purchase the source code for V9t9.EXE from me for $100. It's written entirely in assembly. I recommend that you know 80x86 and 9900 assembly before you purchase it; it's not intended to teach assembly. It was written under Turbo Assembler v3.1 using Turbo Link v5.1, but has compiled under v2.0. I'm unsure about Microsoft Assembler compatibility. It's probably not compatible since I use TASM's ideal mode. You are restricted from distributing the source code or making hybrid versions of V9t9. Some day, when I stop V9t9, I'll release the source code to the public domain, but not yet. The source code will be for the VERSION YOU ORDERED. Take note of this! All orders will come with the archive of the latest version of V9t9 (if one is available), but the source code is not for the new version. þ Currently, I am offering nothing else for you to order. Utilities to transfer modules and files from the 99/4A to your PC, which were paid fare for older versions, now come free with the V9t9 archive to help more people make use of the program. If you have any suggestions for V9t9 utilities I could develop and sell, I'm happy to listen. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ þ Please send all orders by check or money order. Do not send cash in an envelope, because it is likely that someone on the path between you and me will divert your money. þ Please don't send your order via registered mail. As far as I can tell, I have received all the orders sent to me. (The no-money-in- an-envelope request comes from opening a few cash orders and wondering how they DIDN'T get lost or stolen.) Sending your order via registered mail is only an unnecessary hassle, for you and for me. þ If you send money from outside the United States, be sure it is a check that is CASHABLE IN A U.S. BANK. For example, it should read in small print somewhere, "Cashable at the First National Bank in New York." (A $25 collection fee is otherwise required to cash foreign checks, rendering them mere pieces of paper.) Better yet, send a U.S. Postal Money Order. Please add $5 for shipping and handling, and expect a few weeks delay for the post office to do their dirty work. ÍÍÍÍÍÍÍÍÍÍÍÍÍÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ³ RECEIVING YOUR ORDER THROUGH SNAIL-MAIL ³ ÍÍÍÍÍÍÍÍÍÍÍÍÍÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ There is a disk/postage charge of $2 for snail-mail orders (except for minimal orders). Since postal guidelines state that snail-mail orders must be sent within a month unless the buyer agrees to a delay, your payment to me is an agreement to a maximum wait of 60 days to receive your order from the time I get it. While I do not PLAN to make anyone wait this long, I am a college student and have a sufficient workload already without sending off every order the afternoon I get it. In the summer of 1994, delays were an average of two/three weeks. Hopefully they will now shrink to a mere week, now that I've eliminated the vague wording from the ordering guidelines which caused v4.0 and v5.01 orders to anguish me so. Note that it takes the post office about a week to send disk mailers, even with first class postage. If necessary, I will cash your check before sending your order, so please don't panic and assume your order got lost in the mail, unless 60 days have passed since I received your money. If I am unable to send your package within the maximal time limit, I'll return your money and send the latest version of V9t9 and profuse apologies. This should only happen if I lose your order on my desk. If, when you receive your order, the disk has bad sectors or obviously missing files, I'll remedy the situation. Send back the original disks, and I'll send you fixed copies for free. (This only applies to errors found upon receiving the disks -- it's your responsibility to back up the disks to prevent data loss from extended use.) When you receive your order, always unzip it in the directory where you have installed V9t9, with the "-d" option: C:\V9t9> pkunzip -d a:v9t9mods.zip The "-d" option will put the files into the correct subdirectories. In each archive is a short README telling you how to use the new files with V9t9. ÍÍÍÍÍÍÍÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ÍÍÍÍÍÍÍ ³ DO I HAVE TO WAIT FOR YOU TO SNAIL-MAIL ME THE ORDER? ³ ÍÍÍÍÍÍÍÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÍÍÍÍÍÍÍ Absolutely not! I will be happy -- overly joyously happy -- to send your order through e-mail over the Internet. Please don't send YOUR order to MY e-mail address; I will to receive your check before sending an order, anyway. If your e-mail server doesn't allow "big" messages to be sent to it (for example, a limit of 200k), provisions will be made to stick your order on an FTP site for you to retrieve. Please specify if you want the files sent UUENCODED or sent with MIME encoding (aka message "attachments", like Pine uses). If you elect to use this method for receiving your software, I will send the files encoded with a keyword you supply with your order. This is in order to prevent e-mail pirates from obtaining access to TI's copyrighted ROMs. The keyword must have no spaces in it and be at least 8 characters long. You can use any ASCII characters except control characters, spaces, tabs, and the quote mark ("). Capitalization counts!! If your system does not accept long e-mail, and we don't find out until I've tried to send your order, we'll make provisions to retrieve it from an FTP site (this is really where the archive encoding comes in handy!). If all else fails, it's snail-mail (and the archive won't be encoded). So be sure to include your address on the order form. I am assuming that you know how to transfer files from your UNIX system to your PC. If you're unfamiliar with the process, please consider learning, or receive the order via snail-mail to eliminate the hassle. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ³ HOW TO RECEIVE E-MAIL ORDERS FROM ME ³ ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ When you receive your order, please notify me by e-mail. This tells me that you properly received it. (If you received a new V9t9 archive, check the CONTACT.TXT therein to be sure of my current e-mail address!) If I don't receive a reply within a week, I will resend the package up to two more times (again waiting a week for a reply). If you didn't appear to receive the order, I'll snail-mail the order instead. The archive will be encoded with a keyword you specified (but not if it's send via snail-mail). You'll need to decode the archive before being able to use it. If you receive your order via e-mail, you'll need to transfer the file to your PC over the modem (or with FTP in a computer lab). I can't teach the details of transferring files -- please contact your UNIX system administrator. I can only tell you how to assemble the binary from the ASCII e-mail message I send you. If you already know how to do all this kind of stuff, skip down a few sections. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ UUENCODED ARCHIVES If you specified to receive the file in UUENCODEd format, you need to uudecode the mail message into your account. First thing is to look at the text of the message to verify that it is indeed UUENCODEd. Look for the first line in the file which says "begin xxxxxxxx". This is the line which tells what the filename of the archive will be, after you uudecode it. After that will be long lines of nonsense characters. Return to the screen showing the list of messages, and make sure the highlight is on the big message from me. þ ELM users. 1) One thing to do (quick-and-easy) is to press "|" (for pipe), and type in "uudecode" (lower-case). Most likely it will look like nothing at all happened, but it probably did. Press "!" to execute a UNIX command (such as "ls -lA xxxxx" where xxxxx is the filename in the "begin" line), and verify that the file from me is there. 2) The other option is to press "s" to save the uuencoded message. Save it to a file like "v9t9.uue" or somesuch. Then, exit ELM, and run "uudecode v9t9.uue". Do "ls -lA xxxxxxx" (where xxxxxx is the filename in the "begin" line) to make sure the file was created properly. þ PINE users. The best thing to do under Pine is this: from the message list, press "o" for other options. You should see an option "Export", which is activated with the "e" key. (This is opposed to "Save", which is a little more complex.) Press "e", and enter "v9t9.uue" as the filename. Then, exit Pine, and run "uudecode v9t9.uue". Do "ls -lA xxxxxx" (where xxxxxx is the filename in the "begin" line) to make sure the file was created properly. þ Now go to the "TRANSFER" section. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ MIME-encoded ARCHIVES (aka Pine Attachments) If you specified to receive the file in Pine's "attachment" format, it will be very easy. Simply open your INBOX, locate my message, and press "v" to view it. It will tell you that part of the message is text, and the other part is an attachment. Read the text part for important information I may have added at the last minute. Then move the bar over the attachment part, and press "s" to save the file to your account. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ TRANSFER This is the tricky part, especially if you're new to Unix. I suggest you get detailed information on file transfers from your system's administrator, since it is different from machine to machine. Some tips for transferring, though, to lessen common errors. With KERMIT, use this command line: unixcomputer:~> kermit -i -s xxxxxxx or, if using the command mode, enter "set file type binary" before transferring the file. If using ZMODEM and "sz", try the "-eb" options if your find the transfer is racking up a lot of errors. If you have an old ZMODEM program in DOS, always use the "-b" option from UNIX, to assure that "sz" doesn't try to use ASCII mode. If using "ftp" to transfer files to a local machine in a computer lab, always enter "bin" to set the file type to binary. PC-based FTP programs usually make ASCII the default mode. Please store the incoming archive right in your V9t9 directory. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ³ DECODING AND UNPACKING E-MAIL ORDERS ³ ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ This only applies to e-mail orders. Snail-mail orders are not encoded. Once the archive is on your PC, you need to decode it. I encode e- mail archives with the keyword you specified to ensure that pirates don't steal it. (This encoding is separate from the binary-to-ASCII encoding used to send archives via e-mail.) Say you ordered 30 module dumps, and your keyword is "V9t9". (Don't use this keyword yourself, pleez.) The archive I send you may be named V9t9MODS.PKG. This is an encoded PKZIP-compatible archive. You need to run UTILS\DECODE on the file to decode it: C:\V9t9> UTILS\DECODE V9t9MODS.PKG V9t9MODS.ZIP V9t9 ^^ encoded file ^^ decoded file ^^ your keyword (source file) (destination) DECODE won't be able to tell you if you entered the right keyword, so you'll need to remember it. If you forget, contact me via e-mail. (See CONTACT.TXT.) To unpack the archive, run PKUNZIP on the file, and use the "-d" option. This will put the files in the proper subdirectories: C:\V9t9> pkunzip -d V9t9MODS.ZIP If anything goes wrong, check this list: þ Be sure DECODE didn't die with an error. þ Be sure your keyword was correct (capitalization counts!!) þ Be sure you transferred the file from the UNIX system in BINARY mode. þ If you run PKZIPFIX on the file and you get *some* files, there was a transfer error. Try transferring the archive again before contacting me to resend it. In each archive is a short README telling you how to use the new files with V9t9. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ