Embedded Timing Libs
Overview
Use this skill for lightweight software timer libraries such as MultiTimer. The agent should confirm tick source, callback context, time units, wraparound behavior, and scheduler frequency before relying on timer callbacks.
When To Use
Use this skill when:
- The user wants to add or debug MultiTimer, software timers, timeout lists, periodic callbacks, or one-shot timers.
- Timers drift, fire too early/late, stop firing, fire repeatedly, or break across tick overflow.
Do not use this skill for hardware PWM/timer peripheral bring-up. Use embedded-peripheral-bringup for register-level timer issues.
First Questions
Ask for:
- Timer library and target runtime.
- Tick source and frequency.
- Callback context: main loop, RTOS task, ISR, or scheduler hook.
- Time units used by the library and application.
- Number of timers and longest expected uptime.
- Whether callbacks may start/stop other timers.
Integration Checklist
Confirm tick monotonicity.
Timer logic needs a stable increasing timebase or explicit wraparound handling.
Match units.
Milliseconds, ticks, microseconds, and RTOS ticks must not be mixed silently.
Define callback context.
Timer callbacks must not block if they run in ISR or scheduler critical context.
Test one-shot and periodic behavior.
Verify start, stop, restart, and callback ordering.
Test wraparound.
Use simulated ticks or shortened counters to prove overflow behavior.
Common Failures
- Tick function returns seconds while timer expects milliseconds.
- Callback blocks in interrupt context.
- Timer list is modified while iterating without protection.
- Drift accumulates because periodic timers restart from callback time instead of scheduled time.
- Wraparound breaks after long uptime.
Verification
Before claiming timer integration works:
- State tick source, frequency, unit, callback context, and protection strategy.
- Confirm one-shot, periodic, cancel, restart, and wraparound behavior.
- Confirm callback execution time is acceptable.
- Confirm timer operations are safe from ISR/task contexts in use.
Example
User:
MultiTimer 定时回调偶尔不准。
Agent:
- Asks for tick source, units, callback context, and scheduling frequency.
- Checks unit conversion and whether callbacks block.
- Tests periodic drift and tick wraparound with a small counter.
1---2name: embedded-timing-libs3description: Use when integrating, porting, configuring, or debugging embedded software timer libraries such as MultiTimer, timeout schedulers, or tick-based callback timers4---56# Embedded Timing Libs78## Overview910Use this skill for lightweight software timer libraries such as MultiTimer. The agent should confirm tick source, callback context, time units, wraparound behavior, and scheduler frequency before relying on timer callbacks.1112## When To Use1314Use this skill when:1516- The user wants to add or debug MultiTimer, software timers, timeout lists, periodic callbacks, or one-shot timers.17- Timers drift, fire too early/late, stop firing, fire repeatedly, or break across tick overflow.1819Do not use this skill for hardware PWM/timer peripheral bring-up. Use `embedded-peripheral-bringup` for register-level timer issues.2021## First Questions2223Ask for:2425- Timer library and target runtime.26- Tick source and frequency.27- Callback context: main loop, RTOS task, ISR, or scheduler hook.28- Time units used by the library and application.29- Number of timers and longest expected uptime.30- Whether callbacks may start/stop other timers.3132## Integration Checklist33341. Confirm tick monotonicity.35 Timer logic needs a stable increasing timebase or explicit wraparound handling.36371. Match units.38 Milliseconds, ticks, microseconds, and RTOS ticks must not be mixed silently.39401. Define callback context.41 Timer callbacks must not block if they run in ISR or scheduler critical context.42431. Test one-shot and periodic behavior.44 Verify start, stop, restart, and callback ordering.45461. Test wraparound.47 Use simulated ticks or shortened counters to prove overflow behavior.4849## Common Failures5051- Tick function returns seconds while timer expects milliseconds.52- Callback blocks in interrupt context.53- Timer list is modified while iterating without protection.54- Drift accumulates because periodic timers restart from callback time instead of scheduled time.55- Wraparound breaks after long uptime.5657## Verification5859Before claiming timer integration works:6061- State tick source, frequency, unit, callback context, and protection strategy.62- Confirm one-shot, periodic, cancel, restart, and wraparound behavior.63- Confirm callback execution time is acceptable.64- Confirm timer operations are safe from ISR/task contexts in use.6566## Example6768User:6970```text71MultiTimer 定时回调偶尔不准。72```7374Agent:75761. Asks for tick source, units, callback context, and scheduling frequency.771. Checks unit conversion and whether callbacks block.781. Tests periodic drift and tick wraparound with a small counter.
easyzoom