tree-wide: Introduce netif feature and use it

This gets rid of a long list of boards with network interfaces and
instead let's boards (or MCUs with peripheral network interfaces)
provide the netif feature.

The apps that before used the long list are not depending on the
feature instead (in case of the default example, this is an
optional dependency).

Co-authored-by: mguetschow <mikolai.guetschow@tu-dresden.de>
Co-authored-by: mewen.berthelot <mewen.berthelot@orange.com>

boards/b-l072z-lrwan1/Makefile.features

@@ -11,7 +11,5 @@ FEATURES_PROVIDED += periph_timer
 FEATURES_PROVIDED += periph_uart
 
 # Put other features for this board (in alphabetical order)
-# For riotboot you need an openocd that supports dualbank flashing.
+FEATURES_PROVIDED += netif
-# The 0.10.0 openocd version in Ubuntu Bionic doesn't work. The change was
-# introduced after Jun 8, 2017 - v0.10.0-1-20170607-2132-dev.
 FEATURES_PROVIDED += riotboot

boards/cc2538dk/Makefile.features

@@ -11,4 +11,5 @@ FEATURES_PROVIDED += periph_uart
 
 # Various other features (if any)
 FEATURES_PROVIDED += emulator_renode
+FEATURES_PROVIDED += netif
 FEATURES_PROVIDED += riotboot

boards/common/iotlab/Makefile.features

@@ -11,3 +11,4 @@ FEATURES_PROVIDED += periph_uart
 
 # Put other features for this board (in alphabetical order)
 FEATURES_PROVIDED += riotboot
+FEATURES_PROVIDED += netif

boards/common/kw41z/Makefile.features

@@ -9,4 +9,5 @@ FEATURES_PROVIDED += periph_timer
 FEATURES_PROVIDED += periph_uart
 
 # Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif
 FEATURES_PROVIDED += riotboot

boards/common/nrf52/Makefile.features

@@ -3,4 +3,7 @@ CPU = nrf52
 # Put defined MCU peripherals here (in alphabetical order)
 FEATURES_PROVIDED += periph_rtt
 FEATURES_PROVIDED += periph_timer
+
+# Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif
 FEATURES_PROVIDED += riotboot

boards/hamilton/Makefile.features

@@ -10,3 +10,6 @@ FEATURES_PROVIDED += periph_rtc
 FEATURES_PROVIDED += periph_rtt
 FEATURES_PROVIDED += periph_spi
 FEATURES_PROVIDED += periph_timer
+
+# Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif

boards/lobaro-lorabox/Makefile.features

@@ -7,3 +7,6 @@ FEATURES_PROVIDED += periph_rtc
 FEATURES_PROVIDED += periph_spi periph_spi_gpio_mode
 FEATURES_PROVIDED += periph_timer
 FEATURES_PROVIDED += periph_uart
+
+# Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif

boards/lora-e5-dev/Makefile.features

@@ -13,3 +13,4 @@ FEATURES_PROVIDED += periph_uart
 # Put other features for this board (in alphabetical order)
 FEATURES_PROVIDED += arduino_pins
 FEATURES_PROVIDED += riotboot
+FEATURES_PROVIDED += netif

boards/lsn50/Makefile.features

@@ -11,7 +11,5 @@ FEATURES_PROVIDED += periph_timer
 FEATURES_PROVIDED += periph_uart
 
 # Put other features for this board (in alphabetical order)
-# For riotboot you need an openocd that supports dualbank flashing.
-# The 0.10.0 openocd version in Ubuntu Bionic doesn't work. The change was
-# introduced after Jun 8, 2017 - v0.10.0-1-20170607-2132-dev.
 FEATURES_PROVIDED += riotboot
+FEATURES_PROVIDED += netif

boards/mulle/Makefile.features

@@ -18,3 +18,6 @@ FEATURES_PROVIDED += periph_rtt
 FEATURES_PROVIDED += periph_spi
 FEATURES_PROVIDED += periph_timer
 FEATURES_PROVIDED += periph_uart
+
+# Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif

boards/native/common_features.inc.mk

@@ -7,6 +7,7 @@ FEATURES_PROVIDED += periph_gpio
 FEATURES_PROVIDED += periph_pwm
 FEATURES_PROVIDED += periph_qdec
 
-# Various other features (if any)
+# Put other features for this board (in alphabetical order)
 FEATURES_PROVIDED += ethernet
 FEATURES_PROVIDED += motor_driver
+FEATURES_PROVIDED += netif

