D-Bus-examples.md

@@ -96,6 +96,18 @@ i = dbus.Interface(obj, 'org.freedesktop.DBus.Properties')
 i.GetAll('org.freedesktop.ModemManager1.Sms') 
 ```
 
+## Making a Phone Call
+
+The [ModemManager Voice API](https://www.freedesktop.org/software/ModemManager/api/latest/gdbus-org.freedesktop.ModemManager1.Modem.Voice.html) can be used to make calls on a modem-enabled phone with an unlocked SIM. For example, if the modem appears as the `3` node beneath `/org/freedesktop/ModemManager1/Modem` then a call can be started with the following command:
+```
+sudo gdbus call --system \
+                --dest org.freedesktop.ModemManager1 \
+                --object-path /org/freedesktop/ModemManager1/Modem/3 \
+                --method org.freedesktop.ModemManager1.Modem.Voice.CreateCall "{'number': <'********'>}"
+```
+
+See [this thread](https://forums.puri.sm/t/phone-call-api/8433) for context.
+
 ## Using Applications to Provide Services
 
 GNOME applications run using the `--gapplication-service` command line option will expose the [org.freedesktop.Application](https://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#dbus) interface on the session bus. This can be accessed to launch the application and request that it open files specified with URIs. The parameters of the API are explained by [this GApplication D-Bus APIs document](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI) which refers to a different interface but which seems to overlap with the freedesktop interface.