MAX17055, tek hücre Li-Ion / LiPo pillerin şarj durumu (SoC), sağlık durumu (SoH) ve gerçek zamanlı çalışma parametrelerini ölçmek için kullanılan gelişmiş bir yakıt göstergesi (fuel gauge) entegresidir.

Bu kütüphane, MAX17055’in sunduğu tüm temel fonksiyonlara kolay erişim sağlayan, gömülü sistemlerde güvenilir pil ölçümleri yapılmasını mümkün kılan hafif bir Arduino API’sidir.

Kütüphane; sahada kullanılan IoT sensörlerinden, el terminallerine ve enerji tasarrufu gerektiren tüm taşınabilir cihazlara kadar geniş bir kullanım alanı sunar.

Özellikler​

Bu kütüphane sayesinde MAX17055 üzerinden aşağıdaki verilere kolayca erişebilirsin:

• Pil gerilimi (Voltage mV)
• Anlık akım (Current mA)
• Şarj durumu (State of Charge – SOC %)
• Sağlık durumu (State of Health – SOH %)
• Kapsite tahmini (FullCapRep / Remaining Capacity)
• Kararlı SoC ölçümü için hızlı filtrelenmiş veriler
• Hızlı konfigürasyon & otomatik model ayarı
• Alert / Interrupt takibi

Tüm register erişimleri optimize edilmiştir ve mikrodenetleyici üzerinde minimum yük oluşturacak şekilde tasarlanmıştır.

Uygulama Senaryoları​

Bu kütüphane özellikle şu projelerde kritik fayda sağlar:

• Taşınabilir IoT cihazları
• Kablosuz sensör modülleri
• Akıllı tarım sensörleri
• LiPo ile çalışan el cihazları
• Düşük güç modunda çalışan veri kaydediciler
• Uzun süreli saha sistemlerinde pil sağlığı takibi

Pil davranışının doğru analiz edilmesi; kullanım ömrünü uzatır, beklenmedik kapanmaları önler ve cihazın enerji yönetimini daha öngörülebilir hale getirir.

Kurulum​

Arduino IDE​

1. Arduino IDE’de Library Manager’ı aç.
2. Arama kutusuna “MAX17055” yaz.
3. MAX17055 (Author: Günce Akkoyun) kütüphanesini seçip Install de.

Alternatif kurulum:

• GitHub’daki Releases bölümünden .zip indir.
• Sketch → Include Library → Add .ZIP Library… ile projene ekle.

PlatformIO​

platformio.ini dosyana şu satırı eklemen yeterli:

lib_deps = akkoyun/MAX17055

İstersen belirli bir sürüm kullanmak için @^1.0.0 gibi versiyon belirtebilirsin.

Temel Kullanım​

Örnek kod kütüphanenin çalışma mantığını hızlıca gösterir:

#include <MAX17055.h>

MAX17055 battery;

void setup() {
    Serial.begin(115200);
    battery.begin();
}

void loop() {
    Serial.print("Voltage: ");
    Serial.print(battery.getVoltage());
    Serial.println(" mV");

    Serial.print("SOC: ");
    Serial.print(battery.getSOC());
    Serial.println(" %");

    delay(1000);
}

Kütüphane başlatıldığında MAX17055 register’ları otomatik olarak yapılandırılır ve kararlı ölçümler elde etmek için gerekli tüm hesaplamalar yapılır.

Gelişmiş Fonksiyonlar​

Bu kütüphanede sadece temel ölçümler değil, aynı zamanda aşağıdaki gelişmiş fonksiyonlar da bulunur:

• getCurrent() — Anlık akım ölçümü
• getTemperature() — Pil sıcaklığı
• getFullCapacity() — Maksimum kapasite tahmini
• getRemainingCapacity() — Kalan kapasite
• getAVSOC() — Filtrelenmiş SoC (daha kararlı değerler)
• setAlertThreshold() — Düşük pil alarmı ayarı

Bu fonksiyonlar sayesinde pil takibi tamamen gömülü sistem üzerinde yapılabilir.