# OTA AT commands

Source: [https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html](https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html)

Table : OTA AT commands

| Command | Description |
| --- | --- |
| [AT+OTAFWUP](https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html#at_otafwup) | Start the OTA process |
| [AT+OTATRIAL](https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html#at_otatrial) | Accept/reject downloaded images |

Note: These commands only apply to hostless SBL with external flash.

## AT+OTAFWUP

Source: [https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html](https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html)

This command starts the OTA process.

### Operation type

Execution

### Syntax

| Command | Response |
| --- | --- |
| AT+OTAFWUP=&lt;protocol&gt;,&lt;url&gt;,&lt;fw filename&gt;,[flag],[timeout],[size] | OK/ERROR<br><br><br>                                <br>Event:<br><br><br>                                <br>+EVT:OTAFWUP\_START: This indicates that the OTA process is started.<br><br><br>                                <br>+EVT:OTAFWUP\_ERROR: This indicates that something goes wrong in the OTA process. [^1^](https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html#fntarg_1_at_otafwup)<br><br><br>                                <br>+EVT:OTAFWUP\_FIN: This indicates that the OTA process is done. [^2^](https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html#fntarg_2_at_otafwup) |

[^1^](https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html#fnsrc_1_at_otafwup)  An error code is included in this message. You can find the meaning of the error code in the ota\_http.h and fw\_upgrade\_mem.h header files. For example, error code `-110105` indicates that the HTTP connection fails. In this case, check the HTTP connection and try the OTA operation again.

[^2^](https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html#fnsrc_2_at_otafwup)  In rare cases, the host may not receive this message after the OTA process has started for a long time, although OTA should complete quickly (depending on the network environment). This issue may occur if the `auto-reboot` flag is set and the DUT reboots before it sends the message to the SPI host. In this scenario, to verify whether the OTA process has been successful, use the `AT+OTATRIAL` command to try to accept the trial image. If the OTA process is successful, the command returns `AT+OTATRIAL:Success to Accept Trial FWD`. Otherwise, the command returns `AT+OTATRIAL: Fail to Accept Trial FWD`.

### Defined values

- `<protocol>`: The protocol of transmission process
- `<url>`: The URL of the HTTP/HTTPS server
- `<fw filename>`: The filename of the OTA binary file
- `[flag]`: Optional. This is a bitmask that specifies the operations to perform during the OTA process. Set the corresponding bit to `1`to enable the corresponding operation:
    - Bit 0: Auto reboot (default value)
    - Bit 1: Duplicate FS
    - Bit 2: HTTP GET with range headers

        When bit 2 is set to `1`, each HTTP GET request includes a range header and downloads 512 bytes of the image specified by that header. When a timeout occurs, the HTTP GET request is sent again. OTA fails when the second timeout happens. Currently, this option only supports all-in-one OTA.

    **Example**:

    The following command duplicates FS and reboots the device after the download completes:

        AT+OTAFWUP=http,"<url>","ota.bin",3Copy to clipboard
- `[timeout]`: HTTP GET timeout in milliseconds. The OTA process fails if no data is received within the specified timeout period. The default value is `20000` (20 seconds). This argument is necessary when using HTTP GET with range headers.
- `[size]`: This argument is necessary when using HTTP GET with range headers. To determine the file size, use the `AT+HTTPGETSIZE` command.

## AT+OTATRIAL

Source: [https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html](https://docs.qualcomm.com/doc/80-Y8730-7/topic/ota_at_commands.html)

This command accepts/rejects the downloaded images

### Operation type

Execution

### Syntax

| Command | Response |
| --- | --- |
| AT+OTATRIAL=&lt;1|0(accept|reject)&gt;,&lt;reboot\_flag&gt; | For accept:<br><ul class="ul" id="at_otatrial__ul_b2c_djs_gfc"><br>                                    <li class="li"><br>                                        <p class="p">AT+OTATRIAL:Success to Accept Trial FWD</p><br><br>                                        <p class="p">OK</p><br><br>                                    </li><br><br>                                    <li class="li"><br>                                        <p class="p">AT+OTATRIAL:Fail to Accept Trial FWD</p><br><br>                                        <p class="p">ERROR</p><br><br>                                    </li><br><br>                                </ul><br><br>                                <br>For reject:<br><ul class="ul" id="at_otatrial__ul_mx1_fjs_gfc"><br>                                    <li class="li"><br>                                        <p class="p">AT+OTATRIAL:Success to Reject Trial FWD</p><br><br>                                        <p class="p">OK</p><br><br>                                    </li><br><br>                                    <li class="li"><br>                                        <p class="p">AT+OTATRIAL:Fail to Reject Trial FWD</p><br><br>                                        <p class="p">ERROR</p><br><br>                                    </li><br><br>                                </ul> |

### Defined values

- `<1|0(accept|reject)>`:
    - `1`: Accept
    - `0`: Reject
- `<reboot_flag>`:
    - `1`: Reboot
    - `0`: Don't reboot

Last Published: Jul 30, 2026

[Previous Topic
HTTP server AT commands](https://docs.qualcomm.com/bundle/publicresource/80-Y8730-7/topics/http_server_at_commands.md)