Skip to content

qingehao/CW2015

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CW2015 软件包

1 介绍

CW2015是一款小尺寸,无需检流电阻的锂电池电量计量芯片。芯片持续监测电池在充电/放电状态下的电压,运行专利“FastCali”电量计算法,结合电池建模信息,可准确计算电池剩余电量。CW2015适用于包括锂锰,锂钴和聚合物等多种类型的锂电池应用。

1.1 目录结构

名称 说明
cw2015.h 电量计IC使用头文件
cw2015.c 电量计IC使用源代码
SConscript RT-Thread 默认的构建脚本
README.md 软件包使用说明
CW2015_datasheet.pdf 官方数据手册

1.2 许可证

CW2015 软件包遵循 Apache-2.0 许可,详见 LICENSE 文件。

1.3 依赖

依赖 RT-Thread I2C 设备驱动框架。

2 获取软件包

使用 CW2015 软件包需要在 RT-Thread 的包管理器中选择它,具体路径如下:

RT-Thread online packages
    peripheral libraries and drivers  --->
        [*] cw2015: fuel gauging system IC for Lithium-ion(Li+) Battery  --->
        [*] Enable auto update battery information                                               Version (latest)  --->

每个功能的配置说明如下:

  • cw2015: fuel gauging system IC for Lithium-ion(Li+) Battery:选择使用 cw2015 软件包;
  • Enable auto update battery information :使用独立线程自动更新电池容量及电压。
  • Version:配置软件包版本,默认最新版本。

然后让 RT-Thread 的包管理器自动更新,或者使用 pkgs --update 命令更新包到 BSP 中。

3 使用 CW2015 软件包

按照前文介绍,获取 CW2015 软件包后,就可以按照 下文提供的 API 使用传感器 cw2015Finsh/MSH 命令进行测试,详细内容如下。

3.1 API

3.1.1 电池信息结构体

struct cw_battery {
	uint8_t usb_online;
	uint32_t capacity;
	uint32_t voltage;
	uint8_t alt;
};
extern struct cw_battery  cw_bat;

该结构体在cw2015.h中使用extern声明,用户在引用头文件后便可使用该结构体。

参数 描述
usb_online 是否插入充电器,需由用户应用更新此值。
capacity 电池容量,范围 1% - 100%,单位 %
voltage 电池电压,单位 0.001 V
alt 暂未用到

3.1.2 初始化

int cw_init(void);

初始化设备

返回 描述
=RT_EOK 初始化成功
!=RT_EOK 初始化失败

3.1.3 更新电池电压

int8_t cw_update_vol(void)

更新一次电池电压值,并赋值到cw_bat.voltage中

返回 描述
1 失败
0 成功

3.1.4 更新电池容量

cw_update_capacity(void)

更新一次电池电压值,并赋值到cw_bat.capacity中

参数 描述
1 失败
0 成功

3.1.5 释放ALRT_PIN

uint8_t cw_release_alrt_pin(void)

释放引脚中断,该函数在触发低电量中断后必须调用。

返回 描述
-1 失败
!=-1 成功

3.1.6 设置ATHD值

int8_t cw_set_athd(uint8_t new_athd);

设置新的ATHD值

参数 描述
new_athd 新的athd值
返回 描述
0 成功
-1 失败

3.2 Finsh/MSH 测试命令

cw2015 软件包提供了丰富的测试命令,项目只要在 RT-Thread 上开启 Finsh/MSH 功能即可。在输入battery后便可得到详细信息

msh >battery
battery get vol   - get battery voltage
battery get cap   - get battery capacity
battery set athd  - set battery ATHD
msh >battery get vol
battery voltage:3.825 V
msh >battery get cap
battery capacity:66%

4 注意事项

cw2015电量计使用前需拿到自己电池的建模信息,这个模型信息在cw2015.h中。

/*电池建模信息,客户拿到自己电池匹配的建模信息后请替换*/
static unsigned char cw_bat_config_info[SIZE_BATINFO] = {
0X15,0X7E,0X7C,0X5C,0X64,0X6A,0X65,0X5C,0X55,0X53,0X56,0X61,0X6F,0X66,0X50,0X48,
0X43,0X42,0X40,0X43,0X4B,0X5F,0X75,0X7D,0X52,0X44,0X07,0XAE,0X11,0X22,0X40,0X56,
0X6C,0X7C,0X85,0X86,0X3D,0X19,0X8D,0X1B,0X06,0X34,0X46,0X79,0X8D,0X90,0X90,0X46,
0X67,0X80,0X97,0XAF,0X80,0X9F,0XAE,0XCB,0X2F,0X00,0X64,0XA5,0XB5,0X11,0XD0,0X11
};

该模型信息与电路原理图,具体PCB走线的长度,线阻都是有关系的,不可通用。

5 联系方式

About

锂电池电量计驱动

Resources

Stars

Watchers

Forks

Packages

No packages published