boards/nucleo-f207zg/Makefile.features

@@ -14,6 +14,8 @@ FEATURES_PROVIDED += periph_uart
 FEATURES_PROVIDED += periph_usbdev
 
 # Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += ethernet
+FEATURES_PROVIDED += netif
 FEATURES_PROVIDED += riotboot
 FEATURES_PROVIDED += tinyusb_device
 

boards/nucleo-f429zi/Makefile.features

@@ -14,6 +14,8 @@ FEATURES_PROVIDED += periph_uart
 FEATURES_PROVIDED += periph_usbdev
 
 # Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += ethernet
+FEATURES_PROVIDED += netif
 FEATURES_PROVIDED += tinyusb_device
 
 # load the common Makefile.features for Nucleo boards

boards/nucleo-f439zi/Makefile.features

@@ -13,6 +13,8 @@ FEATURES_PROVIDED += periph_uart
 FEATURES_PROVIDED += periph_usbdev
 
 # Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += ethernet
+FEATURES_PROVIDED += netif
 FEATURES_PROVIDED += tinyusb_device
 
 # load the common Makefile.features for Nucleo boards

boards/nucleo-f767zi/Makefile.features

@@ -20,6 +20,8 @@ FEATURES_PROVIDED += periph_uart
 FEATURES_PROVIDED += periph_usbdev
 
 # Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += ethernet
+FEATURES_PROVIDED += netif
 FEATURES_PROVIDED += riotboot
 FEATURES_PROVIDED += tinyusb_device
 

boards/nucleo-wl55jc/Makefile.features

@@ -11,6 +11,7 @@ FEATURES_PROVIDED += periph_uart
 
 # Put other features for this board (in alphabetical order)
 FEATURES_PROVIDED += riotboot
+FEATURES_PROVIDED += netif
 
 # load the common Makefile.features for Nucleo boards
 include $(RIOTBOARD)/common/nucleo64/Makefile.features

boards/openlabs-kw41z-mini/Makefile.features

@@ -13,3 +13,6 @@ FEATURES_PROVIDED += periph_spi
 FEATURES_PROVIDED += periph_timer
 FEATURES_PROVIDED += periph_uart
 FEATURES_PROVIDED += riotboot
+
+# Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif

boards/pba-d-01-kw2x/Makefile.features

@@ -15,3 +15,4 @@ FEATURES_PROVIDED += periph_uart
 
 # Put other features for this board (in alphabetical order)
 FEATURES_PROVIDED += riotboot
+FEATURES_PROVIDED += netif

boards/same54-xpro/Makefile.features

@@ -19,5 +19,7 @@ FEATURES_PROVIDED += periph_freqm
 FEATURES_PROVIDED += periph_can
 
 # Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += ethernet
+FEATURES_PROVIDED += netif
 FEATURES_PROVIDED += riotboot
 FEATURES_PROVIDED += tinyusb_device

boards/samr21-xpro/Makefile.features

@@ -14,5 +14,6 @@ FEATURES_PROVIDED += periph_uart_hw_fc
 FEATURES_PROVIDED += periph_usbdev
 
 # Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif
 FEATURES_PROVIDED += riotboot
 FEATURES_PROVIDED += tinyusb_device

boards/samr30-xpro/Makefile.features

@@ -12,5 +12,6 @@ FEATURES_PROVIDED += periph_uart
 FEATURES_PROVIDED += periph_usbdev
 
 # Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif
 FEATURES_PROVIDED += riotboot
 FEATURES_PROVIDED += tinyusb_device

boards/spark-core/Makefile.features

@@ -5,3 +5,6 @@ CPU_MODEL = stm32f103cb
 FEATURES_PROVIDED += periph_timer
 FEATURES_PROVIDED += periph_spi
 FEATURES_PROVIDED += periph_uart
+
+# Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif

boards/stm32f746g-disco/features-shared.mk

@@ -15,4 +15,8 @@ FEATURES_PROVIDED += periph_uart
 FEATURES_PROVIDED += periph_usbdev
 FEATURES_PROVIDED += periph_usbdev_hs
 FEATURES_PROVIDED += periph_usbdev_hs_ulpi
+
+# Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += ethernet
+FEATURES_PROVIDED += netif
 FEATURES_PROVIDED += tinyusb_device

boards/telosb/Makefile.features

@@ -7,4 +7,5 @@ FEATURES_PROVIDED += periph_spi
 FEATURES_PROVIDED += periph_timer
 FEATURES_PROVIDED += periph_uart
 
