# AT+COPS

The AT+COPS command allows users to check mobile carrier status and select carriers automatically or manually. Below is a guide to executing the AT+COPS command under the default Mobile-Data protocol with MMCLI command sets.

{% hint style="info" %}
Please turn the roaming function on before manually selecting the mobile carrier using the AT+COPS command. You can turn on/off mobile roaming under "Network > Interface > Mobile: Edit."
{% endhint %}

## Test Command

The AT+COPS test command returns five parameters, each representing an operator present in the network. Some formats may be unavailable, which means the fields will be empty.

```html
AT+COPS=?
```

{% code title="Response" overflow="wrap" %}

```html
+COPS: (supported <stat>, long <oper>, short <oper>, numeric <oper>s[<Act>])s][,(supported <mode>s), (supported <format>s)])
```

{% endcode %}

> MMCLI Example:
>
> **mmcli -m 2 --command=AT+COPS=?**
>
> +COPS: (2, "VODAFONE-DE", "VODAFONE", "26202", 7),(1, "Telefónica O2", "O2", "26203", 2),(3, "TELEKOM-DEUTSCHLAND", "TELEKOM", "26206", 7)

## Read Command

The AT+COPS read command returns the current mobile carrier and its mode. The format, operator, and access technology parameters are omitted from the response if no operator is connected.

```html
AT+COPS?
```

{% code title="Response" overflow="wrap" %}

```html
+COPS: <mode>[,<format>[,<oper>][,<Act>]]
```

{% endcode %}

> MMCLI Example:
>
> mmcli -m 2 --command=AT+COPS?
>
> +COPS: (2, "VODAFONE-DE", "VODAFONE", "26202", 7)

## Carrier Selection

The AT+COPS write command attempts to select and register with the specified network operator. If the selected operator is unavailable (unless mode 4 of automatic selection is set), no other operator will be selected. The format of the selected operator name will be used for subsequent AT+COPS read commands.

```html
AT+COPS=<mode>[,<format>[,<oper>[,<Act>]]]
```

{% code title="Response" overflow="wrap" %}

```html
''

// If there is any function error, returns:
<err>
```

{% endcode %}

> MMCLI Example of Select by Carrier's **Numbric** ID: \<format> 2
>
> mmcli -m 2 --command=AT+COPS=1,2,26202,7
>
> ' '\
> \
> We can also input the carrier's **short** name: \<format> 1&#x20;
>
> mmcli -m 2 --command=AT+COPS=1,1,Vodafone,7
>
> \
> If select by the carrier's **full** name, expecially when it has space or special characters, such as "-": \<format> 0
>
> mmcli -m 2 --command=AT+COPS=1,0,\\"Vodafone-DE\\",7

## Response Time

When the mobile signal is weak or unstable, the AT+COPS command can take a long time to execute before getting a response. Suggest adding the timeout parameter for test/read/write commands. The typical maximum response time is 180 seconds, determined by the actual mobile network.

> Example of Adding 120-Second Timeout for Test Command
>
> mmcli -m 2 --command=AT+COPS? --timeout=120

## Parameters

<table><thead><tr><th width="143">Parameter</th><th width="154">String / Integer</th><th>Description</th></tr></thead><tbody><tr><td>&#x3C;stat></td><td>0</td><td>Unknown</td></tr><tr><td></td><td>1</td><td>Operator available</td></tr><tr><td></td><td>2</td><td>Current operator</td></tr><tr><td></td><td>3</td><td>Operator forbidden</td></tr><tr><td>&#x3C;oper></td><td>String Type</td><td>Operator in format as per &#x3C;mode>.</td></tr><tr><td>&#x3C;mode></td><td>0</td><td>Automatic mode. field is ignored.</td></tr><tr><td></td><td>1</td><td>Manual operator selection. The field shall be present and optionally.</td></tr><tr><td></td><td>2</td><td>Manually deregister from network.</td></tr><tr><td></td><td>3</td><td>Set only (for AT+COPS? Read Command), and do not attempt registration/deregistration (and fields are ignored). This value is invalid in the response of Read Command.</td></tr><tr><td></td><td>4</td><td>The manual/automatic selection. The field shall be presented. If manual selection fails, automatic mode ( = 0) will be entered.</td></tr><tr><td>&#x3C;format></td><td>0</td><td>Long format alphanumeric, which can be up to 16 characters long.</td></tr><tr><td></td><td>1</td><td>Short format alphanumeric.</td></tr><tr><td></td><td>2</td><td>Numeric . Mobile operators MCC MNC number.</td></tr><tr><td>&#x3C;Act></td><td>Integer Type</td><td>Selected mobile network type. Values 4, 5, and 6 occur only in the response of Read Command, while MS is in a data service state and is not intended for the AT+COPS Write Command.</td></tr><tr><td></td><td>2</td><td>3G - UTRAN</td></tr><tr><td></td><td>4</td><td>3G - UTRAN W/HSDPA</td></tr><tr><td></td><td>5</td><td>3G - UTRAN W/HSUPA</td></tr><tr><td></td><td>6</td><td>3G - UTRAN W/HSDPA and HSUPA</td></tr><tr><td></td><td>7</td><td>4G - E-UTRAN</td></tr><tr><td></td><td>10</td><td>4G - E-UTRAN connected to a 5GCN</td></tr><tr><td></td><td>11</td><td>5G - 5GNR connect to 5GCN</td></tr><tr><td></td><td>12</td><td>5G - NG-RAN</td></tr><tr><td></td><td>13</td><td>4G &#x26; 5G - E-UTRAN_NR dual connectivity</td></tr></tbody></table>