968458a219
(cherry picked from commit
|
||
---|---|---|
.gitlab/issue_templates | ||
build-aux | ||
data | ||
debian | ||
doc | ||
plugins | ||
po | ||
src | ||
tests | ||
.dir-locals.el | ||
.gitignore | ||
.gitlab-ci.yml | ||
calls.doap | ||
COPYING | ||
HACKING.md | ||
meson.build | ||
meson_options.txt | ||
NEWS | ||
org.gnome.Calls.json | ||
README.md | ||
run.in |
Calls
A phone dialer and call handler.
License
Calls is licensed under the GPLv3+.
Dependencies
To build Calls you need to first install the build-deps defined by the debian/control file
If you are running a Debian based distribution, you can easily install all those the dependencies making use of the following command
sudo apt-get build-dep .
Building
We use the meson and thereby Ninja. The quickest way to get going is to do the following:
meson . _build
ninja -C _build
ninja -C _build install
If you don't want to pollute your filesystem please be aware, that you can also
use --prefix=~/install
.
Build the documentation
If you want to build the documentation you have to configure the meson project
with -Ggtk_doc=true
meson . _build -Dgtk_doc=true
ninja -C _build
ninja -C _build calls-doc
Running
Calls has a variety of backends. The default backend is "mm", which utilises ModemManager. To choose a different backend, use the -p command-line option. For example, to run with the dummy backend and some useful debugging output:
export G_MESSAGES_DEBUG=all
/usr/local/bin/gnome-calls -p dummy
If using ModemManager, Calls will wait for ModemManager to appear on D-Bus and then wait for usable modems to appear. The UI will be inactive and display a status message until a usable modem appears.
Running from the build directory
You can run calls without having to install it by executing the run script in
the build folder, i.e. _build/run
. This script will setup the needed environment
and start Calls.
Call provider backends
Call provider backends are compiled as plugins and can be loaded and unloaded at runtime
using the -p
command line flag, followed by the plugin name.
Setting the CALLS_PLUGIN_DIR
environment variable will include the specified
directory in the plugin search path. F.e.
export CALLS_PLUGIN_DIR=_build/plugins/
/usr/local/bin/gnome-calls -p dummy
oFono
There is also an oFono backend, "ofono". This was the first backend developed but has been superceded by the ModemManager backend so it may suffer from a lack of attention.
The ofono backend depends on oFono Modem objects being present on D-Bus. To run oFono with useful output:
sudo OFONO_AT_DEBUG=1 ofonod -n -d
The test programs within the oFono source tree are useful to bring up a modem to a suitable state. For example:
cd $OFONO_SOURCE/test
./list-modems
./enable-modem /sim7100
./online-modem /sim7100
Then run Calls:
/usr/bin/gnome-calls -p ofono
Phonesim
One can also make use of the oFono modem simulator, phonesim (in the ofono-phonesim package in Debian):
ofono-phonesim -p 12345 -gui /usr/local/share/phonesim/default.xml
then, ensuring /etc/ofono/phonesim.conf has appropriate contents like:
[phonesim]
Address=127.0.0.1
Port=12345
run oFono as above, then:
cd $OFONO_SOURCE/test
./enable-modem /phonesim
./online-modem /phonesim
And again run Calls.