home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / ls30ups.zip / addition.txt next >
Text File  |  1993-09-16  |  11KB  |  270 lines
  1.  
  2.    Brief Description:
  3.  
  4. A  Customer  of Compaq has noted that they can not use the UPS Service with a
  5. certin SDLC adapter.  This is caused because the SDLC adapter uses IRQ 3  and
  6. IRQ4  and  the  UPS  Service  only  can be configured for these two interrupt
  7. levels.  In this type of machine (ISA) the only solution currently  available
  8. to fix this problem is to patch the UPS source.
  9.  
  10.  
  11. 1.2  PROPOSED SOLUTION:
  12. _______________________
  13.  
  14.  The proposed solution would be to make the com. port configurable.
  15.  The range for the com. port would be 1 - 4. Also make the Vector
  16.  address and the IRQ configurable. So the device =  statement would
  17.  be as follows :
  18.  
  19.  DEVICE=C:\IBMLAN\NETPROG\UPSDRV.OS2 /PORT:COMX /IRQ:XX /ADDR:XXXh
  20.  
  21. These parameters would be optional. (/IRQ: and /ADDR:)
  22.  
  23. Deliverables
  24.  
  25. ls.r20 - ups.exe
  26.          upsdrv.os2
  27.  
  28. ls.r30 - ups.exe
  29.          upsdrv.os2
  30.  
  31. NEW DEVICE DRIVER
  32.  
  33. This driver replaces the old UPS device driver in /ibmlan/netprog.  The
  34. following are new features of the driver:
  35.  
  36.    A. Enabled for interrupt request (IRQ) level sharing.  The driver will
  37.          work with other drivers that share interrupts.  At INIT time (during
  38.          config.sys processing) the driver attempts to take the IRQ as
  39.          non-shared and validate the port I/O address.  At OPEN time (when
  40.          the UPS service starts) the driver attempts to take the IRQ as
  41.          shared.
  42.    B. New parameters:  IOADDR and IRQ.  These parameters allow the user to
  43.          specify a non-standard I/O port address and IRQ for the serial port
  44.          used by the UPS.  These parameters are mutually exclusive with the
  45.          existing PORT parameter.
  46.  
  47.       The PORT parameter is set to COM1 or COM2 during the normal installation
  48.          of LAN Server.  The installation/configuration program adds the
  49.          following line into the CONFIG.SYS:
  50.  
  51.          DEVICE=<LAN Server Install Path>\NETPROG\UPSDRV.OS2 /PORT:COMx
  52.  
  53.          COM1 and COM2 are the only valid options to the /PORT parameter.  An
  54.          error will be generated if any other value is specified.  In LS 3.0,
  55.          the driver assumed COM1 if the value was not 2.
  56.  
  57.       Users may have access to serial boards that provide communications ports
  58.          ports that do not conform to IBM standard configurations.  Such boards
  59.          usually offer the user multiple serial ports.  There are also
  60.          circumstances when the user needs the standard COM1 and COM2 for other
  61.          devices but still want the security of a UPS interface.  In these
  62.          cases, the user will need to edit the CONFIG.SYS file and change the
  63.          UPS driver parameters.
  64.  
  65.       Both /IOADDR: and /IRQ: parameters must be specified.
  66.  
  67.       The I/O port address and IRQ for non-standard boards are specified in
  68.          their technical documentation.  Both the "xxxx" and "y" values are
  69.          hexadecimal numbers.  The /IOADDR: value can be a variable number of
  70.          hexadecimal digits.  The /IRQ: value can only be 1 hexadecimal digit.
  71.  
  72.       For example, the IBM Dual Async Adapter provides 2 additional serial
  73.          ports.  On a PS/2 Model 95 containing this adapter, the default
  74.          configuration would be:
  75.  
  76.          Planar:   PORT 1  IRQ 4  IO ADDR 3F8-3FF
  77.          Adapter:  PORT 2  IRQ 3  IO ADDR 2F8-2FF
  78.                    PORT 3  IRQ 3  IO ADDR 3220-3227
  79.  
  80.          To use port 3 (by default, the second port on the adapter), CONFIG.SYS
  81.             would be edited to look like this:
  82.  
  83.          DEVICE=<LAN Server Install Path>\NETPROG\UPSDRV.OS2 /IOADDR:3220 /IRQ:3
  84.  
  85.    C. Messages.  During IPL of a system with the UPS service installed, there
  86.          can be several reasons why the UPS device driver will not install.
  87.          The following list shows the possible text output during IPL that
  88.          accompany a failed attempt to install the UPS device driver.  Along
  89.          with this text is a more detailed description of why the device driver
  90.          did not get installed and/or corrective actions the user can take.
  91.  
  92.       Note:  these messages correspond to base OS/2 message numbers.  The
  93.          cause/action text below supercedes any text for the base messages.
  94.  
  95.       /PORT parameter used:
  96.  
  97.          1. Message
  98.             -------
  99.             "UPS did not install.
  100.             The device does not recognize the command."
  101.  
  102.             Description
  103.             -----------
  104.             The user has specified a COM port parameter other than COM1 or
  105.             COM2.  The user needs to use the /IOADDR: /IRQ: parameters to
  106.             specify a port configuration other than COM1 or COM2.
  107.  
  108.          2. Message
  109.             -------
  110.             "UPS did not install.
  111.             The device adapter could not be located,
  112.             or it is in use by another device."
  113.  
  114.             Description
  115.             -----------
  116.             The specified COM port is not recognized by the BIOS, i.e., OS/2
  117.             is not aware of the COM port's existence.  Run diagnostics to
  118.             determine if the port exists and its I/O address is either
  119.             hex 3f8 (for COM1) or hex 2f8 (for COM2).
  120.  
  121.          3. Message
  122.             -------
  123.             "UPS did not install.
  124.             The device adapter is not supported."
  125.  
  126.             Description
  127.             -----------
  128.             The specified COM port has been configured with a non-standard
  129.             I/O address.  Run diagnostics to be certain that the port's I/O
  130.             address is either hex 3f8 (for COM1) or hex 2f8 (for COM2).
  131.  
  132.             If the port's I/O address is not the standard values as described
  133.             above, the user should use the /IOADDR: /IRQ: parameters to
  134.             specify the proper values.
  135.  
  136.          4. Message
  137.             -------
  138.             "UPS did not install.
  139.             The interrupt level is not available."
  140.  
  141.             Description
  142.             -----------
  143.             A device has already reserved non-shared use of the COM port's IRQ.
  144.             COM1 uses IRQ 4 and COM2 uses IRQ 3.  If possible, configure the
  145.             COM port's IRQ value and use the /IOADDR: /IRQ: parameters to
  146.             specify the different configuration.
  147.  
  148.             If this isn't possible, determine which device has reserved the IRQ
  149.             level and change its configuration.
  150.  
  151.             If this isn't possible, change the COM port for use by the UPS.
  152.  
  153.       /IOADDR: /IRQ: parameters used:
  154.  
  155.          1. Message
  156.             -------
  157.             "UPS did not install.
  158.             The device does not recognize the command."
  159.  
  160.             Description
  161.             -----------
  162.             The user has specified a command parameter other than the /IOADDR:
  163.             /IRQ: pair.  The first parameter must be the /IOADDR: and its value
  164.             followed by the /IRQ: parameter and its value.
  165.  
  166.          2. Message
  167.             -------
  168.             "UPS did not install.
  169.             SYS1003: The syntax of the command is incorrect."
  170.  
  171.             Description
  172.             -----------
  173.             The user has:
  174.                A. specified only a portion of the /IOADDR: parameter, or
  175.                B. failed to specify a hexadecimal value for the /IOADDR:
  176.                   parameter, or
  177.                C. failed to specify the /IRQ: parameter or only a portion
  178.                   of the parameter, or
  179.                D. failed to specify a single hexadecimal digit for the
  180.                   /IRQ: value.
  181.  
  182.          3. Message
  183.             -------
  184.             "UPS did not install.
  185.             SYS0487: The specified address is not correct."
  186.  
  187.             Description
  188.             -----------
  189.             The value specified with the /IOADDR: parameter is not correct.
  190.             The device driver attempted to validate the specified address
  191.             as a legitimate serial port but got no response.
  192.  
  193.             Run diagnostics to determine if the port's I/O address is correct
  194.             and is correctly specified in the CONFIG.SYS file.
  195.  
  196.          4. Message
  197.             -------
  198.             "UPS did not install.
  199.             The interrupt level is not available."
  200.  
  201.             Description
  202.             -----------
  203.             A device has already reserved non-shared use of the IRQ.  If
  204.             possible, reconfigure the serial port's IRQ value and change
  205.             the /IRQ: value in CONFIG.SYS file.
  206.  
  207.             If this isn't possible, determine which device has reserved the IRQ
  208.             level and change its configuration.
  209.  
  210. 3. NEW SERVICE
  211.  
  212. This service replaces the old UPS service in /ibmlan/services.  The
  213. following are changes to the service:
  214.  
  215.    A. Fixes for problems:
  216.  
  217.       1.  Shutdown not performed after power failure and low battery messages.
  218.       2.  LOWBATTERY effective whether AC line is good or bad.
  219.       3.  No low battery message before shutdown where low battery signal is
  220.              available.
  221.       4.  Spurious low battery message when UPS cannot signal low battery.
  222.  
  223.    B. Down-level clients are no longer notified of UPS events.  This includes
  224.          LS 1.0, DLR 1.0, PCLP 1.31 or later, and LM 1.0 (DOS/OS2).  *LM 1.0
  225.          is property of Microsoft Corp.  (C) (R)*
  226.  
  227. Parameter + Default Values Summary:
  228.  
  229.    General:
  230.  
  231.    SIGNALS     100                    MESSDELAY   5 seconds
  232.    VOLTLEVELS  100                    MESSTIME  120 seconds
  233.  
  234.    CMDFILE     <none>
  235.    CMDTIMER     30 seconds
  236.  
  237.    AC good/battery low:
  238.  
  239.    LOWBATTERY  WARNING
  240.    BATTERYMSG  600 seconds (only used for LOWBATTERY=WARNING)
  241.  
  242.    UPS can't signal low battery:
  243.  
  244.    BATTERYTIME  60 seconds
  245.    RECHARGE    100 seconds
  246.  
  247. Miscellaneous notes
  248.    A. DMA mode of micro-channel architecture machines.
  249.          Newer MCA machines, such as the IBM PS/2 models 57, 90, and 95, which
  250.          feature a DMA mode for the serial ports, will cause problems for
  251.          UPS.  The manifestation is UPS service-initiated shutdown immediately
  252.          after the service starts.  To correct, use the system partition
  253.          reference information to set the transmit and receive arbitration
  254.          levels to "disabled" for the UPS-connected port.
  255.  
  256.    B. Compatibility with SDLC.
  257.          The SDLC device driver statement should include the "S" option
  258.          (device=c:/cmlib/sdlcdd.sys S 0), which is a directive for it to
  259.          share IRQ 3 and 4.
  260.  
  261.    C. Pinouts.
  262.       From UPS device       To 25-pin    To 9-pin
  263.          1 low batt            8 DCD        1
  264.          5 ground              7 SG         5
  265.         10 device shutdown    20 DTR        4
  266.         13 AC failure          5 CTS        8
  267.  
  268.  
  270.