-# Various other features (if any)
+# Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif

boards/z1/Makefile.features

@@ -7,4 +7,5 @@ FEATURES_PROVIDED += periph_spi
 FEATURES_PROVIDED += periph_timer
 FEATURES_PROVIDED += periph_uart
 
-# Various other features (if any)
+# Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif

boards/zigduino/Makefile.features

@@ -12,3 +12,6 @@ FEATURES_PROVIDED += periph_uart
 # Put defined MCU peripherals here (in alphabetical order)
 # Peripherals are defined in common/arduino-atmega/Makefile.features
 # Add only additional Peripherals
+#
+# Put other features for this board (in alphabetical order)
+FEATURES_PROVIDED += netif

cpu/atmega128rfa1/Makefile.features

@@ -4,3 +4,6 @@ include $(RIOTCPU)/atmega_common/Makefile.features
 
 # additional PCINT for atmega128rfa1
 FEATURES_PROVIDED += atmega_pcint1
+
+# MCU has a peripheral network interface
+FEATURES_PROVIDED += netif

cpu/atmega256rfr2/Makefile.features

@@ -4,3 +4,6 @@ include $(RIOTCPU)/atmega_common/Makefile.features
 
 # additional PCINT for atmega256rfr2
 FEATURES_PROVIDED += atmega_pcint1
+
+# MCU has a peripheral network interface
+FEATURES_PROVIDED += netif

cpu/cc2538/Makefile.features

@@ -15,4 +15,7 @@ FEATURES_PROVIDED += periph_wdt
 
 FEATURES_PROVIDED += cortexm_mpu
 
+# MCU has a peripheral network interface
+FEATURES_PROVIDED += netif
+
 include $(RIOTCPU)/cortexm_common/Makefile.features

cpu/esp_common/Makefile.features

@@ -30,5 +30,8 @@ ifeq (rv32,$(CPU_ARCH))
   FEATURES_PROVIDED += arch_esp_riscv
 endif
 
+# All ESP* MCUs have a peripheral network interface
+FEATURES_PROVIDED += netif
+
 FEATURES_CONFLICT += esp_wifi_ap:esp_now
 FEATURES_CONFLICT_MSG += "ESP_NOW and ESP_WIFI_AP can not be used at the same time."

cpu/nrf5x_common/Makefile.features

@@ -33,6 +33,7 @@ ifeq (,$(filter nrf9160 nrf5340_app,$(CPU_MODEL)))
   FEATURES_PROVIDED += ble_nimble
   FEATURES_PROVIDED += radio_nrfble
   FEATURES_PROVIDED += radio_nrfmin
+  FEATURES_PROVIDED += netif
 endif
 
 include $(RIOTCPU)/cortexm_common/Makefile.features

examples/default/Makefile

@@ -34,20 +34,10 @@ USEMODULE += ps
 # include and auto-initialize all available sensors
 USEMODULE += saul_default
 
-include $(RIOTBASE)/tests/Makefile.boards.netif
+# Use a network interface, if available. The handling is done in
-ifneq (,$(filter $(BOARD),$(BOARD_PROVIDES_NETIF)))
+# Makefile.board.dep, which is processed recursively as part of the dependency
-  # Use modules for networking
+# resolution.
-  # gnrc is a meta module including all required, basic gnrc networking modules
+FEATURES_OPTIONAL += netif
-  USEMODULE += gnrc
-  # use the default network interface for the board
-  USEMODULE += netdev_default
-  # automatically initialize the network interface
-  USEMODULE += auto_init_gnrc_netif
-  # shell command to send L2 packets with a simple string
-  USEMODULE += gnrc_txtsnd
-  # the application dumps received packets to stdout
-  USEMODULE += gnrc_pktdump
-endif
 
 FEATURES_OPTIONAL += periph_rtc
 
@@ -58,14 +48,5 @@ endif
 
 include $(RIOTBASE)/Makefile.include
 
-ifneq (,$(filter $(BOARD),$(BOARD_PROVIDES_NETIF)))
-  # We use only the lower layers of the GNRC network stack, hence, we can
-  # reduce the size of the packet buffer a bit
-  # Set GNRC_PKTBUF_SIZE via CFLAGS if not being set via Kconfig.
-  ifndef CONFIG_GNRC_PKTBUF_SIZE
-    CFLAGS += -DCONFIG_GNRC_PKTBUF_SIZE=512
-  endif
-endif
-
 # Set a custom channel if needed
 include $(RIOTMAKE)/default-radio-settings.inc.mk

