| # 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_K32SRC_FREQUENCY |
| int "32k source clock frequency" |
| default 32768 |
| |
| 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" |
| select NRFX_CLOCK_LF_SRC_RC if !CLOCK_CONTROL_NRF_FORCE_ALT |
| |
| config CLOCK_CONTROL_NRF_K32SRC_XTAL |
| bool "Crystal Oscillator" |
| select NRFX_CLOCK_LF_SRC_XTAL if !CLOCK_CONTROL_NRF_FORCE_ALT |
| select NRFX_CLOCK_LFXO_TWO_STAGE_ENABLED if (!SOC_SERIES_BSIM_NRFXX && \ |
| !CLOCK_CONTROL_NRF_FORCE_ALT) |
| |
| config CLOCK_CONTROL_NRF_K32SRC_SYNTH |
| bool "Synthesized from HFCLK" |
| depends on !SOC_SERIES_NRF91X |
| select NRFX_CLOCK_LF_SRC_SYNTH if !CLOCK_CONTROL_NRF_FORCE_ALT |
| |
| config CLOCK_CONTROL_NRF_K32SRC_EXT_LOW_SWING |
| bool "External low swing" |
| depends on SOC_SERIES_NRF52X |
| select NRFX_CLOCK_LFXO_TWO_STAGE_ENABLED if !CLOCK_CONTROL_NRF_FORCE_ALT |
| select NRFX_CLOCK_LF_SRC_LOW_SWING if !CLOCK_CONTROL_NRF_FORCE_ALT |
| |
| config CLOCK_CONTROL_NRF_K32SRC_EXT_FULL_SWING |
| bool "External full swing" |
| depends on SOC_SERIES_NRF52X |
| select NRFX_CLOCK_LFXO_TWO_STAGE_ENABLED if !CLOCK_CONTROL_NRF_FORCE_ALT |
| select NRFX_CLOCK_LF_SRC_FULL_SWING if !CLOCK_CONTROL_NRF_FORCE_ALT |
| |
| 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 |
| select NRFX_CLOCK_LF_CAL_ENABLED if !CLOCK_CONTROL_NRF_FORCE_ALT |
| 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 DT_HAS_NORDIC_NRF54L_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_COMMON |
| bool |
| depends on HAS_NORDIC_DRIVERS |
| select ONOFF |
| |
| config CLOCK_CONTROL_NRF_HSFLL_GLOBAL |
| bool "Clock control for global HSFLL" |
| depends on DT_HAS_NORDIC_NRF_HSFLL_GLOBAL_ENABLED |
| select NRFS |
| select NRFS_GDFS_SERVICE_ENABLED |
| select CLOCK_CONTROL_NRF2_COMMON |
| default y |
| |
| if CLOCK_CONTROL_NRF_HSFLL_GLOBAL |
| |
| config CLOCK_CONTROL_NRF_HSFLL_GLOBAL_TIMEOUT_MS |
| int "Frequency request timeout in milliseconds" |
| default 10000 |
| |
| config CLOCK_CONTROL_NRF_HSFLL_GLOBAL_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_NRF_HSFLL_GLOBAL_INIT_PRIORITY |
| int "Init priority of global HSFLL device driver" |
| default 52 |
| help |
| Must be higher than NRFS backend |
| |
| endif # CLOCK_CONTROL_NRF_HSFLL_GLOBAL |
| |
| config CLOCK_CONTROL_NRFS_AUDIOPLL |
| bool "NRFS AudioPLL driver support" |
| depends on DT_HAS_NORDIC_NRFS_AUDIOPLL_ENABLED |
| select NRFS |
| select NRFS_AUDIOPLL_SERVICE_ENABLED |
| select CLOCK_CONTROL_NRF2_COMMON |
| default y |
| |
| config CLOCK_CONTROL_NRF_FLL16M |
| bool "NRF FLL16M driver support" |
| depends on DT_HAS_NORDIC_NRF_FLL16M_ENABLED |
| select CLOCK_CONTROL_NRF2_COMMON |
| default y |
| |
| config CLOCK_CONTROL_NRF54H_HFXO |
| bool "NRF54H HFXO driver support" |
| depends on DT_HAS_NORDIC_NRF54H_HFXO_ENABLED |
| select CLOCK_CONTROL_NRF2_COMMON |
| default y |
| |
| config CLOCK_CONTROL_NRF_HSFLL_LOCAL |
| bool "NRF HSFLL LOCAL driver support" |
| depends on DT_HAS_NORDIC_NRF_HSFLL_LOCAL_ENABLED |
| select NRFS |
| select NRFS_DVFS_LOCAL_DOMAIN |
| select CLOCK_CONTROL_NRF2_COMMON |
| default y |
| |
| if CLOCK_CONTROL_NRF_HSFLL_LOCAL |
| |
| config CLOCK_CONTROL_NRF_HSFLL_LOCAL_REQ_LOW_FREQ |
| bool "Local domain scale down after init" |
| help |
| Request the lowest operating point after DVFS initialization. |
| |
| config CLOCK_CONTROL_NRF_HSFLL_LOCAL_NRFS_DVFS_TIMEOUT_MS |
| int "Timeout waiting for nrfs dvfs service callback in milliseconds" |
| default 2000 |
| |
| endif # CLOCK_CONTROL_NRF_HSFLL_LOCAL |
| |
| config CLOCK_CONTROL_NRF_LFCLK |
| bool "NRF LFCLK driver support" |
| depends on DT_HAS_NORDIC_NRF_LFCLK_ENABLED |
| select NRFS |
| select NRFS_CLOCK_SERVICE_ENABLED |
| select CLOCK_CONTROL_NRF2_COMMON |
| default y |
| |
| if CLOCK_CONTROL_NRF_LFCLK |
| |
| config CLOCK_CONTROL_NRF_LFCLK_CLOCK_TIMEOUT_MS |
| int "Timeout waiting for nrfs clock service callback in milliseconds" |
| default 1000 |
| |
| endif # CLOCK_CONTROL_NRF_LFCLK |
| |
| config CLOCK_CONTROL_NRF_AUXPLL |
| bool "nRF Auxiliary PLL driver" |
| default y |
| depends on DT_HAS_NORDIC_NRF_AUXPLL_ENABLED |
| select CLOCK_CONTROL_NRF2_COMMON |
