#include "HalPowerManager.h" #include #include #include #include #include #include #include #include "HalGPIO.h" HalPowerManager powerManager; // Singleton instance void HalPowerManager::begin() { if (BoardConfig::ACTIVE.batteryAdc >= 0) { pinMode(BoardConfig::ACTIVE.batteryAdc, INPUT); } normalFreq = getCpuFrequencyMhz(); modeMutex = xSemaphoreCreateMutex(); assert(modeMutex != nullptr); } void HalPowerManager::setPowerSaving(bool enabled) { if (normalFreq <= 0) { return; // invalid state } auto wifiMode = WiFi.getMode(); if (wifiMode != WIFI_MODE_NULL) { // Wifi is active, force disabling power saving enabled = false; } // Note: We don't use mutex here to avoid too much overhead, // it's not very important if we read a slightly stale value for currentLockMode const LockMode mode = currentLockMode; if (mode == None && enabled && !isLowPower) { LOG_DBG("PWR", "Going to low-power mode"); if (!setCpuFrequencyMhz(LOW_POWER_FREQ)) { LOG_DBG("PWR", "Failed to set CPU frequency = %d MHz", LOW_POWER_FREQ); return; } isLowPower = true; } else if ((!enabled || mode != None) && isLowPower) { LOG_DBG("PWR", "Restoring normal CPU frequency"); if (!setCpuFrequencyMhz(normalFreq)) { LOG_DBG("PWR", "Failed to set CPU frequency = %d MHz", normalFreq); return; } isLowPower = false; } // Otherwise, no change needed } void HalPowerManager::startDeepSleep(HalGPIO& gpio) const { #ifdef ENABLE_SERIAL_LOG // Tear down HWCDC so the host sees a clean disconnect and the peripheral // doesn't hold power domains that interfere with USB-powered GPIO wake. // logSerial is the raw HWCDC reference; Serial is the MySerialImpl proxy // (which doesn't expose end()). logSerial.end(); #endif #if !SOC_PM_SUPPORT_EXT1_WAKEUP if (gpio.isXteinkDevice() && !gpio.deviceIsX3()) { // X4 GPIO13 is connected to the battery latch MOSFET. Keeping it low powers // the MCU off on battery, while the SDK wake source still handles USB power. constexpr gpio_num_t GPIO_SPIWP = GPIO_NUM_13; gpio_set_direction(GPIO_SPIWP, GPIO_MODE_OUTPUT); gpio_set_level(GPIO_SPIWP, 0); gpio_hold_en(GPIO_SPIWP); } #endif // Cut the gated peripheral rails (touch/SD/EPD on boards like the Sticky) and // hold the enables off through deep sleep — otherwise the GT911 and SD card // stay powered all through "off" and drain the battery. No-op on boards with // no switched rails (X4/X3). Trade-off: no touch-to-wake; wake is the power // button. Must run after display.deepSleep() so the panel controller gets its // deep-sleep command while its rail is still up (enterDeepSleep() in main.cpp // guarantees that ordering). freeink::PowerManager::powerDownRailsForSleep(); // Waits for the power button to be physically released (so holding it doesn't // immediately wake the device again), then arms the wake source and sleeps. freeink::PowerManager::deepSleepUntilPowerButton(); } uint16_t HalPowerManager::getBatteryPercentage() const { static const BatteryMonitor battery; if (BoardConfig::ACTIVE.batteryGauge.gaugeAddr != 0) { const unsigned long now = millis(); if (_batteryLastPollMs != 0 && (now - _batteryLastPollMs) < BATTERY_POLL_MS) { return _batteryCachedPercent; } _batteryLastPollMs = now; uint16_t percent = 0; if (!battery.readPercentageChecked(percent)) { return _batteryCachedPercent; } _batteryCachedPercent = percent; return _batteryCachedPercent; } // smooth the battery %. if (_batteryCachedPercent == 0) { _batteryCachedPercent = 10 * battery.readPercentage(); } else { _batteryCachedPercent = (_batteryCachedPercent * 9 + battery.readPercentage() * 10) / 10; } return _batteryCachedPercent / 10; } HalPowerManager::Lock::Lock() { xSemaphoreTake(powerManager.modeMutex, portMAX_DELAY); // Current limitation: only one lock at a time if (powerManager.currentLockMode != None) { LOG_ERR("PWR", "Lock already held, ignore"); valid = false; } else { powerManager.currentLockMode = NormalSpeed; valid = true; } xSemaphoreGive(powerManager.modeMutex); if (valid) { // Immediately restore normal CPU frequency if currently in low-power mode powerManager.setPowerSaving(false); } } HalPowerManager::Lock::~Lock() { xSemaphoreTake(powerManager.modeMutex, portMAX_DELAY); if (valid) { powerManager.currentLockMode = None; } xSemaphoreGive(powerManager.modeMutex); }