Description
Compute (current - previous) modulo 2^width and mark wrapped when current is numerically smaller.
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.
Compute (current - previous) modulo 2^width and mark wrapped when current is numerically smaller.
When to use this tool
Use Timer Capture Counter Wrap Delta when you need a timer period, wrap delta, or explicit count-budget term.
How to use the tool and how it works
- Enter previous, current, width. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read ticks, wrapped. Inspect wrapped before interpreting the associated values.
Compute (current - previous) modulo 2^width and mark wrapped when current is numerically smaller.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| previous | Previous | Required. Safe integer; minimum 0. |
| current | Current | Required. Safe integer; minimum 0. |
| width | Width | Required. Safe integer; minimum 1; maximum 32. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| ticks | Ticks | Required. Finite number. |
| wrapped | Wrapped | Required. Boolean. |
{
"input": {
"previous": 250,
"current": 5,
"width": 8
},
"output": {
"ticks": 11,
"wrapped": true
}
}Limitations and assumptions
- Only the within-modulus delta is recovered; complete extra wraps cannot be detected from two samples.
- 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 Overflow Age Term
Add wraps × 2^bits to current - captured and require a nonnegative safe-integer elapsedTicks.
- 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.