The set command enables the RF transmitter.
CAUTION:
This command transmits power to the selected RF band and can violate the
radio directives of the region or country. Make sure that the equipment is in an RF-shielded
room or connected to an RF cable so that RF power does not leak.
Syntax:
%XRFTEST=<test>,<operation>[,<param0>,<param1>,…,<param10>]
The set command parameters and their defined values are the following:
- <test>
- 1 – TX.
- <operation>
- 1 – ON.
- 0 – OFF.
Note: Always send OFF <operation>
before sending another ON <operation>.
- <param0>
- 3GPP band number.
- <param1>
- Frequency (100 kHz).
- Valid range 6000–22000 (corresponds to 600.0 MHz–2200.0 MHz).
- <param2>
- TX signal power at the System in Package (SiP) antenna port.
- Valid range from +23 dBm to −50 dBm.
- <param3>
- System mode.
Valid range 0–1. Narrowband Internet of Things (NB-IoT) (0) or
LTE-M (1).
- <param4>
- Modulation.
- 0 – Quadrature Phase-Shift Keying (QPSK).
- 1 – 16-state Quadrature Amplitude Modulation (16-QAM).
- 2 – Reserved.
- 3 – Binary Phase-Shift Keying (BPSK).
- 4 – Carrier Wave (CW).
- LTE-M: QPSK, 16-QAM, and CW.
- NB-IoT: QPSK, BPSK, and CW.
-
Note:
- If <param4> is 4 (CW), in system modes NB-IoT and LTE-M the CW tone is offset
by 255 kHz from the frequency given in <param1>.
v1.0.x
v1.1.x
v1.2.x
- If <param4> is 4 (CW), the CW tone is offset from the
frequency given in <param1> by 48.75 kHz in system mode
NB-IoT and by 401.25 kHz in system mode LTE-M.
v1.2.x≥1
pti_v1.1.x≥1
- If <param4> is 4 (CW), <param5>,
<param6>, and <param7> are 0 (do
not care).
- <param5>
- Resource Block (RB)/Tone count.
- <param6>
- RB/Tone start position.
- <param7>
- Subcarrier spacing.
- 0 – 15 k.
- 1 – 3.75 k.
- <param8>v1.2.x
- System bandwidth.
- 0 – NB-IoT.
- 1 – 1.4 M.
- 2 – Reserved.
- 3 – 5 MHz.
- 4 to 6 – Reserved.
- <param9>v1.2.x
- Narrowband index.
- 0 – 1.4 M.
- 0 to 3 – 5 M.
- Defined in 3GPP TS 36.211 Ch.
6.2.7.
Note: <param9> has effect only when
<param8> is 3 (5 MHz).
- <param10>
v1.2.x≥1
pti_v1.1.x≥1
- TX burst mode.
- 0 – Disable TX burst mode.
- 1 – Enable TX burst mode.
- For more information, see TX burst mode.
The allowed combinations for <param5>,
<param6>, and <param7> for both system
mode (<param3>) values are listed in the following table:
Table 1. Allowed parameter combinations for <param5>, <param6>, and <param7> in
system modes NB-IoT and LTE-M
| System mode <param3> |
RB/Tone count <param5> |
RB/Tone start position <param6> |
Subcarrier spacing <param7> |
| NB-IoT (0) |
1 |
0–11 |
0 |
| 3 |
0, 3, 6, 9 |
0 |
| 6 |
0, 6 |
0 |
| 12 |
0 |
0 |
| 1 |
0–47 |
1 |
| LTE-M (1) |
1 |
0–5 |
0 |
| 2 |
0–4 |
0 |
| 3 |
0–3 |
0 |
| 4 |
0–2 |
0 |
| 5 |
0–1 |
0 |
| 6 |
0 |
0 |
Note: In system mode LTE-M, subcarrier spacing 3.75 kHz is not allowed.
Response syntax when <operation> is ON and TX burst mode is
disabled:
%XRFTEST: <antenna_power>
The response parameter and its defined value are the following:
- <antenna_power>
- Internally measured TX power at the SiP antenna port in q4 dBm. q4 means that dividing
the result by 24 = 16 gives dBm.
The following command example enables the RF transmitter for Band 5, 830.0 MHz, +17 dBm,
NB-IoT, BPSK, 12 tones, tone start position 0, subcarrier spacing 15 kHz, system bandwidth
NB1, NB index 0, TX burst mode disabled:
AT%XRFTEST=1,1,5,8300,17,0,3,12,0,0,0,0,0
%XRFTEST: 271 OK
Note: 271/16 = 16.9 dBm
The following command example enables the RF transmitter for Band 5, 830 MHz, +17 dBm,
LTE-M, 16-QAM, 6 RB, RB start position 0, subcarrier spacing 15 kHz, system bandwidth 5 MHz,
NB index 3, TX burst mode disabled:
AT%XRFTEST=1,1,5,8300,17,1,1,6,0,0,3,3,0
%XRFTEST: 271
OK
The following command example disables the RF transmitter:
AT%XRFTEST=1,0
OK