====================================
Barix Barionet Update and Rescue Kit
------------------------------------
Version: 2.08
Date:    2007-08-17
====================================

CONTENT
-------

This update kit contains all neccessary files to update your Barionet over the
network using the TFTP batch files as well as a rescue procedure using a serial
cable in case a Barionet is not reachable over the network.
It also contains all neccessary files to create your own web interface and BCL 
application for the Barionet.


NEW IN THIS VERSION:
--------------------

        - Barionet firmware 2.08 
          supporting up to 50 OneWire Temperature sensors
          faster BCL execution speed

        - New BCL Tokenizer V1.3 with additional BCL commands (Please tokenize
          your existing BCL sources with this new tokenizer to update your .tok
          files as the old .tok files will not run!)



INSTALLATION
------------

Extract the ZIP file to a folder on your computer.



UPDATING YOUR BARIONET OVER NETWORK
-----------------------------------

Change the working directory to the installation folder and type the command:

	barionet <IP address>

where <IP address> is the IP address of your Barionet. 
This will create two COB files barionetweb.cob and barionetbcl.cob and
transfers both to your Barionet using TFTP.



RESCUEING YOUR BARIONET USING A SERIAL CABLE
--------------------------------------------

This procedure using a serial cross cable is needed in case a Barionet is not
reachable over the network.

ATTENTION:
There are two different start commands for the Barionet serial rescue
depending on the built-in XPort.

The older Barionets (produced 2005 and earlier) came with a Lantronix LX-XPort
while newer Barionets (2006 and later) have the Lantronix EX-XPort!

If you don´t know which one is built in please remove the Barionet´s top plastic
cover and check the product number on the XPort/Network connector.  

For the new Barionet EX-XPort (XPort product number : XP1001001-03R) use:

  rescue1.bat   (when using COM port 1)
  rescue2.bat   (when using COM port 2)
  rescue3.bat   (when using COM port 3)
  rescue4.bat   (when using COM port 4)

For the older Barionet LX-XPort (XPort product number : XP1001000-01):

  lxrescue1.bat   (when using COM port 1)
  lxrescue2.bat   (when using COM port 2)
  lxrescue3.bat   (when using COM port 3)
  lxrescue4.bat   (when using COM port 4)
  
Procedure :
  - unpower the Barionet (disconnect power supply)
  
  - Set the update jumper on pin 2-3 of connector J4
    +========================================     
    ¦  +-+ | XPort U2 | <- Ethernet connector
    ¦  |1| +----------+
    ¦  |2|                +------------------ 
    ¦  |3| <- J4          | J6 IO connector
    ¦  +-+                +------------------
    +========================================
    
  - connect a serial null-modem cable (2-3, 3-2, 5-5) from the barionet´s RS232
    connector to the PC´s COM port

  - start the command depending on the XPort type and PC COM port(see above)

  - wait until you see the prompt: "Unplug the device's power and plug it back.
    Transmitting requests to the device."

  - power the Barionet

  - wait until you see the message: "Rebooting the device...  
    The device should have been rebooted now."

  - unpower the Barionet, remove the jumper and power the Barionet

This procedure does retain the the previous IP settings and does NOT upload the
BCL appliction. In order to do so use the batch file bcl.bat described below.




BATCH FILES FOR PROGRAMMERS
---------------------------

You can use

	web <IP address> 
or
	bcl <IP address>

to update each part of the application separetely.

The WEB application (including web UI, web help, graphics, MIB, MIB.zip, PIC firmware and version file) is 147 KB (150,881 bytes) in size.
The upload to WEB1 (64KB) also uses WEB2 (64KB) and WEB3 (64KB) to store the barionetweb.cob.

The included sample BCL application "Digital I/O tunnel", web setup, barionet.bas is 30.9 KB (31,705 bytes) in size.

WEB usage table:
  X1      Firmware
  WEB1..3 Web UI application , Help, PIC Firmware
  WEB4    Sample BCL application Digital I/O Tunnel (incl. Web setup)


To erase the BCL application (content of WEB4) use the included erasebcl.bat

Usage:

	erasebcl <IP address>


To erase all data (content of WEB1 .. WEB7) use the included erase.bat

Usage:

	erase <IP address>



APPLICATION
------------

There is a menu button "APPLICATION SETUP" in the main menu. Here you can configure the application "Digital I/O Tunnel":

This BCL application permits to tunnel digital inputs from one Barionet to outputs of another Barionet and vice versa. 
Both devices have to be set up in order to do tunneling correctly.

web setup:

Remote IP Address
Input the 4 values of the desired remote IP address.
To disable the tunnel enter 0.0.0.0.

Tunneling UDP Port
UDP port number used for tunnel data communication. 
Use the same port on the remote Barionet. 
To disable the tunnel enter 0.

Send Interval
Input the time in seconds between two status messages.
In case no inputs have changed (changes are sent immediately) a status message is sent to permit the other side to detect a communication loss. 
The same value should be set on the remote Barionet. 
Value range: 2..65535. 
To disable Loss checking enter 0.

The comunication loss will be triggered 1 second after the double time of the remote stations send interval to allow 1 lost UDP packet eg.:

	when interval is 5 seconds the "comuncication loss action" will be triggered 11 seconds after the last received I/O status

Output Action
Choose an output for each remote input and the communication loss. 
Choose Relais 1 or 2, Output 1 to 4 or Extension Relais 1 to 8 (Relais Extension module coming soon). 


------------------------
BARIX AG, Zuerich, CH
http://www.barionet.com/
------------------------