Merge remote-tracking branch 'origin/master' into restructureExamples…

…Folder
RIOT-OS · Feb 12, 2025 · 2660fda · 2660fda
2 parents 6228475 + 9ae0023
commit 2660fda
Show file tree

Hide file tree

Showing 194 changed files with 4,423 additions and 875 deletions.
diff --git a/.gitignore b/.gitignore
@@ -43,6 +43,8 @@ cachegrind.out*
 tags
 # GDB initialization scripts
 .gdbinit
+# GDB history (when using gdb-dashboard)
+.gdb_history
 
 # Eclipse symbol file (output from make eclipsesym)
 eclipsesym.xml

diff --git a/.mailmap b/.mailmap
@@ -26,4 +26,6 @@ Peter Kietzmann <[email protected]>
 René Kijewski <[email protected]>
 René Kijewski <[email protected]> <[email protected]>
 Sebastian Meiling <[email protected]>
+Marian Buschsieweke <[email protected]> <[email protected]>
 Marian Buschsieweke <[email protected]> <[email protected]>
+Marian Buschsieweke <[email protected]> <[email protected]>
diff --git a/LOSTANDFOUND.md b/LOSTANDFOUND.md
@@ -302,6 +302,18 @@ therefore, have no interest in supporting this board. As result, none of the
 RIOT core contributors has access to the hardware, preventing us from doing the
 necessary testing for maintaining this board.
 
+### boards/nrf6310 [4953ba8e6759d2b1a1a1ea497a4ad1e71489195a]
+Author(s):
+- Christian Kühling <[email protected]>
+- Timo Ziegler <[email protected]>
+- Hauke Petersen <[email protected]>
+
+Reason for removal:
+- this was an early development board by Nordic which was discontinued
+ (successor: `nrf51dk`)
+- also for a `BLE DEVKIT.N` board from Mommosoft, which was discontinued as well
+- no hardware available anymore for testing, many exclusions from CI
+
 [6cad5d24771ba6199228351a11b5062cd2e9b36d]: https://github.com/RIOT-OS/RIOT/commit/6cad5d24771ba6199228351a11b5062cd2e9b36d
 [d83d08f0995a88f399e70a7d07b44dd780082436]: https://github.com/RIOT-OS/RIOT/commit/d83d08f0995a88f399e70a7d07b44dd780082436
 [cdc252ab7bd4161cc046bf93a3e55995704b24d4]: https://github.com/RIOT-OS/RIOT/commit/cdc252ab7bd4161cc046bf93a3e55995704b24d4
@@ -334,3 +346,4 @@ necessary testing for maintaining this board.
 [fe941ac9fe3f81c0f08ff3b8564cf439639abcda]: https://github.com/RIOT-OS/RIOT/commit/fe941ac9fe3f81c0f08ff3b8564cf439639abcda
 [81458c8eed8949c686d5ded652dbee10748e860b]: https://github.com/RIOT-OS/RIOT/commit/81458c8eed8949c686d5ded652dbee10748e860b
 [2b8a0d48940517f7df4e78c7a0b16024f46a8694]: https://github.com/RIOT-OS/RIOT/commit/2b8a0d48940517f7df4e78c7a0b16024f46a8694
+[4953ba8e6759d2b1a1a1ea497a4ad1e71489195a]: https://github.com/RIOT-OS/RIOT/commit/4953ba8e6759d2b1a1a1ea497a4ad1e71489195a
diff --git a/Makefile.include b/Makefile.include
@@ -934,7 +934,7 @@ include $(RIOTMAKE)/tools/targets.inc.mk
 include $(RIOTMAKE)/usb-codes.inc.mk
 
 # Warn if the selected board and drivers don't provide all needed features:
-ifneq (, $(filter all flash, $(if $(MAKECMDGOALS), $(MAKECMDGOALS), all)))
+ifeq (, $(filter help generate-Makefile.ci, $(MAKECMDGOALS)))
   EXPECT_ERRORS :=
 
   # Test if there where dependencies against a module in DISABLE_MODULE.
@@ -1012,7 +1012,8 @@ endif
 
 help:
   # filter all targets starting with lowercase and containing lowercase letters, hyphens, or underscores; explicitly include generate-Makefile.ci
