Difference between revisions of "Turbine Software Upgrade"

Latest revision as of 11:11, 4 December 2023

This article describes how to upgrade the software of the Turbine series of intercom devices via the web interface of the station.

The procedure described in this article is applicable to the following devices: TCIS-x, TCIV-x, TKIS-2, TMIS-x, TFIE-x, TKIE-x, TFIX-x, IP-LCM, ECPIR-3P, Exigo IP speakers. Exigo Network Amplifiers, and ENA-2060DC1
For mass upgrade of stations it is recommended to use the VS-IMT tool, see the article IMT - Discover & Upgrade.
Using Turbine version 4.7.3.2 or higher, you can downgrade to VSF-Turbine version 4.2.3.17, but not to any older version.
There is a separate Upgrade procedure for INCA IP stations.
If the station is used in SIP mode, also Automatic Updates can be defined.

There are two ways of updating the software of these devices from the web interface:

By using an external TFTP server, or
By uploading an image file (or drag and drop the image file) to the "Software Upgrade" page of the station. Note: This option is available only to stations with Recovery OS.

Upgrade using the IMT-tool

Upgrade of station can be done from the Windows PC tool VS-IMT, see the article IMT - Discover & Upgrade.

Upgrade by using an external TFTP server

Prerequisites

Current version must be 4.7.3.2 or higher. To upgrade from older versions, see this article.
A TFTP Server must be available on your laptop. A TFTP server can be downloaded from here: http://tftpd32.jounin.net/tftpd32_download.html.
Download the software package vsft-8.x.x.x.zip, and unzip the package and store the files in a folder on your PC.
Check if your local firewall is not blocking incoming ping/ICMP (Turbine station is pinging TFTP Server during update process)

Upgrade procedure

Start the TFTP server program and click Browse, and select the folder where the 8.x.x.x software files are located
Log on to the Turbine Station web interface. Select Station Administration > Manual Upgrade
Enter the IP address of the TFTP server (I.e. the IP address of your laptop)
Enter Image file: vsft-8.x.x.x
Save Settings
Upgrade

Example: Upgrade to the latest the firmware from TFTP Server 10.9.9.217

The device will restart with the new firmware installed.

The upgrade procedure takes about 3 minutes. The process can be monitored by clicking the Log viewer tab in the TFTP server program.

Devices with Recovery OS

As from firmware version 5.1.3.0 a Recovery Operating System, Recovery OS, has been added in addition to the Main OS.

"Recovery OS" is available only on Turbine devices that come from factory with software version 5.1 or higher preinstalled (approx. from March 2020)
When upgrading to firmware 5.1. or later in the field, "Recovery OS" will not be included

The Recovery OS supports:

Software upgrade in IPv6 network
Software upgrade when device is using 802.1X authentication
Software upgrade via HTTP/HTTPS protocol using .swu image

Devices with Recovery OS support both the new method for software upgrade (using .swu file), as well as the original method (using .zip file and TFTP server).

Choose between upgrading using .swu file, or using TFTP server and .zip file

In order to upgrade software using the .swu file:

Press the upper Start Upgrade button
The station will now reboot, and start in "Recovery OS" mode

Turbine device in "Recovery OS" mode

Now click inside the "Software Update" field and upload the image file (e.g. vsft-8.0.3.2.swu), or drag and drop the image file onto this field
The progress of the installation is shown. When finished installation the station will reboot, and start in regular mode.

Upgrade from versions between 3.0 and 4.2

To upgrade devices currently running a version between 3.0.x.x and 4.2.x.x, see article: Upgrading Turbine Devices running firmware between 3.0.x.x and 4.2.x.x

Upgrade in 802.1x environment

Devices with Recovery OS can be upgraded also when the station uses 801.1x authentication. For more details, see IEEE 802.1X

Troubleshooting

In the case the upgrade is not successful it may be due to a windows setting.

For Windows XP: http://www.sysprobs.com/enable-ping-in-xp

For Windows7: http://www.sysprobs.com/enable-ping-reply-windows-7

For Windows10: http://www.sysprobs.com/enable-ping-reply-and-ftp-traffic-in-windows-10-and-server

If the upgrade is not successful when using the default static IP, it may be due to a network setting.

