nicla-system: Add API for operating system.

Author: sebromero

libraries/Nicla_System/examples/NiclaSenseME_BatteryStatus/NiclaSenseME_BatteryStatus.ino

@@ -167,6 +167,8 @@ void setup()
   setupBLE();
 
   nicla::leds.setColor(green);
+
+  nicla::enableCharge();
 }
 
 void loop()
@@ -216,6 +218,11 @@ void loop()
 
     auto chargeLevel = nicla::getBatteryChargeLevel();
     Serial.println("Battery is " + getBatteryChargeLevelDescription(chargeLevel));
+
+    bool isCharging = nicla::getOperatingStatus() == OperatingStatus::Charging;
+    Serial.print("Battery is charging: ");
+    Serial.println(isCharging ? "Yes" : "No");
+    
     Serial.println("----------------------");
   }
 }

libraries/Nicla_System/src/Nicla_System.cpp

@@ -319,6 +319,14 @@ uint8_t nicla::getBatteryTemperature() {
   return getBatteryStatus() & BATTERY_TEMPERATURE_MASK;
 }
 
+
+OperatingStatus nicla::getOperatingStatus() {
+  // Extract bits 6 and 7
+  uint8_t status = _pmic.getStatus() >> 6 & 0b11;
+  return static_cast<OperatingStatus>(status);
+}
+
+
 void nicla::synchronizeFastChargeSettings()
 {
   if (_fastChargeRegisterData != _pmic.readByte(BQ25120A_ADDRESS, BQ25120A_FAST_CHG)) {

libraries/Nicla_System/src/Nicla_System.h

@@ -10,6 +10,13 @@
 
 #define USE_FASTCHG_TO_KICK_WATCHDOG 1
 
+enum class OperatingStatus {
+  Ready = 0b00,
+  Charging = 0b01,
+  ChargingComplete = 0b10,
+  Error = 0b11
+};
+
 // 3 bits are used to indicate the battery charge level
 #define BATTERY_CHARGE_MASK     0b00000111
 #define BATTERY_FULL            5 // Bit pattern: 101
@@ -26,8 +33,6 @@
 #define BATTERY_TEMPERTURE_COOL     (2 << 4)
 #define BATTERY_TEMPERTURE_WARM     (3 << 4)
 
-#define BATTERY_CHARGING        (1 << 7)
-
 class nicla {
 
 public:
@@ -133,6 +138,13 @@ class nicla {
   static uint8_t getBatteryFaults();
 
 
+  /**
+   * @brief Get the current operating status of the PMIC.
+   * 
+   * @return OperatingStatus One of the following: Ready, Charging, ChargingComplete, Error.
+   */
+  static OperatingStatus getOperatingStatus();
+
   static RGBled leds;
   static BQ25120A _pmic;