README.md: Update dependencies and instructions to build/run Calls

This commit is contained in:
Bob Ham 2018-12-04 10:43:03 +00:00
parent 458a4c1df3
commit 5a6dfb7469
1 changed files with 26 additions and 8 deletions

View File

@ -8,21 +8,40 @@ Calls is licensed under the GPLv3+.
## Dependencies ## Dependencies
sudo apt-get install libgtk-3-dev libhandy-0.0-dev modemmanager-dev libmm-glib-dev sudo apt-get install libgtk-3-dev libhandy-0.0-dev \
modemmanager-dev libmm-glib-dev libgsound-dev libpeas-dev
## Building ## Building
We use the meson and thereby Ninja. The quickest way to get going is We use the meson and thereby Ninja. The quickest way to get going is
to do the following: to do the following:
meson ../calls-build meson -Dprefix=/usr/local/stow/calls-git ../calls-build
ninja -C ../calls-build ninja -C ../calls-build
ninja -C ../calls-build install ninja -C ../calls-build install
## Running ## Running
Calls depends on oFono Modem objects being present on D-Bus. To run Calls has a variety of backends. The default backend is "mm", which
oFono with useful output: 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/stow/calls-git/bin/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.
### 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 sudo OFONO_AT_DEBUG=1 ofonod -n -d
@ -37,12 +56,11 @@ useful to bring up a modem to a suitable state. For example:
Then run Calls: Then run Calls:
cd $CALLS_SOURCE /usr/local/stow/calls-git/bin/calls -p ofono
../calls-build/src/calls
### Phonesim #### Phonesim
One can also make use of the modem simulator, phonesim (in the One can also make use of the oFono modem simulator, phonesim (in the
ofono-phonesim package in Debian): ofono-phonesim package in Debian):
ofono-phonesim -p 12345 -gui /usr/local/share/phonesim/default.xml ofono-phonesim -p 12345 -gui /usr/local/share/phonesim/default.xml