Yangtze worknote
1. repo init -u git://review.sonyericsson.net/platform/manifest -b volatile-jb-mr1-yangtze
2. https://wiki.sonyericsson.net/androiki/CN3-II/Bringup_Trail_FC34 如何编译
3. https://wiki.sonyericsson.net/androiki/PLD_CM/Yangtze 如何编译和flash
4. https://wiki.sonyericsson.net/androiki/MIB_Tokyo/Rhine/Hardware_Watchdog_debugging
小技巧：
MISCTA 2473控制kernel log输出： 01 输出，00 无输出
repo sync [目录路径] 比如： kenel,system/vold
repo sync kernel 则只是同步kernel目录下的代码
grep "ifelse" * -r 查找当前目录下（递归）所有文件中包含ifelse的内容
owner:[email protected] status:merged //查找谁提交并且已经merged的gerrit
printk("func = %pf",func)可打印函数名称出来
充电缩写语：(acronym)
FSM: Finite State Machine
CC: Coulcomb Counter
FCC: Full Charge Capacity
OCV: Open Circuit Voltage
PMIC: Power Management IC
PC: Percentage Charge
RC: Remaining Charge
SOC: State of Charge
RUC: Remaining Usable Charge
UUC: Unusable Charge
一、DTS 学习
1. kernel/arch/arm/boot/dts 目录下包含所有的dts.
a. board , msm8226.dtsi
b. pmic, msm-pm8226.dtsi
2. kernel/Androidkernel.mk; Android makefile to build kernel as a part of Android Build
3. kernel/arch/arm/configs 目录下保存对应的config定义， CONFIG_XXXXXX
4. 可参考 jb-mr1-rhine/kernel/arch/arm/boot/dts/msm8974-rhine_togari_row.dtsi
二、LCD Porting
1. http://review.sonyericsson.net/#/c/508903
三、Charger bringup
1. 和battery and hw guys 确定相关 硬件参数
2. http://review.sonyericsson.net/#/c/516297/
3. kernel 发送给battery_logging的uevent格式？
power_supply_uevent@kernel/drivers/power/power_supply_sysfs.c 该函数添加发送的信息到uevent
ret = add_uevent_var(env, "POWER_SUPPLY_NAME=%s", psy->name); //psy->name="battery"
for (j = 0; j < psy->num_properties; j++) {
attr = &power_supply_attrs[psy->properties[j]]; //得到对应的power supply attr,
attrname = kstruprdup(attr->attr.name, GFP_KERNEL);//会把属性名字转成大写，比如“status”->"STATUS"
ret = add_uevent_var(env, "POWER_SUPPLY_%s=%s", attrname, prop_buf); //增加该属性的信息到uevent buffer中
}
qpnp_charger_probe@kernel/drivers/power/qpnp-charger.c中会定义"battery"的properties = msm_batt_power_props
static enum power_supply_property msm_batt_power_props[] = { //对应power_supply_attrs[]@kernel/drivers/power/power_supply_sysfs.c
POWER_SUPPLY_PROP_CHARGING_ENABLED, //表示这些属性是被battery psy所需要的属性,具体如何得到可查看
POWER_SUPPLY_PROP_STATUS, //qpnp_batt_power_get_property 函数
POWER_SUPPLY_PROP_CHARGE_TYPE, //这些属性会添加到/sys/class/power_supply/battery
POWER_SUPPLY_PROP_HEALTH,
POWER_SUPPLY_PROP_PRESENT,
POWER_SUPPLY_PROP_TECHNOLOGY,
POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN,
POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN,
POWER_SUPPLY_PROP_VOLTAGE_NOW,
POWER_SUPPLY_PROP_CAPACITY,
POWER_SUPPLY_PROP_CURRENT_NOW,
POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN,
POWER_SUPPLY_PROP_TEMP,
POWER_SUPPLY_PROP_SYSTEM_TEMP_LEVEL,
};
static struct device_attribute power_supply_attrs[] = {
/* Properties of type `int' */
POWER_SUPPLY_ATTR(status), //表示attr.name = "status"
POWER_SUPPLY_ATTR(charge_type),
...
}
4. parse_uevent@vendor/semc/hardware/power/charge-log/battery_logging/battery_logging.c会分析从kernel传上来的power uevent格式
发送该uevent的path '\0'
POWER_SUPPLY_NAME=battery '\0'
POWER_SUPPLY_CHARGING_ENABLE=%d '\0'
POWER_SUPPLY_CHARGING_STATUS=%d '\0'
...
5. 顺便分析下UEvent如何传递给user space?
a. @kernel/drivers/power/qpnp-charger.c中只要有任何关于charger的变化，比如charger的各种irq handler
b. @kernel/drivers/power/qpnp-bms.c中calculate_soc_from_voltage和calculate_state_of_charge
c. @kernel/arch/arm/boot/dts/msm-pm8226.dtsi中有pm8226_bms的device定义，msm8226-cn3ii.dtsi中有pm8226_bms的定义补充
其中没有 qcom,use-voltage-soc 的定义所以chip->use_voltage_soc=false, 也就是只用calculate_state_of_charge计算soc
顺便chip->use_external_rsense=true,表示用外部的rsense.
d. @kernel/driver/power/power_supply_core.c中的power_supply_changed会被以上内容调用
schedule_work(&psy->changed_work);
e. power_supply_changed_work@kernel/driver/power/power_supply_core.c
kobject_uevent(&psy->dev->kobj, KOBJ_CHANGE); //action=KOBJ_CHANGE
f. kobject_uevent_env@kernel/lib/kobject_uevent.c
static const char *kobject_actions[] = {
[KOBJ_ADD] = "add",
[KOBJ_REMOVE] = "remove",
[KOBJ_CHANGE] = "change",
[KOBJ_MOVE] = "move",
[KOBJ_ONLINE] = "online",
[KOBJ_OFFLINE] = "offline",
};
以下为添加到uevent buffer中发送的内容
/* default keys */
retval = add_uevent_var(env, "ACTION=%s", action_string);//action_string="change"
retval = add_uevent_var(env, "DEVPATH=%s", devpath);//devpath = kobject_get_path(kobj, GFP_KERNEL);
retval = add_uevent_var(env, "SUBSYSTEM=%s", subsystem);//也就是uevent 的name
retval = uevent_ops->uevent(kset, kobj, env); //会调用到power_supply_uevent@kernel/drivers/power/power_supply_sysfs.c
//也就是会添加具体的power battery信息到uevent buffer中了
retval = add_uevent_var(env, "SEQNUM=%llu", (unsigned long long)++uevent_seqnum); //增加uevent发送的计数，
//KERNEL_ATTR_RO(uevent_seqnum); 用cat sys/kernel/uevent_seqnum 可以查看
CONFIG_NET=y被定义，以下代码是发送uevent到userspace 的关键代码
#if defined(CONFIG_NET)
/* send netlink message */
list_for_each_entry(ue_sk, &uevent_sock_list, list) { //uevent_net_init会初始化一个uevent_sock，也只有一个
if (!netlink_has_listeners(uevent_sock, 1))
continue;
/* allocate message with the maximum possible size */
len = strlen(action_string) + strlen(devpath) + 2;
skb = alloc_skb(len + env->buflen, GFP_KERNEL);
if (skb) {
retval = netlink_broadcast_filtered(uevent_sock, skb,
0, 1, GFP_KERNEL,
kobj_bcast_filter,
kobj);
} else
retval = -ENOMEM;
}
#endif
6. Battery充满的识别
1). @kernel/arch/arm/boot/dts/msm-pm8226.dtsi和msm8226-cn3ii.dtsi
qcom,chg-chgr@1000 {
status = "disabled";
reg = <0x1000 0x100>;
interrupts = <0x0 0x10 0x0>,
<0x0 0x10 0x1>,
<0x0 0x10 0x2>,
<0x0 0x10 0x3>,
<0x0 0x10 0x4>,
<0x0 0x10 0x5>,
<0x0 0x10 0x6>,
<0x0 0x10 0x7>; //具体的含义？
interrupt-names = "vbat-det-lo",
"vbat-det-hi",
"chgwdog",
"state-change",
"trkl-chg-on",
"fast-chg-on",
"chg-failed",
"chg-done";
};
2). qpnp_chg_hwinit@kernel/drivers/power
chip->chg_done_irq = spmi_get_irq_byname(chip->spmi,spmi_resource, "chg-done");
如何触发"chg-done"这个interrupt?
3).获取当前充电状态
rc = qpnp_chg_read(chip, &chgr_sts,INT_RT_STS(chip->chgr_base), 1);
如果chgr_sts&CHG_DONE_IRQ == 1则表示充电完成
4).http://review.sonyericsson.net/#/c/480849, workaround for fake charge done
6. 如何查看当前的charger信息？
/sys/devices/qpnp-charger-eab16c00
7. 手机/sys/class/power_supply/battery和bms和usb的来源
1)qpnp_charger_proble@kernel/drivers/power/qpnp-charger.c
if (chip->bat_if_base){
chip->batt_psy.name = "battery";
chip->batt_psy.type = POWER_SUPPLY_TYPE_BATTERY;
chip->batt_psy.properties = msm_batt_power_props;//所选择的属性
rc = power_supply_register(chip->dev, &chip->batt_psy);//注册到/sys/class/power_supply/battery
}
2)qpnp_bms_probe@kernel/drivers/power/qpnp-bms.c
chip->bms_psy.name = "bms";
chip->bms_psy.type = POWER_SUPPLY_TYPE_BMS;
chip->bms_psy.properties = msm_bms_power_props;
rc = power_supply_register(chip->dev, &chip->bms_psy);//注册到/sys/class/power_supply/bms
3)msm_otg_proble@kernel/drivers/usb/otg, 注意CONFIG_USB_MSM_OTG的定义在kernel/drivers/usb/gadget/Kconfig: config USB_CI13XXX_MSM-->select USB_MSM_OTG
motg->usb_psy.name = "usb";
motg->usb_psy.type = POWER_SUPPLY_TYPE_USB;
motg->usb_psy.supplied_to = otg_pm_power_supplied_to;
msm_otg_register_power_supply(pdev, motg))->power_supply_register(&pdev->dev, &motg->usb_psy);
4)充电器的识别过程
msm_chg_detect_work@kernel/drivers/usb/otg/msm_otg.c 主要完成充电器类别的识别过程
->msm_otg_notify_chg_type@msm_otg.c
->power_supply_set_supply_type(psy, charger_type)@msm_otg.c;//psy=motg->usb_psy
->psy->set_property(psy, POWER_SUPPLY_PROP_TYPE,&ret); //@kernel/drivers/power/power_supply_core.c, 最后会call
->otg_power_set_property_usb@msm_otg.c 但是该函数中没有POWER_SUPPLY_PROP_TYPE属性的设置？？
->queue_work(system_nrt_wq, &motg->sm_work);->msm_otg_sm_work[otg->phy->state=OTG_STATE_B_IDLE]
-->msm_otg_notify_charger->msm_otg_notify_power_supply->power_supply_set_online//设置是否online
四、Audio Jack Porting
0. HW Guys: Wang, Junchao(9601), Liu,Xun
1. kernel/sound/soc/msm/msm8226.c;
kernel/sound/soc/codecs/wcd9306.c,Wcd9xxx-mbhc.c
tapan_slimbus_irq
2. adb shell 'echo -n "file wcd9xxx-mbhc.c +p" > /sys/kernel/debug/dynamic_debug/control'
3. [email protected]
0x6c-->0x68 //参考80-NC836-2 WCD9306 AUDIO CODEC SOFTWARE INTERFACE.pdf 中0x14B MBHC_INSERT_DET_STATUS寄存器的说明，PLUG_TYPE 0:NC 1:NO （注意原来的文档有错）
Audio Jack不插入耳机时MBHC_HSDET是低，插入耳机时MBHC_HSDET是高，所以是Normal Close(NC)类型的Audio Jack
4. @kernel/sound/soc/msm/msm8226.c;
S(v_no_mic, 30);
S(v_hs_max, 1650);
5. @kernel/sound/soc/codecs/Wcd9xxx-mbhc.c
wcd9xxx_codec_get_plug_type->
wcd9xxx_find_plug_type
6. Audio jack检测耳机的流程
在函数wcd9xxx_mbhc_decide_swch_plug中如果检测到是headset则不重复多次检测，如果是headphone则需要
wcd9xxx_schedule_hs_detect_plug(mbhc,&mbhc->correct_plug_swch);启动重复检测以确认正确
插入headphone耳机
<7>[ 105.233608] wcd9xxx_mech_plug_detect_irq: enter
<7>[ 105.233625] wcd9xxx_swch_irq_handler: enter
<7>[ 105.238692] wcd9xxx_swch_irq_handler: Acquiring BCL
<7>[ 105.238706] wcd9xxx_swch_irq_handler: Acquiring BCL done
<7>[ 105.238864] wcd9xxx_swch_irq_handler: Current plug type 0, insert 1
<7>[ 105.238876] wcd9xxx_cancel_hs_detect_plug: Canceling correct_plug_swch
<7>[ 105.238885] wcd9xxx_cancel_hs_detect_plug: Release BCL
<7>[ 105.238897] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL
<7>[ 105.238907] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL done
<7>[ 105.239014] wcd9xxx_mbhc_detect_plug_type: enter
<7>[ 105.497933] wcd9xxx_mbhc_decide_swch_plug: enter
<7>[ 105.498378] wcd9xxx_codec_get_plug_type: enter
<7>[ 105.501350] wcd9xxx_mbhc_setup_hs_polling: enter
...
<7>[ 105.590299] wcd9xxx_find_plug_type: DCE #0, fc06, V 0008(0008), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.590317] wcd9xxx_find_plug_type: DCE #1, fc06, V 0008(0008), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.590332] wcd9xxx_find_plug_type: DCE #2, fc06, V 0008(0008), GND 1, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.590346] wcd9xxx_find_plug_type: DCE #3, fc06, V 0008(0008), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.590359] wcd9xxx_find_plug_type: Plug type 2 detected
<7>[ 105.590368] wcd9xxx_codec_get_plug_type: leave
<7>[ 105.590655] wcd9xxx_report_plug: enter insertion 1 hph_status 0
<7>[ 105.590666] wcd9xxx_report_plug: Reporting insertion 1(1)
继续进行检测wcd9xxx_correct_swch_plug，用以确认检测正确，如果检测到是PLUG_TYPE_HEADPHONE则需要在 HS_DETECT_PLUG_TIME_MS＝5000毫秒内多次检测
<7>[ 105.717321] wcd9xxx_correct_swch_plug: Acquiring BCL
<7>[ 105.717335] wcd9xxx_correct_swch_plug: Acquiring BCL done
<7>[ 105.717344] wcd9xxx_codec_get_plug_type: enter
<7>[ 105.720967] wcd9xxx_mbhc_setup_hs_polling: enter
<7>[ 105.804823] wcd9xxx_find_plug_type: DCE #0, fc08, V 0010(0010), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.804841] wcd9xxx_find_plug_type: DCE #1, fc08, V 0010(0010), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.804856] wcd9xxx_find_plug_type: DCE #2, fc08, V 0010(0010), GND 1, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.804871] wcd9xxx_find_plug_type: DCE #3, fc08, V 0010(0010), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.804884] wcd9xxx_find_plug_type: Plug type 2 detected
<7>[ 105.804892] wcd9xxx_codec_get_plug_type: leave
<7>[ 105.804901] wcd9xxx_correct_swch_plug: Release BCL
<7>[ 105.804912] wcd9xxx_correct_swch_plug: attempt(1) current_plug(2) new_plug(2)
<7>[ 105.804922] Good headphone detected, continue polling
。。。
拔出耳机
<7>[ 1010.417287] wcd9xxx_mech_plug_detect_irq: enter
<7>[ 1010.417304] wcd9xxx_swch_irq_handler: enter
<7>[ 1010.422617] wcd9xxx_swch_irq_handler: Acquiring BCL
<7>[ 1010.422635] wcd9xxx_swch_irq_handler: Acquiring BCL done
<7>[ 1010.422809] wcd9xxx_swch_irq_handler: Current plug type 2, insert 0
<7>[ 1010.422820] wcd9xxx_cancel_hs_detect_plug: Canceling correct_plug_swch
<7>[ 1010.422830] wcd9xxx_cancel_hs_detect_plug: Release BCL
<7>[ 1010.422842] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL
<7>[ 1010.422851] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL done
<7>[ 1010.422863] wcd9xxx_report_plug: enter insertion 0 hph_status 1
<7>[ 1010.422876] wcd9xxx_report_plug: Reporting removal 1(0)
<7>[ 1010.422911] wcd9xxx_set_and_turnoff_hph_padac PA is off
<7>[ 1010.445247] __hphocp_off_report: clear ocp status 80
<7>[ 1010.445261] __hphocp_off_report: clear ocp status 40
<7>[ 1010.445272] wcd9xxx_insert_detect_setup: Setting up insert detection
<7>[ 1010.445468] wcd9xxx_report_plug: leave hph_status 0
<7>[ 1010.446056] wcd9xxx_swch_irq_handler: Release BCL
<7>[ 1010.446067] wcd9xxx_swch_irq_handler: leave
<7>[ 1010.446079] wcd9xxx_mech_plug_detect_irq: leave 1
<7>[ 1010.446408] wcd9xxx_hs_insert_irq: enter
<7>[ 1010.446418] wcd9xxx_hs_insert_irq: Acquiring BCL
<7>[ 1010.446427] wcd9xxx_hs_insert_irq: Acquiring BCL done
<7>[ 1010.446880] wcd9xxx_hs_insert_irq_swch: Removal
<7>[ 1010.447010] wcd9xxx_hs_insert_irq: Release BCL
插入Headset
<7>[ 1084.338102] wcd9xxx_mech_plug_detect_irq: enter
<7>[ 1084.338119] wcd9xxx_swch_irq_handler: enter
<7>[ 1084.343428] wcd9xxx_swch_irq_handler: Acquiring BCL
<7>[ 1084.343447] wcd9xxx_swch_irq_handler: Acquiring BCL done
<7>[ 1084.343619] wcd9xxx_swch_irq_handler: Current plug type 0, insert 1
<7>[ 1084.343631] wcd9xxx_cancel_hs_detect_plug: Canceling correct_plug_swch
<7>[ 1084.343641] wcd9xxx_cancel_hs_detect_plug: Release BCL
<7>[ 1084.343653] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL
<7>[ 1084.343662] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL done
<7>[ 1084.343676] wcd9xxx_mbhc_detect_plug_type: enter
<7>[ 1084.598139] wcd9xxx_mbhc_decide_swch_plug: enter
<7>[ 1084.598340] wcd9xxx_codec_get_plug_type: enter
<7>[ 1084.601291] wcd9xxx_mbhc_setup_hs_polling: enter
<7>[ 1084.676366] wcd9xxx_find_plug_type: DCE #0, 026d, V 1306(1306), GND 0, VDDIO 0, HPHL 1 TYPE 1
<7>[ 1084.676384] wcd9xxx_find_plug_type: DCE #1, 02b7, V 1365(1365), GND 0, VDDIO 0, HPHL 1 TYPE 1
<7>[ 1084.676399] wcd9xxx_find_plug_type: DCE #2, 02bb, V 1368(1368), GND 1, VDDIO 0, HPHL 1 TYPE 1
<7>[ 1084.676414] wcd9xxx_find_plug_type: DCE #3, 02bb, V 1368(1368), GND 0, VDDIO 0, HPHL 1 TYPE 1
<7>[ 1084.676427] wcd9xxx_find_plug_type: Plug type 1 detected
<7>[ 1084.676436] wcd9xxx_codec_get_plug_type: leave
<7>[ 1084.676720] wcd9xxx_mbhc_decide_swch_plug: Valid plug found, determine plug type 1
<7>[ 1084.676733] wcd9xxx_find_plug_and_report: enter current_plug(0) new_plug(1)
<7>[ 1084.676745] wcd9xxx_report_plug: enter insertion 1 hph_status 0
<7>[ 1084.676755] wcd9xxx_report_plug: Reporting insertion 3(3)
<7>[ 1084.676802] wcd9xxx_insert_detect_setup: Setting up removal detection
<7>[ 1084.676955] wcd9xxx_report_plug: leave hph_status 3
<7>[ 1084.777467] wcd9xxx_start_hs_polling: enter
<7>[ 1084.779191] wcd9xxx_start_hs_polling: leave
<7>[ 1084.779202] wcd9xxx_find_plug_and_report: leave
<7>[ 1084.779212] wcd9xxx_mbhc_decide_swch_plug: leave
<7>[ 1084.779221] wcd9xxx_mbhc_detect_plug_type: leave
<7>[ 1084.779229] wcd9xxx_swch_irq_handler: Release BCL
<7>[ 1084.779238] wcd9xxx_swch_irq_handler: leave
<7>[ 1084.779250] wcd9xxx_mech_plug_detect_irq: leave 1
五、如何flash开发板
1. lunch
2. fastboot flash boot boot.img, flash kernel的image
fastboot flash system system.img, flash system的image
六、SIM card detection
1. kernel/arch/arm/boot/dts/msm8226-cn3ii.dts 中有gpio_keys节点
gpio_keys {
compatible = "gpio-keys"
input-name = "gpio-keys" //表示输出event的名字
...
}
kernel/drivers/input/keyboard/gpio_keys.c会解析 gpio-keys 的dts
增加sim card detection 的gpio key
sim1 {
ompatible = "gpio-keys";
input-name = "sim1-detection";
sim1_det {
label = "sim1-detection";
gpios = <&msmgpio 60 0x0>; //msmgpio表示使用的是8226的gpio, 60表示GPIO60
linux,input-type = <5>; //define EV_SW 0x05
linux,code = <7>; //#define SW_JACK_PHYSICAL_INSERT 0x07 /* set = mechanical switch set */
gpio-key,wakeup;
debounce-interval = <10>;
};
};
2. http://review.sonyericsson.net/#/c/518583
3. https://wiki.sonyericsson.net/androiki/FP8615_Support_for_SIM_detection_for_Zeus_Docomo_Definition_Report
七、Vibrator
1. 检查是否工作 #echo 1000 > /sys/class/timed_output/vibrator/enable
八、GPIO设置的确认
1. msmgpio@kernel/arch/arm/boot/dts/msm8226-cn3ii.dtsi
msmgpio: gpio@fd510000 {
compatible = "qcom,msm-gpio";
interrupt-controller;
#interrupt-cells = <2>;
reg = <0xfd510000 0x4000>;
gpio-controller;
#gpio-cells = <2>;
ngpio = <117>;
interrupts = <0 208 0>;
qcom,direct-connect-irqs = <8>;
};
2. pm8226_gpios@kernel/arch/arm/boot/dts/msm8226-cn3ii.dts
&pm8226_gpios {
gpio@c000 { /* GPIO 1 */
/* XO_PMIC_CDC_MCLK enable for tapan codec */
qcom,mode = <1>; /* Digital output */
qcom,output-type = <0>; /* CMOS logic */
qcom,pull = <5>; /* QPNP_PIN_PULL_NO*/
qcom,vin-sel = <2>; /* QPNP_PIN_VIN2 */
qcom,out-strength = <3>;/* QPNP_PIN_OUT_STRENGTH_HIGH */
qcom,src-sel = <2>; /* QPNP_PIN_SEL_FUNC_1 */
qcom,master-en = <1>; /* Enable GPIO */
};
gpio@c100 { /* GPIO 2 */
qcom,mode = <1>;
qcom,output-type = <0>;
qcom,pull = <5>;
qcom,vin-sel = <2>;
qcom,out-strength = <3>;
qcom,src-sel = <2>;
qcom,master-en = <1>;
};
...
}
3. http://review.sonyericsson.net/#/c/518583/
4. GPIO 如何配置成I2C
1)@kernel/arch/arm/boot/dts/msm8226-cn3ii.dtsi, 以下设置i2c的参数
i2c@f9926000 { /* BLSP-1 QUP-4 */
cell-index = <0>;
compatible = "qcom,i2c-qup";
reg = <0xf9926000 0x1000>;
#address-cells = <1>;
#size-cells = <0>;
reg-names = "qup_phys_addr";
interrupts = <0 98 0>;
interrupt-names = "qup_err_intr";
qcom,i2c-bus-freq = <400000>;
qcom,i2c-src-freq = <400000>;
ti_lm3630_bl@36{
compatible = "ti,lm3630_bl";
reg = <0x36>;
gpio_hw_en = <&msmgpio 27 0>;
pwm_feedback = <0x08 0x10>;
ctl = <0x00 0x00>;
fsc = <20200 20200>;
iname = "lm3630-lcd-bl-1","lm3630-lcd-bl-2";
connected = <0x01 0x01>;
bank = <0x00 0x01>;
filter_str = <0x03>;
ovp_boost = <0x24>;
led_fault = <0x00>;
intf_name = "lm3630-lcd-bl-1","lm3630-lcd-bl-2";
brightness = <255 255>;
};
};
2)kernel/arch/arm/mach-msm/board-sony_cn3ii-gpiomux.c,以下配置GPIO14和15为I2C的功能，即GPIOMUX_FUNC_3
static struct msm_gpiomux_config msm_blsp_configs[] __initdata = {
{
.gpio = 14, /* BLSP1 QUP4 I2C_SDA */
.settings = {
[GPIOMUX_SUSPENDED] = &gpio_i2c_config,
},
},
{
.gpio = 15, /* BLSP1 QUP4 I2C_SCL */
.settings = {
[GPIOMUX_SUSPENDED] = &gpio_i2c_config,
},
},
}
static struct gpiomux_setting gpio_i2c_config = {
.func = GPIOMUX_FUNC_3,
.drv = GPIOMUX_DRV_2MA,
.pull = GPIOMUX_PULL_NONE,
};
八、GPIO Check
1. AP GPIO:
kernel/arch/arm/mach-msm/board-sony_cn3ii-gpiomux.c //这其中只是定义了某个GPIO的配置，如果程序需要使用，还要gpio_request
/
PMIC GPIO:
kernel/arch/arm/boot/dts/msm-pm8226.dtsi中有pm8226_gpios的定义
kernel/arch/arm/boot/dts/msm8226-cn3ii.dts中的&pm8226_gpios,
kernel/drivers/gpio/gpnp-pin.c 中会解析pm8226_gpios dts.
2. HW Guy: Liu, Helson for GPIO setting.
3. GPIO设置文档http://metadoc.sonyericsson.net/login_link.asp?doc=1/10262-17/FCP1191405/6&rev=latest
４. 还可以在 cat sys/kernel/debug/gpio 确认当前GPIO的状态
九、battery logging port
1. device/somc/yangtze/BoardConfig.mk
# battery logging //打开编译libbatterylogging的开关
ifneq ($(TARGET_BUILD_VARIANT), user)
SONY_CFG_LIBBATTERYLOGGING := true
endif
device/somc/yangtze/platform.mk
->PRODUCT_PACKAGES += battery_logging //添加battery_logging编译目录
device/somc/yangtze/files/init.sony-platform.rc
ONLY_IN_DEBUG( //设置是否 实时开始和停止运行battery_logging, 其定义在/build/core/definitions.mk (－DONLY_IN_DEBUG)
//实际上表示只要编译的版本是eng和userdebug版本都需要执行
on property:battery_log=1 //init.c分析时会把property:battery_log 当作一个action 的条件加入trigger链表，当通过setprop改变
//battery_log的属性时会触发该action: start/stop battery_logging
//具体的代码分析：property_set@system/core/init/property_service.c
start battery_logging
on property:battery_log=0 //setprop battery_log 0 可以停止battery_logging service,
stop battery_logging)
ONLY_IN_VARIANT(eng, //其定义在/build/core/definitions.mk (－DONLY_IN_VARIANT)
on property:dev.bootcomplete=1
start battery_logging)
ONLY_IN_VARIANT(userdebug,
on property:dev.bootcomplete=1
start battery_logging)
ONLY_IN_DEBUG(
service battery_logging /system/bin/battery_logging
disabled) //disable表示需要手动启动
2. vendor/semc/hardware/device/yangtze/libbatterylogging
->out/target/product/cn3ii/obj/STATIC_LIBRARIES/libbatterylogging_intermediates/libbatterylogging.a
3. vendor/semc/hardware/power/charge-log/battery_logging
->out/target/product/cn3ii/system/bin/battery_logging
4. #battery_logging -p //输出所有的需要输出信息的名称和路径
#battery_logging -d //输出运行时的log
十、device tree source(DTS)
0. http://devicetree.org/Main_Page
1. *.dts/dtsi 文件一般位于 kernel/arch/arm/boot/dts，比如msm8226-cn3ii.dts msm8226-cn3ii.dtsi
２. 如何决定用那个*.dts文件？
@kernel/arch/arm/mach-msm/Makefile.boot
# MSM8226
zreladdr-$(CONFIG_ARCH_MSM8226) := 0x00008000 //是啥地址？
dtb-$(CONFIG_MACH_SONY_CN3II) += msm8226-cn3ii.dtb
@kernel/arch/arm/configs/cn3ii_defconfig
CONFIG_ARCH_MSM8226=y
CONFIG_MACH_SONY_CN3II=y
3. 编译dts为dtb的工具为DTC,位于kernel/scripts/dtc
hostprogs-y := dtc //@Makefile中，该行表示用hostprogs编译生成dtc
最后生成的dtc可执行文件位于out/target/product/cn3ii/obj/KERNEL_OBJ/scripts/dtc/dtc
4.用dtc编译*.dts生成的*.dtb文件位于
out/target/product/cn3ii/obj/KERNEL_OBJ/arch/arm/boot/msm8226-cn3ii.dtb
存放在手机什么地方？
bootloader如何读取？如何传递给kernel?
head-common.S@kernel\arch\arm\kernel中有
.long __atags_pointer @ r6 //表示保存dtb的地址通过r6传递给kernel
5. kernel中解析DTS
setup_machine_fdt@kernel/arch/arm/kernel/devtree.c
struct boot_param_header *devtree = phys_to_virt(dt_phys); //注意boot_param_header结构
setup_machine_fdt将分析dtb最后所有devices生成树，如何和以前的版本结果就一样了
6. kernel中各个device和driver谁先加载？
十一、charge only porting
1. device/somc/common/sony-generic.mk 添加
-include vendor/semc/hardware/device/device.mk
2. device/somc/yangtze/files/init.sony-platform.rc 中添加
on early-boot
exec /system/bin/chargemon
//write /sys/class/power_supply/battery/enable_stop_charging_at_low_battery 1
device/somc/yangtze/BoardConfig.mk 增加
# Device sysfs path definitions
TARGET_BACKLIGHT_DEVICE_PATH := /sys/class/leds/wled:backlight/brightness
TARGET_LED_R_DEVICE_PATH := /sys/class/leds/led:rgb_red/brightness
TARGET_LED_G_DEVICE_PATH := /sys/class/leds/led:rgb_green/brightness
TARGET_LED_B_DEVICE_PATH := /sys/class/leds/led:rgb_blue/brightness
TARGET_DISPLAY_DEVICE_PATH := /sys/devices/mdss_dsi_panel
3. vendor/semc/hardware/device/目录下添加device.mk 和 cn3ii/cn3ii.mk, 添加以下关键内容
@device.mk
DEVICE_CONFIG=vendor/semc/hardware/device
# Call product specific makefiles.
-include $(DEVICE_CONFIG)/$(TARGET_PRODUCT)/$(TARGET_PRODUCT).mk
# Call platform specific makefiles.
-include $(DEVICE_CONFIG)/yangtze/platform.mk
@cn3ii.mk
SONY_CFG_CHARGEMON := true
PRODUCT_PACKAGES += chargemon
vendor/semc/hardware/device/yangtze$ 目录下添加chargemon_common.mk和platform.mk
@platform.mk
PLATFORM_DEVICE_CONFIG=vendor/semc/hardware/device/yangtze
# chargemon
include $(PLATFORM_DEVICE_CONFIG)/chargemon_common.mk
6. 注意：
*.rc 文件放在ramdisk中，而一般打包在boot.img或kernel.sin中
修改完*.mk文件后，需要重新lunch才会生效
7. 如何debug
#define DEBUG_LOG //在log.h中定义，打开log输出到手机 data/cm.log
LOGM(2); //在main代码中打开log输出mode,
十二、电池充电的几个关键过程
Trigle charge：
0. 当电池电压很低时，如何charge?
1. Vbat>3.42V,直接进入sys boot; Vbat<3.42时进入SBL的充电逻辑，Vbat<2.9v进入SBL的trigle charge(200mA充电)，当超过2.9v时，进入SBL的fast charge模式(500mA充电)，一直充直到Vbat>3.7V后，boot sys.
进入trigle charge mode,然后当电池电压充到3.7V(system weak threshod, Vweak)则退出trigle charge mode,启动kernel
2. Auto trigle charge(ATC)的触发条件： 电池电压< Vweak系统需要启动的最低电压，然后 充电电流被限制在100mA；手机不能用100mA的电流启动。
3. Two-step ATC 目前没有用，当电池电压特别低时分两步充电
a. Vbat < Vtrkl, Buck off, Bat FET closed, 充电电流50mA-200mA,小电流充电, Vtrkl一般设置区间为2.05V-2.8V
b. Vweak > Vbat > Vtrkl, Buck on, Bat FET closed,充电电流300mA-500mA, Vweak一般设置区间为2.1V-3.6V
4. 用FLCB 充电，目前CN3-ii用该方案
Buck on, Bat FET open, 用VCHG直接给电池充电，不经过Bat FET.一直用ITRKL电流给电池充电，该Itrkl电流一般多大？
当Vbat > Vweak后，系统就启动了
Fast charging
1. CC , Vweak < Vbat < Vbat_max, 用最大电流IBAT_MAX 给电池充电，IBAT_MAX的一般取值区间300mA-3000mA
2. CV, Vbat > Vbate_max, 逐渐降低充电电流Ibat,直到给电池的充电电压VPH_PWR==VDD_MAX,VDD_MAX一般设置区间3.4V-4.5V
Charging termination［依据的是充电电流大小］
1. 结束条件：Ibat(充电电流) < Iterm (with deglitching),Iterm一般设置区间35mA-276mA
2. 结果：Bat FET Open, Buck on 这样仍然可以给系统供电。如果系统需要的电流>Buck能提供的，那么Battery如何供电给系统？Bat FET Open也能反向把电流从电池输送给系统吗？
Automatic Recharge［依据的是电池电压大小］
1. 开始条件：Vbat < Vbat_det, 一般Vbat_det设置区间是3.3V-4.7V
2. 结果，又进入Fast charging阶段
OVP(过压保护)
1. 从外部USB 进入的电压保护范围[5v,28v]，可以设置该指？如果大于这最大进入电压，则第一级的保护电路生效。
2. 进入第二级保护电路，如果通过1进入的电压，大于预先SSBI-programmable设定的门限（该门限设置区间[5.5v,7v]）,如果电压大于该门限，则OVP FET会OPEN,反之。
十三、如何读写充电寄存器
1. 读寄存器
echo 0xccc > /sys/kernel/debug/spmi/spmi-0/address
echo 0xccc > /sys/kernel/debug/spmi/spmi-0/count
cat /sys/kernel/debug/spmi/spmi-0/data
写寄存器
echo 0xccc > /sys/kernel/debug/spmi/spmi-0/address
echo 0xccc > /sys/kernel/debug/spmi/spmi-0/data
2. 如何控制使用内部或外部电阻rsense.
0x3848 IADC2_BMS_ADC_CH_SEL_CTL
0x0: INTRSNS
0x1: EXTRSNS
@kernel/arch/arm/boot/dts/msm8226-cn3ii.dtsi中
&pm8226_bms {
qcom,use-external-rsense = <1>;
}
qcom,pm8226@0 {
iadc@3600 {
qcom,rsense = <10000000>;
};
};
3. 另外Huashan PM8921的路径为： sys/kernel/debug/pm8921-dbg
十四、增加识别wall charger
http://review.sonyericsson.net/#/c/534625/
十五、如何disable/enable充电
1. [User]SysFS: /sys/class/power_supply/battery/charging_enabled;
在charge only程序中，会通过miscTA 2312的值，来判断是否diable/enable充电(1:disable;非1:enable)
disableCharging@vendor/semc/hardware/power/chargemon/src/main.c
hw_disableCharging@vendor/semc/hardware/power/chargemon/src/main.c
->hw_writeSysfs(DISABLE_CHARGING_PATH, DISABLE_CHARGING); //DISABLE_CHARGING_PATH=/sys/class/power_supply/battery/charging_enabled
[Kernel]的对应处理 qpnp_batt_power_set_property@kernel/drivers/power/qpnp-charger.c
chip->charging_disabled = !(val->intval);
qpnp_chg_charge_en(chip, !chip->charging_disabled); //操作0x1049的bit7,主要控制FSM是否工作
qpnp_chg_force_run_on_batt(chip, chip->charging_disabled);//0x1049的bit7,主要控制所有与电池相关的功能(trikle charger, buck reg, batfet)是否工作。
2. Debugmenu中如何控制充电
@vendor/semc/packages/apps/debugmenu/src/com/sonyericsson/debugmenu/charging.java中会操作MiscTA 2312, 写入1 disable或0 enable;
然后下次启动运行charge only的时候会根据该Misc TA的值，enable/disbale充电。
十六、Charge only中的重要控制
1. charge only 是否进入的控制。
miscTA 2311, 0: 可以进入charge only; 2: 这次不让进入，但下次让进入; 其他(1):不让进入charge only.
2. 在charge only程序中是否充电
miscTA 2312的值，来判断是否diable/enable充电(1:disable;非1:enable)
/sys/class/power_supply/battery/charging_enabled;
3. Android USB device的控制
sys/class/android_usb/android0/enable 控制是否enable ADB功能
sys/class/android_usb/android0/functions, 设置USB支持的功能,在属性sys.usb.config，两者一致
sys/class/android_usb/android0/idProduct or idVendor, 重置USB的ID，但必须先disable USB
@vendor/semc/hardware/device/yangtze/chargemon_common.mk中有如下定义
USB_VENDOR_ID := 0fce
USB_PRODUCT_ID := e000
USB_ACCESSORY_VID := 18d1
USB_ACCESSORY_PID := 2d00
MASS_STORAGE := mass_storage
ACCESSORY := accessory
USB_ENABLE_PATH := /sys/class/android_usb/android0/enable
USB_SETFUNC_PATH := /sys/class/android_usb/android0/functions
USB_PRODUCT_ID_PATH := /sys/class/android_usb/android0/idProduct
USB_VENDOR_ID_PATH := /sys/class/android_usb/android0/idVendor
@device/somc/cn3ii/System.prop,中有 ro.usb.pid_suffix=1A9 重新设置USB PID
$在Ubantu上lsusb可以所有的usb device,其中就包括
Bus 001 Device 111: ID 0fce:51a9 Sony Ericsson Mobile Communications AB ，
idProduct,idVendor,function是在那里设定的？
@device/somc/common/files/init.sony.usb.rc
on property:sys.usb.config=mtp,adb //任何sys.usb.config的改变，就会触发后面的动作
exec /init.usbmode.sh
start adbd
setprop sys.usb.state ${sys.usb.config}
@device/somc/common/files/init.usbmode.sh
VENDOR_ID=0FCE
PID_SUFFIX_PROP=$(/system/bin/getprop ro.usb.pid_suffix)
USB_FUNCTION=$(/system/bin/getprop sys.usb.config)
get_pid_prefix ${USB_FUNCTION}中确定PID_PREFI的值，实际上是根据sys.usb.config
PID=${PID_PREFIX}${PID_SUFFIX_PROP},其中PID_PREFIX表示sony自己定义的功能 5:mtp,adb;0:mtp
echo ${VENDOR_ID} > /sys/class/android_usb/android0/idVendor
echo ${PID} > /sys/class/android_usb/android0/idProduct
@device/somc/common/sony-generic.mk
ADDITIONAL_DEFAULT_PROPERTIES += persist.sys.usb.config=mtp 但是只设置了mtp功能，没有adb功能？
@frameworks/base/services/java/com/android/server/usb/usbdevicemanager.java
函数setEnabledFunctions(..) 会根据setting UI的设置改变persist.sys.usb.config的值
if (mAdbEnabled) {
functions = addFunction(functions, UsbManager.USB_FUNCTION_ADB);
} else {
functions = removeFunction(functions, UsbManager.USB_FUNCTION_ADB);
}
SystemProperties.set("persist.sys.usb.config", functions);
有个问题，设置persist.sys.usb.config是如何传到sys.usb.config的？？？
@system/core/rootdir/init.usb.rc
on property:persist.sys.usb.config=*
setprop sys.usb.config none
setprop sys.usb.config ${persist.sys.usb.config} //两者会同步
4. 可以优化的地方
a. 现在charge eoc后，如果拔掉充电器，则会上报report key KEY_F24, charge only process会在
hw_waitForUserAction@vendor/semc/hardware/power/chargemon/src/hw.c中
hw_wakeUnlock();
i = select(max_fd + 1, &listen, NULL, NULL, &delay);//等待5秒，也只有在这5秒中，系统才有机会suspend
hw_wakeLock();
而上报KEY_F24事件，主要是解决在charge only模式下，系统深度睡眠，拔掉充电器时，charge only不会退出关机
b. 而在 check_plugin_wakelock@kernel/drivers/power/qpnp-charger.c中，当拔掉充电器时会有wakelock,超时2秒
wake_lock_timeout(&chip->somc_params.plugin_wake_lock, PLUGIN_WAKELOCK_TIME_SEC);
c. 由此，是否可以不需要上报KEY_F24给charge only呢？直需要缩短 select 的延时<2秒，就可以避免charge only不会退出关机的问题
十七、电池参数的设置（百分比，温度，电压 之间的关系）
1. @kernel/arch/arm/boot/dts/msm8226-cn3ii.dtsi
&pm8226_bms {
qcom,batt-type = <3>; //电池类型为 BATT_OEM
}
@kernel/arch/arm/mach-msm/Makefile, 当前用的是[email protected]
ifdef CONFIG_MACH_SONY_CN3II
obj-$(CONFIG_MACH_SONY_CN3II) += bms-batterydata-sleipner.o
设置电池的相关参数
set_battery_data@kernel/drivers/power/qpnp-bms.c
插值计算@kernel/arch/arm/mach-msm/baterydata-lib.c
十八、电池低电关机过程
1. 涉及关机的几个参数配置
pm8226_bms: qcom,bms {
qcom,v-cutoff-uv = <3400000>; //关机电压，但只用与计算SOC
qcom,low-soc-calculate-soc-threshold = <15>; //认为是低电的电池百分比
qcom,low-soc-calculate-soc-ms = <5000>; //低电情况下的心跳
qcom,calculate-soc-ms = <20000>;
qcom,low-voltage-threshold = <3420000>;
｝
2. 系统休眠情况下的低电关机触发
setup_vbat_monitoring@kernel/drivers/power/qpnp-bms.c 中会设置低电(高电，高温，低温)的threshold,
还有call back函数btm_notify_vbat， 如果电压低于low-voltage-threshold－VBATT_ERROR_MARGIN也就是3.4V
->configure_vbat_monitor_low
唤醒系统 wake_lock(&chip->low_voltage_wake_lock);
开始计算soc, schedule_delayed_work(&chip->calculate_soc_delayed_work, 0);
针对电池低压的情况下，重新配置参数
如果此时soc=0,则上报android 关机
3. 系统正常情况下的低电关机触发
开机后马上运行 calculate_soc_work,以后只要系统不休眠则 心跳间隔20s(soc > 15%),5s(soc < 15% & wake_lock_active(&chip->low_voltage_wake_lock))
->recalculate_soc
->calculate_state_of_charge
->adjust_soc
->very_low_voltage_check 如果电池电压<3.42v，则wake_lock(&chip->low_voltage_wake_lock);不让系统休眠， 随后心跳间隔一直继续，上报soc,如果soc=0则系统会关机。
十九、PMIC中充电部分中断的申请和处理
1. @kernel/arch/arm/boot/dts/msm-pm8226.dtsi
qcom,chgr@1000 {
status = "disabled";
reg = <0x1000 0x100>;
interrupts = <0x0 0x10 0x0>,
<0x0 0x10 0x1>,
<0x0 0x10 0x2>,
<0x0 0x10 0x3>,
<0x0 0x10 0x4>,
<0x0 0x10 0x5>, //"fast-chg-on"对应的寄存器0x1000 + 0x10 = 0x1010, 0x05表示的是第5个bit
<0x0 0x10 0x6>,
<0x0 0x10 0x7>;
interrupt-names = "vbat-det-lo",
"vbat-det-hi",
"chgwdog",
"state-change",
"trkl-chg-on",
"fast-chg-on",
"chg-failed",
"chg-done";
};
对应的是SMBBP_CHAR_SMNNP_CHAR中 0x1010 SMBBP_CHGR_INT_RT_STS 中断寄存器的bits
2. 如何引用,例子如下：
qpnp_chg_request_irqs@kernel/drivers/power/qpnp-charger.c
chip->chg_fastchg.irq = spmi_get_irq_byname(spmi,spmi_resource, "fast-chg-on");
二十、充电最大时间设置(trickle + fast charging)
1. @kernel/arch/arm/boot/dts/msm-pm8226.dtsi
pm8226_chg: qcom,charger {
qcom,tchg-mins = <150>; //表示150分钟， 取值区间[4, 512]分钟
}
2. qpnp_charger_read_dt_props@kernel/drivers/power/qpnp-charger.c
OF_PROP_READ(chip, tchg_mins, "tchg-mins", rc, 1);
qpnp_chg_hwinit
rc = qpnp_chg_tchg_max_set(chip, chip->tchg_mins); //此处往寄存器0x1061 SMBBP_CHGR_TCHG_MAX 写入
3. 如果需要disable 充电最大时间的限制，则需要操作 寄存器0x1060 SMBBP_CHGR_TCHG_MAX_EN
4. 如果需要设置trickle charge的最大时间限制，则需要操作 寄存器0x105F SMBBP_CHGR_TTRKL_MAX,
enable/disable 则需要操作 寄存器0x105E SMBBP_CHGR_TTRKL_MAX_EN,
二十一、当kernel用power_supply_changed 发送uevent 到 userspace的后续处理
1. register_android_server_BatteryService@frameworks/base/services/jni/com_android_server_BatteryService.cpp 注册的sys path如下：
/sys/class/power_supply/???/online 其中???/type=Mains //注意大小写是区分的
/sys/class/power_supply/usb/online 其中usb/type=USB
/sys/class/power_supply/battery/online 其中usb/type=Battery
/sys/class/power_supply/battery/status
/sys/class/power_supply/battery/health
/sys/class/power_supply/battery/present
/sys/class/power_supply/battery/capacity
/sys/class/power_supply/battery/voltage_now[batt_vol]
/sys/class/power_supply/battery/temp[batt_temp]
/sys/class/power_supply/battery/technology
2. 如果是power_supply_changed(&chip->batt_psy);则user space 会读取所有注册的关于battery 的sys path.
二十二、如何在kernel添加input key event给user space用
@kernel/drivers/power/qpnp-charger.c
注册/* register input device */
chip->somc_params.chg_unplug_key = input_allocate_device();
input_set_capability(chip->somc_params.chg_unplug_key, EV_KEY, KEY_F24);
chip->somc_params.chg_unplug_key->name = "qpnp_chg_unplug_key";
chip->somc_params.chg_unplug_key->dev.parent = &(spmi->dev);
rc = input_register_device(chip->somc_params.chg_unplug_key);
//input_free_device(chip->somc_params.chg_unplug_key);
使用：
input_report_key(chip->somc_params.chg_unplug_key, KEY_F24, value ? 1 : 0);
input_sync(chip->somc_params.chg_unplug_key);
二十三、chager debug
1. echo -n "file qpnp-charger.c +p" > /sys/kernel/debug/dynamic_debug/control
2. disable charging:
echo 0 > /sys/class/power_supply/battery/charging_enabled
3. WARN_ON(1) & BUG_ON
二十四、高通Case和公司DMS的关系
1. 如果遇到问题是高通的bug,提交一个case给高通
2. 在公司的DMS中创建一个主DMS, 并且assign给 coordinator, 并且在Attachments/Reference页签中的External References上
External Reference 选择Qcom
External Reference ID 输入 Qcom的case ID;
3. 如果Qcom的solution没有及时deliver, 我们可以创建一个child dms, 在Linked Records页签中单击 Create Child，在该child DMS中diliver我们自己的solution;一旦Qcom diliver了Solution,则我们自己的solution需要revert.
二十五、 Touch screen, Display新的early suspend机制
1. User space 如果需要early suspend,则需要操作 "/dev/graphics/fb0"
ioctl(fb.fd, FBIOBLANK, FB_BLANK_UNBLANK); //resume
ioctl(fb.fd, FBIOBLANK, FB_BLANK_POWERDOWN); //suspend
2. 通过操作display的ioctl, 进而控制其他需要early supend的设备,主要机制是notify的回调
do_fb_ioctl@kernel/drivers/video/fbmem.c
fb_blank(info, arg)@kernel/drivers/video/fbmem.c
fb_notifier_call_chain(FB_EVENT_BLANK, &event)@kernel/drivers/video/fbmem.c
blocking_notifier_call_chain@kernel/kernel/notifier.c
notifier_call_chain(&nh->head, val, v, nr_to_call,nr_calls)@kernel/kernel/notifier.c
nb->notifier_call(nb, val, v)@kernel/kernel/notifier.c
3. 需要和display一块suspend的设备如何注册notify, 比如touch screen
clearpad_probe@kernel/drivers/input/touchscreen/clearpad_core.c
this->fb_notif.notifier_call = synaptics_fb_notifier_callback;
rc = fb_register_client(&this->fb_notif); //注册display notify的关键函数
另外还注册正常的linux power管理的suspend/resume
static const struct dev_pm_ops synaptics_clearpad_pm = {
.suspend = synaptics_clearpad_pm_suspend,
.resume = synaptics_clearpad_pm_resume,
.suspend_noirq = synaptics_clearpad_pm_suspend_noirq,
};
以上两条suspend的路径最后都调用 synaptics_clearpad_suspend和synaptics_clearpad_resume
二十六、低电关机(soc=0%和电压低于设置的低电压 都会触发低电关机)
1. 电压低于设置电压的处理
@msm-pm8226.dtsi中
pm8226_bms: qcom,bms{
qcom,low-soc-calculate-soc-threshold = <15>; //认为是低电压的soc(15%)
qcom,low-soc-calculate-soc-ms = <5000>; //低电压情况下，计算soc 的时间间隔5s
qcom,calculate-soc-ms = <20000>; //正常情况下，计算soc 的时间间隔20s
qcom,v-cutoff-uv = <3400000>;//用于计算soc
qcom,low-voltage-threshold = <3420000>;//用于设置关机低电压
}
2. 系统一开机会马上运行calculate_soc_work，然后间隔20s或5s 循环执行，只要系统不suspend,该schedule work会一直执行，如果s计算的soc有变化还会power_supply_changed上报给用户空间，如果此时soc=0%则用户空间会强制关机shut down.
3. 另外还有一种情况，就是系统已经suspend,但电池电压小于预先设置的门限电压，会触发notify也就是[email protected]，如果是低电状态则继续调用configure_vbat_monitor_low,其中会wake_lock(&chip->low_voltage_wake_lock);让系统不再suspend,马上开始运行calculate_soc_work，也就是把soc=０%的信息赶快通知给user space,好执行低电关机。具体分析如下：
３.1 设置低电notify的相关参数，[email protected]
->[email protected]; 设置adc channel的监控设置
chip->vbat_monitor_params.low_thr = chip->low_voltage_threshold; //低电压门限设置
chip->vbat_monitor_params.high_thr = chip->max_voltage_uv - VBATT_ERROR_MARGIN; //高电压门限设置
chip->vbat_monitor_params.state_request = ADC_TM_HIGH_LOW_THR_ENABLE; //触发的类型 满足高低电压门限时触发
chip->vbat_monitor_params.channel = VBAT_SNS;
chip->vbat_monitor_params.btm_ctx = (void *)chip;
chip->vbat_monitor_params.timer_interval = ADC_MEAS1_INTERVAL_1S; //Polling 时间
chip->vbat_monitor_params.threshold_notification = &btm_notify_vbat; //回调函数
rc = qpnp_adc_tm_channel_measure(&chip->vbat_monitor_params);
3.2 @qpnp-adc-tm.c
notify_adc_tm_fn是其中关键的处理函数
->notify_clients(adc_tm)-->adc_tm->btm_param->threshold_notification(ADC_TM_LOW_STATE, adc_tm->btm_param->btm_ctx);
qpnp_adc_tm_probe中初始化INIT_WORK(&adc_tm->sensor[sen_idx].work, notify_adc_tm_fn);
初始化qpnp_adc_tm_low_thr_isr中断处理函数
rc = devm_request_irq(&spmi->dev, adc_tm->adc->adc_low_thr_irq,
qpnp_adc_tm_low_thr_isr,IRQF_TRIGGER_RISING, "qpnp_adc_tm_low_interrupt", adc_tm);
一旦电压低于chip->vbat_monitor_params.low_thr则触发qpnp_adc_tm_low_thr_isr，然后schedule_work(qpnp_adc_tm_low_thr_work);最后会调用qpnp_adc_tm_read_status，又会触发schedule_work(&adc_tm->sensor[sensor_num].work);即notify_adc_tm_fn函数，从而会发notify消息给BMS的btm_notify_vbat->configure_vbat_monitor_low和power_supply_changed
二十七、读取的adc电压和电池温度的关系
1. @kernel/drivers/hwnon/qpnp-adc-common.c
计算电池温度和电压关系的函数qpnp_adc_scale_batt_therm
电池温度和电压关系的对应表adcmap_btm_threshold[], 该表需要电池team提供
static const struct qpnp_vadc_map_pt adcmap_btm_threshold[] = {
{-300, 1686}, ...
{0, 1342}, ...
{450, 619}, ... {温度45度，电压619mv}
}
通过线性逼近插值计算精度可以到达0.1Degc
2. 读取电池温度的流程
get_prop_batt_temp@kernel/drivers/power/qpnp-charger.c
qpnp_vadc_read(LR_MUX1_BATT_THERM, &results)@kernel/drivers/hwmon/qpnp-adc-voltage.c
qpnp_vadc_conv_seq_request(ADC_SEQ_NONE, channel, result)@kernel/drivers/hwmon/qpnp-adc-voltage.c
vadc_scale_fn[scale_type].chan(result->adc_code,vadc->adc->adc_prop, vadc->adc->amux_prop->chan_prop, result)@qpnp-adc-voltage.c
qpnp_adc_scale_batt_therm@kernel/drviers/hwmon/qpnp-adc-common.c
重点分析[email protected]
a. vadc->adc->adc_channels 的赋值
[email protected]
->adc_qpnp->adc_channels = adc_channel_list;其中adc_channel_list是分析读取msm8226-cn3ii.dtsi中&pm8226_vadc的节点内容，其中有
chan@30 {
label = "batt_therm";
reg = <0x30>; //channel_num 通道号，也就是需要读取的channel,针对battery thermal是LR_MUX1_BATT_THERM＝48，正好匹配
qcom,decimation = <0>;
qcom,pre-div-channel-scaling = <0>;
qcom,calibration-type = "ratiometric";
qcom,scale-function = <1>; //adc_scale_fn的ID,也就是scale_type
qcom,hw-settle-time = <2>;
qcom,fast-avg-setup = <0>;
};
->vadc_scale_fn的定义
static struct qpnp_vadc_scale_fn vadc_scale_fn[] = {
[SCALE_DEFAULT] = {qpnp_adc_scale_default},
[SCALE_BATT_THERM] = {qpnp_adc_scale_batt_therm}, //battery thermal的scale函数[email protected]
[SCALE_PMIC_THERM] = {qpnp_adc_scale_pmic_therm},
[SCALE_XOTHERM] = {qpnp_adc_tdkntcg_therm},
[SCALE_THERM_100K_PULLUP] = {qpnp_adc_scale_therm_pu2},
[SCALE_THERM_150K_PULLUP] = {qpnp_adc_scale_therm_pu1},
[SCALE_QRD_BATT_THERM] = {qpnp_adc_scale_qrd_batt_therm},
};
init.rc文件中执行顺序如下：
2. https://wiki.sonyericsson.net/androiki/CN3-II/Bringup_Trail_FC34 如何编译
3. https://wiki.sonyericsson.net/androiki/PLD_CM/Yangtze 如何编译和flash
4. https://wiki.sonyericsson.net/androiki/MIB_Tokyo/Rhine/Hardware_Watchdog_debugging
小技巧：
MISCTA 2473控制kernel log输出： 01 输出，00 无输出
repo sync [目录路径] 比如： kenel,system/vold
repo sync kernel 则只是同步kernel目录下的代码
grep "ifelse" * -r 查找当前目录下（递归）所有文件中包含ifelse的内容
owner:[email protected] status:merged //查找谁提交并且已经merged的gerrit
printk("func = %pf",func)可打印函数名称出来
充电缩写语：(acronym)
FSM: Finite State Machine
CC: Coulcomb Counter
FCC: Full Charge Capacity
OCV: Open Circuit Voltage
PMIC: Power Management IC
PC: Percentage Charge
RC: Remaining Charge
SOC: State of Charge
RUC: Remaining Usable Charge
UUC: Unusable Charge
一、DTS 学习
1. kernel/arch/arm/boot/dts 目录下包含所有的dts.
a. board , msm8226.dtsi
b. pmic, msm-pm8226.dtsi
2. kernel/Androidkernel.mk; Android makefile to build kernel as a part of Android Build
3. kernel/arch/arm/configs 目录下保存对应的config定义， CONFIG_XXXXXX
4. 可参考 jb-mr1-rhine/kernel/arch/arm/boot/dts/msm8974-rhine_togari_row.dtsi
二、LCD Porting
1. http://review.sonyericsson.net/#/c/508903
三、Charger bringup
1. 和battery and hw guys 确定相关 硬件参数
2. http://review.sonyericsson.net/#/c/516297/
3. kernel 发送给battery_logging的uevent格式？
power_supply_uevent@kernel/drivers/power/power_supply_sysfs.c 该函数添加发送的信息到uevent
ret = add_uevent_var(env, "POWER_SUPPLY_NAME=%s", psy->name); //psy->name="battery"
for (j = 0; j < psy->num_properties; j++) {
attr = &power_supply_attrs[psy->properties[j]]; //得到对应的power supply attr,
attrname = kstruprdup(attr->attr.name, GFP_KERNEL);//会把属性名字转成大写，比如“status”->"STATUS"
ret = add_uevent_var(env, "POWER_SUPPLY_%s=%s", attrname, prop_buf); //增加该属性的信息到uevent buffer中
}
qpnp_charger_probe@kernel/drivers/power/qpnp-charger.c中会定义"battery"的properties = msm_batt_power_props
static enum power_supply_property msm_batt_power_props[] = { //对应power_supply_attrs[]@kernel/drivers/power/power_supply_sysfs.c
POWER_SUPPLY_PROP_CHARGING_ENABLED, //表示这些属性是被battery psy所需要的属性,具体如何得到可查看
POWER_SUPPLY_PROP_STATUS, //qpnp_batt_power_get_property 函数
POWER_SUPPLY_PROP_CHARGE_TYPE, //这些属性会添加到/sys/class/power_supply/battery
POWER_SUPPLY_PROP_HEALTH,
POWER_SUPPLY_PROP_PRESENT,
POWER_SUPPLY_PROP_TECHNOLOGY,
POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN,
POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN,
POWER_SUPPLY_PROP_VOLTAGE_NOW,
POWER_SUPPLY_PROP_CAPACITY,
POWER_SUPPLY_PROP_CURRENT_NOW,
POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN,
POWER_SUPPLY_PROP_TEMP,
POWER_SUPPLY_PROP_SYSTEM_TEMP_LEVEL,
};
static struct device_attribute power_supply_attrs[] = {
/* Properties of type `int' */
POWER_SUPPLY_ATTR(status), //表示attr.name = "status"
POWER_SUPPLY_ATTR(charge_type),
...
}
4. parse_uevent@vendor/semc/hardware/power/charge-log/battery_logging/battery_logging.c会分析从kernel传上来的power uevent格式
发送该uevent的path '\0'
POWER_SUPPLY_NAME=battery '\0'
POWER_SUPPLY_CHARGING_ENABLE=%d '\0'
POWER_SUPPLY_CHARGING_STATUS=%d '\0'
...
5. 顺便分析下UEvent如何传递给user space?
a. @kernel/drivers/power/qpnp-charger.c中只要有任何关于charger的变化，比如charger的各种irq handler
b. @kernel/drivers/power/qpnp-bms.c中calculate_soc_from_voltage和calculate_state_of_charge
c. @kernel/arch/arm/boot/dts/msm-pm8226.dtsi中有pm8226_bms的device定义，msm8226-cn3ii.dtsi中有pm8226_bms的定义补充
其中没有 qcom,use-voltage-soc 的定义所以chip->use_voltage_soc=false, 也就是只用calculate_state_of_charge计算soc
顺便chip->use_external_rsense=true,表示用外部的rsense.
d. @kernel/driver/power/power_supply_core.c中的power_supply_changed会被以上内容调用
schedule_work(&psy->changed_work);
e. power_supply_changed_work@kernel/driver/power/power_supply_core.c
kobject_uevent(&psy->dev->kobj, KOBJ_CHANGE); //action=KOBJ_CHANGE
f. kobject_uevent_env@kernel/lib/kobject_uevent.c
static const char *kobject_actions[] = {
[KOBJ_ADD] = "add",
[KOBJ_REMOVE] = "remove",
[KOBJ_CHANGE] = "change",
[KOBJ_MOVE] = "move",
[KOBJ_ONLINE] = "online",
[KOBJ_OFFLINE] = "offline",
};
以下为添加到uevent buffer中发送的内容
/* default keys */
retval = add_uevent_var(env, "ACTION=%s", action_string);//action_string="change"
retval = add_uevent_var(env, "DEVPATH=%s", devpath);//devpath = kobject_get_path(kobj, GFP_KERNEL);
retval = add_uevent_var(env, "SUBSYSTEM=%s", subsystem);//也就是uevent 的name
retval = uevent_ops->uevent(kset, kobj, env); //会调用到power_supply_uevent@kernel/drivers/power/power_supply_sysfs.c
//也就是会添加具体的power battery信息到uevent buffer中了
retval = add_uevent_var(env, "SEQNUM=%llu", (unsigned long long)++uevent_seqnum); //增加uevent发送的计数，
//KERNEL_ATTR_RO(uevent_seqnum); 用cat sys/kernel/uevent_seqnum 可以查看
CONFIG_NET=y被定义，以下代码是发送uevent到userspace 的关键代码
#if defined(CONFIG_NET)
/* send netlink message */
list_for_each_entry(ue_sk, &uevent_sock_list, list) { //uevent_net_init会初始化一个uevent_sock，也只有一个
if (!netlink_has_listeners(uevent_sock, 1))
continue;
/* allocate message with the maximum possible size */
len = strlen(action_string) + strlen(devpath) + 2;
skb = alloc_skb(len + env->buflen, GFP_KERNEL);
if (skb) {
retval = netlink_broadcast_filtered(uevent_sock, skb,
0, 1, GFP_KERNEL,
kobj_bcast_filter,
kobj);
} else
retval = -ENOMEM;
}
#endif
6. Battery充满的识别
1). @kernel/arch/arm/boot/dts/msm-pm8226.dtsi和msm8226-cn3ii.dtsi
qcom,chg-chgr@1000 {
status = "disabled";
reg = <0x1000 0x100>;
interrupts = <0x0 0x10 0x0>,
<0x0 0x10 0x1>,
<0x0 0x10 0x2>,
<0x0 0x10 0x3>,
<0x0 0x10 0x4>,
<0x0 0x10 0x5>,
<0x0 0x10 0x6>,
<0x0 0x10 0x7>; //具体的含义？
interrupt-names = "vbat-det-lo",
"vbat-det-hi",
"chgwdog",
"state-change",
"trkl-chg-on",
"fast-chg-on",
"chg-failed",
"chg-done";
};
2). qpnp_chg_hwinit@kernel/drivers/power
chip->chg_done_irq = spmi_get_irq_byname(chip->spmi,spmi_resource, "chg-done");
如何触发"chg-done"这个interrupt?
3).获取当前充电状态
rc = qpnp_chg_read(chip, &chgr_sts,INT_RT_STS(chip->chgr_base), 1);
如果chgr_sts&CHG_DONE_IRQ == 1则表示充电完成
4).http://review.sonyericsson.net/#/c/480849, workaround for fake charge done
6. 如何查看当前的charger信息？
/sys/devices/qpnp-charger-eab16c00
7. 手机/sys/class/power_supply/battery和bms和usb的来源
1)qpnp_charger_proble@kernel/drivers/power/qpnp-charger.c
if (chip->bat_if_base){
chip->batt_psy.name = "battery";
chip->batt_psy.type = POWER_SUPPLY_TYPE_BATTERY;
chip->batt_psy.properties = msm_batt_power_props;//所选择的属性
rc = power_supply_register(chip->dev, &chip->batt_psy);//注册到/sys/class/power_supply/battery
}
2)qpnp_bms_probe@kernel/drivers/power/qpnp-bms.c
chip->bms_psy.name = "bms";
chip->bms_psy.type = POWER_SUPPLY_TYPE_BMS;
chip->bms_psy.properties = msm_bms_power_props;
rc = power_supply_register(chip->dev, &chip->bms_psy);//注册到/sys/class/power_supply/bms
3)msm_otg_proble@kernel/drivers/usb/otg, 注意CONFIG_USB_MSM_OTG的定义在kernel/drivers/usb/gadget/Kconfig: config USB_CI13XXX_MSM-->select USB_MSM_OTG
motg->usb_psy.name = "usb";
motg->usb_psy.type = POWER_SUPPLY_TYPE_USB;
motg->usb_psy.supplied_to = otg_pm_power_supplied_to;
msm_otg_register_power_supply(pdev, motg))->power_supply_register(&pdev->dev, &motg->usb_psy);
4)充电器的识别过程
msm_chg_detect_work@kernel/drivers/usb/otg/msm_otg.c 主要完成充电器类别的识别过程
->msm_otg_notify_chg_type@msm_otg.c
->power_supply_set_supply_type(psy, charger_type)@msm_otg.c;//psy=motg->usb_psy
->psy->set_property(psy, POWER_SUPPLY_PROP_TYPE,&ret); //@kernel/drivers/power/power_supply_core.c, 最后会call
->otg_power_set_property_usb@msm_otg.c 但是该函数中没有POWER_SUPPLY_PROP_TYPE属性的设置？？
->queue_work(system_nrt_wq, &motg->sm_work);->msm_otg_sm_work[otg->phy->state=OTG_STATE_B_IDLE]
-->msm_otg_notify_charger->msm_otg_notify_power_supply->power_supply_set_online//设置是否online
四、Audio Jack Porting
0. HW Guys: Wang, Junchao(9601), Liu,Xun
1. kernel/sound/soc/msm/msm8226.c;
kernel/sound/soc/codecs/wcd9306.c,Wcd9xxx-mbhc.c
tapan_slimbus_irq
2. adb shell 'echo -n "file wcd9xxx-mbhc.c +p" > /sys/kernel/debug/dynamic_debug/control'
3. [email protected]
0x6c-->0x68 //参考80-NC836-2 WCD9306 AUDIO CODEC SOFTWARE INTERFACE.pdf 中0x14B MBHC_INSERT_DET_STATUS寄存器的说明，PLUG_TYPE 0:NC 1:NO （注意原来的文档有错）
Audio Jack不插入耳机时MBHC_HSDET是低，插入耳机时MBHC_HSDET是高，所以是Normal Close(NC)类型的Audio Jack
4. @kernel/sound/soc/msm/msm8226.c;
S(v_no_mic, 30);
S(v_hs_max, 1650);
5. @kernel/sound/soc/codecs/Wcd9xxx-mbhc.c
wcd9xxx_codec_get_plug_type->
wcd9xxx_find_plug_type
6. Audio jack检测耳机的流程
在函数wcd9xxx_mbhc_decide_swch_plug中如果检测到是headset则不重复多次检测，如果是headphone则需要
wcd9xxx_schedule_hs_detect_plug(mbhc,&mbhc->correct_plug_swch);启动重复检测以确认正确
插入headphone耳机
<7>[ 105.233608] wcd9xxx_mech_plug_detect_irq: enter
<7>[ 105.233625] wcd9xxx_swch_irq_handler: enter
<7>[ 105.238692] wcd9xxx_swch_irq_handler: Acquiring BCL
<7>[ 105.238706] wcd9xxx_swch_irq_handler: Acquiring BCL done
<7>[ 105.238864] wcd9xxx_swch_irq_handler: Current plug type 0, insert 1
<7>[ 105.238876] wcd9xxx_cancel_hs_detect_plug: Canceling correct_plug_swch
<7>[ 105.238885] wcd9xxx_cancel_hs_detect_plug: Release BCL
<7>[ 105.238897] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL
<7>[ 105.238907] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL done
<7>[ 105.239014] wcd9xxx_mbhc_detect_plug_type: enter
<7>[ 105.497933] wcd9xxx_mbhc_decide_swch_plug: enter
<7>[ 105.498378] wcd9xxx_codec_get_plug_type: enter
<7>[ 105.501350] wcd9xxx_mbhc_setup_hs_polling: enter
...
<7>[ 105.590299] wcd9xxx_find_plug_type: DCE #0, fc06, V 0008(0008), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.590317] wcd9xxx_find_plug_type: DCE #1, fc06, V 0008(0008), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.590332] wcd9xxx_find_plug_type: DCE #2, fc06, V 0008(0008), GND 1, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.590346] wcd9xxx_find_plug_type: DCE #3, fc06, V 0008(0008), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.590359] wcd9xxx_find_plug_type: Plug type 2 detected
<7>[ 105.590368] wcd9xxx_codec_get_plug_type: leave
<7>[ 105.590655] wcd9xxx_report_plug: enter insertion 1 hph_status 0
<7>[ 105.590666] wcd9xxx_report_plug: Reporting insertion 1(1)
继续进行检测wcd9xxx_correct_swch_plug，用以确认检测正确，如果检测到是PLUG_TYPE_HEADPHONE则需要在 HS_DETECT_PLUG_TIME_MS＝5000毫秒内多次检测
<7>[ 105.717321] wcd9xxx_correct_swch_plug: Acquiring BCL
<7>[ 105.717335] wcd9xxx_correct_swch_plug: Acquiring BCL done
<7>[ 105.717344] wcd9xxx_codec_get_plug_type: enter
<7>[ 105.720967] wcd9xxx_mbhc_setup_hs_polling: enter
<7>[ 105.804823] wcd9xxx_find_plug_type: DCE #0, fc08, V 0010(0010), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.804841] wcd9xxx_find_plug_type: DCE #1, fc08, V 0010(0010), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.804856] wcd9xxx_find_plug_type: DCE #2, fc08, V 0010(0010), GND 1, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.804871] wcd9xxx_find_plug_type: DCE #3, fc08, V 0010(0010), GND 0, VDDIO 0, HPHL 1 TYPE 2
<7>[ 105.804884] wcd9xxx_find_plug_type: Plug type 2 detected
<7>[ 105.804892] wcd9xxx_codec_get_plug_type: leave
<7>[ 105.804901] wcd9xxx_correct_swch_plug: Release BCL
<7>[ 105.804912] wcd9xxx_correct_swch_plug: attempt(1) current_plug(2) new_plug(2)
<7>[ 105.804922] Good headphone detected, continue polling
。。。
拔出耳机
<7>[ 1010.417287] wcd9xxx_mech_plug_detect_irq: enter
<7>[ 1010.417304] wcd9xxx_swch_irq_handler: enter
<7>[ 1010.422617] wcd9xxx_swch_irq_handler: Acquiring BCL
<7>[ 1010.422635] wcd9xxx_swch_irq_handler: Acquiring BCL done
<7>[ 1010.422809] wcd9xxx_swch_irq_handler: Current plug type 2, insert 0
<7>[ 1010.422820] wcd9xxx_cancel_hs_detect_plug: Canceling correct_plug_swch
<7>[ 1010.422830] wcd9xxx_cancel_hs_detect_plug: Release BCL
<7>[ 1010.422842] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL
<7>[ 1010.422851] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL done
<7>[ 1010.422863] wcd9xxx_report_plug: enter insertion 0 hph_status 1
<7>[ 1010.422876] wcd9xxx_report_plug: Reporting removal 1(0)
<7>[ 1010.422911] wcd9xxx_set_and_turnoff_hph_padac PA is off
<7>[ 1010.445247] __hphocp_off_report: clear ocp status 80
<7>[ 1010.445261] __hphocp_off_report: clear ocp status 40
<7>[ 1010.445272] wcd9xxx_insert_detect_setup: Setting up insert detection
<7>[ 1010.445468] wcd9xxx_report_plug: leave hph_status 0
<7>[ 1010.446056] wcd9xxx_swch_irq_handler: Release BCL
<7>[ 1010.446067] wcd9xxx_swch_irq_handler: leave
<7>[ 1010.446079] wcd9xxx_mech_plug_detect_irq: leave 1
<7>[ 1010.446408] wcd9xxx_hs_insert_irq: enter
<7>[ 1010.446418] wcd9xxx_hs_insert_irq: Acquiring BCL
<7>[ 1010.446427] wcd9xxx_hs_insert_irq: Acquiring BCL done
<7>[ 1010.446880] wcd9xxx_hs_insert_irq_swch: Removal
<7>[ 1010.447010] wcd9xxx_hs_insert_irq: Release BCL
插入Headset
<7>[ 1084.338102] wcd9xxx_mech_plug_detect_irq: enter
<7>[ 1084.338119] wcd9xxx_swch_irq_handler: enter
<7>[ 1084.343428] wcd9xxx_swch_irq_handler: Acquiring BCL
<7>[ 1084.343447] wcd9xxx_swch_irq_handler: Acquiring BCL done
<7>[ 1084.343619] wcd9xxx_swch_irq_handler: Current plug type 0, insert 1
<7>[ 1084.343631] wcd9xxx_cancel_hs_detect_plug: Canceling correct_plug_swch
<7>[ 1084.343641] wcd9xxx_cancel_hs_detect_plug: Release BCL
<7>[ 1084.343653] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL
<7>[ 1084.343662] wcd9xxx_cancel_hs_detect_plug: Acquiring BCL done
<7>[ 1084.343676] wcd9xxx_mbhc_detect_plug_type: enter
<7>[ 1084.598139] wcd9xxx_mbhc_decide_swch_plug: enter
<7>[ 1084.598340] wcd9xxx_codec_get_plug_type: enter
<7>[ 1084.601291] wcd9xxx_mbhc_setup_hs_polling: enter
<7>[ 1084.676366] wcd9xxx_find_plug_type: DCE #0, 026d, V 1306(1306), GND 0, VDDIO 0, HPHL 1 TYPE 1
<7>[ 1084.676384] wcd9xxx_find_plug_type: DCE #1, 02b7, V 1365(1365), GND 0, VDDIO 0, HPHL 1 TYPE 1
<7>[ 1084.676399] wcd9xxx_find_plug_type: DCE #2, 02bb, V 1368(1368), GND 1, VDDIO 0, HPHL 1 TYPE 1
<7>[ 1084.676414] wcd9xxx_find_plug_type: DCE #3, 02bb, V 1368(1368), GND 0, VDDIO 0, HPHL 1 TYPE 1
<7>[ 1084.676427] wcd9xxx_find_plug_type: Plug type 1 detected
<7>[ 1084.676436] wcd9xxx_codec_get_plug_type: leave
<7>[ 1084.676720] wcd9xxx_mbhc_decide_swch_plug: Valid plug found, determine plug type 1
<7>[ 1084.676733] wcd9xxx_find_plug_and_report: enter current_plug(0) new_plug(1)
<7>[ 1084.676745] wcd9xxx_report_plug: enter insertion 1 hph_status 0
<7>[ 1084.676755] wcd9xxx_report_plug: Reporting insertion 3(3)
<7>[ 1084.676802] wcd9xxx_insert_detect_setup: Setting up removal detection
<7>[ 1084.676955] wcd9xxx_report_plug: leave hph_status 3
<7>[ 1084.777467] wcd9xxx_start_hs_polling: enter
<7>[ 1084.779191] wcd9xxx_start_hs_polling: leave
<7>[ 1084.779202] wcd9xxx_find_plug_and_report: leave
<7>[ 1084.779212] wcd9xxx_mbhc_decide_swch_plug: leave
<7>[ 1084.779221] wcd9xxx_mbhc_detect_plug_type: leave
<7>[ 1084.779229] wcd9xxx_swch_irq_handler: Release BCL
<7>[ 1084.779238] wcd9xxx_swch_irq_handler: leave
<7>[ 1084.779250] wcd9xxx_mech_plug_detect_irq: leave 1
五、如何flash开发板
1. lunch
2. fastboot flash boot boot.img, flash kernel的image
fastboot flash system system.img, flash system的image
六、SIM card detection
1. kernel/arch/arm/boot/dts/msm8226-cn3ii.dts 中有gpio_keys节点
gpio_keys {
compatible = "gpio-keys"
input-name = "gpio-keys" //表示输出event的名字
...
}
kernel/drivers/input/keyboard/gpio_keys.c会解析 gpio-keys 的dts
增加sim card detection 的gpio key
sim1 {
ompatible = "gpio-keys";
input-name = "sim1-detection";
sim1_det {
label = "sim1-detection";
gpios = <&msmgpio 60 0x0>; //msmgpio表示使用的是8226的gpio, 60表示GPIO60
linux,input-type = <5>; //define EV_SW 0x05
linux,code = <7>; //#define SW_JACK_PHYSICAL_INSERT 0x07 /* set = mechanical switch set */
gpio-key,wakeup;
debounce-interval = <10>;
};
};
2. http://review.sonyericsson.net/#/c/518583
3. https://wiki.sonyericsson.net/androiki/FP8615_Support_for_SIM_detection_for_Zeus_Docomo_Definition_Report
七、Vibrator
1. 检查是否工作 #echo 1000 > /sys/class/timed_output/vibrator/enable
八、GPIO设置的确认
1. msmgpio@kernel/arch/arm/boot/dts/msm8226-cn3ii.dtsi
msmgpio: gpio@fd510000 {
compatible = "qcom,msm-gpio";
interrupt-controller;
#interrupt-cells = <2>;
reg = <0xfd510000 0x4000>;
gpio-controller;
#gpio-cells = <2>;
ngpio = <117>;
interrupts = <0 208 0>;
qcom,direct-connect-irqs = <8>;
};
2. pm8226_gpios@kernel/arch/arm/boot/dts/msm8226-cn3ii.dts
&pm8226_gpios {
gpio@c000 { /* GPIO 1 */
/* XO_PMIC_CDC_MCLK enable for tapan codec */
qcom,mode = <1>; /* Digital output */
qcom,output-type = <0>; /* CMOS logic */
qcom,pull = <5>; /* QPNP_PIN_PULL_NO*/
qcom,vin-sel = <2>; /* QPNP_PIN_VIN2 */
qcom,out-strength = <3>;/* QPNP_PIN_OUT_STRENGTH_HIGH */
qcom,src-sel = <2>; /* QPNP_PIN_SEL_FUNC_1 */
qcom,master-en = <1>; /* Enable GPIO */
};
gpio@c100 { /* GPIO 2 */
qcom,mode = <1>;
qcom,output-type = <0>;
qcom,pull = <5>;
qcom,vin-sel = <2>;
qcom,out-strength = <3>;
qcom,src-sel = <2>;
qcom,master-en = <1>;
};
...
}
3. http://review.sonyericsson.net/#/c/518583/
4. GPIO 如何配置成I2C
1)@kernel/arch/arm/boot/dts/msm8226-cn3ii.dtsi, 以下设置i2c的参数
i2c@f9926000 { /* BLSP-1 QUP-4 */
cell-index = <0>;
compatible = "qcom,i2c-qup";
reg = <0xf9926000 0x1000>;
#address-cells = <1>;
#size-cells = <0>;
reg-names = "qup_phys_addr";
interrupts = <0 98 0>;
interrupt-names = "qup_err_intr";
qcom,i2c-bus-freq = <400000>;
qcom,i2c-src-freq = <400000>;
ti_lm3630_bl@36{
compatible = "ti,lm3630_bl";
reg = <0x36>;
gpio_hw_en = <&msmgpio 27 0>;
pwm_feedback = <0x08 0x10>;
ctl = <0x00 0x00>;
fsc = <20200 20200>;
iname = "lm3630-lcd-bl-1","lm3630-lcd-bl-2";
connected = <0x01 0x01>;
bank = <0x00 0x01>;
filter_str = <0x03>;
ovp_boost = <0x24>;
led_fault = <0x00>;
intf_name = "lm3630-lcd-bl-1","lm3630-lcd-bl-2";
brightness = <255 255>;
};
};
2)kernel/arch/arm/mach-msm/board-sony_cn3ii-gpiomux.c,以下配置GPIO14和15为I2C的功能，即GPIOMUX_FUNC_3
static struct msm_gpiomux_config msm_blsp_configs[] __initdata = {
{
.gpio = 14, /* BLSP1 QUP4 I2C_SDA */
.settings = {
[GPIOMUX_SUSPENDED] = &gpio_i2c_config,
},
},
{
.gpio = 15, /* BLSP1 QUP4 I2C_SCL */
.settings = {
[GPIOMUX_SUSPENDED] = &gpio_i2c_config,
},
},
}
static struct gpiomux_setting gpio_i2c_config = {
.func = GPIOMUX_FUNC_3,
.drv = GPIOMUX_DRV_2MA,
.pull = GPIOMUX_PULL_NONE,
};
八、GPIO Check
1. AP GPIO:
kernel/arch/arm/mach-msm/board-sony_cn3ii-gpiomux.c //这其中只是定义了某个GPIO的配置，如果程序需要使用，还要gpio_request
/
PMIC GPIO:
kernel/arch/arm/boot/dts/msm-pm8226.dtsi中有pm8226_gpios的定义
kernel/arch/arm/boot/dts/msm8226-cn3ii.dts中的&pm8226_gpios,
kernel/drivers/gpio/gpnp-pin.c 中会解析pm8226_gpios dts.
2. HW Guy: Liu, Helson for GPIO setting.
3. GPIO设置文档http://metadoc.sonyericsson.net/login_link.asp?doc=1/10262-17/FCP1191405/6&rev=latest
４. 还可以在 cat sys/kernel/debug/gpio 确认当前GPIO的状态
九、battery logging port
1. device/somc/yangtze/BoardConfig.mk
# battery logging //打开编译libbatterylogging的开关
ifneq ($(TARGET_BUILD_VARIANT), user)
SONY_CFG_LIBBATTERYLOGGING := true
endif
device/somc/yangtze/platform.mk
->PRODUCT_PACKAGES += battery_logging //添加battery_logging编译目录
device/somc/yangtze/files/init.sony-platform.rc
ONLY_IN_DEBUG( //设置是否 实时开始和停止运行battery_logging, 其定义在/build/core/definitions.mk (－DONLY_IN_DEBUG)
//实际上表示只要编译的版本是eng和userdebug版本都需要执行
on property:battery_log=1 //init.c分析时会把property:battery_log 当作一个action 的条件加入trigger链表，当通过setprop改变
//battery_log的属性时会触发该action: start/stop battery_logging
//具体的代码分析：property_set@system/core/init/property_service.c
start battery_logging
on property:battery_log=0 //setprop battery_log 0 可以停止battery_logging service,
stop battery_logging)
ONLY_IN_VARIANT(eng, //其定义在/build/core/definitions.mk (－DONLY_IN_VARIANT)
on property:dev.bootcomplete=1
start battery_logging)
ONLY_IN_VARIANT(userdebug,
on property:dev.bootcomplete=1
start battery_logging)
ONLY_IN_DEBUG(
service battery_logging /system/bin/battery_logging
disabled) //disable表示需要手动启动
2. vendor/semc/hardware/device/yangtze/libbatterylogging
->out/target/product/cn3ii/obj/STATIC_LIBRARIES/libbatterylogging_intermediates/libbatterylogging.a
3. vendor/semc/hardware/power/charge-log/battery_logging
->out/target/product/cn3ii/system/bin/battery_logging
4. #battery_logging -p //输出所有的需要输出信息的名称和路径
#battery_logging -d //输出运行时的log
十、device tree source(DTS)
0. http://devicetree.org/Main_Page
1. *.dts/dtsi 文件一般位于 kernel/arch/arm/boot/dts，比如msm8226-cn3ii.dts msm8226-cn3ii.dtsi
２. 如何决定用那个*.dts文件？
@kernel/arch/arm/mach-msm/Makefile.boot
# MSM8226
zreladdr-$(CONFIG_ARCH_MSM8226) := 0x00008000 //是啥地址？
dtb-$(CONFIG_MACH_SONY_CN3II) += msm8226-cn3ii.dtb
@kernel/arch/arm/configs/cn3ii_defconfig
CONFIG_ARCH_MSM8226=y
CONFIG_MACH_SONY_CN3II=y
3. 编译dts为dtb的工具为DTC,位于kernel/scripts/dtc
hostprogs-y := dtc //@Makefile中，该行表示用hostprogs编译生成dtc
最后生成的dtc可执行文件位于out/target/product/cn3ii/obj/KERNEL_OBJ/scripts/dtc/dtc
4.用dtc编译*.dts生成的*.dtb文件位于
out/target/product/cn3ii/obj/KERNEL_OBJ/arch/arm/boot/msm8226-cn3ii.dtb
存放在手机什么地方？
bootloader如何读取？如何传递给kernel?
head-common.S@kernel\arch\arm\kernel中有
.long __atags_pointer @ r6 //表示保存dtb的地址通过r6传递给kernel
5. kernel中解析DTS
setup_machine_fdt@kernel/arch/arm/kernel/devtree.c
struct boot_param_header *devtree = phys_to_virt(dt_phys); //注意boot_param_header结构
setup_machine_fdt将分析dtb最后所有devices生成树，如何和以前的版本结果就一样了
6. kernel中各个device和driver谁先加载？
十一、charge only porting
1. device/somc/common/sony-generic.mk 添加
-include vendor/semc/hardware/device/device.mk
2. device/somc/yangtze/files/init.sony-platform.rc 中添加
on early-boot
exec /system/bin/chargemon
//write /sys/class/power_supply/battery/enable_stop_charging_at_low_battery 1
device/somc/yangtze/BoardConfig.mk 增加
# Device sysfs path definitions
TARGET_BACKLIGHT_DEVICE_PATH := /sys/class/leds/wled:backlight/brightness
TARGET_LED_R_DEVICE_PATH := /sys/class/leds/led:rgb_red/brightness
TARGET_LED_G_DEVICE_PATH := /sys/class/leds/led:rgb_green/brightness
TARGET_LED_B_DEVICE_PATH := /sys/class/leds/led:rgb_blue/brightness
TARGET_DISPLAY_DEVICE_PATH := /sys/devices/mdss_dsi_panel
3. vendor/semc/hardware/device/目录下添加device.mk 和 cn3ii/cn3ii.mk, 添加以下关键内容
@device.mk
DEVICE_CONFIG=vendor/semc/hardware/device
# Call product specific makefiles.
-include $(DEVICE_CONFIG)/$(TARGET_PRODUCT)/$(TARGET_PRODUCT).mk
# Call platform specific makefiles.
-include $(DEVICE_CONFIG)/yangtze/platform.mk
@cn3ii.mk
SONY_CFG_CHARGEMON := true
PRODUCT_PACKAGES += chargemon
vendor/semc/hardware/device/yangtze$ 目录下添加chargemon_common.mk和platform.mk
@platform.mk
PLATFORM_DEVICE_CONFIG=vendor/semc/hardware/device/yangtze
# chargemon
include $(PLATFORM_DEVICE_CONFIG)/chargemon_common.mk
6. 注意：
*.rc 文件放在ramdisk中，而一般打包在boot.img或kernel.sin中
修改完*.mk文件后，需要重新lunch才会生效
7. 如何debug
#define DEBUG_LOG //在log.h中定义，打开log输出到手机 data/cm.log
LOGM(2); //在main代码中打开log输出mode,
十二、电池充电的几个关键过程
Trigle charge：
0. 当电池电压很低时，如何charge?
1. Vbat>3.42V,直接进入sys boot; Vbat<3.42时进入SBL的充电逻辑，Vbat<2.9v进入SBL的trigle charge(200mA充电)，当超过2.9v时，进入SBL的fast charge模式(500mA充电)，一直充直到Vbat>3.7V后，boot sys.
进入trigle charge mode,然后当电池电压充到3.7V(system weak threshod, Vweak)则退出trigle charge mode,启动kernel
2. Auto trigle charge(ATC)的触发条件： 电池电压< Vweak系统需要启动的最低电压，然后 充电电流被限制在100mA；手机不能用100mA的电流启动。
3. Two-step ATC 目前没有用，当电池电压特别低时分两步充电
a. Vbat < Vtrkl, Buck off, Bat FET closed, 充电电流50mA-200mA,小电流充电, Vtrkl一般设置区间为2.05V-2.8V
b. Vweak > Vbat > Vtrkl, Buck on, Bat FET closed,充电电流300mA-500mA, Vweak一般设置区间为2.1V-3.6V
4. 用FLCB 充电，目前CN3-ii用该方案
Buck on, Bat FET open, 用VCHG直接给电池充电，不经过Bat FET.一直用ITRKL电流给电池充电，该Itrkl电流一般多大？
当Vbat > Vweak后，系统就启动了
Fast charging
1. CC , Vweak < Vbat < Vbat_max, 用最大电流IBAT_MAX 给电池充电，IBAT_MAX的一般取值区间300mA-3000mA
2. CV, Vbat > Vbate_max, 逐渐降低充电电流Ibat,直到给电池的充电电压VPH_PWR==VDD_MAX,VDD_MAX一般设置区间3.4V-4.5V
Charging termination［依据的是充电电流大小］
1. 结束条件：Ibat(充电电流) < Iterm (with deglitching),Iterm一般设置区间35mA-276mA
2. 结果：Bat FET Open, Buck on 这样仍然可以给系统供电。如果系统需要的电流>Buck能提供的，那么Battery如何供电给系统？Bat FET Open也能反向把电流从电池输送给系统吗？
Automatic Recharge［依据的是电池电压大小］
1. 开始条件：Vbat < Vbat_det, 一般Vbat_det设置区间是3.3V-4.7V
2. 结果，又进入Fast charging阶段
OVP(过压保护)
1. 从外部USB 进入的电压保护范围[5v,28v]，可以设置该指？如果大于这最大进入电压，则第一级的保护电路生效。
2. 进入第二级保护电路，如果通过1进入的电压，大于预先SSBI-programmable设定的门限（该门限设置区间[5.5v,7v]）,如果电压大于该门限，则OVP FET会OPEN,反之。
十三、如何读写充电寄存器
1. 读寄存器
echo 0xccc > /sys/kernel/debug/spmi/spmi-0/address
echo 0xccc > /sys/kernel/debug/spmi/spmi-0/count
cat /sys/kernel/debug/spmi/spmi-0/data
写寄存器
echo 0xccc > /sys/kernel/debug/spmi/spmi-0/address
echo 0xccc > /sys/kernel/debug/spmi/spmi-0/data
2. 如何控制使用内部或外部电阻rsense.
0x3848 IADC2_BMS_ADC_CH_SEL_CTL
0x0: INTRSNS
0x1: EXTRSNS
@kernel/arch/arm/boot/dts/msm8226-cn3ii.dtsi中
&pm8226_bms {
qcom,use-external-rsense = <1>;
}
qcom,pm8226@0 {
iadc@3600 {
qcom,rsense = <10000000>;
};
};
3. 另外Huashan PM8921的路径为： sys/kernel/debug/pm8921-dbg
十四、增加识别wall charger
http://review.sonyericsson.net/#/c/534625/
十五、如何disable/enable充电
1. [User]SysFS: /sys/class/power_supply/battery/charging_enabled;
在charge only程序中，会通过miscTA 2312的值，来判断是否diable/enable充电(1:disable;非1:enable)
disableCharging@vendor/semc/hardware/power/chargemon/src/main.c
hw_disableCharging@vendor/semc/hardware/power/chargemon/src/main.c
->hw_writeSysfs(DISABLE_CHARGING_PATH, DISABLE_CHARGING); //DISABLE_CHARGING_PATH=/sys/class/power_supply/battery/charging_enabled
[Kernel]的对应处理 qpnp_batt_power_set_property@kernel/drivers/power/qpnp-charger.c
chip->charging_disabled = !(val->intval);
qpnp_chg_charge_en(chip, !chip->charging_disabled); //操作0x1049的bit7,主要控制FSM是否工作
qpnp_chg_force_run_on_batt(chip, chip->charging_disabled);//0x1049的bit7,主要控制所有与电池相关的功能(trikle charger, buck reg, batfet)是否工作。
2. Debugmenu中如何控制充电
@vendor/semc/packages/apps/debugmenu/src/com/sonyericsson/debugmenu/charging.java中会操作MiscTA 2312, 写入1 disable或0 enable;
然后下次启动运行charge only的时候会根据该Misc TA的值，enable/disbale充电。
十六、Charge only中的重要控制
1. charge only 是否进入的控制。
miscTA 2311, 0: 可以进入charge only; 2: 这次不让进入，但下次让进入; 其他(1):不让进入charge only.
2. 在charge only程序中是否充电
miscTA 2312的值，来判断是否diable/enable充电(1:disable;非1:enable)
/sys/class/power_supply/battery/charging_enabled;
3. Android USB device的控制
sys/class/android_usb/android0/enable 控制是否enable ADB功能
sys/class/android_usb/android0/functions, 设置USB支持的功能,在属性sys.usb.config，两者一致
sys/class/android_usb/android0/idProduct or idVendor, 重置USB的ID，但必须先disable USB
@vendor/semc/hardware/device/yangtze/chargemon_common.mk中有如下定义
USB_VENDOR_ID := 0fce
USB_PRODUCT_ID := e000
USB_ACCESSORY_VID := 18d1
USB_ACCESSORY_PID := 2d00
MASS_STORAGE := mass_storage
ACCESSORY := accessory
USB_ENABLE_PATH := /sys/class/android_usb/android0/enable
USB_SETFUNC_PATH := /sys/class/android_usb/android0/functions
USB_PRODUCT_ID_PATH := /sys/class/android_usb/android0/idProduct
USB_VENDOR_ID_PATH := /sys/class/android_usb/android0/idVendor
@device/somc/cn3ii/System.prop,中有 ro.usb.pid_suffix=1A9 重新设置USB PID
$在Ubantu上lsusb可以所有的usb device,其中就包括
Bus 001 Device 111: ID 0fce:51a9 Sony Ericsson Mobile Communications AB ，
idProduct,idVendor,function是在那里设定的？
@device/somc/common/files/init.sony.usb.rc
on property:sys.usb.config=mtp,adb //任何sys.usb.config的改变，就会触发后面的动作
exec /init.usbmode.sh
start adbd
setprop sys.usb.state ${sys.usb.config}
@device/somc/common/files/init.usbmode.sh
VENDOR_ID=0FCE
PID_SUFFIX_PROP=$(/system/bin/getprop ro.usb.pid_suffix)
USB_FUNCTION=$(/system/bin/getprop sys.usb.config)
get_pid_prefix ${USB_FUNCTION}中确定PID_PREFI的值，实际上是根据sys.usb.config
PID=${PID_PREFIX}${PID_SUFFIX_PROP},其中PID_PREFIX表示sony自己定义的功能 5:mtp,adb;0:mtp
echo ${VENDOR_ID} > /sys/class/android_usb/android0/idVendor
echo ${PID} > /sys/class/android_usb/android0/idProduct
@device/somc/common/sony-generic.mk
ADDITIONAL_DEFAULT_PROPERTIES += persist.sys.usb.config=mtp 但是只设置了mtp功能，没有adb功能？
@frameworks/base/services/java/com/android/server/usb/usbdevicemanager.java
函数setEnabledFunctions(..) 会根据setting UI的设置改变persist.sys.usb.config的值
if (mAdbEnabled) {
functions = addFunction(functions, UsbManager.USB_FUNCTION_ADB);
} else {
functions = removeFunction(functions, UsbManager.USB_FUNCTION_ADB);
}
SystemProperties.set("persist.sys.usb.config", functions);
有个问题，设置persist.sys.usb.config是如何传到sys.usb.config的？？？
@system/core/rootdir/init.usb.rc
on property:persist.sys.usb.config=*
setprop sys.usb.config none
setprop sys.usb.config ${persist.sys.usb.config} //两者会同步
4. 可以优化的地方
a. 现在charge eoc后，如果拔掉充电器，则会上报report key KEY_F24, charge only process会在
hw_waitForUserAction@vendor/semc/hardware/power/chargemon/src/hw.c中
hw_wakeUnlock();
i = select(max_fd + 1, &listen, NULL, NULL, &delay);//等待5秒，也只有在这5秒中，系统才有机会suspend
hw_wakeLock();
而上报KEY_F24事件，主要是解决在charge only模式下，系统深度睡眠，拔掉充电器时，charge only不会退出关机
b. 而在 check_plugin_wakelock@kernel/drivers/power/qpnp-charger.c中，当拔掉充电器时会有wakelock,超时2秒
wake_lock_timeout(&chip->somc_params.plugin_wake_lock, PLUGIN_WAKELOCK_TIME_SEC);
c. 由此，是否可以不需要上报KEY_F24给charge only呢？直需要缩短 select 的延时<2秒，就可以避免charge only不会退出关机的问题
十七、电池参数的设置（百分比，温度，电压 之间的关系）
1. @kernel/arch/arm/boot/dts/msm8226-cn3ii.dtsi
&pm8226_bms {
qcom,batt-type = <3>; //电池类型为 BATT_OEM
}
@kernel/arch/arm/mach-msm/Makefile, 当前用的是[email protected]
ifdef CONFIG_MACH_SONY_CN3II
obj-$(CONFIG_MACH_SONY_CN3II) += bms-batterydata-sleipner.o
设置电池的相关参数
set_battery_data@kernel/drivers/power/qpnp-bms.c
插值计算@kernel/arch/arm/mach-msm/baterydata-lib.c
十八、电池低电关机过程
1. 涉及关机的几个参数配置
pm8226_bms: qcom,bms {
qcom,v-cutoff-uv = <3400000>; //关机电压，但只用与计算SOC
qcom,low-soc-calculate-soc-threshold = <15>; //认为是低电的电池百分比
qcom,low-soc-calculate-soc-ms = <5000>; //低电情况下的心跳
qcom,calculate-soc-ms = <20000>;
qcom,low-voltage-threshold = <3420000>;
｝
2. 系统休眠情况下的低电关机触发
setup_vbat_monitoring@kernel/drivers/power/qpnp-bms.c 中会设置低电(高电，高温，低温)的threshold,
还有call back函数btm_notify_vbat， 如果电压低于low-voltage-threshold－VBATT_ERROR_MARGIN也就是3.4V
->configure_vbat_monitor_low
唤醒系统 wake_lock(&chip->low_voltage_wake_lock);
开始计算soc, schedule_delayed_work(&chip->calculate_soc_delayed_work, 0);
针对电池低压的情况下，重新配置参数
如果此时soc=0,则上报android 关机
3. 系统正常情况下的低电关机触发
开机后马上运行 calculate_soc_work,以后只要系统不休眠则 心跳间隔20s(soc > 15%),5s(soc < 15% & wake_lock_active(&chip->low_voltage_wake_lock))
->recalculate_soc
->calculate_state_of_charge
->adjust_soc
->very_low_voltage_check 如果电池电压<3.42v，则wake_lock(&chip->low_voltage_wake_lock);不让系统休眠， 随后心跳间隔一直继续，上报soc,如果soc=0则系统会关机。
十九、PMIC中充电部分中断的申请和处理
1. @kernel/arch/arm/boot/dts/msm-pm8226.dtsi
qcom,chgr@1000 {
status = "disabled";
reg = <0x1000 0x100>;
interrupts = <0x0 0x10 0x0>,
<0x0 0x10 0x1>,
<0x0 0x10 0x2>,
<0x0 0x10 0x3>,
<0x0 0x10 0x4>,
<0x0 0x10 0x5>, //"fast-chg-on"对应的寄存器0x1000 + 0x10 = 0x1010, 0x05表示的是第5个bit
<0x0 0x10 0x6>,
<0x0 0x10 0x7>;
interrupt-names = "vbat-det-lo",
"vbat-det-hi",
"chgwdog",
"state-change",
"trkl-chg-on",
"fast-chg-on",
"chg-failed",
"chg-done";
};
对应的是SMBBP_CHAR_SMNNP_CHAR中 0x1010 SMBBP_CHGR_INT_RT_STS 中断寄存器的bits
2. 如何引用,例子如下：
qpnp_chg_request_irqs@kernel/drivers/power/qpnp-charger.c
chip->chg_fastchg.irq = spmi_get_irq_byname(spmi,spmi_resource, "fast-chg-on");
二十、充电最大时间设置(trickle + fast charging)
1. @kernel/arch/arm/boot/dts/msm-pm8226.dtsi
pm8226_chg: qcom,charger {
qcom,tchg-mins = <150>; //表示150分钟， 取值区间[4, 512]分钟
}
2. qpnp_charger_read_dt_props@kernel/drivers/power/qpnp-charger.c
OF_PROP_READ(chip, tchg_mins, "tchg-mins", rc, 1);
qpnp_chg_hwinit
rc = qpnp_chg_tchg_max_set(chip, chip->tchg_mins); //此处往寄存器0x1061 SMBBP_CHGR_TCHG_MAX 写入
3. 如果需要disable 充电最大时间的限制，则需要操作 寄存器0x1060 SMBBP_CHGR_TCHG_MAX_EN
4. 如果需要设置trickle charge的最大时间限制，则需要操作 寄存器0x105F SMBBP_CHGR_TTRKL_MAX,
enable/disable 则需要操作 寄存器0x105E SMBBP_CHGR_TTRKL_MAX_EN,
二十一、当kernel用power_supply_changed 发送uevent 到 userspace的后续处理
1. register_android_server_BatteryService@frameworks/base/services/jni/com_android_server_BatteryService.cpp 注册的sys path如下：
/sys/class/power_supply/???/online 其中???/type=Mains //注意大小写是区分的
/sys/class/power_supply/usb/online 其中usb/type=USB
/sys/class/power_supply/battery/online 其中usb/type=Battery
/sys/class/power_supply/battery/status
/sys/class/power_supply/battery/health
/sys/class/power_supply/battery/present
/sys/class/power_supply/battery/capacity
/sys/class/power_supply/battery/voltage_now[batt_vol]
/sys/class/power_supply/battery/temp[batt_temp]
/sys/class/power_supply/battery/technology
2. 如果是power_supply_changed(&chip->batt_psy);则user space 会读取所有注册的关于battery 的sys path.
二十二、如何在kernel添加input key event给user space用
@kernel/drivers/power/qpnp-charger.c
注册/* register input device */
chip->somc_params.chg_unplug_key = input_allocate_device();
input_set_capability(chip->somc_params.chg_unplug_key, EV_KEY, KEY_F24);
chip->somc_params.chg_unplug_key->name = "qpnp_chg_unplug_key";
chip->somc_params.chg_unplug_key->dev.parent = &(spmi->dev);
rc = input_register_device(chip->somc_params.chg_unplug_key);
//input_free_device(chip->somc_params.chg_unplug_key);
使用：
input_report_key(chip->somc_params.chg_unplug_key, KEY_F24, value ? 1 : 0);
input_sync(chip->somc_params.chg_unplug_key);
二十三、chager debug
1. echo -n "file qpnp-charger.c +p" > /sys/kernel/debug/dynamic_debug/control
2. disable charging:
echo 0 > /sys/class/power_supply/battery/charging_enabled
3. WARN_ON(1) & BUG_ON
二十四、高通Case和公司DMS的关系
1. 如果遇到问题是高通的bug,提交一个case给高通
2. 在公司的DMS中创建一个主DMS, 并且assign给 coordinator, 并且在Attachments/Reference页签中的External References上
External Reference 选择Qcom
External Reference ID 输入 Qcom的case ID;
3. 如果Qcom的solution没有及时deliver, 我们可以创建一个child dms, 在Linked Records页签中单击 Create Child，在该child DMS中diliver我们自己的solution;一旦Qcom diliver了Solution,则我们自己的solution需要revert.
二十五、 Touch screen, Display新的early suspend机制
1. User space 如果需要early suspend,则需要操作 "/dev/graphics/fb0"
ioctl(fb.fd, FBIOBLANK, FB_BLANK_UNBLANK); //resume
ioctl(fb.fd, FBIOBLANK, FB_BLANK_POWERDOWN); //suspend
2. 通过操作display的ioctl, 进而控制其他需要early supend的设备,主要机制是notify的回调
do_fb_ioctl@kernel/drivers/video/fbmem.c
fb_blank(info, arg)@kernel/drivers/video/fbmem.c
fb_notifier_call_chain(FB_EVENT_BLANK, &event)@kernel/drivers/video/fbmem.c
blocking_notifier_call_chain@kernel/kernel/notifier.c
notifier_call_chain(&nh->head, val, v, nr_to_call,nr_calls)@kernel/kernel/notifier.c
nb->notifier_call(nb, val, v)@kernel/kernel/notifier.c
3. 需要和display一块suspend的设备如何注册notify, 比如touch screen
clearpad_probe@kernel/drivers/input/touchscreen/clearpad_core.c
this->fb_notif.notifier_call = synaptics_fb_notifier_callback;
rc = fb_register_client(&this->fb_notif); //注册display notify的关键函数
另外还注册正常的linux power管理的suspend/resume
static const struct dev_pm_ops synaptics_clearpad_pm = {
.suspend = synaptics_clearpad_pm_suspend,
.resume = synaptics_clearpad_pm_resume,
.suspend_noirq = synaptics_clearpad_pm_suspend_noirq,
};
以上两条suspend的路径最后都调用 synaptics_clearpad_suspend和synaptics_clearpad_resume
二十六、低电关机(soc=0%和电压低于设置的低电压 都会触发低电关机)
1. 电压低于设置电压的处理
@msm-pm8226.dtsi中
pm8226_bms: qcom,bms{
qcom,low-soc-calculate-soc-threshold = <15>; //认为是低电压的soc(15%)
qcom,low-soc-calculate-soc-ms = <5000>; //低电压情况下，计算soc 的时间间隔5s
qcom,calculate-soc-ms = <20000>; //正常情况下，计算soc 的时间间隔20s
qcom,v-cutoff-uv = <3400000>;//用于计算soc
qcom,low-voltage-threshold = <3420000>;//用于设置关机低电压
}
2. 系统一开机会马上运行calculate_soc_work，然后间隔20s或5s 循环执行，只要系统不suspend,该schedule work会一直执行，如果s计算的soc有变化还会power_supply_changed上报给用户空间，如果此时soc=0%则用户空间会强制关机shut down.
3. 另外还有一种情况，就是系统已经suspend,但电池电压小于预先设置的门限电压，会触发notify也就是[email protected]，如果是低电状态则继续调用configure_vbat_monitor_low,其中会wake_lock(&chip->low_voltage_wake_lock);让系统不再suspend,马上开始运行calculate_soc_work，也就是把soc=０%的信息赶快通知给user space,好执行低电关机。具体分析如下：
３.1 设置低电notify的相关参数，[email protected]
->[email protected]; 设置adc channel的监控设置
chip->vbat_monitor_params.low_thr = chip->low_voltage_threshold; //低电压门限设置
chip->vbat_monitor_params.high_thr = chip->max_voltage_uv - VBATT_ERROR_MARGIN; //高电压门限设置
chip->vbat_monitor_params.state_request = ADC_TM_HIGH_LOW_THR_ENABLE; //触发的类型 满足高低电压门限时触发
chip->vbat_monitor_params.channel = VBAT_SNS;
chip->vbat_monitor_params.btm_ctx = (void *)chip;
chip->vbat_monitor_params.timer_interval = ADC_MEAS1_INTERVAL_1S; //Polling 时间
chip->vbat_monitor_params.threshold_notification = &btm_notify_vbat; //回调函数
rc = qpnp_adc_tm_channel_measure(&chip->vbat_monitor_params);
3.2 @qpnp-adc-tm.c
notify_adc_tm_fn是其中关键的处理函数
->notify_clients(adc_tm)-->adc_tm->btm_param->threshold_notification(ADC_TM_LOW_STATE, adc_tm->btm_param->btm_ctx);
qpnp_adc_tm_probe中初始化INIT_WORK(&adc_tm->sensor[sen_idx].work, notify_adc_tm_fn);
初始化qpnp_adc_tm_low_thr_isr中断处理函数
rc = devm_request_irq(&spmi->dev, adc_tm->adc->adc_low_thr_irq,
qpnp_adc_tm_low_thr_isr,IRQF_TRIGGER_RISING, "qpnp_adc_tm_low_interrupt", adc_tm);
一旦电压低于chip->vbat_monitor_params.low_thr则触发qpnp_adc_tm_low_thr_isr，然后schedule_work(qpnp_adc_tm_low_thr_work);最后会调用qpnp_adc_tm_read_status，又会触发schedule_work(&adc_tm->sensor[sensor_num].work);即notify_adc_tm_fn函数，从而会发notify消息给BMS的btm_notify_vbat->configure_vbat_monitor_low和power_supply_changed
二十七、读取的adc电压和电池温度的关系
1. @kernel/drivers/hwnon/qpnp-adc-common.c
计算电池温度和电压关系的函数qpnp_adc_scale_batt_therm
电池温度和电压关系的对应表adcmap_btm_threshold[], 该表需要电池team提供
static const struct qpnp_vadc_map_pt adcmap_btm_threshold[] = {
{-300, 1686}, ...
{0, 1342}, ...
{450, 619}, ... {温度45度，电压619mv}
}
通过线性逼近插值计算精度可以到达0.1Degc
2. 读取电池温度的流程
get_prop_batt_temp@kernel/drivers/power/qpnp-charger.c
qpnp_vadc_read(LR_MUX1_BATT_THERM, &results)@kernel/drivers/hwmon/qpnp-adc-voltage.c
qpnp_vadc_conv_seq_request(ADC_SEQ_NONE, channel, result)@kernel/drivers/hwmon/qpnp-adc-voltage.c
vadc_scale_fn[scale_type].chan(result->adc_code,vadc->adc->adc_prop, vadc->adc->amux_prop->chan_prop, result)@qpnp-adc-voltage.c
qpnp_adc_scale_batt_therm@kernel/drviers/hwmon/qpnp-adc-common.c
重点分析[email protected]
a. vadc->adc->adc_channels 的赋值
[email protected]
->adc_qpnp->adc_channels = adc_channel_list;其中adc_channel_list是分析读取msm8226-cn3ii.dtsi中&pm8226_vadc的节点内容，其中有
chan@30 {
label = "batt_therm";
reg = <0x30>; //channel_num 通道号，也就是需要读取的channel,针对battery thermal是LR_MUX1_BATT_THERM＝48，正好匹配
qcom,decimation = <0>;
qcom,pre-div-channel-scaling = <0>;
qcom,calibration-type = "ratiometric";
qcom,scale-function = <1>; //adc_scale_fn的ID,也就是scale_type
qcom,hw-settle-time = <2>;
qcom,fast-avg-setup = <0>;
};
->vadc_scale_fn的定义
static struct qpnp_vadc_scale_fn vadc_scale_fn[] = {
[SCALE_DEFAULT] = {qpnp_adc_scale_default},
[SCALE_BATT_THERM] = {qpnp_adc_scale_batt_therm}, //battery thermal的scale函数[email protected]
[SCALE_PMIC_THERM] = {qpnp_adc_scale_pmic_therm},
[SCALE_XOTHERM] = {qpnp_adc_tdkntcg_therm},
[SCALE_THERM_100K_PULLUP] = {qpnp_adc_scale_therm_pu2},
[SCALE_THERM_150K_PULLUP] = {qpnp_adc_scale_therm_pu1},
[SCALE_QRD_BATT_THERM] = {qpnp_adc_scale_qrd_batt_therm},
};
init.rc文件中执行顺序如下：
early-init -> init -> early-fs -> fs -> post-fs ->early-boot -> boot。