+MSW_DRV_Battery_Charging_V1.00

MSTAR DRIVEREMMI Battery & Charging概要1.硬件•充电电路图2.软件•充电的驱动相关信息介绍•充电事件请求信息介绍•软件设计•接口介绍•单元测试•集成测试•ADC 校准•用户可以修改的内容•电池充电概图充电电路图Battery ArchitectureBattery TaskABB TaskADCADC requestPMUS e n d d a t aCharging Battery statusAthenaI2CPMUADCSet ChargerIncenseCharger detectcharger detect充电驱动相关信息介绍(1/3)•充电相关函数(Battery 模块) 主要包括以下内容：-Service layer (API)(给上层)-提供给上层来获取电池状态。

-Charging manager-电池充电规则设定-电池状态报告-Battery event 处理-电池相关的事件，如：ADC 测量请求, ADC done 事件通知等。

-根据需要，向上层报告电池状态，如：充电开、关等事件。

充电驱动相关信息介绍(2/3)•充电规则-硬件-Trickle mode (Vbat < 2.6V)-Pre-charge mode (Vbat < 3.3V)（最低开机电压（3.4v ））-软件-CC mode (Vbat > 3.3V)（只是给硬件设置CC 或CV 的电压范围）-CV mode (when Vbat is closing to CV target set by SW)•电池充电满的标准–通过函数bat_DetectFullBattery()来判定（bat_pars.c ）。

–电池充满条件-2个*(V max -V bat )<=200mV (eg: V max =4200)*I chg <Battery_Capacity/10充电驱动相关信息介绍(3/3)•充电管理–充电管理主要在函数_MdlBatManageCharging ()里面进行（bat_pars.c ）。

–充电的状态列表*CHARGER_UNPLUGGED : 没有插充电器*TRICKLE_CHARGING : 充电器刚插进去时的状态，以小电流进行充电（100ma ）。

*FAST_CHARGING : 充电时主要维持的状态，大电流充电模式。

（100ma~500ma ）*DISCHARGE_WAIT : 充电器插入时，MMI 电池显示满图标（电池满的时候插入充电器）。

*SECURITY_WAIT : 充电满时进入的状态。

security timer starts *NO_CHARGING : 充电时，有硬件告警后进入的状态（如：过压保护）*ENOUGH_DISCHARGE_WAIT : security timer 完成后进入的状态。

充电事件请求信息介绍•电池充电相关函数在driver 层实现，为下列服务的应用层提供应用接口，例如给MMI 提供接口-Battery status service calls-To get battery level-To get charger status(充电器是否插入状态)-To get charging status （当前充电状态）-To get battery voltage-If task communication is supported in MMI-Periodic battery level report (including low-battery indication)-Charger plug-in indication and plug-out indication-Charging on indication (start charging) and charging off indication (charging complete)•The charging function is used to charge a battery while charger is plugged.-Pre-charge mode control-Not switch on power until Vbat is higher than 3.3V or more （正常使用，电压可低至3.3v ，充电开机电压为3.4v ）-Full battery control-Vbat is closing to CV target after charging软件设计BAT_TASK MAEBatteryBattery Model listener更新电池显示状态,充电动画等信息SEND EVT （event 定义在mae_battery.h 中）Events are for Battery Model to notifytheir listener （）MSG产产生中断Custom.c--MdlBatAcquireBa tteryData(Sleeped Frames)SleepedFr ames 为周期，处理消息BAT_MEASURE_MSG;BAT_CHARGER _UNPLUGGED;BAT_MEASURE_MSG;BAT_CHARGER _PLUGGED;软件设计(1/3)•接口-Service call•vm_batMmiBatteryLevel_t vm_batGetLevel (void);•bool vm_batGetChargerState (void);•bool vm_batGetChargingState (void);•u16 vm_batGetVoltage(void);•u16 vm_batGetChargerVoltage(void);•u16 vm_batGetChargerCurrent(void);•s16 vm_batGetBatteryTemp(void); (-1 is returned)•s16 vm_batGetBackupBatteryVoltage(void); //("-1" is returned)-Battery status indication (in case of task communication supported)•void vm_batSubscribe(u8 mailbox)•Message type;typedef enum {BAT_LEVEL = VM_BAT_BASE, ///< message sent to indicated the battery level BAT_CHARGER_ON, ///< 当有充电器插入时，发送此消息BAT_CHARGER_OFF, ///< 当有充电器拔出时，发送此消息BAT_CHARGING_ON, ///< 当充电开始的时候，发送此消息BAT_CHARGING_OFF, ///< 当充电结束的时候，发送此消息BAT_ALARM, ///< 当有电池报警时，发送此消息BAT_LAST_EXT_MSG软件设计(2/3)•充电功能分两个模块-Battery 模块-Incense 模块•Battery 模块-API: 提供电池状态-充电管理: 充电控制-事件/请求/Timer 处理: 处理电池相关的事情与请求。

