home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol181 / minimod.dqc / MINIMOD.DOC
Encoding:
Text File  |  1985-02-10  |  6.8 KB  |  162 lines
  1.          MINIMOD - a subset modem program for MSDOS.
  2.          ===========================================
  3.  
  4.           Dave Moore,
  5.           QCOM Pty Ltd
  6.           May 84.
  7.  
  8.           This  program  is  copyright.  (Yes,  really  - its  in 
  9.           source!)  Permission is granted to use it,  but not for 
  10.           profit,  provided  that this notice is retained   along 
  11.           with  the start up message in the program  itself,  and 
  12.           provided that any modified versions of this program are 
  13.           returned  to  the public domain by submission  to  this 
  14.           system.
  15.  
  16.  
  17. The  minimod program is a small modem program which should run on 
  18. any  MSDOS machine.  So far,  it has been run on an HP150  and  a 
  19. SHARP  PC-5000  'Squirrel'.  Providing your BIOS  is  competently 
  20. written,  and you have a serial port, it will run on your machine 
  21. without  any machine specific information beyond the name of your 
  22. serial port driver.
  23.  
  24. Before loading Minimod, you must configure your serial port for 8 
  25. data bits,  no parity.  If you are intending to talk to an  RCPM, 
  26. you   will  want  to  set  300  baud.   Otherwise,   if  you  are 
  27. communicating between local machines,  start at 1200 baud and get 
  28. your interface working,  then try a greater baud rate. If you can 
  29. not  disable  parity on your machine,  you will not  be  able  to 
  30. transfer binary files using Christensen protocol. Minimod is able 
  31. to transfer data in Hex to overcome this problem.  (This code has 
  32. not been tested as it hasn't proved neccessary.)
  33.  
  34. Next,  enter  the  command 'Minimod'.  You should see the  prompt 
  35. 'Minimodem  :'.  If you get an error message and minimod  aborts, 
  36. check that the device name in AUXNAM is correct.
  37.  
  38. All commands are 1 or two characters in length and are similar to 
  39. the  commands  to  be  found in YAM.  If  a  command  requires  a 
  40. filename,  you will be prompted for the file name after you  have 
  41. entered the command. Do not attempt to enter the file name on the 
  42. same line as the command.
  43.  
  44. The commands are:
  45.  
  46.      t     - enter terminal mode. Use control E to get out.
  47.  
  48.      th    - enter  terminal mode.  Echo characters typed on  the 
  49.              keyboard  on  the screen.  (like pressing  the  half 
  50.              duplex key on a terminal)
  51.  
  52.              Note that there is no file logging available.
  53.  
  54.      r    -  receive a file using Christensen protocol.  Only the 
  55.              checksum  form of Christensen  is  supported.  Batch 
  56.              mode is not supported.  You will be prompted for the 
  57.              file name for the data after you enter this command.
  58.  
  59.      s    -  send a file using Christensen protocol.  You will be 
  60.              prompted  for  the  file name after  you  enter  the 
  61.              command. Always enter the receive command before you 
  62.              enter the send command, otherwise the computer doing 
  63.              the  send may time out before you get the other  end 
  64.              going.
  65.  
  66.      ph   -  Use hex for Christensen send and receive.
  67.  
  68.      pb   -  Set  use  binary for Christensen send  and  receive. 
  69.              (default)
  70.  
  71.      f    -  Transmit a file a if it was being typed in. This and 
  72.              the next command are discussed further below.
  73.  
  74.      fw   -  Transmit  a file,  but after each carriage return is 
  75.              sent,  wait  for a prompt character from the  remote 
  76.              machine.
  77.  
  78.      pg   -  Set  prompt character for use with fw  command.  The 
  79.              prompt character must be hard up against the g.
  80.  
  81.      pw   -  Set  the  time out time for waiting  for  characters 
  82.              from the remote terminal.  PW2 is the  default.  The 
  83.              wait  shoul be a decimal digit but the program  will 
  84.              accept any character. If your Christensen send keeps 
  85.              timing out, put this value up.
  86.      
  87.      pc   -  Set  the choke parameter.  After each  character  is 
  88.              sent  to  the  remote machine,  the  program  counts 
  89.              down from the number entered (*1004) to  zero.  This 
  90.              enables  you to slow down a fast machine when it  is 
  91.              talking  to a slow machine.  The default is PC3.  If 
  92.              you are dropping characters,  put this value up.  If 
  93.              you are sending large files in Christensen  protocol 
  94.              at  high baud rates (eg >300),  set this to zero and 
  95.              see if it will work.
  96.  
  97.      ex   -  Return to MSDOS. You can also get back to MSDOS with 
  98.              Control C.  Minimod does not currently set the  line 
  99.              driver back the way it found it. 
  100.  
  101. Getting Minimod across to a new machine. 
  102. ========================================
  103.  
  104. If  you  have a machine with YAM or Minimod on  it,  getting  the 
  105. program across is easy.  If you haven't, see the notes on booting 
  106. Yam and MODEM7 for some ideas.
  107.  
  108. To  move it from a machine with Yam or Minimod to a new  machine, 
  109. connect the machines as described earlier. On the machine you are 
  110. moving to type the command:
  111.  
  112. CTTY \AUX ( or whatever your driver is called)
  113.  
  114. This transfers control of your computer to the remote machine.
  115.  
  116. Fire up Yam or minimod on the source machine and go into terminal 
  117. mode  with the 't' command.  Press 'return' and you should get  a 
  118. prompt  from the remote machine.  You should now be able to enter 
  119. commands to the target machine.
  120.  
  121. Enter the command
  122.  
  123.      EDLIN MINIMOD.ASM
  124.  
  125. You will get an asterisk in reply.  Type 'I'.  You should get the 
  126. line:
  127.      1:*
  128.  
  129. Now exit out of terminal mode with CTRL E and enter the following 
  130. commands (not the stuff in brackets).
  131.  
  132.      PG*       (set the wait character to asterisk)
  133.      FW MINIMOD.ASM (transmit the file)
  134.  
  135. The  file will now be sent to the remote machine.  This  will  be 
  136. fairly  slow.  You  can speed it up by setting PW0  and  PC0.  In 
  137. particular, PW0 will speed things up, since after a tab character 
  138. is  sent,  Minimod  waits for blanks to stop coming  back  before 
  139. continuing.  This  helps prevent garbling of characters,  but may 
  140. not  be required by your equipment.  If you find that  characters 
  141. are being lost, try increasing PW and/or PC. 
  142.  
  143. You can now assemble and link Minimod on the new machine by going 
  144. back into terminal mode and entering 
  145.  
  146.      MASM MINIMOD;  (The semicolon is advisable)
  147.      LINK MINIMOD;  (Ditto)
  148.  
  149. Now  run the program,  transfer MINIMOD again  using  christensen 
  150. protocol, and compare the two files using 
  151.  
  152.      FC MINIMOD.ASM MINIMOD.NEW (say) 
  153.  
  154. They should match to within a few nulls at the end of the file.
  155.  
  156. Good luck.  If you update the program,  please put a version back 
  157. on the system.
  158.  
  159.           Dave Moore,
  160.           QCOM Pty Ltd,
  161.           Brisbane 2293544
  162.           22 May 84