Quectel LTE Module Series Bedienungsanleitung

SC20 Charging User Guide

LTE Module Series

Rev. SC20_Charging_User_Guide_V1.0

Date: 2016-09-26

www.quectel.com

LTE Module Series

SC20 Charging User Guide

SC20_Charging_User_Guide Confidential / Released 1 / 14

Our aim is to provide customers with timely and comprehensive service. For any

assistance, please contact our company headquarters:

Quectel Wireless Solutions Co., Ltd.

Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233

Tel: +86 21 5108 6236

Email: [email protected]

Or our local office. For more information, please visit:

http://www.quectel.com/support/salesupport.aspx

For technical support, or to report documentation errors, please visit:

http://www.quectel.com/support/techsupport.aspx

Or email to: [email protected]

GENERAL NOTES

QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION

PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT

TO ENSURE THE QUALITY OF THE INFORMATION IT MAKES AVAILABLE. QUECTEL DOES NOT

MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT

ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR

RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO

CHANGE WITHOUT PRIOR NOTICE.

THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF

QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS

DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT

PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS

ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL

OR DESIGN.

Quectel

Confidential

LTE Module Series

SC20 Charging User Guide

SC20_Charging_User_Guide Confidential / Released 2 / 14

About the Document

History

Revision

Date

Author

Description

1.0

2016-09-26

Luffy ZHANG

Initial

Quectel

Confidential

LTE Module Series

SC20 Charging User Guide

SC20_Charging_User_Guide Confidential / Released 3 / 14

Contents

About the Document................................................................................................................................ 2

Contents.................................................................................................................................................... 3

Table Index ............................................................................................................................................... 4

1Introduction....................................................................................................................................... 5

2Debug................................................................................................................................................. 6

2.1. Related Code Files and Location.......................................................................................... 6

2.2. Debug................................................................................................................................... 6

3Compile and Download................................................................................................................... 11

4Charge.............................................................................................................................................. 12

4.1. Charging Process ...............................................................................................................12

4.2. Set Power-on/off Voltage ....................................................................................................12

4.3. The Maximum Charging Time.............................................................................................14

4.4. Abnormality.........................................................................................................................14

4.5. Query Device Information................................................................................................... 14

Quectel

Confidential

LTE Module Series

SC20 Charging User Guide

SC20_Charging_User_Guide Confidential / Released 4 / 14

Table Index

TABLE 1: RELATED CODE FILES AND LOCATIONS........................................................................................ 6

TABLE 2: BATTERY-TEMPERATURE MONITORING CALCULATIONS ......................................................... 10

Quectel

Confidential

LTE Module Series

SC20 Charging User Guide

SC20_Charging_User_Guide Confidential / Released 5 / 14

1Introduction

This document mainly describes debug codes for charging on Quectel SC20 module, which will help

customer to better understand the charging process.

Quectel

Confidential

LTE Module Series

SC20 Charging User Guide

SC20_Charging_User_Guide Confidential / Released 6 / 14

2Debug

2.1. Related Code Files and Location

Table 1: Related Code Files and Locations

Linux power_supply standard architecture enables power management on Android OS and data can be

sent to user space through Uevent mechanism.

2.2. Debug

Device Registration

The code for device registration is as follows:

static int qpnp_lbc_main_probe(struct spmi_device *spmi)

{

xxx

rc = power_supply_register(chip->dev, &chip->batt_psy); //Device registration

xxx

}

Code Files and Locations

Description

android/kernel/drivers/power/qpnp-linear-charger.c

Driver file for charging

android/kernel/arch/arm/boot/dts/qcom/batterydata-

palladium.dtsi

Battery parameters

android/kernel/arch/arm/boot/dts/qcom/msm-pm890

9.dtsi

Charging parameters

android/kernel/arch/arm/boot/dts/qcom/msm8909-p

m8909-mtp.dtsi

Charging switch

android/kernel/drivers/hwmon/qpnp-adc-common.c

Thermistor voltage and temperature table

