Schätzung des Akkuladezustands¶

Der Akkurechner des SiFli-SDK schätzt den Ladezustand eines Akkus anhand seiner gemessenen Spannung als Prozentwert. Er ordnet Spannungswerten einen Ladezustand zu, misst aber nicht wie ein Coulomb-Zähler die ein- und ausfließende Ladung. Die Genauigkeit hängt daher von der hinterlegten Akkukurve und der korrekten Ladegerätesterkennung ab.

Die Middleware erkennt den Ladegerätestatus, wählt die passende Lade- oder Entladekurve aus und schätzt den Prozentwert durch Interpolation. Zusätzlich stabilisieren ein primärer Sprungfilter und ein optionaler gewichteter Mittelwertfilter das Ergebnis. Die veröffentlichte Anleitung beschreibt die interne Reihenfolge der Filter nicht vollständig. Prüfen Sie daher die Implementierung der SDK-Revision Ihres Projekts, bevor Sie eine bestimmte Reihenfolge annehmen.

Was der Rechner tut¶

flowchart LR
    A["Akkuspannung über ADC lesen"] --> B{"Ladegerät erkannt?"}
    B -->|"Ja"| C["Ladekurve auswählen"]
    B -->|"Nein"| D["Entladekurve auswählen"]
    C --> F["Kurveninterpolation, Filter und Trendregel für Laden/Entladen<br/>(interne Reihenfolge gemäß SDK-Implementierung)"]
    D --> F
    F --> G["Ladezustand in Prozent ausgeben"]

Das Diagramm fasst den Ablauf konzeptionell zusammen und garantiert keine interne Aufrufreihenfolge. Die veröffentlichte Anleitung legt die genaue Reihenfolge von Interpolation, Filtern und der Trendregel für Laden und Entladen nicht fest. Prüfen Sie dafür die Implementierung der SDK-Revision Ihres Produkts. Laut Anleitung sinkt der gemeldete Prozentwert beim Laden nicht und steigt beim Entladen nicht.

Zuerst das Board konfigurieren¶

Konfigurieren Sie das Board vor der Nutzung der Middleware in menuconfig:

1. ADC-Unterstützung zur Messung der Akkuspannung aktivieren.
2. Die Akkurechner-Funktion aktivieren.
3. Ladeunterstützung aktivieren.
4. Den auf dem Board verwendeten Lade-IC auswählen. Die einfache Ladegeräteoption nur verwenden, wenn keiner der aufgeführten Lade-ICs zutrifft.
5. Den Erkennungspin für das Einstecken des Ladegeräts am Board konfigurieren.
6. Die Polarität des Erkennungspins passend zur Hardware wählen.

BSP_CHARGER_INT_PIN_ACTIVE_HIGH legt die Polarität der Ladegeräteerkennung fest. Ist das Makro definiert, bedeutet ein High-Pegel, dass das Ladegerät angeschlossen ist. Ist es nicht definiert, signalisiert ein Low-Pegel den Anschluss. Eine falsch konfigurierte Polarität führt zur Auswahl der falschen Akkukurve und kann bewirken, dass der angezeigte Prozentwert stehen bleibt oder sich in die falsche Richtung ändert.

Akkukurven der tatsächlich verwendeten Zelle verwenden¶

Die Standarddatei battery_table.c im Board-Verzeichnis ist ein Beispiel, kein universelles Akkumodell. Fragen Sie den Hersteller nach den Kurven, die Spannung und Ladezustand der tatsächlich verwendeten Zelle zuordnen, und konfigurieren Sie passende Nachschlagetabellen für das Produkt.

Verwenden Sie getrennte Kurven, da die Zellspannung bei gleichem Ladezustand beim Laden und Entladen unterschiedlich ist. Ersetzen Sie die Kurve der tatsächlich verwendeten Zelle nicht durch eine beliebige 4,2-V-Kurve für Lithiumzellen, nur weil die Nennchemie übereinstimmt.

Den Rechner konfigurieren¶

battery_calculator_config_t liefert die beiden Kurventabellen und Filtereinstellungen.

Wenn der Sekundärfilter aktiviert ist, muss secondary_filter_weight_pre + secondary_filter_weight_cur gleich 100 sein. Stimmen Sie Schwellenwerte, Messanzahl und Gewichtungen auf den verwendeten Akku, Lasttransienten und das gewünschte Produktverhalten ab. Die SDK-Referenzwerte ersetzen keine Kalibrierung.

Initialisieren und Berechnen¶

Initialisieren Sie den Rechner, bevor Sie einen Prozentsatz anfordern. Die veröffentlichte SiFli-Anleitung deklariert die Initialisierungsfunktion mit Rückgabetyp void; maßgeblich für die Kompilierung ist der Header der SDK-Revision Ihres Projekts.

void battery_calculator_init(battery_calculator_t *calc,
                             const battery_calculator_config_t *config);

Die Prozent-API liefert 0–100 als Ladezustand, nicht die Akkukapazität in mAh. Prüfen Sie vor der Integration den Header und die Implementierung der verwendeten SDK-Revision auf zusätzliche Parameterbedingungen oder einen Initialisierungsstatus.

Übergeben Sie die Akkuspannung in der Skalierung, die von der verwendeten SDK-Revision erwartet wird. Der veröffentlichte API-Parameter heißt voltage_mv; prüfen Sie die tatsächliche Skalierung dennoch wie oben beschrieben:

uint8_t battery_calculator_get_percent(battery_calculator_t *calc,
                                       uint32_t voltage_mv);

Verhalten auf der Produkthardware verifizieren¶

Der angezeigte Prozentwert muss den tatsächlichen Produktzustand widerspiegeln und darf nicht nur im Labor plausibel wirken. Prüfen Sie beim Laden und Entladen sowie beim Anschließen und Abziehen des Kabels gemeinsam, ob das Ladegerät erkannt wird, welche Spannung gemessen und welche Kurve ausgewählt wird und welcher Prozentwert angezeigt wird.

Die offizielle Middleware-Referenz und aktuelle Konfigurations-Screenshots finden Sie unter Akkuladezustand mit dem SiFli-SDK berechnen. Für Abschätzungen der Akkulaufzeit auf Systemebene fahren Sie mit Stromverbrauchsanalyse einer Smartwatch fort; zur Überprüfung durch Messungen siehe Energieverbrauch messen und validieren.

Die veröffentlichte Anleitung ist ein Ausgangspunkt, ersetzt aber nicht die Prüfung der SDK-Revision, die Ihr Produkt verwendet. Klären Sie insbesondere die widersprüchliche Spannungsskalierung anhand des ADC-Pfads, der Akkutabelle, der Schwellenwertvergleiche und des API-Headers dieser Revision.

Zuletzt aktualisiert: 2026-10-21