-Timer 管理: timer 事件处理(发送timer 相关的消息与监控充电状态）。

•Incense 模块-API: 提供Incense 状态-Incense 事件处理-Incense ISR: mask Incense INTCharging managerEvent/Request/Timer handlerIncense APIIncense Event Handler (Task)DRV LAYER(区别不同平台软件设计(3/3)•ADC 数据请求–An example of working model of Battery Module and Incense Module （ACD 500ms ）Upper Task Battery Task Abb Task Incense ISRDrvBattStartDataAcquisition()VM_ABB_ADC_RESULT_INDincense_irq_msg_handler()_MdlBatGetAndSumBatteryData()If report软件接口(1/3) –文件列表•Incense 模块-DRV –drv_abb.c,incense_audio.c,incense_charg.c,incense_irq.c,drv_abb.c,ince nse_charg.h,incense_drv.h,etc.-HAL –hal_adc.c -mdl_abb_task.c•Athena 模块-HAL –hal_athena.c,hal_athena.h,hal_athena_reg.h -DRV –athena.c,athena.h athena_reg.h•Batt 模块-HAL -hal_batt_athena_charg.c,hal_batt_charg.h -DRV -Drv_batt.c,drv_batt.h,vm_batt.h-MIDDLEWARE -bat_cork.c, bat_pars.c,bat_msg.h,bat_pars.h,etc.软件接口(2/3) –Incense 模块•Abb Task 入口点(mdl_abb_task.c)-abb_Task()•Incense IRQ Handler (incense_irq.c)-DrvIncenseIrqHandler ()-DrvIncenseIrqPostHandler ()-incense_mask_irq()-incense_clear_irq()-incense_unmask_irq()•Athena ADC Function (athena.c)-DrvPmuAdcAcquire()-DrvPmuAdcConversionDone()-etc.•Athena Charger Function (hal_athena_adc.c)-_HalPmuSetVbatInitialVaules()-_HalPmuAdcConfigureConversion()-_HalPmuAdcReadResult()-HalPmuAdcDoneHandler()-HalPmuGetVbatValidADC()-HalPmuDetectBatteryPresence() -etc.•Athena Register Access Function (hal_athena.c)-Athena_ReadI2C()-Athena_WriteI2C()软件接口(3/3) –Batt 模块bat_pars.c•Batt Task 进入点: bat_thread_Init()/bat_Task()•Batt 模块初始化: MdlBatInit()•Batt Task 的消息处理: _MdlBatParse()•充电管理: _MdlBatManageCharging()•电池状态报告: _MdlBatReportStatus()•电池相关的API-MdlBatSubscribe()-MdlBatGetLevel()-MdlBatGetChargerState()-MdlBatGetChargingState()-MdlBatGetVoltage()-MdlBatGetChargerVoltage()-MdlBatGetChargerCurrent()Drv_batt.c•Battery Module Utilities单元测试•接口-周期性汇报电池level-电池level 和电池电压之间的映射-Battery level determination-充电器插入和拔出的通知-充电开/关通知(电池满通知(SW) )•充电规则-ADC 数据请求(减小Vbat 测量误差)-充电流程-电池满测量(HW)•系统特性-充电开机-开机电压-关机电压综合测试•关机时-插入充电器开机-充电动画-电池满通知-拔充电器后关机•开机时-如果没有充电器插入-battery level and battery 电压映射-如果充电器插入-充电器插入通知-充电动画-充电满通知-充电器拔出通知•电压过低时-电池低电压告警-电压过低，自动关机ADC Calibration•目的是提供一个系数来补偿ADC 以减少误差。