ofonod: GNOME Calls backend over org.ofono for Phosh and GNOME Mobile
imsd-ofonod presents imsd on the system bus as an oFono modem — Manager at /, Modem + VoiceCallManager at /imsd, a VoiceCall object per call — which is what GNOME Calls' bundled ofono provider drives; Calls, Phosh and GNOME Shell run unmodified. org.gnome.Calls is not a seam a third party can provide (Calls exports it, nothing feeds it), and Calls' provider plugins link private headers, so org.ofono is the only D-Bus contract available. Pure GDBus translation of net.catcrafts.IMS1, no core, like imsd-dialerd. Packaged as the opt-in imsd-ofono subpackage: the daemon, its unit (Conflicts=ofono.service), the system-bus policy and a gschema override that points Calls at the ofono provider instead of mm (the ModemManager origin would offer the modem's CS voice path, which carries no audio on these phones). The policy grants root send_destination=org.ofono: under dbus-broker a broadcast is checked against the sender's send policy for every name the receiver owns, so without it imsd's call signals never reach the daemon. Verified on a Fairphone 6 with GNOME Calls 50.0: outgoing and incoming calls with audio both ways, answered and hung up through org.gnome.Calls.Call. Known Calls-side gap documented in the README: after the VoiceCallManager interface is withdrawn and re-added, Calls keeps the old origin's CallAdded handler and eventually crashes.
This commit is contained in:
parent
6689b8b252
commit
b986eb3750
GPG key ID:
2937E59CDCC1BCFB
11 changed files with 1037 additions and 13 deletions
116
README.md
116
README.md
|
|
@ -9,8 +9,9 @@ Modem firmware on typical mainline-Linux phones will bring up the IMS PDN but
|
|||
can't be used for actual call audio. imsd implements the whole IMS client in
|
||||
userspace instead: SIP registration with USIM AKA authentication over kernel
|
||||
IPsec (ESP), call signalling, and the AMR-WB RTP media plane wired into
|
||||
PipeWire so a stock Plasma Mobile dialer can place and receive real VoLTE
|
||||
calls on a commercial network.
|
||||
PipeWire so a stock mobile dialer — Plasma Dialer, or GNOME Calls under Phosh
|
||||
and GNOME Mobile — can place and receive real VoLTE calls on a commercial
|
||||
network.
|
||||
|
||||
## Status
|
||||
|
||||
|
|
@ -28,7 +29,7 @@ live only in the `imsd` daemon shell.
|
|||
|
||||
## Architecture
|
||||
|
||||
C++26 modules, built with Crafter Build. Four build products:
|
||||
C++26 modules, built with Crafter Build. Five build products:
|
||||
|
||||
- **imsd-core** (static library) — the engine, pure `import std` C++ with no
|
||||
GLib and no I/O side effects. Everything here is unit-testable on any dev
|
||||
|
|
@ -48,6 +49,26 @@ C++26 modules, built with Crafter Build. Four build products:
|
|||
that the root system daemon cannot own; built with `-- --product=dialerd`,
|
||||
autostarted from an `.desktop` file in place of plasma-dialer's
|
||||
`modem-daemon` (whose autostart must be disabled).
|
||||
- **imsd-ofonod** (executable) — the GNOME Calls integration, for Phosh and
|
||||
GNOME Mobile: a system daemon owning `org.ofono` and presenting imsd as an
|
||||
oFono modem, which is the seam GNOME Calls' bundled `ofono` provider plugin
|
||||
drives. GDBus translation only, no core; built with `-- --product=ofonod`.
|
||||
See [GNOME Calls (Phosh, GNOME Mobile)](#gnome-calls-phosh-gnome-mobile).
|
||||
|
||||
### Desktop integration
|
||||
|
||||
imsd itself is desktop-agnostic: everything a dialer needs is on the system
|
||||
bus as `net.catcrafts.IMS1`. Each desktop gets a small translation daemon
|
||||
speaking whatever backend protocol its dialer already consumes, so the dialer,
|
||||
the shell and the call-history/contacts stack all stay unmodified.
|
||||
|
||||
| Desktop | Daemon | Owns | Consumed by |
|
||||
|---|---|---|---|
|
||||
| Plasma Mobile | `imsd-dialerd` | `org.kde.telephony.*` (session bus) | plasma-dialer + kde-telephony-daemon, replacing `modem-daemon` |
|
||||
| Phosh / GNOME Mobile | `imsd-ofonod` | `org.ofono` (system bus) | GNOME Calls' `ofono` provider plugin |
|
||||
|
||||
Phosh's own call UI needs nothing extra: it consumes `org.gnome.Calls`, which
|
||||
GNOME Calls exports once it has a working origin.
|
||||
|
||||
### Terminating-network dependency (incoming)
|
||||
|
||||
|
|
@ -85,7 +106,8 @@ gio-2.0 headers (`glib2` on Arch, `glib-dev` on Alpine).
|
|||
```sh
|
||||
crafter-build # bin/imsd-<target>-<march>/imsd (the daemon)
|
||||
crafter-build -- --product=media # bin/imsd-media-.../imsd-media (the media leg)
|
||||
crafter-build -- --product=dialerd # bin/imsd-dialerd-.../imsd-dialerd (dialer backend)
|
||||
crafter-build -- --product=dialerd # bin/imsd-dialerd-.../imsd-dialerd (Plasma backend)
|
||||
crafter-build -- --product=ofonod # bin/imsd-ofonod-.../imsd-ofonod (GNOME Calls backend)
|
||||
crafter-build test # unit tests (Util, Aka, Ipsec, Messages, Engine, Sip, Sdp)
|
||||
```
|
||||
|
||||
|
|
@ -97,7 +119,7 @@ sources (`std.cppm` — package `llvm-runtimes` on Alpine, `libc++` on Arch),
|
|||
lld, and gio-2.0 headers.
|
||||
|
||||
```sh
|
||||
make # build/make/{imsd,imsd-media,imsd-dialerd}
|
||||
make # build/make/{imsd,imsd-media,imsd-dialerd,imsd-ofonod}
|
||||
make check # the same 7 unit-test suites
|
||||
make install # DESTDIR/PREFIX staged install incl. the packaging/ files
|
||||
```
|
||||
|
|
@ -134,6 +156,86 @@ the granted lifetime. `packaging/APKBUILD` builds the apk from source via
|
|||
the Makefile; `packaging/APKBUILD.binary` + `make-bin-tarball.sh` wrap a
|
||||
cross-compiled build into an apk instead.
|
||||
|
||||
## GNOME Calls (Phosh, GNOME Mobile)
|
||||
|
||||
`imsd-ofonod` presents imsd on the system bus as an oFono modem — a Manager at
|
||||
`/`, one Modem + VoiceCallManager at `/imsd`, and a VoiceCall object per live
|
||||
call — which is what GNOME Calls' bundled `ofono` provider plugin drives.
|
||||
Calls, Phosh and GNOME Shell run unmodified.
|
||||
|
||||
`org.ofono` is the seam because it is the only one a third party can
|
||||
implement. `org.gnome.Calls.Call` is what Calls *exports* so a shell can
|
||||
observe and control a call that already exists (Accept, Hangup, SendDtmf,
|
||||
Silence — there is no Dial); Phosh consumes it from Calls. Calls' own backends
|
||||
are libpeas provider plugins (`mm`, `ofono`, `sip`, `dummy`) linked against
|
||||
private headers that no distro installs.
|
||||
|
||||
Setup:
|
||||
|
||||
```sh
|
||||
apk add imsd-ofono # or install the files by hand
|
||||
systemctl enable --now imsd-ofonod # system service; org.ofono is a system name
|
||||
# point Calls at the ofono provider (the package ships this as a gschema
|
||||
# override; this is the per-user equivalent)
|
||||
gsettings set org.gnome.Calls autoload-plugins "['ofono']"
|
||||
```
|
||||
|
||||
Drop `mm` from `autoload-plugins` rather than adding `ofono` alongside it: the
|
||||
ModemManager provider would offer the modem's own CS voice path as a second
|
||||
origin, and on a phone whose voice path is imsd that origin carries no audio.
|
||||
|
||||
Do not run this alongside a real `ofonod` — there is one `org.ofono` name and
|
||||
one owner; the unit declares `Conflicts=ofono.service` and the daemon exits if
|
||||
it loses the name. Running `imsd-dialerd` at the same time is fine (different
|
||||
bus, different consumer).
|
||||
|
||||
Verified on a Fairphone 6 (postmarketOS, dbus-broker) with GNOME Calls 50.0:
|
||||
outgoing and incoming calls with audio both ways, answered and hung up through
|
||||
`org.gnome.Calls.Call` — the surface Phosh drives. One dbus-broker detail is
|
||||
load-bearing and lives in the policy file: dbus-broker checks a broadcast
|
||||
against the sender's send policy for every name the receiver owns, so root
|
||||
(imsd) must be allowed `send_destination="org.ofono"` or imsd's call signals
|
||||
never reach the daemon.
|
||||
|
||||
Known gaps, all inherited rather than introduced:
|
||||
|
||||
- **USSD is refused** with `org.ofono.Error.NotSupported`; the IMS stack has no
|
||||
USSD path. It is deliberately not advertised in the modem's `Interfaces`.
|
||||
- **No hold, multiparty, transfer or call waiting** — imsd is a single-call
|
||||
stack, so those methods return `org.ofono.Error.NotImplemented`.
|
||||
- **Per-call caller-ID withholding is refused** rather than silently ignored:
|
||||
imsd cannot honour a CLIR request, and failing is safer than dialling with
|
||||
the caller ID exposed.
|
||||
- **Phosh's emergency-call screen lists nothing.** Not for want of the data:
|
||||
`imsd-ofonod` publishes `org.ofono.VoiceCallManager.EmergencyNumbers` (112,
|
||||
911, plus `EMERGENCY_NUMBERS`), which is oFono's standard place for it.
|
||||
Calls' ofono provider simply never reads it — it makes no `GetProperties`
|
||||
call on the VoiceCallManager, and returns NULL for the origin's
|
||||
`emergency-numbers`, which is what
|
||||
`org.gnome.Calls.EmergencyCalls.GetEmergencyContacts` is built from. (The
|
||||
ModemManager provider does read it, via `mm_sim_dup_emergency_numbers()`.)
|
||||
An upstream fix would close this. Dialling an emergency number from the
|
||||
normal dialpad is unaffected — that reaches imsd's own classifier.
|
||||
- DTMF is forwarded to imsd, where `SendDtmf` is still a stub (RFC 4733 is not
|
||||
implemented yet) — the same limitation Plasma has.
|
||||
- **Restart GNOME Calls after restarting `imsd-ofonod` (or imsd).** When the
|
||||
modem's `VoiceCallManager` interface goes away and comes back, Calls 50.0
|
||||
adds a new origin but leaves the old origin's `CallAdded` handler connected:
|
||||
after one such cycle every call is added twice, after a few the stale handler
|
||||
runs on freed memory and Calls dies with SIGBUS in `g_hash_table_lookup`
|
||||
(measured on the FP6). Calls-side; an upstream fix belongs in
|
||||
`plugins/provider/ofono/calls-ofono-provider.c`.
|
||||
|
||||
Development, without a phone or root:
|
||||
|
||||
```sh
|
||||
./bin/imsd-*/imsd --session & # imsd's ABI on the session bus
|
||||
./bin/imsd-ofonod-*/imsd-ofonod --session
|
||||
busctl --user call org.ofono / org.ofono.Manager GetModems
|
||||
# or keep org.ofono on the system bus and imsd on the session bus:
|
||||
IMSD_BUS=session imsd-ofonod
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
Everything is environment variables. The packaged unit reads
|
||||
|
|
@ -204,6 +306,9 @@ integrations depend on it:
|
|||
| `CallDeleted` | `s` |
|
||||
| `RegistrationChanged` | `b` |
|
||||
|
||||
Both `imsd-dialerd` and `imsd-ofonod` are pure translations of this ABI; a new
|
||||
desktop needs a new translation daemon, not changes here.
|
||||
|
||||
## License
|
||||
|
||||
GPL-3.0-only — see [LICENSE](LICENSE).
|
||||
|
|
@ -212,4 +317,3 @@ GPL-3.0-only — see [LICENSE](LICENSE).
|
|||
|
||||
Copyright (C) 2026 Catcrafts®
|
||||
catcrafts.net
|
||||
| `CODECS` | *(empty — defaults)* | comma-separated codec preference list over `AMR-WB`, `AMR` (or `AMR-NB`), `PCMA`, `PCMU`: restricts and orders both the codecs offered on an outgoing call and those accepted from an inbound offer (default: offer AMR-WB + AMR, accept all four in that order). A bench knob — a network whose gateway transcodes every caller up to AMR-WB otherwise never lets the narrowband path run |
|
||||
|
|
|
|||
Loading…
Reference in a new issue