fuel_gauge_calib - bruno-beloff/scs_mfr GitHub Wiki

docs > software repositories > scs_mfr > commands > calibration


DESCRIPTION

The fuel_gauge_calib utility is used to interrogate or update the fuel gauge parameters on an attached battery pack.

Parameters are found automatically though a learning process run by the fuel gauge throughout its lifetime. These values are saved to the file system by the PSU monitor every time the parameters change. The battery pack model incorporates a set of parameter values gained through this process on test systems, referred to as the default parameters.

When a new fuel gauge is put into use, it should be initialised with these values using the fuel_gauge_calib utility --initialise flag - this sets both the parameters and the fuel gauge configuration. If a max17055_params.json configuration file has been stored for this system, then it is used to initialise the parameters. Otherwise, the default parameters for the configured battery pack are used.

SYNOPSIS

fuel_gauge_calib.py { { -c | -d | -l | -r | -z { D | L } } | { -f | -s | -g | -p } [-i INTERVAL] } [-v]

Options
--version show program's version number and exit
-h, --help show this help message and exit
-c, --gauge-conf report fuel gauge configuration
-d, --dflt-learned report battery's default params
-l, --host-learned read params from host
-r, --remove-learned delete params from host
-z INIT, --init=INIT initialise gauge with configuration and Default or Learned params
-g, --gauge-learned read learned params from gauge
-s, --save-learned save learned params to host
-f, --fuel report fuel status
-p, --psu report psu status
-i INTERVAL, --interval=INTERVAL sampling interval
-v, --verbose report narrative to stderr

EXAMPLES

./fuel_gauge_calib.py -cv

FILES

~/SCS/conf/max17055_params.json

DOCUMENT EXAMPLE - CONFIGURATION

{"des-cap": 3000, "sense-res": 0.01, "chrg-term": 10, "empty-v-target": 3.3, "recovery-v": 3.8, "chrg-v": 0, "batt-type": 0}

DOCUMENT EXAMPLE - LEARNED PARAMS

{"calibrated-on": "2021-01-03T09:25:52Z", "r-comp-0": 255, "temp-co": 9278, "full-cap-rep": 3000, "full-cap-nom": 3000, "cycles": 150}

DOCUMENT EXAMPLE - FUEL

{"in": false, "chrg": {"%": 1.0, "mah": 0}, "tte": null, "ttf": null, "v": 3.8, "curr": -486, "g-tmp": 25.5, "cap": 0, "cyc": 2.0}

DOCUMENT EXAMPLE - PSU

{"src": "Cv1", "standby": false, "in": false, "pwr-in": 0.1, "chgr": "TFFT", "batt": {"chg": 1, "tte": null, "ttf": null}, "prot-batt": 3.8}

SEE ALSO

scs_dev/psu_monitor

scs_mfr/psu_conf

RESOURCES

https://www.maximintegrated.com/en/design/technical-documents/userguides-and-manuals/6/6365.html