1README file for dtmf-dial-0.1 2 3(C) 1998 Itai Nahshon, nahshon@actcom.co.il 4Use and redistribution are subject to the GNU GENERAL PUBLIC LICENSE. 5 6 7Dial generates the dtmf tone signals used for telephone 8dialing and by default sends the signals to the sound card. 9 10It can be used for easy dialing, simply put the telephone 11microphone near the compiter speaker and let the software 12dial for you. 13 14It is intended for dialing from within data base programs that 15also store telephone numbers. 16 17Usage: 18Usually you just run need to give the phone number 19that you wish to dial as an argument. 20 dial 555-3456 21 22By default the tone generated for each dialed digit is 23100 milliseconds. Silence between digits is 50 milliseconds. 24A comma or a blank space between digits is replaces with 25a 500 milliseconds delay. 26 27The duration values can be set by these arguments: 28 --tone-time milliseconds (default 100) 29 --silent-time milliseconds (default 50) 30 --sleep-time milliseconds (default 500) 31 32By default the output is sent to "/dev/dsp". Generated samples 33are 8 bits unsigned values (AFMT_U8). 8000 samples/second. 34 35To send the output to another device one can use the option: 36 --output-dev device (default /dev/dsp) 37This option can be used also to store raw audio samples to 38a file, or to stdout. Use the file name with the --output-dev 39option, ir a simpe "-" to sent to stdout. 40If the output device is not the sound special file then another 41option should be used to eliminate attempts to set the sound 42driver parameters: 43 --use-audio onoff (default 1) 44Use "--use-audio 0" to disable sound ioctls. 45 46It is possible to generate the samples in AFMT_S16_LE format, 47To do that use the option: 48 --bits bits-per-sample (default 8) 498 will geneate AFMT_U8 format, 16 will generate AFMT_S16_LE format. 50 51It is possible to generate samples in a different sampling rate. 52To do that use the option: 53 --speed sampling-rate (default 8000) 54 55Sound samples are generated by sub-sampling values from a cosine 56table. By default the cosine table contains 256 samples. 57Smaller cosine table sizes still produce the correct frequencies 58but with some distortion. 59These options can be used: 60 --table-size size (default 256) 61The table used is of a different size 62 --volume volume (default 100) 63Values stored in the table are scaled down volume/100 times 64the maximum value which does not cause overflow on the 8 or 6516 bit samples. 66 67To generate a stereo sound use the options --right or 68--left. By default they are 0 and a mono sample is generated. 69If any of these option are 1, a stereo sample will be generated 70and the corrensponding channel will be turned on. 71