home *** CD-ROM | disk | FTP | other *** search
/ Dream 45 / Amiga_Dream_45.iso / Amiga / emulation / AmigaNPI.readme < prev    next >
Text File  |  1997-10-17  |  7KB  |  218 lines
  1. Short:  V1.1 Load packages into the Newton
  2. Author: David Fong <Dr.David.Fong@medical.net.au>
  3. Type:   misc/emu
  4.  
  5. AmigaNPI 1.1 - 11th October 1997
  6.  
  7.  Amiga Newton Package Installer
  8.  
  9.  Converted into Blitz2 Basic by David Fong
  10.  
  11.  Based on source code by Filip R. Zawadiak
  12.  
  13.  Based on information graciously provided by Apple Computer and Newton Inc.
  14.  
  15. AIM
  16.  
  17.  To upload packages from the Amiga to the Newton without using
  18.  a Macintosh emulator.
  19.  
  20.  Two versions are provided.  A generic WB/CLI version (v1.1),
  21.  and a CLI only version (the old version 0.2a, in the cli_0_2
  22.  drawer).
  23.  
  24. REQUIREMENTS
  25.  
  26.  Can be used from CLI - a fast Amiga is recommended.
  27.  
  28.  Used from CLI on an Amiga 1200 with a 40 MHz 030 and the standard
  29.  serial port, AmigaNPI consumes approximately 82% of available CPU
  30.  processor power.  This requirement drops to about 60% if an external
  31.  serial port (such as provided on the Surf Squirrel) is used.
  32.  
  33.  Graphical user interface requires OS 2.0 (3.0 recommended) and
  34.  Magic User Interface v3.8
  35.  
  36. USAGE
  37.  
  38.  Can be used from Workbench, or from CLI.
  39.  
  40.  Workbench
  41.  
  42.  Double click the program's icon, or type in just `AmigaNPI'
  43.  from the CLI.
  44.  
  45.  From the main window, the package to be uploaded can be
  46.  chosen.  The button immediately below the chooser can be
  47.  used to set serial preferences.  These preferences can
  48.  be saved to env:AmigaNPI.prefs (and will then be copied
  49.  to envarc:AmigaNPI.prefs).
  50.  
  51.  The bottom button will then transfer the package to the
  52.  Newton.  During transfer, the transfer can be stopped by
  53.  pressing the `Abort' button.
  54.  
  55.  CLI
  56.  
  57.  From CLI type...
  58.  
  59.   AmigaNPI filename [device [device_unit [bps [flags]]]]
  60.  
  61.  Where filename is the name of the package file you are uploading.
  62.  
  63.  `AmigaNPI ?' is a special case, and will result in a help and
  64.  information file being displayed in the shell window.
  65.  
  66.  Optionally, the serial device and serial options can be specified.
  67.  Flags is a value derived by adding the possible numbers below.
  68.  
  69.  Flags - 128 - Disable Xon/Xoff
  70.        -  64 - Enable EOF checking
  71.        -  32 - Enable shared mode
  72.        -  16 - Enable high speed mode
  73.        -   8 - Break command waits for buffer empty
  74.        -   4 - use RTS/CTS
  75.        -   2 - Select odd parity (otherwise use even)
  76.        -   1 - Enable parity checking
  77.  
  78.  The default is
  79.  
  80.   serial.device 0 38400 148
  81.  
  82.  Defaults can also be read from the env:AmigaNPI.prefs file.  In
  83.  this file, the arguments are separated by line feeds (ASC 10).  All
  84.  four arguments must be provided in the AmigaNPI.prefs file.
  85.  
  86.  Note that AmigaNPI will only upload package files, which are usually
  87.  suffixed with a `.pkg' extension.
  88.  
  89.  Stuffit files, with a `.sit' extension, are archive files, like
  90.  the Amiga's .lha files, or the .zip files commonly used on
  91.  Windows machines.  Unfortunately, only very old Stuffit de-archiver
  92.  programs are available for the Amiga.  It is called something
  93.  like `unsit', it is available on the Aminet.  It does not work
  94.  properly with modern .sit files.
  95.  
  96.  Fortunately, most Newton packages are also provided in Zip format.
  97.  Good UnZip programs are available for the Amiga e.g. from InfoZip.
  98.  Try the Aminet, or ADE (ftp.ninemoons.com).
  99.  
  100. PROBLEMS
  101.  
  102.  Only tested on my MessagePad 2000 :)
  103.  However, others report success with NewtonOS 2.0 powered MP120s.
  104.  
  105.  Many people have had trouble using one version or another of
  106.  AmigaNPI (especially version 1.0).  This might be a Blitz2
  107.  problem, since Blitz2 was designed with speed rather than
  108.  system-friendliness in mind.
  109.  
  110.  Currently, it is difficult to claim that AmigaNPI is truly
  111.  multitasking, in the sense that the Newton will stop downloading the
  112.  package if the Amiga is significantly delayed for any reason. For
  113.  example, trying to use the Amiga's menu (by pressing the Amiga's right
  114.  mouse button) often results in the Newton stopping the transfer!
  115.  The recommended timeout sent from Amiga to Newton is very short,
  116.  only five seconds.  This may be user adjustable in the future.
  117.  
  118.  Speed is probably slower than it should be.
  119.  
  120.  Cannot interpret compressed information, which is part of the
  121.  V42bis standard.  This doesn't matter when uploading packages
  122.  to the Newton, but it would be nice to see what the Newton is
  123.  trying to send to the Amiga!
  124.  
  125. CREDITS
  126.  
  127.  Blitz2 BASIC
  128.  
  129.  Filip R. Zawadiak - provided the original source code, which
  130.                      is present in the src_c directory.
  131.  
  132.                    - philz@silesia.linux.org.pl
  133.  
  134.                    - http://www.wnet.silesia.pl/~philz/
  135.  
  136.  Andrew Kennan     - for some helpful hints to avoid `busy waiting'
  137.  
  138.                    - bewilder@coastlink.com.au
  139.  
  140.  Apple Computer, Newton Inc.
  141.  
  142.                    - for at last providing the necessary information
  143.                      to make non-Mac package uploaders
  144.  
  145.                    - for making the wonderful MessagePad 2000.
  146.  
  147.  The Makers of the Amiga
  148.  
  149. HISTORY
  150.  
  151.  0.1  - 13th September, 1997.  First release
  152.  
  153.       - added code to `round-up' files to the next largest number
  154.         evenly divisible by four.  This is a requirement according
  155.         to the Newton Load Package protocol.  In fact, most packages
  156.         seem to have been carefully manicured to the appropriate
  157.         size anyway.
  158.  
  159.       - note that Blitz2's lof() function doesn't seem to work
  160.         properly if the end of the file has already been reached.
  161.  
  162.  0.2  - 23rd September, 1997. (beta)
  163.  
  164.       - added code to cope with time-outs or disconnections.
  165.         Unfortunately, the implication of this is that AmigaNPI
  166.         will `busy wait' while waiting for serial port activity.
  167.         I hope this fix this problem shortly...probably at
  168.         the same time that I write a GUI interface for AmigaNPI.
  169.  
  170.       - NEW - optional specification of device (usually serial.device)
  171.         and serial options.  This is for use with FastSerialConn
  172.         by Filip Zawadiak, or if you need a slower than usual
  173.         transfer rate.
  174.  
  175.       - BUG FIX - corrected Bad CRC reporting format.
  176.  
  177.  0.2a - 25th September, 1997.
  178.  
  179.       - BUG FIX - now uses RTS/CTS handshaking (instead of none)
  180.  
  181.  1.0  - 4th October, 1997
  182.  
  183.       - NEW - Graphical User Interface via MUI 3.8
  184.  
  185.       - NEW - AmigaNPI no longer busy waits if the Newton is
  186.         not responding.
  187.  
  188.       - NEW - User can manually abort the transfer (if using the
  189.         graphical user interface).
  190.  
  191.       - NEW - User can set the serial flags personally.
  192.  
  193.       - NEW - Save serial preferences to ENV:AmigaNPI.prefs (from
  194.         graphical user interface only)
  195.  
  196.       - BUG FIX - now turns off Xon/Xoff handling (I hope this is
  197.         a bug fix, rather than introducing a new bug!)
  198.        
  199.       - Source code now split into four separate files.
  200.  
  201.  1.1  - 11th October, 1997
  202.  
  203.       - Used Delay_(1) instead of VWait in the serial handling
  204.         code.  Many people seemed to be experiencing serial
  205.         problems with 1.0, I hope this fixes the problem...
  206.         Delay_(1) is supposed to be more system friendly, and
  207.         also happens to further decrease processor load.
  208.  
  209. CONTACT
  210.  
  211.  Dr.David.Fong@medical.net.au (this is my permanent address)
  212.   - vkelim@onaustralia.com.au
  213.   - vkelim@ariel.unimelb.edu.au
  214.  
  215.  http://ariel.unimelb.edu.au/~vkelim/
  216.   - contains a lot of information about connecting the Newton
  217.     to the Amiga.
  218.