Tasmota/lib/lib_i2c/DFRobot_MAX17043/python/raspberry/README_CN.md

DFRobot_MAX17043

• English Version

Gravity 3.7V锂电池电量计使用Gravity I2C接口，超低工作电流，通过Maxim专利算法，实时跟踪电池的相对充电状态(SOC，State-Of-Charge)，无需充放电学习过程，无积累误差，即插即用，准确地测量锂电池的当前电压和剩余电量。模块预留低电量报警中断引脚，当电池电量低于指定电量时，该引脚产生一个下跳脉冲，触发主控的外部中断。

产品链接（https://www.dfrobot.com.cn/goods-1743.html）

SKU: DFR0563

目录

• 概述
• 连接
• 库安装
• 方法
• 兼容性
• 历史
• 创作者

概述

提供 python 库，用于通过 I2C 读取和解释 MAX17043 数据。

连接

相同颜色的线连接在一起，我们只举例说明主板是如何连接到电量计的。接线时要注意管脚的对应关系，接线图如下：

• Raspberry Pi
  
  

库安装

1. 下载库至树莓派，要使用这个库，首先要将库下载到Raspberry Pi，命令下载方法如下:
   

sudo git clone https://github.com/DFRobot/DFRobot_MAX17043

2. 打开并运行例程，要执行一个例程demo_x.py，请在命令行中输入python demo_x.py。例如，要执行 demo_read_and_int.py例程，你需要输入:
   

python demo_read_and_int.py 
或 
python2 demo_read_and_int.py 

方法

  '''!
    @brief 构造MAX17043对象
    @return MAX17043 初始化
    @retval 0     成功
    @retval -1    失败
  '''
  def begin(self):
    
  '''!
    @brief 读电池电压，单位： mV
    @return 电池电压，单位：mV
  '''    
  def read_voltage(self):
    
  '''!
    @brief 读取剩余电池容量的百分比
    @return 剩余电池容量的百分比
  '''
  def read_percentage(self):
  '''!
    @brief 设置 MAX17043 中断阈值
    @param per       中断阈值范围： %1 - 32% (整数)
  '''
  def set_interrupt(self, per):
    
  '''!
    @brief 清除 MAX17043 中断.
  '''
  def clear_interrupt(self):
    
  '''!
    @brief 设置 MAX17043 进入睡眠模式
  '''
  def set_sleep(self):
    
  '''!
    @brief 唤醒 MAX17043
  ''' 
  def set_wakeup(self):

兼容性

主板	通过	未通过	未测试	备注
RaspberryPi2			√
RaspberryPi3			√
RaspberryPi4	√

• Python 版本

Python	通过	未通过	未测试	备注
Python2	√
Python3			√

历史

• 2018/04/14 - 1.0.0 版本

创作者

Written by ouki.wang(ouki.wang@dfrobot.com), 2018. (Welcome to our website)