Quectel LTE Module Series Manual de usuario

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

Otros manuales para LTE Module Series

Este manual sirve para los siguientes modelos

Tabla de contenidos

Otros manuales de Unidad de control de Quectel

Quectel

Quectel LC76F Manual de usuario

Quectel

Quectel BC660K-GL Manual de usuario

Quectel

Quectel LPWA Series Suplemento

Quectel

Quectel RM510Q-GL Suplemento

Quectel

Quectel LTE-A Series Suplemento

Quectel

Quectel BG96-NA Suplemento

Quectel

Quectel EG06 Series Manual de usuario

Quectel

Quectel FCM561D-P Suplemento

Quectel

Quectel EC2 Series Instrucciones de instalación

Quectel

Quectel 5G Module Series Suplemento

Quectel

Quectel SC262R Series Suplemento

Quectel

Quectel WCDMA UG FILE Series Manual de instalación

Quectel

Quectel SC200R Series Suplemento

Quectel

Quectel Smart EVB G5 Manual de usuario

Quectel

Quectel RMU500-EK Manual de usuario

Quectel

Quectel L76 Manual de usuario

Quectel

Quectel SG368Z Series Suplemento

Quectel

Quectel BG95 Series Instrucciones de instalación y funcionamiento

Quectel

Quectel RG50-Q Series Manual de usuario

Quectel

Quectel SG865W Series Suplemento

Quectel

Quectel BG96 Manual de usuario

Quectel

Quectel WCDMA UG Series Manual de usuario

Quectel

Quectel MC60 Suplemento

Quectel

Quectel LTE OPEN EVB Manual de usuario

Manuales populares de Unidad de control de otras marcas

Festo

Festo Compact Performance CP-FB6-E Manual de lista de piezas

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manual de usuario

JS Automation

JS Automation MPC3034A Manual de usuario

JAUDT

JAUDT SW GII 6406 Series Guía rápida

Spektrum

Spektrum Air Module System Manual de usuario

BOC Edwards

BOC Edwards Q Series Manual de usuario

KHADAS

KHADAS BT Magic Manual de usuario

Etherma

Etherma eNEXHO-IL Manual de usuario

PMFoundations

PMFoundations Attenuverter Manual de usuario

GEA

GEA VARIVENT Manual de usuario

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manual de usuario

Altronix

Altronix LINQ8PD Instrucciones de montaje

Eaton

Eaton Powerware Series Manual de usuario

WAGO

WAGO 750-407/040-000 Manual de usuario

Sony

Sony CCU-590 Manual de usuario

Graco

Graco 25D614 Manual de usuario

Task Force Tips

Task Force Tips YE-RF-900 Manual de programación

Shini

Shini SPV-U Series Manual de usuario