Newsgroups: comp.sources.hp48

From: Maurice Alou <alou@elde1.epfl.ch>

Subject:  v07i029:  xymdm.ma - X&Y Modem v2.2, Part01/01

Message-ID: <1992Oct6.185930.14863@seq.uncwil.edu>

Date: Tue, 6 Oct 1992 18:59:30 GMT

Approved: spell@seq.uncwil.edu



Checksum: 2687033649 (verify with brik -cv)

Submitted-by: Maurice Alou <alou@elde1.epfl.ch>

Posting-number: Volume 7, Issue 29

Archive-name: xymdm.ma





________________________________________________________________



                    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         : 3552.5

Chk          : # A5A8h