wake_esp8266.h

Go to the documentation of this file.

#pragma once
 
#include "esphome/core/defines.h"
 
#ifdef USE_ESP8266
 
#include "esphome/core/hal.h"
 
#include <coredecls.h>
 
namespace esphome {
 
inline void ESPHOME_ALWAYS_INLINE wake_scheduler_impl() {
  // Skip the post when a wake was already signalled and not yet consumed by
  // wakeable_delay(): esp_schedule() -> ets_post() can enter SDK WiFi pm code,
  // which must not be poked per-byte from the software serial RX ISR (see
  // esphome#18409). The flag can stay latched while the loop is awake, which
  // is intentional; posts are only needed to cut a suspend short.
  if (g_main_loop_woke)
    return;
  g_main_loop_woke = true;
  esp_schedule();
}
 
inline void ESPHOME_ALWAYS_INLINE wake_loop_impl() {
  // Set the wake-requested flag BEFORE esp_schedule so the consumer is
  // guaranteed to see it on its next gate check.
  wake_request_set();
  wake_scheduler_impl();
}
 
void wake_loop_any_context();
 
inline void wake_loop_threadsafe() { wake_loop_impl(); }
inline void wake_scheduler_threadsafe() { wake_scheduler_impl(); }
 
inline void ESPHOME_ALWAYS_INLINE wake_loop_isrsafe() { wake_loop_impl(); }
 
namespace internal {
inline void ESPHOME_ALWAYS_INLINE wakeable_delay(uint32_t ms) {
  if (ms == 0) [[unlikely]] {
    delay(0);
    return;
  }
  if (g_main_loop_woke) {
    g_main_loop_woke = false;
    // Yield even on the already-woken fast path so callers in tight loops
    // (e.g. lwIP raw TCP wait_for_data_) make forward progress when ISRs
    // keep re-setting g_main_loop_woke between iterations.
    delay(0);
    return;
  }
  esp_delay(ms, []() { return !g_main_loop_woke; });
}
}  // namespace internal
 
}  // namespace esphome
 
#endif  // USE_ESP8266