README.md 2.07 KB
Newer Older
1 2 3 4 5 6 7 8 9 10
# Calls

A phone dialer and call handler.

## License

Calls is licensed under the GPLv3+.

## Dependencies

11 12
    sudo apt-get install libgtk-3-dev libhandy-0.0-dev \
    modemmanager-dev libmm-glib-dev libgsound-dev libpeas-dev
13 14 15 16 17 18

## Building

We use the meson and thereby Ninja.  The quickest way to get going is
to do the following:

19
    meson -Dprefix=/usr/local/stow/calls-git ../calls-build
20 21 22 23 24
    ninja -C ../calls-build
    ninja -C ../calls-build install


## Running
25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44
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/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:
45 46 47

    sudo OFONO_AT_DEBUG=1 ofonod -n -d

48 49
The test programs within the [oFono source
tree](https://git.kernel.org/pub/scm/network/ofono/ofono.git) are
50 51 52 53 54 55 56
useful to bring up a modem to a suitable state.  For example:

    cd $OFONO_SOURCE/test
    ./list-modems
    ./enable-modem /sim7100
    ./online-modem /sim7100

Bob Ham's avatar
Bob Ham committed
57 58
Then run Calls:

59
    /usr/local/stow/calls-git/bin/calls -p ofono
Bob Ham's avatar
Bob Ham committed
60

61

62 63
#### Phonesim
One can also make use of the oFono modem simulator, phonesim (in the
64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80
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.