________________________________________________________________

                    X&Y Modem v2.2 for HP48
________________________________________________________________
CHANGE FROM v2.0 :
-The bug in ERRSET/ERRTRAP has been fixed.
-The XLIB name have changed ! sorry.

CHANGE FROM v2.1 :
-The bug concerning the IOPAR has been fixed.
-The program check the battery before beginning the communication. 


SETUPXYM : 
  CRC  : toggle flag 57. If flag is true then CRC else CHK.
         Used only with XModem in reception (CRC is automaticaly
         choosen with YModem)
  REPL : toggle flag -36 (see manual)
  EXIT : do a lastmenu

SENDM :
  Send with X or Ymodem depending on the first stack object :

  1: global_name/local_name  -> 1: list       use Ymodem
     Equivalent to SEND Kermit command
     example: 'ABC'

  1: :IO:name                -> 1: list       use Ymodem
     Equivalent to ARCHIVE
     example: :IO:Sep3

  1: :port#:name             -> 1: list       use Ymodem
     send a library or a Backup object
     example: i/  :0:1275    
              ii/ :&:ABC

  1: list                    -> 1: list       use Ymodem
     send one or more objects listed above
     example: { :IO:Sep3 :0:1275 :0:1092 FFT }

  1: any                     ->               use Xmodem
     if the object isn't of a type listed above, it will be send with
     XModem protocol(see remark below).

  The output list contains the unsends objects(files not found in the
  current path).

RECX :
  Receive with XModem protocol. Flag 57 specify CRC or CHK.
  This command is usefull to receive a library on stack.
                             -> 1: object

RECY :
  Receive one or more files with YModem protocol. This command is
  equivalent to the RECV command of Kermit.
                             -> 


REMARK :
i/
Sending an object from the HP48 to a PC with Xmodem protocol (not Ymodem
protocol) is not a good idea : this object cannot be received from HP48 with
the standard RECV Kermit command. Why ?
- because Xmodem don't send the file header which contains the size in bytes of
the object. This information is used by RECV Kermit command to check if the
file has been corrupted.
So a file sended with Xmodem can be received only with Xmodem and Ymodem.

In conclusion:
- a file send with Ymodem is safe : you can receive it later with Kermit,
Xmodem and Ymodem protocol.
- a file send with Xmodem is not safe : you can receive it with only Xmodem and
Ymodem protocol.

ii/
X&Ymodem automatically select the serial port for the communication and
transferts are made in binary mode. So the flags -33 and -35 have no effects.
You can choose the speed (9600, 4800, 2400, 1200) in the SETUP submenu of the
IO menu.

iii/
You must set the size of a bloc to 128 bytes (short bloc) in the configuration
of your comunication program in your PC.


KNOWN BUG :
None.


CREDITS:
  Hewlett-Packard for their Tools.
  Alonzo Gariepy for his Saturn Processor Notes.
  Jan Brittenson for his Star and his MLDL library.
  Detlef Mueller, Raymond Hellstern and Rick Grevelle for their
    Library constructor.
  Chuck Forsberg for his notes on the protocols XModem and YModem.
  And to all people who gave us a lot information about Hp28, 48 on
    mail, news and FTP-server.

Maurice Alou & Edouard Westphal

alou@elde.epfl.ch
westphal@elde.epfl.ch
   
********************************************************************
**** Do a backup with the standard ARCHIVE before using the library!
********************************************************************

Library name : X-Y Modem v2.2
Library ID   : 1275
Size         : 3550
Chk          : # 65E9h
