ESP8266 os_timer_arm() – zatrzymanie timera os_timer_disarm() NON-OS SDK

Pytanie

ESP8266 os_timer_arm() , jak zatrzymać timer

Odpowiedź Sztucznej Inteligencji

Bezpośrednia odpowiedź na pytanie

• Timer uzbrojony funkcją os_timer_arm() zatrzymujesz wywołując os_timer_disarm(&timer_struct);.
• Funkcję można wywołać w dowolnym miejscu kodu (również z poziomu własnego callbacku); jest bezpieczna nawet, gdy timer nie jest aktywny.

Szczegółowa analiza problemu

1. Cykl życia programowego timera w NON-OS SDK

   • Inicjalizacja:

     os_timer_setfn(&myTimer, myCallback, userArg);

   • Uzbrojenie (start):

     os_timer_arm(&myTimer, 1000 /*ms*/, true /*cykliczny*/);

   • Zatrzymanie (stop):

     os_timer_disarm(&myTimer);

   • Ponowne uzbrojenie możliwe od razu po disarm.

2. Własności os_timer_disarm()

   • Operacja atomowa – usuwa wpis timera z kolejki zdarzeń.
   • Zeruje wewnętrzny licznik; „pauza” z zachowaniem czasu nie jest wspierana.
   • Wielokrotne wywołania lub wywołanie dla nieaktywnego timera są dozwolone i nie powodują błędu.

3. Kontekst wywołania

   • Funkcję można wywołać z ISR-a Wi-Fi, innego timera lub z kodu głównego.
   • Jeśli timer ma działać w pamięci IRAM, callback oznacz ICACHE_RAM_ATTR (Arduino Core) lub ICACHE_FLASH_ATTR (NON-OS/RTOS) zgodnie z miejscem przechowywania kodu.

4. Zależności sprzętowe i dokładność

   • Programowe timery korzystają z wewnętrznego timera systemowego (TMR0, przerwanie poziomu 1). Dokładność typowo ±2 ms; zależy od ruchu Wi-Fi i krytycznych sekcji SDK.
   • Dla precyzji poniżej ~50 µs użyj timera sprzętowego FRC1 (hw_timer).

Aktualne informacje i trendy

• W nowych projektach Espressif rekomenduje przejście na ESP8266-RTOS-SDK lub ESP-IDF 4.x+; tam odpowiadające API to esp_timer_*().
• W Arduino ESP8266 (core ≈ 3.1.x, 2024 r.) domyślnym wrapperem jest klasa Ticker (funkcja detach() = disarm).
• Trwają prace nad wspólnym, IDF-owym API timerów także dla ESP8266 (kompatybilność z ESP32).

Wspierające wyjaśnienia i detale

• Mikrosekundowe uzbrojenie:

  os_timer_arm_us(&myTimer, 200 /*µs*/, false);

  Zatrzymanie nadal przez os_timer_disarm().

• Przeładowanie timera „w locie”: pojedyncze os_timer_arm() na już aktywnym timerze działa jak disarm + arm.
• Stan timera można śledzić własną zmienną bool active.

Aspekty etyczne i prawne

• Brak bezpośrednich implikacji etycznych; potencjalne ryzyko dotyczy niezawodności aplikacji IoT (np. sterowanie urządzeniami grzewczymi).
• Upewnij się, że logika zatrzymania timera nie narusza wymagań bezpieczeństwa funkcjonalnego (np. watchdog sprzętowy).
• Licencja Espressif SDK (BSD-like) pozwala na komercyjne użycie; sprawdź zgodność z licencjami bibliotek zewnętrznych.

Praktyczne wskazówki

• Debug: wstaw os_printf() lub ESP_LOGD() tuż przed i po disarm, aby potwierdzić zatrzymanie.
• W aplikacjach krytycznych ustaw re-uzbrojenie timera w oddzielnym zadaniu/kolejce, aby uniknąć dead-locku w ISR.
• Gdy timer steruje GPIO, zawsze wymuś stan bezpieczny (np. wyłącz przekaźnik) natychmiast po zatrzymaniu.

Ewentualne zastrzeżenia lub uwagi dodatkowe

• NON-OS SDK jest jednowątkowe; długie operacje w callbacku spowodują blokadę Wi-Fi.
• Precyzja programowego timera spada przy intensywnej komunikacji 802.11 (beacony, retransmisje).
• Alternatywy: hw_timer (kanał 1), esp_timer (w RTOS SDK), biblioteka TickerScheduler (Arduino).

Sugestie dalszych badań

• Spróbuj migracji do ESP-IDF v5.x z esp_timer (rozszerzona rozdzielczość, łatwy porting na ESP32).
• Analiza zużycia energii: porównaj wybudzanie z DeepSleep + WAKE_RF_DISABLED vs. ciągły timer.
• Sprawdź biblioteki „software PWM” oparte na os_timer, by zrozumieć ograniczenia jittera.

Krótkie podsumowanie

Zatrzymanie timera programowego w ESP8266 (NON-OS) wykonuje się jedną instrukcją:

os_timer_disarm(&myTimer);

Funkcja jest bezpieczna, atomowa i zeruje licznik, umożliwiając ponowne użycie timera. W nowych projektach rozważ migrację do nowszego API (esp_timer lub Ticker) dla większej elastyczności i lepszej dokładności.