A fully Metro-compatible Arduino library for non-blocking timing – with added features!
🟢 Drop-in replacement for Metro library 🟢 Adds support for delta time measurements, dual-phase intervals, and dynamic control
- Fully compatible with Metro:
check(),expired(),reset(),interval(),checkCatchUp(),running() - Adds
get()to measure time since last call - Adds
setPhases(onTime, offTime)for alternating blink/idle periods - Adds
.enable(),.disable()and.isEnabled()to control timers dynamically - Safe for
millis()overflow (~49.7 days) - Makes writing non-blocking code easy: blink LEDs, debounce buttons, periodic actions
| Feature | Metro | EasyInterval |
|---|---|---|
check() |
✅ | ✅ |
expired() |
✅ | ✅ |
interval(ms) |
✅ | ✅ |
reset() |
✅ | ✅ |
checkCatchUp() |
✅ | ✅ |
running() |
✅ | ✅ |
get() |
❌ | ✅ |
setPhases() |
❌ | ✅ |
phase() |
❌ | ✅ |
enable() |
❌ | ✅ |
disable() |
❌ | ✅ |
isEnabled() |
❌ | ✅ |
#include <EasyInterval.h>
const int ledPin = 13;
EasyInterval blink(1000); // 1 second
// Metro blink(1000); // <- just change this line if using Metro
void setup() {
pinMode(ledPin, OUTPUT);
}
void loop() {
if (blink.check()) {
digitalWrite(ledPin, !digitalRead(ledPin));
}
}#include <EasyInterval.h>
const int ledPin = 13;
EasyInterval timer;
void setup() {
pinMode(ledPin, OUTPUT);
timer.setPhases(1000, 3000); // ON 1s, OFF 3s
}
void loop() {
if (timer.check()) {
digitalWrite(ledPin, timer.phase() == 0 ? HIGH : LOW);
}
}#include <EasyInterval.h>
const int buttonPin = 2;
const int ledPin = 13;
EasyInterval debounce;
int lastState = HIGH;
bool ledState = false;
void setup() {
pinMode(buttonPin, INPUT_PULLUP);
pinMode(ledPin, OUTPUT);
}
void loop() {
int state = digitalRead(buttonPin);
if (state != lastState && debounce.get() > 50) {
lastState = state;
if (state == LOW) {
ledState = !ledState;
digitalWrite(ledPin, ledState);
}
}
}#include <EasyInterval.h>
EasyInterval deltaTimer;
void setup() {
Serial.begin(9600);
}
void loop() {
unsigned long dt = deltaTimer.get();
Serial.print("Delta time: ");
Serial.println(dt);
delay(200); // simulate processing
}#include <EasyInterval.h>
EasyInterval heartbeat(500);
void setup() {
Serial.begin(9600);
}
void loop() {
if (heartbeat.check()) {
Serial.println("Heartbeat...");
}
static EasyInterval timeout(5000);
if (timeout.check()) {
heartbeat.disable();
Serial.println("Timer disabled");
}
// heartbeat.enable(); // to resume later
}#include <EasyInterval.h>
EasyInterval blink1(500); // LED1 every 500ms
EasyInterval blink2(1500); // LED2 every 1.5s
const int led1 = 8;
const int led2 = 9;
void setup() {
pinMode(led1, OUTPUT);
pinMode(led2, OUTPUT);
}
void loop() {
if (blink1.check()) {
digitalWrite(led1, !digitalRead(led1));
}
if (blink2.check()) {
digitalWrite(led2, !digitalRead(led2));
}
}#include <EasyInterval.h>
EasyInterval action(1000);
bool fast = false;
void setup() {
Serial.begin(9600);
}
void loop() {
if (action.check()) {
Serial.println("Tick");
if (fast) {
action.interval(1000); // switch to slow
} else {
action.interval(200); // switch to fast
}
fast = !fast;
}
}#include <EasyInterval.h>
EasyInterval blinkLed(500); // create interval
// Metro blinkLed(500); // exact same logic with Metro
void setup() {
pinMode(13, OUTPUT);
}
void loop() {
if (blinkLed.check()) {
digitalWrite(13, !digitalRead(13));
}
}#include <EasyInterval.h>
const int buttonPin = 2;
const int ledPin = 13;
EasyInterval autoOff(2000);
void setup() {
pinMode(buttonPin, INPUT_PULLUP);
pinMode(ledPin, OUTPUT);
}
void loop() {
if (digitalRead(buttonPin) == LOW) {
digitalWrite(ledPin, HIGH);
autoOff.reset(); // restart 2-second timer
}
if (autoOff.expired()) {
digitalWrite(ledPin, LOW);
}
}| Method | Description |
|---|---|
check() |
Returns true if interval passed and resets timer |
expired() |
Returns true if interval passed (no reset) |
reset() |
Manually reset the timer |
interval(ms) |
Set or change the interval time |
get() |
Returns time passed since last get/reset |
checkCatchUp() |
Keeps time aligned even if delayed |
running() |
Returns true if within current interval |
setPhases(a, b) |
Enables dual-phase toggle timer |
phase() |
Returns current phase (0 or 1) |
enable() |
Re-enables the timer after disabling |
disable() |
Disables the timer (check/get return false/0) |
isEnabled() |
Returns whether the timer is currently enabled |
To disable execution:
timer.disable();To re-enable:
timer.enable();Or:
if (timer.isEnabled() && timer.check()) {
// conditional execution
}MIT License Copyright (c) 2025 Author: Regimantas Baublys
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction...
Full license in LICENSE file.