Sip-Tools - Automated calls and answering machine
- sipcall - Automated calls over SIP/VOIP with TTS
- sipserv - Answering machine for SIP/VOIP with TTS
Copyright (C) 2012 by Andre Wussow, firstname.lastname@example.org
major changes 2017 by Fabian Huslik, github.com/fabianhu
more changes 2018 by Kaito Cross, github.com/KaitoCross
For more informations please visit http://binerry.de/post/29180946733/raspberry-pi-caller-and-answering-machine.
Installation on Raspberry Pi 2/3 with Raspian
Build and install PjSIP as explained below
sudo apt-get install espeak espeak-data
If output of DTMF digits through GPIO in sipserv is needed: (if not, skip to step 6)
install wiringPi as outlined on http://wiringpi.com/download-and-install/
./buildas described in link, run sudo make install for wiringPi
Download this folder to Raspberry Pi
If output of DTMF digits in sipserv (answer machine) through GPIO is needed: execute
make sipserv-gpioin SIP-Pi folder in Terminal
If forwarding the 4 last DTMF digits to a tcp server is needed, run
-localdirectly at the end (without a space) if you run the sip server you are planning to connect to is on the same Pi.
make sipcallif you need the standalone phone software as well
If the mentioned output options are not needed, just execute
make allin SIP-Pi folder in Terminal instead
sipserv.cfgto your needs (see example configuration)
test drive using
sudo ./sipserv --config-file sipserv.cfg
this is not(yet) a "real" service, so include
./sipserv-ctrl.sh startcommand into your favourite autostart.
stop the SIP service using
sudo apt-get install lamefor the MP3 compression of recordings (mail.sh)
Pickup a call, have a welcome message played or read. Do some actions by pressing (DTMF) keys on your phone. Get 4-bit DTMF key value through GPIO if wished. This service uses a generic approach. All actions are configurable via config file. One special usage is the special ability to record the caller while playing the intro. Please contact your lawyer, if this is legal in your country. With the sample configuration you can have a blacklist and only the special (=blacklisted) calls answered.
Usage: (if GPIO output needed, has to run as root)
- --config-file=string Set config file
- -s=int Silent mode (hide info messages) (0/1)
ipv6=int IPv6 usage (0/1) Only set to 1 if you want to use IPv6 exclusively
sd=string Set sip provider domain.
su=string Set sip username.
sp=string Set sip password.
ln=string Language identifier for espeak TTS (e.g. en = English or de = German).
tts=string String to be read as a intro message
determine DTMF Key digit encoding
- dtmf-encoding=int Set DTMF digit output binary encoding (0=linear/1=MT8870 scheme) (default linear)
and at least one dtmf key configuration (X = dtmf-key index):
- dtmf.X.active=int Set dtmf-setting active (0/1).
- dtmf.X.description=string Set description.
- dtmf.X.audio-response= Set audio response wav file to play; tts for that DTMF key will not be read, if this parameter is given. File format is Microsoft WAV (signed 16 bit) Mono, 22 kHz;
- dtmf.X.tts-intro=string Set tts intro.
- dtmf.X.tts-answer=string Set tts answer.
- dtmf.X.cmd=string Set shell command.
- rc=int Record call (0=no/1=yes)
- af=string announcement wav file to play; tts will not be read, if this parameter is given. File format is Microsoft WAV (signed 16 bit) Mono, 22 kHz;
- cmd=string command to check if the call should be taken; the wildcard # will be replaced with the calling phone number; should return a "1" as first char, if you want to take the call.
- am=string aftermath: command to be executed after call ends. Will be called with two parameters: $1 = Phone number $2 = recorded file name
- gpio-en=int enable output of DTMF digits on Raspberry Pi wiringPi GPIO
options for DTMF forwarding to TCP server:
- dtmf-value-forward-srv=string Set domain name of tcp server
- mail-audio-response=string _Set audio response for a processed email (in combination with dmail-connect only) (optional)
options for DTMF digit output on Raspberry Pi GPIO
The GPIO output function is based on wiringPi and uses the wiringPi numbering scheme. It outputs the digits as 4-bit binary number. When GPIO output has been enabled, you have to define all 4 output ports and the interrupt port. To define them, put this into the config file:
- gpio-0=int Port number goes here instead of int
- gpio-1=int Port number goes here instead of int
- gpio-2=int Port number goes here instead of int
- gpio-3=int Port number goes here instead of int
- gpio-interrupt=int Port number goes here instead of int The interrupt port is often needed by the microprocesser that reads those digits. Connect it to the interrupt port of your other microprocesser and configure that controller as needed to respond to the interrupt.
a sample configuration can be found in sipserv-sample.cfg
sipserv can be controlled with
sudo ./sipserv-ctrl.sh start and sudo ./sipserv-ctrl.sh stop
Changelog since fabianhu's version:
- Implemented IPv6 Support
- added option for wavefile being played instead of an tts file when DTMF key has been pressed
- added *, #, 0, and A-D into processable DTMF-signals
- added forwarding of last 4 DTMF digits to TCP server after # is pressed
build directly on Raspberry Pi:
cd ~/tmp # any temporary directory wget http://www.pjsip.org/release/2.7.1/pjproject-2.7.1.tar.bz2 tar xvfj pjproject-2.7.1.tar.bz2 cd pjproject-2.7.1/ ./configure --disable-video --disable-libwebrtc nano pjlib/include/pj/config_site.h (add next line into file:) #define PJ_HAS_IPV6 1 navigate back to pjproject-2.7.1 folder make dep make sudo make install
You will have plenty of time to drink some Dr. Pepper during
make. Enjoy while waiting.
Cross build of PjSIP for Raspberry:
export CC=/opt/raspi_tools/tools/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64/bin/arm-linux-gnueabihf-gcc export LD=/opt/raspi_tools/tools/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64/bin/arm-linux-gnueabihf-gcc export CROSS_COMPILE=/opt/raspi_tools/tools/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64/bin/arm-linux-gnueabihf- #export AR+=" -rcs" export LDFLAGS="-L/opt/raspi_tools/tools/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64/lib/gcc/arm-linux-gnueabihf/4.8.3 -L/opt/raspi_tools/tools/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64/arm-linux-gnueabihf/lib -ldl -lc" ./aconfigure --host=arm-elf-linux --prefix=$(pwd)/tmp_build --disable-video --disable-libwebrtc Add into pjlib/include/pj/config_site.h: #define PJ_HAS_IPV6 1 navigate back to pjproject-2.7.1 folder make dep make
Make outgoing calls with your Pi.
- sipcall [options]
- -sd=string Set sip provider domain.
- -su=string Set sip username.
- -sp=string Set sip password.
- -pn=string Set target phone number to call
- -tts=string Text to speak
- -ttsf=string TTS speech file name
- -rcf=string Record call file name
- -mr=int Repeat message x-times
- -s=int Silent mode (hide info messages) (0/1)
- -ipv6=int IPv6 mode (use IPv6 exclusively) (0/1)
see also source of sipcall-sample.sh
This tools are free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This tools are distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.