README.md 1.28 KB
Newer Older
Bob Ham's avatar
Bob Ham committed
1 2 3 4
# Hægtesse
A daemon to transfer call audio data between a modem and PulseAudio.

Hægtesse was written solely for the SIMCom SIM7100 modem but may be
Bob Ham's avatar
Bob Ham committed
5 6
useful for other modems.  The audio format is hard-coded to mono,
signed 16-bit little-endian PCM samples at 8 kHz.
Bob Ham's avatar
Bob Ham committed
7 8 9

Probably the best place for this functionality would be a PulseAudio
plugin which listens to ModemManager over D-Bus and configures itself
Bob Ham's avatar
Bob Ham committed
10 11
according to ModemManager call audio meta-data.  This ModemManager
functionality is still under development, however.
Bob Ham's avatar
Bob Ham committed
12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37

## License
Hægtesse is licensed under the GPLv3+.

## Dependencies

    sudo apt-get install libpulse-dev libglib2.0-dev

A development version of ModemManager is required in order to send
appropriate AT commands to the SIM7100 for enabling call audio.  Our
development tree is here:

    https://source.puri.sm/Librem5/ModemManager


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

    meson ../haegtesse-build
    ninja -C ../haegtesse-build
    ninja -C ../haegtesse-build install


## Running
Hægtesse is usually run as a systemd user service.  To run it by hand,
38
the program takes no options so just run it with the program name:
Bob Ham's avatar
Bob Ham committed
39

40 41 42 43
  $ haegtesse

Hægtesse will then query udev to find and/or wait for an appropriate
TTY.