home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / networking / misc / serialrouter.lha / SerialRouter.doc < prev    next >
Encoding:
Text File  |  1994-06-19  |  2.9 KB  |  84 lines
  1.               SerialRouter v1.0 Copyright 1994 Barry McConnell
  2.  
  3.  
  4. Purpose:
  5. --------
  6.  
  7. To copy data between two serial ports.
  8.  
  9.  
  10. Usage:
  11. ------
  12.  
  13. SerialRouter <device1> <unit1> <device2> <unit2>
  14.  
  15. Must take exactly four parameters -- there are no defaults.  It won't run
  16. from Workbench, sorry.
  17.  
  18. Example: SerialRouter serial.device 0 a2232.device 4
  19.  
  20.  
  21. Description:
  22. ------------
  23.  
  24. This small utility opens two serial devices.  It sets up CMD_READ requests on
  25. each, then waits for something to arrive at either of them.  Once something
  26. does, it is sent to the other using a CMD_WRITE request.  It will loop
  27. continuously like this until you send it a Ctrl-C signal.
  28.  
  29. You might want to do this if you have a multi-port serial card with modems
  30. and terminals connected.  If you route a port which has a terminal to a port
  31. which has a modem, you will be able to control the modem remotely!
  32.  
  33. If either of the devices are already open, this utility will fail.  For
  34. speed, the SERF_RAD_BOOGIE bit is set, bypassing the normal parity checks,
  35. XON/XOFF handling, and break signal testing.  If you don't like this, change
  36. the source code yourself. :-)  Ditto for the SERF_SHARED bit (useful if you
  37. are running a BBS).
  38.  
  39. It is possible to tell it to open devices other than the serial ports,
  40. however I do not recommend this, and nor have I tried it (so its effect can
  41. be considered undefined for the moment).  Routing the gameport.device to the
  42. scsi.device is something you can attempt at your own risk! ;-)
  43.  
  44. The one thing which might be useful (and which I used for debugging) is
  45. routing the serial.device to the console.device.  If you want to do this,
  46. make sure you have the console.device as the *second* device specified on the
  47. command-line.  SerialRouter will then open a window for your keyboard input
  48. (and close it when it exits).  The default window attributes are hard-coded,
  49. but you can drag and resize it as normal.  I find that it won't keep up with
  50. a high-speed connection on my A3000 (although direct serial -> serial works
  51. at any speed).
  52.  
  53.  
  54. Distribution:
  55. -------------
  56.  
  57. FreeWare.  Do what you like with it, play around with the source code, but
  58. please credit me if you re-use it in your own programs.  (Sending me a copy
  59. of that program would be nice, especially if it's commercial!)
  60.  
  61.  
  62. Disclaimer:
  63. -----------
  64.  
  65. This is a very "bare-bones" utility which I am only releasing to the world at
  66. large in case it someone find it (or the source code) useful.  It is not
  67. intended to be robust, so you use it entirely at your own risk.  In actual
  68. fact, I have not been able to test it myself on more than one serial port: a
  69. friend of mine (Andrew Mowatt -- quick plug, Nemesis' Dungeon BBS on +353 1
  70. 832 4755 / 832 6900) asked me to write it, and he says it works fine.
  71.  
  72.  
  73. Contacting me:
  74. --------------
  75.  
  76. Snail mail: Barry McConnell,
  77.             "Piper's Hollow",
  78.             Hillcrest Road,
  79.             Dublin 18,
  80.             Ireland.
  81.  
  82. Internet:   bmccnnll@unix1.tcd.ie
  83. FidoNet:    2:263/150.2
  84.