ENABLE_TIMESTAMP

Flag to enable relative timing information (uptime_ms, timedelta_us) in sensor event output.

Controls whether timestamp tracking (uptime and inter-event timedelta) is included in sensor events and timestamp-related commands are available.

Default

• v2+ (v2.1.2+): Enabled by default (ENABLE_TIMESTAMP=1)
• v0: Disabled by default (ENABLE_TIMESTAMP=0)

Options

• ENABLE_TIMESTAMP=1: Include uptime_ms (milliseconds since boot) and timedelta_us (microseconds since last detection) fields in event output (default)
• ENABLE_TIMESTAMP=0: Disable timestamp tracking (minimal overhead mode)

Complementary Features

• ENABLE_RTC: Absolute time tracking (unix timestamp in microseconds, detected_us field)
• ENABLE_TIMESTAMP: Relative time tracking (uptime and inter-event duration)
• Both can be enabled simultaneously for complete temporal context

Fields Provided

When enabled, detection events include:

• uptime_ms: Milliseconds elapsed since device boot
• timedelta_us: Microseconds since the previous detection event

Added

• v1.7.0 (initial implementation with uptime_ms and timedelta_us)
• v2.1.3+ (default changed to enabled)

Memory Overhead

• Flash: ~200 bytes (timestamp tracking code)
• RAM: ~12 bytes (timing state variables)
• Zero overhead when disabled: All code completely excluded by preprocessor

Recommendation

Use ENABLE_TIMESTAMP=1 (default) for:

• Event rate analysis and detector responsiveness monitoring
• Multi-detector synchronization relative to local timing
• Analyzing detection clustering patterns
• General research and development

Disable (ENABLE_TIMESTAMP=0) for:

• Minimal firmware size requirements
• When only absolute time (RTC) is needed
• Legacy v0 deployments