home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 18 / amigaformatcd18.iso / -in_the_mag- / emulation / emus / connectors / zxmit.doc < prev    next >
Text File  |  1997-07-31  |  5KB  |  143 lines
  1.  
  2.  
  3.                                   ZXMIT V2.00
  4.                                   -----------
  5.  
  6.                      Spectrum/Amiga File Transfer Program
  7.                      ------------------------------------
  8.  
  9.                     Copyright (c) D.J.H.Hartley, 1990,1993.
  10.  
  11.  
  12.  
  13.    ZXmit can be used and distributed freely, but it is not public domain.
  14.    The author retains copyright. It may not be sold for profit, or included
  15.    with any commercial product without prior permission from the author.
  16.    This document must be supplied with the program and must not be modified.
  17.  
  18.  
  19.  
  20.    Format: ZXMIT TO|FROM|INFO <file> [NOHEAD]
  21.  
  22.  
  23.    ZXmit is a general purpose file transfer program for transferring files
  24.    between a ZX Spectrum and the Amiga, using the serial communication ports
  25.    of both computers.
  26.      It has only been tested on a 48K Spectrum and Interface 1 and these
  27.    documents are for the 48K Spectrum and Interface 1 although, without too
  28.    much difficulty, it should work for any Spectrum.
  29.  
  30.  
  31.    SERIAL CABLE
  32.    ------------
  33.    Make up cable as follows:
  34.  
  35.        Spectrum (Interface 1)             Amiga
  36.  
  37.           2 (TxD)---------------------------2 (TxD)
  38.           3 (RxD)---------------------------3 (RxD)
  39.           4 (DTR)---------------------------4 (RTS)
  40.           5 (CTS)---------------------------5 (CTS)
  41.           7 (GND)---------------------------7 (GND)
  42.  
  43.  
  44.    ZXMIT HEADERS
  45.    -------------
  46.    ZXmit headers are optional and are attached to the beginning of a file
  47.    saved on the Amiga. This allows ZXmit to retransmit the file back to the
  48.    Spectrum as faithfully as possible or to provide information to other
  49.    programs that may use the headers. They increase the file size by 12
  50.    bytes, and should be used except when transferring files that are to be
  51.    included in an Amiga program, raw bitmap graphics for example.
  52.  
  53.    These headers are compatible with the Speculator ZX Spectrum Emulator.
  54.  
  55.  
  56.    SPECTRUM TO AMIGA TRANSFER
  57.    --------------------------
  58.    In an Amiga CLI/Shell type:
  59.  
  60.        ZXMIT TO <file> [NOHEAD]
  61.  
  62.    where <file> is the file name you want it saved as. The optional NOHEAD
  63.    does not save a ZXmit header to the disc.
  64.  
  65.    Then on the Speccy one of the following:
  66.  
  67.        SAVE *"b"               for BASIC programs
  68.        SAVE *"b"LINE n         for BASIC programs + start line
  69.        SAVE *"b"CODE s,l       for code/data in memory
  70.        SAVE *"b"SCREEN$
  71.  
  72.        etc.
  73.  
  74.  
  75.    AMIGA TO SPECTRUM TRANSFER
  76.    --------------------------
  77.    On the Amiga:
  78.  
  79.        ZXMIT FROM <file>
  80.  
  81.    On the Speccy one of:
  82.  
  83.        LOAD *"b"               for BASIC programs
  84.        LOAD *"b"CODE           for code/data in memory (or screens)
  85.        LOAD *"b"SCREEN$
  86.  
  87.        etc.
  88.  
  89.      If the file on the Amiga was saved with a ZXmit header then ZXmit will
  90.    use this information as a header to send to the Speccy ie. BASIC/CODE,
  91.    start, length, etc. If the file doesn't have a header then a default
  92.    header of type 3 (code) and start address=25000 is sent to the Spectrum.
  93.  
  94.  
  95.    GENERAL
  96.    -------
  97.    The fault `wrong file type' (always on the receiving computer) indicates
  98.    a header format error. An alternative type of fault is that one side has
  99.    finished while the other is still in the process of transferring. These
  100.    errors are typically due to noise during transfer. Assuming that the
  101.    header that is to be transmitted is not at fault (corrupted), then abort
  102.    both computers and try the transfer again. ZXmit can be aborted at any
  103.    time using Ctrl-C.
  104.  
  105.  
  106.    INFORMATION ABOUT THE FILE ON THE AMIGA
  107.    ---------------------------------------
  108.    If you have saved the file on the Amiga with a header then information
  109.    about the file can be displayed on the Amiga. This also allows you to
  110.    see if the file does have a header.
  111.  
  112.        ZXMIT INFO <file>
  113.  
  114.      The information is then displayed on the screen. A type 0 is a BASIC
  115.    program and type 3 is code. Types 1 and 2 are numeric and string arrays
  116.    respectively. The number after the type indicates Speculator compression,
  117.    0=not compressed. Note ZXmit does not compress transmitted files and does
  118.    not retransmit compressed files. Length is the number of bytes in the data
  119.    block. Start is either the start address of code or the run line for BASIC
  120.    programs, values >= 16384 indicate that the program does not auto-run.
  121.    BASIC is the number of bytes taken by the program part of a program.
  122.  
  123.  
  124.    PROTOCOL
  125.    --------
  126.    The protocol used is the default Speccy one when it boots, that is:
  127.    9600 baud, 8 bits, no parity, 1 stop bit, RTS-CTS. But as the protocol is
  128.    default on the Speccy (just make sure if you have changed the baud rate
  129.    on the Speccy that you change it back to 9600) and in the Amiga is hidden
  130.    inside ZXmit, you don't have to worry about it.
  131.  
  132.  
  133.  
  134.    Any queries, suggestions, spare cash, beer, etc. to:
  135.  
  136.      Danny Hartley
  137.      1 Alexandra Drive
  138.      Prestatyn
  139.      Clwyd
  140.      LL19 8BW
  141.      U.K.
  142.  
  143.