.. | ||
.github/workflows | ||
examples | ||
test | ||
.arduino-ci.yml | ||
keywords.txt | ||
library.json | ||
library.properties | ||
LICENSE | ||
README.md | ||
timing.h |
Timing
Arduino library with wrappers for seconds millis micros
Description
A request often made on the Arduino forum and otherwise is an option to reset the millis() function to 0 or another value. This library provide wrapper classes around millis() and micros() with the extra function to do this. To implement this only a 4 byte offset is needed.
These classes make it easy to make a simple stopwatch.
Interface
The library has 3 classes that are very similar.
- microSeconds
- milliSeconds
- seconds (wrapper around millis() too)
The interface of all three are very similar, so only one is described
- milliSeconds() constructor, sets the offset so it starts at 0.
- now() returs the time elapsed since its 'zero moment', either construction or by a set(0).
- set(value) sets the offset of the object. As it is possible to set it to a non zero value it is easy to adjust the time.
- uint32_t getOffset() returns current offset.
The classes are based upon millis() and micros() therefor have the same restrictions as these functions with respect to overflow and accuracy. Depending on e.g. interrupts millis and micros can drift.
class | overflow after | |
---|---|---|
seconds | 49 days, 17:02:47.297 | |
milliSeconds | 49 days, 17:02:47.297 | |
microSeconds | 00 days 01:11:34.967296 |
Future
idea to give it a clock print layout
-
seconds.toClock() -> DD 12:34:56
-
milliSeconds.toClock(3) -> 12:23:45.123
-
milliSeconds.toClock(1) -> 12:23:45.1
-
microSeconds.toCLock() -> 12:23:45.123456 ???
-
rounding effect, describe
Operation
See examples
Todo
- test on ESP32