                        iRestore Read Me File
                            Version 1.0
                            11/ 9/1998

==============================================================================
NOTE: The shareware version of iRestore is limited to restoring files of less
      than 2048 bytes. Please register IRBACKUP to receive the full unlimited
      version of iRestore.
===============================================================================
What's new from version 0.2?
  Lots! Here is a list of the new features:
   1. A log is now kept listing what files were and were not restored and why.
   2. Restore only missing files.
   3. Restore only missing or newer files.
   4. Check for available space before restoring each file.
   5. Partial restore by directory/subdirectory.
   6. Selective restore by file name/type with wildcards.
   7. Restore to a different directory then the original.
   8. '/Test' option to see a list of what files you have selected for
      restore and where they will go on your Psion. Done without Psion.

I purchased the registered version of iRestore 0.2 how do I upgrade to the
registered version of 1.0?
   You are entitled to a free upgrade to version 1.0. The version of
   irNFS that runs on your Psion is the same as used on 0.2 so you can start
   testing the new features by just running the DOS shareware program. If you
   like what you see just send me a note with your current e-mail address (in
   case it has changed since you registered) and I will ship you out the new
   registered version.

What does iRestore do?
  iRestore allows you to restore a previously saved copy of your Psion's files
  and directory structure from your PC back to your Psion. iRestore is designed
  to restore files saved by IRBACKUP. The required directory characteristic is
  that a valid Psion drive letter (A,B,C, or M) be the start of the Psion
  directory structure.

  C:DOS
     PSION
       PSIWIN
     TEMP     BACKUP                 Starting directory for restore
     WINDOWS    JAN        V
                SDK      FEB
                             M
                           MAR      A
                                       AGN
                                      B       APP
                                                DAT
                                                IMG
                                                OPD
                                                OPL
                                                SPR
                                                WDR
                                                WLD
                                                WRD

  To restore the complete file structure shown above you would use the
  following command line:

  iRestore 2 c:\psion\backup\feb\a a  (where 2 is your Infrared comport number)

  If you were alread in the 'feb' directory and had used 'set IRPORT=2' then
  you would only need to enter:

  iRestore a

  By default iRestore only restores missing files. If the file exists it will
  not be overwritten. If you wish to restore files that are either missing or
  overwrite older files with newer ones from your PC then add the /NEWER
  directive. If you wish to force a complete restore even if the PC version is
  older than the Psion version then add /ALL.

What programs make up iRestore?
  There are two parts to iRestore. The first is the program that runs on your
  PC and is named iRestore.com. This program contains all the logic that makes
  up the restore function. The second part is a general purpose file server
  program that runs on your Psion and is named irnfs.opa. This program manages
  the Infrared Link on your Psion and responses to requests made by the PC
  program for file access. It is the program irnfs.opa that is actually
  creating the directories and writing files at the direction of iRestore.

Where is irnfs.opa kept and how do I get it on my Psion?
  The program irnfs.opa is contained within the iRestore.com program. Also
  included inside iRestore.com is a transfer program that speaks native Psion
  3c/Siena Infrared protocol. You transfer irnfs.opa to your Psion by
  first placing your Psion in Infrared file receive mode (check your Psion
  manual for information on how to receive a file from another Psion). You
  then type the following line at the DOS prompt:

     iRestore 2 send  (where 2 is your Infrared comport number)

  The native file transfer code built into iRestore will fool your Psion into
  thinking it is receiving a file from another Psion.

  The irnfs.opa program currently used is version 0.9 so if you already have
  this version on your Psion from installing one of my other programs
  you do not need to send it again. If you have an older version of irnfs.opa
  on your Psion you will need to delete it first before receiving this newer
  version since the native Psion protocol does not allow a file to be
  overwritten.

