1. 项目概述AutomationTimers 是一个专为 Arduino 平台设计的轻量级、无阻塞事件时序管理库其核心目标是在资源受限的微控制器上以零硬件定时器依赖、零中断占用、零动态内存分配的方式实现高可靠性的软件定时与信号处理逻辑。该库不封装任何底层外设驱动不引入 FreeRTOS 或其他 RTOS 依赖仅基于millis()和abs()这两个标准 Arduino API 构建因此具备极强的跨平台兼容性——可无缝运行于 ATmega328PArduino Uno、ESP32、RP2040Arduino Nano RP2040 Connect、STM32通过 Arduino Core for STM32乃至任何支持millis()语义的 MCU 平台。在嵌入式系统工程实践中“非阻塞”non-blocking并非一个抽象概念而是关乎系统实时性与稳定性的硬性约束。传统delay()函数会挂起整个loop()执行流导致看门狗超时、串口接收缓冲区溢出、传感器数据丢失等严重后果。AutomationTimers 通过将时间推进逻辑与状态判断逻辑解耦强制开发者采用“状态机轮询更新”的设计范式从根本上规避了阻塞风险。其所有类均不持有static全局状态不使用malloc/free所有对象实例均在栈或.data/.bss段静态分配符合 IEC 61508、ISO 26262 等功能安全标准对确定性内存行为的要求。该库的设计哲学高度契合工业自动化控制逻辑IEC 61131-3 中的 TON、TOF、TP、CTU 等功能块但以 C 类的形式进行了现代化封装。它不是通用调度器而是一组经过严格验证的、可组合的“时序原子操作单元”每个类解决一个明确的工程问题精确计时、上电延时、断电延时、按键消抖、方波生成、边沿检测、线性斜坡。这种“小而专”的设计使其代码体积极小编译后通常 1KB Flash执行开销极低单次update()调用耗时 1μs 16MHz且行为完全可预测。2. 核心架构与运行机制2.1 统一时间基准与更新模型AutomationTimers 的全部功能均建立在单一、全局、单调递增的时间源之上——Arduino 的millis()函数。该函数返回自setup()执行开始以来经过的毫秒数其底层通常由 MCU 的 SysTick 定时器或硬件 Timer 实现具有毫秒级精度和约 49.7 天的溢出周期。库内部不维护独立计时器而是通过AutomationTimers.update()这一中心化入口函数统一推进所有时间敏感类的内部状态。// 正确的使用模式在 loop() 开头调用一次 void loop() { AutomationTimers.update(); // 推进所有 Timer/OnDelay/OffDelay/Debounce/LinearRamp 的内部时钟 // 后续所有类的 operator()、update() 调用均基于此时刻的快照 if (myOnDelay) { /* ... */ } mySquareWave.update(); // SquareWave 也需 update因其内部维护相位计数器 myEdge.update(digitalRead(2)); // Edge 需要输入采样 }AutomationTimers.update()的实现本质是调用一个内部Timer实例的update()方法该实例作为全局时间基准。所有继承或组合该Timer的类如OnDelay,Debounce均共享此时间源确保了多对象间时序关系的一致性。这种设计避免了因多次调用millis()可能引入的微小时间差尤其在高频loop()中是保证时序逻辑原子性的关键。2.2 类型体系与职责划分库的类结构遵循清晰的单一职责原则各类型间无继承关系而是通过组合与接口约定协同工作类名核心职责时间依赖输入依赖输出特性典型应用场景Timer提供只读、防溢出的毫秒计数器是否unsigned long通用计时、超时检测、性能分析OnDelay输入上升沿后延时固定时间输出true是是bool继电器吸合延时、LED 启动淡入OffDelay输入下降沿后延时固定时间输出false是是bool电机惯性停机延时、冷却风扇延时关机Debounce对输入信号进行上升/下降沿双延时滤波是是bool机械按键、行程开关、干簧管消抖SquareWave生成指定周期与占空比的方波信号是否boolPWM 控制非硬件 PWM 引脚、LED 呼吸灯、步进电机细分时钟Edge检测输入信号的边沿变化上升/下降/任意否是bool状态 bool事件编码器计数、脉冲计量、中断替代方案LinearRamp以恒定速率线性逼近目标值是是long电机软启动、LED 亮度渐变、温度设定值平滑过渡值得注意的是Edge类是唯一不依赖millis()的类型它纯粹是数字信号边沿的“状态机”其update(bool input)方法仅比较当前输入与上一状态因此响应延迟仅为单次loop()周期远优于基于millis()的延时类适用于对实时性要求极高的场合。3. 关键类深度解析与工程实践3.1Timer防溢出的基石计时器Timer是整个库的时间心脏。其设计精妙之处在于对unsigned long溢出的鲁棒处理。标准millis()在约 49.7 天后会回绕至 0若直接用if (timer timeout)判断回绕时会产生逻辑错误例如0xFFFFFFFF 1000为真。Timer通过内部状态标记确保其值在达到ULONG_MAX后停止递增直至显式调用reset()。class Timer { private: unsigned long _value; bool _isMaxed; // 标记是否已达最大值 public: Timer() : _value(0), _isMaxed(false) {} // operator() 返回当前值是只读接口 operator unsigned long() const { return _value; } void reset() { _value 0; _isMaxed false; } // update() 由 AutomationTimers 内部调用不可直接调用 void update() { if (!_isMaxed) { unsigned long now millis(); // 使用无符号减法的安全比较now - _lastUpdate 总是正数 if (now _lastUpdate) { // 正常递增 _value (now - _lastUpdate); } else { // millis() 回绕now _lastUpdate _value (ULONG_MAX - _lastUpdate) now 1; } // 溢出保护 if (_value ULONG_MAX) { _value ULONG_MAX; _isMaxed true; } _lastUpdate now; } } };工程实践要点Timer实例可被多个逻辑复用例如一个Timer用于主循环心跳另一个用于通信超时。在loop()中AutomationTimers.update()必须在所有依赖时间的类操作之前调用否则myTimer的值将滞后一帧。Timer的operator unsigned long()允许其像原生变量一样参与比较极大提升了代码可读性if (myTimer 5000) { /* 5秒超时 */ }。3.2OnDelay与OffDelay工业级延时功能块OnDelayTON, Turn-On Delay和OffDelayTOF, Turn-Off Delay是 PLC 编程中最基础的时序功能块。它们的行为严格遵循 IEC 61131-3 标准OnDelay当输入input从false变为true上升沿时启动内部计时器计时器达到设定delay后输出true此后只要输入保持true输出即保持true若输入在计时期间变为false则计时器清零输出立即变为false。OffDelay当输入input从true变为false下降沿时启动内部计时器计时器达到设定delay后输出false此后只要输入保持false输出即保持false若输入在计时期间变为true则计时器清零输出立即变为true。// OnDelay 的核心 update() 逻辑 bool OnDelay::update(bool input) { if (input) { // 输入为真若计时器未启动则启动否则维持计时 if (!_active) { _startTime millis(); _active true; } } else { // 输入为假立即停止计时并重置输出 _active false; _output false; } // 检查是否达到延时 if (_active (millis() - _startTime) _delay) { _output true; } return _output; }工程实践要点setDelay()方法允许在运行时动态调整延时参数这对于需要根据工况自适应的系统如不同负载下的电机启动延时至关重要。OnDelay和OffDelay的输出是“电平保持”型而非“单次脉冲”型。若需脉冲输出需结合Edge类使用if (myOnDelay.rising()) { /* 发送单次脉冲 */ }。在电机控制中常将OnDelay用于使能信号延时OffDelay用于刹车信号延时形成安全的启停时序。3.3Debounce可靠的硬件信号净化器Debounce是OnDelay和OffDelay的组合体专为解决机械开关按键、继电器触点、行程开关的弹跳问题而设计。其工作流程为当原始输入input从false变为true启动一个OnDelay计时器计时器到期后输出true当原始输入input从true变为false启动一个OffDelay计时器计时器到期后输出false。// Debounce 的 update() 逻辑简化 bool Debounce::update(bool input) { if (input ! _lastInput) { _lastInput input; if (input) { // 上升沿启动 OnDelay _onDelayStartTime millis(); _onDelayActive true; _offDelayActive false; } else { // 下降沿启动 OffDelay _offDelayStartTime millis(); _onDelayActive false; _offDelayActive true; } } // 检查 OnDelay if (_onDelayActive (millis() - _onDelayStartTime) _delay) { _output true; _onDelayActive false; } // 检查 OffDelay if (_offDelayActive (millis() - _offDelayStartTime) _delay) { _output false; _offDelayActive false; } return _output; }工程实践要点典型的消抖延时为 10ms-50ms。过短无法滤除弹跳过长影响响应速度。Debounce的delay参数应根据具体开关的规格书选择。Debounce的输出是“干净”的电平信号可直接连接到digitalWrite()或作为其他逻辑的输入无需额外的digitalRead()。对于高可靠性系统建议在Debounce前级增加 RC 硬件滤波形成“硬件软件”两级消抖进一步提升抗干扰能力。3.4SquareWave纯软件 PWM 生成器SquareWave类提供了一种不依赖硬件 PWM 外设的方波生成方案特别适用于引脚资源紧张或硬件 PWM 通道已被占用的场景。它支持两种构造方式SquareWave(totalPeriod, dutyCycle)指定总周期ms和占空比0.0 ~ 1.0。SquareWave(onPeriod, offPeriod)直接指定高电平和低电平持续时间ms。其内部维护一个相位计数器_phase每次update()调用时根据当前相位与onPeriod的关系决定输出。// SquareWave 的 update() 逻辑 void SquareWave::update() { unsigned long now millis(); unsigned long elapsed now - _lastUpdate; _phase elapsed; _lastUpdate now; // 相位归一化到 [0, totalPeriod) if (_phase _totalPeriod) { _phase % _totalPeriod; } } // operator bool() 返回当前相位对应的电平 SquareWave::operator bool() const { return _phase _onPeriod; }工程实践要点SquareWave的频率上限受loop()执行频率限制。例如若loop()每 1ms 执行一次则最高可生成 1kHz 方波周期1ms。对于更高频率必须使用硬件 PWM。占空比dutyCycle为float类型允许精细调节如 0.333 表示 1/3 占空比但需注意float运算在 AVR 上较慢对实时性要求苛刻的场合建议预计算onPeriod和offPeriod。SquareWave可与LinearRamp结合实现“呼吸灯”效果mySquareWave.setDutyCycle(myRamp / 100.0);。3.5Edge零延迟的边沿事件捕获器Edge类是库中唯一不依赖millis()的类型其实现完全基于状态寄存器的异步比较因此具有最低的固有延迟仅一个loop()周期。class Edge { private: bool _lastState; bool _rising; bool _falling; bool _change; public: Edge() : _lastState(false), _rising(false), _falling(false), _change(false) {} void update(bool currentState) { _rising (!(_lastState) currentState); _falling (_lastState !currentState); _change (_lastState ! currentState); _lastState currentState; } bool rising() { return _rising; } bool falling() { return _falling; } bool change() { return _change; } operator bool() { return _lastState; } // 返回当前电平 };工程实践要点Edge是实现“中断替代方案”的理想选择。在无法使用外部中断引脚如 ESP32 的 GPIO6-GPIO11或需要同时监控多个引脚时Edge提供了确定性的、无优先级竞争的边沿检测。rising()和falling()方法返回的是“事件标志”即仅在边沿发生的那一帧为true之后自动清零。这使得编写事件驱动代码变得简单if (myEncoderA.rising()) { encoderCount; }。Edge应与Debounce配合使用先用Debounce滤除硬件噪声再用Edge捕捉干净的边沿构成完整的编码器或脉冲输入处理链。3.6LinearRamp平滑的数值过渡引擎LinearRamp类实现了经典的“斜坡发生器”Ramp Generator用于在两个数值之间以恒定速率进行线性插值。其数学模型为output(t) output(t-1) rate * Δt其中rate的单位是“单位/毫秒”。// LinearRamp 的 update() 逻辑 long LinearRamp::update(long target) { long current _output; long diff target - current; long step static_castlong(abs(diff) * _rate); // 计算本次应走的步长 if (diff 0) { _output min(current step, target); } else if (diff 0) { _output max(current - step, target); } // diff 0 时_output 已等于 target无需操作 return _output; }工程实践要点rate参数决定了过渡的“柔和度”。例如rate 0.01表示每毫秒向目标值靠近 1%。对于 LED 亮度0-255rate0.1可在约 1 秒内完成全范围过渡。LinearRamp的update()方法接受long target这意味着它可以驱动任何整型参数PWM 占空比、DAC 输出值、PID 设定值、电机目标转速等。为防止积分饱和在闭环控制系统中LinearRamp的输出应作为 PID 控制器的设定值SP而非直接输出。这能有效抑制阶跃响应中的超调。4. 集成应用一个完整的工业 IO 模块示例以下是一个综合运用所有AutomationTimers类的典型工业 IO 模块示例模拟一个带有本地按钮、LED 指示、远程控制输入和电机驱动的智能节点。#include AutomationTimers.h // --- 硬件定义 --- const int BUTTON_PIN 2; const int LED_PIN 13; const int REMOTE_INPUT_PIN 3; const int MOTOR_ENABLE_PIN 4; // --- 定时器与功能块实例 --- Timer systemUptime; // 系统运行时间 OnDelay motorStartDelay(2000); // 电机启动前的 2s 延时安全确认 OffDelay motorStopDelay(1000); // 电机停止后的 1s 惯性停机延时 Debounce localButton(20); // 本地按钮消抖20ms Edge remoteEdge; // 远程输入边沿检测 SquareWave heartbeatLED(1000, 0.1); // 心跳 LED1Hz10% 占空比 LinearRamp motorSpeedRamp(0.5); // 电机速度斜坡每毫秒变化 0.5 单位 // --- 状态变量 --- bool motorRunning false; long targetMotorSpeed 0; long currentMotorSpeed 0; void setup() { pinMode(BUTTON_PIN, INPUT_PULLUP); pinMode(LED_PIN, OUTPUT); pinMode(REMOTE_INPUT_PIN, INPUT); pinMode(MOTOR_ENABLE_PIN, OUTPUT); digitalWrite(MOTOR_ENABLE_PIN, LOW); Serial.begin(115200); Serial.println(IO Module Initialized); } void loop() { // --- 1. 统一更新所有时间相关功能块 --- AutomationTimers.update(); heartbeatLED.update(); // --- 2. 本地按钮处理带消抖和延时--- bool rawButton !digitalRead(BUTTON_PIN); // 按下为 LOW取反为 true bool debouncedButton localButton.update(rawButton); if (localButton.rising()) { // 消抖后检测到上升沿 if (motorRunning) { // 按下按钮请求停机 targetMotorSpeed 0; motorStartDelay.reset(); // 清除启动延时 } else { // 按下按钮请求启动但需等待 2s 确认 motorStartDelay.update(true); } } // --- 3. 远程控制处理边沿触发--- bool remoteInput digitalRead(REMOTE_INPUT_PIN); remoteEdge.update(remoteInput); if (remoteEdge.rising()) { // 远程上升沿强制启动 targetMotorSpeed 255; motorStartDelay.update(true); } else if (remoteEdge.falling()) { // 远程下降沿强制停机 targetMotorSpeed 0; } // --- 4. 电机启停逻辑 --- if (motorRunning) { // 电机已运行检查是否需要停机 if (targetMotorSpeed 0) { // 启动 OffDelay 停机延时 motorStopDelay.update(true); if (motorStopDelay) { motorRunning false; digitalWrite(MOTOR_ENABLE_PIN, LOW); } } } else { // 电机已停止检查是否需要启动 if (targetMotorSpeed 0) { // 启动 OnDelay 启动延时 motorStartDelay.update(true); if (motorStartDelay) { motorRunning true; digitalWrite(MOTOR_ENABLE_PIN, HIGH); } } } // --- 5. 电机速度斜坡控制 --- if (motorRunning) { currentMotorSpeed motorSpeedRamp.update(targetMotorSpeed); // 将 0-255 的 speed 映射到 PWM 或 DAC 输出 analogWrite(MOTOR_ENABLE_PIN, currentMotorSpeed); } // --- 6. LED 指示 --- digitalWrite(LED_PIN, heartbeatLED); // 心跳 LED if (motorRunning) { digitalWrite(LED_PIN, HIGH); // 运行时 LED 常亮覆盖心跳 } // --- 7. 系统监控 --- if (systemUptime 60000) { // 每分钟打印一次运行时间 Serial.print(Uptime: ); Serial.print(systemUptime / 60000); Serial.println( min); systemUptime.reset(); } }此示例展示了AutomationTimers如何作为一个有机整体协同构建一个健壮、可预测、易于维护的嵌入式控制逻辑。它没有使用任何delay()所有延时、消抖、边沿检测、斜坡生成都通过非阻塞的update()调用完成loop()的执行时间始终保持在微秒级为系统预留了充足的余量来处理通信、传感器读取等其他任务。