zephyr/drivers/gpio/Kconfig.nrf5
Ulf Magnusson ec3eff57e0 Kconfig: Use the first default with a satisfied condition
Up until now, Zephyr has patched Kconfig to use the last 'default' with
a satisfied condition, instead of the first one. I'm not sure why the
patch was added (it predates Kconfiglib), but I suspect it's related to
Kconfig.defconfig files.

There are at least three problems with the patch:

  1. It's inconsistent with how Kconfig works in other projects, which
     might confuse newcomers.

  2. Due to oversights, earlier 'range' properties are still preferred,
     as well as earlier 'default' properties on choices.

     In addition to being inconsistent, this makes it impossible to
     override 'range' properties and choice 'default' properties if the
     base definition of the symbol/choice already has 'range'/'default'
     properties.

     I've seen errors caused by the inconsistency, and I suspect there
     are more.

  3. A fork of Kconfiglib that adds the patch needs to be maintained.

Get rid of the patch and go back to standard Kconfig behavior, as
follows:

  1. Include the Kconfig.defconfig files first instead of last in
     Kconfig.zephyr.

  2. Include boards/Kconfig and arch/<arch>/Kconfig first instead of
     last in arch/Kconfig.

  3. Include arch/<arch>/soc/*/Kconfig first instead of last in
     arch/<arch>/Kconfig.

  4. Swap a few other 'source's to preserve behavior for some scattered
     symbols with multiple definitions.

     Swap 'source's in some no-op cases too, where it might match the
     intent.

  5. Reverse the defaults on symbol definitions that have more than one
     default.

     Skip defaults that are mutually exclusive, e.g. where each default
     has an 'if <some board>' condition. They are already safe.

  6. Remove the prefer-later-defaults patch from Kconfiglib.

Testing was done with a Python script that lists all Kconfig
symbols/choices with multiple defaults, along with a whitelist of fixed
symbols. The script also verifies that there are no "unreachable"
defaults hidden by defaults without conditions

As an additional test, zephyr/.config was generated before and after the
change for several samples and checked to be identical (after sorting).

This commit includes some default-related cleanups as well:

  - Simplify some symbol definitions, e.g. where a default has 'if FOO'
    when the symbol already has 'depends on FOO'.

  - Remove some redundant 'default ""' for string symbols. This is the
    implicit default.

Piggyback fixes for swapped ranges on BT_L2CAP_RX_MTU and
BT_L2CAP_TX_MTU (caused by confusing inconsistency).

Piggyback some fixes for style nits too, e.g. unindented help texts.

Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2018-08-10 12:38:28 -07:00

80 lines
1.8 KiB
Text

# Kconfig.nrf5 - Nordic Semiconductor nRF5x GPIO configuration options
#
# Copyright (c) 2016-2018 Nordic Semiconductor ASA
#
# SPDX-License-Identifier: Apache-2.0
#
menuconfig GPIO_NRF5
bool "Nordic Semiconductor nRF5x-based GPIO driver"
depends on GPIO && SOC_FAMILY_NRF
select HAS_DTS_GPIO if SOC_SERIES_NRF52X
help
Enable GPIO driver for nRF5 line of MCUs.
if GPIO_NRF5
config GPIO_NRF5_P0
bool "nRF5x GPIO Port P0"
help
Enable nRF5 GPIO port P0 config options.
config GPIO_NRF5_P1
bool "nRF5x GPIO Port P1"
depends on SOC_NRF52840
help
Enable nRF5 GPIO port P1 config options.
if !HAS_DTS_GPIO
config GPIO_NRF5_P0_DEV_NAME
string "GPIO Port P0 Device Name"
depends on GPIO_NRF5_P0
default "GPIO_0"
help
Specify the device name to be used for the GPIO port.
config GPIO_NRF5_P1_DEV_NAME
string "GPIO Port P1 Device Name"
depends on GPIO_NRF5_P1
default "GPIO_1"
help
Specify the device name to be used for the GPIO port.
config GPIOTE_NRF5_IRQ_PRI
int "GPIOTE interrupt priority"
depends on GPIO_NRF5_P0 || GPIO_NRF5_P1
range 0 2 if SOC_SERIES_NRF51X
range 0 5 if SOC_SERIES_NRF52X
default 2 if SOC_SERIES_NRF51X
default 5 if SOC_SERIES_NRF52X
help
nRF5 GPIOTE IRQ priority.
config GPIOTE_NRF5_IRQ
int "GPIOTE interrupt number"
depends on GPIO_NRF5_P0 || GPIO_NRF5_P1
range 6 6 if SOC_SERIES_NRF51X
range 6 6 if SOC_SERIES_NRF52X
default 6 if SOC_SERIES_NRF51X
default 6 if SOC_SERIES_NRF52X
help
nRF5 GPIOTE IRQ priority.
endif # !HAS_DTS_GPIO
config GPIO_NRF5_INIT_PRIORITY
int "nRF5 GPIO initialization priority"
default 40
help
Initialization priority for nRF5 GPIO.
config GPIO_NRF5_GPIOTE_CHAN_BASE
# hidden
int
default 4 if (BT_CTLR_GPIO_PA || BT_CTLR_GPIO_LNA) && PWM_NRF5_SW
default 3 if PWM_NRF5_SW
default 1 if (BT_CTLR_GPIO_PA || BT_CTLR_GPIO_LNA)
default 0
endif # GPIO_NRF5