examples/default/Makefile.board.dep

@@ -0,0 +1,20 @@
+ifneq (,$(filter netif,$(FEATURES_USED)))
+  # Use modules for networking
+  # gnrc is a meta module including all required, basic gnrc networking modules
+  USEMODULE += gnrc
+  # use the default network interface for the board
+  USEMODULE += netdev_default
+  # automatically initialize the network interface
+  USEMODULE += auto_init_gnrc_netif
+  # shell command to send L2 packets with a simple string
+  USEMODULE += gnrc_txtsnd
+  # the application dumps received packets to stdout
+  USEMODULE += gnrc_pktdump
+
+  # We use only the lower layers of the GNRC network stack, hence, we can
+  # reduce the size of the packet buffer a bit
+  # Set GNRC_PKTBUF_SIZE via CFLAGS if not being set via Kconfig.
+  ifndef CONFIG_GNRC_PKTBUF_SIZE
+    CFLAGS += -DCONFIG_GNRC_PKTBUF_SIZE=512
+  endif
+endif

features.yaml

@@ -879,6 +879,8 @@ groups:
   features:
   - name: ethernet
     help: The board has Ethernet connectivity
+  - name: netif
+    help: The board has a network interface
   - name: highlevel_stdio
     help: A high-level stdio method (such as CDC ACM) is used. This requires a
           running thread and set-up and will not print during a crash.

makefiles/features_existing.inc.mk

@@ -132,6 +132,7 @@ FEATURES_EXISTING := \
     highlevel_stdio \
     libstdcpp \
     motor_driver \
+    netif \
     newlib \
     no_idle_thread \
     periph_adc \

tests/Makefile.boards.netif

@@ -1,63 +0,0 @@
-# Non-exhaustive list of BOARDs providing a net interface, extend as needed
-# keeping alfabetical order
-BOARD_PROVIDES_NETIF := \
-    airfy-beacon \
-    arduino-nano-33-ble \
-    atmega256rfr2-xpro \
-    avr-rss2 \
-    b-l072z-lrwan1 \
-    calliope-mini \
-    cc2538dk \
-    derfmega128 \
-    derfmega256 \
-    dwm1001 \
-    esp32-wroom-32 \
-    frdm-kw41z \
-    generic-cc2538-cc2592-dk \
-    hamilton \
-    iotlab-a8-m3 \
-    iotlab-m3 \
-    lobaro-lorabox \
-    lora-e5-dev \
-    lsn50 \
-    microbit \
-    microbit-v2 \
-    microduino-corerf \
-    msba2 \
-    mulle \
-    native \
-    native64 \
-    nrf51dk \
-    nrf51dongle \
-    nrf52840-mdk \
-    nrf52840dk \
-    nrf52840dongle \
-    nrf52dk \
-    nrf6310 \
-    nucleo-f207zg \
-    nucleo-f429zi \
-    nucleo-f439zi \
-    nucleo-f767zi \
-    nucleo-wl55jc \
-    openlabs-kw41z-mini \
-    openlabs-kw41z-mini-256kib \
-    openmote-b \
-    openmote-cc2538 \
-    pba-d-01-kw2x \
-    phynode-kw41z \
-    remote-pa \
-    remote-reva \
-    ruuvitag \
-    same54-xpro \
-    samr21-xpro \
-    samr30-xpro \
-    spark-core \
-    stm32f746g-disco \
-    stm32f7508-dk \
-    telosb \
-    thingy52 \
-    usb-kw41z \
-    yunjia-nrf51822 \
-    z1 \
-    zigduino \
-    #

tests/net/netstats_l2/Makefile

@@ -1,7 +1,6 @@
 include ../Makefile.net_common
-include $(RIOTBASE)/tests/Makefile.boards.netif
 
-BOARD_WHITELIST += $(BOARD_PROVIDES_NETIF)
+FEATURES_REQUIRED += netif
 
 USEMODULE += shell
 USEMODULE += shell_cmds_default

tests/pkg/edhoc_c/Makefile

@@ -1,7 +1,6 @@
 include ../Makefile.pkg_common
 
-include $(RIOTBASE)/tests/Makefile.boards.netif
+FEATURES_REQUIRED += netif
-BOARD_WHITELIST += $(BOARD_PROVIDES_NETIF)
 # Cannot run the test on `murdock` in `native`
 #   open(/dev/net/tun): No such file or directory
 TEST_ON_CI_BLACKLIST += native native64