home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / l40tem.zip / L40TEMP.DOC < prev    next >
Text File  |  1993-07-28  |  8KB  |  186 lines
  1.  
  2. L40TEMP - IBM PS/2 L40 SX Temperature Monitor Program
  3. -------   --- ---- --- -- ----------- ------- -------
  4.  
  5. (C) Copyright IBM Corp. 1991 - 1993. All Rights Reserved.
  6.  
  7. L40TEMP is an OS/2 Presentation Manager program for monitoring the temperature
  8. of the IBM PS/2 L40 SX battery and the ambient temperature inside the PS/2's
  9. case. Bar graphs show the battery and ambient temperatures, in degrees
  10. Fahrenheit or degrees Celsius. Both bar graphs are updated once per second.
  11. Another graph displays the 'historical' value of either the battery temperature
  12. or the ambient temperature so that you can monitor the rate of temperature
  13. change.
  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 and ambient temperatures.
  23.  
  24. The program was compiled to run under OS/2 1.30.1. It runs correctly under
  25. OS/2 2.x as well.
  26.  
  27. ===============================================================================
  28.  
  29. INSTALLATION
  30.  
  31.  
  32. The file L40TEM.ZIP is a ZIP archive file. Unpack it with PKUNZIP (available on
  33. any bulletin board system or on CompuServe) into the subdirectory from which
  34. you intend to use the program. The following programs are contained within the
  35. ZIP file:
  36.  
  37.    L40TEMP.DOC
  38.  
  39.       This file.
  40.  
  41.    L40TEMP.EXE
  42.  
  43.       The executable file.
  44.  
  45.    L40TEMP.HLP
  46.  
  47.       The interactive help file for the program.
  48.  
  49.    L40TEMP.ABS
  50.  
  51.       A short description of the program.
  52.  
  53.    LICENSE.TXT
  54.  
  55.       The AS-IS program license agreement.
  56.  
  57. The executable program must access the L40's I/O ports to communicate with the
  58. SMCU chip, so you will need to make sure that it is given I/O Privilege in your
  59. CONFIG.SYS file. To do this, check to see that you have the following line in
  60. your CONFIG.SYS file:
  61.  
  62.    IOPL=YES
  63.  
  64. If you have IOPL=NO, you'll need to edit the line to change NO to YES.
  65.  
  66. The IOPL=YES line gives I/O privilege not only to L40TEMP, but to any program
  67. that requests it. Some people, fearing damage from viruses or from rogue
  68. programs, prefer to limit the programs they give IOPL to. You can alternatively
  69. use the following line in your CONFIG.SYS file:
  70.  
  71.    IOPL=L40TEMP
  72.  
  73. With this, only the L40 Temperature Monitor program is given I/O Privilege.
  74.  
  75. To successfully use L40TEMP's built-in interactive help, be sure that the help
  76. data file L40TEMP.HLP is copied to one of the following locations:
  77.  
  78.     1. Directory \OS2\HELP on your OS/2 boot disk drive,
  79.     2. Any directory specified in the HELP environment variable (type SET to
  80.        see the value of the HELP variable),
  81.     3. The current default directory (type CD to see the current default
  82.        directory.)
  83.  
  84. ===============================================================================
  85.  
  86. OPERATION
  87.  
  88. The L40TEMP program may be executed by simply typing L40TEMP at an OS/2
  89. command-line, by placing it in one of your OS/2 1.3 Group menus, or by
  90. placing it in one of your OS/2 2.0 Workplace Shell file folders. The latter are
  91. the preferred methods of execution, as you can specify that L40TEMP will come
  92. up at system start-up.
  93.  
  94. You can force L40TEMP to start up in the minimized state (that is, as an icon
  95. rather than an open window) by specifying the /M parameter when invoking the
  96. program. This is the only command-line parameter that L40TEMP accepts.
  97.  
  98. The bar graphs are updated once per second. The left bar graph shows the
  99. battery temperature and the right bar graph shows the ambient PS/2 temperature.
  100. All temperatures are expressed in degrees Fahrenheit by default, but the
  101. program may be made to express temperatures in degrees Celsius via the
  102. TEMPERATURE SCALE action bar pull-down menu.
  103.  
  104. The line graph records the battery temperature value or the ambient temperature
  105. value every 18 seconds, thus building a chart of temperatures over the last
  106. hour. A downward slope indicates that the temperature is decreasing, and an
  107. upward slope indicates that the temperature is increasing. You can clear this
  108. graph by selecting the NEW option in the DISPLAY action bar pull-down menu.
  109.  
  110. ===============================================================================
  111.  
  112. NOTES
  113.  
  114. L40TEMP 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 L40TEMP.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 temperature 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.02  October 10, 1991
  167.  
  168.       Display of very small temperature values is now handled correctly.
  169.       Released to individuals within IBM and to CompuServe's IBMOS2 forum.
  170.  
  171.    Version 1.01  September 20, 1991
  172.  
  173.       Allows specification of Battery or Ambient temperature for line graph.
  174.       Graph colors can now be specified.
  175.       Program options can now be saved between sessions.
  176.       The program window position can now be saved between sessions.
  177.       Correctly uses color when the PM window background color is not white.
  178.       Released to individuals within IBM and to CompuServe's IBMOS2 forum.
  179.  
  180.    Version 1.00  September 9, 1991
  181.  
  182.       Baseline functionality.
  183.       First version, released to selected beta test volunteers only.
  184.  
  185. ===============================================================================
  186.