home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / buadb14.lha / BaudBandit.Doc < prev    next >
Text File  |  1992-08-26  |  12KB  |  256 lines
  1. ---------------------------------------------------------------------------
  2.                                                _________ __          
  3.                                               /___  ___// /           
  4.            CHRISTIAN BUCHNER                     / /   / /            
  5.                                                 / /   / /__   _______
  6.                 PROUDLY PRESENTS               / /   / ___ \ / /__/_/
  7.                                               / /   / /  / // /      
  8.                                              /_/   /_/  /_//_/____   
  9.        ____                      __    ____                       __     __
  10.       / __ \                    / /   / __ \                     / /__  / /
  11.      / /_/ /                   / /   / /_/ /                    / //_/_/ /_
  12.     / _  _/ ____/\ __  __ __  / /   / _  _/ ____/\ /\___   __  / /__ /  __/
  13.    / / \ \ / __/ // / / // _\/ /   / / \ \ / __/ // ___ \ / _\/ // / / /   
  14.   / /__/ // /_/ // /_/ // /_/ /   / /__/ // /_/ // /  / // /_/ // / / /    
  15.  /______//_____//_____//_____/   /______//_____//_/  /_//_____//_/ /_/     
  16.  
  17.  
  18.           THE CHEAPEST WAY TO USE YOUR SERIAL PORT AT LIGHT SPEED
  19.  
  20. ---------------------------------------------------------------------------
  21.      BaudBandit Documentation, Version 1.4, 26th of August 1992, 23:00
  22. ---------------------------------------------------------------------------
  23.  
  24.  
  25.                          WHAT'S HOT, WHAT'S NEW?
  26.  
  27. Version  1.4  should fix most problems that occured with previous versions.
  28. The  nasty  transmission  errors  have been fixed, as well as various other
  29. bugs.  Refer to "Version.Doc" for more accurate information.
  30.  
  31. Ah,  I  nearly  forgot  to  mention that you will automagically "receive" a
  32. lovely  text every time BaudBandit is opened.  It will be displayed on your
  33. terminal  screen, but it does not affect BaudBandit's function.  Instead it
  34. will affect the number of registrations, I hope. ;-)
  35.  
  36. The  documentation  has  been  reworked  to clarify some misunderstandings.
  37. Read it again, perhaps you will discover some important details.
  38.  
  39. I have got an EMAIL address now (see below).
  40.  
  41. I also have got a lot of new ideas concerning serial communication (see the
  42. section about future plans).
  43.  
  44.  
  45.                          WHAT IS THE BAUD BANDIT?
  46.  
  47. The BaudBandit is a replacement for the original serial.device allowing you
  48. to  drive  your serial port at baud rates up to 115200 Baud with a standard
  49. 68000 Processor in full multitasking.  Without any doubt the BaudBandit can
  50. be  called  "a little revolution" within the telecommunication scene on the
  51. Commodore Amiga.
  52.  
  53. When  Commodore  developed  the  serial.device some years ago, they were of
  54. course  not able to foresee the development of very cheap modems using data
  55. compression  at incredibly high baud rates like the US Robotics HST and the
  56. new  v32bis  modems.   So  the  serial.device  soon became too slow for the
  57. requirements of modern telecommunication standards.
  58.  
  59. The BaudBandit is especially designed for use with high speed modems and it
  60. supports  full bidirectional RTS/CTS handshake and receive buffering.  This
  61. device will no longer bring your computer to a standstill when transferring
  62. a  file at 14400 baud or more.  Compared to the serial.device, this program
  63. provides a speed increase of about 500% percent.
  64.  
  65.  
  66.                            HOW TO USE THE DEVICE
  67.  
  68. Simply  copy  the BaudBandit.device to your DEVS:  directory.  Now you have
  69. to  configure  your  software  to  the  new device.  Most telecommunication
  70. programs offer a configurable device name and unit.  Here you have to enter
  71. "BaudBandit.device".  The device name is case sensitive, so be sure to type
  72. it right as shown above!
  73.  
  74. The  easiest  way  to install the BaudBandit is to run the program QuickFix
  75. early in your startup sequence.  Then you do not have to change any of your
  76. configurations.   QuickFix  will patch the OpenDevice() vectors so that any
  77. attempt  to open the serial device will open the BaudBandit device instead.
  78. The  patch  may  be  removed at any time with a CTRL-C or the break command
  79. from an AmigaShell.
  80.  
  81. If  you use an A2232 multiserial card, you may install the program A2232Fix
  82. in  your  startup  sequence.  Do NOT run QuickFix in this case.  When using
  83. A2232Fix,  you do not need to change any of your configurations.  The patch
  84. will  replace  oldser.device  with the faster BaudBandit.device by patching
  85. the  OpenDevice()  vectors.   This allows you to access the internal serial
  86. port  via  A2232's serial.device, but this time using my faster BaudBandit.
  87. Please note that the BaudBandit will NOT speed up the A2232 ports.
  88.  
  89.  
  90.                        WHAT ABOUT THE COMPATIBILITY?
  91.  
  92. The  code  is designed to work under OS1.2/1.3 as well as OS2.0.  It should
  93. run on all processors from 68000 to 68040.
  94.  
  95. In  order  to  get  the  best speed results, I dropped some features of the
  96. original serial.device which are usually not needed in telecommunication.
  97.  
  98. I  completely  dropped  the  xOn/xOff protocoll, as well as the termination
  99. array  and  parity  checks.   Breaks are currently not supported but may be
  100. included in later versions.  Characters must consist of 8 bits.  The device
  101. only supports plain 8N1 RTS/CTS transfer.  But this is all you need!
  102.  
  103. The  BaudBandit.device  should be able to replace the serial.device in most
  104. situations.   It  has  been  tested  with  Fido  mailers  like TrapDoor and
  105. terminal  programs like Term, NComm and Magicall.  Up- and downloads are no
  106. problem  and especially at high speed transfers you should notice that your
  107. computer  will NOT stand still anymore.  FAXing is possible, too.  This has
  108. been tested with GPFax and other software.
  109.  
  110.  
  111.                            HARDWARE REQUIREMENTS
  112.  
  113. The  device  supports  a very common handshake method for high speed modems
  114. using  the  RTS/CTS  wires.  The RTS/CTS wires prevent a buffer overflow on
  115. the  computer  and  on  the  modem  side.   This  handshake method is often
  116. referred to as "flow control".
  117.  
  118. THIS  IS  IMPORTANT:  In order for the device to work properly, you have to
  119. connect  these  wires to your computer, even if your modem does not support
  120. this  handshake method.  Without the RTS/CTS wires connected to your serial
  121. port, the device will not be able to send anything!
  122.  
  123.  
  124.                      WHAT IS INCLUDED IN THIS PACKAGE?
  125.  
  126. This  archive  contains  an  fully  functional  version of the device and a
  127. complete  documentation.  The device displays a little text on the terminal
  128. screen  reminding you that it is shareware.  If you want to use the program
  129. regularly,  you  have  to  register. 
  130.  
  131. Please  note  that  the  contents  of  the  distribution archive may not be
  132. altered in any way.  Any modification of the program is prohibitted.
  133.  
  134.  
  135.                            WHY IS IT SHAREWARE?
  136.  
  137. The  development  of  this  programm  has taken many weeks of hard work and
  138. frustration.   Previous  versions  of  BaudBandit were not as reliable as I
  139. wanted  them  to  be,  but  now  I  hope  to  present  a reliable and fully
  140. functional program which will be of great use for many people.
  141.  
  142. Please understand that I do not want to give this program away for free.  I
  143. ask  you  to pay a small shareware donation.  The more people register, the
  144. more  support  this  product  will  get.  The shareware fee will help me to
  145. support my customers and to continue my work on this project.
  146.  
  147.  
  148.                               HOW TO REGISTER
  149.  
  150. Before  you decide to register, please check whether this program satisfies
  151. all your requirements or not.  You are allowed to evaluate this program for
  152. two weeks.  If you continue using it, you have to register.
  153.  
  154. Fill  in the registration form and send it to me.  I think, it is justified
  155. to ask for a shareware donation of DM 20.  This is very cheap for a project
  156. like  BaudBandit  and  it is not even half the price the authors demand for
  157. programs like TrapDoor or Foozle.  There are many ways of sending the money
  158. to me, so don't tell me that you did not know how to do it.
  159.  
  160. a) Enclose it cash.
  161. b) Send me a cheque over DM 20.
  162. c) Let your bank transfer it to me
  163. d) Transfer it with a postal money order.
  164.  
  165. Please do not transfer any money before having sent the registration form!
  166.  
  167. The registration form must be mailed to the following address:
  168.  
  169.                          Christian Buchner
  170.                          Ganghoferstraße 2
  171.                          8034 Germering
  172.                          Deutschland
  173.  
  174. You may transfer the money to the following account:
  175.  
  176.                          Raiffeisenbank Germering-Olching
  177.                          Bankleitzahl 701 693 80
  178.                          Kontonummer  49573
  179.  
  180. After  registering,  you  will  receive  a  BaudBandit version that does no
  181. longer  display  the reminder text.  Important updates and bugfixes will be
  182. sent  to you as long as the mailing costs do not exceed a reasonable level.
  183. I  prefer  sending  the device UUEncoded via Netmail.  The device itself is
  184. about  4KB  in length, so this should be no problem.  If it is not possible
  185. to  reach  you  on the digital way, I'll use the analog method and send you
  186. the device on a disk.
  187.  
  188.  
  189.                                FUTURE PLANS
  190.  
  191. Depending  on  your  needs  and  wishes, I will eventually add XOn/XOff and
  192. Break  support to the BaudBandit device.  Write to me if you need these new
  193. features.
  194.  
  195. Please  do  not  "forget" to register to BaudBandit.  Since there is such a
  196. sad  discrepancy  between  the  number  of REGISTERED USERS compared to the
  197. number  of  ILLEGAL  USERS,  I  am  honestly  thinking  of programming some
  198. shareware requesters and a rigorous time limit for the next updates as well
  199. as  for  any  future projects.  This method worked with MFR and I'm sure it
  200. works for BaudBandit as well.  It's up to you.
  201.  
  202. I  am  planning to create a program, that will patch itself in front of any
  203. serial device to provide data compression and error correction.  It will be
  204. implemented  as  an  OS2.0  style  commodity and it will use the XPK packer
  205. standard  allowing  you  to select any compression and/or encryption method
  206. that  is  currently  available  as  XPK  external  library.   This might be
  207. especially  useful  for  all those people who have not yet deciced to buy a
  208. faster modem.  A very complex project, but I love the idea.
  209.  
  210. Another  nice  idea  is  to create a xpr library that allows realtime voice
  211. chats  via  high speed modem using your sound sampler in the parallel port.
  212. The  implementation  as an xpr external library allows usage in ANY mailbox
  213. and  terminal  program!   The  sound  data  will  be  reduced to 4 bit thus
  214. doubling  the  sampling  rate.   This would be just a toy, but a very funny
  215. one.   Eventually,  it  will be possible to arrange digital conferences, if
  216. the host system has enough CPU power. ;-)
  217.  
  218. How  about  a  pipe-style  serial  device  that allows you to test your bbs
  219. system  locally?   All  data  sent  to unit 0 comes out at unit 1, and vice
  220. versa.  What do you think of it?
  221.  
  222.  
  223.                              IF YOU FIND A BUG
  224.  
  225. If  you  discover  a  bug  or  a  problem,  please  inform me as quickly as
  226. possible.  It is important for me to get very accurate information.  Please
  227. tell  me  excactly  in what situation, with what software and configuration
  228. the  problem  aroused.   Bugs are easier to spot if they are reproduceable.
  229.  
  230.  
  231.                              HOW TO CONTACT ME
  232.  
  233. If  you have any questions concerning this device or anything else, you can
  234. reach  me  via Fidonet and via InterNet.  Just write a netmail to Christian
  235. Buchner  at node 2:246/65 or send your mail to cbuchner@heavenly.lm.sub.org
  236. Please be careful.  Your mails might get lost on their way.
  237.  
  238. Send love letters and registrations to the following address:
  239.  
  240.                              Christian Buchner
  241.                              Ganghoferstraße 2
  242.                               8034 Germering
  243.                                 Deutschland
  244.  
  245.  
  246.  
  247.            ----------------------------------------------------
  248.            And always remember: USING it means PAYING it, okay?
  249.            ----------------------------------------------------
  250.  
  251.                 I can not FORCE you, but I may PLEASE you.
  252.  
  253.  
  254.  
  255.                                (End of File)
  256.