home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsp / phonering / ReadMe next >
Encoding:
Text File  |  1995-02-27  |  3.9 KB  |  76 lines
  1. WatchRing 1.10
  2. Rick Hudson, rick@actrix.gen.nz
  3.  
  4. This archive contains a pair of modules to detect the phone ringing via a
  5. modem and plays a sound sample when it does. Simply run the two modules,
  6. switch on your modem and wait for the phone to ring.
  7.  
  8. Version 1.10 is basically the same WatchRing (previously called WatchRing)
  9. module but the supplied voice module, RingIn, has a bug fixed. It was
  10. possible for the ring voice to not detach itself from the sound system and
  11. remain as your system bell. This happened if another ring signal was received
  12. while the sample was already playing.
  13.  
  14. The module works by watching for the string <CR><LF>RING<CR><LF> coming in
  15. through the serial port so you need to be sure that your modem does generate
  16. this message when the phone rings (it should come up in the window of a comms
  17. program). The more natural way to implement this would have been to simply
  18. monitor the RI line which some modems use to indicate the phone ringing. The
  19. problem with this however is that not all modems do this and the serial
  20. cable to the Arc is often wired so that RI is used for the DCD (to
  21. circumvent an old serial port bug).
  22.  
  23. The RingIn module that actually plays the sound must supply a command called
  24. 'Splay_RingIn' to play the sounds. Because of this it cannot be replaced by
  25. just any old voice module. The reason for this is that the module is a
  26. 'transient voice' and does not attach itself to the system until it's needed
  27. at which point it borrows channel 1, plays the sound and releases the
  28. channel it when it's finished. A sample converter that I have written (soon
  29. to be released into the PD) can generate voice modules suitable for
  30. WatchRing, so e-mail me at the address above (if you can't find it on a PD
  31. archive) if you want me to send a copy of this so you can use your own
  32. samples. You will, of course, need a sample in some other format first.
  33.  
  34. Because of the transient nature of the sound playing, if the sound system is
  35. being used when the phone rings it is possible that something will crash!
  36. This is because I couldn't figure out how to determine if a channel was free
  37. or not. I usually switch off my modem when the computer is playing music or
  38. something.
  39.  
  40. Some things you may find annoying: The supplied phone sample is a New
  41. Zealand phone and the sample is played at a fixed volume independant of the
  42. system setting. The latter is not because of sloppy programming but because
  43. that's how I wanted it. The module generator allows various volume 'modes',
  44. one of which is a fixed independant volume setting.
  45.  
  46. Disclaimer: This software is supplied 'as is' and I cannot guarantee that it
  47. will work on your computer/modem setup. I will not be held responsible for
  48. any 'effects' caused by the use of this program. I would nevertheless be
  49. interested to hear any problems you may have.
  50.  
  51. History:
  52.  
  53. 1.00  First released version
  54. 1.10  Rewrote module because I lost the source code! Fixed bug in voice
  55.       module generator that sometimes caused voice to be left as system bell.
  56.  
  57.  
  58. Using !SoundCon to create a voice module for WatchRing
  59. ------------------------------------------------------
  60.  
  61. AS noted above, the !SoundCon application is probably the best application
  62. for generating a voice module to use with WatchRing. The important thing is
  63. that the command SPlay_RingIn exists that plays the required sound.
  64.  
  65. - To make the module, drag the sound sample you want to use on to SoundCon
  66.   which should be identified as the correct sample. SoundCon will report the
  67.   type as being 'Raw data?' if it doesn't recognise it.
  68.  
  69. - Open the convert window (from icon bar or info window menus) and
  70.   open the Type pop-up menu. Select VoiceMod as the major format and ensure
  71.   that the sub-format is set to 'Transient' and 'Fixed freq'. The volume
  72.   type is a matter of taste (see SoundCon help for details).
  73.  
  74. - Change the name in the savebox to RingIn (this is important) and save it
  75.   somewhere. There's your new phone ring module!
  76.