9. Firmware Update
UCX series – User's Manual
143
Applied firmware package: v1.2.0b9 | LDC software: v2.5.10b1
9.6.5.
Update
This command can be used to update the firmware of the devices.
Command
LightwareDeviceUpdaterV2_CLI.cmd update [options]
Options
Option
Description
Required?
-p
or
--package
The path of the firmware package file
yes
-i
or
--ip
List of IP addresses of devices to be updated
one of them is
mandatory
-n
or
--hostName
List of host names of devices to be updated
-r
or
--reportProgress
Report update progress in percentage form. Default: false
optional
Package-specific options Certain LFP2 packages have features which can be applied
at this command; see the
optional
ATTENTION!
The configuration is restored automatically if the factory default option is not applied in the
update
command.In that case, there is no need to run the
restore
command after the update.
Example
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>LightwareDeviceUpdaterV2_CLI.cmd update --ip
192.168.0.52 --package f:\!!!LIGHTWARE\firmware\taurus_v1.2.0b7.lfp2 --reportProgress
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>LightwareDeviceUpdaterV2_CLI.cmd update --ip
192.168.0.52 --package f:\!!!LIGHTWARE\firmware\taurus_v1.2.0b7.lfp2 --reportProgress
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>lib\jre\bin\java.exe -jar lib\ldu2.jar update --ip
192.168.0.52 --package f:\!!!LIGHTWARE\firmware\taurus_v1.2.0b7.lfp2 --reportProgress
[2021-06-17 08:53:01.250] [ INFO] [ main] - Device IPs: [192.168.0.52]
[2021-06-17 08:53:09.075] [ INFO] [ main] - All the selected devices are accessible over the network.
[2021-06-17 08:53:11.097] [ INFO] [ main] - All the selected devices are compatible with the specified
package.
[2021-06-17 08:53:15.067] [ INFO] [ 192.168.0.52] - Taurus UCX update process started
[2021-06-17 08:53:15.074] [ INFO] [ 192.168.0.52] - Update parameters: deviceIp: 192.168.0.52, factoryDefault:
true
[2021-06-17 08:53:15.185] [ INFO] [ 192.168.0.52] - Update API version: 1.0
[2021-06-17 08:53:15.222] [ INFO] [ 192.168.0.52] - Update protocol: http://
[2021-06-17 08:53:15.223] [ INFO] [ 192.168.0.52] - Authentication type: BASIC
[2021-06-17 08:53:15.415] [ INFO] [ 192.168.0.52] - Device info: Product name: UCX-4x2-HC30, Device label:
LW_UCX-4x2-HC30_00006869, Serial number: 00006869, Mac address: a8:d2:36:F0:68:69, Ip address: 192.168.0.52, Host
name: , Package version: v1.2.0b6, Part number: 91310081, Hw version: V20_AXAX
[2021-06-17 08:53:15.450] [ INFO] [ 192.168.0.52] - Uploading firmware package.
[2021-06-17 08:53:16.108] [ INFO] [ProgressReporter] - Progress: 2%...
[...]
The lines containing "ProgressReporter" can be enabled optionally. If it is enabled, the current state is
displayed in every 5 seconds.
9.6.6.
Package Options
Shows package-specific update options.
Command
LightwareDeviceUpdaterV2_CLI.cmd packageOptions [options]
Options
Option
Description
Required?
-p
or
--package
The path of the firmware package file
yes
Example
c:\Program Files (x86)\Lightware\Lightware Device Updater V2>LightwareDeviceUpdaterV2_CLI.cmd packageOptions
--package f:\!!!LIGHTWARE\firmware\taurus_v1.2.0b7.lfp2
Login options:
--user : HTTP(s) basic authentication user (Default: empty string)
--pw : HTTP(s) basic authentication password (Default: empty string)
Package option example can be seen in the following section.
9.6.7.
Complex Example
The following options applied:
▪
Firmware is updated
▪
Authentication enabled
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>LightwareDeviceUpdaterV2_CLI.cmd update --ip
192.168.0.52 --package f:\!!!LIGHTWARE\firmware\taurus_v1.2.0b9.lfp2 --user admin --pw 4x2 --reportProgress
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>lib\jre\bin\java.exe -jar lib\ldu2.jar update --ip
192.168.0.52 --package f:\!!!LIGHTWARE\firmware\taurus_v1.2.0b9.lfp2 --user admin --pw 4x2 --reportProgress
[2021-07-01 08:35:23.421] [ INFO] [ main] - Device IPs: [192.168.0.52]
[2021-07-01 08:35:31.547] [ INFO] [ main] - All the selected devices are accessible over the network.
[2021-07-01 08:35:33.715] [ INFO] [ main] - All the selected devices are compatible with the specified
package.
[2021-07-01 08:35:37.675] [ INFO] [ 192.168.0.52] - Taurus UCX update process started
[2021-07-01 08:35:37.682] [ WARN] [ 192.168.0.52] - This update will call factory reset on the device. All user
settings will be lost.
[2021-07-01 08:35:37.688] [ INFO] [ 192.168.0.52] - Update parameters: deviceIp: 192.168.0.52, factoryDefault:
true
[2021-07-01 08:35:38.505] [ INFO] [ 192.168.0.52] - Update API version: 1.0
[2021-07-01 08:35:38.774] [ INFO] [ 192.168.0.52] - Update protocol: http://
[2021-07-01 08:35:38.776] [ INFO] [ 192.168.0.52] - Authentication type: BASIC
[2021-07-01 08:35:40.660] [ INFO] [ 192.168.0.52] - Device info: Product name: UCX-4x2-HC30, Device label:
LW_UCX-4x2-HC30_00006869, Serial number: 00006869, Mac address: a8:d2:36:F0:68:69, Ip address: 192.168.0.52, Host
name: , Package version: v1.2.0b8, Part number: 91310081, Hw version: V20_AXAX
[2021-07-01 08:35:40.728] [ INFO] [ 192.168.0.52] - Uploading firmware package.
[2021-07-01 08:35:43.736] [ INFO] [ProgressReporter] - Progress: 4%
[2021-07-01 08:35:48.744] [ INFO] [ProgressReporter] - Progress: 12%
[2021-07-01 08:35:53.759] [ INFO] [ProgressReporter] - Progress: 20%