qpnp-linear-charger.c

Driver file for charging, it is about device

registration, DTS parse, charging controlling, etc.

Quectel

Confidential

LTE Module Series

SC20 Charging User Guide

SC20_Charging_User_Guide Confidential / Released 7 / 14

static int qpnp_lbc_probe(struct spmi_device *spmi)

{

if (is_parallel_charger(spmi))

return qpnp_lbc_parallel_probe(spmi);

else

return qpnp_lbc_main_probe(spmi);

}

static int __init qpnp_lbc_init(void)

{

return spmi_driver_register(&qpnp_lbc_driver);

}

module_init(qpnp_lbc_init);

static void __exit qpnp_lbc_exit(void)

{

spmi_driver_unregister(&qpnp_lbc_driver);

}

module_exit(qpnp_lbc_exit);

MODULE_DESCRIPTION("QPNP Linear charger driver");

MODULE_LICENSE("GPL v2");

DTS Parse

DTS (Device Tree Source) is parsed by probe function.

static int qpnp_charger_read_dt_props(struct qpnp_lbc_chip *chip)

{ xxx

xxx

}

Charging Controlling

e.g.: when the battery temperature changes, charging current will become smaller to protect battery.

Please refer to the following code:

static void qpnp_lbc_set_appropriate_current(struct qpnp_lbc_chip *chip)

{

unsigned int chg_current = chip->usb_psy_ma;

if (chip->bat_is_cool && chip->cfg_cool_bat_chg_ma)

chg_current = min(chg_current, chip->cfg_cool_bat_chg_ma);

if (chip->bat_is_warm && chip->cfg_warm_bat_chg_ma)

chg_current = min(chg_current, chip->cfg_warm_bat_chg_ma);

if (chip->therm_lvl_sel != 0 && chip->thermal_mitigation)

chg_current = min(chg_current,

Quectel

Confidential

LTE Module Series

SC20 Charging User Guide

SC20_Charging_User_Guide Confidential / Released 8 / 14

chip->thermal_mitigation[chip->therm_lvl_sel]);

pr_debug("setting charger current %d mA\n", chg_current);

qpnp_lbc_ibatmax_set(chip, chg_current);

}

Battery Parameters

Battery parameters can be configured to calculate battery capacity, such as OCV (Open Circuit Voltage)

under different temperature and battery percentage.

qcom,pc-temp-ocv-lut{ xxx

}

Charging Parameters

Charging parameters includes high temperature percentage, low temperature percentage, battery cooling

threshold, battery warming threshold, charging current, etc., as shown below:

pm8909_chg: qcom,charger{

xxx

qcom,batt-hot-percentage = <35>; //High temperature percentage

qcom,batt-cold-percentage = <70>; //Low temperature percentage

qcom,cool-bat-decidegc = <100>; //Cooling threshold

qcom,warm-bat-decidegc = <450>; //Warming threshold

qcom,ibatmax-warm-ma = <360>; //Cooling current

qcom,ibatmax-cool-ma = <360>; //Warming current

xxx

}

Charging Switch

SC20 applies PMU internal charging and IC is pm8909, so customer needs to turn on pm8909 charger IC,

as follows:

&pm8909_chg {

status = "ok";

/* qcom,charging-disabled; */ //Comment out this line.

};

Thermistor Voltage and Temperature Table:

Thermistor voltage and temperature table is used to judge the accuracy of battery temperature that is

read.

Quectel

Confidential

LTE Module Series

SC20 Charging User Guide

SC20_Charging_User_Guide Confidential / Released 9 / 14

static const struct qpnp_vadc_map_pt adcmap_btm_threshold[] = {

{XXX, YYY}, //The former is the temperature value, and the latter is the voltage

}

The table is customized, it needs hardware engineers to get values from battery vendors and fill in.

High Temperature Shutdown

High temperature protection has been enabled on SC20, when the battery temperature is above 68

degrees, it will automatically shut down.

