home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / ansi / avatar1.arj / READ.ME < prev   
Encoding:
Text File  |  1991-02-14  |  6.3 KB  |  145 lines
  1. Avatar, level 1, Console.
  2. Copyright (C) 1991, G. Adam Stanislav.
  3. All Rights Reserved.                    January 20, 1991
  4.  
  5. AVATAR and Avatar Console are trademarks of G. Adam Stanislav and
  6. Stanislav Publishing.
  7.  
  8. AVT1CON.ZIP should contain the following files:
  9.  
  10.     AVATAR.DOC
  11.     AVATAR.SYS
  12.     DISPATCH.DOC
  13.     AVATERM.ASM
  14.     AVATERM.EXE
  15.     READ.ME
  16.  
  17. AVATAR.DOC contains the specs for Avatar, level 1, console commads. It
  18. assumes familiarity with AVT/0 and AVT/0+ specs.
  19.  
  20. AVATAR.SYS is a console device driver. It should be installed in config.sys
  21. as follows:
  22.  
  23.     device = avatar.sys [switches]
  24.  
  25. Switches are optional and are described in the commercial documentation
  26. for AVATAR.SYS. I will probably have a document describing them out soon,
  27. for now I am writing this quickly, right after finishing the program.
  28.  
  29. DISPATCH.DOC describes my proposal how to handle the problem of several
  30. programs sharing the same IRQ at the same time in multitasking environment.
  31. AVATAR.SYS contains Avatar Serial Dispatcher which, if used, makes such
  32. sharing a breeze.
  33.  
  34. AVATERM.ASM illustrates how to check for the presence of AVT/1 console,
  35. and how to use it to emulate AVT/0.
  36.  
  37. AVATERM.EXE is the assembled version of above file. Its purpose is to
  38. show how to write programs that take advantage of AVATAR.SYS. It is not
  39. meant as a full serial program. It only works with COM1 and does not even
  40. set the baud rate, etc. However, I have called Opus 1.10+ systems with it.
  41. I got a fast throughput and was able to use function keys in OpEd. If you
  42. try it, remember that Shift-F1 is the key reserved in previous AVT docs for
  43. local toggle. AVATERM uses it to hang up and to quit the program. All other
  44. function keys are transfered over the phone.
  45.  
  46. READ.ME is this document.
  47.  
  48. Please distribute these file always together. Make them as widely available
  49. as possible.
  50.  
  51. Please note that AVATAR.SYS is a commercial product. I have enclosed version
  52. 0.10 which does not have all the capabilities of the commercial version,
  53. but does contain a full Avatar Console driver. The reason I enclosed it is
  54. to make it simple to understand the operation of the console. Whenever
  55. AVATAR.DOC may not be clear, simply type the commands and see for yourself
  56. what they do.
  57.  
  58. I am releasing this earlier than I wanted. So many people keep asking me
  59. for the spec that I am releasing it now. Because of that, not all
  60. capabilities of AVATAR.SYS are described here.
  61.  
  62. If you would like to use the commercial version of AVATAR.SYS, send $45,
  63. plus $5.00 shipping and handling to:
  64.  
  65.     Stanislav Publishing
  66.     322 Mall Blvd., Suite 174
  67.     Monroeville, PA 15416
  68.  
  69. Please make your checks payable to Adam Stanislav. This offer is good only
  70. in United States of America. I was told there are some restrictions on
  71. exporting software. I'll have to find out what they are before going any
  72. further.
  73.  
  74. The above price is guaranteed till the end of March 1991 and will be
  75. reconsidered after. Anyone who has licensed the use of ControlD software
  76. can receive AVATAR.SYS for $25, plus $5.00 s&h. In any case, Pennsylvanians
  77. should include state tax.
  78.  
  79. If you never heard of ControlD: It offers command line interface to DESQview.
  80. Thus, instead of using DESQview menus, you can enter commands at the command
  81. line or from batc files. You can also disable and re-enable any menu item,
  82. as well as password protect any window.
  83.  
  84. ControlD is available at the same address for $65.00, plus $5.00 s&h. Again,
  85. please make checks payable to Adam Stanislav.
  86.  
  87. Or get both, ControlD and AVATAR.SYS at the same time for $90.00 plus $5.00
  88. s&h.
  89.  
  90. Because AVATAR.SYS is a DOS console driver, it suffers from the same problem
  91. as DOS: non-reentrancy. Thus, to run it under DESQview you need DVAVATAR.COM.
  92. I worked on it at the same time as AVATAR.SYS, but then set it aside to give
  93. more energy to AVATAR.SYS. Anyone who licensed or licenses ControlD will
  94. receive DVAVATAR.SYS for FREE as soon as it is available.
  95.  
  96. Please note that DVAVATAR will only work under DESQview and it will not
  97. have Avatar Serial Dispatcher in it (having it there would actually defeat
  98. its purpose). It is still recommended that you license AVATAR.SYS even if
  99. you expect to use DVAVATAR.COM.
  100.  
  101. The commercial version of AVATAR comes in two varieties (both included at no
  102. extra cost): AVATAR.SYS which runs on all PC compatibles, and AVT386.SYS
  103. which requires and is optimized for '386 machines and better.
  104.  
  105. Any questions should be sent to the above address. Or you can reach me at
  106. Fidonet node 1:129/39.0.
  107.  
  108.                             February 5, 1991
  109.  
  110. Version 0.10a corrects a bug in Avatar Serial Dispatcher which caused it
  111. not to work under certain circumstances.
  112.  
  113. Also, Ralf Brown noticed that the sound was being too short: Instead of using
  114. two timer ticks per 1/10th of a second, only one was being used. Thanks to
  115. Ralf for notifying me this fast. It is fixed in this version.
  116.  
  117. I have asked about export restrictions and the only ones I could find had
  118. to do with data encryption. Since AVATAR.SYS does not encrypt any
  119. data, it is now available anywhere in the world. Please make your checks
  120. payable in U.S. funds. Please add enough to cover the postage.
  121.  
  122. To allow people outside the U.S. the same low introductory price, the $45
  123. price tag has been extended till the end of April 1991.
  124.  
  125.                                                         February 13, 1991
  126.  
  127. Version 0.11 adds an int 2Fh call to find AVATAR.SYS data segment. This will
  128. be used in version 1.00 and up to allow the use of AVT/1 console in
  129. multitasking systems.
  130.  
  131. The int 2Fh calls of AVATAR.SYS are still largely undocumented, simply due
  132. to the lack of time. I will get to that....
  133.  
  134. As for the call added in this version: If AH = 1Ah, AL = 'D', and BX = 'AV',
  135. int 2Fh returns its data segment in DS, the size of its data segment in CX,
  136. AX = 0, other registers are unchanged. Starting with version 1.00, this will
  137. allow programmers to give AVT/1 console a data segment that be unique to
  138. their own programs. Thus a program that calls another program can save the
  139. current state of Avatar console by simply grabbing int 2Fh, giving AVT/1
  140. console a new data segment, resetting the driver, loading another program,
  141. then restoring the original int 2Fh. This will have no effect in current
  142. version, but starting with version 1.00, AVATAR.SYS always calls int 2Fh
  143. to set its data segment.
  144.  
  145.