ESP32TimerInterrupt 项目教程

ESP32TimerInterrupt 项目教程

ESP32TimerInterruptThis library enables you to use Interrupt from Hardware Timers on an ESP32-based board. 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.项目地址:https://gitcode.com/gh_mirrors/es/ESP32TimerInterrupt

1. 项目的目录结构及介绍

ESP32TimerInterrupt 项目的目录结构如下：

ESP32TimerInterrupt/
├── examples/
│   ├── ISR_16_Timers_Array_Complex/
│   │   └── ISR_16_Timers_Array_Complex.ino
│   └── TimerInterruptTest/
│       └── TimerInterruptTest.ino
├── src/
│   ├── ESP32TimerInterrupt.cpp
│   └── ESP32TimerInterrupt.h
├── LICENSE
└── README.md

目录结构介绍

• examples/: 包含项目的示例代码，帮助用户理解如何使用库。
  • ISR_16_Timers_Array_Complex/: 包含一个复杂的示例，展示如何使用16个定时器。
  • TimerInterruptTest/: 包含一个基本的示例，展示如何使用定时器中断。
• src/: 包含库的核心源代码文件。
  • ESP32TimerInterrupt.cpp: 库的主要实现文件。
  • ESP32TimerInterrupt.h: 库的头文件，包含函数和变量的声明。
• LICENSE: 项目的许可证文件，本项目使用MIT许可证。
• README.md: 项目的说明文件，包含项目的基本信息和使用指南。

2. 项目的启动文件介绍

项目的启动文件位于 examples/TimerInterruptTest/TimerInterruptTest.ino。这个文件是一个基本的示例，展示了如何使用 ESP32TimerInterrupt 库。

启动文件内容

#include "ESP32TimerInterrupt.h"

#define LED0 25 // GPIO 25
#define LED1 27 // GPIO 27
#define LED2 33 // GPIO 33

#define TIMER0_INTERVAL_MS 100
#define TIMER1_INTERVAL_MS 3000
#define TIMER2_INTERVAL_MS 400

void IRAM_ATTR TimerHandler0(void) {
  static bool toggle0 = false;
  // 定时器中断切换LED0
  digitalWrite(LED0, toggle0 = !toggle0);
}

void setup() {
  pinMode(LED0, OUTPUT);
  pinMode(LED1, OUTPUT);
  pinMode(LED2, OUTPUT);

  // 初始化定时器
  timer0.attachInterruptInterval(TIMER0_INTERVAL_MS, TimerHandler0);
}

void loop() {
  // 主循环
}

启动文件介绍

• #include "ESP32TimerInterrupt.h": 引入库的头文件。
• #define LED0 25: 定义LED引脚。
• #define TIMER0_INTERVAL_MS 100: 定义定时器间隔。
• void IRAM_ATTR TimerHandler0(void): 定时器中断处理函数。
• void setup(): 初始化函数，设置引脚模式并初始化定时器。
• void loop(): 主循环函数。

3. 项目的配置文件介绍

项目的配置文件主要是 src/ESP32TimerInterrupt.h 和 src/ESP32TimerInterrupt.cpp。这些文件包含了库的核心实现和配置。

配置文件内容

ESP32TimerInterrupt.h

#ifndef ESP32TIMERINTERRUPT_H
#define ESP32TIMERINTERRUPT_H

#include <Arduino.h>

#define TIMER_INTERRUPT_DEBUG       0
#define TIMERINTERRUPT_LOGLEVEL     0

class ESP32TimerInterrupt {
  public:
    ESP32TimerInterrupt();
    void attachInterruptInterval(unsigned long interval, void (*handler)(void));
    void detachInterrupt();
};

#endif

ESP32TimerInterrupt.cpp

#include "ESP32TimerInterrupt.h"

ESP32TimerInterrupt::ESP32TimerInterrupt() {
  // 初始化代码
}

void ESP32TimerInterrupt::attachInterruptInterval(unsigned long interval, void (*handler)(void)) {
  // 设置定时器中断
}

void ESP32TimerInterrupt::detachInterrupt() {
  // 取消定时器中断
}

ESP32TimerInterruptThis library enables you to use Interrupt from Hardware Timers on an ESP32-based board. 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.项目地址:https://gitcode.com/gh_mirrors/es/ESP32TimerInterrupt