Secondary Temperature Control Program (STCP) Specification for Qualcomm Battery Characterization Software (QBCSW) [80-NN139-21 Rev. A ed.]

Citation preview

Secondary Temperature Control Program (STCP) Specification for Qualcomm Battery Characterization Software (QBCSW)

80-NN139-21 Rev. A Confidential and Proprietary – Qualcomm Technologies, Inc. Restricted Distribution: Not to be distributed to anyone who is not an employee of either Qualcomm or its subsidiaries without the express approval of Qualcomm’s Configuration Management.

Confidential and Proprietary – Qualcomm Technologies, Inc. NO PUBLIC DISCLOSURE PERMITTED: Please report postings of this document on public servers or websites to: [email protected]. Restricted Distribution: Not to be distributed to anyone who is not an employee of either Qualcomm or its subsidiaries without the express approval of Qualcomm’s Configuration Management. Not to be used, copied, reproduced, or modified in whole or in part, nor its contents revealed in any manner to others without the express written permission of Qualcomm Technologies, Inc. Qualcomm is a trademark of QUALCOMM Incorporated, registered in the United States and other countries. All QUALCOMM Incorporated trademarks are used with permission. Other product and brand names may be trademarks or registered trademarks of their respective owners. This technical data may be subject to U.S. and international export, re-export, or transfer (“export”) laws. Diversion contrary to U.S. and international law is strictly prohibited. Qualcomm Technologies, Inc. 5775 Morehouse Drive San Diego, CA 92121 U.S.A. © 2014 Qualcomm Technologies, Inc.

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

2

Revision History

Revision

Date

A

June 2014

Description Initial release

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

3

Contents

1 Overview

5

2 QBCSW and STCP

7

2.1 Behavior QBCSW and STCP 2.2 Requirements of STCP

8 11

3 High-level Sequence Diagrams

25

4 References

29

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

4

Section 1

Overview STCP Specification for QBCSW

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

5

Overview Qualcomm® has developed a battery characterization software (QBCSW) application that measures battery open circuit voltage and resistance as they vary with temperature and state of charge.  





Sec. 1

QBCSW interacts with a battery charger (Keithley 2306) and a temperature chamber. To enable the use of a wider variety of temperature chambers, QBCSW is being modified to allow a secondary temperature control program (STCP) to read and set the chamber temperature. QBCSW and STCP should interface in synchronized ways so that QBCSW can execute correctly. This document specifies the interface to be used. See the QBCSW User Manual (80-NN139-1) for the QBCSW operation details, beyond the scope of this document.

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

6

Section 2

QBCSW and STCP

2.1 Behavior QBCSW and STCP 2.2 Requirements of STCP

8 11

STCP Specification for QBCSW

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

7

Section 2.1

Behavior QBCSW and STCP STCP Specification for QBCSW

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

8

Behavior Summary of QBCSW and STCP 

QBCSW is a Windows application written in VB.NET



STCP may be written in any suitable language/s



The main QBCSW user interface form is used to configure, start, and monitor battery characterization 







Configuration details include an ordered list of temperatures to be used

Battery charger (Keithley 2306) is used to charge and discharge the battery under test and to measure voltage and current Temperature chamber controls the temperature during testing 

QBCSW currently supports only a chamber with Watlow F4 controller



Batteries can be characterized during charging and/or discharging cycles

For each temperature to test, STCP must interact with the following type of QBCSW-driven actions, for both charging and discharging: 

Set the temperature chamber to the desired temperature and exchange files that signal the beginning and completion of this temperature-setting. – The desired temperature is either room temperature (25 °C) or the current target temperature

– E.g. typically a battery is not characterized during charging and is characterized during discharging – in this case, the desired temperature during charging is always 25 °C and the desired temperature during discharging changes for each cycle – Alternately, if a battery is being characterized during both charging and discharging, then the desired temperature during both charging and discharging changes for each cycle – All such files read/written by QBCSW or STCP are located in a known, preconfigured directory (the synch file directory) File content is not used; only file names matter

Sec. 2.1

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

9

Behavior Summary of QBCSW and STCP (continued) On an ongoing basis, STCP may optionally interact with QBCSW by: 

Reporting the most recently measured temperature chamber temperature 

STCP must perform this role for QBCSW to be able to: – Log actual measured temperatures – Abort the program if measured temperature falls outside of the configured range



Sec. 2.1

