BTK_HELP.TXT ------------------------------------------------------------- NOTE!! This file is in the format required for BTK's on-line help routines. It may be scanned using a text editor, but be careful not to modify it. TERMINAL BTK's terminal mode is the central operating mode from which all other modes are called. It is primarily a terminal emulator. The communications settings may be altered using the SETUP screen. If a "communications error" message is recieved upon entering terminal mode, it means that the program was unable to establish communications with the 8052-AH BASIC cpu. This is usually caused by the chip already operating at a different baud rate, or not powered up, or not connected to the PC serial port. If you got a "communications error" message and the target system is connected properly, try pressing the space bar to reestablish communications. For help on the menu selections, press the selection, then . Any menu selection can be backed out of by pressing . + SETTINGS The setup screen allows setting of communications parameters, and screen colors. All selections are made using the cursor keys. Abort setup by pressing , finish by pressing . If the settings become corrupted, or the screen mistakenly made illegible (ie. black-on-black), the default settings may be restored by deleting "BTK.INI". The program will create a new version based on the selections in effect when BTK is exited. Changes to any communications settings other than baud rate may have undesired effects when communicating with an 8052-AH BASIC cpu. These CPUs expect 8 data bits, 1 stop bit, and no parity. Changing the color settings on monochrome monitors may have unpre- dictable results. By default, the monochrome message screens use high intensity. This can only be restored by deleting "BTK.INI" (which can be found in the same directory as BTK.EXE), restarting the program, and selecting M for monochrome. Changing the colors for the terminal screen will not fully take effect until the program is restarted. + DOWNLOAD File download copies a BASIC program from a file on disk to the 8052-AH BASIC cpu. A "raw" mode is also provided for transferring ".hex" and other text files when using a monitor (Such as Binary Technology's M/DP) to put the program in the target system RAM. Raw / Basic mode is selected using the cursor keys. The filename is entered from the keyboard, and may be edited during entry using the right and left cursor keys. erases the entire line, aborts, and terminates the entry. and are also active. BTK will always keep a record of the most recent selections, so that downloads can usually be done with only two keystrokes. + UPLOAD Upload copies a BASIC program from the target system to a disk file on the PC. The 8052-AH BASIC cpu will sometimes expand lines during a "list" to a length longer that it would accept as input (79 chars), so BTK will adaptively compress the line during upload to assure that it will be accepted during a download. The filename is entered from the keyboard, and may be edited during entry using the right and left cursor keys. erases the entire line, aborts, and terminates the entry. and are also active. BTK will always keep a record of the most recent selections, so that succesive uploads of the same file can be done with only two keystrokes. + EDITOR The btk editor is a screen-oriented editor allowing the user to move about the screen by using the four cursor keys and the page up, and page down keys. There is also a "goto line" command which will center the desired line on the screen. The editor is always in "insert" mode. Keys that are active are to exit, , , and to delete char- acters. The editor works by sending the modified line to the 8052-AH BASIC cpu as soon as the line is exited. Note that if a line is rejected by the 8052, (such as a line with line number only) the internal editor pointers will become corrupted, and screen refreshing may become confused. In that case exit and reenter the editor. Both Delete Line and Insert Line will make best guesses as to the next line number that the user might wish to select. Delete Line will always suggest the next number in sequence, while Insert Line will base it's guess on the increment between the last and next-to-last numbers entered. The editor requires a line numbered program to operate properly, so at least two lines should be entered in terminal mode before using the screen editor. (This will be improved in subsequent releases.) Large Basic programs will cause the editor to become slow on startup, and "edit line" may be preferred. + RENUMBER Renumbers a basic program. The default selections are to renumber the entire program. ie. from 0 to 65535, starting with 100 and incrementing by 10. These numbers may be changed by moving to the desired position with the up/down cursor keys, and entering the new number from the keyboard. aborts the operation, and terminates an entry. A second (or a without changing any numbers) terminates number entry and begins the renumbering. Sections of a program may be relocated by using renumber. A file "BTK.TMP" will be created and left in the current default directory, containing a compressed version of the original (un- renumbered) program. This may be restored to the target with "download" if desired. This file will be overwritten by subsequent renumberings. + LINE EDITOR The BTK line editor allows editing of a single line from within a 8052-AH BASIC program. All the standard editing keys are active, Cursor right and left, Home, End, and (to abort). Characters typed are inserted in the line, and Backspace deletes the character to the left of the cursor. Line edit will first check the terminal screen to see if an error message containing a line number is present, and if so, will suggest that number upon entry. The key will erase the suggested number, allowing another to be entered. + ------------------------------------------------------------------