1.  Download the kernel/romdisks you want to load from:
     ftp://ftp.agendacomputing.com

2.  Convert kernel/romdisk from SREC format to binary with:
     'mipsel-linux-objcopy -Isrec -Obinary filename.srec filename'

     Note:  You can safely ignore the following warning from objcopy:
     "Warning: Output file cannot represent architecture UNKNOWN!"

     Note:  This step is now generally unnecessary as the recent
     kernels and romdisks already come in binary format.  If you
     get one of these images, all you have to do is 'gunzip' them
     before loading.

3.  Hook up the Agenda to your computer's serial port

4.  Run 'vrflash' with the options you need and it will patiently
    wait for you to power/reset your vr3 to begin flashing.

 vrflash:  0.14 - 2001/03/07 - Jeff Carneal <jeff@soldmy.net>

 Usage:  vrflash [OPTIONS] <file> <kernel|romdisk|0xOffset> 
  [ -l ]                 -- Capture input/output to ./capture.log
  [ -r ]                 -- Restart VR3 after loading
  [ -s <serial port> ]   -- Serial port.  Default == ttyS0
  [ -t <temp dir> ]      -- Temp dir for split files.  Default==/tmp
  [ -v (or -h) ]         -- Version and usage (this)
  [ -C ]                 -- Disable kernel/romdisk size check (expert-only!)
  [ -D ]                 -- Disable PMON overwrite check (expert-only!)
  [ -R ]                 -- Restore defaults after flash (1st update only!)
  [ -X ]                 -- Do not load xmodem-load.srec

EXAMPLES

Note:  Make sure minicom (or any other serial application) is NOT
       running on the port your Vr3 is connected to before running
       'vrflash'.  

Note:  These are examples only.  However, in general you should
       be able to issue example 1 and example 2 to upgrade your
       VR3.  

       Optionally, you can issue example 3 to do it in one step.  
       Or, if you just got your VR3 from the factory, you can 
       upgrade it for the first time using example 4.
 
# 1.  a) defaults to /dev/ttyS0 for serial port
#     b) load kernel vmlinux-ces2 (using xmodem)
#     c) flash kernel using offset of 0x0 ('kernel' offset)
#     d) capture all input/output to ./capture.log
 
  % vrflash -l ./vmlinux-ces2 kernel
   
# 2.  a) defaults to /dev/ttyS0 for serial port
#     b) skip xmodem-load download (since we know it's there already)
#     c) load romdisk 'romdisk-ces2'
#     d) flash romdisk using offset of 0x200000 ('romdisk' offset)
#     e) capture all input/output to ./capture.log
#     f) restart the VR3 when finished 

  % vrflash -X -l -r ./romdisk-ces2 romdisk
 
# 3.  a) specify port /dev/ttyS1 (com 2)
#     b) load kernel vmlinux-ces2 
#     c) flash kernel using offset of 0x0 ('kernel' offset)
#     d) load romdisk 'romdisk-ces2'
#     e) flash romdisk using offset of 0x200000 ('romdisk' offset)
#     f) capture all input/output to ./capture.log
#     g) restart the VR3 when finished 

  % vrflash -s ttyS1 -r -l ./vmlinux-ces2 kernel ./romdisk-ces2 romdisk
 
# 4.  a) load kernel vmlinux-ces2 (using xmodem)
#     b) flash kernel using offset of 0x0 ('kernel' offset)
#     c) load romdisk 'romdisk-ces2' (using xmodem)
#     d) flash romdisk using offset of 0x200000 ('romdisk' offset)
#     e) capture all input/output to ./capture.log
#     f) issue "restore defaults" command to the VR3
#        and restart when finished

  Note:  Be aware that -R formats the user flash partition and
  you will lose any data on that partition when you use it

  % vrflash -R -l ./vmlinux-ces2 kernel ./romdisk-ces2 romdisk

