summaryrefslogtreecommitdiff
path: root/introspection/org.freedesktop.ModemManager1.Modem.Oma.xml
blob: d697265e84b94c211022e2123c80b40074e2a206 (plain)
1
2
3
4
5
6
7
8
9
10
11
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
<?xml version="1.0" encoding="UTF-8" ?>

<!--
 ModemManager 1.0 Interface Specification

   Copyright (C) 2013 Google, Inc.
-->

<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">

  <!--
      org.freedesktop.ModemManager1.Modem.Oma:
      @short_description: The ModemManager Open Mobile Alliance interface.

      This interface allows clients to handle device management operations as
      specified by the Open Mobile Alliance (OMA).

      Device management sessions are either on-demand (client-initiated), or
      automatically initiated by either the device itself or the network.

      This interface will only be available once the modem is ready to be
      registered in the cellular network. 3GPP devices will require a valid
      unlocked SIM card before any of the features in the interface can be
      used.
  -->
  <interface name="org.freedesktop.ModemManager1.Modem.Oma">

    <!--
        Setup:
        @features: Bitmask of <link linkend="MMModemOmaFeature">MMModemOmaFeature</link> flags, specifying which device management features should get enabled or disabled. <link linkend="MM-OMA-FEATURE-NONE:CAPS">MM_OMA_FEATURE_NONE</link> will disable all features.

        Configures which OMA device management features should be enabled.

        Since: 1.2
    -->
    <method name="Setup">
      <arg name="features" type="u" direction="in" />
    </method>

    <!--
        StartClientInitiatedSession:
        @session_type: Type of client-initiated device management session,given as a <link linkend="MMModemOmaSessionType">MMModemOmaSessionType</link>

        Starts a client-initiated device management session.

        Since: 1.2
    -->
    <method name="StartClientInitiatedSession">
      <arg name="session_type" type="u" direction="in" />
    </method>

    <!--
        AcceptNetworkInitiatedSession:
        @session_id: Unique ID of the network-initiated device management session.
        @accept: Boolean specifying whether the session is accepted or rejected.

        Accepts or rejects a network-initiated device management session.

        Since: 1.2
    -->
    <method name="AcceptNetworkInitiatedSession">
      <arg name="session_id" type="u" direction="in" />
      <arg name="accept"     type="b" direction="in" />
    </method>

    <!--
        CancelSession:

        Cancels the current on-going device management session.

        Since: 1.2
    -->
    <method name="CancelSession" />

    <!--
        Features:

        Bitmask of <link linkend="MMModemOmaFeature">MMModemOmaFeature</link>
        flags, specifying which device management features are enabled or
        disabled.

        Since: 1.2
    -->
    <property name="Features" type="u" access="read" />

    <!--
        PendingNetworkInitiatedSessions:

        List of network-initiated sessions which are waiting to be accepted or
        rejected, given as an array of unsigned integer pairs, where:

        <variablelist>
          <varlistentry>
            <listitem>
              The first integer is a <link linkend="MMOmaSessionType">MMOmaSessionType</link>.
            </listitem>
          </varlistentry>
          <varlistentry>
            <listitem>
              The second integer is the unique session ID.
            </listitem>
          </varlistentry>
        </variablelist>

        Since: 1.2
    -->
    <property name="PendingNetworkInitiatedSessions" type="a(uu)" access="read" />

    <!--
        SessionType:

        Type of the current on-going device management session, given as a
        <link linkend="MMOmaSessionType">MMOmaSessionType</link>.

        Since: 1.2
    -->
    <property name="SessionType" type="u" access="read" />

    <!--
        SessionState:

        State of the current on-going device management session, given as a
        <link linkend="MMOmaSessionState">MMOmaSessionState</link>.

        Since: 1.2
    -->
    <property name="SessionState" type="i" access="read" />

    <!--
        SessionStateChanged:
        @old_session_state: Previous session state, given as a <link linkend="MMOmaSessionState">MMOmaSessionState</link>.
        @new_session_state: Current session state, given as a <link linkend="MMOmaSessionState">MMOmaSessionState</link>.
        @session_state_failed_reason: Reason of failure, given as a  <link linkend="MMOmaSessionStateFailedReason">MMOmaSessionStateFailedReason</link>, if @session_state is <link linkend="MM-OMA-SESSION-STATE-FAILED:CAPS">MM_OMA_SESSION_STATE_FAILED</link>.

        The session state changed.

        Since: 1.2
    -->
    <signal name="SessionStateChanged">
      <arg name="old_session_state"           type="i" />
      <arg name="new_session_state"           type="i" />
      <arg name="session_state_failed_reason" type="u" />
    </signal>

  </interface>
</node>