Please check the station's subnet mask. If it is 255.255.0.0, change it to 255.255.255.0 and try again

@@ Line 1: / Line 1: @@
-This article describes how to upgrade the software in the Turbine Compact and Industri IP Stations.
+{{AEIPS}}
+This article describes how to upgrade the software of the [[:Category:Stations#Turbine_stations|Turbine series of intercom devices]] via the '''web interface''' of the station.
-There are two ways of upgrading the software on the IP station:
+{{Note|
-* Uploading the software via the web interface of the station
+* ''The procedure described in this article is applicable to the following devices: '''TCIS-x''', '''TCIV-x''', '''TKIS-2''', '''TMIS-x''', '''TFIE-x''', '''TKIE-x''', '''TFIX-x''', '''IP-LCM''', '''ECPIR-3P''', '''Exigo IP speakers'''. '''Exigo Network Amplifiers''', and '''ENA-2060DC1'''''
-* Uploading the software via AlphaWeb on the AlphaCom server
+* ''For mass upgrade of stations it is recommended to use the [[IMT|VS-IMT]] tool, see the article [[IMT - Discover & Upgrade]].''
+* ''Using Turbine version 4.7.3.2 or higher, you can downgrade to VSF-Turbine version 4.2.3.17, but not to any older version.''
+* ''There is a separate Upgrade procedure for [[INCA Station Software upgrade|INCA IP stations.]]''
+* ''If the station is used in SIP mode, also [[Automatic Software Upgrade|Automatic Updates]] can be defined.'' }}
+<div style="float:right;"> <youtube width="300" height="180">WS-ysJCOYcI</youtube> </div>
-=Prerequisites=
+There are two ways of updating the software of these devices from the web interface:
-Both upgrade methods require that an TFTP Server is available and that the latest software image files have been downloaded from [[Downloads#Turbine_stations|Downloads]]. During the upgrade process, the IP station will connect to the TFTP Server and download the software. Install the TFTP Server program on your PC. The TFTP Server can be downloaded from [[Downloads#Useful Tools|Downloads]]
+* By using an [[#Upgrade by using an external TFTP server|external TFTP server]], or
+* By uploading an image file (or drag and drop the image file) to the "Software Upgrade" page of the station. '''Note:''' This option is available only to [[#Devices with Recovery OS|stations with Recovery OS]].
-=Upgrade Via Station Web Interface=
+== Upgrade using the IMT-tool==
-* Start the TFTP server program and click '''Browse''' to select the folder where the software image files are located
+Upgrade of station can be done from the Windows PC tool [[IMT|VS-IMT]], see the article [[IMT - Discover & Upgrade]].
-[[File:TCIS Software Upgrade 1.PNG|thumb|left|500px]]
+<br>
-<br style="clear:both;" />
+== Upgrade by using an external TFTP server ==
+===Prerequisites===
+# Current version '''must be 4.7.3.2 or higher'''. To upgrade from older versions, [[Upgrading Turbine Devices running firmware between 3.0.x.x and 4.2.x.x|see this article]].
+# A TFTP Server must be available on your laptop.  A TFTP server can be downloaded from here: http://tftpd32.jounin.net/tftpd32_download.html.
+# Download the software package '''[[Downloads#Stations_and_Devices|vsft-8.x.x.x.zip]]''', and '''unzip the package''' and store the files in a folder on your PC.
+# Check if your local firewall is '''not''' blocking incoming ping/ICMP  (Turbine station is pinging TFTP Server during update process)
+<br>
-:1.  Log on to the IP Station web interface
+=== Upgrade procedure ===
-:2.  Select Station Administration> Manual Upgrade
+# Start the TFTP server program and click '''Browse''', and select the folder where the 8.x.x.x software files are located
+# [[Logging into an IP Station|Log on to the Turbine Station]] web interface. Select '''Station Administration''' > '''Manual Upgrade'''
-[[File:TCIS Software Upgrade 2.PNG|thumb|left|500px]]
+# Enter the IP address of the '''TFTP server''' (I.e. the IP address of your laptop)
+# Enter Image file: '''vsft-8.x.x.x'''
+# '''Save Settings'''
+# '''Upgrade'''
+[[File:Upgrade to 7.1.3.0.PNG|thumb|left|700px|Example: Upgrade to the latest the firmware from TFTP Server 10.9.9.217]]
 <br style="clear:both;" />
-:3.  Enter the IP address of the '''TFTP server'''(your PC’s IP address)
-:4.  Enter the prefix (e.g. '''tsi-3.x.x.x''')to the software image files in the '''Image file''' field
-:5.  Click '''Save settings''' to store the data
-The station will now try to contact the TFTP server. If the connection cannot be established or the ''tftp_test.txt'' file is missing from the folder, the message ''TFTP_CONN_ERROR'' is displayed. If the response is ''TFTP_CONN_OK'' the settings are saved, and the '''Upgrade''' button will appear.
+The device will restart with the new firmware installed.
-[[File:TCIS Software Upgrade 3.PNG|thumb|left|500px]]
+The upgrade procedure takes about 3 minutes. The process can be monitored by clicking the '''Log viewer''' tab in the TFTP server program.
-<br style="clear:both;" />
+<br>
-* Click the Upgradebutton to upgrade the software on the IP station.
+== Devices with Recovery OS ==
+As from firmware version 5.1.3.0 a Recovery Operating System, '''Recovery OS''', has been added in addition to the Main OS.
-[[File:TCIS Software Upgrade 4.PNG|thumb|left|500px]]
+{{note|
+* ''"Recovery OS" is available only on Turbine devices that '''come from factory''' with software version 5.1 or higher preinstalled (approx. from March 2020)'' <br>
+* ''When upgrading to firmware 5.1. or later in the field, "Recovery OS" will not be included'' }}
-<br style="clear:both;" />
+The Recovery OS supports:
+* Software upgrade in IPv6 network
+* Software upgrade when device is using [[IEEE 802.1X|802.1X authentication]]
+* Software upgrade via HTTP/HTTPS protocol using '''.swu''' image
-The upgrade procedure takes about 3 minutes. The process can be monitored by clicking the '''Log viewer''' tab in the TFTP server program.
+Devices with Recovery OS support both the new method for software upgrade (using '''.swu''' file), as well as the original method (using '''.zip''' file and TFTP server).
-==Upgrade Via AlphaCom XE==
+[[File:Turbine Upgr Both.PNG|thumb|left|500px|Choose between upgrading using '''.swu''' file, or using TFTP server and '''.zip''' file]]
-* Start the TFTP server program and click '''Browse''' to select the folder where the software image files are located
+<br style="clear:both;" />
-:1.  Log on to the AlphaCom web interface AlphaWeb
-:2.  Select '''System Maintenance -> IP Station Upgrade'''
-[[File:TCIS Software Upgrade 5.PNG|thumb|left|500px]]
+In order to upgrade software using the .swu file:
+* Press the ''upper''  '''Start Upgrade''' button
+* The station will now reboot, and start in "Recovery OS" mode
+[[File:Turbine Recovery.PNG|thumb|left|500px|Turbine device in "Recovery OS" mode]]
 <br style="clear:both;" />
-:3.  Enter the '''IP Address''' of the '''TFTP Server'''
+* Now click inside the "Software Update" field and upload the image file (e.g. '''vsft-8.0.3.2.swu'''), or drag and drop the image file onto this field
-:4.  Enter the prefix (e.g. '''tsi-3.x.x.x''')to the software image files in the '''Image Name''' field and click '''Save'''
+* The progress of the installation is shown. When finished installation the station will reboot, and start in regular mode.
-:5.  Select the station to upgrade and click '''Update Station List'''
-:6.  Click '''Start Upgrade Process'''
-The AlphaCom XE exchange will tell the station to contact the TFTP server, download the software image files and carry out the upgrade. A short status description of the process will be displayed in the Upgrade status column. The message ''IPST:ERROR'' indicates that there is no connection to the TFTP server, or that the ''tftp_test.txt'' file is missing from the folder. The transfer process can be monitored by selecting the '''Log viewer''' tab in the TFTP server program.
+<br>
- '''''NOTE!''' During an upgrade of the IP station, 802.1X will not be running.''
+==Upgrade from versions between 3.0 and 4.2==
- ''Thus if 802.1X reauthentication is enabled and is performed during the upgrade, the IP station may lose contact''
+To upgrade devices currently running a version between 3.0.x.x and 4.2.x.x, see article: [[Upgrading Turbine Devices running firmware between 3.0.x.x and 4.2.x.x]]
- ''with the TFTP server (depending on the configuration when 802.1X authentication fails).''
- ''If the IP station loses contact with the TFTP server, it will not be upgraded.''
-==Troubleshooting==
+<br>
-In the case where upgrade is not successful it may be due to a windows setting.
-For Windows XP: [http://www.sysprobs.com/enable-ping-in-xp http://www.sysprobs.com/enable-ping-in-xp]
+== Upgrade in 802.1x environment ==
+Devices with Recovery OS can be upgraded also when the station uses 801.1x authentication. For more details, see [[IEEE 802.1X]]
-For Windows7: [http://www.sysprobs.com/enable-ping-reply-windows-7 http://www.sysprobs.com/enable-ping-reply-windows-7]
+<br>
-==Coming==
+==Troubleshooting==
-===Upgrade from tsi-3.0.3.4 or older===
+In the case the upgrade is not successful it may be due to a windows setting.
-* Upgrade to 3.0.3.5 or newer user standard upgrade procedure
-* Upgrade to 4.2.x.x using UpgradeApp2.0. Load sti-prod-4.2.x.x.zip
-* Upgrade with file tsi2sti-4.2.x.x.ipk
-===Upgrade from sti-3.1===
-* Use UpgradeApp2.0
-* Load sti-4.2.x.x.zip
-* Upgrade with file boot/sti-4.2.x.x
-* Save Settings
-* Upgrade (Turbine restarts)
-* Upgrade with file sti-4.2.x.x
-* Save Settings
-* Upgrade (Turbine restarts)
-===Upgrade TCIV from sti-4.1===
+*For Windows XP: [http://www.sysprobs.com/enable-ping-in-xp http://www.sysprobs.com/enable-ping-in-xp]
-* Use UpgradeApp2.0
-* Load sti-4.2.x.x.zip
-* Upgrade with file boot/sti-4.2.x.x
-* Save Settings
-* Upgrade (Turbine restarts)
-* Upgrade with file video/sti-4.2.x.x
-* Save Settings
-* Upgrade (Turbine restarts)
-* Upgrade with file sti-4.2.x.x
-* Save Settings
-* Upgrade (Turbine restarts)
-===Upgrade TMIS from sti-4.1===
+*For Windows7: [http://www.sysprobs.com/enable-ping-reply-windows-7 http://www.sysprobs.com/enable-ping-reply-windows-7]
-* Use UpgradeApp2.0
-* Load sti-4.2.x.x.zip
-* Upgrade with file boot/sti-4.2.x.x
-* Save Settings
-* Upgrade (Turbine restarts)
-* Upgrade with file sti-4.2.x.x
-* Save Settings
-* Upgrade (Turbine restarts)
-===Manual upgrade through serial connection and console===
+*For Windows10: [http://www.sysprobs.com/enable-ping-reply-and-ftp-traffic-in-windows-10-and-server http://www.sysprobs.com/enable-ping-reply-and-ftp-traffic-in-windows-10-and-server]
-Example showing ECPIR-3P:
- st_net_enable
- eth0.ipaddr=10.5.101.140
- eth0.gateway=10.5.101.1
- eth0.netmask=255.255.255.0
- eth0.serverip=10.5.101.140
- update -t bootstream -d nand -f sti-4.2.1.x_boot
- update -t bareboxenv -d nand -f sti-4.2.1.x_bareboxenv
- update -t oftree -d nand -f sti-4.2.1.x_imx28-st-extended exigopanel.dtb
- update -t kernel -d nand -f sti-4.2.1.x_kernel
- update -t rootfs -d nand -f sti-4.2.1.x_rootfs
- reset
+If the upgrade is not successful when using the default static IP, it may be due to a network setting.
+* Please check the station's subnet mask. If it is 255.255.0.0, change it to 255.255.255.0 and try again
-[[Category:Turbine]]
+[[Category: Turbine - Restore Factory Defaults and Software Upgrade]]