home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 628.XFER.DOC < prev    next >
Text File  |  1988-05-29  |  9KB  |  239 lines
  1.           DOCUMENTATION FOR FLTIBM.ASM/CO1/CO2/HX1/HX2
  2.  
  3.                   by Phil Wheeler -- 71266,125
  4.  
  5.  
  6.  
  7. 1. Introduction
  8.  
  9. FLTIBM is a program for the IBM-PC, and compatibles, which 
  10. facilitates file transfers to and from the Model 100; it should 
  11. do the same for any computer, including the Model 200 and the NEC 
  12. lap computers. It has been evolved from FLTKP.UPD in DL1 and 
  13. works the in a similar manner.  The final machine language 
  14. program is about 1.2K byte in length, making for fast loading and 
  15. operation.  I find it more convenient than working my way through 
  16. all the menus in PC-TALK, Qmodem, et al to do the same thing.  Of 
  17. course, FLTIBM does only one thing, direct-connect ASCII file 
  18. transfer at 9600 baud. 
  19.  
  20. This program has two fundamental applications.  One is for mass 
  21. storage of Model 100 programs and files, a plus for those of us 
  22. who have an IBM compatible but do not have a lap computer disk 
  23. drive.  The second, more general, use is in moving documents from 
  24. the lap computer to a desktop machine for further editing,
  25. merging, etc.  For example, a text file can be uploaded from the 
  26. Model 100 to the IBM and then be refomatted into a standard 
  27. Wordstar file by doing '^QQ^B. 
  28.  
  29.  
  30. 2. The Files
  31.  
  32. The FLTIBM files are:
  33.  
  34.     o FLTIBM.DES -- the beginning of FLTIBM.DOC
  35.     
  36.     o FLTIBM.DOC -- full documentation of FLTIBM
  37.  
  38.     o FLTIBM.ASM -- the source (Version 1.7, for COM1: port)
  39.  
  40.     o FLTIBM.CO1 -- FLTIBM.COM for the COM1: port
  41.  
  42.     o FLTIBM.CO2 -- FLTIBM.COM for the COM2: port
  43.  
  44.     o FLTIBM.HX1 -- FLTIBM.HEX for the COM1: port; convert to 
  45.                     FLTIBM.COM with hexconverter HC.COM from 
  46.                     IBMSIG
  47.  
  48.     o FLTIBM.HX2 -- FLTIBM.HEX for the COM2: port; convert to
  49.                     FLTIBM.COM with hexconverter HC.COM from
  50.                     IBMSIG.
  51.  
  52. These files replace all previous FLTIBM documentation and program
  53. files.  However, except for the version number message,
  54. FLTIBM.CO1 and FLTIBM.CO2 are identical to FLTY1.COM and
  55. FLTY2.COM, respectively.
  56.  
  57.  
  58. 3. Installing FLTIBM on Your IBM-PC or Compatible
  59.  
  60. FLTIBM must be downloaded into your IBM (or compatible) computer.  
  61. With xmodem capability in your PC, and 8 bit, no parity 
  62. Compuserve DEFALT settings, you can download 
  63. FLTIBM.CO1 or FLTIBM.CO2 directly, where the first is set up for 
  64. COM1 and the second for COM2; these are machine language programs 
  65. which can be loaded and used "as-is" in your PC/compatible.
  66.  
  67. Another approach is to download FLTIBM.ASM (an ASCII file) and 
  68. assemble it using MASM; before assembly, you must select COM1: or 
  69. COM2: as the direct-connect serial port as an assembly-time 
  70. option.  Once you have a copy of FLTIBM.ASM in your "big" 
  71. computer, you will need MASM and the IBM DOS programs LINK and 
  72. EXE2BIN.  Create FLTIBM.COM as follows: 
  73.  
  74.        1) Do 'MASM FLTIBM;<cr>' 
  75.  
  76.        2) Do 'LINK FLTIBM;<cr>' 
  77.  
  78.        3) Do 'EXE2BIN FLTIBM<cr>' 
  79.  
  80.        4) Do 'REN FLTIBM.BIN FLTIBM.COM<cr>'. 
  81.  
  82. where it is assumed here that all files are on the same disk and 
  83. <cr> is a carriage return or enter. 
  84.  
  85. If you have neither xmodem capability nor MASM, you can create 
  86. the desired FLTIBM.COM from the corresponding FLTIBM.HEX.These 
  87. can be downloaded with a 7-bit protocaol and converted using 
  88. HC.COM.  HC can be obtained by downloading MAKEHC.BAS from the 
  89. IBMSIG and running it under BASICA/GWBASIC. 
  90.  
  91. Rename whichever version you use as FT.COM for ease of use, and 
  92. put it in the root directory of your hard disk -- or on the 
  93. floppy you will use for transfers.
  94.  
  95.  
  96. 4. Operation of FLTIBM
  97.  
  98. To use FLTIBM, connect the RS-232 port of your lap computer to 
  99. the COM1: port of the IBM, using a null modem cable or adapter; 
  100. I recommend the null modem prescription given below, since it 
  101. fully supports the RS-232 hardware handshaking signals.  In this 
  102. regard, the Tandy 200 appears more demanding than the Model 100.
  103.  
  104. Run FLTIBM, by typing FT <CR>, if named as suggested above. You 
  105. will see a set of four options: receive, send, send a stripped 
  106. Wordstar file & quit. 
  107.  
  108. To transfer a file from the lap computer, select R)eceive and 
  109. give a file name in response to the prompt, followed by a <cr>. 
  110. On the lap computer, enter the file you wish to transfer and 
  111.  
  112. (Model 100/102) do 'save to:COM:88N1E<cr>', where the 'save to:' 
  113. comes from pressing key 3 in TEXT.  Reverse the process for 
  114. sending from the IBM to the lap computer.  Mainly ALWAYS DO THE 
  115. FINAL <cr> ON THE RECEIVING END BEFORE THE FINAL <cr> ON THE 
  116. SENDING END, and if the receiver is the desk-top machine, make 
  117. sure the drives have openned the file before starting the 
  118. transfer.  Otherwise you will get only part (or none) of the 
  119. file. 
  120.  
  121. The command syntax for using FLTIBM with the Model 200 requires 
  122. additional data in the "Save to:" and "Load from:" commands. 
  123. Specifically, replace COM:88N1E by COM:88N1ENI.
  124.  
  125. FLTIBM can be used to save/load Basic programs, as well. Enter
  126. Basic and use Save or Load with 'COM:88N1E' as the argument.  
  127. Programs will be detokenized into ASCII files when saved, and 
  128. retokenized when loaded.  As a result, the process will be a bit 
  129. slower than when working with text files. 
  130.  
  131.  
  132. 5. Null Modem Connections for FLTIBM
  133.  
  134. A good Null Modem prescription is as follows: 
  135.  
  136.         END A                END B 
  137.         -----                ----- 
  138.           1                    1 
  139.           2                    3 
  140.           3                    2 
  141.           4                    5 
  142.           5                    4 
  143.           6,20                 8 
  144.           7                    7 
  145.           8                    6,20 
  146.          20,6                  8 
  147.  
  148. This is what I use.  It is identical to the "store-bought" RS
  149. null modem adaptor. 
  150.  
  151.  
  152. 6. Stripping of Wordstar Files
  153.  
  154. FLTIBM optional stripping of Wordstar files as they 
  155. are sent to the lap computer.  Characters stripped are: soft 
  156. carriage returns; soft linefeeds; soft hyphens (end-of-line 
  157. and mid-text); no-break spaces (replaced with normal space); 
  158. control-B; control-S; control-D; control-T; and control-V. 
  159. This selection can be alterred or augmented by changing the 
  160. source code.  Note that this Wordstar stripping option will 
  161. also convert all high-bit characters to their 7-bit counter- 
  162. parts (i.e., subtract 80h from them).
  163.  
  164. After adding this code, I have found it more effective to do the 
  165. stripping in the PC, using a utility such as TEXTCON or WSCNVN, 
  166. before sending the file to the Model 100.
  167.  
  168.  
  169. 7.  Simulating an EOF for Some Model 100/102/200 Applications
  170.  
  171. This version of FLTIBM will interpret an incoming CHR$(206) 
  172. as an EOF, and convert it to a ^Z in the PC.  This is useful in 
  173. printing (or saving) to COM:88N1E from programs which do not 
  174. provide an EOF (^Z) as an end-of-file marker (required by 
  175. FLTIBM).
  176.  
  177. One such application for the Model 100 family is THOUGHT, the 
  178. outline processor in Super ROM.  To embed a CHR$(206) in a 
  179. THOUGHT .CT file, hit CODE-z for a Model 100 or a Tandy 200, and 
  180. CODE-v on a 102. 
  181.  
  182. Embed this at the end of the file (or at the point where you want 
  183. the output to end), print it to COM:88N1E, and FLTIBM will get 
  184. it. 
  185.  
  186. This same tactic may work with other Super ROM elements (e.g., 
  187. printing a LUCID sheet to COM:88N1E) and for printing to COM: 
  188. with other Laptop software which does not end output files with a 
  189. CHR$(26)=^Z. 
  190.  
  191.  
  192. 8. Patching FLTIBM for Fast PC's
  193.  
  194. FLTIBM has several time-out loops which are sensitive to the 
  195. speed of your computer.  The versions here are set up for a 
  196. normal IBM-PC (8080 running at 4.77 MHz).  They also work fine 
  197. with my Zenith Z-150 with an NEC V20 installed.  However, some 
  198. users of faster machines reported problems with premature time-
  199. outs when transferring Basic programs.  So the following speed 
  200. patch information is provided to permit lengthening the time-out 
  201. period.
  202.  
  203. NEVER patch your ONLY copy of FLTIBM.COM!
  204.  
  205. As uploaded these files have a count of 30000 times CNTSCL, where 
  206. CNTSCL is 02 hex (2 decimal). You can adjust the timing by 
  207. patching new values into the address 045F using DEBUG. 
  208.  
  209. For example, to patch a value of 20 hex (32 decimal) into 
  210. FLTIBM.COM, do the following: 
  211.  
  212.     A>debug fltibm.com<cr> 
  213.     -e045f<cr>             ---->leading '-' from computer 
  214.     XXXX:045F 02:20<cr>    ---->you type only the 20 and the <cr>
  215.     -w<cr> 
  216.     Writing 04A2 bytes     ---->computer does this! 
  217.     -q<cr> 
  218.  
  219. which takes you back to DOS.  Do this on a backup copy, in case 
  220. you mess up! 
  221.  
  222.  
  223. The time-out times are not linear.  Some of my timings are: 
  224.  
  225.         CNTSCL            Time-Out 
  226.         ------            -------- 
  227.         02h ( 2d)         2.9 sec 
  228.         04h ( 4d)         3.5 sec 
  229.         08h ( 8d)         4.3 sec 
  230.         20h (32d)         9.5 sec 
  231.  
  232. for a V20 running MS-DOS 2.11 at a clock speed of 4.77 MHz.  
  233. Faster processors will require larger values of CNTSCL.  Note 
  234. that the file in question (not a Basic program) took about 10 
  235. seconds to send in each of the above cases.
  236.  
  237.  
  238. pcw -- 9/25/86
  239.