-	@$(MAKE) -qp | sed -ne 's/\(^[a-z][a-z_-]*\|generate-Makefile.ci\):.*/\1/p' | sort -u
+  # inspired by: https://stackoverflow.com/a/26339924
+	@LC_ALL=C $(MAKE) -pRrq -f $(firstword $(MAKEFILE_LIST)) : 2>/dev/null | sed -ne 's/\(^[a-z][a-z_-]*\|generate-Makefile.ci\):.*/\1/p' | sort -u
 
 ifeq (iotlab-m3,$(BOARD))
   ifneq (,$(filter iotlab-%,$(MAKECMDGOALS)))

diff --git a/boards/arduino-due/doc.txt b/boards/arduino-due/doc.txt
@@ -3,5 +3,59 @@
 @ingroup     boards
 @brief       Support for the Arduino Due board
 
-@see boards_common_arduino_due for details
+\section arduino_due Arduino-Due
+
+## Table of Contents {#arduino_due_toc}
+
+1. [Overview](#arduino_due_overview)
+2. [Hardware](#arduino_due_hardware)
+    1. [MCU](#atmel_sam3x8e_mcu)
+    2. [Board Configuration](#arduino_due_board_configuration)
+    3. [Board Pinout](#arduino_due_pinout)
+3. [Flashing the Device](#arduino_due_flashing)
+
+## Overview {#arduino_due_overview}
+
+The Arduino Due is a microcontroller board based on the Atmel SAM3X8E ARM Cortex-M3 CPU.
+It is the first Arduino board based on a 32-bit ARM core microcontroller.
+
+\image html "https://store.arduino.cc/cdn/shop/files/A000062_00.front_1000x750.jpg" "Arduino Due board" width=750px
+
+## Hardware {#arduino_due_hardware}
+
+### MCU {#atmel_sam3x8e_mcu}
+
+The board features a SAM3X8E MCU (ARM Cortex-M3) running at up to 84MHz.
+It embeds 96 KiB of SRAM and 512 KiB of flash memory.
+The board reference manual is available [here](https://docs.arduino.cc/resources/datasheets/A000062-datasheet.pdf)
+and the MCU datasheet is available [here](https://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-11057-32-bit-Cortex-M3-Microcontroller-SAM3X-SAM3A_Datasheet.pdf).
+
+### Board configuration {#arduino_due_board_configuration}
+The Arduino Due provides the following features:
+- 54 I/Os (of which 12 PWM outputs)
+- 12 analog inputs
+- 4 UARTs
+- 1 USB OTG
+- 2 DAC outputs
+- 2 TWI
+- 1 power jack
+- 1 SPI header
+- 1 JTAG header
+- 2 CAN Buses
+- A reset button
+- An erase button
+
+### Board pinout {#arduino_due_pinout}
+
+\image html "https://content.arduino.cc/assets/Pinout-Due_latest.png" "Arduino Due pinout"
+
+The board schematics are available [here](https://docs.arduino.cc/resources/schematics/A000056-schematics.pdf).
+
+## Flashing the device {#arduino_due_flashing}
+Flashing RIOT on the Arduino Due is quite straight forward as it relies on
+the preinstalled arduino bootloader. Connect your board using the programming
+port to your host computer and type:
+
+`make BOARD=arduino-due flash`
+
  */
diff --git a/boards/esp32-ethernet-kit-v1_0/doc.txt b/boards/esp32-ethernet-kit-v1_0/doc.txt
@@ -26,15 +26,15 @@
 
 ## Overview {#esp32_ethernet_kit_v1_0_overview}
 
-The Espressif [ESP32-Ethernet-Kit](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/hw-reference/esp32/get-started-ethernet-kit-v1.0.html) is a development board that uses the ESP32-WROVER-B module. Most important features of the board are
+The Espressif [ESP32-Ethernet-Kit](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32/esp32-ethernet-kit/user_guide.html) is a development board that uses the ESP32-WROVER-B module. Most important features of the board are
 
 - 100 Mbps Ethernet via IP101G PHY
 - USB bridge with JTAG interface
 
 Furthermore, some GPIOs are broken out for extension. The USB bridge based on FDI FT2232HL provides a JTAG interface for OCD debugging through the USB interface.
 For flashing and debugging the board, see \ref boards_esp32_esp-ethernet-kit common board documentation.
 
-@image html "https://docs.espressif.com/projects/esp-idf/en/latest/esp32/_images/esp32-ethernet-kit-v1.0.png" "ESP32-Ethernet-Kit V1.0" width=500
+@image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32/_images/esp32-ethernet-kit-v1.0.png" "ESP32-Ethernet-Kit V1.0" width=500
 
 [Back to table of contents](#esp32_ethernet_kit_v1_0_toc)
 

diff --git a/boards/esp32-ethernet-kit-v1_1/doc.txt b/boards/esp32-ethernet-kit-v1_1/doc.txt
@@ -34,7 +34,7 @@ The Espressif [ESP32-Ethernet-Kit](https://docs.espressif.com/projects/esp-idf/e
 Furthermore, some GPIOs are broken out for extension. The USB bridge based on FDI FT2232HL provides a JTAG interface for OCD debugging through the USB interface.
 For flashing and debugging the board, see \ref boards_esp32_esp-ethernet-kit common board documentation.
 
-@image html "https://docs.espressif.com/projects/esp-idf/en/latest/esp32/_images/esp32-ethernet-kit-v1.1.png" "ESP32-Ethernet-Kit V1.1" width=500
+@image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32/_images/esp32-ethernet-kit-v1.1.png" "ESP32-Ethernet-Kit V1.1" width=500
 
 [Back to table of contents](#esp32_ethernet_kit_v1_1_toc)
 

diff --git a/boards/esp32-ethernet-kit-v1_2/doc.txt b/boards/esp32-ethernet-kit-v1_2/doc.txt
@@ -34,7 +34,7 @@ The Espressif [ESP32-Ethernet-Kit](https://docs.espressif.com/projects/esp-idf/e
 Furthermore, some GPIOs are broken out for extension. The USB bridge based on FDI FT2232HL provides a JTAG interface for OCD debugging through the USB interface.
 For flashing and debugging the board, see \ref boards_esp32_esp-ethernet-kit common board documentation.
 
-@image html "https://docs.espressif.com/projects/esp-idf/en/latest/esp32/_images/esp32-ethernet-kit-v1.2.jpg" "ESP32-Ethernet-Kit V1.2" width=500
+@image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32/_images/esp32-ethernet-kit-v1.2.jpg" "ESP32-Ethernet-Kit V1.2" width=500
 
 [Back to table of contents](#esp32_ethernet_kit_v1_2_toc)
 

diff --git a/boards/esp32-heltec-lora32-v2/doc.txt b/boards/esp32-heltec-lora32-v2/doc.txt
@@ -37,7 +37,7 @@ Since the board is
 [open source hardware](https://github.com/Heltec-Aaron-Lee/WiFi_Kit_series),
 a number of clones are available.
 
-@image html "https://heltec.org/wp-content/uploads/2020/04/SAM_0748_800X800.png" "Heltec WiFi Lora 32 V2" width=400px
+@image html "https://heltec.org/wp-content/uploads/2024/07/wifi-lora-32-v2-1.png" "Heltec WiFi Lora 32 V2" width=400px
 
 [Back to table of contents](#esp32_heltec_lora32_v2_toc)
 

diff --git a/boards/esp32c3-devkit/doc.txt b/boards/esp32c3-devkit/doc.txt
@@ -36,7 +36,7 @@ limited, the ESP32-C3-DevKit should also work for most other ESP32-C3 boards.
 Any modifications required for specific applications could be overridden by
 \ref esp32_application_specific_configurations "application-specific board configuration".
 
-\image html "https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/_images/esp32-c3-devkitm-1-v1-annotated-photo.png" "Espressif ESP32-C3-DevKitM-1" width=800px
+\image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32c3/_images/esp32-c3-devkitm-1-v1-annotated-photo.png" "Espressif ESP32-C3-DevKitM-1" width=800px
 
 [Back to table of contents](#esp32c3_devkit_toc)
 

diff --git a/boards/esp32s2-devkit/doc.txt b/boards/esp32s2-devkit/doc.txt
@@ -35,7 +35,7 @@ the following modules:
 - ESP32-S2-WROOM module (ESP32-S2-Saola-1 board)
 - ESP32-S2-WROVER-N4R2 module (ESP32-S2-Saola-1R board)
 
-\image html "https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/_images/esp32-s2-devkitm-1-v1-annotated-photo.png" "Espressif ESP32-S2-DevKitM-1" width=600px
+\image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s2/_images/esp32-s2-devkitm-1-v1-annotated-photo.png" "Espressif ESP32-S2-DevKitM-1" width=600px
 
 <br>
 Due to the different modules used, the available versions of the
@@ -174,9 +174,9 @@ boards, see section \ref esp32_peripherals "Common Peripherals".
 The following figures show the pinouts as configured by default board
 definition.
 
-@image html https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/_images/esp32-s2-devkitm-1-v1-pin-layout.png "ESP32-S2-DevKitM-1x Pinout" width=900px
-@image html https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/_images/esp32-s2-devkitc-1-v1-pinout.png "ESP32-S2-DevKitC-1x Pinout" width=900px
-@image html https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/_images/esp32-s2_saola1-pinout.jpg "ESP32-S2-Saola-1x Pinout" width=900px
+@image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s2/_images/esp32-s2-devkitm-1-v1-pin-layout.png" "ESP32-S2-DevKitM-1x Pinout" width=900px
+@image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s2/_images/esp32-s2-devkitm-1-v1-pin-layout.png" "ESP32-S2-DevKitC-1x Pinout" width=900px
+@image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s2/_images/esp32-s2_saola1-pinout.jpg" "ESP32-S2-Saola-1x Pinout" width=900px
 
 The corresponding board schematics can be found:
 

diff --git a/boards/esp32s3-devkit/doc.txt b/boards/esp32s3-devkit/doc.txt
@@ -32,7 +32,7 @@ the following modules:
 - ESP32-S3-WROOM-1x module (ESP32-S3-DevKitC-1 board)
 - ESP32-S3-WROOM-2 module (ESP32-S3-DevKitC-1 board)
 
-\image html "https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/_images/ESP32-S3-DevKitC-1_v2-annotated-photo.png" "Espressif ESP32-S3-DevKitM-1" width=600px
+\image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/_images/ESP32-S3-DevKitC-1_v2-annotated-photo.png" "Espressif ESP32-S3-DevKitM-1" width=600px
 
 <br>
 Due to the different modules used, the available versions of the
@@ -179,8 +179,8 @@ boards, see section \ref esp32_peripherals "Common Peripherals".
 The following figures show the pinouts as configured by default board
 definition.
 
-@image html https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/_images/ESP32-S3_DevKitC-1_pinlayout.jpg "ESP32-S3-DevKitC-1 Pinout" width=900px
-@image html https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/_images/ESP32-S3_DevKitM-1_pinlayout.jpg "ESP32-S3-DevKitM-1 Pinout" width=900px
+@image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/_images/ESP32-S3_DevKitC-1_pinlayout_v1.1.jpg" "ESP32-S3-DevKitC-1 Pinout" width=900px
+@image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/_images/ESP32-S3_DevKitM-1_pinlayout.jpg" "ESP32-S3-DevKitM-1 Pinout" width=900px
 
 The corresponding board schematics can be found:
 

diff --git a/boards/esp32s3-usb-otg/doc.txt b/boards/esp32s3-usb-otg/doc.txt
@@ -32,7 +32,7 @@ it is equipped with two USB type A ports:
 - `USB_DEV` male port that is used to connect the board as a USB device to a host.
 - `USB_HOST` female port that is used to connect other USB devices to the board.
 
-\image html "https://docs.espressif.com/projects/espressif-esp-dev-kits/en/latest/_images/pic_board_top_lable.png" "Espressif ESP32-S3-USB-OTG" width=600px
+\image html "https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/_images/pic_board_top_lable.png" "Espressif ESP32-S3-USB-OTG" width=600px
 
 @note RIOT-OS does only support the `USB_DEV` port, that is the board can only
       be used as USB device.

diff --git a/boards/nrf6310/Kconfig b/boards/nrf6310/Kconfig
diff --git a/boards/nrf6310/Makefile b/boards/nrf6310/Makefile
diff --git a/boards/nrf6310/Makefile.dep b/boards/nrf6310/Makefile.dep
diff --git a/boards/nrf6310/Makefile.features b/boards/nrf6310/Makefile.features
diff --git a/boards/nrf6310/Makefile.include b/boards/nrf6310/Makefile.include
diff --git a/boards/nrf6310/board.c b/boards/nrf6310/board.c
diff --git a/boards/nrf6310/doc.txt b/boards/nrf6310/doc.txt
diff --git a/boards/nrf6310/include/board.h b/boards/nrf6310/include/board.h