home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 214.MFJ1278.TXT < prev    next >
Text File  |  1989-03-15  |  14KB  |  370 lines
  1.  
  2.              To: QST
  3.  
  4.         Subject: MJF-1278 Software Documentation
  5.  
  6.  
  7.                    P R E L I M I N A R Y
  8.  
  9.  
  10.  
  11.                  Instructions for 1278.EXE
  12.                MFJ-1278 (R) Terminal Program
  13.             Distributed by KA3DXX, Severn, MD USA
  14.  
  15.  
  16.      1.   MACHINE REQUIREMENTS
  17.  
  18.           a.   Hardwire Required:  IBM (R) PC, or 100%      
  19. compatible operating under PC(MS)-DOS 2.0 or higher
  20.  
  21.           b.   One floppy disk drive
  22.  
  23.           c.   150 KBytes available RAM
  24.  
  25.           d.   Printer (optional)
  26.  
  27.      2.   SOFTWARE
  28.  
  29.           a.   1 - 5 1/4 inch floppy DS DS (360K floppy)
  30.  
  31.           b.   1278.EXE - Terminal Program
  32.  
  33.           c.   OPEN.MFJ - Configuration file (use optional)
  34.  
  35.           d.   CLOSE.MFJ - Configuration file (use is optional)
  36.  
  37.      3.   GETTING STARTED
  38.  
  39.           a.   If the RS-232 (COMn:) port to which your     
  40. MFJ-1278 is attached is configured as COM1: and you are     
  41. capable of operating at 9600 baud, then you may accept the
  42. program default settings of  COM1:9600,E,7,1 by simply
  43. typing:
  44.  
  45.           1278
  46.  
  47.           b.   If you plan to use the OPEN.MFJ              
  48. configuration file (described later) then you may include a 
  49. SETUP command in that file.  If you use the SETUP command   
  50. in the configuration file, then it must be the first        
  51. command in the OPEN.MFJ file.  If you choose this method    
  52. then execution begins simply by typing:
  53.  
  54.           1278
  55.  
  56.      c.   If you do not want the default settings and do    
  57. not wish to use a configuration file, or wish to override   
  58. either the default settings in the terminal program or in   
  59. the configuration file, then begin execution by typing:
  60.  
  61.      1278  n,bbbb,p,s
  62.  
  63.  
  64.           where     n    = port number, either 1 or 2
  65.                     bbbb = baud rates of 300, 1200
  66.                            2400, 4800, or 9600
  67.                     p    = parity of Even, Odd, or None
  68.                     s    = number of data bits, usually 7
  69.  
  70.  
  71.      4.   CONFIGURATION FILES
  72.  
  73.           a.   Two configuration files are allowed as       
  74. options to configure certain terminal parameters to your    
  75. choosing both when initializing the program AND when        
  76. terminating the program.
  77.  
  78.           b.   Both files are simple ASCII files that may   
  79. be created/edited with EDLIN (supplied with DOS) or any     
  80. other ASCII text editor.
  81.  
  82.           c.   Any valid MFJ-1278 command is allowed in the 
  83. file to configure the MFJ-1278 to one's liking;  several    
  84. pseudo commands are provided for configuring the terminal   
  85. program itself.
  86.  
  87.           d.  Why use the configuration files at all?  My   
  88. personal experience with the RAM battery backup system in   
  89. the MFJ-1278 is that if the power is turned on after having 
  90. been off for only a short time, all values in the RAM       
  91. resort to the default values.  To avoid the nuisance of     
  92. having to reset some of the values (including my call!)     
  93. each time by hand, I have included all changes to the       
  94. default values in the configuration file.  If more than one 
  95. operator uses the same MFJ-1278, then each can have his/her 
  96. own OPEN.MFJ, thus customizing the unit for each call for   
  97. each desired mode of operation.
  98.  
  99.      When I turn off the computer, but still want to be     
  100. able to use the MFJ-1278 as a CW keyer, I include the       
  101. command  MODE CW  in the CLOSE.MFJ file to leave the        
  102. MFJ-1278 in the CW mode.  (A corresponding  MODE HP  is     
  103. included in the OPEN.MFJ file to restore the MFJ-1278 to HF 
  104. Packet operation when the terminal program is next          
  105. initiated.)
  106.  
  107.  
  108.      5.   PSEUDO COMMANDS
  109.  
  110.           a.   SETUP  n:bbbb,p,s        Overrides default
  111.                                         values in terminal  
  112.                                         program.  IF USED,  
  113.                                         MUST BE FIRST       
  114.                                         COMMAND IN OPEN.MFJ 
  115.                                         file.  See par      
  116.                                         3.c., above. (NOTE:
  117.                                         a colon (:) is used
  118.                                         here!)
  119.  
  120.           b.   COLOR ON/OFF             If you have an RGB  
  121.                                         monitor, by all     
  122.                                         means use COLOR ON
  123.  
  124.           c.   FOREx n and BACKx n      Set Foreground and  
  125.                                         Background Colors 
  126.                                         n = 0  BLACK
  127.                                           = 1  BLUE
  128.                                           = 2  GREEN
  129.                                           = 3  CYAN
  130.                                           = 4  RED
  131.                                           = 5  MAGENTA
  132.                                           = 6  BROWN
  133.                                           = 7  WHITE
  134.  
  135.                               Function       Default
  136.           FORE1 and BACK1     Receive Text   White on Black
  137.           FORE2 and BACK2     Xmit Text      Green on Black
  138.           FORE3 and BACK3     Command Line   Black on White
  139.           FORE4 and BACK4     Connect Line   White on Black
  140.           FORE5 and BACK5     Status Line    Black on Brown
  141.           FORE6 and BACK6     Separators     White on Brown
  142.           FORE7 and BACK7     Function Key   Black on Cyan
  143.           FORE8 and BACK8     MultiDCA*>WB4FLT (RR)
  144. Connect   White on Red
  145.  
  146.           d.   TIME ON/OFF         Copy TIME from computer  
  147.                                    to MFJ-1278 during       
  148.                                    initialization
  149.  
  150.           e.   LOGFILE name.ext    Name of log file,        
  151.                                    including directory, if  
  152.                                    any 
  153.  
  154.  
  155.           f.   LOG ON/OFF          Set on if you want all   
  156.                                    events recorded.  May    
  157.                                    also be toggled on/off   
  158.                                    with the F5 key.
  159.  
  160.           g.   CONNECTFILE name.ext
  161.                                    Name of connect file,    
  162.                                    including directory,     
  163.                                    where you wish call      
  164.                                    signs and date/time of   
  165.                                    connect to be recorded.
  166.  
  167.           h.   CONNECT ON/OFF      Enable/disable recording 
  168.                                    of connects.  May also   
  169.                                    be toggled by F6 key.
  170.  
  171.  
  172.           i.   EDITOR name.ext     Name of editor (or other 
  173.                                    program), including      
  174.                                    directory, to be         
  175.                                    executed when the F4 key 
  176.                                    is depressed.  When      
  177.                                    named program finishes,  
  178.                                    control returns to       
  179.                                    1278.EXE.
  180.  
  181.  
  182.  
  183.      6.   FUNCTION KEYS
  184.  
  185.           F1   MENU selection of all MFJ-1278 operating     
  186.                modes
  187.  
  188.           F2   STREAM rotate through the ten streams A - J
  189.  
  190.           F3   Exit to DOS
  191.  
  192.           F4   Execute EDITOR (or other program of          
  193.                choice..see CONFIGURATION FILES
  194.  
  195.           F5   LOG  toggle logfile on and off
  196.  
  197.           F6   CONNECT..toggle connect file on and off
  198.  
  199.           F7   PRINT..toggle printer on and off
  200.  
  201.           F8   STATUS..performs a CStatus  BUT remembers    
  202.                comnmand/converse state
  203.  
  204.  
  205.           F9   Toggle multi-connect on and off.  When multi 
  206.                is on.. the top status lines shows the call  
  207.                signs of connected stations by stream.  A    
  208.                blinking letter indicates either a connect   
  209.                or disconnect in progress.
  210.      
  211.           F10  EXIT..the way home
  212.  
  213.          LeftArrow     COMMAND mode
  214.  
  215.           RightArrow    CONVERSE mode
  216.  
  217.      7.   SCREEN
  218.  
  219.           A split screen operation is used with four status 
  220. lines.  The largest part of the screen is dedicated to      
  221. incoming text.  The smallest, for outgoing text.
  222.  
  223.           In PACKET and AMTOR modes, the lower (outgoing    
  224. text) screen is in paragraph mode, i.e. no transmission is  
  225. made until the carriage return  <ENTER>  key is depressed.  
  226. In the other modes, screen is in character mode, i.e., each 
  227. characters is sent to the MFJ-1278 as it is typed.
  228.  
  229.           Under the default settings, the incoming text in  
  230. the upper screen is displayed in white on black.  The       
  231. echoed outgoing text is displayed in green on black, thus   
  232. improving readibility of the interleaved texts.
  233.  
  234.      a.   Bottom line shows shorthand description of
  235. function keys.
  236.  
  237.      b.   Lower status line shows COMMAND/CONVERSE state    
  238. and status of LOG file, CONNECT file, and PRINTER options.
  239.  
  240.      c.   Upper Status line shows call sign of most recent  
  241. connect, and RETRY, USER, PACLEN, UNPROTO values.
  242.  
  243.      d.   Top Status line shows value in MYCALL, current    
  244. mode of MFJ-1278, and terminal (RS-232 port) parameters.
  245.  
  246.      NOTE:  If MULTI is toggled on with F9, then the top    
  247. line shows which stream is connected and with what call     
  248. sign.  A blinking letter only indicates that either a       
  249. connect or disconnect is in progress.
  250.  
  251.      8.   GENERAL
  252.  
  253.         The program reflects the authors personal         
  254. preferences in a terminal program and is tailored           
  255. principally for packet, CW, and AMTOR.  Modifications are,  
  256. of course, possible and feed back of any sort is            
  257. appreciated.
  258.  
  259.  
  260. ======================= AND HERE IS SOME MORE INFORMATION ================= 
  261.  
  262.  
  263.             To: ALL@MDCBBS
  264.  
  265.         Subject: Software for MFJ-1278/PC-XT Users
  266.  
  267.  
  268. Attention MFJ-1278/PC-XT or Compatible Clone Users:
  269.  
  270.    There is new terminal software designed specifically for use with the
  271. MFJ-1278 Multi-Mode Data Controller.  It is free for "beta testing" from
  272. KA3DXX for a self-addressed stamped diskette mailer and diskette formatted
  273. for MS-DOS.  This software was written by K3QAP (Dick) and is available
  274. exclusively via KA3DXX by U.S. Mail.
  275.  
  276.    NOTE:  Although this software is designed specifically for use with the
  277. MFJ-1278, it may also be compatible with other MFJ TNC's.  Users of other
  278. MFJ TNC's are invited to use the software.
  279.  
  280.  
  281. Preliminary instructions for the MFJ-1278 terminal program.
  282.  
  283. 1.   This is a preliminary version undergoing Beta testing  
  284. by a group of interested radio amateurs.
  285.  
  286. 2.   To start the program, simply type
  287.  
  288.           1278
  289.  
  290.      The default is communcations port 1 at 4800 baud.
  291.  
  292.      IF THIS IS NOT SATISFACTORY for your system then type
  293.  
  294.           1278 a,b
  295.  
  296.           where     a is 1 or 2
  297.                     b is 300, 1200, 2400, 4800, or 9600
  298.  
  299.      EXAMPLE:  MFJ 1,300 sets comm port 1, 300 baud
  300.      See Also Par 5, below, for additional information
  301.  
  302. 3.   No file other than 1278.EXE is necessary, but two
  303. auxiliary files, which may be created by any text processor 
  304. such as EDLIN, Q, WORDSTAR, etc., allow you to customize    
  305. the setup of the MFJ-1278 to your own specifications.  A    
  306. sample file  OPEN.MFJ  is included and may be edited to     
  307. your liking.
  308.  
  309.      Similarly a file  CLOSE.MFJ  allows a sequence of      
  310. commands of your choosing to be sent to the MFJ-1278 before 
  311. the MFJ program exits.
  312.  
  313. 4.   ANY legal MFJ-1278 command may be included in the      
  314. file.  Additionally, other commands allow you to turn color 
  315. on/off, choose colors, select an text editor, name your     
  316. connect file and your log file.
  317.  
  318. 5.You may include a SETUP command in the OPEN.MFJ file to   
  319. tell the MFJ which comm port to use when initializing.  If  
  320. you use this option, then the setup command MUST BE the     
  321. first command in the OPEN.MFJ file.  The format is 
  322.  
  323. SETUP 1,300,E,7,1
  324.  
  325. The command line option, described in par 2, above,         
  326. overrides any file setup command.
  327.  
  328. 6.   AUTOSTAT.  An interesting feature is toggled on and    
  329. off by F9.  When on, the status of each of the 10 streams   
  330. and call sign of any connection is displayed on the top     
  331. line of the screen.  A blank means no connection, a         
  332. blinking letter in reverse video indicates a                
  333. connect/disconnect in progress, and a reverse video call    
  334. sign indicates a current connection.  This is particularly  
  335. useful in multi station contacts.
  336.  
  337. 7.   KENWOOD. An option to remotely control a Kenwood       
  338. transceiver has been removed from this version.
  339.  
  340. 8.  Hopefully, the remaining functions are self             
  341. explanatory.  The program shud not hang up regardless of    
  342. what keys you may hit, with the exception of the MFJ-1278   
  343. command which sets the MFJ to transparent mode.  This is    
  344. not a defect in the software.
  345.  
  346. 9.   F10 is the way to exit.  It gives you a second chance  
  347. to change your mind.  In my CLOSE.MFJ file, I issue a       
  348. restart to insure that the transmitter is not keyed when I  
  349. am not expecting it.  (This can happen!)
  350.  
  351. 10.  Enjoy and let me know.  Send comments or suggestions to
  352. better the software to K3QAP @ KA3DXX.
  353.  
  354. 11.  Since this is a preliminary version, please do not     
  355. provide copies to others.  The final product will be made   
  356. available to amateur radio operators via KA3DXX.            
  357. Hopefully an orderly distribution will allow us to keep     
  358. track of who has what when modifications/updates are        
  359. available.
  360.  
  361. 12.  Send self-addressed stamped diskette mailers and diskettes to:
  362.  
  363.       George H. Stickler - KA3DXX
  364.       8249 Quarterfield Road
  365.       Severn, Maryland 21144
  366.  
  367.  
  368.  
  369.  
  370.