Is Attached
Function: IS_ATTACHED
The IS_ATTACHED function is used to check if the test device is attached to the specified Radio Access Network (RAN). This function is essential for verifying network attachment and connectivity.
IS_ATTACHED reads the current state once and does not wait. If the network needs time to settle, put a WAIT step before it. It only reads the state and never changes the radio. SET_RAN already checks attachment itself, so use IS_ATTACHED for later re-checks.
Supported on: Android, iOS and MCM.
Parameters¶
| Parameter Name | Description | Example Values | Required | Default Value |
|---|---|---|---|---|
| RAN_TYPE | The Radio Access Network type to verify. 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) |
| EXPECT | Expected result of the attachment check. | 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.