Exit Codes; If The Update Is Not Successful - Lightware UMX-TPS-TX120 User Manual


  
8. Firmware Update
[2021-05-14 14:40:50.179] [ INFO] [ 192.168.1.14] - [tps_family_ps171.bin]'s version in the package: 1.0.6b0
r522
[2021-05-14 14:41:06.386] [ INFO] [ 192.168.1.14] - [tps_family_ps171.bin]'s firmware version updated in FVS
EEPROM.
[2021-05-14 14:41:12.514] [ INFO] [ 192.168.1.14] - Setting system information...
[2021-05-14 14:41:18.637] [ INFO] [ 192.168.1.14] - Starting application...
[2021-05-14 14:43:03.605] [ INFO] [ 192.168.1.14] - Waiting for VS100...
[2021-05-14 14:43:05.237] [ INFO] [ 192.168.1.14] - Restoring device settings from the following backup file:
c:\My_backup\backup_91540050_00006363_2021-05-14_14-39-28_converted.lw3 ...
[2021-05-14 14:43:14.325] [ INFO] [ 192.168.1.14] - Device settings have been restored
[2021-05-14 14:43:14.358] [ INFO] [ 192.168.1.14] - Resetting device...
[2021-05-14 14:43:19.071] [ INFO] [ 192.168.1.14] - Done
All 1 update(s) finished successfully.
Example 3
The following options applied:
Cleartext login password is applied
▪
Custom backup folder is set
▪
Current configuration is saved
▪
Firmware is not updated but the process and the connection is tested
▪
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>LightwareDeviceUpdaterV2_CLI.cmd update --test --ip
192.168.1.14 --package c:\Firmwares\umx-tps-tx100_v1.5.0b4.lfp2 --backupFolder c:\My_backup --clearTextLoginPw
qwer1234
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>lib\jre\bin\java.exe -jar lib\ldu2.jar update --test
--ip 192.168.1.14 --package c:\Firmwares\umx-tps-tx100_v1.5.0b4.lfp2 --backupFolder c:\My_backup --clearTextLoginPw
qwer1234
[2021-05-14 14:45:37.351] [ INFO] [
[2021-05-14 14:45:40.396] [ WARN] [ pool-2-thread-1] - NetworkMask property is not available. Cannot determine
whether the device is on the same network or not.
[2021-05-14 14:45:40.481] [ WARN] [ pool-2-thread-1] - Bonjour device builder error messages: [object Array]
[2021-05-14 14:45:40.551] [ INFO] [
[2021-05-14 14:45:40.748] [ INFO] [
package.
[2021-05-14 14:45:41.347] [ INFO] [ 192.168.1.14] - PASSED - Test #01 - Communication over LW3
[2021-05-14 14:45:41.427] [ INFO] [ 192.168.1.14] - PASSED - Test #02 - Cleartext login - PW is correct
[2021-05-14 14:45:41.474] [ INFO] [ 192.168.1.14] - Creating backup of device settings...
[2021-05-14 14:45:45.010] [ INFO] [ 192.168.1.14] - Backup HTTP enable properties
[2021-05-14 14:45:47.417] [ INFO] [ 192.168.1.14] - HTTP and HTTP post have got enabled on port 80
[2021-05-14 14:45:47.620] [ INFO] [ 192.168.1.14] - No miniweb file is found on the device.
[2021-05-14 14:45:50.058] [ INFO] [ 192.168.1.14] - HTTP and HTTP post properties have got restored on port 80
[2021-05-14 14:45:50.060] [ INFO] [ 192.168.1.14] - PASSED - Test #03 - Configuration and/or device preset
backup created
[2021-05-14 14:45:50.080] [ INFO] [ 192.168.1.14] - Switching device into bootload mode...
[2021-05-14 14:45:51.721] [ INFO] [ 192.168.1.14] - PASSED - Test #04 - Switch device into bootloader mode
[2021-05-14 14:46:09.050] [ INFO] [ 192.168.1.14] - PASSED - Test #05 - Communication with bootloader
[2021-05-14 14:46:09.063] [ INFO] [ 192.168.1.14] - Gathering UID information from device...
[2021-05-14 14:46:09.403] [ INFO] [ 192.168.1.14] - PASSED - Test #06 - TFTP file transfer
[2021-05-14 14:46:22.638] [ INFO] [ 192.168.1.14] - PASSED - Test #07 - Start application FW
[2021-05-14 14:46:22.681] [ INFO] [ 192.168.1.14] - Done
All 1 update(s) finished successfully.
main] - Device IPs: [192.168.1.14]
main] - All the selected devices are accessible over the network.
main] - All the selected devices are compatible with the specified
Applied firmware packages: (UMX-TPS): v1.5.0b4 | (WP-UMX-TPS): v1.4.0b8 | (FP-UMX-TPS): v1.4.0b8 | LDC software: v2.5.6b2
UMX-TPS-TX100 series – User's Manual
8.6.9. Exit Codes
There is a return value in all cases, when a command run is finished. Currently, three codes are defined:
Code Displayed text
0 N/A
1 Update error (ErrorCode:1)
2 CLI error (ErrorCode:2
The error line contains further information about the error.
Querying the Exit Code under Windows
c:\Program Files (x86)\Lightware\Lightware Device Updater V2\echo %errorlevel%
0
Querying the Exit Code under Linux
echo $?
0
So if this value is queried after the update and it is 0, the update performed successfully.
8.7. If the Update is not successful
Restart the process and try the update again.
▪
▪ If the device cannot be switched to bootload (firmware update) mode, you can do that manually as
written in the User's manual of the device. Please note that backup and restore cannot be performed
in this case.
▪ If the backup cannot be created for some reason, you will get a message to continue the process
without backup or stop the update. A root cause can be that the desired device is already in bootload
(firmware update) mode, thus, the normal operation mode is suspended and backup cannot be made.
If an update is not successful, the Export log button becomes red. If you press the button, you can
▪
download the log file as a ZIP package which can be sent to Lightware Support if needed. The log files
contain useful information about the circumstances to find the root cause.
Description
The update performed successfully
The error happened during the update
The error happened before starting the update
®
157
#bootload