diff --git a/introspection/org.freedesktop.ModemManager1.Modem.Sar.xml b/introspection/org.freedesktop.ModemManager1.Modem.Sar.xml index 1c96617a..5acffc5f 100644 --- a/introspection/org.freedesktop.ModemManager1.Modem.Sar.xml +++ b/introspection/org.freedesktop.ModemManager1.Modem.Sar.xml @@ -12,7 +12,33 @@ org.freedesktop.ModemManager1.Modem.Sar: @short_description: The ModemManager dynamic SAR interface. - The SAR interface defines operations and properties for dynamic SAR. + 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 |