XMDPW5.200 by Phil Wheeler 3/17/88 XMDPW5.CO is a full featured machine language communications program for the 100/102/200 Tandy laptop computers. It is created by running the appropriate Basic loader program on your laptop, the resulting program includes: 1 - Online access to BASIC and TEXT (based on code by Hugo Ferreyra) 2 - Split screen for use in online conferences (based on code by James Yi) 3 - Scroll lock to reduce speed constraints associated with the LCD, useful in the capture mode. 4 - Macros sent while online (based on code by Jon Diercks). 5 - Xmodem file transfer, either CRC (cyclic redundancy check, a polynomial generated 16-bit checksum) or standard checksum. USING THE MENUS On entry to the XMDPW5.CO you will be in the Command Mode. The function keys will have the following assignments: [F1] Find: (search your ADRS.DO for a number). [F2] Call: (dial a given number). [F3] Stat: (display or alter the serial port status). [F4] File: (displays the filename directory, as in BASIC). [F5] Free: (displays "Bytes free" as in the MENU display). [F6] (unused) [F7] Term: (switches to the "normal terminal menu", see below). [F8] Menu: (returns to the MENU). Note that STAT must be set with Ignore parity when using XMDPW5, Even parity can give erratic results following an Xmodem download. Pressing F7 in the Command Menu takes you to the Normal Terminal Menu, with the function keys defined as follows: [F1] Prev: (displays the previous 8 lines until it is pressed again, also sends a X-off if enabled). [F2] Down: (downloads just like in TELCOM). [F3] Up: (uploads just like in TELCOM). [F4] Full/Half: (toggles between full and half duplex, remains in effect in XMODEM terminal mode). [F5] Echo: (toggles the printer echoing on and off, remains in effect in XMODEM terminal mode). [F6] Says "Wait" when a X-off is recieved. [F7] Xmod: (switches to XMODEM terminal mode, see below). [F8] Bye : (returns to the "command mode", press "Y" to confirm). Pressing F7 will take you to the Xmodem Menu, with the function keys defined as follows: [F1] Prev: (displays the previous 8 lines until it is pressed again, also sends a X-off if enabled). [F2] Send: (sends a .DO file to the host using XMODEM protocol. Begins by prompting for a filename, ext may be left off). [F3] Recv: (receives a .DO file from the host, using XMODEM protocol. Begins by prompting for a filename, ext may be left off). [F4] File: (displays the directory, same as executing FILES in BASIC. [F5] Free: (displays "Bytes free" as in the MENU display. [F6] Says "Wait" when a X-off is recieved. [F7] CRC/CkSm: (toggles between CRC and the standard checksum mode, over ridden by host request when sending XMODEM. [F8] Norm: (returns to the "normal terminal menu"). XMODEM FILE TRANSFERS To send or receive with XMODEM protocol you must enter the XMODEM terminal mode by pressing F7, now F2 will read "Send" and F3 will read "Recv". Before proceeding the host computer must be in its standby mode, waiting for the transfer to begin. It will either be awaiting a CRC or checksum request, or repeatedly sending the same. Pressing either F2+ or F3 will prompt for a filename, it must be a .DO file. If receiving a file it must not already exist, if it does you will be asked if you want to erase the file. This is different than "Down" in TELCOM which will erase your file without asking. After a filename is entered, "Send" or "Recv" will continue until completion or an error (either of which will sound a beep). In the case of an error it will display the cause of the error and a retry number, it will retry up to 10 times. After a successful transfer it returns to the XMODEM terminal mode. The Xmodem transfer can be used with any baud rate, word length, parity, number of stop bits, and flow control enabled or disabled since it forces the setting to "x8N1D" (where "x" is the baud rate, 1-9 or M that you have set) during the transfer. It restores your previous settings when the transfer is finished or aborted, however if the Reset button on the back of the computer is pressed during the transfer the settings remain at "x8N1D". ONLINE ACCESS TO BASIC AND TEXT Pressing SHIFT+F7 takes you to TEXT and SHIFT+F6 takes you to BASIC. To return from TEXT press F8, to return from BASIC execute a CALL HIMEM+19, assuming that XMDPW5.CO is the lowest or the only CO program loaded in memory. This can be facilitated by defining a function key in Basic as follows: F6,"Term"+CHR$(24)+"Call#####"+CHR$(13) where CALL##### = the starting address of XMDPW5.CO plus 19 bytes. Caution: If you use a function key to return to Term from Basic make sure you zero out the definition if XMDPW5.CO is removed otherwise hitting this key could be unfriendly! SPLIT SCREEN WHILE IN CONFERENCE This program also includes James Yi's original split screen code for the T200, to toggle it hit SHIFT+F1. In CIS conferences it's necessary to send the command /NOECHO while in conference. For GEnie conferences switch to full duplex and go back to half duplex when it is over. To toggle the split screen mode on, the label line MUST be on. To use a label line function first press SHIFT+F1 to toggle split screen to off, then do your thing. Use SHIFT+F1 to get back to the split screen mode, other approaches work, but are confusing. SENDING MACROS WHILE ONLINE This program includes a macro routine, to use it go to TEXT and create a macro file named XMDMAC.DO. The following is shows how to construct XMDMAC.DO: <1>This is the first macro to be sent. <2>This is the second macro, and is a typical long and complex macro. It can include carriage returns, blank lines, ************* * * * O O * * ^ * * / \ * * ___ * * * * * *** and can be used to send bizarre graphics creations so long as they have all ASCII characters with values less than 128. <3>This is the third macro, another short one. Each macro must be started by a keystroke with its ASCII value above 127 as denoted by <1>, <2> and <3> above. Example: CODE-D, CODE-d or GRPH-c, each is sent by pressing the letter key while holding down the corresponding CODE or GRPH key. The macro will continue until another such CODE or GRPH character is reached. To send a macro while on line just press the CODE or GRPH key and the selected key, in fact by using the TEXT access you can even edit your XMDMAC.DO file while on line! SCROLL LOCK By pressing F6 while in either the Xmodem Menu or the Normal Menu the LCD scroll can be toggled. This mode is of limited benefit since it is some what difficult to read the LCD, but can be used in dumping BBS messages to a fast printer or a capturing file in RAM. The XMDPW5 project has been a joint endeavor contributed to by a number of programmers, first and foremost J.R. Chenoweth who wrote XMD100 from which most of the core program was derived. Edited by Robert Benson 4/24/89