If STCP does not perform this role then the user alone is responsible for temperature integrity

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

10

Section 2.2

Requirements of STCP STCP Specification for QBCSW

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

11

Summary of STCP Requirements 

STCP required actions: A. Wait for and recognize QBCSW-written files that signal when to set temperature B. Set target temperature and monitor temperature as it changes to the target temperature C. Write files that signal to QBCSW successful setting of target temperature: Contact Qualcomm for updated specifics of file formats



STCP optional action: 





Write file/s that report to QBCSW most recent measured temperature

Configuration data that STCP requires prior to the start of a QBCSW test: 

Ordered list of target temperatures



Temperature-setting timeout limit (enforced by QBCSW, not STCP)



Temperature-setting tolerance (acceptable variance from target temperature)



Whether battery is or is not being characterized during charge and discharge



Synch file directory path where STCP and QBCSW read/write files



Format details of files to wait for and to write

The user must set the following QBCSW configuration setting before starting tests: 

Sec. 2.2

Check relevant box to indicate use of STCP for temperature chamber

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

12

STCP Required Actions 1. Wait for and recognize QBCSW-written files that signal when to set temperature 

To signal when STCP should set the temperature for each target temperature’s charging-cycle or discharging-cycle, QBCSW writes a uniquely-named file with this format: – SET_TEMP_CHARGING_BEGIN_COMMAND___ OR – SET_TEMP_DISCHARGING_BEGIN_COMMAND___ – Example: SET_TEMP_CHARGING_BEGIN_COMMAND_0_25_3000 would be the file indicating the beginning of setting charging-cycle temperature for the first target temperature (index 0) whose target temperature Centigrade value is 25, written by QBCSW instance with process ID of 3000 – Like all other synchronization-related files, this file are placed in the synch file directory

2. Set target temperature and monitor temperature 



During this stage, STCP does not need to read or write any QBCSW-related files. QBCSW is waiting for STCP to write the file described on the next slide (required action C) There is a pre-configured time limit within which the temperature chamber must settle at the target temperature and STCP must report this to QBCSW

3. Write files that signal to QBCSW successful setting of target temperature 

For each target temperature’s charging cycle, QBCSW writes a file with format – SET_TEMP_CHARGING_COMPLETED_COMMAND___ – Example: SET_TEMP_CHARGING_COMPLETED_COMMAND_0_-20_3000 would be the file indicating the successful completion of STPC’s setting temperature to -20 Centigrade for the first target temperature (index 0) – Like all other synchronization-related files, this file is found in the synch file directory – Note that timing is critical: STCP must not begin setting the temperature until it detects the relevant signal file from QBCSW, and then it must, as soon as possible, set the temperature and report success in doing so. Once the temperature has reached a value within the acceptable range (target temperature +/- the configured acceptable variance) STCP should write the appropriate file signaling completion of temperature setting.

Sec. 2.2

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

13

Example Signal Files 1 This series of files would be written by QBCSW for the 3-temperature series with order and values of {-20, 0, 25} in the case where the battery is not being characterized during charging cycle and is being characterized during discharging cycle. 

SET_TEMP_CHARGING_BEGIN_COMMAND_0_25_1234



SET_TEMP_DISCHARGING_BEGIN_COMMAND_0_-20_1234



SET_TEMP_CHARGING_BEGIN_COMMAND_1_25_1234



SET_TEMP_DISCHARGING_BEGIN_COMMAND_1_0_1234



SET_TEMP_CHARGING_BEGIN_COMMAND_2_25_1234



SET_TEMP_DISCHARGING_BEGIN_COMMAND_2_25_1234

Sec. 2.2

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

14

Example Signal Files 2 In response to the set of files on the previous slide, STCP could write the set of files listed below. STCP would write each file after completing the corresponding successful setting of temperature. Note that the process ID value (5678, 001, etc.) does not matter as long as the format is followed. 

SET_TEMP_CHARGING_COMPLETED_COMMAND_0_25_5678



SET_TEMP_DISCHARGING_COMPLETED_COMMAND_0_-20_001



SET_TEMP_CHARGING_COMPLETED_COMMAND_1_25_444



SET_TEMP_DISCHARGING_COMPLETED_COMMAND_1_0_888



SET_TEMP_CHARGING_COMPLETED_COMMAND_2_25_1234



SET_TEMP_DISCHARGING_COMPLETED_COMMAND_2_25_1234

Sec. 2.2

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

