View source for Flowire Software Upgrade Procedure

This is a step by step guide to upgrading the software in Flowire through its serial interface. 

== Requirements ==
The following equipment is required to perform the upgrade:
* Windows PC
* TFTPS server, for example Tftpd32 or Tftpd64 by Ph. Jounin (http://tftpd32.jounin.net)
* Telnet software, for example PuTTY by Simon Tatham (http://www.chiark.greenend.org.uk/~sgtatham/putty/)
* A network switch
* 2 Ethernet cables
* Special USB-Serial cable with JTAG connector
* Flowire unit
* Flowire power supply
* Software for the Flowire. [[Downloads#Flowire|Download the software here.]]

== Create the special USB-Serial cable ==
* You need an USB to RS232 cable with 3,3V TTL level. For example: http://au.element14.com/ftdi/ttl-232r-3v3/connector-type-a/dp/1329311
* You also need a ribbon cable. Suggested type: http://no.farnell.com/harwin/m50-9011042/receptacle-to-dip-150mm-20way/dp/2289813
* With these two items, create an adapter cable which connects the debug connector of the Flowire to the USB port of the PC:
[[File:Flowire cable.PNG|thumb|left|500px|Flowire cable]]
<br style="clear:both;" />

* On the Flowire, you must connect to these pins:
** 7: GND
** 8: UART1_TX – Connect this to Rx on the serial cable
** 16: UART1_RX – Connect this to Tx on the serial cable
[[File:FlowirePins.PNG|thumb|left|500px|Flowire pinning]]
<br style="clear:both;" />

== PC setup ==
*Set the IP address of your computer to 169.254.1.2, subnet mask 255.255.255.0:

[[File:FlowirePCSetup.png|thumb|left|300px|Set static IP address 169.254.1.2 on your PC]]
<br style="clear:both;" />
* Connect the USB-Serial cable
* In the '''Control Panel''', open the '''Device Manager''' to see which serial port is being assigned. It will be listed under''' Ports (COM & LPT)''' as USB Serial COM port #x, where x represents the COM port number. Double click it and change the port settings from 9600 baud to 115200 baud.

== TFTP server setup ==
* Start the Tftpd
* From the main window browse to the folder where the software files are kept. Choose the PC LAN port as the server interface:
[[File:FlowireTFTP.png|thumb|left|500px|TFTP server setup]]
<br style="clear:both;" />


== Physical setup ==
* ''Do not'' connect the power supply to the Flowire unit yet
* Take of the top lid of the Flowire by unscrewing the two screws
* Locate the JTAG and connect the cable, cable pointing away from the PCB
* Connect the PC to the switch using a LAN cable.
* Connect the Flowire to the switch using a LAN cable

[[File:FlowireConnections.PNG|thumb|left|500px|Physical setup]]
<br style="clear:both;" />


== Telnet setup ==
* Open PuTTY
* Choose Connection Type Serial, change Speed to 115200 and make sure it has the right COM port number:

[[File:FlowirePutty.png|thumb|left|500px|Telnet setup]]
<br style="clear:both;" />

* While holding down the space bar (or actually any key), power up the Flowire. You should see data in the command window. Once you see data release the space bar.
*Enter these commands, one at a time, and press [Enter] after each command:
** ''setenv serverip 169.254.1.2''
** ''setenv ipaddr 169.254.1.10''
** ''protect off all''
** ''tftp 0x40100000 u-boot218.bin''
** ''erase 0x30000000 0x3002FFFF''
** ''cp.b 0x40100000 0x30000000 0x30000''
** ''tftp 0x40100000 jffs2-spc''
** ''erase 0x30040000 0x3013FFFF''
** ''cp.b 0x40100000 0x30040000 0x100000''
** ''tftp 0x40100000 linux-spc''
** ''erase 0x30140000 0x3049FFFF''
** ''cp.b 0x40100000 0x30140000 0x360000''
** ''reset''


'''TIP!''' Mark the text line and copy it (right click > copy, or Ctrl+C). In the PuTTY window right click with the mouse and the text is instantly pasted. Hit [enter]. Copy/paste one line at a time.
* When the Flowire is back online you can login with root.
* By running this command you can see the new software version:
** ''cat /proc/net/plc/version''
* The procedure is now finished. The Flowire can be disconnected and the next unit can be upgraded.