Update Kit
==========

Version overview
----------------

Type        File name             Flash Target      Version_Date
Firmware    stream.rom            2K                V32.1_20210824
WEB UI      streamapp.cob         WEB5              V04.18_20210824
FW Ext. 1   sg.bin                WEB2              V10.18_20171019
FW Ext. 2   fs.bin                WEB1              V02.08_20140820
FW Ext. 3   bclio.bin             WEB4              V02.06_20151028
Update mod. rupdate.bin           WEB14             V01.01_20141124
Bootloader  unifull.spb           serial only       V99.28_20160624



Content
-------

The Update Kit comes in a ZIP file format and contains 5 sub folders:

A) gold_unit        files for the Gold Unit update procedure
B) tools            helper tools for webuidevkit
C) update_rescue    update via web browser or rescue via serial cable
D) versionhistory   version history of each component
E) webuidevkit      web UI development kit

Installation
------------
First extract the Update Kit using a zip tool such as WinZIP or the like.


A) Gold Unit
-------------
Please refer to the _readme1st.txt file in the gold_unit folder


B) Tools
--------
The folder "tools" contains web2cob and additional conversion tools for creating
the WEB UI COB file.


C1.1) How to update your device (requires a standard web browser)
-----------------------------------------------------------------
Please Note:
The update described below will NOT change the current configuration settings!
Reverting to Factory Defaults is not needed but recommended.

1. Open a browser and type the IP address announced into the URL field and hit
   the ENTER key.
2. Click on the UPDATE button to enter the update page.
3. Click on "Please click here to continue" to launch the update process.
   The device will restart in a special mode called Bootloader showing a
   number counting down. Upon start up the following screen appears ready
   for the update process.
   (The word Browse may differ depending on browser and language).
____________________________________________________
Update  Barix Bootloader version date               |
                                                    |
---------------------------------------------       |
Resource                               Browse       |
                                       Upload       |
                                       Reboot       |
---------------------------------------------       |
                                                    |
Advanced Update                                     |
---------------                                     |
____________________________________________________|

4. To update the software click "Browse" to locate the file you want to upload.
   Browse to the folder "update_rescue" and choose the file compound.bin.
5. Once selected, click "Upload". This process can take a few minutes.
   After a successful upload click the "update" link and when the Update
   window reappears click the "Reboot" button or if there is no button, click
   Browse and select the file "reboot". The device will reboot with the new
   firmware.

C1.2) Advanced update
---------------------
Individual files may be loaded using the Advanced Update.

1-3 Steps 1-3 above
4. Click "Advanced Update" and the following screen appears ready for the
   advanced update process. (The word Browse may differ).
____________________________________________________
Advanced Update                                     |
                                                    |
---------------------------------------------       |
Target                                 Browse       |
Resource                               Upload       |
                                       Reboot       |
---------------------------------------------       |
                                                    |
Update                                              |
------                                              |
____________________________________________________|

5. For advanced updates an additional "Target" parameter is required.
   This specifies where in the Flash to load the file.
   Refer to "Version overview" above for a list of flash targets.
   The bootloader is not intended for web uploads but is included in a serial
   "rescue". (see A2 below). 
6. To make an update type in the Target and then click "Browse" to locate
   the corresponding file in the "update_rescue" folder.
7. Once selected, click "Upload". This process can take up to one minute.
   After a successful upload click the "update" link and when the Update
   window reappears click the "Reboot" button.
   The device will reboot with the new resource file.

C2) To rescue your device using Windows XP/2000/NT and serial port
------------------------------------------------------------------
Please Note:
The update described below will CHANGE the current configuration settings!
Open a browser and type the announced IP address followed by "/status" into 
the URL field and hit the ENTER key. Print this page which contains the 
current configuration settings of the device in order to reenter them
after the update.

1.  Unplug power supply.
2.  Use a serial crossover cable to connect your device's serial port to
    that of the PC. 
3.  Start one of the following scripts in the folder "update_rescue"
    depending on the COM port you are using.
    Either use one of the prepared batch files for serial ports COM1-COM4
    or use the serial.bat file directly with a serial port parameter   
     
    serial port  	Use 
    -----------		-----------
    COM 1        	serial1.bat
    COM 2        	serial2.bat
    COM 3        	serial3.bat
    COM 4        	serial4.bat    
    COM n        	serial COMn  

    Also included in the folder "update_rescue" is a "legacy" batch file.
    For a "Legacy Product" use the "legacy" script instead of "serial".
    A description of the "Legacy Products" is provided in the download
    section at www.barix.com.
            
4.  A message 'Waiting for the device' will be shown on the bottom of the
    screen.
5.  Plug in the power supply now.
6.  Wait until a message 'SUCCESSFUL' appears on the second line.
7.  Close the rescue program.
8.  Unplug power supply.
9.  Plug in the power supply.
10. Your device is set to factory defaults and should work now.
    If it does not work, please contact info@barix.com.
11. Reconfigure the unit to your last configuration
    (see note above).

C3) To rescue your device using Linux and other POSIX systems and serial port.
------------------------------------------------------------------------------
1.  Unplug the power supply
2.  Use a serial crossover cable to connect your device's serial port to
    that of the PC. 
3.  Change directory to update_rescue/linux_mac (cd update_rescue/linux_mac)
4.  Start the program according to the instructions in the README file
5.  Plug in the power supply as requested by the program.
6.  Wait until the program finishes
7.  Your device is set to factory defaults and should work now. If it doesn't
    work please contact info@barix.com
8.  Reconfigure the device to your last configuration (see note above).

C4) To rescue your device on a MAC
----------------------------------
Please refer to the instructions in update_rescue/linux_mac/MAC_README.


D) Version history
------------------
The folder "versionhistory" contains a version history text file for each part
of the Update Kit.


E) WEB UI Development Kit (to customize UI appearance)
------------------------------------------------------
Download the WEB UI Development Kit Manual from www.barix.com, read it
carefully and follow the steps to customize the devices UI (User Interface).



Copyright information
------------------------

GPL-covered files
---------------------
The file update_rescue/cygwin1.dll is copyright 2000-2005 Red Hat, Inc.

GPL files are free software; you can redistribute them and/or modify them
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option) any
later version. These files are distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
Public License for more details. You should have received a copy of the GNU
General Public License along with this program in update_rescue/GPL; if not,
write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA  02110-1301, USA.

Remaining files
-------------------
The remaining files are copyright (C) 2006-2009, Barix AG. All rights reserved.


-------------------------------------------------------------------------------
This document is copyright (C) 2009, Barix AG. All rights reserved.

Barix AG assumes no responsibility for errors or omissions in this document.
Nor does Barix make any commitment to update the information contained herein.

Other product and corporate names may be trademarks of other companies and are
used only for explanation and to the owners' benefit, without intent to
infringe.

