v2.2.0 to add support to more boards

### Releases v2.2.0

1. Suppress warnings for ESP32_C3, ESP32_S2 and ESP32_S3
2. Add support to 
  - ESP32_S2 : ESP32S2 Native USB, UM FeatherS2 Neo, UM TinyS2, UM RMP, microS2, LOLIN_S2_MINI, LOLIN_S2_PICO, ADAFRUIT_FEATHER_ESP32S2, ADAFRUIT_FEATHER_ESP32S2_TFT, ATMegaZero ESP32-S2, Deneyap Mini, FRANZININHO_WIFI, FRANZININHO_WIFI_MSC
  - ESP32_S3 : UM TinyS3, UM PROS3, UM FeatherS3, ESP32_S3_USB_OTG, ESP32S3_CAM_LCD, DFROBOT_FIREBEETLE_2_ESP32S3, ADAFRUIT_FEATHER_ESP32S3_TFT
  - ESP32_C3 : LOLIN_C3_MINI, DFROBOT_BEETLE_ESP32_C3, ADAFRUIT_QTPY_ESP32C3, AirM2M_CORE_ESP32C3, XIAO_ESP32C3

Author: khoih-prog

CONTRIBUTING.md

@@ -19,7 +19,7 @@ Please ensure to specify the following:
 * `ESP32` Board type (e.g. ESP32_DEV Module, etc.)
 * `ESP32-S2` Board type (e.g. ESP32S2_DEV Module, ESP32_S2_Saola, etc.)
 * `ESP32_S3` Board type (e.g. ESP32S3_DEV, ESP32_S3_BOX, UM TINYS3, UM PROS3, UM FEATHERS3, etc.)
-* `ESP32-C3` Board type (e.g. ESP32C3_DEV Module, etc.)
+* `ESP32-C3` Board type (e.g. ESP32C3_DEV Module, LOLIN_C3_MINI, DFROBOT_BEETLE_ESP32_C3, ADAFRUIT_QTPY_ESP32C3, AirM2M_CORE_ESP32C3, XIAO_ESP32C3, etc.)
 * Contextual information (e.g. what you were trying to achieve)
 * Simplest possible steps to reproduce
 * Anything that might be relevant in your opinion, such as:

README.md

@@ -119,9 +119,9 @@ The catch is **your function is now part of an ISR (Interrupt Service Routine),
 ### Currently supported Boards
 
 1. ESP32 boards, such as `ESP32_DEV`, etc.
-2. ESP32S2-based boards, such as `ESP32S2_DEV`, `ESP32_S2 Saola`, Adafruit QTPY_ESP32S2, etc.
-3. ESP32C3-based boards, such as `ESP32C3_DEV`, etc. **New**
-4. ESP32_S3 (ESP32S3_DEV, ESP32_S3_BOX, UM TINYS3, UM PROS3, UM FEATHERS3, FEATHER_ESP32S3_NOPSRAM and QTPY_ESP32S3_NOPSRAM, etc.) **New**
+2. ESP32_S2-based boards, such as `ESP32S2_DEV`, `ESP32_S2 Saola`, Adafruit QTPY_ESP32S2, ESP32S2 Native USB, UM FeatherS2 Neo, UM TinyS2, UM RMP, microS2, etc.
+3. ESP32_C3-based boards, such as `ESP32C3_DEV`, LOLIN_C3_MINI, DFROBOT_BEETLE_ESP32_C3, ADAFRUIT_QTPY_ESP32C3, AirM2M_CORE_ESP32C3, XIAO_ESP32C3, etc. **New**
+4. ESP32_S3-based boards, such as ESP32S3_DEV, ESP32_S3_BOX, UM TINYS3, UM PROS3, UM FEATHERS3, FEATHER_ESP32S3_NOPSRAM, QTPY_ESP32S3_NOPSRAM, etc. **New**
 
 ---
 
