1. What do I need? - The tool chain
------------------------------------

To use the scripts you need to have perl installed and additional the module
Win32|Device::Serialport


Installing on Linux: 

install Perl from your repository.

Download the Serialport module uncompress it and follow the instruction inside.

http://search.cpan.org/CPAN/authors/id/C/CO/COOK/D...



Installing on Windows:

First install ActivePerl (doubleclick the .msi file) and restart your PC.

http://www.activestate.com/activeperl/		(new Version)
http://www.oldapps.com/Perl.php			(older Versions)


Then download the Serialport module uncompress it and follow the instruction inside.

http://mirror.netcologne.de/cpan/authors/id/B/BB/BBIRTH/Win32-SerialPort-0.19.tar.gz




2. Loading up the firmware to your DSO:
---------------------------------------------

I provided two shell scripts for Linux bash that must be changed according to your
own configuration (examples inside).

flashloader.sh	-> loading firmware to W20xxA flash memory overwriting the old firmware
ramloader.sh	-> loading firmware to W20xxA RAM without overwriting the old firmware

Also you will find similar batch files for Windows with the same function.

flashloader.bat	-> loading firmware to W20xxA flash memory overwriting the old firmware
ramloader.bat	-> loading firmware to W20xxA RAM without overwriting the old firmware

Both shell scripts are using the perl script GERMSloader.pl which can be started directly also.


All scripts have to be in the same directory as your TomCat file.

- Switch on your DSO.
- Start the GERMS monitor. Press the left two function keys under the screen at the same time. 
  (First press the first key and then the second key - letting go just the other way round)
  The screen will become white and ten black - the monitor has started. 

- Under Linux start a command shell now (be shure you have root permission for opening the port),
  change to your directory with the scripts and the TomCat file and type in:

	- for loading to RAM  ./ramloader.sh

	- for loading to flash  ./flashloader.sh

  Under Windows you only need to doubleclick on the flashloader.bat or ramloader.bat


The upload starts. After 3 Minutes the upload should be complete and the DSO will
run with the new Firmware if you loaded to RAM. If you loaded to flash you
have to switch off and restart the DSO or to reset it with the first two function buttons.
(First press the second key and then the first key - letting go just the other way round)



3. Compressed UCL firmware file for turbo upload
----------------------------------------------------

For power users and developers short a upload time is very important. Due to that there is the 
possibility upload compressed UCL firmware files via perl script. The upload needs ca. 18s.
The decompressen is done automatically inside the DSO. You need to install the toolchain
as described in section 1.

To start the UCL upload go to the UCL directory and proceed like described above in section 2.



---------------------------------------------------------------------------------------------- 


Thanks for the perl script development to Stefan, Johannes and Daniel.
Thanks to Günter for the .ram enhancement in the Makefile script.



Further information you will find here:

http://apps.sourceforge.net/trac/welecw2000a/wiki/FWupload



Regards Hayo