High temperature shutdown related files and codes are presented as follows:

1. android/frameworks/base/services/core/java/com/android/server/BatteryService.java: for executing

shutdown action.

private void shutdownIfOverTempLocked() {

//Shut down gracefully if temperature is too high (>68°C by default)

//Wait until the system has booted before attempting to display the shutdown dialog.

if (mBatteryProps.batteryTemperature > mShutdownBatteryTemperature) {

mHandler.post(new Runnable() {

@Override

public void run() {

if (ActivityManagerNative.isSystemReady()) {

Slog.e(TAG, "silent_reboot shutdownIfOverTempLocked");

Intent intent = new Intent(Intent.ACTION_REQUEST_SHUTDOWN);

intent.putExtra(Intent.EXTRA_KEY_CONFIRM, false);

intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

mContext.startActivityAsUser(intent, UserHandle.CURRENT);

}

});

}

2. android/frameworks/base/core/res/res/values/config.xml: set the temperature that triggers shutdown.

If module shuts down immediately after being turned on, customer should first make sure that the battery

has power, then check whether it is caused by high temperature or not.

Quectel

Confidential

Andere Handbücher für LTE Module Series

Dieses Handbuch passt für folgende Modelle

Inhaltsverzeichnis

Andere Quectel Steuereinheit Handbücher

Quectel

Quectel SC200L-EM Beilage

Quectel

Quectel EC21 Series Beilage

Quectel

Quectel EG91 Series Beilage

Quectel

Quectel EC200A Series Beilage

Quectel

Quectel RM510Q-GL Beilage

Quectel

Quectel BC660K-GL Bedienungsanleitung

Quectel

Quectel EC25 series Bedienungsanleitung

Quectel

Quectel BG772A-GL Beilage

Quectel

Quectel Smart LTE Module Series Beilage

Quectel

Quectel SC20-EL Bedienungsanleitung

Quectel

Quectel EM12-G Beilage

Quectel

Quectel BG95 Series Beilage

Quectel

Quectel SG865W Series Beilage

Quectel

Quectel SC200R Series Beilage

Quectel

Quectel M35 Montageanleitung

Quectel

Quectel EG91 Series Beilage

Quectel

Quectel BC660K-GL Bedienungsanleitung

Quectel

Quectel LTE Module Series Montageanleitung

Quectel

Quectel BC26 Bedienungsanleitung

Quectel

Quectel MC60-TE-A Bedienungsanleitung

Quectel

Quectel M12 Beilage

Quectel

Quectel UC200T-EM Beilage

Quectel

Quectel EC25 Mini PCIe Beilage

Quectel

Quectel Smart Wi-Fi Module Series Bedienungsanleitung

Beliebte Steuereinheit Handbücher anderer Marken

Festo

Festo Compact Performance CP-FB6-E Stücklistenhandbuch

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Bedienungsanleitung

JS Automation

JS Automation MPC3034A Bedienungsanleitung

JAUDT

JAUDT SW GII 6406 Series Kurzanleitung

Spektrum

Spektrum Air Module System Bedienungsanleitung

BOC Edwards

BOC Edwards Q Series Bedienungsanleitung

KHADAS

KHADAS BT Magic Bedienungsanleitung

Etherma

Etherma eNEXHO-IL Bedienungsanleitung

PMFoundations

PMFoundations Attenuverter Bedienungsanleitung

GEA

GEA VARIVENT Bedienungsanleitung

Walther Systemtechnik

Walther Systemtechnik VMS-05 Bedienungsanleitung

Altronix

Altronix LINQ8PD Montageanleitung

Eaton

Eaton Powerware Series Bedienungsanleitung

WAGO

WAGO 750-407/040-000 Bedienungsanleitung

Sony

Sony CCU-590 Bedienungsanleitung

Graco

Graco 25D614 Bedienungsanleitung

Task Force Tips

Task Force Tips YE-RF-900 Programmierhandbuch

Shini

Shini SPV-U Series Bedienungsanleitung