# 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](https://smartpossdk.gitbook.io/cloudpossdk/faq/hardware-repair/tf-micro-sd-card-suggestion) for compatible card types.
  * Ensure the folder structure on your TF-Card matches the example provided

    <figure><img src="https://3254882245-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTv6FkzHXX8QyxZpeenq6%2Fuploads%2F9wqkJReIiQ5zk2jLLWMG%2Fimage.png?alt=media&#x26;token=ea0eb182-ee99-4919-86cf-715e9b23d498" 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="https://3254882245-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTv6FkzHXX8QyxZpeenq6%2Fuploads%2FKXva0LKfYfyOLj7bXYUo%2Fimage.png?alt=media&#x26;token=14c804c4-6d6a-4d5d-be9b-a57b34e308ba" alt="" data-size="original"><br>

* TF-card Location in WizarPOS Q3

<div align="left"><figure><img src="https://3254882245-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTv6FkzHXX8QyxZpeenq6%2Fuploads%2F3bZN8lciddGrI9iTmMLp%2Fimage.png?alt=media&#x26;token=24d64720-00dd-4ca0-83ff-0eb784283ea4" alt=""><figcaption></figcaption></figure></div>

* TF-card Location in WizarHand Q1

<div align="left"><figure><img src="https://3254882245-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTv6FkzHXX8QyxZpeenq6%2Fuploads%2FVE1g58HAYpQYntAStofl%2Fimage.png?alt=media&#x26;token=5aece90a-76d0-424f-abbf-22055a9db796" 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="https://3254882245-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTv6FkzHXX8QyxZpeenq6%2Fuploads%2FKqIgYfre7r85LTc3afM7%2Fimage.png?alt=media&#x26;token=5257c8b7-96cb-44c6-9892-bcd651c58cb5" alt="" width="119"><figcaption><p>thumb drive</p></figcaption></figure></div>

  <div align="left"><figure><img src="https://3254882245-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTv6FkzHXX8QyxZpeenq6%2Fuploads%2F0AgE3mkbkztkm6vwiqOj%2Fimage.png?alt=media&#x26;token=acbf5dae-a9d4-4d7d-8b81-93e101129dcf" 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](https://smartpossdk.gitbook.io/cloudpossdk/faq/tms-wizarview/update-firmware-remotely)[ Remotely](https://smartpossdk.gitbook.io/cloudpossdk/faq/tms-wizarview/update-firmware-remotely).

### 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.