drivers/capture: add signal notification support and fake capture driver #17747
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Donny9
requested review from
michallenc,
raiden00pl,
saramonteiro,
simbit18 and
xiaoxiang781216
as code owners
github-actions
bot
added
Area: Drivers
Contributor
|
@Donny9 please fix the conflict |
xiaoxiang781216
previously approved these changes
Dec 30, 2025
acassis
requested changes
Dec 30, 2025
Contributor
acassis
left a comment
acassis
left a comment
There was a problem hiding this comment.
@Donny9 please include information to this signal notification and this new fake capture to https://nuttx.apache.org/docs/latest/components/drivers/character/timers/capture.html#capture
Contributor
Author
Contributor
Author
Done~ @acassis |
github-actions
bot
added
the
Area: Documentation
acassis
previously approved these changes
Dec 30, 2025
Contributor
This commit adds comprehensive signal notification support to the capture driver, enabling applications to be asynchronously notified when capture edge events occur on any channel, rather than having to poll for events. Background: The capture driver is used to measure frequency and duty cycle of external signals by detecting edges (rising/falling). Previously, applications could only retrieve captured values through periodic polling via CAPIOC_GETDUTY and CAPIOC_GETFREQ ioctl commands, which is inefficient for event-driven applications. Problem: Without event notification, applications must: - Continuously poll the capture device to check for new events - Waste CPU cycles in polling loops - Experience higher latency in responding to capture events - Cannot efficiently handle multiple capture channels simultaneously Solution: This commit adds a signal-based notification mechanism that allows applications to register callbacks for specific capture channels and edge types (rising, falling, or both). When the hardware detects the configured edge, a signal is sent to the registered task. Signed-off-by: dongjiuzhu1 <dongjiuzhu1@xiaomi.com>
This commit introduces a software-based fake capture driver that simulates a 10Hz square wave with 50% duty cycle, enabling development and testing of capture-related applications without requiring real hardware. Background: The capture driver subsystem requires hardware support (timers with input capture functionality) to measure external signal frequency and duty cycle. During development, testing, or on platforms without capture hardware, it's difficult to develop and test applications that use the capture API. Problem: Without a fake/simulator driver: - Developers cannot test capture applications without specific hardware - Continuous Integration (CI) systems cannot run capture-related tests - Applications cannot be developed on platforms lacking capture hardware - Testing edge notification features requires complex hardware setup - Difficult to reproduce specific timing scenarios for debugging Solution: This commit provides a software-simulated capture driver that generates predictable capture events using a watchdog timer. The fake driver produces a square wave signal at 10Hz frequency with 50% duty cycle, allowing applications to test the full capture API without hardware. Signed-off-by: dongjiuzhu1 <dongjiuzhu1@xiaomi.com>
Contributor
Author
These documentation updates correspond to commits: - drivers/capture: add signal notification support for edge capture events - drivers/capture: add fake capture driver for testing and development Signed-off-by: dongjiuzhu1 <dongjiuzhu1@xiaomi.com>
Contributor
Contributor
|
@Donny9 strange, still failing |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
patch1:
drivers/capture: add signal notification support for edge capture events
This commit adds comprehensive signal notification support to the capture
driver, enabling applications to be asynchronously notified when capture
edge events occur on any channel, rather than having to poll for events.
patch2:
drivers/capture: add fake capture driver for testing and development
This commit introduces a software-based fake capture driver that simulates
a 10Hz square wave with 50% duty cycle, enabling development and testing
of capture-related applications without requiring real hardware.
Impact
new function about capture
Testing
examples capture
