Add fuel gauge max17048 (#459)

This pull request introduces a new part definition for the MAX17048
1-cell Li-Ion fuel gauge, along with its integration into the package
exports. The main changes are the addition of a new device class with
proper electrical modeling, footprint assignment, and typical usage
block, as well as updating the package's `__init__.py` to make the part
available for import.

New part implementation:

* Added the `Max17048_Device` class in `FuelGauge_Max17048.py`, modeling
the MAX17048 fuel gauge with ports for power, ground, I2C, alert, and
QSTRT, including electrical characteristics and footprint assignment.
* Created the `Max17048` block in `FuelGauge_Max17048.py`, which wraps
the device with a decoupling capacitor, QSTRT grounding, alert pull-up
resistor, and default I2C address assignment for typical usage.

Package integration:

* Updated `__init__.py` to export the new `Max17048` part, making it
available for use elsewhere in the codebase.

Author: Suke0811

edg/parts/FuelGauge_Max17048.py

@@ -0,0 +1,75 @@
+from typing_extensions import override
+from ..abstract_parts import *
+from .JlcPart import JlcPart
+
+
+class Max17048_Device(InternalSubcircuit, FootprintBlock, JlcPart):
+    def __init__(self) -> None:
+        super().__init__()
+        self.pwr = self.Port(
+            VoltageSink(
+                voltage_limits=Range(2.5, 4.5),
+                current_draw=(0.5, 40) * uAmp,  # ~23 uA typ
+            )
+        )
+        self.gnd = self.Port(Ground())
+
+        # I2C target interface
+        # I/O tolerant to 5.5 V independent of pwr (per datasheet)
+        dio_model = DigitalBidir.from_supply(
+            self.gnd, self.pwr, voltage_limit_abs=(-0.3, 5.5) * Volt, input_threshold_abs=(0.5, 1.4) * Volt
+        )
+        self.i2c = self.Port(I2cTarget(dio_model, addresses=[0x36]))
+
+        self.alrt = self.Port(
+            DigitalSource.low_from_supply(self.gnd),
+            optional=True,
+        )
+
+        self.qstrt = self.Port(Passive())
+
+    @override
+    def contents(self) -> None:
+        super().contents()
+        self.footprint(
+            "U",
+            "Package_DFN_QFN:DFN-8-1EP_2x2mm_P0.5mm_EP0.8x1.6mm",
+            {
+                "1": self.gnd,
+                "3": self.pwr,
+                "4": self.gnd,
+                "5": self.alrt,
+                "6": self.qstrt,
+                "7": self.i2c.scl,
+                "8": self.i2c.sda,
+                "9": self.gnd,
+            },
+            mfr="Analog Devices (Maxim)",
+            part="MAX17048",
+            datasheet="https://www.analog.com/media/en/technical-documentation/data-sheets/MAX17048-MAX17049.pdf",
+        )
+        self.assign(self.lcsc_part, "C2682616")
+        self.assign(self.actual_basic_part, False)
+
+
+class Max17048(DefaultExportBlock):
+    """1-Cell Li-Ion voltage based fuel gauge. Senses its pwr as the battery voltage."""
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.ic = self.Block(Max17048_Device())
+
+        self.pwr = self.Export(self.ic.pwr, [Power])
+        self.gnd = self.Export(self.ic.gnd, [Common])
+        self.i2c = self.Export(self.ic.i2c)
+        self.alrt = self.Export(self.ic.alrt, optional=True)
+
+    @override
+    def contents(self) -> None:
+        super().contents()
+
+        # Required local decoupling 0.1 uF from pwr to GND
+        self.pwr_cap = self.Block(DecouplingCapacitor(0.1 * uFarad(tol=0.2))).connected(self.gnd, self.ic.pwr)
+
+        # Tie QSTRT to ground unless otherwise needed
+        self.connect(self.ic.qstrt.adapt_to(Ground()), self.gnd)

edg/parts/__init__.py

@@ -181,6 +181,7 @@
 from .CanTransceiver_Sn65hvd230 import Sn65hvd230
 from .CurrentSense_Ad8418 import Ad8418a
 from .Ina219 import Ina219
+from .FuelGauge_Max17048 import Max17048
 from .BatteryProtector_S8261A import S8261A
 from .BatteryCharger_Mcp73831 import Mcp73831
 from .Distance_Vl53l0x import Vl53l0x, Vl53l0xConnector, Vl53l0xArray