How to Update Firmware for WizarPOS Devices - Revision history

Mahong: Replaced content with "{{Migrating|https://smartpossdk.gitbook.io/cloudpossdk/faq/firmware/update-firmware}}"

2024-04-07T08:30:57Z

Replaced content with "{{Migrating|https://smartpossdk.gitbook.io/cloudpossdk/faq/firmware/update-firmware}}"

← Older revision		Revision as of 08:30, 7 April 2024
Line 1:		Line 1:
	~~== Overview ==~~		{{Migrating\|https://smartpossdk.gitbook.io/cloudpossdk/faq/firmware/update-firmware}}
	~~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 '[[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.
	~~:: [[File:firmwareintfcard.png\|none\|400px\|left\|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:'''
	~~[[File:q2tfcardlocation.png\|none\|300px\|left~~\|~~caption]]~~


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


	*'''TF-card Location in WizarHand Q1:'''
	~~[[File:Q1V2TFslot.png\|none\|300px\|left\|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 ==~~
	*For remote firmware updates, refer to the '[[How to Remotely Update Firmware]]' guide.
	~~== Using Application Interface ==~~
	* WizarPOS provides an AIDL interface for third-party applications to update system firmware.
	* Refer to the attached [http://~~ftp~~.~~wizarpos~~.~~com~~/~~advanceSDK~~/~~UpdateSystemDescription_1.1.docx documentation] and [http:~~//~~ftp.wizarpos.com/advanceSDK/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.~~

Mahong: /* Using Application Interface */

2024-02-18T06:07:14Z

Using Application Interface

← Older revision		Revision as of 06:07, 18 February 2024
Line 39:		Line 39:
	== Using Application Interface ==		== Using Application Interface ==
	* WizarPOS provides an AIDL interface for third-party applications to update system firmware.		* 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.		* Refer to the attached [http://ftp.wizarpos.com/advanceSDK/UpdateSystemDescription_1.1.docx documentation] and [http://ftp.wizarpos.com/advanceSDK/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.		'''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.

Simon no use at 23:49, 12 January 2024

2024-01-12T23:49:02Z

← Older revision		Revision as of 23:49, 12 January 2024
Line 36:		Line 36:
	* '''Note:''' This method is not applicable for Wizarhand Q1 models as the battery must be removed to insert the TF-Card.		* '''Note:''' This method is not applicable for Wizarhand Q1 models as the battery must be removed to insert the TF-Card.
	== Using WizarView ==		== Using WizarView ==
	*For remote firmware updates, refer to the '[[How to ~~update firmware remotely~~]]' guide.		*For remote firmware updates, refer to the '[[How to Remotely Update Firmware]]' guide.
	== Using Application Interface ==		== Using Application Interface ==
	* WizarPOS provides an AIDL interface for third-party applications to update system firmware.		* 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.		* 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.		'''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.

Simon no use: Simon moved page How to update firmware to How to Update Firmware for WizarPOS Devices: Normalize the title

2023-12-26T16:45:16Z

Simon moved page How to update firmware to How to Update Firmware for WizarPOS Devices: Normalize the title

← Older revision

Revision as of 16:45, 26 December 2023

Simon no use at 16:44, 26 December 2023

2023-12-26T16:44:08Z

← Older revision		Revision as of 16:44, 26 December 2023
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.

Mahong at 08:17, 3 November 2023

2023-11-03T08:17:11Z

← Older revision		Revision as of 08:17, 3 November 2023
Line 24:		Line 24:
	[[File:Q1V2TFslot.png\|none\|300px\|left\|caption]]		[[File:Q1V2TFslot.png\|none\|300px\|left\|caption]]

	== Using thumb ~~driver~~ ==		== Using thumb drive ==
	This feature requires the system application PosSysAssistant version is '''2.11.22''', old version can not update correctly:		This feature requires the system application PosSysAssistant version is '''2.11.22''', old version can not update correctly:
	* Create the folder "\cloudpos\image\" in the thumb ~~driver~~		* Create the folder "\cloudpos\image\" in the thumb drive
	* 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.		* 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.
	* Insert the thumb ~~driver~~ 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		* 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
	* 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.		* 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.
	* Please enter '''<big>Settings>About POS</big>''', and check the '''Build number''' and '''Kernel version''', they should be the new version number.		* Please enter '''<big>Settings>About POS</big>''', and check the '''Build number''' and '''Kernel version''', they should be the new version number.

Mahong: /* Using thumb driver */

2023-11-03T08:15:05Z

Using thumb driver

← Older revision		Revision as of 08:15, 3 November 2023
Line 26:		Line 26:
	== Using thumb driver ==		== Using thumb driver ==
	This feature requires the system application PosSysAssistant version is '''2.11.22''', old version can not update correctly:		This feature requires the system application PosSysAssistant version is '''2.11.22''', old version can not update correctly:
	* Create the folder "\cloudpos\image\" in the thumb ~~drive~~		* Create the folder "\cloudpos\image\" in the thumb driver
	* 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.		* 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.
	* Insert the thumb driver 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		* Insert the thumb driver 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

Mahong: /* Using thumb drive */

2023-11-03T08:14:30Z

Using thumb drive

← Older revision		Revision as of 08:14, 3 November 2023
Line 24:		Line 24:
	[[File:Q1V2TFslot.png\|none\|300px\|left\|caption]]		[[File:Q1V2TFslot.png\|none\|300px\|left\|caption]]

	== Using thumb ~~drive~~ ==		== Using thumb driver ==
	This feature requires the system application PosSysAssistant version is '''2.11.22''', old version can not update correctly:		This feature requires the system application PosSysAssistant version is '''2.11.22''', old version can not update correctly:
	* Create the folder "\cloudpos\image\" in the thumb drive		* Create the folder "\cloudpos\image\" in the thumb drive
	* 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.		* 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.
	* 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		* Insert the thumb driver 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
	* 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.		* 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.
	* Please enter '''<big>Settings>About POS</big>''', and check the '''Build number''' and '''Kernel version''', they should be the new version number.		* Please enter '''<big>Settings>About POS</big>''', and check the '''Build number''' and '''Kernel version''', they should be the new version number.

Mahong: /* Use TF-card (Terminal power off operation) */

2023-06-21T07:00:45Z

Use TF-card (Terminal power off operation)

← Older revision		Revision as of 07:00, 21 June 2023
Line 10:		Line 10:
	* Please enter '''<big>Settings>About POS</big>''', and check the '''Build number''' and '''Kernel version''', they should be the new version number.		* Please enter '''<big>Settings>About POS</big>''', and check the '''Build number''' and '''Kernel version''', they should be the new version number.

	TF-card Location in ~~WizarHand~~ Q2:		TF-card Location in Q2:
	[[File:q2tfcardlocation.png\|none\|300px\|left\|caption]]		[[File:q2tfcardlocation.png\|none\|300px\|left\|caption]]

Line 23:		Line 23:
	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 thumb drive ==		== Using thumb drive ==

Mahong at 02:48, 29 July 2022

2022-07-29T02:48:49Z

← Older revision		Revision as of 02:48, 29 July 2022
Line 22:		Line 22:

	TF-card Location in WizarHand Q1:		TF-card Location in WizarHand Q1:
	[[File:~~q1tfcardlocation~~.png\|none\|300px\|left\|caption]]		[[File:Q1V2TFslot.png\|none\|300px\|left\|caption]]