home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / communication / newam.0.1.README < prev    next >
Encoding:
Text File  |  1996-09-08  |  7.2 KB  |  191 lines
  1.                 Answering Machine for Zyxel modems
  2.                 ==================================
  3.  
  4.  
  5. History
  6. =======
  7.  
  8. This Answering Machine based on "am.1.16" written by
  9.  
  10.         Jolly alias Patrick Stein  =  jolly@cis.uni-muenchen.de
  11.         Tel: ++49 +89 -211 06 70          (priv) +89 -950 57 34
  12.  
  13. It was completely rewritten because it did not work in some (for me) important points.
  14. These are:
  15.     Zyxel voice <--> NeXT sound did not work on my Intel machine.
  16.     UUCP did never work when the old am was running.
  17.  
  18.  
  19. Following improvements were made:
  20.  
  21. o    Conversion from Zyxel voice file (*.zsnd) to NeXT sound file (*.snd) can be done to
  22.     9600Hz, 16Bit linear, which has the best sound on my Intel machine, or optional to
  23.     8012Hz, 8bit mulaw, which seems to be better on black hardware (no clicks).
  24.     The second format can be obtained by using the option -c in "zsnd2snd" and "zsndplay".
  25.  
  26. o    The old voice file format ".zyxel" was modified to the new format ".zsnd", so that you can
  27.     play now voice files delivered by ZyXEL.
  28.     Unfortunately these both formats are incompatible.
  29.     The following modifications are made:
  30.     1. one byte swap in file header, bytes 11 and 12
  31.     2. the file now has only raw data, and the reading software has to take care, that
  32.        the special character DLE has to be escaped (with DLE) when writing to the modem.
  33.  
  34. o    Class2 protocol implemented for receiving faxes. Code not only is more robust compared
  35.     with ZyXEL's internal protocol 6 (which was used by the old "am"), but also there is a
  36.     chance for an easy porting of am to a lot of other modems.
  37.  
  38. o    am can now be configured _after_ compiling using e.g. the configuration file ".am"
  39.  
  40. o    eMail service has been implemented. Incoming calls or faxes can be listened to or read in
  41.     the mail box.
  42.  
  43. o    am and UUCP are friends now. Any software using the same port as am, and which locks the
  44.     port, can do its work without any troubles.
  45.  
  46. o    The name of the voice or fax files have a new format. Now they can be sorted in order of
  47.     incoming date and not in order of weekdays. Day, month and year are now part of the name.
  48.  
  49. o    In case of you took off the receiver and - what a surprise - a fax is coming, you are now
  50.     able to make a switch to persuade the modem to take the line for handling this event.
  51.     (This can be done either by entering "echo > /tmp/faxsignal.am" in a Terminal window or
  52.     using my NeXT application "Dial".) After modem took the line, you MUST hang up the receiver.
  53.  
  54. o    The random generation of welcome messages has not been ported to the new version.
  55.  
  56. o    Additionally, there is a small NeXTSTEP application ("Dial") for dialing a number you coded
  57.     in one of your "AddressBook"'s.
  58.     Sorry for nearly no documentation or help for this application.
  59.     And sorry also for not working properly.
  60.     The most important thing of this application is the menu button "FaxSignal" (see above).
  61.  
  62.  
  63. The following things do NOT work:
  64.  
  65. o    Incoming data calls are not handled.
  66.         This is, because I currently don't need this feature. But it should be easy to
  67.         implement. If someone will do it, do it, and send me the code for maintaining.
  68.  
  69. o    Only ZyXEL modem U-1496EG+ is supported.
  70.         This is because I have only this modem. If there is someone with another modem with
  71.         voice capabilities, port it, and send me the code for maintaining.
  72.  
  73. o    sending faxes
  74.  
  75.  
  76.  
  77. Installing am
  78. =============
  79.  
  80. The am package includes
  81.     am                    - voice/fax driver
  82.     .am                    - configuration of am
  83.     amreset                - resetting am (should not be needed)
  84.     dial                - dialing out
  85.     zsnd2snd            - converting ZyXEL voice to NeXT sound
  86.     snd2zsnd            - converting NeXT sound to ZyXEL voice
  87.     zsndplay            - plays a ZyXEL voice on the NeXT sound system
  88.     voicemail            - makes a NeXTMail of a received voice (only used by am internally)
  89.     faxmail                - makes a NeXTMail of a received fax (only used by am internally)
  90.     SystemVoices        - ZyXEL voices for advanced voice features of am
  91.     spool                - directory for incoming voices and faxes
  92.  
  93.     
  94. We suggest to install the binaries (am, amreset, dial, zsnd2snd, snd2zsnd, zsndplay) at
  95. "/usr/local/bin".
  96.  
  97. Then it makes sense to install .am, voicemail, faxmail, SystemVoices at "/usr/local/lib/AM"
  98.  
  99. The spool directory might reside at "/usr/spool/AM".
  100.  
  101. If your installation differs, you have to edit the script "voicemail" to set the correct path for the variable SNDCONVERT.
  102.  
  103. If you are using a black NeXT Computer, probably you want to edit "voicemail" to enable
  104. the option -c for SNDCONVERT.
  105.  
  106. Now you probably want to edit .am to set your am configuration. The config file .am, which is part
  107. of this package, contains all defaults, which can be overwritten.
  108.  
  109. To start am, modify your file "/private/etc/ttys". You need (assuming port b) an entry of form
  110.     ttydfb    "/usr/local/bin/am /usr/local/lib/AM/.am"    vt100        on
  111.  
  112. Type "kill -HUP 1" at a root terminal window (or reboot) and am will start.
  113. (You should have installed a serial driver, which supports 38400 Baud)
  114.  
  115.  
  116. When using Makefile:
  117. --------------------
  118.     cd to /yourdir/newam-0.1 in a Terminal window
  119.     Enter "make"
  120.     Login as root
  121.     Copy SystemVoices and .am to /usr/local/lib/AM
  122.         "cp -rp lib/AM /usr/local/lib"
  123.     Copy spool directories to /usr/spool/AM
  124.         "cp -rp spool/AM /usr/spool"
  125.     Enter "make install"
  126.     Now edit /usr/local/lib/AM/.am and /private/etc/ttys
  127.         and perhaps /usr/local/lib/AM/voicemail
  128.  
  129.  
  130. Use option -h to see, how the commands zsnd2snd, zsndplay and snd2zsnd work.
  131.  
  132.  
  133.  
  134. Using advanced voice features
  135. =============================
  136.  
  137. There are two features of remote control using MFV tones.
  138. The first one is for you (root mode):
  139.     You can call from anywhere to your phone and enter "#4711*" to enter the root menu.
  140.     (The root password number 4711 can be modified in the configuration file.)
  141.     Then someone is telling you ("RootMenu.zsnd"), that you can press "#1" for listening to
  142.     a recorded message or "#2" for archiving the recorded message, you heard last.
  143. The second feature is for friends of you:
  144.     They can enter "#nnnnn*" and have an ear, wether a message "nnnnn.zsnd" is left in
  145.     FriendDir. After hearing this - or the message, that there is nothing to hear
  146.     ("NoMessageForFriend.zsnd") - , they can leave a message for you.
  147.  
  148.  
  149. You can modify the SystemVoices in two ways:
  150. 1.    Use your microphone and speak text to a NeXT sound file. Then convert it to ZyXEL voice
  151.     using "snd2zsnd" in a Terminal window.
  152. 2.    Phone yourself, speak all messages, run at home and build the voice files using "zsnd2snd",
  153.     Sound Tools for copy, cut and paste, and "snd2zsnd".
  154.  
  155. NOTE: Delivered voices are spoken by me and my girlfriend, and ALL are spoken in german language.
  156.       If you will modify the contents, the names of the files will lead you to the correct text
  157.       in your language.
  158.  
  159.  
  160.  
  161. Voice
  162. =====
  163.  
  164. ZyXEL has 3 voice compression modes, called CELP, ADPCM2 and ADPCM3.
  165. CELP is not supported by am because of unknown algorithm. ADPCM code is adopted from "am.1.16".
  166. Voice files to play may have ADPCM2 or ADPCM3 compression. Received files are always of format
  167. ADPCM3. If you want to change it, modify RECVCM in am.c and recompile.
  168.  
  169.  
  170.  
  171. Guarantee
  172. =========
  173.  
  174. This piece of software is full of bugs, and its use may well be hazardous to your health.
  175.  
  176.  
  177.  
  178. Use
  179. ===
  180.  
  181. The use of this software is free for all non-commercial purposes. In case of intention of
  182. commercial use please contact me.
  183.  
  184.  
  185.  
  186.  
  187. September 1996
  188.  
  189. Olaf Mueller    Heinrichstr. 38    D-38106 Braunschweig
  190. eMail: olaf@orest.escape.de        Tel/Fax: +49 531 338026
  191.