home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / l40bat.zip / L40BATT.DOC < prev    next >
Text File  |  1993-07-28  |  8KB  |  204 lines
  1.  
  2. L40BATT - IBM PS/2 L40 SX Battery Monitor Program
  3. -------   --- ---- --- -- ------- ------- -------
  4.  
  5. (C) Copyright IBM Corp. 1991 - 1993. All Rights Reserved.
  6.  
  7. L40BATT is an OS/2 Presentation Manager program for monitoring the condition of
  8. the IBM PS/2 L40 SX battery. Bar graphs show the battery voltage and the
  9. current (in amperes) being drawn from the battery. Both bar graphs are updated
  10. once per second. Another graph displays the 'historical' value of the battery
  11. voltage so that you can monitor the battery's rate of charge or discharge. The
  12. program also displays an indicator whenever the AC adapter is connected to the
  13. L40.
  14.  
  15. ===============================================================================
  16.  
  17. REQUIREMENTS
  18.  
  19.  
  20. This program was written for, and only runs on, the IBM PS/2 L40 SX. It
  21. communicates directly with the L40's Slave Micro-Controller Unit (SMCU) to
  22. determine the current battery condition and to detect the attachment of the
  23. AC adapter.
  24.  
  25. The program was compiled to run under OS/2 1.30.1. It runs correctly under
  26. OS/2 2.0 as well.
  27.  
  28. ===============================================================================
  29.  
  30. INSTALLATION
  31.  
  32.  
  33. The file L40BAT.ZIP is a ZIP archive file. Unpack it with PKUNZIP (available on
  34. any bulletin board system or on CompuServe) into the subdirectory from which
  35. you intend to use the program. The following programs are contained within the
  36. ZIP file:
  37.  
  38.    L40BATT.DOC
  39.  
  40.       This file.
  41.  
  42.    L40BATT.EXE
  43.  
  44.       The executable file.
  45.  
  46.    L40BATT.HLP
  47.  
  48.       The interactive help file for the program.
  49.  
  50.    L40BATT.ABS
  51.  
  52.       A short description of the program.
  53.  
  54.    LICENSE.TXT
  55.  
  56.       The AS-IS program license agreement.
  57.  
  58. The executable program must access the L40's I/O ports to communicate with the
  59. SMCU chip, so you will need to make sure that it is given I/O Privilege in your
  60. CONFIG.SYS file. To do this, check to see that you have the following line in
  61. your CONFIG.SYS file:
  62.  
  63.    IOPL=YES
  64.  
  65. If you have IOPL=NO, you'll need to edit the line to change NO to YES.
  66.  
  67. The IOPL=YES line gives I/O privilege not only to L40BATT, but to any program
  68. that requests it. Some people, fearing damage from viruses or from rogue
  69. programs, prefer to limit the programs they give IOPL to. You can alternatively
  70. use the following line in your CONFIG.SYS file:
  71.  
  72.    IOPL=L40BATT
  73.  
  74. With this line, only the L40 Battery Monitor program is given I/O Privilege.
  75.  
  76. To successfully use L40BATT's built-in interactive help, be sure that the help
  77. data file L40BATT.HLP is copied to one of the following locations:
  78.  
  79.     1. Directory \OS2\HELP on your OS/2 boot disk drive,
  80.     2. Any directory specified in the HELP environment variable (type SET to
  81.        see the value of the HELP variable),
  82.     3. The current default directory (type CD to see the current default
  83.        directory.)
  84.  
  85. ===============================================================================
  86.  
  87. OPERATION
  88.  
  89. The L40BATT program may be executed by simply typing L40BATT at an OS/2
  90. command-line, by placing it in one of your OS/2 1.3 Group menus, or by
  91. placing it in one of your OS/2 2.0 Workplace Shell file folders. The latter are
  92. the preferred methods of execution, as you can specify that L40BATT will come
  93. up at system start-up.
  94.  
  95. You can force L40BATT to start up in the minimized state (that is, as an icon
  96. rather than an open window) by specifying the /M parameter when invoking the
  97. program. This is the only command-line parameter that L40BATT accepts.
  98.  
  99. The bar graphs are updated once per second. The left graph shows the battery
  100. voltage (9 volts to 15 volts) and the rightmost graph shows the current in
  101. amperes being drawn from the battery (0 amps to 4 amps, though the value will
  102. become negative when the battery is charging.)
  103.  
  104. The line graph records the voltage value every 18 seconds, thus building a
  105. chart of battery voltage over the last hour. A downward slope indicates that
  106. the battery is discharging, and an upward slope indicates that the battery is
  107. charging. You can clear this graph by selecting the NEW option in the DISPLAY
  108. action bar pull-down menu.
  109.  
  110. ===============================================================================
  111.  
  112. NOTES
  113.  
  114. L40BATT consults your OS/2 system configuration parameters to determine how
  115. long it should display its initial logo screen. After you install OS/2, the
  116. logo panel display time is 'indefinite', and you must press ENTER to dismiss
  117. the panel. You may change the logo panel display time to any desired value in
  118. milliseconds, including 0, in one of the following ways:
  119.  
  120.    Under OS/2 PM 1.30.x, bring up the Desktop Manager menu and select the
  121.    "Group - Utilities" option. Under this menu, select the Control Panel
  122.    application. The logo display time value can be changed via an action bar
  123.    menu item.
  124.  
  125.    Under OS/2 PM 2.x with the WPS, open the "OS/2 System" folder on the
  126.    desktop. Under this folder, open the "System Setup" folder, and select the
  127.    System icon under this folder. The logo display time value can be changed
  128.    via one of the notebook 'tabs'.
  129.  
  130. ===============================================================================
  131.  
  132. HISTORY
  133.  
  134.    Version 2.21  July 22, 1993
  135.  
  136.       Error pop-up messages are now written to a log file.
  137.       'Phantom' errors from the system are now detected and ignored.
  138.       Increased the program stack to account for new OS/2 2.1 requirements.
  139.       Found a compiler switch set wrong - unknown if it caused any problems.
  140.       Program was not saving options correctly under OS/2 2.1, causing multiple
  141.          unrelated program errors at subsequent startups.
  142.       Program options are now saved to L40BATT.INI, and not to OS2.INI.
  143.       Released to the world via the IBM Employee Written Software program.
  144.  
  145.    Version 2.20  February 9, 1993
  146.  
  147.       Added option to sync window title updates to bar or line graph updates.
  148.       Revised display code to not redraw the line graph each second.
  149.       Changed the 'simulated display' mode to be more visually interesting.
  150.       Released to the world via the IBM Employee Written Software program.
  151.  
  152.    Version 2.10  October 12, 1992
  153.  
  154.       Interactive help added.
  155.       The voltage graph value is now displayed in the program title.
  156.       Added the /M command line parameter to force minimized start-up.
  157.       Changed the line graph X-axis label from elapsed "Hours" to "Minutes".
  158.       Released to the world via the IBM Employee Written Software program.
  159.  
  160.    Version 2.00  November 22, 1991
  161.  
  162.       Now works correctly under OS/2 2.0 beta test driver 6.167F.
  163.       Minor fix to better handle customized screen colors.
  164.       Released to individuals within IBM and to CompuServe's IBMOS2 forum.
  165.  
  166.    Version 1.05  October 10, 1991
  167.  
  168.       Revised amperes calculation (Found an error in the L40 Tech Ref.)
  169.       Display of very small +/- amperes values is now handled correctly.
  170.       Released to individuals within IBM and to CompuServe's IBMOS2 forum.
  171.  
  172.    Version 1.04  September 20, 1991
  173.  
  174.       AC connection indicator (a dot) was added to the minimized program icon.
  175.       Graph colors can now be specified.
  176.       Program options can now be saved between sessions.
  177.       The program window position can now be saved between sessions.
  178.       Correctly uses color when the PM window background color is not white.
  179.       Attempt to make work under OS/2 2.0 6.149 (PTR opened for DosPortAccess.)
  180.       Released to individuals within IBM and to CompuServe's IBMOS2 forum.
  181.  
  182.    Version 1.03  September 2, 1991
  183.  
  184.       Charge/discharge history graph now displayed in minimized program icon.
  185.       Released to individuals within IBM and to CompuServe's IBMOS2 forum.
  186.  
  187.    Version 1.02  August 22, 1991
  188.  
  189.       Default program icon now set automatically.
  190.       Released to individuals within IBM.
  191.  
  192.    Version 1.01  August 13, 1991
  193.  
  194.       Removed the MAXIMIZE button from the title bar.
  195.       Updated DOC file to mention problems with OS/2 2.0 EEP driver 6.149.
  196.       Released to GEnie's LAPTOP forum.
  197.  
  198.    Version 1.00  August 12, 1991
  199.  
  200.       Baseline functionality.
  201.       First version, released to CompuServe's IBMOS2 forum.
  202.  
  203. ===============================================================================
  204.