@@ -333,7 +333,7 @@ The following is the sample terminal output when running example [TimerInterrupt
 
 ```
 Starting TimerInterruptTest on ESP32C3_DEV
-ESP32TimerInterrupt v2.1.0
+ESP32TimerInterrupt v2.2.0
 CPU Frequency = 160 MHz
 [TISR] ESP32_TimerInterrupt: _timerNo = 0 , _fre = 1000000
 [TISR] TIMER_BASE_CLK = 80000000 , TIMER_DIVIDER = 80
@@ -368,7 +368,7 @@ The following is the sample terminal output when running example [Change_Interva
 
 ```
 Starting Change_Interval on ESP32C3_DEV
-ESP32TimerInterrupt v2.1.0
+ESP32TimerInterrupt v2.2.0
 CPU Frequency = 160 MHz
 Starting  ITimer0 OK, millis() = 293
 Starting  ITimer1 OK, millis() = 303
@@ -403,7 +403,7 @@ The following is the sample terminal output when running example [Argument_None]
 
 ```
 Starting Argument_None on ESP32S3_DEV
-ESP32TimerInterrupt v2.1.0
+ESP32TimerInterrupt v2.2.0
 CPU Frequency = 240 MHz
 [TISR] ESP32_S3_TimerInterrupt: _timerNo = 0 , _fre = 1000000
 [TISR] TIMER_BASE_CLK = 80000000 , TIMER_DIVIDER = 80
@@ -427,7 +427,7 @@ The following is the sample terminal output when running example [ISR_16_Timers_
 
 ```
 Starting ISR_16_Timers_Array_Complex on ESP32S3_DEV
-ESP32TimerInterrupt v2.1.0
+ESP32TimerInterrupt v2.2.0
 CPU Frequency = 240 MHz
 [TISR] ESP32_S3_TimerInterrupt: _timerNo = 1 , _fre = 1000000
 [TISR] TIMER_BASE_CLK = 80000000 , TIMER_DIVIDER = 80
@@ -601,7 +601,7 @@ The following is the sample terminal output when running example [ISR_16_Timers_
 
 ```
 Starting ISR_16_Timers_Array on ESP32S3_DEV
-ESP32TimerInterrupt v2.1.0
+ESP32TimerInterrupt v2.2.0
 CPU Frequency = 240 MHz
 [TISR] ESP32_S3_TimerInterrupt: _timerNo = 1 , _fre = 1000000
 [TISR] TIMER_BASE_CLK = 80000000 , TIMER_DIVIDER = 80
@@ -624,7 +624,7 @@ The following is the sample terminal output when running example [ISR_16_Timers_
 
 ```
 Starting ISR_16_Timers_Array_Complex on ESP32C3_DEV
-ESP32TimerInterrupt v2.1.0
+ESP32TimerInterrupt v2.2.0
 CPU Frequency = 160 MHz
 [TISR] ESP32_TimerInterrupt: _timerNo = 1 , _fre = 1000000
 [TISR] TIMER_BASE_CLK = 80000000 , TIMER_DIVIDER = 80
@@ -847,7 +847,10 @@ Submit issues to: [ESP32TimerInterrupt issues](https://github.com/khoih-prog/ESP
 14. Add example [multiFileProject](examples/multiFileProject) to demo for multiple-file project
 15. Add example [ISR_16_Timers_Array_Complex_OneShot](examples/ISR_16_Timers_Array_Complex_OneShot) to demo how to use `one-shot ISR-based timer` in complex case
 16. Add example [ISR_16_Timers_Array_OneShot](examples/ISR_16_Timers_Array_OneShot) to demo how to use `one-shot ISR-based timer`
-
+17. Add support to many more boards, such as
+  - ESP32_S2 : ESP32S2 Native USB, UM FeatherS2 Neo, UM TinyS2, UM RMP, microS2, LOLIN_S2_MINI, LOLIN_S2_PICO, ADAFRUIT_FEATHER_ESP32S2, ADAFRUIT_FEATHER_ESP32S2_TFT, ATMegaZero ESP32-S2, Deneyap Mini, FRANZININHO_WIFI, FRANZININHO_WIFI_MSC
+  - ESP32_S3 : UM TinyS3, UM PROS3, UM FeatherS3, ESP32_S3_USB_OTG, ESP32S3_CAM_LCD, DFROBOT_FIREBEETLE_2_ESP32S3, ADAFRUIT_FEATHER_ESP32S3_TFT
+  - ESP32_C3 : LOLIN_C3_MINI, DFROBOT_BEETLE_ESP32_C3, ADAFRUIT_QTPY_ESP32C3, AirM2M_CORE_ESP32C3, XIAO_ESP32C3
 
 ---
 ---

changelog.md

@@ -12,6 +12,7 @@
 ## Table of Contents
 
 * [Changelog](#changelog)
+  * [Releases v2.2.0](#releases-v220)
   * [Releases v2.1.0](#releases-v210)
   * [Releases v2.0.2](#releases-v202)
   * [Releases v2.0.1](#releases-v201)
@@ -31,6 +32,14 @@
 
 ## Changelog
 
+### Releases v2.2.0
+
+1. Suppress warnings for ESP32_C3, ESP32_S2 and ESP32_S3
+2. Add support to 
+  - ESP32_S2 : ESP32S2 Native USB, UM FeatherS2 Neo, UM TinyS2, UM RMP, microS2, LOLIN_S2_MINI, LOLIN_S2_PICO, ADAFRUIT_FEATHER_ESP32S2, ADAFRUIT_FEATHER_ESP32S2_TFT, ATMegaZero ESP32-S2, Deneyap Mini, FRANZININHO_WIFI, FRANZININHO_WIFI_MSC
+  - ESP32_S3 : UM TinyS3, UM PROS3, UM FeatherS3, ESP32_S3_USB_OTG, ESP32S3_CAM_LCD, DFROBOT_FIREBEETLE_2_ESP32S3, ADAFRUIT_FEATHER_ESP32S3_TFT
+  - ESP32_C3 : LOLIN_C3_MINI, DFROBOT_BEETLE_ESP32_C3, ADAFRUIT_QTPY_ESP32C3, AirM2M_CORE_ESP32C3, XIAO_ESP32C3
+
 ### Releases v2.1.0
 
 1. Suppress errors and warnings for new ESP32 core v2.0.4+

examples/multiFileProject/multiFileProject.h

@@ -18,14 +18,14 @@
 #define TIMER_INTERRUPT_DEBUG         2
 #define _TIMERINTERRUPT_LOGLEVEL_     0
 
-#ifndef LED_BUILTIN
-  #define LED_BUILTIN       2
-#endif
-
 // Can be included as many times as necessary, without `Multiple Definitions` Linker Error
 #include "ESP32TimerInterrupt.hpp"
 #include "ESP32_ISR_Timer.hpp"
 
+#ifndef LED_BUILTIN
+  #define LED_BUILTIN       2
+#endif
+
 extern ESP32_ISR_Timer ISR_Timer;  // declaration of the global variable ISRTimer
 
 void setupISR();

library.json

@@ -1,6 +1,6 @@
 {
   "name": "ESP32TimerInterrupt",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "keywords": "timing, device, control, timer, interrupt, timer-interrupt, hardware, isr, isr-based, hardware-timer, isr-timer, isr-based-timer, mission-critical, accuracy, precise, non-blocking, esp32, esp32-s2, esp32-c3, esp32-s3",
   "description": "This library enables you to use Interrupt from Hardware Timers on ESP32-based (including ESP32_S2, ESP32_S3 and ESP32_C3) boards. It now supports 16 ISR-based timers, while consuming only 1 Hardware Timer. Timers interval is very long (ulong millisecs). The most important feature is they're ISR-based timers. Therefore, their executions are not blocked by bad-behaving functions or tasks. This important feature is absolutely necessary for mission-critical tasks. These hardware timers, using interrupt, still work even if other functions are blocking. Moreover, they are much more precise (certainly depending on clock frequency accuracy) than other software timers using millis() or micros(). That's necessary if you need to measure some data requiring better accuracy.",
   "authors":

library.properties

@@ -1,5 +1,5 @@
 name=ESP32TimerInterrupt
-version=2.1.0
+version=2.2.0
 author=Khoi Hoang <khoih.prog@gmail.com>
 maintainer=Khoi Hoang <khoih.prog@gmail.com>
 sentence=This library enables you to use Interrupt from Hardware Timers on ESP32-based (including ESP32_S2, ESP32_S3 and ESP32_C3) boards

platformio/platformio.ini

@@ -42,6 +42,10 @@ build_flags =
 ; comment the folowing line to enable WiFi debugging
  -D NDEBUG
 
+
+; ============================================================
+; ============================================================
+
 [env:ESP32]
 platform = espressif32
 framework = arduino
@@ -84,6 +88,8 @@ board = esp32doit-devkit-v1
 ;board = iotbusproteus
 ;board = nina_w10
 
+; ============================================================
+
 [env:esp32s2]
 platform = espressif32
 framework = arduino
@@ -112,6 +118,7 @@ build_flags =
         -DARDUINO_ESP32S2_DEV
         -DARDUINO_VARIANT="esp32s2"
 
+; ============================================================
 
 [env:esp32s3]
 platform = espressif32
@@ -131,6 +138,7 @@ build_flags =
         -DARDUINO_ESP32S3_DEV
         -DARDUINO_VARIANT="esp32s3"
 
+; ============================================================
 
 [env:esp32sc3]
 platform = espressif32
@@ -150,3 +158,4 @@ build_flags =
         -DARDUINO_ESP32S3_DEV
         -DARDUINO_VARIANT="esp32c3"
 
+; ============================================================        

src/ESP32TimerInterrupt.h

@@ -29,7 +29,7 @@
   Based on BlynkTimer.h
   Author: Volodymyr Shymanskyy
 
-  Version: 2.1.0
+  Version: 2.2.0
   
   Version Modified By   Date      Comments
   ------- -----------  ---------- -----------
@@ -48,6 +48,7 @@
   2.0.1   K Hoang      13/03/2022 Add example to demo how to use one-shot ISR-based timers. Optimize code
   2.0.2   K Hoang      16/06/2022 Add support to new Adafruit boards
   2.1.0   K Hoang      03/08/2022 Suppress errors and warnings for new ESP32 core
+  2.2.0   K Hoang      11/08/2022 Add support and suppress warnings for ESP32_C3, ESP32_S2 and ESP32_S3 boards
 *****************************************************************************************************************************/
 
 #pragma once

src/ESP32TimerInterrupt.hpp

@@ -29,7 +29,7 @@
   Based on BlynkTimer.h
   Author: Volodymyr Shymanskyy
 
-  Version: 2.1.0
+  Version: 2.2.0
   
   Version Modified By   Date      Comments
   ------- -----------  ---------- -----------
@@ -48,6 +48,7 @@
   2.0.1   K Hoang      13/03/2022 Add example to demo how to use one-shot ISR-based timers. Optimize code
   2.0.2   K Hoang      16/06/2022 Add support to new Adafruit boards
   2.1.0   K Hoang      03/08/2022 Suppress errors and warnings for new ESP32 core
+  2.2.0   K Hoang      11/08/2022 Add support and suppress warnings for ESP32_C3, ESP32_S2 and ESP32_S3 boards
 *****************************************************************************************************************************/
 
 #pragma once
@@ -57,28 +58,50 @@
 
 #if ( ARDUINO_ESP32S2_DEV || ARDUINO_FEATHERS2 || ARDUINO_ESP32S2_THING_PLUS || ARDUINO_MICROS2 || \
       ARDUINO_METRO_ESP32S2 || ARDUINO_MAGTAG29_ESP32S2 || ARDUINO_FUNHOUSE_ESP32S2 || \
-      ARDUINO_ADAFRUIT_FEATHER_ESP32S2_NOPSRAM || ARDUINO_ADAFRUIT_QTPY_ESP32S2)
+      ARDUINO_ADAFRUIT_FEATHER_ESP32S2_NOPSRAM || ARDUINO_ADAFRUIT_QTPY_ESP32S2 || ARDUINO_ESP32S2_USB || \
+      ARDUINO_FEATHERS2NEO || ARDUINO_TINYS2 || ARDUINO_RMP || ARDUINO_LOLIN_S2_MINI || ARDUINO_LOLIN_S2_PICO || \
+      ARDUINO_ADAFRUIT_FEATHER_ESP32S2 || ARDUINO_ADAFRUIT_FEATHER_ESP32S2_TFT  || ARDUINO_atmegazero_esp32s2 || \
+      ARDUINO_DYM || ARDUINO_FRANZININHO_WIFI  || ARDUINO_FRANZININHO_WIFI_MSC )
   #define USING_ESP32_S2_TIMERINTERRUPT         true
+  
+  #if (_TIMERINTERRUPT_LOGLEVEL_ > 3)
+    #warning USING_ESP32_S2_TIMERINTERRUPT
+  #endif
 #elif ( defined(ARDUINO_ESP32S3_DEV) || defined(ARDUINO_ESP32_S3_BOX) || defined(ARDUINO_TINYS3) || \
         defined(ARDUINO_PROS3) || defined(ARDUINO_FEATHERS3) || defined(ARDUINO_ADAFRUIT_FEATHER_ESP32S3_NOPSRAM) || \
-        defined(ARDUINO_ADAFRUIT_QTPY_ESP32S3_NOPSRAM))
+        defined(ARDUINO_ADAFRUIT_QTPY_ESP32S3_NOPSRAM) || defined(ARDUINO_ESP32S3_CAM_LCD) || \
+        defined(ARDUINO_ADAFRUIT_FEATHER_ESP32S3) || defined(ARDUINO_ADAFRUIT_FEATHER_ESP32S3_TFT) || \
+        defined(ARDUINO_ESP32_S3_USB_OTG) )
   #define USING_ESP32_S3_TIMERINTERRUPT         true
-#elif ( ARDUINO_ESP32C3_DEV )
-  #define USING_ESP32_C3_TIMERINTERRUPT         true  
+  
+  #if (_TIMERINTERRUPT_LOGLEVEL_ > 3)
+    #warning USING_ESP32_S3_TIMERINTERRUPT
+  #endif
+#elif ( defined(ARDUINO_ESP32C3_DEV) || defined(ARDUINO_LOLIN_C3_MINI) || defined(ARDUINO_ADAFRUIT_QTPY_ESP32C3) || \
+        defined(ARDUINO_AirM2M_CORE_ESP32C3) || defined(ARDUINO_XIAO_ESP32C3) )
+  #define USING_ESP32_C3_TIMERINTERRUPT         true
+  
+  #if (_TIMERINTERRUPT_LOGLEVEL_ > 3)
+    #warning USING_ESP32_C3_TIMERINTERRUPT
+  #endif
 #elif defined(ESP32)
-  #define USING_ESP32_TIMERINTERRUPT            true  
+  #define USING_ESP32_TIMERINTERRUPT            true 
+  
+  #if (_TIMERINTERRUPT_LOGLEVEL_ > 3)
+    #warning USING_ESP32_TIMERINTERRUPT
+  #endif 
 #else
   #error This code is intended to run on the ESP32 platform! Please check your Tools->Board setting.  
 #endif
 
 #ifndef ESP32_TIMER_INTERRUPT_VERSION
-  #define ESP32_TIMER_INTERRUPT_VERSION          "ESP32TimerInterrupt v2.1.0"
+  #define ESP32_TIMER_INTERRUPT_VERSION          "ESP32TimerInterrupt v2.2.0"
 
   #define ESP32_TIMER_INTERRUPT_VERSION_MAJOR     2
-  #define ESP32_TIMER_INTERRUPT_VERSION_MINOR     1
+  #define ESP32_TIMER_INTERRUPT_VERSION_MINOR     2
   #define ESP32_TIMER_INTERRUPT_VERSION_PATCH     0
 
-  #define ESP32_TIMER_INTERRUPT_VERSION_INT      2001000
+  #define ESP32_TIMER_INTERRUPT_VERSION_INT      2002000
 #endif
 
 #ifndef TIMER_INTERRUPT_DEBUG
@@ -254,8 +277,11 @@ class ESP32TimerInterrupt
       .counter_en   = TIMER_START,          //starts counting counter once timer_init called
       .intr_type    = TIMER_INTR_MAX,
       .counter_dir  = TIMER_COUNT_UP,       //counts from 0 to counter value
-      .auto_reload  = TIMER_AUTORELOAD_EN,  // reloads counter automatically
-      .divider      = TIMER_DIVIDER
+      .auto_reload  = TIMER_AUTORELOAD_EN,  //reloads counter automatically
+      .divider      = TIMER_DIVIDER,
+#if SOC_TIMER_GROUP_SUPPORT_XTAL
+      .clk_src      = TIMER_SRC_CLK_XTAL    //Use XTAL as source clock
+#endif      
     };
 
     timer_idx_t       _timerIndex;

src/ESP32_ISR_Timer-Impl.h

@@ -28,7 +28,7 @@
   Based on BlynkTimer.h
   Author: Volodymyr Shymanskyy
 
-  Version: 2.1.0
+  Version: 2.2.0
   
   Version Modified By   Date      Comments
   ------- -----------  ---------- -----------
@@ -47,6 +47,7 @@
   2.0.1   K Hoang      13/03/2022 Add example to demo how to use one-shot ISR-based timers. Optimize code
   2.0.2   K Hoang      16/06/2022 Add support to new Adafruit boards
   2.1.0   K Hoang      03/08/2022 Suppress errors and warnings for new ESP32 core
+  2.2.0   K Hoang      11/08/2022 Add support and suppress warnings for ESP32_C3, ESP32_S2 and ESP32_S3 boards
 *****************************************************************************************************************************/
 
 #pragma once