# Update Firmware

### Overview

This guide details the methods to update the firmware on WizarPOS devices. Ensure that the firmware package is obtained from WizarPOS. Here are the Methods of Updating Firmware.

### Using a TF-Card (When Terminal is Off)

* Preparation:
  * Format a 4G to 16G TF-Card to FAT32 and name the folder 'wizarpos' (in lowercase). Refer to [TF(Micro SD)  Card Suggestion](/cloudpossdk/faq/hardware-repair/tf-micro-sd-card-suggestion.md) for compatible card types.
  * Ensure the folder structure on your TF-Card matches the example provided

    <figure><img src="/files/pZTyMhYoS8ieyMCm2dAs" alt=""><figcaption></figcaption></figure>
* Update Process:
  * Power off the terminal and remove the battery.
  * Insert the prepared TF-Card into the terminal.
  * Power on the terminal. The update will commence automatically.
  * After the update, the terminal restarts. Verify the update by checking the 'Build number' and 'Kernel version' in 'Settings > About POS'.
* TF-card Location in Q2

<img src="/files/J3HE2ElRterOiz9V3Ljr" alt="" data-size="original"><br>

* TF-card Location in WizarPOS Q3

<div align="left"><figure><img src="/files/7Ofr0DKZAEkZPQSK2NG0" alt=""><figcaption></figcaption></figure></div>

* TF-card Location in WizarHand Q1

<div align="left"><figure><img src="/files/N26kqLMSacJjiZjWqd41" alt=""><figcaption></figcaption></figure></div>

### Using a Thumb Drive

* Requirements:
  * Ensure the PosSysAssistant application version is at least 2.11.22.
* Preparation:
  * Create a directory "\cloudpos\image" on the thumb drive.
  * Depending on the firmware package's root folder, copy the 'xxx.zip' file accordingly (refer to detailed instructions).
* Update Process:

  * Connect the thumb drive to the terminal using an OTG-USB host converter.

  <div align="left"><figure><img src="/files/AFTtlwJwTR41Q0JwAQvz" alt="" width="119"><figcaption><p>thumb drive</p></figcaption></figure></div>

  <div align="left"><figure><img src="/files/eiW7Luiu6iifXzQ2FG0o" alt="" width="125"><figcaption><p>otg-usb convertor</p></figcaption></figure></div>

  * Click system update to select the firmware file from the pop-up message.
  * Click Confirm to copy the firmware to internal storage, restart the terminal to apply the update.
  * Verify the update in 'Settings > About POS'.

### Using a TF-Card (When Terminal is On)

* Follow the same steps as the thumb drive method.
* Note: This method is not applicable for Wizarhand Q1 models as the battery must be removed to insert the TF-Card.

### Using WizarView

* For remote firmware updates, refer to [Update Firmware](/cloudpossdk/faq/tms-wizarview/update-firmware-remotely.md)[ Remotely](/cloudpossdk/faq/tms-wizarview/update-firmware-remotely.md).

### Using Application Interface

* WizarPOS provides an AIDL interface for third-party applications to update system firmware.
* Refer to the attached [documentation](https://ftp.wizarpos.com/advanceSDK/UpdateSystemDescription_1.1.docx) and [Demo](https://github.com/SmartPOSSamples/SystemUpdateTest) for guidance. Note that the firmware system package must be obtained from WizarPOS.

Post-Update Verification：After any update method, confirm the new 'Build number' and 'Kernel version' in 'Settings > About POS' to ensure the update was successful.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://smartpossdk.gitbook.io/cloudpossdk/faq/firmware/update-firmware.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.