15

Example Signal Files 3 This series of files would be written by QBCSW for the 3-temperature series with order and values of {-10, 0, 25} in the case where the battery is being characterized during charging cycle and is being characterized during discharging cycle. Note the difference in temperature values for the charging cycle files between these file names and those of the previous series of files. 

SET_TEMP_CHARGING_BEGIN_COMMAND_0_-10_1234



SET_TEMP_DISCHARGING_BEGIN_COMMAND_0_-10_1234



SET_TEMP_CHARGING_BEGIN_COMMAND_1_0_1234



SET_TEMP_DISCHARGING_BEGIN_COMMAND_1_0_1234



SET_TEMP_CHARGING_BEGIN_COMMAND_2_25_1234



SET_TEMP_DISCHARGING_BEGIN_COMMAND_2_25_1234

Sec. 2.2

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

16

Example Signal Files 4 In response to the set of files on the previous slide, STCP could write the set of files listed below. STCP would write each file after completing the corresponding successful setting of temperature. Note that the process ID value (5678, 001, etc.) does not matter as long as the format is followed. 

SET_TEMP_CHARGING_COMPLETED_COMMAND_0_-10_5678



SET_TEMP_DISCHARGING_COMPLETED_COMMAND_0_-10_5678



SET_TEMP_CHARGING_COMPLETED_COMMAND_1_0_5678



SET_TEMP_DISCHARGING_COMPLETED_COMMAND_1_0_5678



SET_TEMP_CHARGING_COMPLETED_COMMAND_2_25_5678



SET_TEMP_DISCHARGING_COMPLETED_COMMAND_2_25_5678

Sec. 2.2

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

17

STCP Optional Action Write file/s that report to QBCSW most recent measured temperature 

 

If STCP writes such files throughout the execution time of QBCSW, QBCSW accurately logs measured temperatures and abort execution and/or report problems with the temperature if/when the temperature is out of range. Such files must be written to the synch file folder. At most, two temperature measurement reporting files should remain in the synch file folder. Therefore, STCP should remove stale such files in the course of creating or updating new files.



QBCSW uses the most recently written file as the source of the most recent temperature measurement.



File format is explained on the next slide.

Sec. 2.2

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

18

Example Measurement File 

LATEST_TEMPERATURE_FROM_MASTER_3000_25.2 

The file name above illustrates the format STCP must use for reporting temperature measurements. The format is: – LATEST_TEMPERATURE_FROM_MASTER__







Process ID section of the filename may take on any alphanumeric value, but it must be present and it must be separated by ‘_’ characters from the preceding string and the succeeding temperature measurement Measured temperature section of the filename must represent temperature using digits, a prefixed negative sign if necessary, and optionally a decimal point with at most one digit following the decimal point

LATEST_TEMPERATURE_FROM_MASTER_OLD3000_25.2 

The file name above is the format QBCSW uses for preserving a previously reported temperature value. STCP can follow the same convention: – When ready to write a new temperature measurement file, STCP can preserve the previous measurement using such a file format. Again, QBCSW uses the most recently written temperature measurement file as the source of temperature value, and no more than two such files should be present.

Sec. 2.2

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

19

Configuration Data that STCP Requires Prior to Start of QBCSW Tests 

Ordered list of target temperatures



Temperature-setting timeout limit (enforced by QBCSW, not STCP)



Temperature-setting tolerance (acceptable variance from target temperature)



Whether battery is or is not being characterized during charge and discharge



Synch file directory path where STCP and QBCSW read/write files 

Items A–D are loaded and edited by QBCSW user at runtime



Item E is written at runtime by QBCSW into a file with a preconfigured location and name – The file location is one configuration parameter (Output file root directory) and the file name is another parameter (Synchronization file path file name)





Example views of these configurations within the QBCSW user interface are on next two slides; relevant lines labeled A–E, further explanation follows on the next two slides

Format file details to wait for and to write: Contact Qualcomm for updated specifics of file  

Item F was described in detail on slides 8–14 STCP knows which files to expect from QBCSW, and which files to write upon successful setting of temperature, based on the ordered list of target temperatures that is part of the pre-configured data copied from QBCSW to STCP by the user. The list of temperatures is zero-indexed: – Files for the first cycle have suffix format: _0__ – Files for the second cycle have suffix format: _1__ and so on – STCP needs to wait for, recognize, and write files based upon the temperature index and temperature value in the file suffixes; the process ID at the very end of files written by QBCSW is not relevant to STCP and STCP can append any positive integer for that final part of the files it writes

