View source for Image recovery - Zenitel Devices based on iMX8

This article describes how to flash a new image on [[Zenitel Devices based on iMX8]] processor. 

== Requirements ==
* Download and install [[Downloads#Turbine_Test_and_Demo_Application|VS-Tools.msi]]. The PC application '''VS-ProductUpgrade''' is a part of this package. This software runs both a TFTP server, and USB boot of target. 
* Access to the physical circuit board.
* Software Image
* A USB Micro plug cable.
* PoE ethernet cable or local power.
[[File:usbmicrocable.jpg|thumb|left|300px|USB Micro cable]]
<br style="clear:both;" />

== Setup and connections ==
[[File:TurbineRecovery1-2.png|thumb|left|500px|Principle connection. The upper cable ("USB to serial, TTL level") is optional.]]
<br style="clear:both;" />

=== Optional connection===
The process can optionally be monitored via the serial port of the board. This is not required, but could be useful for troubleshooting if issues appear during the process. You would need:
* A terminal emulator program. PuTTY is recommended
* A USB to Serial cable for serial connection from the PC to the circuit board
* See [[#Preparation of the optional USB to Serial converter cable|Preparation of the optional USB to Serial converter cable]] if you want to use this option

== Prepare the "VS-ProductUpgrade" application==
*Launch '''VS-ProductUpgrade''' application from Windows start menu ('''Start''' > '''Vingtor-Stentofon''' > '''VS-ProductUpgrade''').
#Download the software image for [[Zenitel Devices based on iMX8]]. Image: [https://alpha.zenitel.com/downloads/vsff8-prod-8.2.3.3.zip vsff8-prod-8.2.3.3.zip]
#Load the software image using the '''Open Software Image Archive''' button.
#Activate tab '''Production Programming'''
#Insert input fields '''Operator Name''', '''Programming Device'''. 
#Verify USB Operation is set to "Write all images (Recovery)


Your application should look something like below programming a TCIV+ Station:
[[File:Product_Upgrade_imx8_image.png|thumb|left|700px|The VS-ProductUpgrade application]]
<br style="clear:both;" />
{{Note|
*The Operator Name can be anything (only used in production)
*Take care to select the correct Programming Device from drop down <br>
*To reselect Programming Device double click in the label "Programming Device"<br>}}

*On HW version 100831xxxx.0102 and later the device cannot be powered from the USB connector. The procedure is then:
#Connect the the Micro-USB cable
#Hold down the USB Boot button while powering up the device (by connecting the PoE ethernet cable or local power) and wait for the PC to detect the new USB hardware
#In the PC application press the "USB Boot Target" button
#Watch the Pop-up window for the progress.  When the window disappears, the process is complete.  Be aware, it sits at 99% for several minutes.
*On HW version 100831xxxx.0101 and earlier the device can be powered from the USB connector. The procedure is then:
#Hold down the USB Boot button while connecting the Micro-USB cable and wait for the PC to detect the new hardware
#In the PC application press the "USB Boot Target" button
#Watch the Pop-up window for the progress.  When the window disappears, the process is complete.  Be aware, it sits at 99% for several minutes.
[[File:Product_Upgrade_imx8_status.png|thumb|left|500px|Progress window iMX8]]
<br style="clear:both;" />
*Disconnect power and USB. Reconnect Power and verify that it starts normally.

== Preparation of the optional USB to Serial converter cable ==

The Turbine station has a TTL level serial interface to which we can connect during the upgrade process. For this purpose a USB to Serial converter cable can be used. Recommended cable is [http://uk.farnell.com/ftdi/ttl-232r-3v3/cable-usb-to-ttl-level-serial-conv/dp/1329311?Ntt=FTDI+-+TTL-232R-3V3+-+CABLE TTL-232R-3V3], available from Farnell. 

This cable needs to be slightly modified as per photo below:

* Pin 1 = Black (GND)
* Pin 2 = Orange (Turbine RX)
* Pin 3 = Yellow (Turbine TX)

[[File:USB Serial orig.PNG|thumb|left|300px|Original cable]]


[[File:USB Serial mod.PNG|thumb|left|300px|Modified cable]]
<br style="clear:both;" />


Insert the USB connector in the PC. The unit will now install itself. Make a note of which COM port number it is assigned to. You will also find it in the Device Manager. Baud rate: 115200.

[[File:USBSerialPort.PNG|thumb|left|500px|USB Serial Port in the Device Manager]]
<br style="clear:both;" />

== Related articles ==
* [[Image recovery - Zenitel Devices based on iMX28]]
* [[Image recovery - Zenitel Devices based on iMX6]]
* [[Image recovery - ENA amplifier]]

[[Category: Turbine - Restore Factory Defaults and Software Upgrade]]