How to Update Firmware for WizarPOS Devices: Difference between revisions

From wizarPOS
No edit summary
No edit summary
Line 1: Line 1:
== Use TF-card (Terminal power off operation)==
== Overview ==
* After the firmware package is decompressed, copy the wizarpos folder to the root directory of a 4G to 16g TF-Card in FAT32 format, see also [[Recommended_TF_Card]]. Please confirm that the folder structure in your TF-card is as shown in the figure below, and the letters of the folder name should be lowercase.
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.
[[File:firmwareintfcard.png|none|400px|left|caption]]
== 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 '[[How to Select Optimal TF Card (Micro SD Card) for Smart POS Systems]]' for compatible card types.
 
** Ensure the folder structure on your TF-Card matches the example provided.
* Turn off the power supply; turn on the back of the terminal and remove the battery; install the TF-card.  
:: [[File:firmwareintfcard.png|none|400px|left|caption]]
* Turn on the terminal power, and the terminal will update automatically.
* '''Update Process:'''
* After the update process is completed, the terminal will restart automatically.
** Power off the terminal and remove the battery.
* Please enter '''<big>Settings>About POS</big>''', and check the '''Build number''' and '''Kernel version''', they should be the new version number.
** Insert the prepared TF-Card into the terminal.
 
** Power on the terminal. The update will commence automatically.
  TF-card Location in Q2:
** 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:'''
[[File:q2tfcardlocation.png|none|300px|left|caption]]
[[File:q2tfcardlocation.png|none|300px|left|caption]]




 
*'''TF-card Location in WizarPOS Q3:'''
 
  TF-card Location in WizarPOS Q3:
[[File:Q3tfupdate.png|none|300px|left|caption]]
[[File:Q3tfupdate.png|none|300px|left|caption]]




 
*'''TF-card Location in WizarHand Q1:'''
  TF-card Location in WizarHand Q1:
[[File:Q1V2TFslot.png|none|300px|left|caption]]
[[File:Q1V2TFslot.png|none|300px|left|caption]]
 
== Using a Thumb Drive ==
== Using thumb drive ==
* '''Requirements:'''
This feature requires the system application PosSysAssistant version is '''2.11.22''', old version can not update correctly:
** Ensure the PosSysAssistant application version is at least 2.11.22.
* Create the folder "\cloudpos\image\" in the thumb drive
* '''Preparation:'''
* When get firmware package from Wizarpos, please check the root folder in the xxx.zip, if it is wizarpos, then copy the firmware zip package xxx.zip, if it is cloudpos, please unzip it, copy xxx.zip in \cloudpos\image\ to the the folder which created at Step 1.
** Create a directory "\cloudpos\image" on the thumb drive.
* Insert the thumb drive into the terminal through the OTG-USB host converter, a message window will pop up, and select the firmware to be installed. The default setting is selected
** Depending on the firmware package's root folder, copy the 'xxx.zip' file accordingly (refer to detailed instructions).
* When you click OK, the new firmware is copied to internal storage. After processing, a success window will pop up. Please restart the terminal and the terminal will update to the new firmware.
* '''Update Process:'''
* Please enter '''<big>Settings>About POS</big>''', and check the '''Build number''' and '''Kernel version''', they should be the new version number.
** Connect the thumb drive to the terminal using an OTG-USB host converter.
 
** Select the firmware file from the pop-up message.
== Use TF-Card (Terminal power on operation) ==
** After copying the firmware to internal storage, restart the terminal to apply the update.
The operation steps are the same as those of the thumb drive above. By the way, you can't use this method in wizarhand Q1, because you need to remove the battery in Q1 to plug in the TF-card.
** Verify the update in 'Settings > About POS'.
 
== Using a TF-Card (When Terminal is On) ==
== Use WizarView==
* Follow the same steps as the thumb drive method.
Please refer to: [[How to update firmware remotely]]
* '''Note:''' This method is not applicable for Wizarhand Q1 models as the battery must be removed to insert the TF-Card.
 
== Using WizarView ==
== Use Application Interface ==
*For remote firmware updates, refer to the '[[How to update firmware remotely]]' guide.
WizarPOS have defined an AIDL interface to help the third party application updating system firmware. Please look at the attachment doc and get [[http://ftp.wizarpos.com/SystemUpdateTest.zip the demo]]. But the firmware system package must get from wizarPOS.
== Using Application Interface ==
[[http://ftp.wizarpos.com/UpdateSystemDescription_1.1.docx Document]].
* WizarPOS provides an AIDL interface for third-party applications to update system firmware.
* Refer to the attached [http://ftp.wizarpos.com/UpdateSystemDescription_1.1.docx documentation] and [http://ftp.wizarpos.com/SystemUpdateTest.zip Demo] 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.

Revision as of 16:44, 26 December 2023

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)

caption
  • 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:
caption


  • TF-card Location in WizarPOS Q3:
caption


  • TF-card Location in WizarHand Q1:
caption

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.
    • Select the firmware file from the pop-up message.
    • After copying 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

Using Application Interface

  • WizarPOS provides an AIDL interface for third-party applications to update system firmware.
  • Refer to the attached documentation and Demo 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.

Retrieved from "http://sdkwiki.wizarpos.com/index.php?title=How_to_Update_Firmware_for_WizarPOS_Devices&oldid=3520"