| Top | |
|
|
|
org.freedesktop.ModemManager1.Modem.Sarorg.freedesktop.ModemManager1.Modem.Sar — The ModemManager dynamic SAR interface. |
Enable (IN b enable); SetPowerLevel (IN u level);
The SAR interface defines operations and properties for dynamic SAR, so that user applications can control the output power level dynamically.
Using the SAR interface is not trivial, and it requires prior knowledge of the internal SAR mapping table configured in each device.
The SAR mapping table is defined by the manufacturer of the device, and is usually setup to match a specific hardware setup (e.g. a specific laptop or hardware configuration). This table may provide different power levels for different frequency bands and/or antennas.
An example SAR mapping table, where all bands and antennas share the same level, could look like this:
| Power Level | LTE B3 | LTE B7 | LTE B20 |
| 0 | 26.0 dBm | 26.5 dBm | 27.0 dBm |
| 1 | 26.5 dBm | 27.0 dBm | 27.5 dBm |
| 2 | 27.0 dBm | 27.5 dBm | 28.0 dBm |
| 3 | 27.5 dBm | 28.0 dBm | 28.5 dBm |
| 4 | 28.0 dBm | 28.5 dBm | 28.5 dBm |
| 5 | 28.5 dBm | 28.5 dBm | 28.5 dBm |
In this example, the SAR mapping table has 6 different levels (0 to 5), and it's applied exclusively for LTE bands B3, B7 and B20 in all available antennas. None of this information is exposed to the user in the SAR interface, not even the amount of levels available.
Enable (IN b enable);
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.
Since: 1.20
|
|
SetPowerLevel (IN u level);
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.
Since: 1.20
|
Index of the SAR power level mapping table. |