Can I specify what directories iRestore restores to my Psion?
  Yes. After the drive letter you can add the directory/subdirectory you
  would like restored. To restore only files in the Agenda directory you
  would enter:

     iRestore m\agn

  If you wanted to restore them to a different drive you would enter:

     iRestore m\agn a:

  To restore them to a different directory you would enter:

     iRestore m\agn  temp
  or
     iRestore m\agn  a:\temp\agn


Can I specify the type of files to be restored?
  Yes. You can add a file specification after the drive/path name.


  VERY IMPORTANT !!!!!!!!!!!!!!!

  The current version of IRBACKUP does not archive files it finds in your
  PC directory but are no longer on your PSION when it does a backup. This
  means that your PC backup directories may contain many files that are no
  longer on your PSION. If you run iRestore it will attempt to restore all the
  files it finds in the backup directory which could be more than your Psion
  has space for. The current solution is to move those files that have been
  backed-up but are no longer needed on your Psion to a different directory.

  Move any files you no longer wish restored out of the specified source
  directory structure to an archive directory structure before starting a
  restore.

  At some point in the future I hope to upgrade IRBACKUP to automatically do
  this archive function. But I can not give any target date at this time.

Does iRestore erase any files or directories on my PSION?
  No. iRestore only addes to or overwrites files with the ones being restored.
  For example if you have a directory with files that were never backed up
  then they will still be there after the restore opertion.

  You will need to first reformat or erase (if m: drive) your Psion drive if
  you wish to only have the files that restore sends over.

How is the data protected?
  Each data block transferred is protected by a 16 bit CRC check code
  (x^0+x^5+x^12+x^16) and a 16 bit sequence number.

What baud rate is used to send the files?
  The default speed is 19,200 for both irNFS and iRestore. Baud rates up to
  115,200 are possible given your hardware's capabilities. Be sure to set both
  irNFS and iRestore to the same speed. I currently use 57,600 baud for my
  Siena.

What IR hardware works with iRestore?
   This version now supports the Adaptec AIRport 1000/2000, Actisys IR220L,
   Redeye, Jeteye, and Tekram external adatpers.

How can I permanently set the IR port?
  The IR port can be permanently set by setting the environment variable
  IRPORT. The syntax is "set IRPORT=x" or "set IRPORT=xxx:i" depending on
  whether you have a standard or non-standard IR port. This can be typed
  at the DOS prompt for testing and then added to your AUTOEXEC.BAT. Once
  set you no longer need to supply it on the command line when running
  iRestore. To do a complete backup of the m: drive to the subdirectory
  myfiles just type:

                 iRestore 2 c:\psion\backup\feb\a a

How can I select a different IR link speed?
  The IR link speed can be changed from the default speed of 19,200 baud by
  setting the environment variable IRSPEED. The syntax is "set IRSPEED=x"
  where x can be 9600,19200,38400,57600, or 115200. Only the first two
  digits of the speed value are actually checked so IRSPEED=11 selects
  115200 baud and IRSPEED=96 selects 9600 baud. Not all baud rates are
  available on some external IR adapters.

  The IRSPEED value does not affect the IR link speeds used by the SEND option
  unless the lowest link speed (9600) is selected. In this case the SEND
  option link speed is also limited to 9600 baud. The SEND option normally
  uses 9600 baud to locate the PSION and then steps up to 19,200 for the actual
  OPA file transfer.

  Be sure to select the same link speed when starting the Psion IRNFS.OPA
  server code as you specified with the IRSPEED variable.

Where can I get the latest version?
   A web site has been setup at:

       http://www.geocities.com/SiliconValley/Lakes/3947

   It has the latest version of iRestore plus access to other Psion IR programs
   and information about current and future plans.

IMPORTANT  IMPORTANT  IMPORTANT  IMPORTANT  IMPORTANT  IMPORTANT  IMPORTANT
==============================================================================
It is highly recommended that you do a test restore with some sample files as
outlined above before doing a complete restore.
==============================================================================
                             DISCLAIMER
Use this software at your own risk. I will not be held responsible for any
damage to you, your machine and/or your information as a result of using
iRestore.
==============================================================================

