mirror of
https://github.com/zephyrproject-rtos/zephyr
synced 2025-09-01 21:51:59 +00:00
7a2ce2882a
Add custom clock_control API for nRF platforms that allows requesting clocks with specified minimal required attributes (accuracy, precision, and frequency). Provide an implementation of this API for FLL16M, HFXO, HSFLL, and LFCLK controllers in the nRF54H20 SoC. Signed-off-by: Andrzej Głąbek <andrzej.glabek@nordicsemi.no> Signed-off-by: Bjarki Arge Andreasen <bjarki.andreasen@nordicsemi.no>
196 lines
5.7 KiB
Plaintext
196 lines
5.7 KiB
Plaintext
# Clock controller driver configuration options
|
|
|
|
# Copyright (c) 2016 Nordic Semiconductor ASA
|
|
# SPDX-License-Identifier: Apache-2.0
|
|
|
|
config CLOCK_CONTROL_NRF_FORCE_ALT
|
|
bool
|
|
depends on SOC_COMPATIBLE_NRF
|
|
help
|
|
This option can be enabled to force an alternative implementation
|
|
of the clock control driver.
|
|
|
|
menuconfig CLOCK_CONTROL_NRF
|
|
bool "NRF Clock controller support"
|
|
default y
|
|
depends on DT_HAS_NORDIC_NRF_CLOCK_ENABLED
|
|
select NRFX_CLOCK if !CLOCK_CONTROL_NRF_FORCE_ALT
|
|
select ONOFF
|
|
help
|
|
Enable support for the Nordic Semiconductor nRFxx series SoC clock
|
|
driver.
|
|
|
|
if CLOCK_CONTROL_NRF
|
|
|
|
config CLOCK_CONTROL_NRF_SHELL
|
|
bool "Shell commands"
|
|
depends on SHELL
|
|
|
|
choice CLOCK_CONTROL_NRF_SOURCE
|
|
prompt "32KHz clock source"
|
|
default CLOCK_CONTROL_NRF_K32SRC_XTAL
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_RC
|
|
bool "RC Oscillator"
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_XTAL
|
|
select NRFX_CLOCK_LFXO_TWO_STAGE_ENABLED if (!SOC_SERIES_BSIM_NRFXX && \
|
|
!CLOCK_CONTROL_NRF_FORCE_ALT)
|
|
bool "Crystal Oscillator"
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_SYNTH
|
|
depends on !SOC_SERIES_NRF91X
|
|
bool "Synthesized from HFCLK"
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_EXT_LOW_SWING
|
|
depends on SOC_SERIES_NRF52X
|
|
select NRFX_CLOCK_LFXO_TWO_STAGE_ENABLED if !CLOCK_CONTROL_NRF_FORCE_ALT
|
|
bool "External low swing"
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_EXT_FULL_SWING
|
|
depends on SOC_SERIES_NRF52X
|
|
select NRFX_CLOCK_LFXO_TWO_STAGE_ENABLED if !CLOCK_CONTROL_NRF_FORCE_ALT
|
|
bool "External full swing"
|
|
|
|
endchoice
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_RC_CALIBRATION
|
|
bool "LF clock calibration"
|
|
depends on !SOC_SERIES_NRF91X && CLOCK_CONTROL_NRF_K32SRC_RC
|
|
default y if !SOC_NRF53_CPUNET_ENABLE
|
|
help
|
|
If calibration is disabled when RC is used for low frequency clock then
|
|
accuracy of the low frequency clock will degrade. Disable on your own
|
|
risk.
|
|
|
|
if CLOCK_CONTROL_NRF_K32SRC_RC_CALIBRATION
|
|
|
|
config CLOCK_CONTROL_NRF_DRIVER_CALIBRATION
|
|
bool
|
|
depends on !CLOCK_CONTROL_NRF_FORCE_ALT
|
|
depends on MULTITHREADING
|
|
default y
|
|
help
|
|
Enabling indicates that calibration is performed by the clock control driver.
|
|
|
|
config CLOCK_CONTROL_NRF_CALIBRATION_LF_ALWAYS_ON
|
|
bool "LF clock is always on"
|
|
default y if NRF_RTC_TIMER
|
|
help
|
|
If RTC is used as system timer then LF clock is always on and handling
|
|
can be simplified.
|
|
|
|
config CLOCK_CONTROL_NRF_CALIBRATION_PERIOD
|
|
int "Calibration opportunity period in milliseconds"
|
|
default 4000
|
|
help
|
|
Periodically, calibration action is performed. Action includes
|
|
temperature measurement followed by clock calibration. Calibration may
|
|
be skipped if temperature change (compared to measurement of previous
|
|
calibration) did not exceeded CLOCK_CONTROL_NRF_CALIBRATION_TEMP_DIFF
|
|
and number of consecutive skips did not exceeded
|
|
CLOCK_CONTROL_NRF_CALIBRATION_MAX_SKIP.
|
|
|
|
config CLOCK_CONTROL_NRF_CALIBRATION_MAX_SKIP
|
|
int "Maximum number of calibration skips"
|
|
default 1
|
|
range 0 $(UINT8_MAX)
|
|
help
|
|
Calibration is skipped when temperature change since last calibration
|
|
was less than configured threshold. If number of consecutive skips
|
|
reaches configured value then calibration is performed
|
|
unconditionally. Set to 0 to perform calibration periodically
|
|
regardless of temperature change.
|
|
|
|
config CLOCK_CONTROL_NRF_CALIBRATION_TEMP_DIFF
|
|
int "Temperature change triggering calibration (in 0.25 degree units)"
|
|
default 2
|
|
help
|
|
Calibration is triggered if the temperature has changed by at least
|
|
this amount since the last calibration.
|
|
|
|
if CLOCK_CONTROL_NRF_DRIVER_CALIBRATION
|
|
|
|
config CLOCK_CONTROL_NRF_CALIBRATION_DEBUG
|
|
bool "Calibration instrumentation"
|
|
help
|
|
Enables retrieving debug information like number of performed or
|
|
skipped calibrations.
|
|
|
|
config CLOCK_CONTROL_NRF_USES_TEMP_SENSOR
|
|
bool
|
|
depends on HAS_HW_NRF_TEMP
|
|
default y if CLOCK_CONTROL_NRF_CALIBRATION_MAX_SKIP > 0 && \
|
|
CLOCK_CONTROL_NRF_CALIBRATION_TEMP_DIFF > 0
|
|
select TEMP_NRF5
|
|
select SENSOR
|
|
|
|
endif # CLOCK_CONTROL_NRF_DRIVER_CALIBRATION
|
|
endif # CLOCK_CONTROL_NRF_K32SRC_RC_CALIBRATION
|
|
|
|
choice CLOCK_CONTROL_NRF_ACCURACY_PPM
|
|
prompt "32KHz clock accuracy"
|
|
default CLOCK_CONTROL_NRF_K32SRC_500PPM if CLOCK_CONTROL_NRF_K32SRC_RC && SOC_COMPATIBLE_NRF52X
|
|
default CLOCK_CONTROL_NRF_K32SRC_250PPM if CLOCK_CONTROL_NRF_K32SRC_RC
|
|
default CLOCK_CONTROL_NRF_K32SRC_50PPM
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_500PPM
|
|
bool "251 ppm to 500 ppm"
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_250PPM
|
|
bool "151 ppm to 250 ppm"
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_150PPM
|
|
bool "101 ppm to 150 ppm"
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_100PPM
|
|
bool "76 ppm to 100 ppm"
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_75PPM
|
|
bool "51 ppm to 75 ppm"
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_50PPM
|
|
bool "31 ppm to 50 ppm"
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_30PPM
|
|
bool "21 ppm to 30 ppm"
|
|
|
|
config CLOCK_CONTROL_NRF_K32SRC_20PPM
|
|
bool "0 ppm to 20 ppm"
|
|
|
|
endchoice
|
|
|
|
config CLOCK_CONTROL_NRF_ACCURACY
|
|
int
|
|
default 500 if CLOCK_CONTROL_NRF_K32SRC_500PPM
|
|
default 250 if CLOCK_CONTROL_NRF_K32SRC_250PPM
|
|
default 150 if CLOCK_CONTROL_NRF_K32SRC_150PPM
|
|
default 100 if CLOCK_CONTROL_NRF_K32SRC_100PPM
|
|
default 75 if CLOCK_CONTROL_NRF_K32SRC_75PPM
|
|
default 50 if CLOCK_CONTROL_NRF_K32SRC_50PPM
|
|
default 30 if CLOCK_CONTROL_NRF_K32SRC_30PPM
|
|
default 20 if CLOCK_CONTROL_NRF_K32SRC_20PPM
|
|
|
|
endif # CLOCK_CONTROL_NRF
|
|
|
|
config CLOCK_CONTROL_NRF2
|
|
bool "nRF clock control support"
|
|
depends on SOC_SERIES_NRF54HX && !RISCV_CORE_NORDIC_VPR
|
|
select ONOFF
|
|
select NRFS if HAS_NRFS
|
|
imply NRFS_LOCAL_DOMAIN_DVFS_SCALE_DOWN_AFTER_INIT if NRFS_DVFS_LOCAL_DOMAIN
|
|
help
|
|
Support for nRF clock control devices.
|
|
|
|
if CLOCK_CONTROL_NRF2
|
|
|
|
config CLOCK_CONTROL_NRF2_NRFS_DVFS_TIMEOUT_MS
|
|
int "Timeout waiting for nrfs dvfs service callback in milliseconds"
|
|
default 2000
|
|
|
|
config CLOCK_CONTROL_NRF2_NRFS_CLOCK_TIMEOUT_MS
|
|
int "Timeout waiting for nrfs clock service callback in milliseconds"
|
|
default 1000
|
|
|
|
endif # CLOCK_CONTROL_NRF2
|