home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol143 / packet.doc < prev    next >
Encoding:
Text File  |  1984-04-29  |  5.0 KB  |  169 lines
  1.                ---NOTES ON THE PACKET RADIO MODULES FOR CP/M---
  2.  
  3.  
  4.         Description of disk files.
  5.  
  6.         PACKET.ASM
  7.  
  8.         This is the main program.   It contains all the protocol logic as 
  9.         well as the disk file I/O for both receiving and sending.
  10.  
  11.  
  12.         PACIO.ASM
  13.  
  14.         This is the modem I/O module.  It has the routines which drive
  15.         the modem as well as the stations call sign.  It needs to be
  16.         customized for the hardware the user will be interfacing with.
  17.         Normally it will be the only module that needs to be changed.
  18.  
  19.         RECV.ASM
  20.  
  21.         This is a very small module which provides an entry from and
  22.         exit to CP/M for the receiver section of PACKET.ASM.
  23.  
  24.         SEND.ASM
  25.  
  26.         This  is  the same as RECV.ASM except that it causes entry to  the 
  27.         transmitting section of PACKET.ASM.
  28.  
  29.         SEQIO2.LIB
  30.  
  31.         This is a modified version of "SEQIO.LIB" from Digital Research.
  32.         The mods fix a bug which prevented it from working with the  RMAC 
  33.         assembler.   It  contains the disk file interface macros and is 
  34.         used by "PACKET.ASM" only.
  35.  
  36.  
  37.  
  38.               ---What to do with the above list of files---
  39.  
  40.         If you don't know what 8080 assembly language is I would  suggest 
  41.         you  get  some help or go back to playing STARTREK  because  some 
  42.         knowledge of this is required to modify the "PACIO.ASM" file.
  43.  
  44.         1)    Read the instructions in the "PACIO.ASM" file and modify it 
  45.         to match your hardware.
  46.  
  47.         2)   Use the Digital Research RMAC relocating macro assembler  to 
  48.         assemble the following files:
  49.                        SEND.ASM
  50.                        RECV.ASM
  51.                        PACKET.ASM
  52.                        PACIO.ASM
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                         1
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         3)   You will now have 4 .REL files
  69.                        SEND.REL
  70.                        RECV.REL
  71.                        PACKET.REL
  72.                        PACIO.REL
  73.  
  74.              Now  you need to link them with the Digital Research  linker 
  75.         "LINK.COM" to create two .COM files.
  76.  
  77.         Do this:  A>LINK SEND,PACIO,PACKET
  78.  
  79.                   A>LINK RECV,PACIO,PACKET
  80.  
  81.              Now  you have "SEND.COM" and "RECV.COM" which are the  ready 
  82.         to run packet radio programs.
  83.  
  84.  
  85.  
  86.  
  87.                  ----HOW TO USE THE SEND AND RECV PROGRAMS----
  88.  
  89.         SEND:
  90.  
  91.         First  of all there must be another station running the  RECV.COM 
  92.         program.   Assuming  this is the case,  to send him a file do the 
  93.         following:
  94.                        A>SEND TEST.ASM K4ZZ
  95.  
  96.         That caused the file "TEST.ASM" to be sent to K4ZZ.
  97.  
  98.         This is the sequence of events after typing the command.
  99.  
  100.         1)  Your station and the called station are IDed in morse code in 
  101.         the format:  HIS CALL   DE   YOUR CALL   ie:  K4ZZ DE WA4DSY.
  102.  
  103.         2)   An ENQ packet is sent to see if K4ZZ is on the air.
  104.  
  105.         3)   If an ACK packet is received from K4ZZ then Transmission  of 
  106.         the data packets will begin.
  107.  
  108.         4)    The  file "TEST.ASM" is sent 1024 bytes per  packet.   K4ZZ 
  109.         will send an ACK packet after each 1024 byte segment if no errors 
  110.         are detected.   Both stations will ID in morse code after every 8 
  111.         packets and at end of the last packet.   If K4ZZ detects an error 
  112.         he  will send a NAK packet and your station will  retransmit  the 
  113.         last packet up to 4 times.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.                                         2
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.         RECV:
  135.  
  136.         There  are 2 ways to use RECV.   If you simply want to go on line 
  137.         and  receive  all  messages or files addressed to  you  just  run 
  138.         RECV.COM.
  139.         example:       A>RECV
  140.  
  141.              If  you want to get a message or file from  another  station 
  142.         just  do  the  following (assuming the other station  is  running 
  143.         RECV.COM).
  144.  
  145.         example:       A>RECV TEST.ASM K4ZZ
  146.  
  147.              That  will  cause  K4ZZ to send you  the  TEST.ASM  file  as 
  148.         follows.
  149.  
  150.         1)   Your station sends a file request (FRQ) packet to K4ZZ.
  151.  
  152.         2)    If K4ZZ has the file on his disk he will send an ACK and go 
  153.         into send mode to send the file in the normal way as described in 
  154.         the SEND section then revert to RECV again.
  155.  
  156.         3)    Your station will go into the normal receive mode  and  get 
  157.         the packets from K4ZZ and store them on your disk.
  158.  
  159.                   *** SPECIAL CASE "DIR" *****
  160.  
  161.         If  the file name DIR is specified the directory of the disk will 
  162.         be sent or received as if it were a file.  It will be stored in a 
  163.         disk file named "DIR".   For example if you wondered what was  on 
  164.         K4ZZ's  disk you would type "RECV DIR K4ZZ".   After he sends you 
  165.         his directory you would "TYPE DIR" to see it.   You can send your 
  166.         directory  with  the command "SEND DIR K4ZZ".   He may  not  know 
  167.         where  it came from, since it will be stored on his disk as  "DIR" 
  168.         with no call sign.
  169.