home *** CD-ROM | disk | FTP | other *** search
/ Amiga GigaPD 3 / Amiga_GigaPD_v3_3of3.iso / libs / xprjmodem.doc < prev    next >
Text File  |  1993-06-25  |  3KB  |  67 lines
  1.  
  2.            XPR JMODEM File Transfer Protocol, Amiga Version 0.1
  3.           ------------------------------------------------------
  4.  
  5.   Based on original implementation version 1.20 by Richard B. Johnson
  6.   for IBM PC compatibles. Amiga port made by Kenneth Osterberg, released
  7.   into public domain June 10, 1989.
  8.   XPR Amiga Library Version made by Markus Pietz on Okt, 1990.
  9.  
  10.   Diese Files sollten sich im Archiv befinden:
  11.   xprjmodem.library  Die fertige XPRLibrary, compiliert mit AztecC V5.0
  12.   JModem.c           Der C Sourcecode fⁿr das Protocol
  13.   docrc.asm          Assembler Sourcecode der fⁿr die Checksummen berechnung
  14.                      zustΣndig ist
  15.   timeout.c          Routine die eine Delay() Funktion bereit stellt.
  16.   libsup.c &         Routinen die beim ÷ffnen und schlie▀en der Library
  17.   mylib.h &          angesprungen werden.
  18.   libstart.asm
  19.   Makefile           Makefile fⁿr AztecC V5.0
  20.  
  21.   Kurzanleitung zu JModem:
  22.    Fⁿr genaue Informationen ⁿber das JModem Protocol siehe die
  23.    Original Anleitung bei der JModem Implemation fⁿr PC.
  24.  
  25.   Features:
  26.   o      16-bit CRC fⁿr efficiente Fehlerfindung
  27.   o      Eine Limitierte Form von Datencompression.
  28.   o      Schnelle Syncronisation mit der Gegenstelle
  29.   o      Variable LΣnge der ▄bertragenden Bl÷cke von bis zu 8192 Bytes,
  30.          je nach QualitΣt der Verbindung
  31.   o      Es gibt keine Mindest Gr÷▀e der ⁿbertragenden Bl÷cke,
  32.          mⁿssen nur 2 Bytes ⁿbertragen werden, werden nur 2 ⁿbertragen
  33.          ( plus BlockHeader)
  34.  
  35.   BeschrΣnkungen:
  36.   o      Filename, -gr÷▀e, und Σnderungs Datum werden nicht ⁿbertragen :-(
  37.   o      Das Protocol arbeitet mit Handshaking fⁿr jeden Block.
  38.          Das verlangsamt die ▄bertragung, es mu▀ aber kein Nachteil sein
  39.          weil so schnell auf die QualitΣt der ▄bertragungsleitung
  40.          reagiert werden kann.
  41.  
  42.   Datencomprimierung:
  43.    Beim verwendeten Compressionsverfahren ist es nicht sicher das die
  44.    LΣnge des Blocks wirklich kⁿrzer wird (b.z. bei schon comprimierten
  45.    Files), deshalb werden von Fall zu Fall Comprimierte oder nicht
  46.    Comprimierte Blocks ⁿbertragenden.
  47.    Die Compressionsmethode hei▀t Run-Length-Encoding. Sie wird auch
  48.    bei IFF-Bildern verwendet.
  49.  
  50.   XPR-Implementierung:
  51.    Jedes Programm was mit der XPRZmodem.library functioniert sollte
  52.    auch mit JModem laufen.
  53.  
  54.    Zur Information wΣhrend der ▄bertragung werden folgende Daten ausgegeben:
  55.    XPRU_BYTES, XPRU_BLOCKS, XPRU_BLOCKSIZE, XPRU_ERROR, XPRU_MSG, XPRU_FILENAME
  56.    beim Senden zusΣtzlich: XPRU_FILESIZE
  57.  
  58.    Die Library braucht zum Senden und zum Empfangen einen Filenamen
  59.    weil das Protocol das Mitversenden des Filenamens wie ZModem nicht
  60.    unterstⁿtzt.
  61.  
  62.    Folgende Call-Back-Funktionen mⁿssen bereitgestellt werden:
  63.     fopen(),fclose(),fread(),fwrite(),
  64.     sread(),swrite(),sflush(),
  65.     update(),chkabort()
  66.  
  67.