Quectel LTE Module Series Manuale utente

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

Altri manuali per LTE Module Series

Questo manuale è adatto per i seguenti modelli

Indice

Altri manuali Quectel Unità di controllo

Quectel

Quectel UG96 Manuale utente

Quectel

Quectel L76 Manuale utente

Quectel

Quectel EC25 series Istruzioni per l'installazione

Quectel

Quectel Smart EVB G5 Manuale utente

Quectel

Quectel BC68-TE-B Manuale utente

Quectel

Quectel Smart EVB Manuale utente

Quectel

Quectel WCDMA UG FTP Series Manuale di installazione

Quectel

Quectel GSM Series Guida

Quectel

Quectel BG96 Manuale di installazione

Quectel

Quectel EG91 Series Supplemento

Quectel

Quectel GNSS Module Series Manuale utente

Quectel

Quectel FC80A Manuale utente

Quectel

Quectel BG96 Supplemento

Quectel

Quectel NB-IoT Module Series Manuale utente

Quectel

Quectel LCC Series Manuale utente

Quectel

Quectel SC20 Supplemento

Quectel

Quectel FC905A Manuale utente

Quectel

Quectel LTE-A Series Supplemento

Quectel

Quectel UG Series Istruzioni per l'installazione

Quectel

Quectel EC25 Mini PCIe Supplemento

Quectel

Quectel EG95-E Manuale utente

Quectel

Quectel EC25 series Guida

Quectel

Quectel LTE-A Series Supplemento

Quectel

Quectel LPWA Series Supplemento

Manuali Unità di controllo popolari di altre marche

Festo

Festo Compact Performance CP-FB6-E Manuale elenco delle parti

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manuale utente

JS Automation

JS Automation MPC3034A Manuale utente

JAUDT

JAUDT SW GII 6406 Series Guida rapida

Spektrum

Spektrum Air Module System Manuale utente

BOC Edwards

BOC Edwards Q Series Manuale utente

KHADAS

KHADAS BT Magic Manuale utente

Etherma

Etherma eNEXHO-IL Manuale utente

PMFoundations

PMFoundations Attenuverter Manuale utente

GEA

GEA VARIVENT Manuale utente

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manuale utente

Altronix

Altronix LINQ8PD Istruzioni per il montaggio

Eaton

Eaton Powerware Series Manuale utente

WAGO

WAGO 750-407/040-000 Manuale utente

Sony

Sony CCU-590 Manuale utente

Graco

Graco 25D614 Manuale utente

Task Force Tips

Task Force Tips YE-RF-900 Manuale di programmazione

Shini

Shini SPV-U Series Manuale utente