aboutsummaryrefslogtreecommitdiff
path: root/introspection/org.freedesktop.ModemManager1.Modem.Sar.xml
blob: 1c96617a866690037bd1c77bcdd8f8ae6c9ffcfd (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
<?xml version="1.0" encoding="UTF-8" ?>

<!--
 ModemManager 1.0 Interface Specification

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

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

  <!--
      org.freedesktop.ModemManager1.Modem.Sar:
      @short_description: The ModemManager dynamic SAR interface.

      The SAR interface defines operations and properties for dynamic SAR.
  -->
  <interface name="org.freedesktop.ModemManager1.Modem.Sar">

    <!--
        Enable:
        @enable: %TRUE to enable dynamic SAR and %FALSE to disable it.

        Enable or disable dynamic SAR.

        When enabled, the modem's output power level can be dynamically updated
        by the host.

        When disabled, the modem's output power level is dynamically updated
        exclusively by the device.
    -->
    <method name="Enable">
      <arg name="enable" type="b" direction="in" />
    </method>

    <!--
        SetPowerLevel:
        @level: Index of the SAR power level mapping table.

        Set current dynamic SAR power level for all antennas on the device.

        Please check with your modem vendor for detailed description on the
        number of levels and corresponding power output for each level.

        The index set here will apply to all antennas on the system.
    -->
    <method name="SetPowerLevel">
      <arg name="level" type="u" direction="in" />
    </method>

    <!--
        State:

        Boolean indicating whether dynamic SAR is currently enabled.
    -->
    <property name="State" type="b" access="read" />

    <!--
        PowerLevel:

        Current index of the SAR power level mapping table that is being used
        for setting the output power of all antennas on the system.
    -->
    <property name="PowerLevel" type="u" access="read" />

  </interface>
</node>