home *** CD-ROM | disk | FTP | other *** search
/ Boink! 1995 February / BOINK_CD2.ISO / dfue / mdr / mdr52doc.exe / MDR52FST.TXT < prev   
Text File  |  1993-06-02  |  41KB  |  1,123 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.               __________________________________________________
  8.                                     T H E 
  9.                                   M O D E M
  10.                                  D O C T O R
  11.                              Version 5.2S / 5.2R
  12.                   Hank Volpe copyr. 1989,1990,1991,1992,1993
  13.                                 P.O. Box 43214
  14.                               Baltimore MD 21236      
  15.                __________________________________________________
  16.  
  17.  
  18.  
  19. Thank you for using the Modem Doctor. This file offers you a brief
  20. introduction into how the program works, and how you can use the Modem
  21. Doctor to solve your communication problems. 
  22.  
  23. Why would you need the Modem Doctor? Well, have you ever tried to install
  24. a serial card or a modem to find out that you have the IRQ lines set
  25. wrong, or the modem cable wired wrong, or some silly jumper set
  26. incorrectly? What about when you have had trouble connecting to a BBS? Is
  27. it the phone line, your setup, or your modem? Could it be the uart,
  28. settings on your serial card, or an incorrect assignment of the base port
  29. address? The Modem Doctor was written to assist you with all of these
  30. problems and some of the pitfalls involved in Personal Computer
  31. communications. 
  32.  
  33. The Modem Doctor checks every serial port chip (uart) register, checks
  34. cables and modems for proper handshaking signals, and will inform you if
  35. it runs across something that isn't set properly. Modems are also
  36. rigorously tested, including handshaking tests and modem self-connect
  37. tests which simulate an on-line connection. IRQ assignment errors, base
  38. port addressing errors, and a host of other settings are checked. The
  39. Modem Doctor also will inform you of the type of uart and modem you have
  40. installed, and will print a copy of the test results to a printer or a
  41. file.
  42.  
  43. I feel the Modem Doctor is very easy to use, in fact all you need to do is
  44. move the cursor around with your arrow keys and press return to run a
  45. feature or press the escape key to get out. You can get help at any time
  46. by pressing ALT-H. You can change the baud rate of the port you are
  47. working with at any time by pressing ALT-B. ALT-F is used to by-pass the
  48. microprocessor tests (which is discussed more in the technical reference
  49. manual). These special keys are called "Hot-Keys", and can be short-cuts
  50. at times during testing.
  51.  
  52. Remember a left or a right arrow is used to move around the main menu.
  53. Pressing enter will activate a pulldown window. Use the up or down arrows
  54. to make a selection. Press enter to start a test or escape to abort. Use
  55. any of the "hot-keys" at any time you wish. It's that simple!
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  74.  
  75.  
  76.  
  77. Starting Modem Doctor
  78. ---------------------
  79.  
  80. Here is a list of all the Modem Doctor files. Make sure you are logged
  81. onto the disk drive that has all of these files. Hard disk users should be
  82. logged into a directory that contains these files;
  83.  
  84. MDR.EXE       The Modem Doctor program executable file.
  85. MDR.CFG       A file that contains your custom color selections 
  86.                (optional, created by the user).
  87.  
  88. MDR5.DRV      A reserved file name for future external modem drivers.
  89.                (there are currently no files with this name).
  90.  
  91. MDR.DAT       A file that contains user created setup instructions for
  92.                running MDR in the /S mode (this will be explained later).
  93.  
  94. MDR.MNU       A mouse driver file that can be loaded with any Microsoft-
  95.                compatible menu load program (such as menu.com).
  96.  
  97. The program MDR.EXE can be run out of a dos path command without you being
  98. logged into the proper directory or disk, however the user selected
  99. configuration (MDR.CFG) and external driver files will not be used.
  100.  
  101. Also included with the Modem Doctor are the following text files that are
  102. a good source of technical information about testing, and the history of
  103. the Modem Doctor program. Included is an order form, for the Modem Doctor
  104. is distributed in two versions. The shareware version (5.0S) allows you to
  105. take a look at the Modem Doctor before you buy it. The Registered Version
  106. (5.0R) includes more features, comm port selections, higher baud rates and
  107. some extra test information. I feel quite certain you will agree that the
  108. Registered Version is worth the price of $19.95 (which includes shipping
  109. in the U.S.). Here is a list of these support files;
  110.  
  111.  
  112. MDR5DOC.TXT   The Technical reference Manual that explains in detail the
  113.               operation and testing of your modem and uart. 
  114.  
  115. MDR5FST.TXT   This file.
  116. MDR5ORDR.TXT  The form for you to use to order the registered version of 
  117.               the Modem Doctor.
  118.  
  119. There are four modes that the Modem Doctor operates in; normal, bios
  120. writes, setup (/s) and exchange (/x).
  121.  
  122. Normal mode is simply starting the Modem Doctor from the dos prompt by
  123. typing; MDR. 
  124.  
  125.  
  126.                                         Page 2
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  140.  
  141.  
  142.  
  143. Bios write mode is a feature that you might use if you have a totally
  144. incompatible display adapter. If you are visually impaired, this feature
  145. allows the text of the Modem Doctor to be echoed to your speech
  146. synthesizer system. Bios writes use the ROM-Bios of your computer instead 
  147. of working to the display adapter. This method is very slow compared to
  148. screen writes, so if you have no need for it, I would suggest that you
  149. refrain from using it. Starting the Modem Doctor in this bios write mode
  150. is done from the dos prompt by typing ; MDR /b
  151.  
  152. Setup mode is a very useful feature and gives you the ability to use the
  153. Modem Doctor every day. Setup mode is used to send setup strings
  154. (initialization strings) to your modem. In this mode, the Modem Doctor
  155. looks for a file called MDR.DAT, which you make with a simple ASCII text
  156. editor. This file contains the port, the baud rate, and the setup string
  157. you want to send to the modem. If the modem received this information
  158. properly, a message is printed to the screen, and an errorlevel of 0 is
  159. returned. If there is a problem, a message is printed and an errorlevel of
  160. 99 is returned. You can use this feature inside batch files, and these
  161. errorlevels can be used to trigger different actions. This mode is
  162. explained in great detail, with example batch files and MDR.DAT files.
  163. Starting the Modem Doctor in this setup mode is done from the dos prompt
  164. by typing ; MDR /s
  165. (Note, the setup mode is a registered feature).
  166.  
  167. New in Version 5.0, you can instruct Modem Doctor to use a comm driver 
  168. instead of its normal, uart control functions. This allows you to test the 
  169. operation of FOSSIL or other INT 14 drivers. A warning though, most comm 
  170. drivers do not allow Modem Doctor complete diagnostic testing ability. Always 
  171. make sure your modem is operating properly with Modem Doctor before you use 
  172. the FOSSIL feature. To start Modem Doctor in this mode, type MDR /i (for INT 
  173. 14 generic interface) or MDR /F (for FOSSIL support). Modem Doctor works with 
  174. both standard and extended version FOSSILS.
  175.  
  176. Version 5 of Modem Doctor includes routines that verify the actual occurance 
  177. of interrupts associated with Comm ports. In this mode, Modem Doctor will
  178. verify assignments and also report if they are associated with a mouse
  179. driver. However, self-testing of IRQ's may not be desirable in all 
  180. environments. Additionally, some environments may "freeze" when running 
  181. Modem Doctor in the IRQ test mode. Bypassing these tests is accomplished
  182. by typing ; MDR /Q at the dos prompt.
  183.  
  184. Finally, the exchange mode is used to swap Comm pointers in memory. This
  185. makes Com1 act like Com2. The main reason for this feature is so you can
  186. access a serial device that is not interrupt driven (like a printer) from
  187. some high level languages that do not allow access to Com2. Some programs
  188. do not work with two Comm ports. Running the program does not permanently
  189. alter anything, all changes can be restored by running the Modem Doctor in
  190. exchange mode again, or by warmbooting your computer. Starting the Modem
  191.  
  192.                                         Page 3
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  206.  
  207.  
  208. Doctor in this exchange mode is done from the dos prompt 
  209. by typing; MDR /x. 
  210.  
  211. You can use MDR /x to swap any of the 4 Dos comm port pointers besides the 
  212. defaults of Com1 and Com2. To do this just type the numbers of the two ports 
  213. you wish to switch..ie  MDR /x 1 4  will swap Com1 and Com4. MDR /x 2 3 will 
  214. swap Com2 and Com3. 
  215.  
  216. The following pages show you operating instructions that you receive when
  217. the Modem Doctor runs in the normal or bios write modes.
  218.  
  219. After the Modem Doctor starts, you are presented with the following
  220. screen;
  221.  
  222. ┌───────────────────────────── The Modem Doctor─────────────────────────────┐
  223. │                         Welcome to the Modem Doctor                       │
  224. └───────────────────────────────────────────────────────────────────────────┘
  225.     ╒[ Modem / Uart Hardware Detection]══════════════════════════════════╕
  226.     │ Port assignments  Base(hex)    Irq       Special Port Usage        │
  227.     │ Com port 1   [ ]     3f8        4                                  │
  228.     │ Com port 2   [ ]     2f8        3    IRQ assigned to a mouse driver│
  229.     │ Com port 3   [ ]  not found                                        │
  230.     │ Com port 4   [ ]  not found                                        │
  231.     │ Com port 5   [ ]                                                   │
  232.     │ Com port 6   [ ]                                                   │
  233.     │ Com port 7   [ ]                                                   │
  234.     │ Com port 8   [ ]                                                   │
  235.     └────────────────────────────────────────────────────────────────────┘
  236.  
  237.  ╔[  Serial Port Detection ]═══════════════════════════════════════════════╗
  238.  ║                          Serial port detection                          ║
  239.  ║                Searching for other standard active Comm ports           ║
  240.  ║                                                                         ║
  241.  ║                              Total Comm ports  =2                       ║
  242.  ║                        PRESS ANY KEY TO START TESTING                   ║
  243.  ║                                                                         ║
  244.  ║                                                                         ║
  245.  ║                                                                         ║
  246.  ══════════════════════════════════════════════════════════════════════════╝ 
  247.  
  248.  
  249.  
  250. When you start Modem Doctor for the first time, two windows are displayed on 
  251. screen. The first window, (Modem/Uart Hardware detection) gives you a 
  252. snapshot of your computer/serial port hardware. In the example above, it 
  253. found 2 Comm ports (or serial ports). The registered version also looks for 
  254. custom Comm ports (those defined by a user in a section called Log-in). 
  255.  
  256. New in version 5.0, Modem Doctor will also attempt to verify which IRQ line 
  257.  
  258.                                         Page 4
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  272.  
  273.  
  274. your comm port is using. Modem Doctor traps IRQ's 2,3,4,5,7 and then creates 
  275. a situation that should cause an interrupt. When the interrupt happens, Modem 
  276. Doctor notes the IRQ line, and displays it under the IRQ heading. If no 
  277. interrupt occurs, a 0 is displayed, which means you may have an IRQ problem, 
  278. or you need to use a FOSSIL driver for support. (See the tech reference 
  279. manual under FOSSILS and TIMER routines).
  280.  
  281. Also new in version 5.0, if a serial port is being used by a mouse driver, 
  282. Modem Doctor will flag this usage. This is done by requesting this info from 
  283. the mouse driver. Note, this feature only works with Microsoft compatible 
  284. mouse drivers.
  285.  
  286. Meanwhile, the Serial Port Detection window displays what Modem Doctor is 
  287. doing. This window maintains a dialogue between you and the program, and if 
  288. problems or special instructions need to be displayed, they are shown in this 
  289. window.
  290.  
  291. Finally, at the bottom of the screen, the copyright notice is displayed 
  292. along with either "shareware version" or your personal serial number. As a 
  293. registered user, you need your serial number for support and for 
  294. updates.After you press return, you will get the following windows on your 
  295. screen;
  296.  
  297. At this point, pressing any key will bring up a series of windows, whose 
  298. function is explained below;
  299.  
  300.  ╔[  Ports  ]═╗   ╔[  IRQ's  ]═╗    ╔[  Baud  ]══╗  
  301.  ║ Use COM 1  ║   ║ Use IRQ 2  ║    ║   300 BPS  ║  
  302.  ║ Use COM 2  ║   ║ Use IRQ 3  ║    ║  1200 BPS  ║  
  303.  ╚════════════╝   ║ Use IRQ 4  ║    ║  2400 BPS  ║  
  304.                   ║ Use IRQ 5  ║    ║  4800 BPS  ║ * 
  305.                   ║ Use IRQ 7  ║    ║  9600 BPS  ║ * 
  306.                   ╚════════════╝    ║ 19200 BPS  ║ * 
  307.                                     ║ 38400 BPS  ║ * Registered Versions
  308.                                     ║ 57600 BPS  ║ * only
  309.                                     ╚════════════╝  
  310.  
  311.  
  312. The Ports window will only display valid comm ports that you can work with. 
  313. The IRQ window automatically selects what it believes is the correct IRQ 
  314. (based on its tests), however you are free to select any IRQ line you wish. 
  315. Note- selecting the wrong IRQ is a great way to get all kinds of useless 
  316. error messages, so unless you think Modem Doctor made a mistake, use the 
  317. choice that Modem Doctor has made for you. Finally, you can pick a baud rate. 
  318. Although any computer, even an old XT will work at the highest rates, you 
  319. should realize that only fast machines can really use faster speeds. Make 
  320. sure you read the sections in the Technical Reference Manuals regarding 
  321. HISPEED modems and Interrupt Latency testing.Use the up or down arrow keys to 
  322. move the highlighted bar to your selection. If you are using a mouse, and if 
  323.  
  324.                                         Page 5
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  338.  
  339.  
  340. you have the custom Modem Doctor mouse driver loaded, , moving the mouse up 
  341. or down on your pad will do the same thing. Press return or the left mouse 
  342. key to complete your selection.
  343.  
  344. Please take care when selecting a baud rate, for you should not select 
  345. a speed faster than the modem you wish to test can support. If you are just
  346. testing the serial port without a modem, you can set the speed anywhere. In
  347. the example above, say we decided to use port 2 and use 2400 bps as the
  348. speed. 
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.                                         Page 6
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  404.  
  405.  
  406.  
  407. After selecting the speed, you will get the next window;
  408.  
  409.                     ╒[  Select an Option  ]═══════════════╕
  410.                     │ Test Modem / Port 2 to 2400 BPS     │
  411.                     │ Test the Uart Hardware Only         │
  412.                     │ Don't set up modem, return to Menu  │
  413.                     └─────────────────────────────────────┘
  414.  
  415. Testing the Modem and the Port starts a series of tests which communicate
  416. to the comm port, talk to the microprocessor in the modem, run a few tests
  417. of the modem in what is called the "command mode" and then it displays of
  418. all Uart status and control and the first 16 Modem S-registers.
  419.  
  420. If you decide to test the uart only, then only the comm port section of the
  421. tests are run. You should use this test if you are just testing the comm
  422. port, or if you want to determine if the problem you are having is with the
  423. modem or the comm port.
  424.  
  425. The last option gives you the ability to change your mind in case you made
  426. an error in any of the port or baud rate choices, or simply hit the escape
  427. key to get out of this testing.
  428.  
  429. The Modem Doctor requires that you have logged in at least 1 comm port so
  430. that it can execute tests. So, if this is your first time through and you
  431. did not select, you will be "beeped" and warned to setup a port in order to
  432. access any of the other tests with the exception of auto-login and manual
  433. log-in (for registered users). If you have selected at least 1 comm port,
  434. then if you escape, the last settings you used will still be in force.
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.                                         Page 7
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  470.  
  471.  
  472.  
  473. Assuming you made a selection to start testing, the Modem Doctor now begins
  474. testing. If you selected to test the modem and the port, you will get the
  475. following displayed to you in most instances;
  476.  
  477.     ╒[ Modem / Uart System Diagnostics]══════════════════════════════════╕
  478.     │ Comm port /IRQ in use [ ] Port = 1  Address = 3F8  IRQ = 4         │
  479.     │ Int 14 interface      [ ] Inactive                                 │
  480.     │ Uart type             [ ] 16450/8250A detected                     │
  481.     │ Baud rate selected    [ ]  2400                                    │
  482.     │ Baud Rate reg test    [ ] Confirmed correct baud rate              │
  483.     │ Modem Microprocessor  [ ] Modem Microprocessor On-Line             │
  484.     │ Modem ID Type         [ ] 9600+ bps modem                          │
  485.     │ Modem Memory/Rom      [ ] Memory tests OK                          │
  486.     └────────────────────────────────────────────────────────────────────┘
  487.  
  488. ╒[ Diagnostic Dialog]═══════════════════════════════════════════════════════╕
  489. │                  Preliminary diagnostic checks of hardware                │
  490. │                  -----------------------------------------                │
  491. │                   Confirmed uart setup to proper baud rate                │
  492. │                          Testing Modem Microprocessor                     │
  493. │                          --------------------------                       │
  494. │                                                                           │
  495. │                   Modem microprocessor command bus active                 │
  496. │                Modem ID reports a 2400 bps modem installed                │
  497. │                    Modem microprocessor memory tests OK                   │
  498. │                Modem microprocessor accepts setup commands                │
  499. │                     Modem - Uart status appears correct                   │
  500. │              Press any key to see register status and diagnosis           │
  501. │                                                                           │
  502. └───────────────────────────────────────────────────────────────────────────┘
  503.  
  504.  
  505. What did the Modem Doctor do? Well, first, the Modem Doctor looked for the
  506. type of uart so that it could figure out what tests to run. It next checked
  507. a very important register in the uart that holds the baud rate divisor. It
  508. programmed it for a certain speed and then made sure that speed was indeed
  509. held properly in the uart register. These same tests are run if you had
  510. decided only to run the uart tests and not the modem tests (or visa versa).
  511.  
  512. Next, the Modem Doctor established communications with the modem
  513. microprocessor. There are dozens of ways in which this could happen, but
  514. for starters, it figures you are using an "AT" compatible instruction set.
  515. There are ways to test modems of any kind with the Modem Doctor. This
  516. information is available in the technical reference manual that comes with
  517. the Modem Doctor, so for now just assume this is a standard PC-type modem.
  518. When the Modem Doctor makes contact, it tells you that the modem is in the
  519. command mode. it then asks the modem for its ID number. Theoretically, this
  520. should indicate the maximum speed your modem can work at, however, there
  521.  
  522.                                         Page 8
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  536.  
  537.  
  538. are some manufacturers that do not follow this convention, so don't be
  539. alarmed if you have a 9600 bps modem and it says you have a 2400 bps
  540. installed, for the Modem Doctor is only working with information provided
  541. by the manufacturer and stored in its ROM. Next, a quick test of the RAM
  542. and ROM memory is run. Some modems do both, others only do one or the
  543. other. Finally, a setup string is sent to the modem, which should respond
  544. back properly. If you decided to run the uart tests alone, then none of
  545. these modem tests are run.
  546.  
  547. Finally, the screen is filled with displays that show you the internal
  548. settings of the Uart registers and the first 16 S-registers. Many modems
  549. have more than 16 S-registers, however these first 16 are the only
  550. universally agreed-upon registers. If a problem turns up, you will get a
  551. diagnostic message that points out the error gives you an idea of what the
  552. problem can be.
  553.  
  554. A normal Uart test sequence looks like this;
  555.  
  556. ╒[ Line Control Register ]══════════╕
  557. │  DLB STB STP EPS PEN STB WS1 WS0  │ * These will alternate color. Dark
  558. └───────────────────────────────────┘   for a logic low, Bright for a
  559. ╒[ Line Status Register ]═══════════╕   logic high. If all is ok
  560. │      TSE THE BI  FE  PE  OE  DR   │   you get the diagnostic window
  561. └───────────────────────────────────┘   message displayed below.
  562. ╒[ Modem Control Register ]═════════╕
  563. │              LP  OT2 OT1 RTS DTR  │
  564. └───────────────────────────────────┘ ╒[ Diagnostics ]══════════╕
  565. ╒[ Modem Status Register ]══════════╕ │    Hardware tests OK    │
  566. │  RLS RI  DSR CTS DRD TER DDR DCS  │ │Press any key to continue│
  567. └───────────────────────────────────┘ │                         │
  568. ╒[ Interrupt ID Register ]══════════╕ └─────────────────────────┘
  569. │                      ID1 ID0 ITP  │
  570. └───────────────────────────────────┘
  571. ╒[ Interrupt Enable Register ]══════╕
  572. │                  ESI ELI ETI ERI  │
  573. └───────────────────────────────────┘
  574. ╒[ Interrupt Mask Register ]════════╕
  575. │  IQ7 IQ6 IQ5 IQ4 IQ3 IQ2 IQ1 IQ0  │
  576. └───────────────────────────────────┘
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.                                         Page 9
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  602.  
  603.  
  604.  
  605. If however something is wrong, you will get this display;
  606.  
  607.  
  608. ╒[ Line Control Register ]══════════╕
  609. │  DLB STB STP EPS PEN STB WS1 WS0  │* The register name is displayed as
  610. └───────────────────────────────────┘  the first item and what was wrong.
  611. ╒[ Line Status Register ]═══════════╕
  612. │      TSE THE BI  FE  PE  OE  DR   │╒[ Diagnostics]═══════════════════════╕
  613. └───────────────────────────────────┘│ Line Control Register readings show │
  614. ╒[ Modem Control Register ]═════════╕│ that the word length selected is    │
  615. │              LP  OT2 OT1 RTS DTR  ││ incorrect or you have a parity error│
  616. └───────────────────────────────────┘│ error. WS1 and WS0 should both be   │
  617. ╒[ Modem Status Register ]══════════╕│ on indicating that 8 bit words are  │
  618. │  RLS RI  DSR CTS DRD TER DDR DCS  ││ to be used. All other readings      │
  619. └───────────────────────────────────┘│ should be low. Parity errors could  │
  620. ╒[ Interrupt ID Register ]══════════╕│ happen once but not every time. If  │
  621. │                      ID1 ID0 ITP  ││ either persists, then the Uart is   │
  622. └───────────────────────────────────┘│ defective or communications to the  │
  623. ╒[ Interrupt Enable Register ]══════╕│ Uart are suspect.                   │
  624. │                  ESI ELI ETI ERI  ││                                     │
  625. └───────────────────────────────────┘│   PRESS ANY KEY TO CONTINUE         │
  626. ╒[ Interrupt Mask Register ]════════╕│                                     │
  627. │  IQ7 IQ6 IQ5 IQ4 IQ3 IQ2 IQ1 IQ0  ││                                     │
  628. └───────────────────────────────────┘└─────────────────────────────────────┘
  629.  
  630. There are many diagnostic messages you could get, and all of these are
  631. detailed in the technical reference manual. If you are running the modem
  632. test, you will get this display plus the first 16 S-registers, however if
  633. there was an error detected, you will get the example listed above and no
  634. S-register display. The reason for this is simple, because the uart might
  635. have a problem there is no way to know if the data coming from the modem is
  636. totally correct.
  637.  
  638. After you have logged in at least 1 comm port, the Modem Doctor will enter
  639. the main menu section. Use the main menu bar by operating your left and
  640. right arrow keys. Complete a selection with the enter key, or escape with
  641. the escape key.
  642.  
  643. The menu system is very straight forward, so you will only see here a list
  644. of all the possible menus you might run into. For detailed explanations on
  645. the tests that are conducted, refer to the Modem Doctor technical reference
  646. file (MDR5DOC.TXT).
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.                                        Page 10
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  668.  
  669.  
  670.  
  671. Main Menu Bar:
  672.  
  673. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  674. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  675. └──────────────────────────────────────────────────────────────────────────┘
  676.  
  677. For example, if you wanted to display the registers again, chose the Regs
  678. selection and press return. Next you will get a pulldown of various
  679. register tests. Just use the down or up arrows to slide the bar to the
  680. selection you wish to make, and press return to activate it.
  681.  
  682. Pulldowns
  683. ------------
  684. Pulldowns are easy to use. Each pulldown system follows the same ground
  685. rules; First, you can escape any pulldown by pressing Escape, or skip to
  686. the next pulldown by using the left or right arrow keys. Second, each
  687. pulldown includes a detailed help menu that you can access by moving the
  688. sliding bar to help or by pressing the hot-key combination ALT-H. Press any
  689. key to escape help and return to your selection. As you move from pulldown
  690. to pulldown, the Modem Doctor will remember your last selection and move
  691. the sliding bar to that choice for you.
  692.  
  693. Detailed Menus and what each  does for you;
  694.  
  695.    * Select these from the Login menu
  696. ┌───────────────────────────── The Modem Doctor───────────────────────────┐
  697. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program   │  
  698. └─────────────────────────────────────────────────────────────────────────┘
  699. ╔[  Comm Port Login  ]═══════════╗
  700. ║ Let me Auto Detect COMM Ports  ║ <- Searches for all Comm ports
  701. ║ You Manually Enter COMM Ports  ║+<- You enter port addresses
  702. ║ Help with Auto login Commands  ║ <- Detailed help or ALT-H
  703. ║      Return To Main Menu       ║
  704. ╚════════════════════════════════╝    + registered version only
  705.  
  706.  
  707.            * Select these from Regs menu
  708. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  709. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  710. └──────────────────────────────────────────────────────────────────────────┘
  711.          ╔[  Register Tests  ]══════════════╗
  712.          ║ Quick Uart Register Diagnostics  ║ <- Displays all registers
  713.          ║ DTR/DSR  RTS/CTS echo test       ║ <- Tests handshake lines
  714.          ║ Dynamic  RTS/CTS handshake test  ║+<-|Handshakes under simulated
  715.          ║ Dynamic Xon/Xoff handshake test  ║+<-|on-line conditions.
  716.          ║ Display any 10 S-registers       ║ <- Display S-registers
  717.          ║ Help and Info on these tests     ║ <- Help or ALT-H
  718.          ║       Return To Main Menu        ║
  719.  
  720.                                        Page 11
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  734.  
  735.  
  736.          ╚══════════════════════════════════╝
  737.                                              + registered version only
  738.  
  739.  
  740.  
  741.                      * Select these from Carrier menu
  742. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  743. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  744. └──────────────────────────────────────────────────────────────────────────┘
  745.                    ╔[  Setup  ]═════════════╗
  746.                    ║ Run the Carrier Tests  ║ <- Simulate on-line tests
  747.                    ║ Select Modem Commands  ║ <- Pick a modem driver
  748.                    ║ Help With Carrier Test ║ <- Help
  749.                    ║  Return to Main Menu   ║
  750.                    ╚════════════════════════╝
  751.  
  752.                                 * Select from Loopback
  753. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  754. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  755. └──────────────────────────────────────────────────────────────────────────┘
  756.                    ╔[  Loopback Tests  ]═══════════╗
  757.                    ║ Analog Loopback using a PLUG  ║ +<- test Uart & Cables
  758.                    ║ Digital Loopback 8250 UARTS   ║ +<- Uart test only
  759.                    ║ Loopback Plug Technical Data  ║ +<- How to build a
  760.                    ║ Help with Loopback Tests      ║     loopback plug
  761.                    ║     Return To Main Menu       ║
  762.                    ╚═══════════════════════════════╝
  763.                                                    +registered version only
  764.  
  765.  
  766.                                          * Select from Options
  767. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  768. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  769. └──────────────────────────────────────────────────────────────────────────┘
  770.                               ╔[  User Options Selection  ]╗
  771.  A Built-in mini-terminal  -> ║ Interactive Terminal Mode  ║
  772.  Status of all tests       -> ║ View Current Statistics    ║
  773.  Reset all tests to 0      -> ║ Reset Current Statistics   ║
  774.  Send results to printer   -> ║ Print Current Statistics   ║
  775.                               ║ Help with these options    ║
  776.                               ║    Return To Main Menu     ║
  777.                               ╚════════════════════════════╝
  778.  
  779.  
  780.                                                    * Setup selections
  781. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  782. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  783. └──────────────────────────────────────────────────────────────────────────┘
  784.                                        ╔[  Setup  ]═════════════╗
  785.  
  786.                                        Page 12
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  800.  
  801.  
  802.  Pick the Comm port and Baud rate   -> ║ Setup Command Section  ║
  803.  Customize your choice of colors    -> ║ Choose System Colors   ║
  804.                                        ║  Return to Main Menu   ║
  805.                                        ╚════════════════════════╝
  806.  
  807.  
  808.  
  809.                                                             * End options
  810. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  811. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  812. └──────────────────────────────────────────────────────────────────────────┘
  813.                                                          ╔[  Exit Options]═╗
  814.                          Quit and display results     -> ║ Exit the Program║
  815.                          Don't quit, stay in program  -> ║ Don't Exit      ║
  816.                                                          ╚═════════════════╝
  817.  
  818.  
  819. If you have a mouse, you can easily construct a custom mouse driver that
  820. will replace all of your motions. The Modem Doctor does not presently
  821. contain built-in mouse support, but it will work with any program such as
  822. Microsoft's Mouse.com and Menu.com. An example driver is included with the
  823. files on disk (MDR.MNU). Basically, you use the mouse motion left to right
  824. and up and down to replace the arrow keys, a key for escape and a key for
  825. enter or return.
  826.  
  827. Test report generator:
  828.  
  829. Whenever you quit the Modem Doctor you will get a statistical summary of
  830. all the tests and results that were run. You can also access this report
  831. anytime, and print it or reset it to zero from the options menu pulldown
  832. system. The results of these tests look like this;
  833.  
  834. ----------------------------------------------------------------------------
  835. THE MODEM DOCTOR   Ver. 4.0  Copyr. 1990 by Hank Volpe has tested this modem
  836. ----------------------------------------------------------------------------
  837.  
  838.         Diagnostics were run on your modem with the following results
  839.  
  840. Results of COM2 Testing
  841.  Test Name             # of Tests      # of Char Sent    # of Errors
  842.  ---------------       ----------      --------------    -----------
  843.  CARRIER ORIGINATE         0                0                  0
  844.  CARRIER ANSWER            0                0                  0
  845.  ANALOG LOOP               0                0                  0
  846.  DIGITAL LOOP              0                0                  0
  847.  MICROPROCESSOR            0               n/a                 0
  848.  REGISTER TESTS           24               n/a                 2
  849.  INTERRUPT TESTS           1               n/a                 0
  850.  
  851.  
  852.                                        Page 13
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  866.  
  867.  
  868.                        Speeds Modem/Uart were tested at
  869.                        --------------------------------
  870.  
  871. Tested Baud Rate : 2400
  872.  
  873.  
  874.  
  875. Results will be displayed in order for each comm port you tested. If there
  876. was an error detected, this line will be highlighted on the screen. You can
  877. reset these tests at any time, print and reset, or whatever you like.
  878.  
  879.  
  880.  
  881. The Status Bar
  882. ---------------
  883.  
  884.         Com1 | 2400bps | Micro:ON | TxINT: ON | Cfg: Generic Compatible
  885.  
  886.  
  887.  
  888. The status bar is displayed at the bottom of the screen. It shows you
  889. The Port you are using and the speed your port is operating at.
  890. Additionally it shows you if the Modem Doctor has successfully communicated
  891. to the modem microprocessor. MICRO : ON means it has, MICRO : OFF means
  892. that it has not. Normally, if you run the Modem / Uart test from
  893. the setup mode, this display will say MICRO : ON. If you only ran the Uart
  894. test, then it will say MICRO : OFF. You can toggle between states using a
  895. short-cut Hot-Key ALT-F, but I wouldn't recommend it your first time out.
  896. The ALT-F really can help if you have a modem problem to force testing,
  897. which is why it was included as a feature. See the technical reference
  898. manual for a detailed description of this feature. 
  899.  
  900. TxINT :ON indicates that Modem Doctor is using "transmit interrupts" to 
  901. determine when to send characters to your uart. ALT-T toggles this feature on 
  902. or off. Older 8250 Uarts running on slow systems had serious problems using 
  903. transmit interrupts. If you have such a machine, I would recommend you turn 
  904. this feature off if you have any problems. Refer to the Technical Reference 
  905. Manual for further information. Finally, the name of the Modem Driver you are 
  906. currently using is displayed on the right. 
  907.  
  908.  
  909. Alert Bars:
  910. -----------
  911.  
  912. Alert bars are warnings that the Modem Doctor found something that it thinks
  913. should be set another way to insure good communications. The warning is
  914. displayed with a red bar and a "beep". That is called a fatal error, which
  915. means that it is doubtful that your modem or serial port will operate with
  916. these settings. Other alert bar displays that do not have a audible "beep"
  917.  
  918.                                        Page 14
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  932.  
  933.  
  934. are considered setup warnings, and are suggestions of what you should do to
  935. make your communications better.
  936.  
  937. External Modem Drivers (MDR5.DRV)
  938.  
  939. The Modem Doctor uses a software module to communicate with most brands of
  940. modems. These "modem drivers" are built into the Modem Doctor. When you
  941. start up the Modem Doctor, it will make a choice of the correct
  942. driver to use depending on what kind of modem it finds. You can always
  943. override this choice by going to the Carrier tests and selecting the
  944. pulldown "Select Modem Commands".
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.                                        Page 15
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  998.  
  999.  
  1000.  
  1001. To keep your registered version of Modem Doctor as state-of-the-art as
  1002. possible, Version 4.0 and higher have the ability to read external modem
  1003. driver files. Like printer drivers, these files can be loaded to extend the
  1004. ability of the Modem Doctor to communicate with any type of modem. This
  1005. means you should never need to update for the sake of incorporating a new
  1006. modem selection into the Modem Doctor. ALL FUTURE MODEM DRIVER FILES WILL BE
  1007. DISTRIBUTED FREE OF CHARGE. You can always download the latest version of 
  1008. Modem Doctor and Modem Drivers from the Modem Doctor BBS (410-256-3631).
  1009.  
  1010. Questions about the Modem Doctor
  1011. --------------------------------
  1012.  
  1013. Q: Will the Modem Doctor "fix" a problem?
  1014. A: If the problem is software based, or if it is a problem with port
  1015.    conflicts or incorrect assignments, the Modem Doctor will straightened it
  1016.    out for testing purposes only. It will advise you though what it found
  1017.    and suggest what you can do to correct the problem later. You can always
  1018.    print this information by using the Print Screen command from your
  1019.    keyboard.
  1020.  
  1021.  
  1022. Q: I start Modem Doctor, but it freezes at the main menu. What's wrong?
  1023. A: Modem Doctor 5 performs a self-test IRQ generation and verification
  1024.    routine that might not be compatible with your computer environment,
  1025.    especially if it runs with a network interface. To bypass these tests,
  1026.    run Modem Doctor with the /Q switch. In this mode, no IRQ verification
  1027.    is performed.
  1028.  
  1029. Q: I have a LCD display, and the colors the modem doctor uses do not give
  1030.    me good contrast.
  1031.  
  1032. A: Go to setup, select custom colors, and pick the shades you like, or
  1033.    better still, use monochrome shades. This information will be saved
  1034.    in a file in the same directory you are in currently for the next time
  1035.    you load the Modem Doctor.
  1036.  
  1037.  
  1038. Q: I tell the Modem Doctor to test my Modem, but it says it is not
  1039.    compatible.
  1040.  
  1041. A: This could be due to several things;
  1042.     1) You must make sure you use a baud rate equal to or lower than
  1043.        the maximum baud rate of your modem. If you try for example to talk
  1044.        to the modem at 19.2K bps but your modem is only a 2400 bps, then
  1045.        the Modem Doctor will report falsely about your modem.
  1046.  
  1047.     2) You do not have a modem attached to that port. In this case run the
  1048.        Uart diagnostics.
  1049.  
  1050.                                        Page 16
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  1064.  
  1065.  
  1066.     3) Your modem is off or disconnected.
  1067.  
  1068.  
  1069.  
  1070. Q: I would like to use a mouse, but the Modem Doctor doesn't recognize it.
  1071. A: The Modem Doctor does not have internal mouse support, but it will work
  1072.    with programs such as Microsoft's Menu.com and special mouse drivers
  1073.    that you create. A sample driver is included with the Modem Doctor.
  1074.  
  1075.  
  1076. Q: If a new modem comes on the market that is not compatible, can the Modem
  1077.    Doctor work with it?
  1078.  
  1079. A: You can use the Modem Doctor in what is called the "Dumb Modem" mode to
  1080.    test any modem than has external switches to generate carrier tests.
  1081.    Furthermore, this release of the Modem Doctor will work with externally
  1082.    created modules for incompatible modems. If a modem is manufactured at
  1083.    a later time that creates a new set of rules, these external modules
  1084.    will be distributed at no cost to all users. Also, custom modules can be
  1085.    created for any registered user for a small fee.
  1086.  
  1087.  
  1088. Q: The Analog loop tests do not run.
  1089. A: This feature only works in the registered version. If you have a     
  1090.    registered version and have a problem, you also need to have a loop-back  
  1091.    plug attached either to the back of your PC, or to the end of a cable     
  1092.    that you are testing. You can run these tests usually through most modem
  1093.    command modes, however you might get errors that are not valid. The    
  1094.    Analog loopback was meant to be a help in spotting a bad cable or
  1095.    connector.
  1096.  
  1097. Q: Do I need to worry if my modem does not pass any of the Dynamic tests?
  1098. A: Only if you have a high speed modem. Most 9600 bps modems need these
  1099.    handshaking signals to work properly, but at 2400 and lower, they are
  1100.    seldom used. If the Modem Doctor reports that all the uart handshaking
  1101.    signals are present, then all you need to do is set your modem up
  1102.    according to the manufacturers handbook. You can do this from the
  1103.    Interactive terminal mode without even exiting the Modem Doctor, and then
  1104.    use the Modem Doctor to test that your settings are correct.
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.                                        Page 17
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.