Adafruit MAX17048 Usermod (LiPo & LiIon Battery Monitor & Fuel Gauge)

This usermod reads information from an Adafruit MAX17048 and outputs the following:

Battery Voltage
Battery Level Percentage

Dependencies

Data is published over MQTT - make sure you've enabled the MQTT sync interface.

Compilation

Add "MAX17048_v2" to your platformio.ini environment's custom_usermods and build. To enable, compile with USERMOD_MAX17048 define in the build_flags (e.g. in platformio.ini or platformio_override.ini) such as in the example below:

ini

[env:usermod_max17048_d1_mini]
extends = env:d1_mini
custom_usermods = ${env:d1_mini.custom_usermods} MAX17048_v2

Configuration Options

The following settings can be set at compile-time but are configurable on the usermod menu (except First Monitor time):

USERMOD_MAX17048_MIN_MONITOR_INTERVAL (the min number of milliseconds between checks, defaults to 10,000 ms)
USERMOD_MAX17048_MAX_MONITOR_INTERVAL (the max number of milliseconds between checks, defaults to 10,000 ms)
USERMOD_MAX17048_FIRST_MONITOR_AT

Additionally, the Usermod Menu allows you to:

Enable or Disable the usermod
Enable or Disable Home Assistant Discovery (turn on/off to sent MQTT Discovery entries for Home Assistant)
Configure SCL/SDA GPIO Pins

API

The following method is available to interact with the usermod from other code modules:

getBatteryVoltageV read the last battery voltage (in Volt) obtained from the sensor
getBatteryPercent reads the last battery percentage obtained from the sensor

MQTT

MQTT topics are as follows (<deviceTopic> is set in MQTT section of Sync Setup menu):

Measurement type	MQTT topic
Battery Voltage	`<deviceTopic>/batteryVoltage`
Battery Percent	`<deviceTopic>/batteryPercent`

Authors

Carlos Cruz @ccruz09

Revision History

Jan 2024

Added Home Assistant Discovery
Implemented PinManager to register pins
Added API call for other modules to read battery voltage and percentage
Added info-screen outputs
Updated readme.md