aboutsummaryrefslogtreecommitdiff
path: root/introspection
diff options
context:
space:
mode:
authorAleksander Morgado <aleksander@aleksander.es>2020-08-01 09:59:37 +0200
committerAleksander Morgado <aleksander@aleksander.es>2020-08-28 14:59:06 +0000
commit924cf1af3c5e1aec1df680d50e4b9ae6dd8e0ba9 (patch)
tree48c1492b1412ca81b3e0abfc860d55a60a5d47cd /introspection
parent5041b9c99b8587185b629715e3466d31a619abf3 (diff)
api,modem: new 'SetPrimarySimSlot' method
This new method allows changing the SIM slot considered as primary, when the modem supports multiple SIM slots. The generic handling of this method will make sure that the modem object and all its SIM objects are re-probed from scratch as soon as a successful SIM slot switch happens. Implementations may report MM_CORE_ERROR_EXISTS when the switch doesn't need to happen (e.g. if the requested SIM slot is already the active one).
Diffstat (limited to 'introspection')
-rw-r--r--introspection/org.freedesktop.ModemManager1.Modem.xml18
1 files changed, 18 insertions, 0 deletions
diff --git a/introspection/org.freedesktop.ModemManager1.Modem.xml b/introspection/org.freedesktop.ModemManager1.Modem.xml
index 9b8d2d6d..d9dbd436 100644
--- a/introspection/org.freedesktop.ModemManager1.Modem.xml
+++ b/introspection/org.freedesktop.ModemManager1.Modem.xml
@@ -183,6 +183,24 @@
</method>
<!--
+ SetPrimarySimSlot:
+ @sim_slot: SIM slot number to set as primary.
+
+ Selects which SIM slot to be considered as primary, on devices that expose
+ multiple slots in the #org.freedesktop.ModemManager1.Modem:SimSlots property.
+
+ When the switch happens the modem may require a full device reprobe, so the modem
+ object in DBus will get removed, and recreated once the selected SIM slot is in
+ use.
+
+ There is no limitation on which SIM slot to select, so the user may also set as
+ primary a slot that doesn't currently have any valid SIM card inserted.
+ -->
+ <method name="SetPrimarySimSlot">
+ <arg name="sim_slot" type="u" direction="in" />
+ </method>
+
+ <!--
Command:
@cmd: The command string, e.g. "AT+GCAP" or "+GCAP" (leading AT is inserted if necessary).
@timeout: The number of seconds to wait for a response.