PB-LITE code

Micropython and Arduino code, just copy and paste...

Choose your language of choice.

Full code.

Code for reading battery percentage and checking charge status.

from machine import Pin, I2C
import time

MAX_i2c = I2C(0, scl=Pin(1), sda=Pin(0))  # change to your pins of choice
MAX17048G_ADDR = 0x36

CHRG = Pin(13, Pin.IN, Pin.PULL_UP)  # change to your pins of choice
DONE = Pin(14, Pin.IN, Pin.PULL_UP)  # change to your pins of choice

def read_battery_percentage():
    try:
        MAX_i2c.writeto(MAX17048G_ADDR, bytes([0x04]))
        percentage = MAX_i2c.readfrom(MAX17048G_ADDR, 2)
        percentage = int.from_bytes(percentage, 'big')
        
        battery_percentage = (percentage >> 8) & 0xFF
        return battery_percentage
    except Exception as e:
        print("Error reading battery percentage:", str(e))
        return None

while True:
    battery_percentage = read_battery_percentage()
    print(str(battery_percentage) + "%")
    if DONE.value() == 0:
        if CHRG.value() == 0:
            print("charging")
        else:
            print("done charging")
        
    time.sleep(2)

Only reading battery percentage.

Code for only reading battery percentage.

from machine import Pin, I2C
import time

MAX_i2c = I2C(0, scl=Pin(1), sda=Pin(0))  # change to your pins of choice
MAX17048G_ADDR = 0x36

def read_battery_percentage():
    try:
        MAX_i2c.writeto(MAX17048G_ADDR, bytes([0x04]))
        percentage = MAX_i2c.readfrom(MAX17048G_ADDR, 2)
        percentage = int.from_bytes(percentage, 'big')
        
        battery_percentage = (percentage >> 8) & 0xFF
        return battery_percentage
    except Exception as e:
        print("Error reading battery percentage:", str(e))
        return None

while True:
    battery_percentage = read_battery_percentage()
    print(str(battery_percentage) + "%")
        
    time.sleep(2)

Only checking charge status.

Code for only checking charge status.

from machine import Pin
import time

CHRG = Pin(13, Pin.IN, Pin.PULL_UP)  # change to your pins of choice
DONE = Pin(14, Pin.IN, Pin.PULL_UP)  # change to your pins of choice


while True:
    if DONE.value() == 0:
        if CHRG.value() == 0:
            print("charging")
        else:
            print("done charging")
        
    time.sleep(2)

Advanced.

Code for reading battery percentage and checking charge status. With even more advanced features like checking charge/discharge rate, undervoltage, overvoltage, reset, SOC low, and SOC change

from machine import Pin, I2C
import time

# Initialize I2C
MAX_i2c = I2C(0, scl=Pin(1), sda=Pin(0))  # Adjust pins as needed
MAX17048G_ADDR = 0x36

# Initialize charging pins
CHRG = Pin(13, Pin.IN, Pin.PULL_UP)  # Adjust pins as needed
DONE = Pin(14, Pin.IN, Pin.PULL_UP)  # Adjust pins as needed

# Set the battery design capacity
design_capacity = 1000  # mAh

def initialize_max17048():
    design_capacity_bytes = design_capacity.to_bytes(2, 'big')
    MAX_i2c.writeto_mem(MAX17048G_ADDR, 0x18, design_capacity_bytes)

def read_battery_percentage():
    try:
        soc_bytes = MAX_i2c.readfrom_mem(MAX17048G_ADDR, 0x04, 2)
        soc = int.from_bytes(soc_bytes, 'big')
        
        battery_percentage = soc >> 8
        fractional_percentage = soc & 0xFF
        
        precise_percentage = battery_percentage + (fractional_percentage / 256.0)
        return precise_percentage
    except Exception as e:
        print("Error reading battery percentage:", str(e))
        return None

def read_crate():
    try:
        crate_bytes = MAX_i2c.readfrom_mem(MAX17048G_ADDR, 0x16, 2)
        crate = int.from_bytes(crate_bytes, 'big')
        
        if crate & 0x8000:
            crate -= 1 << 16
        crate_per_hr = crate * 0.208
        return crate_per_hr
    except Exception as e:
        print("Error reading charge/discharge rate:", str(e))
        return None

def read_status():
    try:
        status_bytes = MAX_i2c.readfrom_mem(MAX17048G_ADDR, 0x1A, 2)
        status = int.from_bytes(status_bytes, 'big')
        
        overvoltage = bool(status & (1 << 15))
        undervoltage = bool(status & (1 << 14))
        soc_change = bool(status & (1 << 13))
        soc_low = bool(status & (1 << 12))
        reset = bool(status & (1 << 11))
        
        return {
            'Overvoltage': overvoltage,
            'Undervoltage': undervoltage,
            'SOC Change': soc_change,
            'SOC Low': soc_low,
            'Reset': reset
        }
    except Exception as e:
        print("Error reading status:", str(e))
        return None

initialize_max17048()

while True:
    battery_percentage = read_battery_percentage()
    if battery_percentage is not None:
        print(f"Battery: {battery_percentage:.2f}%")
    else:
        print("Failed to read battery percentage")
    
    crate_per_hr = read_crate()
    if crate_per_hr is not None:
        if crate_per_hr > 0:
            print(f"Charging at {crate_per_hr:.2f}%/hr")
        else:
            print(f"Discharging at {abs(crate_per_hr):.2f}%/hr")
    else:
        print("Failed to read charge/discharge rate")
    
    status = read_status()
    if status is not None:
        print(f"Status: {status}")
    else:
        print("Failed to read status")
    
    if DONE.value() == 0:
        if CHRG.value() == 0:
            print("Charging")
        else:
            print("Done charging")
        
    time.sleep(2)