Revision : 06 -------------------------------------------------------------------------------- Software Name Lenovo Battery Diagnostic Tool Support models ThinkPad R60, R60e, R60i ThinkPad R61, R61e, R61i ThinkPad T60, T60p ThinkPad T61, T61p ThinkPad X60, X60s ThinkPad X61, X61s Operating Systems Microsoft Windows 7 32-bit Microsoft Windows 7 64-bit Microsoft Windows Vista 32-bit Microsoft Windows Vista 64-bit Microsoft Windows XP Home Edition, Professional Microsoft Windows 2000 Version 1.6.3634.18081 -------------------------------------------------------------------------------- WHAT THIS PACKAGE DOES The LenovoBatteryDiagnosticTool.exe is provided to determine if your battery failed due to the issues outlined the URL below, and is qualified for a free replacement battery. http://www.lenovo.com/support/site.wss/BATT-082009.html -------------------------------------------------------------------------------- NOTES * Network Traffic The Lenovo Battery Diagnostic Tool will access the network to retrieve the current date and time, as well as to download a configuration file needed by the utility. To retrieve the date and time, the following URL is accessed. http://batteryprogram.lenovo.com/t.asp To retrieve the configuration file, the following URL is accessed. http://download.lenovo.com/lenovo/content/batt/LenovoBatteryDiagnosticTool_config.xmlz As a result, client firewalls, or corporate proxy servers, might prevent the utility from completing successfully. Aside from the retrieve requests, all network traffic is incoming. No data is sent out by the utility. [Note 1: Network traffic from the tool can be prevented. See the "SUPPORTED SWITCHES" section for more details.] Upon successful completion of the utility, by default a web browser is opened to a webpage which explains either why the battery does not qualify, or to a page where a replacement battery can be ordered. These pages are accessed by the web browser, so there are typically no concerns about a client firewall preventing completion of the utility. * Common Errors There are some common errors that users have been experiencing. -2147422111: The error number indicates that the utility is unable to gather the battery information. Typically this is because the battery does not have enough power to run the communications chip. If you remove the battery and re-insert it, the system will power the battery communications chip for a couple of seconds. If you run the utility again as soon as you insert the battery, it may work. -2147482776: The error number indicates a problem loading the Power Manager library which is needed to communicate with the battery. If you are using a 64-bit version of Windows, Power Manager needs to be installed. Below is a link where it can be found. http://www.lenovo.com/support/site.wss/document.do?lndocid=MIGR-70601 If you are using a 32-bit version Windows, the utility can install the Power Manager library while it is running, but administrator rights are required. On Windows Vista, this will require running the utility "As Administrator" if UAC (User Account Control) is enabled. When installed, Power Manager should appear as a big battery in your System Notification Area. It is also on Start->Programs->ThinkVantage-> Power Manager. Often, people confuse "Power Manager" with "Power Management driver". Be sure to install the application. * Return Codes The Lenovo Battery Diagnostic Tool will provide a return code which can be used to determine the qualification result. Cached configuration file created successfully 0 [See Note 6] No battery errors detected 1 Battery is too old or unaffected 2 or 4 [See Note 2] Battery error detected 3 Some error was encountered < 0 The program return code is also available in the registry HKCU\Software\Lenovo\BatteryDiagnosticTool\ReturnCode [Note 2: If the utility determines that the battery is bad, the return code will be 4; if not, the value will be 2. In either case, the battery is too old to qualify for a free replacement.] [Note 6: This is only returned if the --create-cached-config-file switch is provided. See below for details on this switch.] -------------------------------------------------------------------------------- SUPPORTED SWITCHES The Lenovo Battery Diagnostic Tool supports several command-line switches. These can be provided when calling the program, for example, in a Command Prompt, via the Start->Run menu, or from a batch file. --silent * Do not show any dialog boxes. Without this switch, dialog boxes are only shown in error conditions. --output-to-file * The filename should include a full path. If there are spaces in the filename or path, the entire filename should be enclosed in double quotes. * The path can include a drive letter, such as a mapped network share. * If the file exists, the new contents will be appended. * The output file is a text file with comma-separated values (CSV). The following information is included: o Timestamp o MachineType o MachineModel o MachineSerial o BatteryBarcode o BatteryFRU o BatteryError o BatteryCapacity o BatteryAge o FulfillmentURL * Users should use the FulfillmentURL to order their replacements for all qualified batteries. --no-fulfillment * Do not open a web browser when the utility has finished determining battery eligibility. Normally, the default web browser is opened to a web page which explains either why the battery does not qualify, or to a page where a replacement battery can be ordered. * Use of this switch without the "--output-to-file" switch does not make sense. --internet-proxy [:port] * Manually specify the proxy server the utility should use. Otherwise, proxy settings will be gathered from Internet Explorer, and failing that the Web Proxy Autodiscovery Protocol (WPAD). --proxy-username * Manually specify the proxy authentication username. --proxy-password * Manually specify the proxy authentication password. --no-network * Prevent the utility itself from accessing the network. This switch may be useful in corporate environments where adding an exception to the firewall is not possible. * Providing this switch requires that a cached configuration file be specified. * Providing this switch will cause the Windows Time Service to issue a resync command. This will cause network activity, though it will not be from the utility. * Providing this switch will not prevent the browser from being opened. Use the --no-fulfillment switch for that purpose. * When this switch is given, the program must be run with administrator privileges. This is because the Windows Time Service resync command requires administrator privileges to work. --cached-config-file * The filename should include a full path. If there are spaces in the filename or path, the entire filename should be enclosed in double quotes. * The path can include a drive letter, such as a mapped network share. * Read the configuration file needed by the utility from disk. This switch is required if the --no-network switch is provided. However, it may be used even without the --no-network switch. * If the cached configuration file does not exist, it will be created. To do this, the configuration file is downloaded from the network, unless the --no-network switch is also provided, in which case the utility will have an error. * The cached configuration file, when created, is created with a one month expiration. * If the cached configuration file is expired, it is deleted (and then re- created). --create-cached-config-file * The filename should include a full path. If there are spaces in the filename or path, the entire filename should be enclosed in double quotes. * The path can include a drive letter, such as a mapped network share. * Cannot be provided with --cached-config-file. * Cannot be provided with --no-network. * Will not replace the cached configuration file specified by filename if it already exists and is not expired. * This switch is provided to make it easier to create the cached configuration file. When this switch is provided, the battery will not be qualified for replacement. Creating the cached configuration file is all that the tool will do, before exiting. Example usage (all on one line): > LenovoBatteryDiagnosticTool.exe --no-fulfillment --output-to-file "N:\LenovoBatteryDiagnosticTool.csv" --silent --no-network --internet-proxy proxy.corporate.com:8001 --cached-config-file "\Lenovo\LenovoBatteryDiagnosticTool\cached config file.xmlz" [Note 3: The order in which the switches are provided does not matter.] [Note 4: The "current working directory" when the tool is run is the %TMP% folder. For that reason, it is recommended that the filenames provided include the full path.] [Note 5: In order to use the --no-network switch, a cached configuration file is needed. In order to create a cached configuration file, the network is needed. IT departments will need to create the cached configuration file; then, they can distribute it with the utility to be used with the --no-network switch.] -------------------------------------------------------------------------------- VERSION INFORMATION The following versions have been released to date. Version The contents -------------- ------------------- 1.6.3634.18081 Sixth release 1.5.3601.19500 Fifth release 1.4.3502.15362 Fourth release 1.3.3494.23481 Third release 1.2.3478.16507 Second release 1.0.0.0 Initial release To check the version of software, view the file Details, "File Version" information in Windows Explorer. Summary of Changes Where: < > Version number [Important] Important update (New) New function or enhancement (Fix) Correction to existing function <1.6.3634.18081> - (Fix) When the Internet Explorer checkbox for automatic detection of automatic configuration of proxy settings was checked, but the detection identified that there was no proxy server, the program would report that no internet connection was found. This has been fixed. The detection takes some extra time (about 15 seconds). <1.5.3601.19500> - (New) Added the ability to create a cached configuration file only. This makes it easier to create the cached configuration file. - (New) Added support for proxy server configurations requiring authentication. Now, proxy server basic credentials (username and password) can be provided through the command-line or a GUI prompt. - (New) Added messages (in English only) for many common errors. - (Fix) When the --no-network switch is provided, the w32tm command is issued. In version 1.5, the process is created with a hidden window. In 1.4, a window would appear while this command was running. <1.4.3502.15362> - (New) Added support Windows 2000. - (New) Added support for no network activity from the tool. That is, support for the --no-network and --cached-config-file switches. - (Fix) Fixed a problem where automatic proxy configuration scripts at a fixed URL were not detected.. Version 1.3 added support for WPAD, which uses DHCP or DNS to find the proxy configuration script. <1.3.3494.23481> - (New) Include program version (major and minor) in the messagebox. - (New) Added a message for 64-bit Windows users without Power Manager. - (New) Added autoproxy detection. - (New) Removed UAC elevation prompt requirement. - (Fix) Fix an error in the encryption library. This was displayed as error -2147422111. - (Fix) Ignore error if there is a problem getting system information (MTM, system serial number). - (Fix) Fixed language detection for error messages. - (Fix) Fixed a problem where application crashes. <1.2.3478.16507> - (New) Added the ability to specify a proxy server as a command-line argument. - (New) Added support for 64-bit Windows. - (New) Added support for users who have Battery MaxiMiser installed instead of Power Manager. - (Fix) Fix an error processing the date and time retrieved from the network. <1.0.0.0> - (New) Initial release. -------------------------------------------------------------------------------- LICENSING INFORMATION LenovoBatteryDiagnosticTool makes use of open source software (specifically TinyXML) made available through the zlib license: /* zlib.h -- interface of the 'zlib' general purpose compression library version 1.2.2, October 3rd, 2004 Copyright (C) 1995-2004 Jean-loup Gailly and Mark Adler This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required. 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software. 3. This notice may not be removed or altered from any source distribution. Jean-loup Gailly jloup@gzip.org Mark Adler madler@alumni.caltech.edu */ -------------------------------------------------------------------------------- TRADEMARKS * ThinkPad is a registered trademark of Lenovo. * Microsoft, Windows, and Internet Explorer are registered trademarks of Microsoft Corporation. Other company, product, and service names may be registered trademarks, trademarks or service marks of others.