The version number is 5.0.0 What works - what doesn't ========================= This version can tokenize, load and run TxBASIC programs on any Tattletale loaded with TxBASIC 4.10 and above. The editor and terminal emulator should be fully functional. The datafile off-load command works. ReMind works as well as the View Variables function. The serial port set-up screen allows setting all the serial port parameters now. Scrolling back through the terminal window buffer can seem a bit strange at first. You can scroll back by either hitting the Up Arrow key or by clicking in the terminal window "Scroll off" box (which will change to "Scroll on"). A scroll bar will appear on the right of the terminal window. You can scroll back and forth using the mouse on the scroll bar or by using the Up Arrow and Down Arrow keys. Although characters coming into the COM port will be saved in a buffer, they will not be displayed until scrolling is turned off. This can be done by either hitting the Return key or clicking in the terminal window "Scroll on" box (which will change to "Scroll off"). Remember - the terminal window will not accept new characters until scrolling is off. If scrolling stays on for an extended time, characters may be lost when the buffer overflows. This version cannot modify variables on your Tattletale from TxTools (used by all Tattletales except the Model 8) but you can view variables on your Tattletale. Modifying variables will be added at a future date. When you find problems ====================== Please send all bug reports and requests for features to: Jim Dodd Onset Computer Corp. jim_dodd@onsetcomp.com Installing TxTools for Windows ============================== Simply run the program. TxTools will check the Windows Registry and will not find an entry for itself. It will display a list of available COM ports and ask you to choose one. This port number (along will a long list of parameters) will be saved in the Registry when you exit TxTools. To uninstall TxTools, run RegEdit.exe and delete the key "TxTools" under the heading "Onset Computer Corporation" in the "Software" heading under the "HKEY_CURRENT_USER" root key. At this point, the following items are saved in the registry. This will change in future versions of the application. HKEY_CURRENT_USER | Software | Onset Computer Corporation | TxTools | Program Version Int Version number of TxTools OpenDir String Start directory for Open dialog SaveAsDir String Start directory for Save As dialog OffloadDir String Start directory for Offload dialog NumMRU Int How many Most Recently Used files follow MRUFile00 String Most recently used file followed by others MRUFilexx String Less recently used files Autoindent Bool True if editor autoindents text TabSize Int Tab size in characters. Must > 0 and < 255 FileExAction Int Suggested action if saving to existing file | Window Maximized Bool True if main window is maximized Left Int Non-maximized left side of main window Top Int Non-maximized top side of main window Width Int Non-maximized width of main window Height Int Non-maximized height of main window | Terminal Maximized Bool True if terminal is maximized Left Int Non-maximized left side of terminal window Top Int Non-maximized top side of terminal window Width Int Non-maximized width of terminal window Height Int Non-maximized height of terminal window Columns Int Number of characters displayed in a text line Rows Int Number of rows of displayed text Capture file String Path and name of default capture file Capture append Bool True if in append mode, false if in overwrite TabSize Int Tab size in characters. Must > 0 and < 255 | Ports Baud String Serial port baud rate ComNum String Serial port com port number must be 1 or greater DataBits String Serial port data bits (7 or 8) StopBits String Serial port stop bits (1 or 2) Parity String Serial port parity (Even, Odd or None) Handshake String Serial port handshaking (None or XON/XOFF) | Transfer TermType Int ASCII recv terminate, 0=char, 1=time-out, 2=cancel TermChar String Character that terminates ASCII receive TermTimeout Int Seconds of inactivity that terminates ASCII receive Prefix String String sent before sending ASCII file Suffix String String sent after sending ASCII file CharDelay Int Delay between send ASCII file characters (millisec) LineDelay Int Delay between send ASCII file lines (millisec) | Find StartAtTop Bool True if first find starts at top of document WrapAround Bool True if search wraps to top when end found SelectedText Bool True if search only selected text (if any) WholeWords Bool True to search for only whole words CaseSensitive Bool True to perform case sensitive search PromptOnReplace Bool True to prompt each replace operation ReplaceAll Bool True to replace all instances of find string NumFindStrings Int How many Most Recently Used find strings follow FindString00 String Most recently used find string FindStringxx String Less recently used find strings NumReplStrings Int How many Most Recently Used replace strings follow ReplaceString00 String Most recently used replace string ReplaceStringxx String Less recently used replace strings | Compile ConfirmConnect Bool True if app should wait for Tattletale response EmbedLineNum Bool True to put line number tokens in object file CreateListFile Bool True to create a separate List file CreateBinFile Bool True to create a separate binary copy of object file CreateSymFile Bool True to create a separate Symbol Table file CaseInsenSym Bool True to use case insensitive compare for all symbols MaxLabels Int Maximum number of symbols (variables + labels) MaxAsmLines Int Maximum number of assembler source lines What changed with version 5.0.0 - Only the version number! What changed with version 4.14.14 - The "Save all" selection under "File" now works. What changed with version 4.14.13 - The Help file is now available with the "Help | TxBASIC summary..." menu selection. The file used for this help is a standard Windows Help file named TxTools.hlp and can be used independently from the TxTools application. This is just a rough first pass at the help file. We hope to improve it soon. - The Print selection of the File dialog now allows more options and correctly handles the options it allowed before. You can now optionally select a range of pages to print (instead of printing the entire document). You can now optionally print multiple copies of a document and optionally collate the pages. TxTools now corectly handles printing selections that span pages on the printer. What changed with version 4.14.12 - On first installing TxTools and selecting a serial COM port, it was possible to later exit TxTools and have this information not be stored in the Windows Registry. This meant that the next time TxTools started, no COM port would be selected and all menu items (except those involved in selecting a COM port) would be disabled. This has been corrected and installing TxTools will save the COM port information when you first set it up. - Sometimes, when receiving an XMODEM file, TxTools would force a TXB extension on the new file. Now this should never happen. - When the ASCII Transfer Options dialog was closed, an empty error message box would appear. Nevermore (apologies to Mr. Poe). - If the process of starting Capture to File for the Terminal window was canceled, Capture to File mode would be enabled anyway. Now it remains disabled. - A clarification - When you open a program file, save a program file or off-load a datafile, the initial directory displayed in the file dialog box comes from a value that is saved in the Windows Registry. There is a separate entry for each of the three situations (open program, save program, off-load datafile) and it is updated to the directory of the last file that was selected by the dialog. When you first install TxTools, all three directories are initialized to the directory where TxTools.exe is located. If you immediately open a program file in a different directory, that different directory becomes the default the next time you go to open a program file. The save program and off-load datafile default directories will not be changed until you use those dialogs. Is that more clear or more confusing? If you have comments on this, contact Jim Dodd at: jim_dodd@onsetcomp.com What changed with version 4.14.9 - The option to embed line number information in the final TxBASIC executable file was being ignored. Line numbers were ALWAYS being embedded in the program making the program larger by three bytes for every line of your program. Now, you can choose if you want the line numbers (a HOW? error will give the line number where the error occurred) or not (saving program space) from the "Tattletale| Compiler options..." dialog. The checkbox is labeled "Embed line numbers". Unchecking this will reduce your program size. - A new option is available for the "Tile" selection of the "Window" menu. Tile now has a sub-menu to allow tiling the windows horizontally or vertically. - A new command is available under the CommPort menu. You can now choose "Clear terminal" to clear all the text in the terminal window. This includes text in the scroll-back (non-visible) part of the terminal window. There is also a new "button" labeled "Clear" in the status bar at the bottom of the Terminal window. This acts just like you selected CommPort | Clear terminal. What changed with version 4.14.8 - Another bug was fixed in the Replace function. If "Start at top", "Replace All" and "Prompt On Replace" were selected, after finding the first instance, the second search would start at the top of the document again - subsequent searches would be handled correctly. Now, Replace works as it should. What changed with version 4.14.7 - All the normal serial port parameters can be viewed and changed with the port settings dialog. This includes baud rate, port number, data bits, stop bits, parity and handshaking. - All of these serial port parameters are stored in the Windows Registry when TxTools exits and are restored when the program starts the next time. The Registry list (above) has been updated. Notice that baud rate and port number used to be stored as integers under different names. When you first run this version, TxTools attempts to read the old settings, update the new settings to those values and remove the old Registry values. If you get an error on start-up, use the Alt-P (Port set-up) shortcut or choose "Port setup..." under the CommPort menu to set up the serial port correctly. - A bug was found in the Most Recently Used file list that would, rarely, allow multiple copies of the same file to show up in the list. Also, in announcing this feature, the explanation failed to mention that the full path to the file can be found in the status bar at the bottom of the TxTools main window. Just let the mouse hover over the file name in the Most Recently Used list and its full path name will show up in the status bar. - Another bug in the Most Recently Used file list was found and fixed. This involved files opened from a network. Now, the path to these files should be handled correctly. - The list file and symbol table file no longer produce a blank line between every line of text. - Shortcut keys were added for the File|Open and File|Save menu items. In the DOS version of TxTools, Function Key 3 (F3) could be used as a shortcut for Open and Function Key 2 (F2) could be used as a shortcut for Save. Unfortunately, many Windows programs use F3 for the Find Again function (as we have in TxTools for Windows). Therefore, we've changed the shortcut for File|Open to F4 - Function Key 4. The shortcut for File|Save is F2, as in the DOS version of TxTools. Please accept our apologies for trying to change your habits. - The ReMind EPROM function (under the Tattletale menu) now works. - The View Variables function (under the Tattletale menu) now works. To get the data for a specific variable, just click (once is enough) in the Data column for that variable. To get the data for all variables, use the "All data" button at the bottom of the dialog. To get a different symbol table, use the "Open" button. To change the format of the addresses for the variables, click in the "Address..." heading box. You can toggle between hexadecimal (the default) and decimal. The default format for floating point data is fixed point format. You can toggle between this and scientific format by clicking in the "Data..." heading box. Floating point values larger than 1.0e7 or less than 1.0e-6 are forced to be in scientific notation. - A bug was fixed in the Replace function. If "Replace All" and "Prompt On Replace" were selected, you would continue to be prompted about replacing the selection after the last selection was finished even though there was no selection. The only way out of this was to cancel the action. Now, Replace works as it should. - New filters are available in the Open File Dialog box. There is now a filter for: TxBASIC programs - *.TXB (this has always been available) TxBASIC list files - *.LST TxBASIC symbol tables - *.SYM Any TxBASIC file - *.TXB, *.LST, *.SYM Any file - *.* (this has always been available) What changed with version 4.14.6 - A bug was fixed in the compiler. If the MODEL command was not used to specify a Tattletale model, TxTools would complain about an unknown model number. Now, unless certain commands demand it, the MODEL command is not necessary. - The Replace function under the Search menu works now. - The Find Again function under the Search menu now works for both Find and Replace. Normally, it will find the next occurrence of the find string in the editor. If the last operation was a replace, though, Find Next will replace the current selection and find the next occurrence of the find string. - The Send File ASCII function (under the CommPort menu) is now implemented. - The Receive File ASCII function (under the CommPort menu) is now implemented. - There is a new dialog for setting options for the Send File ASCII and Receive File ASCII functions. The dialog is accessed through a menu item labeled "ASCII transfer options..." under the CommPort menu. ASCII Receive - Select how an ASCII receive will terminate. Selecting the first radio button, Character, will stop storing data to the file when a specified character is received. The terminating character will not be included in the disk file. You can enter the character in the edit box to right. Any printable character is specified by simply typing the character in the edit box. Certain control codes can be entered by using the escape character before a letter. These control characters are allowed: \a BEL alarm, the bell character 07H \b BS backspace character 08H \f FF formfeed character 0CH \n LF newline (linefeed) character 0AH \r CR carriage return character 0DH \t HT horizontal tab character 09H \v VT vertical tab character 0BH \" double quote character 22H \' single quote character 27H \\ backslash character 5CH Finally, any character from 00 to FF hex can be specified by using \xhh where '\' and 'x' are the literal characters and 'hh' is two hexadecimal digits. For instance, to specify that FF hex is to be used as the terminating character, enter "\xff" (without the quotes) in the edit box. To specify 00 hex, use "\x00". Selecting the second radio button, Time-out (sec), will stop storing data to the file when there is no activity on the serial input for a specified number of seconds. You can enter the number of seconds in the edit box to right. Selecting the third radio button, User cancel, will stop storing data to the file ONLY when the Cancel button is clicked in the status window. Clicking cancel will also stop either of the other two options of file reception. ASCII Send - Select options for sending an ASCII file. You can send a string out the serial port before and/or after sending the disk file. Just fill in the edit box labeled "Send prefix" for a string to be sent before the disk file is sent. Fill in the edit box labeled "Send suffix" for a string to be sent after the disk file has been sent. Non-printable and control characters can be sent using the same techniques listed above for the Terminating Character for an ASCII receive. For example, if you need to send a command (like "Load") followed by a carriage return/line feed pair before the file is sent, fill in the "Send prefix" edit box with: Load\r\n or alternately: Load\x0d\x0a using the hex codes for carriage return (0d hex) and line feed (0a hex). If you are sending the file to a slow device, you can add a delay between characters and/or lines by filling in the appropriate edit box with the number of milliseconds of delay you want between characters and/or lines. - A "Most Recently Used" list of files has been added under the File menu. The last five editor files are listed. The order is changed when a new file is opened with the latest file to be opened listed at the top. To open a file in the list, just click on it. If it's already open, the file's editor will be brought into focus. If you want to remove a file name from the Most Recently Used list, hold the Control key while you select the file in the list. What changed with version 4.14.5 - Sending a BREAK over the serial port was added. A menu item was added under the CommPort menu was added along with a shortcut of Alt+K (holding the Alt key while hitting the 'K'). Also, the status bar at the bottom of the Terminal Window has a new section showing the status of the BREAK (either on or off). If you click on this area of the status bar, the state of the BREAK will toggle. - This version was not released What changed with version 4.14.4 - Programs for the Model 8 would give various problems but none would run. All TxBASIC programs for the Model 8 should run now. What changed with version 4.14.3 - A bug was fixed that caused memory to be corrupted or a non-working TxBASIC program to be generated. The code that caused this was triggered by using forward label references in the TxBASIC program. This has been corrected and forward references are once again available to TxBASIC programs. - The Disk Off-load function (under the Tattletale menu) is now implemented. - The Send File XMODEM function (under the CommPort menu) is now implemented. - The Receive File XMODEM function (under the CommPort menu) is now implemented. - The status window now shows both the percent complete and the number of bytes transferred (under the moving bar). Where the full size of the transfer is unknown (as when receiving an XMODEM transfer), the moving bar just shows activity and does not display percent completed. What changed with version 4.14.2 - The Open file and Save file functions (under the File menu) were using a default TFB extension instead of TXB. They both use TXB now. - The Open menu item is supposed to save the path of the last opened file but it wasn't. When the next open is attempted, it is supposed to start in the saved directory. TxTools now works that way. What changed with version 4.14.1 Initial release