Sec. 2.2

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

20

Example Settings 1

Sec. 2.2

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

21

Example Settings 2

Sec. 2.2

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

22

Explanation of Configuration Items A–E  





Item A is an ordered list of numbers (possibly with associated Booleans) representing target temperatures Item B is an integer representing the maximum number of minutes allowed for the temperature chamber to settle on a given target temperature Item C is a set of two Boolean values indicating whether the battery is or is not be characterized during charging and discharging cycles Item D is the maximum allowable difference between target and measured temperature

The user should configure STCP for items A–D, using values identical to those used for QBCSW, prior to selecting the green Start Test button in QBCSW 

Item E:  





Item E is written at runtime by QBCSW into a file with a preconfigured location and name The user should configure STCP to discover the value of item E by giving STCP the values tagged as E in the slide. STCP must use the configured path and file name to open this pre-specified file.

The file contains a single line of text; STCP must use this line of text as the path to the synch file directory, where all relevant files are read and written STCP is able to open the preconfigured file to discover the synch file path almost immediately after the Start Test is selected. The programmer/user of STCP should expect a brief delay (a few seconds) before trying to read the file.

Sec. 2.2

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

23

QBCSW Configuration Setting The QBCSW configuration settings the user must make before starting tests: 

Check relevant box to indicate use of STCP for temperature chamber 



Sec. 2.2

The user must select the Multiple Charger Setting box pictured below, in the QBCSW interface, prior to clicking the green Start Test button. If this box remains unchecked then QBCSW does not expect STCP to be active and QBCSW performs all STCP actions (required actions and optional actions).

The Use STCP for temp. chamber must be selected

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

24

Section 3

High-level Sequence Diagrams STCP Specification for QBCSW

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

25

Illustrating Relevant Flow for Configuration and Start (Slides 20–24) 

User must provide identical configuration details to QBCSW and STCP



User must select the Use STCP for temp. chamber

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

26

Illustrating Relevant Flow for Setting Temperature (Slides 13–17) 

QBCSW indicates start of temperature-setting phase by writing SET_TEMP_~_BEGIN file



STCP sets temperature



Once temperature is reached, STCP indicates this by writing SET_TEMP_~_COMPLETED file; QBCSW continues with characterization

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

27

Illustrating Relevant Flow for Reporting Temperature (Slides 18–19) 

STCP reads current temperature from chamber



STCP writes LATEST_TEMP file



QBCSW reads LATEST_TEMP file

Sec. 3

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

28

Section 4

References STCP Specification for QBCSW

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

29

Reference: Complete Range of Synchronization File Types For reference when debugging/testing: The following file types should appear in the synch file folder during the course of QBCSW execution. Brackets [] enclose alternative strings. For details please contact John Griffin or refer to the QBCSW User Manual (80-NN139-1). 

REGISTRATION_DECLARATION_



REGISTRATION_COMPLETED_COMMAND_



SET_TEMP_[CHARGING/DISCHARGING]_[BEGIN/COMPLETED]_COMMAND___



SET_TEMP_[CHARGING/DISCHARGING]_[BEGIN/COMPLETED]_COMMAND_ACK___



SOAK_[CHARGING/DISCHARGING]_[BEGIN/COMPLETED]_COMMAND___



SOAK_[CHARGING/DISCHARGING]_[BEGIN/COMPLETED]_COMMAND_ACK___





RUN_[CHARGE/DISCHARGE]_[NO/YES]_CHARACTERIZE_[BEGIN/COMPLETED]_COMMAND___ RUN_[CHARGE/DISCHARGE]_[NO/YES]_CHARACTERIZE_[BEGIN/COMPLETED]_COMMAND_ACK___



LATEST_TEMPERATURE_FROM_MASTER__



LATEST_TEMPERATURE_FROM_MASTER_OLD_



REPORT_ALL_TESTS_RESULT_COMMAND_



ABORT_COMMAND_



REPORT_ALL_TESTS_RESULT_COMMAND_ACK__[SUCCESS/FAIL]



ABORT_COMMAND_ACK_

Sec. 4

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

30

Questions? You may also submit questions to: https://support.cdmatech.com

Confidential and Proprietary – Qualcomm Technologies, Inc. | MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION | 80-NN139-21 Rev. A

31