Set RAN
Function: SET_RAN
The SET_RAN function is used to set the Radio Access Network (RAN) type on the test device. This function is essential for testing network compatibility and performance under different RAN types.
The step passes only after the device has attached on the selected RAN within TIMEOUT, so a separate IS_ATTACHED step straight afterwards is not needed. Use IS_ATTACHED later in the test when you want to re-check the network state. Selecting VOWIFI also cycles airplane mode and Wi-Fi.
Supported on: Android, iOS and MCM.
Parameters¶
| Parameter Name | Description | Example Values | Required | Default Value |
|---|---|---|---|---|
| RAN_TYPE | The Radio Access Network type to set. The step editor shows the labels in brackets; the API uses the values. | _2G (2G only), _3G (3G only), _3G_2G_AUTO (3G/2G Auto), _LTE (LTE only), _LTE_3G_2G_AUTO (LTE Auto), _5G (5G), VOLTE (VoLTE), VOWIFI (VOWIFI) |
Yes | _2G (2G only) |
| TIMEOUT | Maximum time to wait for the RAN change and the attachment before the step is considered failed. Whole seconds, 0-3700; there is no default. | Recommended 45 - 120 seconds |
Yes | |
| EXPECT | Expected result of the RAN change. Use SUCCESS when the device should switch successfully, or FAIL when testing a negative path. |
SUCCESS, FAIL |
Yes | SUCCESS |
The step editor pre-selects "2G only". In an API payload RAN_TYPE must be present: a step without it is rejected with 400 ("Missing required parameters"). The _LTE_3G_2G_AUTO (LTE Auto) that GET /api/v2/functionparams lists as its default is not filled in for you.
RAN Type Values¶
| UI Label | API / Internal Value |
|---|---|
| 2G only | _2G |
| 3G only | _3G |
| 3G/2G Auto | _3G_2G_AUTO |
| LTE only | _LTE |
| LTE Auto | _LTE_3G_2G_AUTO |
| 5G | _5G |
| VoLTE | VOLTE |
| VOWIFI | VOWIFI |
"LTE only" is not offered for iOS devices.