Description
Add wraps × 2^bits to current - captured and require a nonnegative safe-integer elapsedTicks.
Timer formulas depend on whether endpoints are inclusive, the count direction, prescaling, and wrap behavior. A counter reading alone cannot reveal an arbitrary number of elapsed wraps.
Add wraps × 2^bits to current - captured and require a nonnegative safe-integer elapsedTicks.
When to use this tool
Use Timer Capture Overflow Age Term when you need a timer period, wrap delta, or explicit count-budget term.
How to use the tool and how it works
- Enter captured, current, wraps, bits. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read elapsedTicks. Use the output convention below.
Add wraps × 2^bits to current - captured and require a nonnegative safe-integer elapsedTicks.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| captured | Captured | Required. Safe integer; minimum 0. |
| current | Current | Required. Safe integer; minimum 0. |
| wraps | Wraps | Required. Safe integer; minimum 0. |
| bits | Bits | Required. Safe integer; minimum 1; maximum 32. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| elapsedTicks | Elapsed Ticks | Required. Safe integer. |
{
"input": {
"captured": 250,
"current": 10,
"wraps": 1,
"bits": 8
},
"output": {
"elapsedTicks": 16
}
}Limitations and assumptions
- The caller must know the wrap count; inconsistent wrap and counter values are rejected rather than corrected.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Check the timer mode and register semantics in the device documentation, including synchronization and latency.
References
Similar or alternative tools
- Timer Capture Counter Wrap Delta
Compute (current - previous) modulo 2^width and mark wrapped when current is numerically smaller.
- Tick Counter Wrap Safe Half Range
For a width in 2-32 bits, return halfRange = 2^(bits - 1) and unambiguous when supplied delta is strictly below it.