Skip to content

Hootie81/STC3117

Repository files navigation

Updtated 17/6/2016 by C.Huitema to suit STC3117

STC3117 GenericDriver

STC3117 fuel gauge Open source generic driver (STC3117 Generic Driver)

Device under test:

Device: STC3117 Battery Gas gage.
Manufacturer: STMicroelectronics

Hardware:

Can be used on any platform with I2C Master (pin SCL & SDA) connected to I2C Slave of STC3117 device.
For instance: STM32 Nucleo board, STM32 discovery board, Arduino, ...

The STC3117 is designed to be power supplied directly from the battery. In this case, the STC3115 remains active even if the whole platform is in standby or powered off.

SW Requirements:

Implement the I2C driver depending on your platform.

SW Configuration:

Update the configuration file depending on the battery characteristics (Capacity, Internal Impedance, battery default OCV curve, ...), and the schematic (Resistor value used for current sensing)

SW Use:

The host driver access the STC3117 registers via I2C every 5s typically (or longer, up to 30s).
So a 5s timer is required to be implemented.

The STC3117 monitors the battery continuously.
But It is not needed for the host to access the STC3117 more often because the Battery charging/discharging variation is very slow.
However, even if the driver is access more frequently (every 1s), the STC3117 algorithm still works properly.

Battery State of Charge:

The STC3117 driver use the ST OptimGauge(tm) algorithm to give the Optimum accuracy regarding the estimation of the battery state of charge (in %).

Notes:

this version is an updated version of the STC3115GenericDriver found here: https://github.com/st-sw/STC3115GenericDriver/

Source code Examples are based on STSW-BAT001 package: STC3117 Open source driver.

The core of source code in this repository is an updated and corrected version of the one provided on manufacturer website.

Issues:

For any issues, please refer to the FAQ first.

A short FAQ is available here: https://github.com/st-sw/STC3115GenericDriver/wiki/STC3115-FAQ

About

Driver for STC3117

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published