home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / 1142a.zip / INSTALL.DOC < prev    next >
Text File  |  1994-06-21  |  28KB  |  980 lines
  1.  
  2.  
  3.  
  4.  
  5.     This read.me file covers installing the DigiBoard LAN Distance
  6.     driver on LAN Distance Servers and Remote Workstations.
  7.  
  8.  
  9.  
  10.  
  11.  
  12.     - HARDWARE SUPPORTED
  13.  
  14.  
  15.  
  16.     The driver supports the following DigiBoard Hardware products to
  17.     a maximum of 4 Host adapter cards and a maximun of 256 ports.
  18.  
  19.  
  20.     ISA Bus  :
  21.  
  22.         PC/16i, PC/8i, PC/16e, PC/8e, PC/4e, PC/2e, PC/Xem, and C/X.
  23.  
  24.  
  25.     EISA Bus :
  26.  
  27.         PC/16i, PC/8i, PC/16e, PC/8e, PC/4e, PC/2e, PC/Xem, EISA/Xem,
  28.         C/X and EISA C/X.
  29.  
  30.     MCA Bus  :
  31.  
  32.  
  33.         MC/16i, MC/8i, MC/4i, MC/8e, MC/4e, MC/2e, MC/Xem, MC C/X
  34.  
  35.  
  36.  
  37.  
  38.     - HARDWARE INSTALLATION
  39.  
  40.  
  41.  
  42.     Hardware installation should be done in accordance with the DigiBoard
  43.     Hardware Installation manual that you received with your DigiBoard
  44.     product.
  45.  
  46.  
  47.     You should choose a memory address and I/O port that does not conflict
  48.     with other devices in your system. You may address ISA and MCA bus
  49.     products up to the 16 Megabyte boundary if your computer does not
  50.     have system memory installed that high. On EISA computers, memory
  51.     addresses may be selected through the 4th Gigabyte range.
  52.  
  53.     On MCA computers beware of configuring I/O ports in the 100 - 10f
  54.     range as they may conflict with POS I/O space.
  55.  
  56.  
  57.  
  58.     - SOFTWARE INSTALLATION
  59.  
  60.  
  61.  
  62.     The installation process consists of
  63.  
  64.     1) Copying files to your \IBMCOM\MACS directory.
  65.     2) Automatically Updating your CONFIG.SYS
  66.     3) Installing support for the DigiBoard driver under LAPS.
  67.     4) Configuring the LAN Distance product to use the DigiBoard ports.
  68.     5) Manually Updating your CONFIG.SYS
  69.  
  70.  
  71.  
  72.  
  73.     * STARTING THE INSTALL PROCESS
  74.  
  75.  
  76.  
  77.  
  78.     This process will begin when you run INSTALL.CMD found on the Digi-
  79.     Board driver diskette. Insert the diskette into a floppy drive on
  80.     your system and make that drive the current drive. Then simply type
  81.  
  82.  
  83.         INSTALL < LAN Distance Drive: >  [< CONFIG.SYS Drive: >]
  84.  
  85.  
  86.     where
  87.  
  88.         < LAN Distance Drive: > is the drive LAN distance is
  89.         installed on.
  90.  
  91.  
  92.         [< CONFIG.SYS Drive: >] is the drive where your CONFIG.SYS
  93.         is located. If it is the same a the LAN Distance Drive,
  94.         you may omit this parameter.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.     * Step 1 : COPYING FILES
  102.  
  103.  
  104.  
  105.     Several files will be copied to your C:\IBMCOM\MACS directory. These
  106.     files are as follows :
  107.  
  108.         DGAFGP.OS2
  109.         DGPOLLER.EXE
  110.         *.BIN
  111.  
  112.  
  113.  
  114.  
  115.     * Step 2: AUTOMATICALLY UPDATING CONFIG.SYS
  116.  
  117.  
  118.  
  119.     The next action that the INSTALL.CMD script will perform is to
  120.     update your CONFIG.SYS with the following lines :
  121.  
  122.  
  123.         rem DigiBoard PC/16e, PC & MC/8e, 4e, 2e, and PC/Xi
  124.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:320
  125.  
  126.         rem DigiBoard MC/16i, MC/8i, MC/4i
  127.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:C0000 /P:F1F0
  128.  
  129.         rem DigiBoard PC/Xem, MC/Xem
  130.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:324 /T:P
  131.  
  132.         rem DigiBoard EISA Xem, slot 3
  133.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:3005 /T:P
  134.  
  135.         rem DigiBoard ISA C/X 1 concentrator
  136.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:328 /T:I10
  137.  
  138.         rem DigiBoard EISA C/X 1 concentrator, slot 3
  139.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:3005 /T:E10
  140.  
  141.         rem DigiBoard Micro Channel C/X 1 concentrator
  142.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:328 /T:M10
  143.  
  144.  
  145.         RUN=C:\IBMCOM\MACS\DGPOLLER.EXE
  146.  
  147.  
  148.  
  149.     Note : Several of the lines a remarked out and thus inactive. This
  150.            will be dealt with in the last part of the install process.
  151.  
  152.  
  153.  
  154.     * Step 3 : LAPS INSTALLATION
  155.  
  156.  
  157.     Next, LAPS will be run to install the DigiBoard MAC driver so that
  158.     the DigiBoard ports will be available to LAN Distance. This will
  159.     require some minimal user interaction. When LAPS is run you will see
  160.     a LAPS screen with the following options :
  161.  
  162.  
  163.  
  164.         Install     Configure     Remove     Exit    Help
  165.  
  166.  
  167.     * You should click on the "Install" option.
  168.  
  169.  
  170.     When you do, you will see a box titled "Install Additional Network
  171.     Drivers" and a dialog box where you should indicate the source drive.
  172.  
  173.  
  174.     * Enter the drive letter in which the DigiBoard Driver Diskette is
  175.       located and click on "OK".
  176.  
  177.  
  178.     At this point, more files will be transfered and you will be notified
  179.     that the installation is complete and that LAPS has successfully
  180.     installed the "DigiBoard Communication Ports".
  181.  
  182.     * Click "OK" again.
  183.  
  184.  
  185.     You will return to the first LAPS screen you saw.
  186.  
  187.  
  188.     * Click "Exit"
  189.  
  190.  
  191.     You will see another dialog box titled "CONFIG.SYS Updates"
  192.  
  193.  
  194.     * Click "Exit" again.
  195.  
  196.  
  197.     You will see the final LAPS message informing you that you are
  198.     "Exiting LAPS".
  199.  
  200.  
  201.  
  202.  
  203.     * Step 4 : CONFIGURING THE LAN DISTANCE PRODUCT
  204.  
  205.  
  206.  
  207.     After INSTALL.CMD finishes, you will be required to configure
  208.     LAN Distance for the DigiBoard Ports you wish to use. The
  209.     configuration process is virtually the same for a Server or a
  210.     Remote Workstation.
  211.  
  212.  
  213.     * Start LAN Distance
  214.  
  215.     * From the "LAN Distance - Workstations" Box
  216.  
  217.         Select "Selected" from the menu bar.
  218.         Select "Open As ->".
  219.         Select "Settings".
  220.  
  221.  
  222.     * From the "MyWorkStation - Settings" Box
  223.  
  224.         Select "Ports" Tab.
  225.         Push   "Add..." Button.
  226.         Highlight "OEM DigiBoard Communications Ports".
  227.  
  228.             If this option is not shown, you have not properly
  229.             installed the DigiBoard Driver using LAPS in Step 2.
  230.             You should go to an OS/2 command prompt and run
  231.             \ibmcom\laps, or click on the "OS\2 System" icon
  232.             and run LAPS from the "System Setup" folder.
  233.  
  234.         Push   "OK..." Button.
  235.  
  236.  
  237.     * From the "DigiBoard Communications Ports - Settings" Box
  238.  
  239.  
  240.         Push   "LAPS" Button.
  241.  
  242.  
  243.     * You are now in the "Configure Workstation" Box in the "LAN Adapter
  244.       and Protocol Support Settings" window.
  245.  
  246.  
  247.         Scroll Down the "Network Adapters" List and highlight the
  248.             "DigiBoard Communications Ports" selection.
  249.  
  250.         Press the "Add" button.
  251.  
  252.         Make sure that the "DigiBoard Communication Ports..." entry
  253.             has been added and highlighted in the "Current
  254.             Configuration" window.
  255.  
  256.         Press the "Edit" button.
  257.  
  258.         Enter a new Portname if the default name "DIGI1" is not to
  259.             your liking. If there is an error with the name you
  260.             choose, LAPS will warn you. Be sure to use different
  261.             names if adding more than one port.
  262.  
  263.         Press the "OK" button when finished.
  264.  
  265.  
  266.         You must repeat this process for each DigiBoard Port you wish
  267.             to add.
  268.  
  269.         Press the "OK" button to exit.
  270.  
  271.  
  272.         If you are configuring a LAN Distance Server you may get an
  273.         error message upon attempting to exit. The message  will say
  274.         something like
  275.  
  276.             "All LAN Adapter and Protocol Support combinations
  277.             in the Current Configuration must contain at least
  278.             one protocol driver."
  279.  
  280.         Click on the "OK". Most likely, the problem lies with the
  281.         entry that looks like this :
  282.  
  283.  
  284.             LAN Distance Logical Adapter ....
  285.             [BRIDGEFH]....
  286.                 1 - [SR_BRIDGE]
  287.  
  288.  
  289.         You may highlight these lines one at a time starting with
  290.         the last line and press the "Remove" button. These are
  291.         entries in your \ibmcom\protocol.ini file that are inserted
  292.         by LAN Distance but apparently not liked by LAPS. Removing
  293.         them will cause no harm because LAN Distance will reinsert
  294.         them before you exit. Now you may press the "OK" button to
  295.         exit without further ado.
  296.  
  297.  
  298.     * Now, back in the "DigiBoard Communications Ports - Settings" Box,
  299.  
  300.  
  301.         Double-Click on the box's upper left hand corner button to
  302.         close it.
  303.  
  304.  
  305.  
  306.     * Now, you should be back in the "MyWorkStation - Settings" Box and
  307.       should see the "DigiBoard Communication Ports" entry in the
  308.       "Configured ports" window. If this is the case, you have success-
  309.       fully added your DigiBoard ports.
  310.  
  311.  
  312.  
  313.     * You are now ready to complete the LAN Distance configuration to your
  314.       liking. This will include assigning modems to each port you added,
  315.       as well as setting up "Dial" and "Answer" parameters and making
  316.       "Phone Book" entries using the "MyWorkstation - Setting" tabs.
  317.  
  318.       Please refer to your LAN DIstance documentation for information on
  319.       these topics.
  320.  
  321.  
  322.     ****
  323.  
  324.     When you have finished configuring LAN Distance, you MUST shut down
  325.     LAN Distance and save the settings.
  326.  
  327.     ****
  328.  
  329.     * Step 5 : MANUALLY UPDATING CONFIG.SYS
  330.  
  331.  
  332.     Finally the time has come to update your CONFIG.SYS file to indicate
  333.     the type of DigiBoard you will be installing. Using your favorite
  334.     editor, bring up your CONFIG.SYS file. Near the bottom of the file
  335.     you will see the following entries that have been made.
  336.  
  337.  
  338.  
  339.  
  340.         rem DigiBoard PC/16e, PC & MC/8e, 4e, 2e, and PC/Xi
  341.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:320
  342.  
  343.         rem DigiBoard MC/16i, MC/8i, MC/4i
  344.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:C0000 /P:F1F0
  345.  
  346.         rem DigiBoard PC/Xem, MC/Xem
  347.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:324 /T:P
  348.  
  349.         rem DigiBoard EISA Xem, slot 3
  350.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:3005 /T:P
  351.  
  352.         rem DigiBoard ISA C/X 1 concentrator
  353.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:328 /T:I10
  354.  
  355.         rem DigiBoard EISA C/X 1 concentrator, slot 3
  356.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:3005 /T:E10
  357.  
  358.         rem DigiBoard Micro Channel C/X 1 concentrator
  359.         rem DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /M:D0000 /P:328 /T:M10
  360.  
  361.  
  362.         RUN=C:\IBMCOM\MACS\DGPOLLER.EXE
  363.         DEVICE=C:\IBMCOM\MACS\DGANDIS.OS2
  364.  
  365.  
  366.  
  367.     Your task will be to uncomment and modify one of the "rem"ed "DEVICE="
  368.     lines to indicate the type and configuration of the DigiBoard you will
  369.     be installing. The lines that have been added to you CONFIG.SYS are
  370.     examples of typical configurations for the various DigiBoard products
  371.     supported by the LAN Distance Driver. One of these entries may very
  372.     well match the configuration you are using, in which case you need to
  373.     just delete the "rem" statement in front of that entry. Once you are
  374.     satisfied with your entry, you may delete the other entries or you
  375.     may leave them as is for future reference.
  376.  
  377.  
  378.  
  379.     Below is information on how to determine the entry you need to make :
  380.  
  381.  
  382.  
  383.     All DigiCHANNEL intelligent asynchronous serial communications boards
  384.     must be installed from a single command line, which contains complete
  385.     set-up information for each board.  The format of the command line is:
  386.  
  387.  
  388.     DEVICE=[d:][Path]DGAFGP.OS2 /a:a /m:mem /p:port /t:card
  389.                    [,/m:mem /p:port /t:card ]
  390.                    [, ...]
  391.  
  392.  
  393.     The above command line must appear on a single command line in the
  394.     CONFIG.SYS file.  This line may be up to 255 characters long.
  395.  
  396.  
  397.  
  398.  
  399.  
  400.     * Global Parameter.
  401.  
  402.     This type of parameter affects all boards installed. These parameters
  403.     are optional, and may be omitted. If omitted, default values will be
  404.     used.
  405.  
  406.  
  407.     - Parameter /a:a
  408.  
  409.         Enable the alternate pin assignment of Data Carrier Detect
  410.         (DCD) for all ports. Alt-Pin is a feature that swaps the
  411.         meaning of the DSR and DCD input pins on each DigiBoard port.
  412.         This is useful when using an 8-pin RJ-45 plug in a DigiBoard
  413.         10-pin RJ-45 jack. In this configuration, pins 1 and 10 in
  414.         jack are not accessible to the 8-pin plug. Pin 10 is DCD and
  415.         very useful when attaching to a modem. Enabling the Alt-Pin
  416.         option causes the DigiBoard driver to interpret pin 2
  417.         (usually DSR) as DCD and pin 10 (usually DCD) as DSR. In
  418.         order to use this feature, your cables must be made to run
  419.         the real DCD signal into pin 2 of the DigiBoard jack (pin 1
  420.         on the 8-pin plug).
  421.  
  422.  
  423.  
  424.     * Per-Card Parameters.
  425.  
  426.     The remaining three parameters are per-card parameters, and are used
  427.     to inform the driver of the type of board and where it is to be
  428.     addressed in the hosts I/O and memory buses.  These parameters are
  429.     mandatory, and must be given for each board!  The per-card parameters
  430.     must be given in complete sets, and the sets must be separated by
  431.     commas.
  432.  
  433.  
  434.  
  435.     - Parameter /m:mem
  436.  
  437.  
  438.  
  439.       Dual-ported memory starting address.  This is the full
  440.       32-bit hexadecimal address of the beginning of the boards
  441.       dual-ported memory.
  442.  
  443.  
  444.           /m:d0000      Sets dual-ported memory start address to
  445.                 0D0000h (in the BIOS expansion area between
  446.                 640K and 1 megabyte).
  447.  
  448.           /m:e80000     Sets start address of E80000h (in the
  449.                 fifteenth megabyte).  EISA and ISA boards
  450.                 may all share the same memory starting address.
  451.                 Micro Channel boards must each have unique
  452.                 memory addresses.
  453.  
  454.  
  455.  
  456.  
  457.     - Parameter /p:port
  458.  
  459.  
  460.       Defines the I/O port address for the card.
  461.  
  462.  
  463.           /p:300        Board is addressed at I/O port 300h.
  464.  
  465.           /p:2005       EISA board (EISA C/X or EISA/Xem host adapter)
  466.                 is in slot 2 (EISA I/O addresses are 4
  467.                 digits : the slot number, followed by 005).
  468.                 When plugging an ISA board (PC/Xe, ISA
  469.                 C/X host adapter, etc.) into an EISA
  470.                 machine, the /p parameter must contain the
  471.                 3-digit I/O address as set by the DIP switches
  472.                 on the board, and not the 4-digit address
  473.                 based on the EISA slot number.
  474.  
  475.  
  476.  
  477.     - Parameter /t:card
  478.  
  479.       Defines the card type to the driver.  Legal values for card are:
  480.  
  481.           i for the ISA C/X,
  482.           e for the EISA C/X,
  483.           m for the MC C/X,
  484.           p for Xem (PC/Xem, MC/Xem or EISA/Xem)
  485.  
  486.  
  487.       This parameter must be omitted for PC/Xe, PC/Xi, MC/Xe and MC/Xi
  488.       boards.  The designators i, e, and m must be followed by an
  489.       additional two digits defining the number and arrangement of
  490.       DigiCHANNEL C/CON-16 or C/CON-16e concentrators on each host
  491.       adapter channel. If the concentrator(s) are connected to the
  492.       host adapter via a dial-up or leased line (remote concentra-
  493.       tors), each of the two digits must be followed by a parameter,
  494.       enclosed in parentheses, specifying the synchronous commun-
  495.       ications mode to be used for that line.  See below for a list of
  496.       available synchronous communications modes.
  497.  
  498.  
  499.           /t:i10        ISA C/X, one local concentrator on line 1 only.
  500.  
  501.  
  502.           /t:e11        EISA C/X, one local concentrator on each of
  503.                 lines 1 and 2.
  504.  
  505.           /t:m21        MC C/X, two local concentrators on line 1 and
  506.                 1 on line 2.
  507.  
  508.           /t:e12        EISA C/X, one local concentrator on line 1,
  509.                 and two on line 2.
  510.  
  511.           /t:i22        ISA C/X, two local concentrators on each of
  512.                 lines 1 and 2.
  513.  
  514.           /t:p           PC/Xem, MC/Xem or EISA Xem
  515.  
  516.  
  517.           /t:i2(21)3(27)
  518.  
  519.                 ISA C/X, two remote concentrators on line 1,
  520.                 and two remote concentrators on line 2.
  521.                 The concentrators on line 1 will use mode
  522.                 #21 (76,800 baud, 8-wire, external clock) to
  523.                 communicate with the host adapter, and the
  524.                 concentrators on line 2 will use mode #27
  525.                 (614,400 baud, 8-wire, internal clock).  See
  526.                 below for a list of synchronous communications
  527.                 modes.
  528.  
  529.  
  530.  
  531.  
  532.  
  533.               C/X Synchronous Communicatio Modes
  534.  
  535.          ----------------------------------------------------
  536.          |     8-Wire           8-Wire          4-Wire      |
  537.          | Internal Clock   External Clock    Self-Clock    |
  538.          ----------------------------------------------------
  539.          |  Mode   Baud       Mode   Baud      Mode   Baud  |
  540.          |---------------------------------------------------
  541.          |                                                  |
  542.          |    0    115k        15    2400       1     230k  |
  543.          |                                                  |
  544.          |    3    2400        16    4800       2     460k  |
  545.          |                                                  |
  546.          |    4    4800        17    9600                   |
  547.          |                                                  |
  548.          |    5    9600        18    19.2k                  |
  549.          |                                                  |
  550.          |    6    19.2k       19    38.4k                  |
  551.          |                                                  |
  552.          |    7    38.4k       20    57.6k                  |
  553.          |                                                  |
  554.          |    8    57.6k       21    76.8k                  |
  555.          |                                                  |
  556.          |    9    76.8k       22    115k                   |
  557.          |                                                  |
  558.          |    10   115k        23    230k                   |
  559.          |                                                  |
  560.          |    11   230k        24    460k                   |
  561.          |                                                  |
  562.          |    12   460k        25    920k                   |
  563.          |                                                  |
  564.          |    13   920k        26    1.2M                   |
  565.          |                                                  |
  566.          |    14   1.2M                                     |
  567.          |                                                  |
  568.          |                     29    614k                   |
  569.          |                                                  |
  570.          |                     30    737k                   |
  571.          |                                                  |
  572.          |    27   614k                                     |
  573.          |                                                  |
  574.          |    28   737k                                     |
  575.          |                                                  |
  576.          ----------------------------------------------------
  577.  
  578.  
  579.  
  580.     * Examples
  581.  
  582.     The following examples start out with just the minimum to install a
  583.     DigiCHANNEL board.  After locating an example for your type of board,
  584.     read the rest of the examples for optional situations that may be
  585.     appropriate to your application.  Default options will be altered by
  586.     LAN DIstance.
  587.  
  588.  
  589.     Example 1:
  590.  
  591.     PC/Xe, PC/Xi One PC/Xe (or PC/Xi) at I/O port 220h, memory address
  592.     D0000h.
  593.  
  594.  
  595.         DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /m:d0000 /p:220
  596.  
  597.  
  598.  
  599.     Example 2:
  600.  
  601.     MC/Xi One MC/Xi at I/O port F1F0h, memory address FC0000h.
  602.  
  603.  
  604.         DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /m:FC0000 /p:F1F0
  605.  
  606.  
  607.     Example 3:
  608.  
  609.     Two board installation with Alt-Pin optional global parameter.
  610.     Two PC/Xe or PC/Xi boards at I/O ports 320h and 300h, with
  611.     dual-ported memory of both starting at D0000h.
  612.  
  613.         DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2  /a:a /m:D0000 /p:320,
  614.                                /m:D0000 /p:300
  615.  
  616.     (Note that the above must all appear on one line in CONFIG.SYS)
  617.  
  618.  
  619.  
  620.     Example 4:
  621.  
  622.     Two board installation with Alt-Pin optional global parameter.
  623.     One MC/Xe and one MC/Xi boards at I/O ports F1F0h and 320h, with
  624.     different (can't be the same) dual-ported memory addresses. Alt-Pin
  625.     enabled.
  626.  
  627.         DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2  /a:a /m:C0000 /p:F1F0,
  628.                                /m:C8000 /p:300
  629.  
  630.     (Note that the above must all appear on one line in CONFIG.SYS)
  631.  
  632.  
  633.  
  634.     Example 5:
  635.  
  636.     PC/Xem One PC/Xem at I/O port 224h, memory start address C8000h;
  637.  
  638.  
  639.         DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /m:C8000 /p:224 /t:p
  640.  
  641.  
  642.  
  643.     Example 6:
  644.  
  645.     ISA C/X One ISA C/X host adapter at I/O port 228h, memory address
  646.     D0000h, with one concentrator on line 1 and two on line 2.
  647.  
  648.  
  649.         DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /m:d0000 /p:228 /t:i12
  650.  
  651.  
  652.  
  653.     Example 7:
  654.  
  655.     EISA C/X with a remote concentrator via an RS-232 synchronous modem.
  656.     One EISA C/X host adapter in slot 3, memory address D8000h, with two
  657.     local concentrators on line 1 and one remote concentrator at 9600
  658.     baud and external clocking on line 2.
  659.  
  660.  
  661.         DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /m:d8000 /p:3005 /t:e21(17)
  662.  
  663.  
  664.  
  665.     Example 8:
  666.  
  667.  
  668.     MC C/X and MC/Xem One MC C/X host adapter at I/O port 228h, memory
  669.     address D8000h, with one concentrator on line 1 and one concentrator
  670.     on line 2; one MC/Xem at I/O Port 304h, memory address D0000h.
  671.  
  672.     Alt-Pin enabled
  673.  
  674.  
  675.         DEVICE=C:\IBMCOM\MACS\DGAFGP.OS2 /a:a /m:d8000 /p:228 /t:m11,
  676.                               /m:d0000 /p:304 /t:p
  677.  
  678.     (Note that the above must all appear on one line in CONFIG.SYS)
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.     - DRIVER LOAD
  687.  
  688.  
  689.  
  690.     As you may have noticed from the CONFIG.SYS file, the DigiBoard LAN
  691.     Distance driver is made up of 2 drivers. One driver that interacts
  692.     with the Protocol driver (DGANDIS.OS2) and one driver that interacts
  693.     with the hardware (DGAFGP.OS2). So when you boot your system, you
  694.     will see two drivers load. The order in which they load will follow
  695.     their order in the CONFIG.SYS file and should be DGAFGP.OS2 followed
  696.     sometime thereafter by DGANDIS.OS2, however, they can be loaded in
  697.     either order.
  698.  
  699.  
  700.     Loading DGAFGP.OS2 -
  701.  
  702.  
  703.     When this driver loads, it's primary goal is to find the DigiBoard
  704.     hardware specified on the "DEVICE=" line in CONFIG.SYS, initialize
  705.     it, and assure that it is functional. The driver displays the banner
  706.     shown below when the driver loads successfully.
  707.  
  708.  
  709.  
  710.           -----------------------------------------------------------
  711.           | DigiBoard ANDIS Intelligent Board Driver        V 0.0.1 |
  712.           | DGAFGP.OS2   Copyright (C) 1994                         |
  713.           | All Rights Reserved.                                    |
  714.           -----------------------------------------------------------
  715.           -----------------------------------------------------------
  716.           |  RESTRICTED RIGHTS LEGEND:                              |
  717.           |  Use, duplication, or disclosure by the Government is   |
  718.           |  subject to restrictions set forth in sub-paragraph (c) |
  719.           |  (1) (ii) of the Rights in Technical Data and Computer  |
  720.           |  Software clause at DFARS 252.227-7013.                 |
  721.           |                                                         |
  722.           |  Digi International Inc. d/b/a  DigiBoard, 6400 Flying  |
  723.           |  Cloud Drive, Eden Prairie, MN 55344                    |
  724.           -----------------------------------------------------------
  725.           -----------------------------------------------------------
  726.           | Board Type   I/O Address    Memory Address     Channels |
  727.           -----------------------------------------------------------
  728.          PC/Xem          324          0x000D0000           16
  729.  
  730.  
  731.     If there are any errors encountered as the driver loads, error
  732.     messages will be posted to alert you of the condition and OS/2
  733.     should stop the boot process and prompt you to continue.
  734.  
  735.  
  736.     Possible error messages include :
  737.  
  738.  
  739.     * CONFIG.SYS errors
  740.  
  741.  
  742.     "Incomplete specification: need IO port AND memory for each board."
  743.     "Unexpected character: "
  744.     "Too many boards: Only 4 Intelligent boards supported."
  745.     "Unknown value assigned"
  746.     "Multiple IO port specifications: (/p:_)"
  747.     "Duplicate IO port address specifications: (/p:_)"
  748.     "Invalid IO port address specification: (/p:_)"
  749.     "Multiple memory address specifications: (/m:_)"
  750.     "Invalid memory address specification: (/m:_)"
  751.     "Invalid board type code: (/t:_)"
  752.     "No DigiBoards Specified on command line"
  753.     "Invalid Command Line Arguments"
  754.     "Zero DigiBoards Configured"
  755.     "Too many channels: maximum = 256"
  756.  
  757.  
  758.     - Cause & Remedy
  759.  
  760.  
  761.     The driver has encountered the specified error as it was parsing the
  762.     CONFIG.SYS "DEVICE= line". You should check your CONFIG.SYS for
  763.     accuracy.
  764.  
  765.  
  766.  
  767.  
  768.  
  769.     * Hardware Errors
  770.  
  771.  
  772.     "Failed to RESET the I/O PORT"
  773.     "IO Port Not Responding"
  774.     "Failed Shared Memory Test near OFFSET: 0xXXXX"
  775.     "Failed to write to shared memory"
  776.  
  777.  
  778.     - Cause & Remedy
  779.  
  780.  
  781.     There is a memory or I/O port conflict with an other device in your
  782.     system or you have a defective board. Try a different I/O port or
  783.     memory address.
  784.  
  785.  
  786.  
  787.  
  788.     * FEP and BIOS Binary file problems
  789.  
  790.  
  791.     "Invalid DATA FILES DIRECTORY"
  792.     "Failed to locate data files"
  793.     "Failed to STAT file"
  794.  
  795.  
  796.     - Cause & Remedy
  797.  
  798.  
  799.     These messages usually occur while the driver is attempting to locate
  800.     and open the *.bin files for download to the DigiBoard card. First,
  801.     make sure that the *.bin files on your driver diskette have been
  802.     copied to the \ibmcom\macs directory. If they are there, you may need
  803.     to recopy them from the driver diskette in case a file was corrupted.
  804.     If this fails to remedy th condition, you may need to add another
  805.     command line argument to your "DEVICE=" statement in the CONFIG.SYS
  806.     file. The argument is " /f:<path to *.bin files> ". This tells the
  807.     driver where the files are located. If the errors persist, you may
  808.     have a conflict with the DigiBoard hardware and your disk controller.
  809.     Move the DigiBoard to another I/O port and memory address.
  810.  
  811.  
  812.  
  813.     * DigiBoard Initialization Errors
  814.  
  815.  
  816.     "Failed to BOOT the BIOS"
  817.     "Failed to BOOT the uploaded FEPOS"
  818.     "Failed to Read Initialization Information"
  819.     "DigiBoard FEPOS will not execute commands"
  820.     "DigiBoard BIOS Will Not Boot"
  821.     "DigiBoard BIOS Will Not Respond"
  822.     "DigiBoard FEPOS Will Not Boot"
  823.     "Unknown Fatal Error"
  824.  
  825.  
  826.     - Cause & Remedy
  827.  
  828.  
  829.     These messages usually indicate problems initializing the card's on-
  830.     board software and are usually the results of a memory conflict with
  831.     another device in your system, a corrupt *.bin file, or a faulty
  832.     board. First, recopy the *.bin files from your driver diskette and
  833.     reboot your system. If this doen not work, relocated your board to
  834.     another I/O port and/or memory address. If none of this works, you
  835.     may have a bad board.
  836.  
  837.  
  838.  
  839.  
  840.     * OS/2 System Errors
  841.  
  842.  
  843.     "System Cannot Allocate Memory"
  844.     "Driver Failed to hook Timer",
  845.     "System Cannot Allocate Ctx Hook",
  846.     "Failed to make upload FILE memory"
  847.  
  848.  
  849.     - Cause & Remedy
  850.  
  851.     Chances are your system resources are depleted. Try unloading any
  852.     unnecessary drivers to see if the problem goes away. If this doesn't
  853.     work, get a bigger computer!
  854.  
  855.  
  856.  
  857.  
  858.  
  859.     * Possible Hardware problems
  860.  
  861.  
  862.     "Zero channels installed."
  863.  
  864.  
  865.     - Cause & Remedy
  866.  
  867.     This usually means that the card's on-board code could not locate
  868.     any ports. Usually you will see this message with the Xem and C/X
  869.     products when you forget to connect the EBI or concentrators. Check
  870.     this to see if that may be the case. Other wise you may have a faulty
  871.     card.
  872.  
  873.  
  874.  
  875.  
  876.  
  877.     Loading DGANDIS.OS2 -
  878.  
  879.  
  880.     When this driver loads, it's primary goal is to determine the LAN
  881.     Distance ports you have configured using LAPS, and register these
  882.     with the protocol driver. The driver internal tables and memory
  883.     are also allocated and initialized. The driver displays the banner
  884.     shown below when the driver loads successfully.
  885.  
  886.  
  887.           -----------------------------------------------------------
  888.           | DigiBoard Intelligent Board ANDIS MAC Driver    V 0.0.1 |
  889.           | DGANDIS.OS2   Copyright (C) 1994                        |
  890.           | All Rights Reserved.                                    |
  891.           -----------------------------------------------------------
  892.  
  893.         Installing DGANDIS
  894.         Initializing port: DIGI1
  895.         Initializing port: DIGI2
  896.         DGANDIS is installed
  897.  
  898.  
  899.  
  900.  
  901.     If the driver encounters an error while loading, one of the following
  902.     messages will be displayed. Since this driver does not initialize
  903.     any hardware the sources of error are usually software in nature
  904.     and fairly difficult for you to remedy but some suggestions may help.
  905.  
  906.  
  907.  
  908.     * Driver Registration Problems
  909.  
  910.  
  911.     "Can not open PROTMAN"
  912.     "PROTMAN returns error on config read"
  913.     "Register port to PROTMAN returns Failure"
  914.     "DosDevIOCtl Fails on register to PROTMAN"
  915.     "PROTMAN does not support PPAT"
  916.     "PPAT registration Failed"
  917.     "DosDevIOCtl Failed on GetPMInfo"
  918.  
  919.  
  920.  
  921.     - Cause & Remedy
  922.  
  923.  
  924.  
  925.     PROTMAN.OS2, the protocol manager, and the driver are having some
  926.     interaction difficulties. First, check to see that a
  927.  
  928.             "DEVICE=PROTMAN.OS2"
  929.  
  930.     statement is in your CONFIG.SYS file. Try recopying the DGANDIS.OS2
  931.     driver from the driver diskette. Also, you may have a wrong version
  932.     PROTMAN.OS2.
  933.  
  934.  
  935.  
  936.     * PROTOCOL.INI Problems
  937.  
  938.  
  939.       "ProcessKeyWords Failed"
  940.  
  941.  
  942.     - Cause & Remedy
  943.  
  944.  
  945.  
  946.     Check to see that your \ibmcom\protocol.ini file has a "PORTNAME="
  947.     line under [DGANDIS_nif] entry.
  948.  
  949.  
  950.  
  951.  
  952.     * OS/2 System Errors
  953.  
  954.  
  955.       "DGANDIS Failed to install"
  956.       "Internal Error"
  957.       "AllocPhysMem Failed"
  958.       "AllocGDT Failed"
  959.       "Phys2GDT Failed"
  960.       "VirtualAddr Failed"
  961.       "AllocSpareGDT Failed"
  962.  
  963.  
  964.  
  965.     - Cause & Remedy
  966.  
  967.     Chances are your system resources are depleted. Try unloading any
  968.     unnecessary drivers to see if the problem goes away. If this doesn't
  969.     work, get a bigger computer!
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.