# gsmSignal

Set the GSM signal strength on the Android emulator.

> **Note:** Falls back to the deprecated Appium 2 protocol endpoint if the driver does not support the `mobile:` execute method.

## Usage[​](#usage "Direct link to Usage")

```
await browser.gsmSignal(signalStrength)
```

## Parameters[​](#parameters "Direct link to Parameters")

| Name             | Type     | Details                                                                                                                    |
| ---------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
| `signalStrength` | `number` | The signal strength to set. Accepted values: `0` (no signal), `1` (very poor), `2` (poor), `3` (moderate), `4` (good/full) |

## Example[​](#example "Direct link to Example")

gsmSignal.js

```
it('should set GSM signal to full strength', async () => {
    await browser.gsmSignal(4)
})
it('should set GSM signal to no signal', async () => {
    await browser.gsmSignal(0)
})
```

## Support[​](#support "Direct link to Support")

![Support for android](/assets/images/android-d941e94d5839760141de31c8446b67ce.svg)

**Supported platforms:** Android

note

Refer to the official [Appium driver documentation](https://appium.io/docs/en/latest/ecosystem/) to see which driver versions support this command.
