home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / network / conferences / radio.1p3.README < prev    next >
Encoding:
Text File  |  1991-12-07  |  7.3 KB  |  202 lines
  1. Welcome to the wonderful world of Local Area Network radio!
  2. ===========================================================
  3.  
  4. This is Radio version 1, patchlevel 3.
  5.  
  6. If you have a local area network full of workstations with audio
  7. capabilities and at least one FM/AM radio or other audio source, you
  8. can broadcast the audio over the network, and let other users listen
  9. to it.
  10.  
  11. This software works for Sun Sparcs running SunOS 4.0 or 4.1, for SGI
  12. Indigo or 4D/35 workstations running SGI IRIX 4.0 or 3.3.2, and for
  13. NeXT workstations (running version 2.1).  At CWI, it has been in use
  14. continuously on a mix of Sun and SGI system types for the past few
  15. months; it was quickly tested on a NeXT.
  16.  
  17. Man pages for "radio" and "broadcast" are provided.
  18.  
  19. The implementation continuously transmits UDP broadcast packets of
  20. 1400 bytes each (less than six per second), which contain the data in
  21. U-LAW format (8000 samples/second, 1 byte/sample, logarithmically
  22. encoded).  On a typical ethernet, this uses about 1 percent of the net
  23. available bandwith.  Some loss of UDP packets is tolerated by the
  24. receiving program (this is heard as short interruptions of the sound).
  25.  
  26. It is possible to use multiple transmission stations (each identified
  27. by a different UDP port), and to transmit to multiple connected
  28. subnets simultaneously (as long as the gateways let UDP broadcast
  29. packets through).
  30.  
  31. This software is copyrighted.  See the notice at the end of this file.
  32.  
  33.  
  34. Building and installing
  35. -----------------------
  36.  
  37. For SunOS, type "make sun"; for SGI IRIX, type "make sgi".  For the
  38. NeXT, type "make next".  This should produce two binaries, "radio" and
  39. "broadcast", and for the NeXT, a third, "sndulaw".  Read the Makefile
  40. for details -- it's pretty trivial.
  41.  
  42. For SunOS 4.1, you may try "make sun4.1" instead, assuming your audio
  43. library is in /usr/demo/SOUND.  Edit the Makefile if necessary to
  44. accomodate other locations.
  45.  
  46. For SGI IRIX, you also need to build the "recordulaw" program in
  47. the subdirectory "ulawtools".  This uses the IRIX audio library to
  48. sample the audio input and convert it to U-LAW format.  The audio
  49. library is available on IRIS 4.0 and on IRIS 3.3.2 or higher.
  50.  
  51. Install the "radio" program on a convenient public place (where
  52. potential listeners can find it, e.g., /usr/local); install
  53. "broadcast" on a convenient place for yourself (assuming you're the
  54. one doing transmissions).  The "recordulaw" or "sndulaw" programs, if
  55. needed, should be installed together with "broadcast".
  56.  
  57.  
  58. Usage -- transmissions
  59. ----------------------
  60.  
  61. To start transmissions on Sun Sparcs, run this command (probably in
  62. the background, once you've debugged your audio setup):
  63.  
  64.     broadcast -p port </dev/audio
  65.  
  66. You must connect a mono audio source to the machine using a standard
  67. cable provided by Sun.  Control the input gain with [x_]gaintool
  68. (e.g., /usr/demo/SOUND/x_gaintool).
  69.  
  70.  
  71. This command start transmissions on SGI IRIX:
  72.  
  73.     recordulaw | broadcast -p port
  74.  
  75. Connect a stereo audio source to the machine using a standard walkman
  76. jack.  If you're using an early 4D/35, check that you have audio
  77. hardware and software installed -- the output from hinv will tell you
  78. this.
  79.  
  80.  
  81. On the NeXT you start transmissions as follows:
  82.  
  83.     sndulaw | broadcast -p port
  84.  
  85. This takes input from the microphone; you may also connect an audio
  86. source to the microphone input (probably needs some attenuation to get
  87. the impedance right).
  88.  
  89.  
  90. By default this broadcasts on the local ethernet.  You can specify one
  91. or more -b options to broadcast, passing it explicit IP broadcast
  92. addresses (last byte 0 or 255, depending on local convention).  You can
  93. specify your local IP net or another net; the latter only works if
  94. your gateways pass UDP broadcasts through (at CWI it works).
  95.  
  96. Note: each transmitter must choose a unique port number.  The default
  97. is 54321; other suitable ports are 54322, 54323, and so on.
  98.  
  99.  
  100. Usage -- reception
  101. ------------------
  102.  
  103. To listen to transmissions on either system:
  104.  
  105.     radio -p port
  106.  
  107. This sends the data directly to the audio output device (speaker or
  108. headphones).  It is also possible to get the ULAW audio data on
  109. standard output with the -f option ("filter").
  110.  
  111. The -v option sets the output volume (on a scale from 0 to 100).  To
  112. change the volume later on a Sun Sparc, use [x_]gaintool (at CWI:
  113. /usr/demo/SOUND/x_gaintool).  On an SGI, use "apanel".
  114.  
  115.  
  116. Bells 'n whistles
  117. -----------------
  118.  
  119. Jack Jansen <jack@cwi.nl> maintains several versions of a "tuner"
  120. program that can be used to control the port that "radio" listens to,
  121. default 54320 (changeable with the -c option).  Note that this allows
  122. anybody on the world to control your radio, in principle.  If you
  123. don't want this, you can pass the -s flag (secure), which turns off
  124. the control port altogether.  By convention, the tuner program assumes
  125. that every user who performs transmissions has two files "CD" and
  126. "CDlog" in their home directory giving program information (this is
  127. actually a bad idea, since it requires that the listener and the
  128. broadcaster share the same file name space for user's home
  129. directories, but it saves a lot of complication in the broadcast
  130. program).
  131.  
  132. The tuner programs aren't distributed, since they are written in
  133. Python, an experimental prototyping language that I developed.  Free
  134. source for a Python interpreter can be obtained by writing me at the
  135. address below.  An version is also available by anonymous ftp from
  136. various file servers, e.g., wuarchive.wustl.edu (in the US),
  137. mcsun.eu.net and ftp.cwi.nl (in the Netherlands).
  138.  
  139.  
  140. The Python program "nielsen.py" implements a rudimentary way of
  141. finding out who's listening to what.
  142.  
  143.  
  144. Author
  145. ------
  146.  
  147. The author of this software is:
  148.  
  149. Guido van Rossum
  150. CWI, dept. CST
  151. Kruislaan 413
  152. 1098 SJ  Amsterdam
  153. The Netherlands
  154.  
  155. E-mail (Internet)  :  Guido.van.Rossum@cwi.nl (guido@cwi.nl)
  156. E-mail (X.400)     :  G=Guido;S=van.Rossum;O=cwi;PRMD=surf;ADMD=400net;C=nl
  157.  
  158. The "libst" U-LAW conversion library is written and copyrighted by Jef
  159. Poskanzer.
  160.  
  161. If you port this software to other systems, I'd like to hear from you.
  162.  
  163.  
  164. Acknowledgements
  165. ----------------
  166.  
  167. I would like the following contributors for pieces of code and/or
  168. documentation:
  169.  
  170. Toerless Eckert for the -n, -l, -r and -t options
  171.  
  172. Paul Friedman for the -v option
  173.  
  174. Axel Belinfante for starting the man pages
  175.  
  176. Reimer A. Mellin for the NeXT port
  177.  
  178.  
  179. Copyright notice
  180. ----------------
  181.  
  182. Copyright 1991 by Stichting Mathematisch Centrum, Amsterdam, The
  183. Netherlands.
  184.  
  185.                         All Rights Reserved
  186.  
  187. Permission to use, copy, modify, and distribute this software and its 
  188. documentation for any purpose and without fee is hereby granted, 
  189. provided that the above copyright notice appear in all copies and that
  190. both that copyright notice and this permission notice appear in 
  191. supporting documentation, and that the names of Stichting Mathematisch
  192. Centrum or CWI not be used in advertising or publicity pertaining to
  193. distribution of the software without specific, written prior permission.
  194.  
  195. STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
  196. THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
  197. FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
  198. FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  199. WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  200. ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
  201. OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  202.