-
Notifications
You must be signed in to change notification settings - Fork 6.6k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
include/drivers: Add RTC support #52618
Merged
carlescufi
merged 5 commits into
zephyrproject-rtos:main
from
bjarki-andreasen:drivers_add_rtc_rtcc_wup_tmr
Apr 4, 2023
Merged
Changes from 1 commit
Commits
Show all changes
5 commits
Select commit
Hold shift + click to select a range
c4f0349
include/drivers: Add RTC API header and handlers
ae7bda8
tests/drivers/rtc: Add unit tests for RTC devices
4e3a8ed
boards/posix/native_posix: Add emulated RTC device driver
db2e4fb
MAINTAINERS.yml: Add Drivers: RTC: entry
221558c
tests/drivers/rtc: Add rtc_api_helpers test suite
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains 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
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -63,4 +63,52 @@ API Reference | |
RTC device driver test suite | ||
**************************** | ||
|
||
See :ref:`rtc_api_test` | ||
The test suite validates the behavior of the RTC device driver. It | ||
is designed to be portable between boards. It uses the device tree | ||
alias ``rtc`` to designate the RTC device to test. | ||
|
||
This test suite tests the following: | ||
|
||
* Setting and getting the time. | ||
* RTC Time incrementing correctly. | ||
* Alarms if supported by hardware, with and without callback enabled | ||
* Calibration if supported by hardware. | ||
|
||
The calibration test tests a range of values which are printed to the | ||
console to be manually compared. The user must review the set and | ||
gotten values to ensure they are valid. | ||
|
||
By default, only the mandatory Setting and getting time is enabled | ||
for testing. To test the optional alarms, update event callback | ||
and clock calibration, these must be enabled by selecting | ||
``CONFIG_RTC_ALARM``, ``CONFIG_RTC_UPDATE`` and | ||
``CONFIG_RTC_CALIBRATION``. | ||
|
||
To build the test application with default settings for a board which | ||
contains the device tree alias ``rtc``, the following command can be used | ||
for reference: | ||
|
||
:: | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Seems like these parts should be using |
||
|
||
$ west build -p -b <your board> zephyr/tests/drivers/rtc/rtc_api/ | ||
|
||
To build the test with additional RTC features enabled, use menuconfig | ||
to enable the additional features. The following command can be used | ||
for reference: | ||
|
||
:: | ||
|
||
$ west build -p -b <your board> -t menuconfig zephyr/tests/drivers/rtc/rtc_api/ | ||
|
||
Then build the test application using the following command | ||
|
||
:: | ||
|
||
$ west build | ||
|
||
To run the test suite, flash and run the application on your board, the output will | ||
be printed to the console. | ||
|
||
.. note:: | ||
|
||
The tests take up to 30 seconds each if they are testing real hardware. |
This file contains 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
This file contains 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
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
# Copyright (c) 2022 Bjarki Arge Andreasen | ||
# SPDX-License-Identifier: Apache-2.0 | ||
|
||
config RTC_EMUL | ||
bool "Emulated RTC driver" | ||
default y | ||
depends on DT_HAS_ZEPHYR_RTC_EMUL_ENABLED | ||
help | ||
Enable emulated Real-Time Clock (RTC) driver. |
Oops, something went wrong.
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.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As before, use
syntax