home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a081 / 2.ddi / HISTORY.CTF < prev    next >
Encoding:
Text File  |  1993-05-13  |  10.5 KB  |  377 lines
  1. HISTORY.CTF -- Chronology of changes to 'CommTools For FoxPro'
  2.  
  3. Last updated: 19930131
  4.  
  5. 01-16-92 
  6. --------------
  7. CommTools has no history.
  8.  
  9.  
  10. 05-19-92 
  11. --------------
  12. a) IRQs above 7 are now supported in CommTools, for those using 16-bit
  13. serial cards;
  14.  
  15. b) IRQ lines may now be shared by more than one serial port. Usage is as
  16. follows. Assume we have the following lines from FOXCOM1:
  17.  
  18.  
  19. ret = u8250_init(0, COM1, 2400, 8, PARITY_NONE, 1)
  20. IF ret < 0
  21.     ? ret
  22.     QUIT
  23. ENDIF
  24. =install_ipr(0, RECEIVE, NULL, 2048)         && initialize receive IPR
  25. =install_isr(0, 4, NULL)                     && IRQ4,
  26.  
  27. we wish to use COM3, which we assume uses I/O address 0X3E8 and IRQ 4
  28. (sharing it with COM1). We could do this as follows for CommTools portid
  29. 1:
  30.  
  31. ret = u8250_init(1, x2d("3E8"), 2400, 8, PARITY_NONE, 1)
  32. IF ret < 0
  33.     ? ret
  34.     QUIT
  35. ENDIF
  36. =install_ipr(1, RECEIVE, NULL, 2048)         && initialize receive IPR
  37. =install_isr(1, 4, NULL)                     && IRQ4,
  38.  
  39. CommTools chains the ISRs together.
  40.  
  41.  
  42.  
  43. 05-21-92 
  44. --------------
  45. a) You may now specify the length of a screen under terminal emulation.
  46. To do so, call:
  47.  
  48.         =term_set(portid, TERM_ROWS, <rows>)
  49.  
  50. Note: a bug in FoxPro prevents scrolling of a window, other than when
  51. the cursor reaches the last line. This causes all lines written to the
  52. bottom line of <rows> (e.g. line 24 if you specify rows as 25, since
  53. rows are numbered from zero) to overwrite one another. The workaround is
  54. to specify <rows> to be equal to the interior height of the
  55. display window (the height excluding the border) plus one..
  56.  
  57. For example usage, see FOXCOM11.
  58.  
  59. Note: The VT100 defaults to a 24 line screen. If you log on to a BBS as
  60. an ANSI terminal this causes strange video displays when the BBS
  61. explicitly tries to move the cursor to line 25. The solution is to call
  62. term_set() to set the number of rows to 25;
  63.  
  64.  
  65. b) Fixed a bug in CAS routines that prevented CommTools from opening and
  66. using the CAS log.
  67.  
  68.  
  69. c) Other term_set() options:
  70. set the number of columns use by a terminal emulator:
  71.     =term_set(portid, TERM_COLS, <cols>)
  72.  
  73. Turn a key click ON or OFF under terminal emulation:
  74.     =term_set(portid, TERM_KEYCLICK, <ON|OFF>)
  75.  
  76.  
  77. 06-21-92 
  78. ---------------
  79.  
  80. a) A new file transfer status routine report has been added.
  81. "CONNECTION_LOST" is returned when carrier is lost during file transfer.
  82. See the sample transfer status routine XFER_PROGRESS in CTFUTIL.PRG.
  83.  
  84. b) The function x2d() converts a hexadecimal value expressed as a string
  85. to a decimal value. This is useful when passing parameters that are
  86. conventionally expressed in hexadecimal notation (e.g. COM1 is expressed
  87. as 3F8h, rather than 1016 decimal).
  88. Prototype:
  89.                       expN x2d(expC <parm>)
  90. Usage example:
  91.     Type the following in the FoxPro command window:
  92.  
  93.                         SET LIBRARY TO ctf
  94.                         ? x2d("3f8")
  95.  
  96. The number "1016" should appear in the active window.
  97.  
  98. Note: their must not be any characters that are not part of the hex.
  99. character set in <parm>.
  100.  
  101. c) Fax Developers: A new function cas_close() closes files opened with
  102. cas_open(). Prototype:
  103.     expN cas_close(expN file_handle)
  104.  
  105. Returns 0 on success, negative value on error;
  106.  
  107. d) New function: Make terminal revert to TTY and free memory allocated
  108. for an emulated terminal.
  109. Prototype:
  110.     term_deinit(expn <portnum>)
  111. Returns:
  112.     0   on success;
  113.     EOF if no special terminal allocated to this port;
  114.  
  115. Usage Notes: This function is called automatically when you unload the
  116. CommTools library. Optionally, call it earlier if you have used a
  117. terminal emulation, revert to TTY, and want to conserve memory usage.
  118.  
  119. e) New manifest constants:
  120.     DigiBoard COM/Xi functions:
  121.     The return code from comxi_init() is:
  122.     0               -- success;
  123.     -2              -- invalid board number or timeout error during
  124.                        initialization;
  125.     NO_RAM          -- insufficient memory for data structures;
  126.                        or FEP busy (0h not written to "mailbox");
  127.     -4              -- Module not loaded;
  128.     -8              -- Bad ROM version
  129.     PARMERROR       -- Incorrect number or type of parameters;
  130.  
  131.     The return code from comxi_i_channel() is:
  132.     0               -- success;
  133.     NO_RAM          -- unable to allocate memory for COMM_PORT;
  134.     -2              -- COM/Xi card not initialized;
  135.     -3              -- invalid COM/Xi board number;
  136.     NO_PORT         -- invalid COM/Xi channel number;
  137.     PARMERROR       -- Incorrect number or type of parameters;
  138.  
  139.     The return code from comxi_deinit() is:
  140.      0      -- success;
  141.      EOF    -- Port already deinitialized;
  142.      -2     -- invalid board number;
  143.  
  144. f) MODEM_ICMD() is renamed MODEM_CMD();
  145.  
  146.  
  147. 07-30-92 
  148. ---------------
  149.  
  150. a) Fixed bugs in Kermit and ZMODEM;
  151.  
  152. b) cas_get_hardware() was returning -2. Fixed. It now returns 0 on
  153. success. In addition, a new error return code is added.
  154.  
  155.     NO_RAM => inadequate memory to allocate buffer to return information
  156. from CAS device;
  157.  
  158. c) All fax functions are now in a separate library: FTF.PLB ("FaxTools
  159. for FoxPro"). This allows you to load only the serial or fax functions,
  160. as you wish, reducing memory requirements in most environments.
  161.  
  162. To load both libraries, use:
  163.  
  164.     SET LIBRARY TO <libname> ADDITIVE
  165.  
  166.  
  167. 08-06-92 
  168. ---------------
  169.  
  170. a) isacas() is renamed cas_exist() (the old name still works);
  171.  
  172. b) True colors are now available under terminal emulation. ANSI.SYS is
  173. especially noteworthy. See FOXCOM11 for a demonstration.
  174.  
  175.  
  176. 09-07-92 
  177. ---------------
  178.  
  179. a) Fixed bug in CAS_SET_DATE_EVENT(). It was not setting the date;
  180.  
  181. b) Fixed bugs in file transfer protocols that caused a hang at the end;
  182.  
  183. c) The Star Gate ACL 16 and ACL 16+ intelligent multiport boards are now
  184. supported;
  185.  
  186.  
  187. 09-13-92 
  188. ---------------
  189.  
  190. a) Fixed bug in fqueue() that had crept in from a previous fix and
  191. prevented files being sent;
  192.  
  193. b) Fixed bug in CAS fax routines that caused "Use of Transgressed
  194. Handles";
  195.  
  196.  
  197. 09-20-92 
  198. ---------------
  199.  
  200. a) K_SET() can now set parameters individually for each port. This
  201. requires a change in its parameters.
  202. Viz:
  203.  
  204.     expN K_SET(expN portid, expN parm, expN value)
  205.  
  206. where
  207.     expN portid is the port number to which the Kermit parameters apply;
  208.     expN parm   is the parameter to set;
  209.     expN value  is the value to use for 'parm';
  210.  
  211. Likewise, K_GET() takes a portid:
  212.  
  213.     expN K_GET(expN portid, expN parm)
  214.  
  215. where
  216.     expN portid is the port number to which the Kermit parameters apply;
  217.     expN parm   is the parameter to set;
  218.  
  219. b) K_INIT() is no longer needed. Its functions are performed by K_SET();
  220.  
  221. c) Fixed bug in Kermit file send that caused a hang at the end or if the
  222. abort key was pressed;
  223.  
  224.  
  225. 09-30-92 
  226. ---------------
  227.  
  228. a) Fixed some bugs in X/Ymodem transfers that resulted in incorrect
  229. return codes being returned;
  230.  
  231.  
  232. 10-03-92 
  233. ---------------
  234.  
  235. a) Fixed some bugs in Kermit transfers that resulted in incorrect
  236. return codes being returned;
  237.  
  238.  
  239. 10-04-92 
  240. ---------------
  241.  
  242. a) New function added:
  243.     CT_GET_VERSION()
  244.  
  245. Returns CommTools version number.
  246.  
  247. Usage:
  248.  
  249. ? ct_get_ver()
  250.  
  251. "CommTools/Fox 10-04-92"
  252.  
  253.  
  254. 10-08-92 
  255. ---------------
  256.  
  257. a) Corrected unitialized variable problem in MODEM_...() functions;
  258.  
  259. b) Corrected problem of CAS_CREATE_TASK() assuming that date format was
  260. 'AMERICAN';
  261.  
  262. c) See $README.CTF for new usage notes on DOSD2XD();
  263.  
  264.  
  265. 11-28-92 
  266. ---------------
  267.  
  268. a) Corrected various problems with file tranfer, mainly involving return
  269. codes;
  270.  
  271.  
  272. 12-06-92 
  273. ---------------
  274.  
  275. a) Corrected various problems with file tranfer, mainly involving return
  276. codes;
  277.  
  278. b) Added new file transfer status reporting to CTFUTIL.PRG
  279.  
  280.  
  281. 12-22-92 
  282. ---------------
  283.  
  284. a) Corrected a bug in CAS routines that prevented the reading of the CAS
  285. log;
  286.  
  287.  
  288. 12-27-92 
  289. ---------------
  290.  
  291. a) The unimplemented 'echos' discussed in earlier copies of the
  292. $README.CTF file are now implemented.  There is some commented out code
  293. in FOXCOM11.PRG that shows how to use them.  A new constant FILE_ECHO
  294. has been created to replace CAPTURE_BUFFER_ECHO.  The constant
  295. CAPTURE_BUFFER_ECHO is retained for backward compatibility.  We
  296. RECOMMEND that you use FILE_ECHO for future compatibility, The supported
  297. echoes are:
  298.  
  299.     SET_RX_XLAT(<portid>, CAPTURE_BUFFER_ECHO, <fn>)
  300.     SET_RX_XLAT(<portid>, FILE_ECHO, <fn>)
  301.     SET_RX_XLAT(<portid>, PRINTER_ECHO, <fn>)
  302.  
  303.     SET_TX_XLAT(<portid>, CAPTURE_BUFFER_ECHO, <fn>)
  304.     SET_TX_XLAT(<portid>, FILE_ECHO, <fn>)
  305.     SET_TX_XLAT(<portid>, PRINTER_ECHO, <fn>)
  306.  
  307.  
  308. 12-29-92 
  309. ---------------
  310.  
  311. a) ZMODEM: A file 'send' terminated immediately at >= 38,400bps. Fixed;
  312.  
  313. b) IRQ Sharing: Most PC hardware cannot share an IRQ line between two
  314. ACTIVE devices (this does not apply to the Microchannel and EISA
  315. busses).  CommTools now tests the hardware to see if it supports
  316. interrupt sharing if you try an install two (or more) devices on the
  317. same IRQ line. If the hardware does not support interrupt sharing, a
  318. warning message pops up. To see this, run CT2ISR.PRG;
  319.  
  320. c) Fax: Cover page messages were limited to 128 bytes due to the design
  321. of the CommTools API. This restriction is now REMOVED. Cover page
  322. messages may now be any length (however, the CAS spec. recommends a
  323. maximum of 36 lines);
  324.  
  325.  
  326. 01-09-93 
  327. ---------------
  328.  
  329. a) Fixed bug in file transfers under terminal emulation;
  330.  
  331.  
  332. 01-16-93 
  333. ---------------
  334.  
  335. a) DigiBoard DigiCHANNEL COM/Xi: Fixed bug that prevented the use of
  336. even parity;
  337.  
  338. b) DigiBoard DigiCHANNEL Boards: CommTools now supports the following
  339. DigiBoard intelligent boards:
  340.     DigiBoard DigiCHANNEL COM/Xi
  341.     DigiBoard DigiCHANNEL MC/Xi
  342.     DigiBoard DigiCHANNEL PC/Xe
  343.     DigiBoard DigiCHANNEL PC/Xi
  344.  
  345. Previously, the only intelligent DigiBoard supported was the DigiBoard
  346. DigiCHANNEL COM/Xi.
  347.  
  348. The new support is via the DigiBoard "Universal DOS Driver" supplied
  349. with the board. See CTFX00.PRG for an example and usage instructions.
  350.  
  351. The original method of addressing the COM/Xi (direct board access) is
  352. still available and has certain advantages (e.g. higher speeds on each
  353. port).
  354.  
  355. 01-31-93 
  356. ---------------
  357.  
  358. a) Support added for Foxpro for DOS v2.5
  359.  
  360. 02-11-93 
  361. ---------------
  362.  
  363. a) Support added for FoxPro for DOS v2.5.
  364.     CTF.PLB is now:
  365.     CTF20.PLB for FoxPro v2.0
  366.     CTF25.PLB for FoxPro for DOS v2.5
  367.  
  368. b) Some internal changes to improve the error handling of streaming
  369. protocols when transmit interrupts are in use;
  370.  
  371. 05-06-93
  372. ---------------
  373.  
  374. a) Fixed some file transfer problems under FoxPro 2.5
  375.  
  376.  
  377.