Files
ModemManager/introspection/org.freedesktop.ModemManager1.Sim.xml
T
Aleksander Morgado 86a183778b api,sim: new 'Active' property
In preparation for the multi-SIM setup, we need a way to tell whether
a given SIM card is active or not in the system.

On systems with one single SIM slot, the available SIM card will
always be active.

On Multi-SIM Single-Standby setups we may have multiple SIM slots with
multiple SIM cards, but only one of them will be active at any given
time.

On Multi-SIM Multi-Standby setups we may have multiple SIM slots with
multiple SIM cards that may be active at the same time. E.g. the QMI
protocol allows up to 5 different active SIM cards (primary,
secondary, tertiary...).
2020-08-28 14:59:06 +00:00

125 lines
3.3 KiB
XML

<?xml version="1.0" encoding="UTF-8" ?>
<!--
ModemManager 1.0 Interface Specification
Copyright (C) 2011-2013 Red Hat, Inc.
Copyright (C) 2011-2013 Google, Inc.
Copyright (C) 2011-2013 Lanedo GmbH
-->
<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">
<!--
org.freedesktop.ModemManager1.Sim:
@short_description: The ModemManager SIM interface.
The SIM interface handles communication with SIM, USIM, and RUIM (CDMA
SIM) cards.
-->
<interface name="org.freedesktop.ModemManager1.Sim">
<!--
SendPin:
@pin: A string containing the PIN code.
Send the PIN to unlock the SIM card.
-->
<method name="SendPin">
<arg name="pin" type="s" direction="in" />
</method>
<!--
SendPuk:
@puk: A string containing the PUK code.
@pin: A string containing the PIN code.
Send the PUK and a new PIN to unlock the SIM card.
-->
<method name="SendPuk">
<arg name="puk" type="s" direction="in" />
<arg name="pin" type="s" direction="in" />
</method>
<!--
EnablePin:
@pin: A string containing the PIN code.
@enabled: %TRUE to enable PIN checking, %FALSE otherwise.
Enable or disable the PIN checking.
-->
<method name="EnablePin">
<arg name="pin" type="s" direction="in" />
<arg name="enabled" type="b" direction="in" />
</method>
<!--
ChangePin:
@old_pin: A string containing the current PIN code.
@new_pin: A string containing the new PIN code.
Change the PIN code.
-->
<method name="ChangePin">
<arg name="old_pin" type="s" direction="in" />
<arg name="new_pin" type="s" direction="in" />
</method>
<!--
Active:
Boolean indicating whether the SIM is currently active.
On systems that support Multi SIM Single Standby, only one SIM may be
active at any given time, which will be the one considered primary.
On systems that support Multi SIM Multi Standby, more than one SIM may
be active at any given time, but only one of them is considered primary.
-->
<property name="Active" type="b" access="read" />
<!--
SimIdentifier:
The ICCID of the SIM card.
This may be available before the PIN has been entered depending
on the device itself.
-->
<property name="SimIdentifier" type="s" access="read" />
<!--
Imsi:
The IMSI of the SIM card, if any.
-->
<property name="Imsi" type="s" access="read" />
<!--
OperatorId:
The ID of the network operator that issued the SIM card,
formatted as a 5 or 6-digit MCC/MNC code (e.g. <literal>"310410"</literal>).
-->
<property name="OperatorIdentifier" type="s" access="read" />
<!--
OperatorName:
The name of the network operator, as given by the SIM card, if known.
-->
<property name="OperatorName" type="s" access="read" />
<!--
EmergencyNumbers:
List of emergency numbers programmed in the SIM card.
These numbers should be treated as numbers for emergency calls in
addition to 112 and 911.
-->
<property name="EmergencyNumbers" type="as" access="read" />
</interface>
</node>