ce8af54ce8
Calibration process can be simplified if LF clock is always on. Kconfig was depending on RTC being used as system clock because that indicates LF clock being always on. Same can be done for case when GRTC is used as system clock. Signed-off-by: Krzysztof Chruściński <krzysztof.chruscinski@nordicsemi.no>
264 lines
7.9 KiB
Plaintext
264 lines
7.9 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 || NRF_GRTC_TIMER
|
|
help
|
|
If RTC or GRTC 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
|
|
|
|
config CLOCK_CONTROL_NRF_HFINT_CALIBRATION
|
|
bool "HFINT clock calibration"
|
|
depends on SOC_NRF54L05 || SOC_NRF54L10 || SOC_NRF54L15
|
|
depends on DT_HAS_NORDIC_NRF_HFXO_ENABLED
|
|
depends on !TRUSTED_EXECUTION_NONSECURE
|
|
select EXPERIMENTAL
|
|
help
|
|
Enables calibration of HFINT clock on every start of HFXO clock.
|
|
|
|
if CLOCK_CONTROL_NRF_HFINT_CALIBRATION
|
|
|
|
config CLOCK_CONTROL_NRF_HFINT_CALIBRATION_PERIOD
|
|
int "HFINT clock calibration period in milliseconds"
|
|
default 60000
|
|
help
|
|
Periodically, HFINT clock calibration is performed.
|
|
This includes requesting HFXO clock and starting actual calibration.
|
|
Once the calibration is finished, the HFXO clock is released.
|
|
Set to 0 to disable periodic calibration - in such case calibration
|
|
will be done only when HFXO is started by the application itself.
|
|
|
|
endif # CLOCK_CONTROL_NRF_HFINT_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"
|
|
default y
|
|
depends on SOC_SERIES_NRF54HX && !RISCV_CORE_NORDIC_VPR
|
|
select ONOFF
|
|
select NRFS if HAS_NRFS
|
|
help
|
|
Support for nRF clock control devices.
|
|
|
|
if CLOCK_CONTROL_NRF2
|
|
|
|
config CLOCK_CONTROL_NRF2_HSFLL_REQ_LOW_FREQ
|
|
bool "Local domain scale down after init"
|
|
default y if NRFS_DVFS_LOCAL_DOMAIN
|
|
help
|
|
Request the lowest operating point after DVFS initialization.
|
|
|
|
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
|
|
|
|
config CLOCK_CONTROL_NRF2_GLOBAL_HSFLL
|
|
bool "Clock control for global HSFLL"
|
|
depends on NRFS_GDFS_SERVICE_ENABLED
|
|
default y
|
|
|
|
if CLOCK_CONTROL_NRF2_GLOBAL_HSFLL
|
|
|
|
config CLOCK_CONTROL_NRF2_GLOBAL_HSFLL_TIMEOUT_MS
|
|
int "Frequency request timeout in milliseconds"
|
|
default 10000
|
|
|
|
config CLOCK_CONTROL_NRF2_GLOBAL_HSFLL_REQ_LOW_FREQ
|
|
bool "Request LOW frequency on init"
|
|
default y
|
|
help
|
|
The GDFS service will default to HIGH frequency until it receives
|
|
a lower frequency request. The NRF2 clock controller drivers
|
|
expect the clock to be initialized to their lowest frequency, so
|
|
we need to send a request on init to align GDFS with the NRF2
|
|
clock controller driver.
|
|
|
|
This initial request can be disabled to prevent a potentially
|
|
unnecessary HIGH -> LOW -> HIGH cycle given some module will
|
|
request a HIGH frequency on init anyway.
|
|
|
|
config CLOCK_CONTROL_NRF2_GLOBAL_HSFLL_INIT_PRIORITY
|
|
int "Init priority of global HSFLL device driver"
|
|
default 52
|
|
help
|
|
Must be higher than NRFS backend
|
|
|
|
endif # CLOCK_CONTROL_NRF2_GLOBAL_HSFLL
|
|
|
|
config CLOCK_CONTROL_NRF2_AUDIOPLL
|
|
bool "NRFS AudioPLL driver support"
|
|
depends on DT_HAS_NORDIC_NRFS_AUDIOPLL_ENABLED
|
|
depends on NRFS_AUDIOPLL_SERVICE_ENABLED
|
|
default y
|
|
|
|
endif # CLOCK_CONTROL_NRF2
|