Requirements:
  PSION: Siena, 3c
  PC   : x86 with IRDA compliant IR port
  Operating System: DOS, Windows 3.1, WIN95 (MS-DOS mode only)

Files in this package:
  iRestore.COM    Program that restores files to your Psion.
  README.IRS      This file.

Installation:
  Load iRestore.COM on your PC then type "iRestore com# send" to load the
  ifnfs.opa program onto your Psion. Replace "com#" with the number of your
  Infrared serial port (ie 1,2,3,4 or port#). Install the program on your
  Psion system screen using the nornal Psion-I key sequence.

Running iRestore.
  Be sure to set the IR Link to run at HIGH power.  From the system screen
  press Psion-L select Infrared then Power setting to HIGH. Now startup the
  irNFS.opa program and point your Psion Infrared window at your PC's Infrared
  window. Then type iRestore followed by the COM number for your IR port,
  the name of the starting directory of the restore (must end in valid Psion
  drive letter), and last specify the Psion drive to restore to (A,B,C,M).
  Your can restore to a different drive then where the data came from.

  If a file transfer gets hung up you can terminate the iRestore by holding
  down both shift keys on the PC.

  Restored files will have the original date and time preserved.

  Syntax of iRestore.com:

  iRestore <   com 1,2,3,4  > <source path> < Psion > {</AIRport>}
           <or adr:IRQ XXX:I>               <m,a,b,c>  </ACTisys>
                                            </Jeteye,/Redeye,/TMx x=0-3 /PSION>

    Examples:
      iRestore 2 psion\m m          (Restore to Psion m drive)
      iRestore 3E8 c:\backup\a a    (Restore to Psion a drive)
      iRestore 2 send /airport (Send irnfs.opa file to Psion, AIRport IR Adp)


  You can set the environmet variable IRPORT to avoid having to type the
  IR port information on the command line each time. At the DOS prompt type:
  "set IRPORT=2" or "set IRPORT=3e8" (Of course use the correct values
  for your IR port.) You can also use the environment variable IRTYPE to
  avoid having to type the adapter type. At the DOS prompt type:
  "set IRTYPE=Redeye" (replace Redeye with your adatper type).

Aborting the program:
  To abort a restore on the PC just hold down both the left and right shift
  keys for a few seconds. Then after the statistics have been displayed press
  any key.

  To abort the PSION IRNFS.OPA program press Psion-Esc or go to the system
  screen and highlight IRNFS then press the 'Del' key.

How can I tell if my IR port is working:
  If you have a camcorder get it out and go into record standby mode and look
  through the viewfinder.  You should see a flashing light coming from the IR
  window on your PSION or Notebook when they are sending.  When the iRestore
  program is running it makes the PC the master and it starts sending looking
  for the PSION to respond.  Look for a flashing light from your PC's IR
  window (you don't even need the PSION running at this point).  You should
  see a flash about once a second as the PC looks for the PSION.  Next startup
  your PSION and place it so you can watch its IR window for the return
  response.

Improvements:
  If you have any suggestions for improvements please email me with them.

Registration:
  If you find this program useful please register your copy. Registered users
  will receive an unrestricted version without the 2KB limit that restores any
  size file as well as the backup program.

  Registration is now available online through RegNet ($23 = $15  + $7
  RegNet handling fee).

  To register online go to:       http://www.reg.net/product.asp?ID=840

Jim Pollock <jpollock@ix.netcom.com>

History:
   0.2  8/11/1997  First release
   1.0 11/09/1998  Add support for Tekram external IR Adapter
                   Improved ability to run in Windows 95/98 DOS Window.
                   Stopped using Interrupts.
                   Fix bug that stopped restore if an attempt was made to
                   restore the file irNFS.opa. The program would stop after
                   restoring the remainder of the directory \APP or any
                   subdirectory within \APP.

===========================End of Readme======================================
