                          Introduction

This program  allows you to connect your Psion Organiser II, via 
the RS232 Comms Link package from Psion to any model in the Acorn 
Archimedes computer range. (The A3000 will require the RS232
serial port upgrade)

The  program allows you transfer files (Data and  Procedures)  to 
and from your Psion and Archimedes.

This  provides a simple way to backup valuable data held on  your 
Organiser to very safe a reliable storage medium.

While your data is held on disc you could safely change batteries 
or  erase  a  data pack,  and then reload your  Psion  after  the 
operation is completed.

   
Now for some notes on how to use this program, it is very easy to 
use, employing a simply menu system to use the various features.

This  manual  uses  the  following  convention,   if  a  word  is 
surrounded  by  < >  it means press that particular  key  on  the 
Archimedes keyboard.

Any  word  surrounded by { } means select that  function  on  the 
Psion by pressing the EXE key on the Organiser keypad.

Pressing the <ESCAPE> key at any time will return you to the main 
menu of the program.

Important Notes.

The only limitation to the package is that procedures written  on 
the  Psion  are can only be transferred in  there  non-translated 
form  (Source  code).
This  means that you must transfer the procedure code before  you 
delete the source code and just keep the object code.
When  you come to reload the Organiser you must  {TRANSlate}  the 
procedure to OPL before using it.
 
This  package  will  work  with a  Psion  Organiser  II  and  any 
Archimedes computer, it does how ever require an adaptor cable to 
join  the two units together.  See the section CABLE LAYOUT  else 
ware for the correct type of cable needed.

                  Psion To Archimedes Transfer

Option  1  allows  to  transfer files form  your  Psion  to  your 
Archimedes computer.

After you have selected this option from the main menu,  you  are 
asked to enter a file name for the data to be saved under on  the 
disk. The default file name of $.!Psion.Data.MAIN will only be 
used if you press <RETURN> at the prompt.

The  program will now pause to wait for data to arrive from  your 
Psion  Organiser.   On  your  organiser  you  should  follow  the 
following prompts :-

                    1.Select {COMMS}
                    2.Select {TRANSMIT}
                    3.Select {FILE} or {PROCEDURE}
                    
                    If you selected {FILE} :-

                    4.Type in the name of the file to be sent
                      or use the default {MAIN}.

                    If you selected {PROCEDURE} :-

                    4.Type in the name of the program file to be 
                      sent.

                    5.Press  'CLEAR'  on  the  Psion  keypad   to 
                      return to the {COMMS} menu.
 
The file or procedure should now be sent to the  Archimedes.  The 
data  will  automatically  be saved to the disk  under  the  name 
entered earlier.

When  the transfer has been completed you will be asked to  press 
the <SPACE BAR> to return to the main menu.

                  Archimedes To Psion Transfer 

Option  2  allows  you  to  transfer  files  to  your  Archimedes 
computer to your Psion Organiser.

After you have selected this option from the main menu,  you will 
be asked to supply a filename for the data to be transferred.
The  program will now try to find this file on the current  disk. 
If  the  file  could not be found or was of the  wrong  type  the 
screen will display the appropriate error message. 

The  default filename of $.!Psion.Data.MAIN  will only be  used if 
you press <RETURN> at the prompt.

Your  Psion  Organiser should be set up in the following  way  by 
following the prompts :-

                    1.Select {COMMS}
                    2.Select {RECEIVE}
                    3.Select {FILE} or {PROCEDURE}

                    IF you selected {FILE} :-

                    4.Select {ERASE} or {APPEND}

                    If you selected {PROCEDURE} :-

                    4.Type in the filename for the procedure to 
                      be saved under.

                    5.Press  'CLEAR'  to return  to  the  {COMMS} 
                      menu.

WARNING:  The Psion must be set up first before the file transfer 
is  attempted  or  the file transfer  may  fail,  and  lock  both 
machines up!

When  you have the Psion set up  ready to receive data press  the 
<SPACE BAR> to transfer the file.
  
The Archimedes will inform you when the transfer is complete  and 
ask you to press the <SPACE BAR> to return to the main menu.

                           Print File

Option 3 allows you to print a previously saved file.

After you have selected this option you will be asked to  provide 
a  filename  of  the  file to be  printed  out.  The  default  of 
$.!Psion.Data.MAIN  will only be selected if you press <RETURN> at
the prompt.

The  screen will now ask you weather you want the data  displayed 
on the screen or the printer.The default in this case is [S]  the 
screen,  this  will  be  selected if you press  <RETURN>  at  the 
prompt.

The data from the selected file will now be printed on the screen 
or the printer.

When  this operation has finished the screen will prompt  you  to 
press the <SPACE BAR> to return to the main menu.

                      Convert File To ASCII

Option 4 allows you to convert any file to ASCII, for loading into
a word processor etc. A default name of $.!Psion.Data.MAIN is
offered for the source of the data file.

An output name is generated in the program which is the source 
name plus the word 'Text', just press <RETURN> to accept the new
filename. 

The input file is now converted and the output stored as the file
name you selected. (Default='$.!Psion.Text.nameText')

I'am sorry but this option was not thought of when I first wrote 
this program, therefore it is PRACTICALLY impossible to write a
reverse procedure (eg to convert ASCII to a Psion data file).
(All to do with file formats, that sort of thing!)

                       Help/* Command/Exit

These three options are all fairly self explanatory.

Option number five displays one page of help, describing the set 
up options the Psion should be set to.

Option  number six allows you to do any star (*) command on  the
Archimedes operating system, mounting of disks etc.
Pressing <RETURN> on its own will exit this procedure.

Option seven will exit the program to BASIC/DESKTOP.



                          Cable Layout

           9 Pin Female                  25 Pin Male
           (Archimedes)                  (Psion)

               (TD)  3 -------->-------- 2 
               (RD)  2 --------<-------- 3
               (RTS) 7 -------->-------- 4
               (CTS) 8 --------<-------- 5
               (DSR) 6 --------<-------- 6
               (SG)  5 ----------------- 7
               (DTR) 4 -------->-------- 20
             
               (DCD) 1 ---|
                          |
               (DTR) 4 ---| 

     Key :-

     TD   Transmit Data
     RD   Receive Data
     RTS  Ready to send
     CTS  Clear to send
     DRS  Data set ready
     SG   Signal ground
     DTR  Data terminal ready
     DCD  Data carrier detected

Note pins 1 and 4 are connected together at the 9 pin (Psion) end 
of the cable.
Pin 4 (9 pin) is also connected to pin 20 (25 pin).

                      Technical Information  

     Hardware needed..........Psion Comms Link (RS232) package
                              Acorn Archimedes computer

     Transfer Speed...........9600 BAUD (Receive and Transmit)

     Transfer Protocol........XON/XOFF

     Archimedes file type.....&7FF (Psion)

     File size................Any size

     
     Psion Setup

     BAUD.....................9600
     PARITY...................ODD
     BITS.....................8
     STOP.....................1
     HAND.....................ALL
     PROTOCOL.................NONE
     ECHO.....................LOCAL

     All other values are the COMMS program defaults.
