The set command writes the MAGPIO configuration to device's RAM memory.
The command configuration is stored to Non-volatile Memory (NVM) approximately every 48 hours and when the modem is powered off with the
+CFUN=0
command. The configuration can be stored to NVM with the %XFSSYNC
command when the Production Test Image (PTI) modem firmware is
used. The
stored configuration is applied when the device is powered on.
This command has been updated in v0.7.1 of this document. The earlier format described in v0.7 of this document is still valid, but the new format is recommended.
Syntax:
%XMAGPIO=<gpio_0>,<gpio_1>,<gpio_2>,<num_ranges>,<state_0>,<flo_0>,<fhi_0><state_1>,<flo_1>,
<fhi_1>,...
A command without any parameters deletes the previously written values.
The set command parameters and their defined values are the following:
The following table contains an example configuration for an antenna tuner:
State | MAGPIO2 | MAGPIO1 | MAGPIO0 | Low MHz | High MHz | |
---|---|---|---|---|---|---|
Unused | 0 | 0 | 0 | 0 | - | - |
LTE(746–803) | 1 | 0 | 0 | 1 | 746 | 803 |
LTE(698–746) | 2 | 0 | 1 | 0 | 698 | 746 |
LTE(1710–2200) | 2 | 0 | 1 | 0 | 1710 | 2200 |
LTE(849–894) | 3 | 0 | 1 | 1 | 849 | 894 |
LTE(894–960) | 4 | 1 | 0 | 0 | 894 | 960 |
Unused | 5 | 1 | 0 | 1 | - | - |
LTE(803–849) | 6 | 1 | 1 | 0 | 803 | 849 |
GNSS | 7 | 1 | 1 | 1 | 1574 | 1577 |
The following command example writes seven ranges to device's RAM:
AT%XMAGPIO=1,1,1,7,1,746,803,2,698,746,2,1710,2200,3,849,894,4,894,960,6,803,849,7,
1574,1577
OK
The following command example writes three ranges to device's RAM:
AT%XMAGPIO=1,1,1,3,0,1574,1577,1,705,747,6,748,804
OK
The following command example deletes the previously written values:
AT%XMAGPIO
OK