From 9a45c302224ab5f56782b9d72bb64748d5ab74ba Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mikolai=20G=C3=BCtschow?= Date: Mon, 17 Feb 2025 12:00:19 +0100 Subject: [PATCH] examples: shorten subfolders' names --- .murdock | 4 +- Makefile | 2 +- boards/adafruit-clue/doc.txt | 4 +- boards/adafruit-pybadge/doc.txt | 2 +- boards/alientek-pandora/doc.txt | 4 +- boards/arduino-mkrfox1200/doc.txt | 2 +- boards/arduino-mkrwan1300/doc.txt | 2 +- boards/arduino-nano-33-ble-sense/doc.txt | 4 +- boards/arduino-nano-33-ble/doc.txt | 4 +- boards/arduino-nano-33-iot/doc.txt | 2 +- boards/atmega256rfr2-xpro/doc.txt | 4 +- boards/common/nrf52/doc.txt | 6 +- boards/common/particle-mesh/doc.txt | 6 +- boards/dwm1001/doc.txt | 6 +- boards/e104-bt5010a-tb/doc.txt | 2 +- boards/e104-bt5011a-tb/doc.txt | 2 +- boards/feather-m0/doc.txt | 6 +- boards/feather-nrf52840-sense/doc.txt | 2 +- boards/feather-nrf52840/doc.txt | 2 +- boards/i-nucleo-lrwan1/doc.txt | 2 +- boards/iotlab-m3/doc.txt | 6 +- boards/lsn50/doc.txt | 4 +- boards/mega-xplained/doc.txt | 6 +- boards/microbit/doc.txt | 2 +- boards/msbiot/doc.txt | 10 +- boards/nrf52832-mdk/doc.txt | 2 +- boards/nrf52840-mdk/doc.txt | 2 +- boards/nrf52840dk/doc.txt | 2 +- boards/nrf52840dongle/doc.txt | 2 +- boards/nrf52dk/doc.txt | 2 +- boards/nrf5340dk-app/doc.txt | 2 +- boards/nrf9160dk/doc.txt | 2 +- boards/nucleo-l4r5zi/doc.txt | 4 +- boards/openlabs-kw41z-mini/doc.txt | 2 +- boards/p-l496g-cell02/doc.txt | 4 +- boards/p-nucleo-wb55/doc.txt | 4 +- boards/phynode-kw41z/doc.txt | 2 +- boards/samr21-xpro/doc.txt | 2 +- boards/seeedstudio-gd32/doc.txt | 12 +-- boards/seeeduino_xiao/doc.txt | 2 +- boards/sensebox_samd21/doc.txt | 2 +- boards/serpente/doc.txt | 2 +- boards/sipeed-longan-nano/doc.txt | 16 ++-- boards/sodaq-autonomo/doc.txt | 2 +- boards/sodaq-explorer/doc.txt | 2 +- boards/sodaq-one/doc.txt | 2 +- boards/sodaq-sara-aff/doc.txt | 2 +- boards/sodaq-sara-sff/doc.txt | 2 +- boards/spark-core/doc.txt | 2 +- boards/stm32f723e-disco/doc.txt | 6 +- boards/stm32g0316-disco/doc.txt | 2 +- boards/stm32l0538-disco/doc.txt | 4 +- boards/teensy31/doc.txt | 2 +- boards/usb-kw41z/doc.txt | 2 +- boards/waveshare-nrf52840-eval-kit/doc.txt | 4 +- bootloaders/riotboot/doc.txt | 2 +- bootloaders/riotboot_dfu/doc.txt | 6 +- bootloaders/riotboot_tinyusb_dfu/doc.txt | 4 +- cpu/cc26xx_cc13xx/doc.txt | 4 +- cpu/esp32/doc.txt | 6 +- cpu/esp8266/doc.txt | 4 +- cpu/esp_common/esp-wifi/doc.txt | 4 +- .../riotctrl_ctrl/tests/test_native.py | 2 +- .../compile_test/compile_like_murdock.py | 2 +- dist/tools/desvirt/README.desvirt.md | 8 +- dist/tools/dhcpv6-pd_ia/README.md | 2 +- dist/tools/eclipsesym/README.md | 2 +- dist/tools/vagrant/freebsd/README.md | 4 +- dist/tools/zep_dispatch/README.md | 6 +- .../src/advanced-build-system-tricks.md | 6 +- doc/doxygen/src/build-in-docker.md | 14 +-- doc/doxygen/src/creating-an-application.md | 2 +- doc/doxygen/src/flashing.md | 2 +- doc/doxygen/src/getting-started.md | 8 +- doc/doxygen/src/mainpage.md | 4 +- doc/guides/setup-windows/README.md | 14 +-- drivers/atwinc15x0/doc.txt | 2 +- drivers/doc.txt | 2 +- examples/README.md | 86 +++++++++--------- .../bindist/Makefile | 0 .../bindist/README.md | 0 .../bindist/abc/Makefile | 0 .../bindist/abc/abc.c | 0 .../bindist/main.c | 0 .../opendsme/Makefile | 0 .../opendsme/Makefile.ci | 0 .../opendsme/README.md | 0 .../opendsme/main.c | 0 .../pio_blink/Makefile | 0 .../pio_blink/README.md | 0 .../pio_blink/main.c | 0 .../pio_blink/rpx0xx_pio_blink/Makefile | 0 .../pio_blink/rpx0xx_pio_blink/blink.c | 0 .../pio_blink/rpx0xx_pio_blink/blink.pio | 0 .../posix_select/Makefile | 0 .../posix_select/Makefile.ci | 0 .../posix_select/README.md | 0 .../posix_select/main.c | 0 .../psa_crypto/Makefile | 0 .../psa_crypto/Makefile.ci | 0 .../psa_crypto/README.md | 0 .../psa_crypto/app.config.base | 0 .../psa_crypto/app.config.multi_se | 0 .../psa_crypto/app.config.se | 0 .../psa_crypto/custom_atca_params.h | 0 .../psa_crypto/example_cipher_aes_128.c | 0 .../psa_crypto/example_ecdsa_p256.c | 0 .../psa_crypto/example_eddsa.c | 0 .../psa_crypto/example_hash.c | 0 .../psa_crypto/example_hmac_sha256.c | 0 .../psa_crypto/main.c | 0 .../psa_crypto/tests/01-run.py | 0 .../senml_saul/Makefile | 0 .../senml_saul/Makefile.ci | 0 .../senml_saul/README.md | 0 .../senml_saul/main.c | 0 .../suit_update/Makefile | 0 .../suit_update/Makefile.board.dep | 0 .../suit_update/Makefile.ci | 0 .../suit_update/Makefile.suit.custom | 0 .../suit_update/README.hardware.md | 32 +++---- .../suit_update/README.md | 0 .../suit_update/README.native.md | 6 +- .../suit_update/coap_handler.c | 0 .../suit_update/main.c | 0 .../suit_update/native_steps.svg | 0 .../suit_update/tests-with-config/01-run.py | 0 .../tests-with-config/check-config.sh | 0 .../thread_duel/Makefile | 0 .../thread_duel/Makefile.ci | 0 .../thread_duel/README.md | 0 .../thread_duel/main.c | 0 .../twr_aloha/Makefile | 0 .../twr_aloha/Makefile.ci | 0 .../twr_aloha/README.md | 0 .../twr_aloha/control.c | 0 .../twr_aloha/control.h | 0 .../twr_aloha/main.c | 0 .../twr_aloha/tests-with-config/01-run.py | 0 .../twr_aloha/twr_shell.c | 0 .../twr_aloha/twr_shell.py | 0 .../usbus_minimal/Makefile | 0 .../usbus_minimal/README.md | 0 .../usbus_minimal/main.c | 0 .../{essentials => basic}/blinky/Makefile | 0 .../blinky/Makefile.board.dep | 0 .../{essentials => basic}/blinky/Makefile.ci | 0 .../{essentials => basic}/blinky/README.md | 0 examples/{essentials => basic}/blinky/main.c | 0 .../{essentials => basic}/default/Makefile | 0 .../default/Makefile.board.dep | 0 .../{essentials => basic}/default/Makefile.ci | 0 .../{essentials => basic}/default/README.md | 2 +- examples/{essentials => basic}/default/main.c | 0 .../{essentials => basic}/filesystem/Makefile | 0 .../filesystem/Makefile.ci | 0 .../filesystem/README.md | 0 .../{essentials => basic}/filesystem/main.c | 0 .../hello-world/Makefile | 0 .../hello-world/README.md | 0 .../{essentials => basic}/hello-world/main.c | 0 .../ipc_pingpong/Makefile | 0 .../ipc_pingpong/Makefile.ci | 0 .../ipc_pingpong/README.md | 0 .../{essentials => basic}/ipc_pingpong/main.c | 0 .../{essentials => basic}/leds_shell/Makefile | 0 .../leds_shell/Makefile.ci | 0 .../leds_shell/README.md | 0 .../{essentials => basic}/leds_shell/main.c | 0 examples/{essentials => basic}/saul/Makefile | 0 .../{essentials => basic}/saul/Makefile.ci | 0 examples/{essentials => basic}/saul/README.md | 0 examples/{essentials => basic}/saul/main.c | 0 .../{essentials => basic}/subfolders/Makefile | 0 .../subfolders/README.md | 0 .../subfolders/folder/a.c | 0 .../subfolders/folder/subfolder/b.c | 0 .../subfolders/folder/subfolder/c.c | 0 .../{essentials => basic}/subfolders/main.c | 0 .../subfolders/module/Makefile | 0 .../subfolders/module/a.c | 0 .../subfolders/module/b.c | 0 .../timer_periodic_wakeup/Makefile | 0 .../timer_periodic_wakeup/Makefile.ci | 0 .../timer_periodic_wakeup/README.md | 0 .../timer_periodic_wakeup/main.c | 0 .../community}/arduino_hello-world/Makefile | 0 .../arduino_hello-world/Makefile.ci | 0 .../community}/arduino_hello-world/README.md | 0 .../arduino_hello-world/hello-world.sketch | 0 .../community}/javascript/Makefile | 0 .../community}/javascript/Makefile.ci | 0 .../community}/javascript/README.md | 0 .../community}/javascript/main.c | 0 .../community}/javascript/main.js | 0 .../community}/lua_REPL/Makefile | 0 .../community}/lua_REPL/Makefile.ci | 0 .../community}/lua_REPL/README.md | 0 .../community}/lua_REPL/main.c | 0 .../community}/lua_REPL/repl.lua | 0 .../community}/lua_basic/Makefile | 0 .../community}/lua_basic/Makefile.ci | 0 .../community}/lua_basic/README.md | 0 .../community}/lua_basic/main.c | 0 .../community}/lua_basic/main.lua | 0 .../community}/micropython/Makefile | 0 .../community}/micropython/Makefile.ci | 0 .../community}/micropython/README.md | 0 .../community}/micropython/boot.py | 0 .../community}/micropython/main.c | 0 .../community}/micropython/tests/01-run.py | 0 .../community}/wasm/.gitignore | 0 .../community}/wasm/Makefile | 0 .../community}/wasm/Makefile.ci | 0 .../community}/wasm/README.md | 0 .../community}/wasm/config.cmake | 0 .../community}/wasm/iwasmt.c | 0 .../community}/wasm/test.wasm | Bin .../community}/wasm/wasm-main.c | 0 .../community}/wasm/wasm_sample/Makefile | 0 .../community}/wasm/wasm_sample/hello.c | 0 .../wasm/wasm_sample/hello_prebuild.wasm | Bin .../official}/riot_and_cpp/Makefile | 0 .../official}/riot_and_cpp/Makefile.ci | 0 .../official}/riot_and_cpp/README.md | 0 .../official}/riot_and_cpp/c_functions.c | 0 .../official}/riot_and_cpp/c_functions.h | 0 .../official}/riot_and_cpp/cpp_class.cpp | 0 .../official}/riot_and_cpp/cpp_class.hpp | 0 .../official}/riot_and_cpp/main.cpp | 0 .../official}/rust-async/Cargo.lock | 0 .../official}/rust-async/Cargo.toml | 0 .../official}/rust-async/Makefile | 0 .../official}/rust-async/Makefile.ci | 0 .../official}/rust-async/README.md | 0 .../official}/rust-async/src/lib.rs | 0 .../official}/rust-gcoap/Cargo.lock | 0 .../official}/rust-gcoap/Cargo.toml | 0 .../official}/rust-gcoap/Makefile | 0 .../official}/rust-gcoap/Makefile.ci | 0 .../official}/rust-gcoap/README.md | 0 .../official}/rust-gcoap/src/lib.rs | 0 .../official}/rust-gcoap/vfs.c | 0 .../official}/rust-hello-world/Cargo.lock | 0 .../official}/rust-hello-world/Cargo.toml | 0 .../official}/rust-hello-world/Makefile | 0 .../official}/rust-hello-world/README.md | 0 .../official}/rust-hello-world/src/lib.rs | 0 .../misc}/skald_eddystone/Makefile | 0 .../misc}/skald_eddystone/README.md | 0 .../misc}/skald_eddystone/main.c | 0 .../misc}/skald_ibeacon/Makefile | 0 .../misc}/skald_ibeacon/README.md | 0 .../misc}/skald_ibeacon/main.c | 0 .../nimble/nimble_gatt/Makefile | 0 .../nimble/nimble_gatt/README.md | 0 .../nimble/nimble_gatt/main.c | 0 .../nimble/nimble_heart_rate_sensor/Makefile | 0 .../nimble/nimble_heart_rate_sensor/README.md | 0 .../nimble/nimble_heart_rate_sensor/main.c | 0 .../nimble/nimble_scanner/Makefile | 0 .../nimble/nimble_scanner/README.md | 0 .../nimble/nimble_scanner/main.c | 0 examples/networking/coap/gcoap/README.md | 4 +- .../cord_ep/Makefile | 0 .../cord_ep/Makefile.ci | 0 .../cord_ep/README.md | 0 .../cord_ep/main.c | 0 .../cord_epsim/Makefile | 0 .../cord_epsim/Makefile.ci | 0 .../cord_epsim/README.md | 0 .../cord_epsim/main.c | 0 .../cord_lc/Makefile | 0 .../cord_lc/Makefile.ci | 0 .../cord_lc/README.md | 0 .../cord_lc/cord_lc_cli.c | 0 .../cord_lc/main.c | 0 .../gnrc_border_router/Kconfig | 0 .../gnrc_border_router/Makefile | 0 .../gnrc_border_router/Makefile.board.dep | 0 .../gnrc_border_router/Makefile.cdc-ecm.conf | 0 .../gnrc_border_router/Makefile.ci | 0 .../gnrc_border_router/Makefile.ethos.conf | 0 .../gnrc_border_router/Makefile.native.conf | 0 .../gnrc_border_router/Makefile.slip.conf | 0 .../gnrc_border_router/Makefile.wifi.conf | 0 .../gnrc_border_router/README.md | 2 +- .../gnrc_border_router/main.c | 0 .../gnrc_lorawan/Makefile | 0 .../gnrc_lorawan/Makefile.ci | 0 .../gnrc_lorawan/README.md | 0 .../gnrc_lorawan/main.c | 0 .../gnrc_minimal/Makefile | 0 .../gnrc_minimal/Makefile.ci | 0 .../gnrc_minimal/Makefile.gnu.dep | 0 .../gnrc_minimal/README.md | 0 .../gnrc_minimal/main.c | 0 .../gnrc_networking/Makefile | 0 .../gnrc_networking/Makefile.ci | 0 .../gnrc_networking/README.md | 0 .../gnrc_networking/main.c | 0 .../gnrc_networking_mac/Makefile | 0 .../gnrc_networking_mac/README.md | 0 .../gnrc_networking_mac/mac.c | 0 .../gnrc_networking_mac/main.c | 0 .../gnrc_networking_mac/udp.c | 0 .../gnrc_networking_subnets/Makefile | 0 .../gnrc_networking_subnets/Makefile.ci | 0 .../gnrc_networking_subnets/README.md | 0 .../gnrc_networking_subnets/main.c | 0 .../gnrc_networking_subnets/setup_taps.sh | 0 .../gnrc_networking_subnets/tapology.txt | 0 makefiles/app_dirs.blacklist | 8 +- makefiles/arch/native.inc.mk | 2 +- makefiles/tests/boards_supported/README.md | 2 +- pkg/cryptoauthlib/doc.txt | 6 +- pkg/micropython/doc.txt | 8 +- pkg/nimble/README.ipv6-over-ble.md | 2 +- pkg/uwb-core/doc.txt | 4 +- pkg/wamr/doc.txt | 6 +- sys/include/auto_init.h | 2 +- sys/include/stdio_nimble.h | 2 +- sys/psa_crypto/doc.txt | 8 +- .../README.md | 2 +- tests/net/gnrc_udp/README.md | 2 +- tests/riotboot_flashwrite/README.md | 2 +- tests/sys/psa_crypto_cipher/README.md | 2 +- .../example_cipher_aes_128.c | 2 +- .../example_cipher_chacha20.c | 2 +- tests/sys/psa_crypto_ecdsa/README.md | 2 +- .../sys/psa_crypto_ecdsa/example_ecdsa_p256.c | 2 +- tests/sys/psa_crypto_eddsa/README.md | 2 +- tests/sys/psa_crypto_eddsa/example_eddsa.c | 2 +- tests/sys/psa_crypto_hashes/README.md | 2 +- tests/sys/psa_crypto_hashes/example_hash.c | 2 +- tests/sys/psa_crypto_mac/README.md | 2 +- .../sys/psa_crypto_mac/example_hmac_sha256.c | 2 +- tests/sys/psa_crypto_se/README.md | 2 +- tests/sys/psa_crypto_se/custom_atca_params.h | 2 +- .../psa_crypto_se/example_cipher_aes_128.c | 2 +- tests/sys/psa_crypto_se/example_ecdsa_p256.c | 2 +- tests/sys/psa_crypto_se/example_hmac_sha256.c | 2 +- tests/sys/psa_crypto_se_cipher/README.md | 2 +- .../psa_crypto_se_cipher/custom_atca_params.h | 2 +- .../example_cipher_aes_128.c | 2 +- tests/sys/psa_crypto_se_ecdsa/README.md | 2 +- .../psa_crypto_se_ecdsa/custom_atca_params.h | 2 +- .../psa_crypto_se_ecdsa/example_ecdsa_p256.c | 2 +- tests/sys/psa_crypto_se_mac/README.md | 2 +- .../psa_crypto_se_mac/custom_atca_params.h | 2 +- .../psa_crypto_se_mac/example_hmac_sha256.c | 2 +- 351 files changed, 271 insertions(+), 271 deletions(-) rename examples/{advanced_examples => advanced}/bindist/Makefile (100%) rename examples/{advanced_examples => advanced}/bindist/README.md (100%) rename examples/{advanced_examples => advanced}/bindist/abc/Makefile (100%) rename examples/{advanced_examples => advanced}/bindist/abc/abc.c (100%) rename examples/{advanced_examples => advanced}/bindist/main.c (100%) rename examples/{advanced_examples => advanced}/opendsme/Makefile (100%) rename examples/{advanced_examples => advanced}/opendsme/Makefile.ci (100%) rename examples/{advanced_examples => advanced}/opendsme/README.md (100%) rename examples/{advanced_examples => advanced}/opendsme/main.c (100%) rename examples/{advanced_examples => advanced}/pio_blink/Makefile (100%) rename examples/{advanced_examples => advanced}/pio_blink/README.md (100%) rename examples/{advanced_examples => advanced}/pio_blink/main.c (100%) rename examples/{advanced_examples => advanced}/pio_blink/rpx0xx_pio_blink/Makefile (100%) rename examples/{advanced_examples => advanced}/pio_blink/rpx0xx_pio_blink/blink.c (100%) rename examples/{advanced_examples => advanced}/pio_blink/rpx0xx_pio_blink/blink.pio (100%) rename examples/{advanced_examples => advanced}/posix_select/Makefile (100%) rename examples/{advanced_examples => advanced}/posix_select/Makefile.ci (100%) rename examples/{advanced_examples => advanced}/posix_select/README.md (100%) rename examples/{advanced_examples => advanced}/posix_select/main.c (100%) rename examples/{advanced_examples => advanced}/psa_crypto/Makefile (100%) rename examples/{advanced_examples => advanced}/psa_crypto/Makefile.ci (100%) rename examples/{advanced_examples => advanced}/psa_crypto/README.md (100%) rename examples/{advanced_examples => advanced}/psa_crypto/app.config.base (100%) rename examples/{advanced_examples => advanced}/psa_crypto/app.config.multi_se (100%) rename examples/{advanced_examples => advanced}/psa_crypto/app.config.se (100%) rename examples/{advanced_examples => advanced}/psa_crypto/custom_atca_params.h (100%) rename examples/{advanced_examples => advanced}/psa_crypto/example_cipher_aes_128.c (100%) rename examples/{advanced_examples => advanced}/psa_crypto/example_ecdsa_p256.c (100%) rename examples/{advanced_examples => advanced}/psa_crypto/example_eddsa.c (100%) rename examples/{advanced_examples => advanced}/psa_crypto/example_hash.c (100%) rename examples/{advanced_examples => advanced}/psa_crypto/example_hmac_sha256.c (100%) rename examples/{advanced_examples => advanced}/psa_crypto/main.c (100%) rename examples/{advanced_examples => advanced}/psa_crypto/tests/01-run.py (100%) rename examples/{advanced_examples => advanced}/senml_saul/Makefile (100%) rename examples/{advanced_examples => advanced}/senml_saul/Makefile.ci (100%) rename examples/{advanced_examples => advanced}/senml_saul/README.md (100%) rename examples/{advanced_examples => advanced}/senml_saul/main.c (100%) rename examples/{advanced_examples => advanced}/suit_update/Makefile (100%) rename examples/{advanced_examples => advanced}/suit_update/Makefile.board.dep (100%) rename examples/{advanced_examples => advanced}/suit_update/Makefile.ci (100%) rename examples/{advanced_examples => advanced}/suit_update/Makefile.suit.custom (100%) rename examples/{advanced_examples => advanced}/suit_update/README.hardware.md (94%) rename examples/{advanced_examples => advanced}/suit_update/README.md (100%) rename examples/{advanced_examples => advanced}/suit_update/README.native.md (98%) rename examples/{advanced_examples => advanced}/suit_update/coap_handler.c (100%) rename examples/{advanced_examples => advanced}/suit_update/main.c (100%) rename examples/{advanced_examples => advanced}/suit_update/native_steps.svg (100%) rename examples/{advanced_examples => advanced}/suit_update/tests-with-config/01-run.py (100%) rename examples/{advanced_examples => advanced}/suit_update/tests-with-config/check-config.sh (100%) rename examples/{advanced_examples => advanced}/thread_duel/Makefile (100%) rename examples/{advanced_examples => advanced}/thread_duel/Makefile.ci (100%) rename examples/{advanced_examples => advanced}/thread_duel/README.md (100%) rename examples/{advanced_examples => advanced}/thread_duel/main.c (100%) rename examples/{advanced_examples => advanced}/twr_aloha/Makefile (100%) rename examples/{advanced_examples => advanced}/twr_aloha/Makefile.ci (100%) rename examples/{advanced_examples => advanced}/twr_aloha/README.md (100%) rename examples/{advanced_examples => advanced}/twr_aloha/control.c (100%) rename examples/{advanced_examples => advanced}/twr_aloha/control.h (100%) rename examples/{advanced_examples => advanced}/twr_aloha/main.c (100%) rename examples/{advanced_examples => advanced}/twr_aloha/tests-with-config/01-run.py (100%) rename examples/{advanced_examples => advanced}/twr_aloha/twr_shell.c (100%) rename examples/{advanced_examples => advanced}/twr_aloha/twr_shell.py (100%) rename examples/{advanced_examples => advanced}/usbus_minimal/Makefile (100%) rename examples/{advanced_examples => advanced}/usbus_minimal/README.md (100%) rename examples/{advanced_examples => advanced}/usbus_minimal/main.c (100%) rename examples/{essentials => basic}/blinky/Makefile (100%) rename examples/{essentials => basic}/blinky/Makefile.board.dep (100%) rename examples/{essentials => basic}/blinky/Makefile.ci (100%) rename examples/{essentials => basic}/blinky/README.md (100%) rename examples/{essentials => basic}/blinky/main.c (100%) rename examples/{essentials => basic}/default/Makefile (100%) rename examples/{essentials => basic}/default/Makefile.board.dep (100%) rename examples/{essentials => basic}/default/Makefile.ci (100%) rename examples/{essentials => basic}/default/README.md (99%) rename examples/{essentials => basic}/default/main.c (100%) rename examples/{essentials => basic}/filesystem/Makefile (100%) rename examples/{essentials => basic}/filesystem/Makefile.ci (100%) rename examples/{essentials => basic}/filesystem/README.md (100%) rename examples/{essentials => basic}/filesystem/main.c (100%) rename examples/{essentials => basic}/hello-world/Makefile (100%) rename examples/{essentials => basic}/hello-world/README.md (100%) rename examples/{essentials => basic}/hello-world/main.c (100%) rename examples/{essentials => basic}/ipc_pingpong/Makefile (100%) rename examples/{essentials => basic}/ipc_pingpong/Makefile.ci (100%) rename examples/{essentials => basic}/ipc_pingpong/README.md (100%) rename examples/{essentials => basic}/ipc_pingpong/main.c (100%) rename examples/{essentials => basic}/leds_shell/Makefile (100%) rename examples/{essentials => basic}/leds_shell/Makefile.ci (100%) rename examples/{essentials => basic}/leds_shell/README.md (100%) rename examples/{essentials => basic}/leds_shell/main.c (100%) rename examples/{essentials => basic}/saul/Makefile (100%) rename examples/{essentials => basic}/saul/Makefile.ci (100%) rename examples/{essentials => basic}/saul/README.md (100%) rename examples/{essentials => basic}/saul/main.c (100%) rename examples/{essentials => basic}/subfolders/Makefile (100%) rename examples/{essentials => basic}/subfolders/README.md (100%) rename examples/{essentials => basic}/subfolders/folder/a.c (100%) rename examples/{essentials => basic}/subfolders/folder/subfolder/b.c (100%) rename examples/{essentials => basic}/subfolders/folder/subfolder/c.c (100%) rename examples/{essentials => basic}/subfolders/main.c (100%) rename examples/{essentials => basic}/subfolders/module/Makefile (100%) rename examples/{essentials => basic}/subfolders/module/a.c (100%) rename examples/{essentials => basic}/subfolders/module/b.c (100%) rename examples/{essentials => basic}/timer_periodic_wakeup/Makefile (100%) rename examples/{essentials => basic}/timer_periodic_wakeup/Makefile.ci (100%) rename examples/{essentials => basic}/timer_periodic_wakeup/README.md (100%) rename examples/{essentials => basic}/timer_periodic_wakeup/main.c (100%) rename examples/{language_bindings/community_supported => lang_support/community}/arduino_hello-world/Makefile (100%) rename examples/{language_bindings/community_supported => lang_support/community}/arduino_hello-world/Makefile.ci (100%) rename examples/{language_bindings/community_supported => lang_support/community}/arduino_hello-world/README.md (100%) rename examples/{language_bindings/community_supported => lang_support/community}/arduino_hello-world/hello-world.sketch (100%) rename examples/{language_bindings/community_supported => lang_support/community}/javascript/Makefile (100%) rename examples/{language_bindings/community_supported => lang_support/community}/javascript/Makefile.ci (100%) rename examples/{language_bindings/community_supported => lang_support/community}/javascript/README.md (100%) rename examples/{language_bindings/community_supported => lang_support/community}/javascript/main.c (100%) rename examples/{language_bindings/community_supported => lang_support/community}/javascript/main.js (100%) rename examples/{language_bindings/community_supported => lang_support/community}/lua_REPL/Makefile (100%) rename examples/{language_bindings/community_supported => lang_support/community}/lua_REPL/Makefile.ci (100%) rename examples/{language_bindings/community_supported => lang_support/community}/lua_REPL/README.md (100%) rename examples/{language_bindings/community_supported => lang_support/community}/lua_REPL/main.c (100%) rename examples/{language_bindings/community_supported => lang_support/community}/lua_REPL/repl.lua (100%) rename examples/{language_bindings/community_supported => lang_support/community}/lua_basic/Makefile (100%) rename examples/{language_bindings/community_supported => lang_support/community}/lua_basic/Makefile.ci (100%) rename examples/{language_bindings/community_supported => lang_support/community}/lua_basic/README.md (100%) rename examples/{language_bindings/community_supported => lang_support/community}/lua_basic/main.c (100%) rename examples/{language_bindings/community_supported => lang_support/community}/lua_basic/main.lua (100%) rename examples/{language_bindings/community_supported => lang_support/community}/micropython/Makefile (100%) rename examples/{language_bindings/community_supported => lang_support/community}/micropython/Makefile.ci (100%) rename examples/{language_bindings/community_supported => lang_support/community}/micropython/README.md (100%) rename examples/{language_bindings/community_supported => lang_support/community}/micropython/boot.py (100%) rename examples/{language_bindings/community_supported => lang_support/community}/micropython/main.c (100%) rename examples/{language_bindings/community_supported => lang_support/community}/micropython/tests/01-run.py (100%) rename examples/{language_bindings/community_supported => lang_support/community}/wasm/.gitignore (100%) rename examples/{language_bindings/community_supported => lang_support/community}/wasm/Makefile (100%) rename examples/{language_bindings/community_supported => lang_support/community}/wasm/Makefile.ci (100%) rename examples/{language_bindings/community_supported => lang_support/community}/wasm/README.md (100%) rename examples/{language_bindings/community_supported => lang_support/community}/wasm/config.cmake (100%) rename examples/{language_bindings/community_supported => lang_support/community}/wasm/iwasmt.c (100%) rename examples/{language_bindings/community_supported => lang_support/community}/wasm/test.wasm (100%) rename examples/{language_bindings/community_supported => lang_support/community}/wasm/wasm-main.c (100%) rename examples/{language_bindings/community_supported => lang_support/community}/wasm/wasm_sample/Makefile (100%) rename examples/{language_bindings/community_supported => lang_support/community}/wasm/wasm_sample/hello.c (100%) rename examples/{language_bindings/community_supported => lang_support/community}/wasm/wasm_sample/hello_prebuild.wasm (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/riot_and_cpp/Makefile (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/riot_and_cpp/Makefile.ci (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/riot_and_cpp/README.md (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/riot_and_cpp/c_functions.c (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/riot_and_cpp/c_functions.h (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/riot_and_cpp/cpp_class.cpp (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/riot_and_cpp/cpp_class.hpp (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/riot_and_cpp/main.cpp (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-async/Cargo.lock (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-async/Cargo.toml (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-async/Makefile (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-async/Makefile.ci (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-async/README.md (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-async/src/lib.rs (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-gcoap/Cargo.lock (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-gcoap/Cargo.toml (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-gcoap/Makefile (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-gcoap/Makefile.ci (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-gcoap/README.md (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-gcoap/src/lib.rs (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-gcoap/vfs.c (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-hello-world/Cargo.lock (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-hello-world/Cargo.toml (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-hello-world/Makefile (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-hello-world/README.md (100%) rename examples/{language_bindings/officially_supported => lang_support/official}/rust-hello-world/src/lib.rs (100%) rename examples/networking/{bluetooth_low_energy/misc_ble_examples => ble/misc}/skald_eddystone/Makefile (100%) rename examples/networking/{bluetooth_low_energy/misc_ble_examples => ble/misc}/skald_eddystone/README.md (100%) rename examples/networking/{bluetooth_low_energy/misc_ble_examples => ble/misc}/skald_eddystone/main.c (100%) rename examples/networking/{bluetooth_low_energy/misc_ble_examples => ble/misc}/skald_ibeacon/Makefile (100%) rename examples/networking/{bluetooth_low_energy/misc_ble_examples => ble/misc}/skald_ibeacon/README.md (100%) rename examples/networking/{bluetooth_low_energy/misc_ble_examples => ble/misc}/skald_ibeacon/main.c (100%) rename examples/networking/{bluetooth_low_energy => ble}/nimble/nimble_gatt/Makefile (100%) rename examples/networking/{bluetooth_low_energy => ble}/nimble/nimble_gatt/README.md (100%) rename examples/networking/{bluetooth_low_energy => ble}/nimble/nimble_gatt/main.c (100%) rename examples/networking/{bluetooth_low_energy => ble}/nimble/nimble_heart_rate_sensor/Makefile (100%) rename examples/networking/{bluetooth_low_energy => ble}/nimble/nimble_heart_rate_sensor/README.md (100%) rename examples/networking/{bluetooth_low_energy => ble}/nimble/nimble_heart_rate_sensor/main.c (100%) rename examples/networking/{bluetooth_low_energy => ble}/nimble/nimble_scanner/Makefile (100%) rename examples/networking/{bluetooth_low_energy => ble}/nimble/nimble_scanner/README.md (100%) rename examples/networking/{bluetooth_low_energy => ble}/nimble/nimble_scanner/main.c (100%) rename examples/networking/{core_resource_directory => cord}/cord_ep/Makefile (100%) rename examples/networking/{core_resource_directory => cord}/cord_ep/Makefile.ci (100%) rename examples/networking/{core_resource_directory => cord}/cord_ep/README.md (100%) rename examples/networking/{core_resource_directory => cord}/cord_ep/main.c (100%) rename examples/networking/{core_resource_directory => cord}/cord_epsim/Makefile (100%) rename examples/networking/{core_resource_directory => cord}/cord_epsim/Makefile.ci (100%) rename examples/networking/{core_resource_directory => cord}/cord_epsim/README.md (100%) rename examples/networking/{core_resource_directory => cord}/cord_epsim/main.c (100%) rename examples/networking/{core_resource_directory => cord}/cord_lc/Makefile (100%) rename examples/networking/{core_resource_directory => cord}/cord_lc/Makefile.ci (100%) rename examples/networking/{core_resource_directory => cord}/cord_lc/README.md (100%) rename examples/networking/{core_resource_directory => cord}/cord_lc/cord_lc_cli.c (100%) rename examples/networking/{core_resource_directory => cord}/cord_lc/main.c (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_border_router/Kconfig (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_border_router/Makefile (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_border_router/Makefile.board.dep (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_border_router/Makefile.cdc-ecm.conf (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_border_router/Makefile.ci (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_border_router/Makefile.ethos.conf (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_border_router/Makefile.native.conf (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_border_router/Makefile.slip.conf (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_border_router/Makefile.wifi.conf (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_border_router/README.md (99%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_border_router/main.c (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_lorawan/Makefile (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_lorawan/Makefile.ci (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_lorawan/README.md (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_lorawan/main.c (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_minimal/Makefile (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_minimal/Makefile.ci (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_minimal/Makefile.gnu.dep (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_minimal/README.md (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_minimal/main.c (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking/Makefile (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking/Makefile.ci (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking/README.md (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking/main.c (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking_mac/Makefile (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking_mac/README.md (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking_mac/mac.c (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking_mac/main.c (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking_mac/udp.c (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking_subnets/Makefile (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking_subnets/Makefile.ci (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking_subnets/README.md (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking_subnets/main.c (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking_subnets/setup_taps.sh (100%) rename examples/networking/{gnrc_networking => gnrc}/gnrc_networking_subnets/tapology.txt (100%) diff --git a/.murdock b/.murdock index ed93ef533186..97e4669f3b12 100755 --- a/.murdock +++ b/.murdock @@ -3,7 +3,7 @@ # uncomment and change this to limit builds, e.g., #export BOARDS="samr21-xpro native" # and / or -#export APPS="examples/essentials/hello-world tests/unittests" +#export APPS="examples/basic/hello-world tests/unittests" QUICKBUILD_BOARDS=" adafruit-itsybitsy-m4 @@ -43,7 +43,7 @@ esac # on LLVM. : ${TEST_BOARDS_LLVM_COMPILE:="iotlab-m3 native native64 nrf52dk mulle nucleo-f401re samr21-xpro slstk3402a"} -: ${TEST_WITH_CONFIG_SUPPORTED:="examples/advanced_examples/suit_update tests/drivers/at86rf2xx_aes"} +: ${TEST_WITH_CONFIG_SUPPORTED:="examples/advanced/suit_update tests/drivers/at86rf2xx_aes"} export RIOT_CI_BUILD=1 export CC_NOCOLOR=1 diff --git a/Makefile b/Makefile index 9f1c072a70e2..f44532cb5ad9 100644 --- a/Makefile +++ b/Makefile @@ -69,7 +69,7 @@ define welcome_message @echo " doc doc-{man,latex}" @echo "" @echo "==> tl;dr Try running:" - @echo " cd examples/essentials/default" + @echo " cd examples/basic/default" @echo " make BOARD=" endef diff --git a/boards/adafruit-clue/doc.txt b/boards/adafruit-clue/doc.txt index d60c36effae0..72a695856128 100644 --- a/boards/adafruit-clue/doc.txt +++ b/boards/adafruit-clue/doc.txt @@ -26,7 +26,7 @@ The board is flashed using the `adafruit-nrfutil` Python package: Example with `hello-world` application: ``` - make BOARD=adafruit-clue -C examples/essentials/hello-world flash + make BOARD=adafruit-clue -C examples/basic/hello-world flash ``` ### Accessing STDIO via UART @@ -36,7 +36,7 @@ generally mapped to `/dev/ttyACM0`. Use the `term` target to connect to the board serial port
``` - make BOARD=adafruit-clue -C examples/essentials/hello-world term + make BOARD=adafruit-clue -C examples/basic/hello-world term ``` The `TERM_DELAY` environment variable can be used to add a delay (in second) diff --git a/boards/adafruit-pybadge/doc.txt b/boards/adafruit-pybadge/doc.txt index a3dd07444c70..80a32caf3472 100644 --- a/boards/adafruit-pybadge/doc.txt +++ b/boards/adafruit-pybadge/doc.txt @@ -26,7 +26,7 @@ Connect the board via USB and use `BOARD=adafruit-pybadge` with the `make` comma this uses the Arduino style bootloader preprogrammed on the board.
Example with `hello-world` application: ``` - make BOARD=adafruit-pybadge -C examples/essentials/hello-world flash + make BOARD=adafruit-pybadge -C examples/basic/hello-world flash ``` In case of a crash of the firmware, one has to manually reset the board in diff --git a/boards/alientek-pandora/doc.txt b/boards/alientek-pandora/doc.txt index 7364312c9f43..2add0098544d 100644 --- a/boards/alientek-pandora/doc.txt +++ b/boards/alientek-pandora/doc.txt @@ -18,7 +18,7 @@ Additional resources may be found on [RT-Thread bsp support page](https://gitee. To flash the board, use the on board ST-Link programmer/debugger. Input the following command: - make BOARD=alientek-pandora -C examples/essentials/hello-world flash + make BOARD=alientek-pandora -C examples/basic/hello-world flash The NRST pin is connected to the on board debugger, so users do not need to reset manually every time it requires to flash. @@ -33,7 +33,7 @@ Before you begin, check that the both the jumper caps marked as 'USART1' is conn Use the `term` target to open a terminal: - make BOARD=alientek-pandora -C examples/essentials/hello-world term + make BOARD=alientek-pandora -C examples/basic/hello-world term An on-board ST-Link compatible debugger is used to transport serial STDIO message. diff --git a/boards/arduino-mkrfox1200/doc.txt b/boards/arduino-mkrfox1200/doc.txt index 30443fc9db73..1bbf82e3ff49 100644 --- a/boards/arduino-mkrfox1200/doc.txt +++ b/boards/arduino-mkrfox1200/doc.txt @@ -19,7 +19,7 @@ powered by an Atmel SAMD21 microcontroller. Use `BOARD=arduino-mkrfox1200` with the `make` command.
Example with `hello-world` application: ``` - make BOARD=arduino-mkrfox1200 -C examples/essentials/hello-world flash + make BOARD=arduino-mkrfox1200 -C examples/basic/hello-world flash ``` @note If the application crashes, automatic reflashing via USB, as explained diff --git a/boards/arduino-mkrwan1300/doc.txt b/boards/arduino-mkrwan1300/doc.txt index e8b92b5e84b5..65ab8207119b 100644 --- a/boards/arduino-mkrwan1300/doc.txt +++ b/boards/arduino-mkrwan1300/doc.txt @@ -19,7 +19,7 @@ powered by an Atmel SAMD21 microcontroller. Use `BOARD=arduino-mkrwan1300` with the `make` command.
Example with `hello-world` application: ``` - make BOARD=arduino-mkrwan1300 -C examples/essentials/hello-world flash + make BOARD=arduino-mkrwan1300 -C examples/basic/hello-world flash ``` @note If the application crashes, automatic reflashing via USB, as explained diff --git a/boards/arduino-nano-33-ble-sense/doc.txt b/boards/arduino-nano-33-ble-sense/doc.txt index ec2cb68983d3..83619aef4f9a 100644 --- a/boards/arduino-nano-33-ble-sense/doc.txt +++ b/boards/arduino-nano-33-ble-sense/doc.txt @@ -19,7 +19,7 @@ This board provides 802.15.4 and BLE connectivity. Use `BOARD=arduino-nano-33-ble-sense` with the `make` command.
Example with `hello-world` application: ``` - make BOARD=arduino-nano-33-ble-sense -C examples/essentials/hello-world flash + make BOARD=arduino-nano-33-ble-sense -C examples/basic/hello-world flash ``` ### Accessing STDIO via UART @@ -29,7 +29,7 @@ generally mapped to `/dev/ttyACM0`. Use the `term` target to connect to the board serial port
``` - make BOARD=arduino-nano-33-ble-sense -C examples/essentials/hello-world term + make BOARD=arduino-nano-33-ble-sense -C examples/basic/hello-world term ``` */ diff --git a/boards/arduino-nano-33-ble/doc.txt b/boards/arduino-nano-33-ble/doc.txt index 896c4d1a3d41..d2dd043598d4 100644 --- a/boards/arduino-nano-33-ble/doc.txt +++ b/boards/arduino-nano-33-ble/doc.txt @@ -19,7 +19,7 @@ This board provides 802.15.4 and BLE connectivity. Use `BOARD=arduino-nano-33-ble` with the `make` command.
Example with `hello-world` application: ``` - make BOARD=arduino-nano-33-ble -C examples/essentials/hello-world flash + make BOARD=arduino-nano-33-ble -C examples/basic/hello-world flash ``` ### Accessing STDIO via UART @@ -29,6 +29,6 @@ generally mapped to `/dev/ttyACM0`. Use the `term` target to connect to the board serial port
``` - make BOARD=arduino-nano-33-ble -C examples/essentials/hello-world term + make BOARD=arduino-nano-33-ble -C examples/basic/hello-world term ``` */ diff --git a/boards/arduino-nano-33-iot/doc.txt b/boards/arduino-nano-33-iot/doc.txt index c7952ae98cf2..1027226aa377 100644 --- a/boards/arduino-nano-33-iot/doc.txt +++ b/boards/arduino-nano-33-iot/doc.txt @@ -14,7 +14,7 @@ powered by an Atmel SAMD21 microcontroller. Use `BOARD=arduino-nano-33-iot` with the `make` command.
Example with `hello-world` application: ``` - make BOARD=arduino-nano-33-iot -C examples/essentials/hello-world flash + make BOARD=arduino-nano-33-iot -C examples/basic/hello-world flash ``` ### Accessing STDIO via UART diff --git a/boards/atmega256rfr2-xpro/doc.txt b/boards/atmega256rfr2-xpro/doc.txt index df6def4c87ee..b5ffb9f29d8a 100644 --- a/boards/atmega256rfr2-xpro/doc.txt +++ b/boards/atmega256rfr2-xpro/doc.txt @@ -27,7 +27,7 @@ To flash the board, just call `make` from an application directory with the `flash` target: ``` -make BOARD=atmega256rfr2-xpro -C examples/essentials/hello-world flash +make BOARD=atmega256rfr2-xpro -C examples/basic/hello-world flash ``` ### Accessing STDIO via UART @@ -36,7 +36,7 @@ STDIO can be accessed through the USB connector. The on-board UART-USB adapter is not affected by flashing. It shows up as /dev/ttyACM0 on Linux. It will be used automatically with `make term`: ``` -make BOARD=atmega256rfr2-xpro -C examples/essentials/hello-world term +make BOARD=atmega256rfr2-xpro -C examples/basic/hello-world term ``` */ diff --git a/boards/common/nrf52/doc.txt b/boards/common/nrf52/doc.txt index d3b03e6220ee..cf3cbefd5143 100644 --- a/boards/common/nrf52/doc.txt +++ b/boards/common/nrf52/doc.txt @@ -11,7 +11,7 @@ uses PyOCD by default. To flash the board, use `BOARD=` with the `make` command.
Example with `hello-world` application: ``` - make BOARD= -C examples/essentials/hello-world flash + make BOARD= -C examples/basic/hello-world flash ``` OpenOCD can also be used to flash nrf52 boards (except thingy52 and ruuvitag @@ -22,13 +22,13 @@ can be used. To flash the board with OpenOCD, use the `PROGRAMMER` variable: ``` - PROGRAMMER=openocd make BOARD= -C examples/essentials/hello-world flash + PROGRAMMER=openocd make BOARD= -C examples/basic/hello-world flash ``` It is also possible to use the SWD interface of a ST-LINK/V2 in-circuit debugger/programmer with OpenOCD to flash a nrf52 board: ``` - PROGRAMMER=openocd OPENOCD_DEBUG_ADAPTER=stlink make BOARD= -C examples/essentials/hello-world flash + PROGRAMMER=openocd OPENOCD_DEBUG_ADAPTER=stlink make BOARD= -C examples/basic/hello-world flash ``` */ diff --git a/boards/common/particle-mesh/doc.txt b/boards/common/particle-mesh/doc.txt index 9ba9c8feb6d8..793af751802b 100644 --- a/boards/common/particle-mesh/doc.txt +++ b/boards/common/particle-mesh/doc.txt @@ -23,7 +23,7 @@ To flash the board, use `BOARD=` (with board name in {particle-argon particle-boron, particle-xenon}) with the `make` command.
Example with `hello-world` application: ``` - make BOARD=particle-xenon -C examples/essentials/hello-world flash + make BOARD=particle-xenon -C examples/basic/hello-world flash ``` In this case, OpenOCD can also be used. For the moment, the latest stable @@ -32,7 +32,7 @@ built against the actual development version can be used. To flash the board with OpenOCD, use the `PROGRAMMER` variable: ``` - PROGRAMMER=openocd make BOARD= -C examples/essentials/hello-world flash + PROGRAMMER=openocd make BOARD= -C examples/basic/hello-world flash ``` #### Alternative flashing procedure: Particle bootloader and DFU-Util @@ -72,7 +72,7 @@ Then, the checksum is only calculated over the memory region that contains the i The on-board reset button doesn't work, so to trigger a reset of the board, use the `reset` target with `make`: ``` - make BOARD= -C examples/essentials/hello-world reset + make BOARD= -C examples/basic/hello-world reset ``` ### STDIO configuration diff --git a/boards/dwm1001/doc.txt b/boards/dwm1001/doc.txt index 738d5d2c5e77..6be2611b1811 100644 --- a/boards/dwm1001/doc.txt +++ b/boards/dwm1001/doc.txt @@ -19,13 +19,13 @@ To program this board, plug it to your computer via USB and run the following command: ``` -make BOARD=dwm1001 -C examples/essentials/hello-world flash +make BOARD=dwm1001 -C examples/basic/hello-world flash ``` To program the board with OpenOCD, use: ``` -PROGRAMMER=openocd make BOARD=dwm1001 -C examples/essentials/hello-world flash +PROGRAMMER=openocd make BOARD=dwm1001 -C examples/basic/hello-world flash ``` ## Accessing STDIO via UART @@ -35,6 +35,6 @@ generally mapped to `/dev/ttyACM0`. Use the `term` target to connect to the board serial port
``` -make BOARD=dwm1001 -C examples/essentials/hello-world term +make BOARD=dwm1001 -C examples/basic/hello-world term ``` */ diff --git a/boards/e104-bt5010a-tb/doc.txt b/boards/e104-bt5010a-tb/doc.txt index f444afc08c5c..bd9b7864835c 100644 --- a/boards/e104-bt5010a-tb/doc.txt +++ b/boards/e104-bt5010a-tb/doc.txt @@ -25,7 +25,7 @@ generally mapped to `/dev/ttyUSB0`. Use the `term` target to connect to the board serial port
``` - make BOARD=e104-bt5010a-tb -C examples/essentials/hello-world term + make BOARD=e104-bt5010a-tb -C examples/basic/hello-world term ``` */ diff --git a/boards/e104-bt5011a-tb/doc.txt b/boards/e104-bt5011a-tb/doc.txt index 18591d5cd7a5..622bb487a783 100644 --- a/boards/e104-bt5011a-tb/doc.txt +++ b/boards/e104-bt5011a-tb/doc.txt @@ -25,7 +25,7 @@ generally mapped to `/dev/ttyUSB0`. Use the `term` target to connect to the board serial port
``` - make BOARD=e104-bt5011a-tb -C examples/essentials/hello-world term + make BOARD=e104-bt5011a-tb -C examples/basic/hello-world term ``` */ diff --git a/boards/feather-m0/doc.txt b/boards/feather-m0/doc.txt index b0be9305a641..af469fe2469e 100644 --- a/boards/feather-m0/doc.txt +++ b/boards/feather-m0/doc.txt @@ -44,7 +44,7 @@ printf("Bat: %dV\n", vbat); Use `BOARD=feather-m0` with the `make` command.
Example with `hello-world` application: ``` - make BOARD=feather-m0 -C examples/essentials/hello-world flash + make BOARD=feather-m0 -C examples/basic/hello-world flash ``` @note If the application crashes, automatic reflashing via USB, as explained @@ -59,7 +59,7 @@ automatically for networking applications, use `feather-m0-wifi` as board and define the required WiFi parameters, for example: ``` CFLAGS='-DWIFI_SSID=\"\" -DWIFI_PASS=\"\"' \ - make BOARD=feather-m0-wifi -C examples/networking/gnrc_networking/gnrc_networking + make BOARD=feather-m0-wifi -C examples/networking/gnrc/gnrc_networking ``` For detailed information about the parameters, see section @@ -73,7 +73,7 @@ variant of the board automatically for LoRa applications, use `feather-m0-lora` as board: ``` -make BOARD=feather-m0-lora -C examples/networking/gnrc_networking/gnrc_lorawan +make BOARD=feather-m0-lora -C examples/networking/gnrc/gnrc_lorawan ``` For detailed information about the parameters, see section diff --git a/boards/feather-nrf52840-sense/doc.txt b/boards/feather-nrf52840-sense/doc.txt index 946d0c6023d5..302996004db0 100644 --- a/boards/feather-nrf52840-sense/doc.txt +++ b/boards/feather-nrf52840-sense/doc.txt @@ -26,7 +26,7 @@ Both use the same flasher, bootloader, and terminal settings. Example with `hello-world` application: ``` - make BOARD=feather-nrf52840-sense -C examples/essentials/hello-world flash term + make BOARD=feather-nrf52840-sense -C examples/basic/hello-world flash term ``` On "fresh" boards the diff --git a/boards/feather-nrf52840/doc.txt b/boards/feather-nrf52840/doc.txt index 8cf0232e4eae..a427aab8b148 100644 --- a/boards/feather-nrf52840/doc.txt +++ b/boards/feather-nrf52840/doc.txt @@ -24,7 +24,7 @@ The rest of the process is automated in the usual way with `BOARD=feather-nrf528 Example with `hello-world` application: ``` - make BOARD=feather-nrf52840 -C examples/essentials/hello-world flash term + make BOARD=feather-nrf52840 -C examples/basic/hello-world flash term ``` If RIOT is already running on the board, it will automatically reset the CPU and enter diff --git a/boards/i-nucleo-lrwan1/doc.txt b/boards/i-nucleo-lrwan1/doc.txt index 0e3215ed5d37..db3830d08882 100644 --- a/boards/i-nucleo-lrwan1/doc.txt +++ b/boards/i-nucleo-lrwan1/doc.txt @@ -48,7 +48,7 @@ index c59a1939a2..0c359e438c 100755 ``` - Run make flash: ```sh -make BOARD=i-nucleo-lrwan1 -C examples/essentials/hello-world flash +make BOARD=i-nucleo-lrwan1 -C examples/basic/hello-world flash ``` The command will fail but after that the memory will be unlocked after a power cycle. The line added above in `openocd.sh` can also be removed. diff --git a/boards/iotlab-m3/doc.txt b/boards/iotlab-m3/doc.txt index b4a2cb435c78..40c48b50e2bf 100644 --- a/boards/iotlab-m3/doc.txt +++ b/boards/iotlab-m3/doc.txt @@ -102,13 +102,13 @@ debug` - assuming that the current directory is your application directory. It establishes an openocd connection to the device and starts gdb connected to the openocd instance. For example, it should look something like this ``` -[user@host RIOT]$ cd examples/essentials/default/ +[user@host RIOT]$ cd examples/basic/default/ [user@host default]$ BOARD=iotlab-m3 make Building application default for iotlab-m3 w/ MCU stm32f1. ... [user@hostdefault]$ BOARD=iotlab-m3 make debug RIOT/boards/hikob-common/dist/debug.sh RIOT/boards/iotlab-m3/dist/gdb.conf -RIOT/examples/essentials/default/bin/iotlab-m3/default.elf +RIOT/examples/basic/default/bin/iotlab-m3/default.elf Open On-Chip Debugger 0.8.0 (2014-07-27-20:18) Licensed under GNU GPL v2 For bug reports, read @@ -123,7 +123,7 @@ This GDB was configured as "--host=x86_64-apple-darwin10 --target=arm-none- eabi". For bug reporting instructions, please see: ... -Reading symbols from RIOT/examples/essentials/default/bin/iotlab-m3/default.elf...done. +Reading symbols from RIOT/examples/basic/default/bin/iotlab-m3/default.elf...done. idle_thread (arg=) at RIOT/core/kernel_init.c:67 67 lpm_set(LPM_IDLE); JTAG tap: stm32f1x.cpu tap/device found: 0x3ba00477 (mfg: 0x23b, part: diff --git a/boards/lsn50/doc.txt b/boards/lsn50/doc.txt index 4a73690eb0b5..a86c6998ffa7 100644 --- a/boards/lsn50/doc.txt +++ b/boards/lsn50/doc.txt @@ -30,7 +30,7 @@ exposed with v1.0). Ensure SW1 is on `flash` position. Then use the following command: - make BOARD=lsn50 -C examples/essentials/hello-world flash + make BOARD=lsn50 -C examples/basic/hello-world flash On the v1.0 version of the board, no NRST pin is exposed so one has to press the reset button during flash and release it when OpenOCD prints `adapter speed: 240 kHz` @@ -43,7 +43,7 @@ application. STDIO is connected to pins PA9 (TX) and PA10 (RX) so an USB to UART adapter is required. Use the `term` target to open a terminal: - make BOARD=lsn50 -C examples/essentials/hello-world term + make BOARD=lsn50 -C examples/basic/hello-world term If an external ST-Link adapter is used, RX and TX pins can be directly connected to it. In this case, STDIO is available on /dev/ttyACMx (Linux case). diff --git a/boards/mega-xplained/doc.txt b/boards/mega-xplained/doc.txt index 29b471d59986..92032a4777fa 100644 --- a/boards/mega-xplained/doc.txt +++ b/boards/mega-xplained/doc.txt @@ -39,12 +39,12 @@ square pin on the adapter connecting with the square pin on the board. If using the Buspirate: ``` - BOARD=mega-xplained make -C examples/essentials/hello-world flash + BOARD=mega-xplained make -C examples/basic/hello-world flash ``` If using the Atmel-ICE: ``` - BOARD=mega-xplained PROGRAMMER=atmelice make -C examples/essentials/hello-world flash + BOARD=mega-xplained PROGRAMMER=atmelice make -C examples/basic/hello-world flash ``` ### Accessing STDIO via UART @@ -53,7 +53,7 @@ STDIO can be accessed through the USB connector. The on-board UART-USB adapter is not affected by flashing. It shows up as /dev/ttyACM0 on Linux. It will be used automatically with `make term`: ``` - BOARD=mega-xplained make -C examples/essentials/hello-world term + BOARD=mega-xplained make -C examples/basic/hello-world term ``` ### Pin Change Interrupts diff --git a/boards/microbit/doc.txt b/boards/microbit/doc.txt index 13a80122e0dd..e342ba3b67ef 100644 --- a/boards/microbit/doc.txt +++ b/boards/microbit/doc.txt @@ -92,7 +92,7 @@ fail. Use it like this: - $ cd examples/essentials/hello-world + $ cd examples/basic/hello-world $ BOARD=microbit make clean all -j4 $ EMULATE=1 BOARD=microbit make term diff --git a/boards/msbiot/doc.txt b/boards/msbiot/doc.txt index af85f1df4bec..d5030c59e923 100644 --- a/boards/msbiot/doc.txt +++ b/boards/msbiot/doc.txt @@ -215,7 +215,7 @@ respective board name. ### Compiling ``` -fabian@fabian-ThinkPad-L412:~/myriot/RIOT/examples/essentials/hello-world$ BOARD=msbiot +fabian@fabian-ThinkPad-L412:~/myriot/RIOT/examples/basic/hello-world$ BOARD=msbiot make Building application "hello-world" for "msbiot" with MCU "stm32f4". @@ -229,14 +229,14 @@ Building application "hello-world" for "msbiot" with MCU "stm32f4". "make" -C /home/fabian/myriot/RIOT/sys/auto_init text data bss dec hex filename 11116 116 6444 17676 450c -/home/fabian/myriot/RIOT/examples/essentials/hello-world/bin/msbiot/hello-world.elf +/home/fabian/myriot/RIOT/examples/basic/hello-world/bin/msbiot/hello-world.elf ``` ### Flashing ``` -fabian@fabian-ThinkPad-L412:~/myriot/RIOT/examples/essentials/hello-world$ BOARD=msbiot +fabian@fabian-ThinkPad-L412:~/myriot/RIOT/examples/basic/hello-world$ BOARD=msbiot make flash Building application "hello-world" for "msbiot" with MCU "stm32f4". @@ -250,7 +250,7 @@ Building application "hello-world" for "msbiot" with MCU "stm32f4". "make" -C /home/fabian/myriot/RIOT/sys/auto_init text data bss dec hex filename 11116 116 6444 17676 450c -/home/fabian/myriot/RIOT/examples/essentials/hello-world/bin/msbiot/hello-world.elf +/home/fabian/myriot/RIOT/examples/basic/hello-world/bin/msbiot/hello-world.elf /home/fabian/myriot/RIOT/dist/tools/openocd/openocd.sh flash ### Flashing Target ### Open On-Chip Debugger 0.8.0 (2015-03-01-08:19) @@ -305,7 +305,7 @@ Done flashing ### Debugging ``` -fabian@fabian-ThinkPad-L412:~/myriot/RIOT/examples/essentials/hello-world$ BOARD=msbiot +fabian@fabian-ThinkPad-L412:~/myriot/RIOT/examples/basic/hello-world$ BOARD=msbiot make debug /home/fabian/myriot/RIOT/dist/tools/openocd/openocd.sh debug ### Starting Debugging ### diff --git a/boards/nrf52832-mdk/doc.txt b/boards/nrf52832-mdk/doc.txt index 240d28e63914..56a1a13a749e 100644 --- a/boards/nrf52832-mdk/doc.txt +++ b/boards/nrf52832-mdk/doc.txt @@ -42,6 +42,6 @@ generally mapped to `/dev/ttyACM0`. Use the `term` target to connect to the board serial port
``` - make BOARD=nrf52832-mdk -C examples/essentials/hello-world term + make BOARD=nrf52832-mdk -C examples/basic/hello-world term ``` */ diff --git a/boards/nrf52840-mdk/doc.txt b/boards/nrf52840-mdk/doc.txt index 6a8f4d89c888..d9d9474fdac3 100644 --- a/boards/nrf52840-mdk/doc.txt +++ b/boards/nrf52840-mdk/doc.txt @@ -32,6 +32,6 @@ generally mapped to `/dev/ttyACM0`. Use the `term` target to connect to the board serial port
``` - make BOARD=nrf52840-mdk -C examples/essentials/hello-world term + make BOARD=nrf52840-mdk -C examples/basic/hello-world term ``` */ diff --git a/boards/nrf52840dk/doc.txt b/boards/nrf52840dk/doc.txt index bf8da36000f7..526c43d25c53 100644 --- a/boards/nrf52840dk/doc.txt +++ b/boards/nrf52840dk/doc.txt @@ -24,7 +24,7 @@ generally mapped to `/dev/ttyACM0`. Use the `term` target to connect to the board serial port
``` - make BOARD=nrf52840dk -C examples/essentials/hello-world term + make BOARD=nrf52840dk -C examples/basic/hello-world term ``` */ diff --git a/boards/nrf52840dongle/doc.txt b/boards/nrf52840dongle/doc.txt index f561102d2b96..88d936e59026 100644 --- a/boards/nrf52840dongle/doc.txt +++ b/boards/nrf52840dongle/doc.txt @@ -6,7 +6,7 @@ ### Quick start - Plug into a USB port. -- `$ make BOARD=nrf52840dongle -C examples/essentials/saul flash term` +- `$ make BOARD=nrf52840dongle -C examples/basic/saul flash term` - See [Flash the board](#nrf52840dongle_flash) if anything goes wrong. - `> saul write 2 10 40 10` - The LED glows in a soft turquise. diff --git a/boards/nrf52dk/doc.txt b/boards/nrf52dk/doc.txt index cf77d820031b..7644fc57eb14 100644 --- a/boards/nrf52dk/doc.txt +++ b/boards/nrf52dk/doc.txt @@ -62,6 +62,6 @@ generally mapped to `/dev/ttyACM0`. Use the `term` target to connect to the board serial port
``` - make BOARD=nrf52dk -C examples/essentials/hello-world term + make BOARD=nrf52dk -C examples/basic/hello-world term ``` */ diff --git a/boards/nrf5340dk-app/doc.txt b/boards/nrf5340dk-app/doc.txt index d9dd56fbfeb7..c86d66c1f8e3 100644 --- a/boards/nrf5340dk-app/doc.txt +++ b/boards/nrf5340dk-app/doc.txt @@ -32,7 +32,7 @@ generally mapped to `/dev/ttyACM0`. Use the `term` target to connect to the board serial port
``` - make BOARD=nrf5340dk-app -C examples/essentials/hello-world term + make BOARD=nrf5340dk-app -C examples/basic/hello-world term ``` */ diff --git a/boards/nrf9160dk/doc.txt b/boards/nrf9160dk/doc.txt index 8c2d26f674f4..59182730ccea 100644 --- a/boards/nrf9160dk/doc.txt +++ b/boards/nrf9160dk/doc.txt @@ -29,7 +29,7 @@ generally mapped to `/dev/ttyACM0`. Use the `term` target to connect to the board serial port
``` - make BOARD=nrf9160dk -C examples/essentials/hello-world term + make BOARD=nrf9160dk -C examples/basic/hello-world term ``` */ diff --git a/boards/nucleo-l4r5zi/doc.txt b/boards/nucleo-l4r5zi/doc.txt index 21f83d0859a3..2678ac59b1cf 100644 --- a/boards/nucleo-l4r5zi/doc.txt +++ b/boards/nucleo-l4r5zi/doc.txt @@ -51,7 +51,7 @@ must be built from source to be able to flash this board. To flash this board, just use the following command: ``` -make BOARD=nucleo-l4r5zi flash -C examples/essentials/hello-world +make BOARD=nucleo-l4r5zi flash -C examples/basic/hello-world ``` ### Flashing the Board Using ST-LINK Removable Media @@ -77,6 +77,6 @@ The default baud rate is 115 200. Use the `term` target to open a terminal: - make BOARD=nucleo-l4r5zi -C examples/essentials/hello-world term + make BOARD=nucleo-l4r5zi -C examples/basic/hello-world term */ diff --git a/boards/openlabs-kw41z-mini/doc.txt b/boards/openlabs-kw41z-mini/doc.txt index 7321a809a402..18235110aa59 100644 --- a/boards/openlabs-kw41z-mini/doc.txt +++ b/boards/openlabs-kw41z-mini/doc.txt @@ -58,7 +58,7 @@ running OpenOCD. # build and flash the gnrc_networking example - cd RIOT/examples/networking/gnrc_networking/gnrc_networking + cd RIOT/examples/networking/gnrc/gnrc_networking BOARD=openlabs-kw41z-mini CFLAGS+="-DKW41ZRF_ENABLE_LEDS=1" make -j4 flash ### Debug Uart Pinout diff --git a/boards/p-l496g-cell02/doc.txt b/boards/p-l496g-cell02/doc.txt index c0ba872f0af6..cac814a67204 100644 --- a/boards/p-l496g-cell02/doc.txt +++ b/boards/p-l496g-cell02/doc.txt @@ -17,7 +17,7 @@ flashed using OpenOCD. To flash this board, just use the following command: ``` -make BOARD=p-l496g-cell02 flash -C examples/essentials/hello-world +make BOARD=p-l496g-cell02 flash -C examples/basic/hello-world ``` ### STDIO @@ -26,6 +26,6 @@ STDIO is available via the ST-Link programmer. Use the `term` target to open a terminal: - make BOARD=p-l496g-cell02 -C examples/essentials/hello-world term + make BOARD=p-l496g-cell02 -C examples/basic/hello-world term */ diff --git a/boards/p-nucleo-wb55/doc.txt b/boards/p-nucleo-wb55/doc.txt index 77ca41e12038..580f06eac847 100644 --- a/boards/p-nucleo-wb55/doc.txt +++ b/boards/p-nucleo-wb55/doc.txt @@ -56,7 +56,7 @@ flashed using OpenOCD (use version 0.11.0 at least). To flash this board, just use the following command: ``` -make BOARD=p-nucleo-wb55 flash -C examples/essentials/hello-world +make BOARD=p-nucleo-wb55 flash -C examples/basic/hello-world ``` ### Flashing the Board Using ST-LINK Removable Media @@ -85,7 +85,7 @@ The default baud rate is 115 200. Use the `term` target to open a terminal: ``` -make BOARD=p-nucleo-wb55 -C examples/essentials/hello-world term +make BOARD=p-nucleo-wb55 -C examples/basic/hello-world term ``` ## User Interface diff --git a/boards/phynode-kw41z/doc.txt b/boards/phynode-kw41z/doc.txt index 1cc8ba684851..adec71b5a2b2 100644 --- a/boards/phynode-kw41z/doc.txt +++ b/boards/phynode-kw41z/doc.txt @@ -31,7 +31,7 @@ To flash the board using OpenOCD: 1. Use `BOARD=phynode-kw41z` with the `make` command.
Example with `hello-world` application: ``` - make BOARD=phynode-kw41z -C examples/essentials/hello-world flash term + make BOARD=phynode-kw41z -C examples/basic/hello-world flash term ``` ### Current support diff --git a/boards/samr21-xpro/doc.txt b/boards/samr21-xpro/doc.txt index 435c68a2aa99..4ccf4e965eb7 100644 --- a/boards/samr21-xpro/doc.txt +++ b/boards/samr21-xpro/doc.txt @@ -164,7 +164,7 @@ STDIO is available through the edbg debugger. Use the `term` target to open a terminal: - make BOARD=samr21-xpro -C examples/essentials/hello-world term + make BOARD=samr21-xpro -C examples/basic/hello-world term RTS / CTS hardware flow control is available on `UART_DEV(0)` and `UART_DEV(1)`. This is unavailable when using STDIO directly through diff --git a/boards/seeedstudio-gd32/doc.txt b/boards/seeedstudio-gd32/doc.txt index 170dbfd536fb..b20215f73d72 100644 --- a/boards/seeedstudio-gd32/doc.txt +++ b/boards/seeedstudio-gd32/doc.txt @@ -152,17 +152,17 @@ By default, an FTDI adapter according to the configuration defined in [`interface/openocd-usb.cfg`](https://github.com/openocd-org/openocd/blob/9ea7f3d647c8ecf6b0f1424002dfc3f4504a162c/tcl/interface/ftdi/openocd-usb.cfg) is assumed. ``` -BOARD=seeedstudio-gd32 make -C examples/essentials/hello-world flash +BOARD=seeedstudio-gd32 make -C examples/basic/hello-world flash ``` To use an FTDI adapter with a different configuration, the configuration can be defined using the variable `OPENOCD_FTDI_ADAPTER`, for example: ``` -OPENOCD_FTDI_ADAPTER=tigar BOARD=seeedstudio-gd32 make -C examples/essentials/hello-world flash +OPENOCD_FTDI_ADAPTER=tigar BOARD=seeedstudio-gd32 make -C examples/basic/hello-world flash ``` If another adapter is used, it can be specified using variable `OPENOCD_DEBUG_ADAPTER`, for example for a Segger J-Link adapter: ``` -OPENOCD_DEBUG_ADAPTER=jlink BOARD=seeedstudio-gd32 make -C examples/essentials/hello-world flash +OPENOCD_DEBUG_ADAPTER=jlink BOARD=seeedstudio-gd32 make -C examples/basic/hello-world flash ``` ## Accessing STDIO @@ -174,7 +174,7 @@ the index of the CDC ACM interface, which is 0 by default. To use the first UART interface for `stdio` instead, the `stdio_uart` module has to be enabled: ``` -USEMODULE=stdio_uart BOARD=seeedstudio-gd32 make -C examples/essentials/hello-world flash +USEMODULE=stdio_uart BOARD=seeedstudio-gd32 make -C examples/basic/hello-world flash ``` The `stdio` is then directly accessible through the first UART interface. If an @@ -184,11 +184,11 @@ interface, which is 0 by default. Use the `term` target to connect to the board using `/dev/ttyUSB0`: ``` -BOARD=seeedstudio-gd32 make -C examples/essentials/hello-world term PORT=/dev/ttyUSB0 +BOARD=seeedstudio-gd32 make -C examples/basic/hello-world term PORT=/dev/ttyUSB0 ``` If the UART interface index of the USB-to-UART interface is not 0, use the following command to connect: ``` -BOARD=seeedstudio-gd32 make -C examples/essentials/hello-world term PORT=/dev/ttyUSB +BOARD=seeedstudio-gd32 make -C examples/basic/hello-world term PORT=/dev/ttyUSB ``` */ diff --git a/boards/seeeduino_xiao/doc.txt b/boards/seeeduino_xiao/doc.txt index 7357208b1f7c..d0040cfa3f5d 100644 --- a/boards/seeeduino_xiao/doc.txt +++ b/boards/seeeduino_xiao/doc.txt @@ -21,7 +21,7 @@ Use `BOARD=seeeduino_xiao` with the `make` command.
Example with `default` application: ``` - make BOARD=seeeduino_xiao -C examples/essentials/default flash + make BOARD=seeeduino_xiao -C examples/basic/default flash ``` RIOT will automatically trigger a reset to the bootloader, but this only works if RIOT is still diff --git a/boards/sensebox_samd21/doc.txt b/boards/sensebox_samd21/doc.txt index b8b88a95fd2e..76dcbbf093e0 100644 --- a/boards/sensebox_samd21/doc.txt +++ b/boards/sensebox_samd21/doc.txt @@ -21,7 +21,7 @@ SenseBox board is based on the Atmel SAMD21G18A microcontroller. See 2. Use `BOARD=sensebox_samd21` with the `make` command.
Example with `hello-world` application: ``` - make BOARD=sensebox_samd21 -C examples/essentials/hello-world flash + make BOARD=sensebox_samd21 -C examples/basic/hello-world flash ``` ### Accessing STDIO via UART diff --git a/boards/serpente/doc.txt b/boards/serpente/doc.txt index 92aeefa47163..51a952603ffd 100644 --- a/boards/serpente/doc.txt +++ b/boards/serpente/doc.txt @@ -26,7 +26,7 @@ and dirty, yet flexible, prototyping tools. Use `BOARD=serpente` with the `make` command.
Example with `micropython` application: ``` - make BOARD=serpente -C examples/language_bindings/community_supported/micropython flash + make BOARD=serpente -C examples/lang_support/community/micropython flash ``` RIOT will automatically trigger a reset to the bootloader, but this only works if RIOT is still diff --git a/boards/sipeed-longan-nano/doc.txt b/boards/sipeed-longan-nano/doc.txt index f9cb62af8da8..88189d8ca7c7 100644 --- a/boards/sipeed-longan-nano/doc.txt +++ b/boards/sipeed-longan-nano/doc.txt @@ -160,7 +160,7 @@ The board is flashed via the in-ROM DFU bootloader by default. To enter bootloader mode, hold the BOOT0 button while pressing the RESET button. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -BOARD=sipeed-longan-nano make -C examples/essentials/hello-world flash +BOARD=sipeed-longan-nano make -C examples/basic/hello-world flash ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ After flashing you need to leave bootloader mode again by pressing the RESET button. @@ -168,7 +168,7 @@ After flashing you need to leave bootloader mode again by pressing the RESET but @note For the Sipeed Longan Nano board version with TFT display, the `sipeed-longan-nano-tft` board definition has to be used. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -BOARD=sipeed-longan-nano-tft make -C examples/essentials/hello-world flash +BOARD=sipeed-longan-nano-tft make -C examples/basic/hello-world flash ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ### Using an external debug adapter @@ -179,18 +179,18 @@ By default, an FTDI adapter according to the configuration defined in [`interface/openocd-usb.cfg`](https://github.com/openocd-org/openocd/blob/9ea7f3d647c8ecf6b0f1424002dfc3f4504a162c/tcl/interface/ftdi/openocd-usb.cfg) is assumed. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -PROGRAMMER=openocd BOARD=sipeed-longan-nano make -C examples/essentials/hello-world flash +PROGRAMMER=openocd BOARD=sipeed-longan-nano make -C examples/basic/hello-world flash ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To use an FTDI adapter with a different configuration, the configuration can be defined using the variable `OPENOCD_FTDI_ADAPTER`, for example: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -PROGRAMMER=openocd OPENOCD_FTDI_ADAPTER=tigard BOARD=sipeed-longan-nano make -C examples/essentials/hello-world flash +PROGRAMMER=openocd OPENOCD_FTDI_ADAPTER=tigard BOARD=sipeed-longan-nano make -C examples/basic/hello-world flash ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If another adapter is used, it can be specified using variable `OPENOCD_DEBUG_ADAPTER`, for example for a Segger J-Link adapter: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -PROGRAMMER=openocd OPENOCD_DEBUG_ADAPTER=jlink BOARD=sipeed-longan-nano make -C examples/essentials/hello-world flash +PROGRAMMER=openocd OPENOCD_DEBUG_ADAPTER=jlink BOARD=sipeed-longan-nano make -C examples/basic/hello-world flash ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ## Using the TFT Display @@ -210,7 +210,7 @@ the index of the CDC ACM interface, which is 0 by default. To use the first UART interface for `stdio` instead, the `stdio_uart` module has to be enabled: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -USEMODULE=stdio_uart BOARD=sipeed-longan-nano make -C examples/essentials/hello-world flash +USEMODULE=stdio_uart BOARD=sipeed-longan-nano make -C examples/basic/hello-world flash ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The `stdio` is then directly accessible through the first UART interface. If an @@ -220,11 +220,11 @@ interface, which is 0 by default. Use the `term` target to connect to the board using `/dev/ttyUSB0`: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -BOARD=sipeed-longan-nano make -C examples/essentials/hello-world term PORT=/dev/ttyUSB0 +BOARD=sipeed-longan-nano make -C examples/basic/hello-world term PORT=/dev/ttyUSB0 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If the UART interface index of the USB-to-UART interface is not 0, use the following command to connect: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -BOARD=sipeed-longan-nano make -C examples/essentials/hello-world term PORT=/dev/ttyUSB +BOARD=sipeed-longan-nano make -C examples/basic/hello-world term PORT=/dev/ttyUSB ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */ diff --git a/boards/sodaq-autonomo/doc.txt b/boards/sodaq-autonomo/doc.txt index 281209c39b8a..1211c251dc45 100644 --- a/boards/sodaq-autonomo/doc.txt +++ b/boards/sodaq-autonomo/doc.txt @@ -96,7 +96,7 @@ Besides the SAMD21 the board has the following features: Use `BOARD=sodaq-autonomo` with the `make` command.
Example with `hello-world` application: ``` - make BOARD=sodaq-autonomo -C examples/essentials/hello-world flash + make BOARD=sodaq-autonomo -C examples/basic/hello-world flash ``` @note If the application crashes, automatic reflashing via USB, as explained diff --git a/boards/sodaq-explorer/doc.txt b/boards/sodaq-explorer/doc.txt index 37a5a2dad8dd..cc2f9b1d7b26 100644 --- a/boards/sodaq-explorer/doc.txt +++ b/boards/sodaq-explorer/doc.txt @@ -13,7 +13,7 @@ General information about this board can be found on the Use `BOARD=sodaq-explorer` with the `make` command.
Example with `hello-world` application: ``` - make BOARD=sodaq-explorer -C examples/essentials/hello-world flash + make BOARD=sodaq-explorer -C examples/basic/hello-world flash ``` @note If the application crashes, automatic reflashing via USB, as explained diff --git a/boards/sodaq-one/doc.txt b/boards/sodaq-one/doc.txt index 6de350364a79..f6bc00756fb1 100644 --- a/boards/sodaq-one/doc.txt +++ b/boards/sodaq-one/doc.txt @@ -13,7 +13,7 @@ * Use `BOARD=sodaq-one` with the `make` command.
* Example with `hello-world` application: * ``` - * make BOARD=sodaq-one -C examples/essentials/hello-world flash + * make BOARD=sodaq-one -C examples/basic/hello-world flash * ``` * * @note If the application crashes, automatic reflashing via USB, as explained diff --git a/boards/sodaq-sara-aff/doc.txt b/boards/sodaq-sara-aff/doc.txt index 550df106df0a..785da6ba2cc3 100644 --- a/boards/sodaq-sara-aff/doc.txt +++ b/boards/sodaq-sara-aff/doc.txt @@ -15,7 +15,7 @@ * Use `BOARD=sodaq-sara-aff` with the `make` command.
* Example with `hello-world` application: * ``` - * make BOARD=sodaq-sara-aff -C examples/essentials/hello-world flash + * make BOARD=sodaq-sara-aff -C examples/basic/hello-world flash * ``` * * @note If the application crashes, automatic reflashing via USB, as explained diff --git a/boards/sodaq-sara-sff/doc.txt b/boards/sodaq-sara-sff/doc.txt index bd5ca5ae88ca..3cdd8b638aad 100644 --- a/boards/sodaq-sara-sff/doc.txt +++ b/boards/sodaq-sara-sff/doc.txt @@ -16,7 +16,7 @@ * Use `BOARD=sodaq-one` with the `make` command.
* Example with `hello-world` application: * ``` - * make BOARD=sodaq-one -C examples/essentials/hello-world flash + * make BOARD=sodaq-one -C examples/basic/hello-world flash * ``` * * @note If the application crashes, automatic reflashing via USB, as explained diff --git a/boards/spark-core/doc.txt b/boards/spark-core/doc.txt index 56376e6aa911..592e0dacb99f 100644 --- a/boards/spark-core/doc.txt +++ b/boards/spark-core/doc.txt @@ -97,7 +97,7 @@ Build and flash =============== 1. clone RIOT-OS -2. cd to e.g. `examples/essentials/hello-world` +2. cd to e.g. `examples/basic/hello-world` 3. enter `BOARD=spark-core make clean all flash` Use the UART diff --git a/boards/stm32f723e-disco/doc.txt b/boards/stm32f723e-disco/doc.txt index 5b3ddecae2d9..bc5a163429f4 100644 --- a/boards/stm32f723e-disco/doc.txt +++ b/boards/stm32f723e-disco/doc.txt @@ -17,7 +17,7 @@ flashed using OpenOCD. To flash this board, just use the following command: ``` -make BOARD=stm32f723e-disco flash -C examples/essentials/hello-world +make BOARD=stm32f723e-disco flash -C examples/basic/hello-world ``` ### STDIO @@ -26,12 +26,12 @@ STDIO is available via the ST-Link programmer. Use the `term` target to open a terminal: - make BOARD=stm32f723e-disco -C examples/essentials/hello-world term + make BOARD=stm32f723e-disco -C examples/basic/hello-world term ### USB OTG Peripheral Device Driver By default, the USB OTG FS port is used. To use the USB OTG HS port with the internal UTMI+ HS PHY, enable the module `periph_usbdev_hs_utmi`: - make BOARD=stm32f723e-disco USEMODULE=periph_usbdev_hs_utmi -C examples/advanced_examples/usbus_minimal + make BOARD=stm32f723e-disco USEMODULE=periph_usbdev_hs_utmi -C examples/advanced/usbus_minimal */ diff --git a/boards/stm32g0316-disco/doc.txt b/boards/stm32g0316-disco/doc.txt index 8a8deffa4902..85bf4891fdbb 100644 --- a/boards/stm32g0316-disco/doc.txt +++ b/boards/stm32g0316-disco/doc.txt @@ -24,7 +24,7 @@ * To flash this board, just use the following command: * * ``` - * make BOARD=stm32g0316-disco flash -C examples/essentials/hello-world + * make BOARD=stm32g0316-disco flash -C examples/basic/hello-world * ``` * * ### UART Terminal Interaction diff --git a/boards/stm32l0538-disco/doc.txt b/boards/stm32l0538-disco/doc.txt index 8f39e46d58f4..c5ac26751b81 100644 --- a/boards/stm32l0538-disco/doc.txt +++ b/boards/stm32l0538-disco/doc.txt @@ -52,7 +52,7 @@ The board also provides an on-board 2.04\" E-paper display (not supported yet). The board can be flashed using OpenOCD via the on-board ST-Link adapter. Then use the following command: - make BOARD=stm32l0538-disco -C examples/essentials/hello-world flash + make BOARD=stm32l0538-disco -C examples/basic/hello-world flash ## Flashing the Board Using ST-LINK Removable Media @@ -72,7 +72,7 @@ could be found on [this STM webpage](https://www.st.com/en/development-tools/sts STDIO is connected to pins PA9 (TX) and PA10 (RX) so an USB to UART adapter is required. Use the `term` target to open a terminal: - make BOARD=stm32l0538-disco -C examples/essentials/hello-world term + make BOARD=stm32l0538-disco -C examples/basic/hello-world term If an external ST-Link adapter is used, RX and TX pins can be directly connected to it. In this case, STDIO is available on /dev/ttyACMx (Linux case). diff --git a/boards/teensy31/doc.txt b/boards/teensy31/doc.txt index ba623be3cd67..8fac736c3a0d 100644 --- a/boards/teensy31/doc.txt +++ b/boards/teensy31/doc.txt @@ -27,7 +27,7 @@ microcontroller. See [Datasheet](http://cache.freescale.com/files/32bit/doc/data 2. Use `BOARD=teensy31` with the `make` command. This works for Teensy 3.1 & 3.2
Example with `hello-world` application: ``` - make BOARD=teensy31 -C examples/essentials/hello-world flash + make BOARD=teensy31 -C examples/basic/hello-world flash ``` ### Accessing STDIO via UART diff --git a/boards/usb-kw41z/doc.txt b/boards/usb-kw41z/doc.txt index f842c577ca11..e30e9053a9a9 100644 --- a/boards/usb-kw41z/doc.txt +++ b/boards/usb-kw41z/doc.txt @@ -32,7 +32,7 @@ debugging. 2. Use `BOARD=usb-kw41z` with the `make` command.
Example with `hello-world` application: ``` - make BOARD=usb-kw41z -C examples/essentials/hello-world flash term + make BOARD=usb-kw41z -C examples/basic/hello-world flash term ``` [quick-start-guide]: https://www.nxp.com/products/wireless/bluetooth-low-energy-ble/bluetooth-low-energy-ieee-802.15.4-packet-sniffer-usb-dongle:USB-KW41Z?&tab=In-Depth_Tab&tid=van/usb-kw41z/startnow diff --git a/boards/waveshare-nrf52840-eval-kit/doc.txt b/boards/waveshare-nrf52840-eval-kit/doc.txt index bd51b8a4130b..e95d4ebe1f4a 100644 --- a/boards/waveshare-nrf52840-eval-kit/doc.txt +++ b/boards/waveshare-nrf52840-eval-kit/doc.txt @@ -138,12 +138,12 @@ the index of the UART interface which is 0 by default. Use the `term` target to connect to the board serial port using `/dev/ttyUSB0`: ``` - make BOARD=waveshare-nrf52840-eval-kit -C examples/essentials/hello-world term + make BOARD=waveshare-nrf52840-eval-kit -C examples/basic/hello-world term ``` If the UART interface index of board's USB to UART bridge is not 0, use the following command to connect to the board serial port: ``` - make BOARD=waveshare-nrf52840-eval-kit -C examples/essentials/hello-world PORT=/dev/ttyUSB term + make BOARD=waveshare-nrf52840-eval-kit -C examples/basic/hello-world PORT=/dev/ttyUSB term ``` ## RESET Pin Configuration diff --git a/bootloaders/riotboot/doc.txt b/bootloaders/riotboot/doc.txt index c13b44c3192e..da997bed55c7 100644 --- a/bootloaders/riotboot/doc.txt +++ b/bootloaders/riotboot/doc.txt @@ -78,7 +78,7 @@ be booted. The image can also be flashed using `riotboot/flash` which also flashes the bootloader. Below a concrete example: -`BOARD=samr21-xpro FEATURES_REQUIRED+=riotboot APP_VER=$(date +%s) make -C examples/essentials/hello-world riotboot/flash-combined-slot0` +`BOARD=samr21-xpro FEATURES_REQUIRED+=riotboot APP_VER=$(date +%s) make -C examples/basic/hello-world riotboot/flash-combined-slot0` The above compiles a hello world binary and a bootloader, then flashes the combined binary comprising of: bootloader + slot 0 header + slot 0 image. diff --git a/bootloaders/riotboot_dfu/doc.txt b/bootloaders/riotboot_dfu/doc.txt index d1809bc92def..e08f194efde1 100644 --- a/bootloaders/riotboot_dfu/doc.txt +++ b/bootloaders/riotboot_dfu/doc.txt @@ -18,7 +18,7 @@ At startup, the DFU mode is entered when either # Prerequisites -- The board must have functional USB support, easily tested using the `examples/advanced_examples/usbus_minimal/` example. +- The board must have functional USB support, easily tested using the `examples/advanced/usbus_minimal/` example. - The board must have functional riotboot support, see @ref bootloader_riotboot. @@ -51,7 +51,7 @@ When the device is attached and in DFU mode (or the current firmware uses the `u new firmware can be flashed to slot 0 using: ``` -$ FEATURES_REQUIRED+=riotboot USEMODULE+=usbus_dfu make -C examples/essentials/saul BOARD=particle-xenon \ +$ FEATURES_REQUIRED+=riotboot USEMODULE+=usbus_dfu make -C examples/basic/saul BOARD=particle-xenon \ PROGRAMMER=dfu-util all riotboot/flash-slot0 ``` @@ -61,7 +61,7 @@ the variable `DFU_USB_ID`, e.g. if the RIOT DFU bootloader was compiled for a different VID/PID pair. ``` -$ FEATURES_REQUIRED+=riotboot USEMODULE+=usbus_dfu make -C examples/essentials/saul BOARD=particle-xenon \ +$ FEATURES_REQUIRED+=riotboot USEMODULE+=usbus_dfu make -C examples/basic/saul BOARD=particle-xenon \ PROGRAMMER=dfu-util DFU_USB_ID=1209:7d02 all riotboot/flash-slot0 ``` diff --git a/bootloaders/riotboot_tinyusb_dfu/doc.txt b/bootloaders/riotboot_tinyusb_dfu/doc.txt index 1f810d558669..2b595b38bf10 100644 --- a/bootloaders/riotboot_tinyusb_dfu/doc.txt +++ b/bootloaders/riotboot_tinyusb_dfu/doc.txt @@ -58,7 +58,7 @@ When the device is attached and in DFU mode (or the current firmware uses the `tinyusb_dfu` module), new firmware can be flashed to slot 0 using: ``` -$ FEATURES_REQUIRED+=riotboot USEMODULE+=tinyusb_dfu make -C examples/essentials/saul BOARD=particle-xenon \ +$ FEATURES_REQUIRED+=riotboot USEMODULE+=tinyusb_dfu make -C examples/basic/saul BOARD=particle-xenon \ PROGRAMMER=dfu-util USB_VID=1209 USB_PID=7d02 all riotboot/flash-slot0 ``` @@ -66,7 +66,7 @@ Instead of setting `USB_VID` and `USB_PID`, the variable `DFU_USB_ID` could also be used to specify the DFU device to be used. ``` -$ FEATURES_REQUIRED+=riotboot USEMODULE+=tinyusb_dfu make -C examples/essentials/saul BOARD=particle-xenon \ +$ FEATURES_REQUIRED+=riotboot USEMODULE+=tinyusb_dfu make -C examples/basic/saul BOARD=particle-xenon \ PROGRAMMER=dfu-util DFU_USB_ID=1209:7d02 all riotboot/flash-slot0 ``` diff --git a/cpu/cc26xx_cc13xx/doc.txt b/cpu/cc26xx_cc13xx/doc.txt index c8d29c87984b..f350964bca0a 100644 --- a/cpu/cc26xx_cc13xx/doc.txt +++ b/cpu/cc26xx_cc13xx/doc.txt @@ -41,7 +41,7 @@ CC26xx/CC13xx MCUs. It can be done through Kconfig using `make menuconfig`. For example: ``` -make -C examples/essentials/hello-world menuconfig BOARD=cc1350-launchpad +make -C examples/basic/hello-world menuconfig BOARD=cc1350-launchpad ``` It will open the Kconfig terminal configuration utility, you may see the @@ -55,7 +55,7 @@ device. For example: ``` -make -C examples/essentials/hello-world flash BOARD=cc1350-launchpad +make -C examples/basic/hello-world flash BOARD=cc1350-launchpad ``` @note Once flashed, there's no need to flash it again, unless the configuration diff --git a/cpu/esp32/doc.txt b/cpu/esp32/doc.txt index 20416bafdf71..4f4bc50f8f54 100644 --- a/cpu/esp32/doc.txt +++ b/cpu/esp32/doc.txt @@ -1637,7 +1637,7 @@ line, for example: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ USEMODULE=esp_wifi \ CFLAGS='-DWIFI_SSID=\"MySSID\" -DWIFI_PASS=\"MyPassphrase\"' \ -make -C examples/networking/gnrc_networking/gnrc_networking BOARD=... +make -C examples/networking/gnrc/gnrc_networking BOARD=... ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @note @@ -1694,7 +1694,7 @@ line, for example: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ USEMODULE=esp_wifi_enterprise \ CFLAGS='-DWIFI_SSID=\"MySSID\" -DWIFI_EAP_ID=\"anonymous\" -DWIFI_EAP_USER=\"MyUserName\" -DWIFI_EAP_PASS=\"MyPassphrase\"' \ -make -C examples/networking/gnrc_networking/gnrc_networking BOARD=... +make -C examples/networking/gnrc/gnrc_networking BOARD=... ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @note @@ -1746,7 +1746,7 @@ line, for example: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ USEMODULE=esp_wifi_ap \ CFLAGS='-DWIFI_SSID=\"MySSID\" -DWIFI_PASS=\"MyPassphrase\" -DESP_WIFI_MAX_CONN=1' \ -make -C examples/networking/gnrc_networking/gnrc_networking BOARD=... +make -C examples/networking/gnrc/gnrc_networking BOARD=... ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @note diff --git a/cpu/esp8266/doc.txt b/cpu/esp8266/doc.txt index f8d0c6874870..af0e596e2a9e 100644 --- a/cpu/esp8266/doc.txt +++ b/cpu/esp8266/doc.txt @@ -731,7 +731,7 @@ line, e.g.: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ USEMODULE=esp_wifi \ CFLAGS='-DWIFI_SSID=\"MySSID\" -DWIFI_PASS=\"MyPassphrase\"' \ -make -C examples/networking/gnrc_networking/gnrc_networking BOARD=... +make -C examples/networking/gnrc/gnrc_networking BOARD=... ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @note @@ -782,7 +782,7 @@ line, for example: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ USEMODULE=esp_wifi_ap \ CFLAGS='-DWIFI_SSID=\"MySSID\" -DWIFI_PASS=\"MyPassphrase\" -DESP_WIFI_MAX_CONN=1' \ -make -C examples/networking/gnrc_networking/gnrc_networking BOARD=... +make -C examples/networking/gnrc/gnrc_networking BOARD=... ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @note diff --git a/cpu/esp_common/esp-wifi/doc.txt b/cpu/esp_common/esp-wifi/doc.txt index 2c889cd6d5df..221ba4f469b9 100644 --- a/cpu/esp_common/esp-wifi/doc.txt +++ b/cpu/esp_common/esp-wifi/doc.txt @@ -51,7 +51,7 @@ line, for example: ``` USEMODULE=esp_wifi \ CFLAGS='-DWIFI_SSID=\"MySSID\" -DWIFI_PASS=\"MyPassphrase\"' \ -make -C examples/networking/gnrc_networking/gnrc_networking BOARD=... +make -C examples/networking/gnrc/gnrc_networking BOARD=... ``` @note @@ -102,7 +102,7 @@ line, for example: ``` USEMODULE=esp_wifi_enterprise \ CFLAGS='-DWIFI_SSID=\"MySSID\" -DWIFI_EAP_ID=\"anonymous\" -DWIFI_EAP_USER=\"MyUserName\" -DWIFI_EAP_PASS=\"MyPassphrase\"' \ -make -C examples/networking/gnrc_networking/gnrc_networking BOARD=... +make -C examples/networking/gnrc/gnrc_networking BOARD=... ``` @note diff --git a/dist/pythonlibs/riotctrl_ctrl/tests/test_native.py b/dist/pythonlibs/riotctrl_ctrl/tests/test_native.py index dd8a43f2f2f5..b55c8be261f1 100644 --- a/dist/pythonlibs/riotctrl_ctrl/tests/test_native.py +++ b/dist/pythonlibs/riotctrl_ctrl/tests/test_native.py @@ -17,7 +17,7 @@ def test_reset(): application_directory=os.path.normpath(os.path.join( os.path.abspath(__file__), '..', '..', '..', '..', '..', - 'examples', 'essentials', 'hello-world' + 'examples', 'basic', 'hello-world' )), env=env, ) diff --git a/dist/tools/compile_test/compile_like_murdock.py b/dist/tools/compile_test/compile_like_murdock.py index c019f29d89be..f61405cea9ae 100755 --- a/dist/tools/compile_test/compile_like_murdock.py +++ b/dist/tools/compile_test/compile_like_murdock.py @@ -49,7 +49,7 @@ ] DEFAULT_APPS = [ - "examples/essentials/hello-world", + "examples/basic/hello-world", "tests/drivers/mtd_mapper", "tests/drivers/saul", "tests/pkg/tinyusb_cdc_msc", diff --git a/dist/tools/desvirt/README.desvirt.md b/dist/tools/desvirt/README.desvirt.md index 87055284224c..050d0afe3fb6 100644 --- a/dist/tools/desvirt/README.desvirt.md +++ b/dist/tools/desvirt/README.desvirt.md @@ -85,16 +85,16 @@ lossnet : line4: New link from line4_2 to line4_3, rate=100mbit, loss=0.0 lossnet : line4: New link from line4_3 to line4_2, rate=100mbit, loss=0.0, delay=0.0 vnet : Network Name: line4 vm : Defining RIOT native process line4_1 -riotnative : Start the RIOT: socat EXEC:'/home/pschmerzl/RIOT/examples/networking/gnrc_networking/gnrc_networking/bin/native/gnrc_networking.elf line4_1',end-close,stderr,pty TCP-L:4711,reuseaddr,fork +riotnative : Start the RIOT: socat EXEC:'/home/pschmerzl/RIOT/examples/networking/gnrc/gnrc_networking/bin/native/gnrc_networking.elf line4_1',end-close,stderr,pty TCP-L:4711,reuseaddr,fork riotnative : PID: 18235 vm : Defining RIOT native process line4_0 -riotnative : Start the RIOT: socat EXEC:'/home/pschmerzl/RIOT/examples/networking/gnrc_networking/gnrc_networking/bin/native/gnrc_networking.elf line4_0',end-close,stderr,pty TCP-L:4712,reuseaddr,fork +riotnative : Start the RIOT: socat EXEC:'/home/pschmerzl/RIOT/examples/networking/gnrc/gnrc_networking/bin/native/gnrc_networking.elf line4_0',end-close,stderr,pty TCP-L:4712,reuseaddr,fork riotnative : PID: 18236 vm : Defining RIOT native process line4_3 -riotnative : Start the RIOT: socat EXEC:'/home/pschmerzl/RIOT/examples/networking/gnrc_networking/gnrc_networking/bin/native/gnrc_networking.elf line4_3',end-close,stderr,pty TCP-L:4713,reuseaddr,fork +riotnative : Start the RIOT: socat EXEC:'/home/pschmerzl/RIOT/examples/networking/gnrc/gnrc_networking/bin/native/gnrc_networking.elf line4_3',end-close,stderr,pty TCP-L:4713,reuseaddr,fork riotnative : PID: 18237 vm : Defining RIOT native process line4_2 -riotnative : Start the RIOT: socat EXEC:'/home/pschmerzl/RIOT/examples/networking/gnrc_networking/gnrc_networking/bin/native/gnrc_networking.elf line4_2',end-close,stderr,pty TCP-L:4714,reuseaddr,fork +riotnative : Start the RIOT: socat EXEC:'/home/pschmerzl/RIOT/examples/networking/gnrc/gnrc_networking/bin/native/gnrc_networking.elf line4_2',end-close,stderr,pty TCP-L:4714,reuseaddr,fork riotnative : PID: 18238 ``` diff --git a/dist/tools/dhcpv6-pd_ia/README.md b/dist/tools/dhcpv6-pd_ia/README.md index 6d3f9076bbdb..ebd380e4e0e8 100644 --- a/dist/tools/dhcpv6-pd_ia/README.md +++ b/dist/tools/dhcpv6-pd_ia/README.md @@ -22,4 +22,4 @@ the script [DHCPv6]: https://tools.ietf.org/html/rfc8415 [prefix delegation]: https://en.wikipedia.org/wiki/Prefix_delegation [Kea]: http://kea.isc.org -[`gnrc_border_router` example]: ../../../examples/networking/gnrc_networking/gnrc_borader_router +[`gnrc_border_router` example]: ../../../examples/networking/gnrc/gnrc_border_router diff --git a/dist/tools/eclipsesym/README.md b/dist/tools/eclipsesym/README.md index 667d16ca6ea5..6be2108ca786 100644 --- a/dist/tools/eclipsesym/README.md +++ b/dist/tools/eclipsesym/README.md @@ -12,7 +12,7 @@ otherwise change cmdline2xml.sh accordingly (ECLIPSE_PROJECT_NAME=RIOT). In the shell: - cd to application directory (e.g. examples/essentials/hello-world) + cd to application directory (e.g. examples/basic/hello-world) make eclipsesym In Eclipse: diff --git a/dist/tools/vagrant/freebsd/README.md b/dist/tools/vagrant/freebsd/README.md index 2812a3032ced..22be71b89705 100644 --- a/dist/tools/vagrant/freebsd/README.md +++ b/dist/tools/vagrant/freebsd/README.md @@ -39,8 +39,8 @@ Even applications requiring network interface access should be able to work: ```sh sudo dist/tools/tapsetup/tapsetup -make -C examples/networking/gnrc_networking/gnrc_networking all -j16 -make -C examples/networking/gnrc_networking/gnrc_networking term +make -C examples/networking/gnrc/gnrc_networking all -j16 +make -C examples/networking/gnrc/gnrc_networking term ``` ``` diff --git a/dist/tools/zep_dispatch/README.md b/dist/tools/zep_dispatch/README.md index 7c278357d255..254a90a510fc 100644 --- a/dist/tools/zep_dispatch/README.md +++ b/dist/tools/zep_dispatch/README.md @@ -117,7 +117,7 @@ This can be changed with the `TOPOLOGY` environment variable. Next, start the border router example with RPL enabled: - USEMODULE=gnrc_rpl make -C examples/networking/gnrc_networking/gnrc_borader_router all term + USEMODULE=gnrc_rpl make -C examples/networking/gnrc/gnrc_border_router all term Verify that the border router got a prefix on it's downstream interface with `ifconfig`. @@ -149,8 +149,8 @@ Iface 6 HWaddr: 7A:37:FC:7D:1A:AF Now start as many `gnrc_networking` nodes as you have mesh nodes defined in your topology file: - USE_ZEP=1 make -C examples/networking/gnrc_networking/gnrc_networking all term - USE_ZEP=1 make -C examples/networking/gnrc_networking/gnrc_networking all term + USE_ZEP=1 make -C examples/networking/gnrc/gnrc_networking all term + USE_ZEP=1 make -C examples/networking/gnrc/gnrc_networking all term … The node should be able to join the DODAG as you can verify with the `rpl` command: diff --git a/doc/doxygen/src/advanced-build-system-tricks.md b/doc/doxygen/src/advanced-build-system-tricks.md index d97f540f1c69..404add77acd8 100644 --- a/doc/doxygen/src/advanced-build-system-tricks.md +++ b/doc/doxygen/src/advanced-build-system-tricks.md @@ -78,7 +78,7 @@ Building application "default" for "samr21-xpro" with MCU "samd21". [...] text data bss dec hex filename - 37016 180 6008 43204 a8c4 /home/kaspar/src/riot/examples/essentials/default/bin/samr21-xpro/default.elf + 37016 180 6008 43204 a8c4 /home/kaspar/src/riot/examples/basic/default/bin/samr21-xpro/default.elf real 0m12.321s user 0m10.317s @@ -95,7 +95,7 @@ Building application "default" for "samr21-xpro" with MCU "samd21". [...] text data bss dec hex filename -37016 180 6008 43204 a8c4 /home/kaspar/src/riot/examples/essentials/default/bin/samr21-xpro/default.elf +37016 180 6008 43204 a8c4 /home/kaspar/src/riot/examples/basic/default/bin/samr21-xpro/default.elf real 0m15.462s user 0m12.410s @@ -112,7 +112,7 @@ Building application "default" for "samr21-xpro" with MCU "samd21". [...] text data bss dec hex filename - 37016 180 6008 43204 a8c4 /home/kaspar/src/riot/examples/essentials/default/bin/samr21-xpro/default.elf + 37016 180 6008 43204 a8c4 /home/kaspar/src/riot/examples/basic/default/bin/samr21-xpro/default.elf real 0m2.157s user 0m1.213s diff --git a/doc/doxygen/src/build-in-docker.md b/doc/doxygen/src/build-in-docker.md index ed84618bb96f..d059acc97d71 100644 --- a/doc/doxygen/src/build-in-docker.md +++ b/doc/doxygen/src/build-in-docker.md @@ -32,7 +32,7 @@ When building in docker one might want for the command ran in docker to inherit variables that might have been set in the command line. e.g.: ```shell -BOARD=samr21-xpro USEMODULE=xtimer make -C examples/essentials/hello-world +BOARD=samr21-xpro USEMODULE=xtimer make -C examples/basic/hello-world ``` In `docker.ink.mk` the origin of a variable listed in `DOCKER_ENV_VARS` is checked @@ -43,11 +43,11 @@ You can also set in `DOCKER_ENV_VARS` in the environment to add variables to the list, e.g.: ```shell -DOCKER_ENV_VARS=BEER_TYPE BEER_TYPE="imperial stout" BUILD_IN_DOCKER=1 make -C examples/essentials/hello-world/ +DOCKER_ENV_VARS=BEER_TYPE BEER_TYPE="imperial stout" BUILD_IN_DOCKER=1 make -C examples/basic/hello-world/ docker run --rm -t -u "$(id -u)" \ ... -e 'BEER_TYPE=imperial stout' \ - -w '/data/riotbuild/riotbase/examples/essentials/hello-world/' \ + -w '/data/riotbuild/riotbase/examples/basic/hello-world/' \ 'riot/riotbuild:latest' make ``` @@ -61,11 +61,11 @@ but will need to be prefixed with `-e` (see [option-summary]). e.g.: ``` -DOCKER_ENVIRONMENT_CMDLINE='-e BEER_TYPE="imperial stout"' BUILD_IN_DOCKER=1 make -C examples/essentials/hello-world/ +DOCKER_ENVIRONMENT_CMDLINE='-e BEER_TYPE="imperial stout"' BUILD_IN_DOCKER=1 make -C examples/basic/hello-world/ docker run --rm -t -u "$(id -u)" \ ... -e 'BEER_TYPE=imperial stout' \ - -w '/data/riotbuild/riotbase/examples/essentials/hello-world/' \ + -w '/data/riotbuild/riotbase/examples/basic/hello-world/' \ 'riot/riotbuild:latest' make ``` @@ -81,11 +81,11 @@ To pass variables overriding the command-line to docker `DOCKER_OVERRIDE_CMDLINE may be used: ```shell -DOCKER_OVERRIDE_CMDLINE="BEER_TYPE='imperial stout'" BUILD_IN_DOCKER=1 make -C examples/essentials/hello-world/ RIOT_CI_BUILD=1 +DOCKER_OVERRIDE_CMDLINE="BEER_TYPE='imperial stout'" BUILD_IN_DOCKER=1 make -C examples/basic/hello-world/ RIOT_CI_BUILD=1 Launching build container using image "riot/riotbuild:latest". sudo docker run --rm -t -u "$(id -u)" \ ... - -w '/data/riotbuild/riotbase/examples/essentials/hello-world/' \ + -w '/data/riotbuild/riotbase/examples/basic/hello-world/' \ 'riot/riotbuild:latest' make BEER_TYPE='imperial stout' 'RIOT_CI_BUILD=1' ``` diff --git a/doc/doxygen/src/creating-an-application.md b/doc/doxygen/src/creating-an-application.md index 5d656a8747bd..837fcca05f67 100644 --- a/doc/doxygen/src/creating-an-application.md +++ b/doc/doxygen/src/creating-an-application.md @@ -104,7 +104,7 @@ module support](#external-modules). 2. Add the source files within subdirectories to `SRC`, either explicitly or with Makefile wildcards. -Both approaches are illustrated and explained in `examples/essentials/subfolders`. +Both approaches are illustrated and explained in `examples/basic/subfolders`. # Helper tools diff --git a/doc/doxygen/src/flashing.md b/doc/doxygen/src/flashing.md index a1e398016328..50f7e3366ee7 100644 --- a/doc/doxygen/src/flashing.md +++ b/doc/doxygen/src/flashing.md @@ -293,7 +293,7 @@ Procedure: variable or on each `make` call: ~~~~~~~~~~~~~~~~~~~ - $ RIOT_MAKEFILES_GLOBAL_PRE=/path/to/makefile.pre make -C examples/essentials/hello-world flash term + $ RIOT_MAKEFILES_GLOBAL_PRE=/path/to/makefile.pre make -C examples/basic/hello-world flash term ~~~~~~~~~~~~~~~~~~~ @note if set as an environment variable it would be a good idea to add a diff --git a/doc/doxygen/src/getting-started.md b/doc/doxygen/src/getting-started.md index 412b2c3daf75..0f8661d8b7a6 100644 --- a/doc/doxygen/src/getting-started.md +++ b/doc/doxygen/src/getting-started.md @@ -207,7 +207,7 @@ Building and executing an example {#building-and-executing-an-example} --------------------------------- RIOT provides a number of examples in the `examples/` directory. Every example has a README that documents its usage and its purpose. You can build them by -opening a shell, navigating to an example (e.g. `examples/essentials/default`), and +opening a shell, navigating to an example (e.g. `examples/basic/default`), and running: ~~~~~~~~ {.sh} @@ -258,7 +258,7 @@ the `dist/tools/pyterm/` directory. If you choose to use another terminal program you can set `TERMPROG` (and if need be the `TERMFLAGS`) macros: ~~~~~~~~ {.sh} -make -C examples/networking/gnrc_networking/gnrc_networking/ term \ +make -C examples/networking/gnrc/gnrc_networking/ term \ BOARD=samr21-xpro \ TERMPROG=gtkterm \ TERMFLAGS="-s 115200 -p /dev/ttyACM0 -e" @@ -335,7 +335,7 @@ Usage The RIOT build system provides support for using the Docker container to build RIOT projects, so you do not need to type the long docker command line every time: -(**from the directory you would normally run make, e.g. examples/essentials/default**) +(**from the directory you would normally run make, e.g. examples/basic/default**) ```console $ make BUILD_IN_DOCKER=1 @@ -403,4 +403,4 @@ To create a bridge and two (or `count` at your option) tap interfaces: sudo ./dist/tools/tapsetup/tapsetup [-c []] ~~~~~~~ -A detailed example can be found in `examples/networking/gnrc_networking/gnrc_networking`. +A detailed example can be found in `examples/networking/gnrc/gnrc_networking`. diff --git a/doc/doxygen/src/mainpage.md b/doc/doxygen/src/mainpage.md index 767e9a6234b1..98f7da3d0860 100644 --- a/doc/doxygen/src/mainpage.md +++ b/doc/doxygen/src/mainpage.md @@ -61,14 +61,14 @@ git checkout sudo ./dist/tools/tapsetup/tapsetup # create virtual Ethernet # interfaces to connect multiple # RIOT instances -cd examples/essentials/default/ +cd examples/basic/default/ make all make term ~~~~~~~ ... and you are in the RIOT shell! Type `help` to discover available commands. For further information see the -[README of the `default` example](https://github.com/RIOT-OS/RIOT/tree/master/examples/essentials/default). +[README of the `default` example](https://github.com/RIOT-OS/RIOT/tree/master/examples/basic/default). To use RIOT directly on your embedded platform, and for more hands-on details with RIOT, see @ref getting-started. diff --git a/doc/guides/setup-windows/README.md b/doc/guides/setup-windows/README.md index 9ba539b55881..3e40c6c542c9 100644 --- a/doc/guides/setup-windows/README.md +++ b/doc/guides/setup-windows/README.md @@ -215,7 +215,7 @@ sudo apt install make gcc-multilib python3-serial wget unzip git openocd gdb-mul Just wait for this to complete.) - Type `git clone https://github.com/RIOT-OS/RIOT` and confirm with the return-key - This may take some time. Eventually, it will print `done.` when it completed -- Type `cd RIOT/examples/essentials/hello-world` and confirm with the return-key to enter +- Type `cd RIOT/examples/basic/hello-world` and confirm with the return-key to enter the folder `hello-world` example app in the RIOT repo - Type `make` and confirm with the return key to build the app for the board `native` @@ -239,12 +239,12 @@ sudo apt install make gcc-multilib python3-serial wget unzip git openocd gdb-mul ![Ubuntu terminal running `make compile-commands` in the `hello-world` app](img/06-Use_VS_Code-00.png) - If not already open, open the Ubuntu terminal -- Confirm that the terminal is pointed to the folder `~/RIOT/examples/essentials/hello-world` +- Confirm that the terminal is pointed to the folder `~/RIOT/examples/basic/hello-world` - The blue part left of the prompt (the `$` sign in the terminal) shows the current working directory for the terminal - - If the blue string is not `~/RIOT/examples/essentials/hello-world`, type - `cd ~/RIOT/examples/essentials/hello-world` to enter that path -- Inside `~/RIOT/examples/essentials/hello-world` run the command `make compile-commands` + - If the blue string is not `~/RIOT/examples/basic/hello-world`, type + `cd ~/RIOT/examples/basic/hello-world` to enter that path +- Inside `~/RIOT/examples/basic/hello-world` run the command `make compile-commands` - The output should look like above ![Launching VS Code from Ubuntu](img/06-Use_VS_Code-01.png) @@ -307,7 +307,7 @@ sudo apt install make gcc-multilib python3-serial wget unzip git openocd gdb-mul in the source code - Save the modified source code (e.g. `Ctrl`+`S`) - Open the integrated terminal by clicking on the terminal tab at the bottom -- Navigate to `~/RIOT/examples/essentials/hello-world` using `cd ~/RIOT/examples/essentials/hello-world` +- Navigate to `~/RIOT/examples/basic/hello-world` using `cd ~/RIOT/examples/basic/hello-world` - Run the `make` command to build the code - Run make `make term` to launch the application - The result should look like: @@ -415,7 +415,7 @@ been attached to WSL and VS Code has been launched from within WSL by running 2. Open the `default` folder within `examples` 3. Open the `main.c` file in the `default` folder 4. Select the "Terminal" tab at the bottom -5. Enter `cd ~/RIOT/examples/essentials/default` to enter the `default` folder also in the terminal +5. Enter `cd ~/RIOT/examples/basic/default` to enter the `default` folder also in the terminal 6. Run `make BOARD=esp32-mh-et-live-minikit compile-commands` - You can replace `esp32-mh-et-live-minikit` with the name of any other supported board diff --git a/drivers/atwinc15x0/doc.txt b/drivers/atwinc15x0/doc.txt index ffd5acd9c68f..530fb59cfd02 100644 --- a/drivers/atwinc15x0/doc.txt +++ b/drivers/atwinc15x0/doc.txt @@ -168,7 +168,7 @@ CFLAGS='-DWIFI_SSID=\"ssid\" -DWIFI_PASS=\"pass\" \ -DATWINC15X0_PARAM_SSN_PIN=GPIO_PIN\(1,6\) \ -DATWINC15X0_PARAM_RESET_PIN=GPIO_PIN\(1,4\) \ -DATWINC15X0_PARAM_IRQ_PIN=GPIO_PIN\(0,8\)' \ -make BOARD=... -C examples/networking/gnrc_networking/gnrc_networking flash term +make BOARD=... -C examples/networking/gnrc/gnrc_networking flash term ``` */ diff --git a/drivers/doc.txt b/drivers/doc.txt index 2e1c460641cd..70450d50141e 100644 --- a/drivers/doc.txt +++ b/drivers/doc.txt @@ -157,7 +157,7 @@ * The driver is enabled by using the module `shield_w5100`, e.g. with: * * ``` - * USEMODULE=shield_w5100 make BOARD=arduino-due -C examples/networking/gnrc_networking/gnrc_networking + * USEMODULE=shield_w5100 make BOARD=arduino-due -C examples/networking/gnrc/gnrc_networking * ``` * * It depends on @ref drivers_w5100 and provides nothing more than the providing diff --git a/examples/README.md b/examples/README.md index 17c6acc93fbc..89864f175fd3 100644 --- a/examples/README.md +++ b/examples/README.md @@ -10,15 +10,15 @@ Here is a quick overview of the examples available in the RIOT: | Example | Description | |---------|-------------| -| [default](./essentials/default/README.md) | This application is a showcase for RIOT's hardware support. Using it for your board, you should be able to interactively use any hardware that is supported. | -| [hello-world](./essentials/hello-world/README.md) | A simple "Hello World" that shows the basic structure of a RIOT application. | -| [blinky](./essentials/blinky/README.md) | The classic "Hello World" example for embedded systems: blinking an LED (or printing "Blink!" via stdio when none are available). | -| [leds_shell](./essentials/leds_shell/README.md) | The application `leds_shell` is a basic example, which allows easy, interactive control of internal board LEDs, and basic GPIO for externally connected simple devices (for e.g. additional LEDs, relay, motors - via dedicated drivers, etc.) via the shell. | -| [saul](./essentials/saul/README.md) | This example demonstrates the usage of the SAUL (Sensor Actuator Uber Layer) module. | -| [timer_periodic_wakeup](./essentials/timer_periodic_wakeup/README.md) | How to set up a periodic wakeup timer using the RIOT operating system. | -| [ipc_pingpong](./essentials/ipc_pingpong/README.md) | This example is to illustrate the usage of RIOTs IPC messaging system. | -| [filesystem](./essentials/filesystem/README.md) | This example showcases ways to interact/manage the filesystem in RIOT. | -| [subfolders](./essentials/subfolders/README.md) | This example demonstrates how to use subfolders in RIOT applications. | +| [default](./basic/default/README.md) | This application is a showcase for RIOT's hardware support. Using it for your board, you should be able to interactively use any hardware that is supported. | +| [hello-world](./basic/hello-world/README.md) | A simple "Hello World" that shows the basic structure of a RIOT application. | +| [blinky](./basic/blinky/README.md) | The classic "Hello World" example for embedded systems: blinking an LED (or printing "Blink!" via stdio when none are available). | +| [leds_shell](./basic/leds_shell/README.md) | The application `leds_shell` is a basic example, which allows easy, interactive control of internal board LEDs, and basic GPIO for externally connected simple devices (for e.g. additional LEDs, relay, motors - via dedicated drivers, etc.) via the shell. | +| [saul](./basic/saul/README.md) | This example demonstrates the usage of the SAUL (Sensor Actuator Uber Layer) module. | +| [timer_periodic_wakeup](./basic/timer_periodic_wakeup/README.md) | How to set up a periodic wakeup timer using the RIOT operating system. | +| [ipc_pingpong](./basic/ipc_pingpong/README.md) | This example is to illustrate the usage of RIOTs IPC messaging system. | +| [filesystem](./basic/filesystem/README.md) | This example showcases ways to interact/manage the filesystem in RIOT. | +| [subfolders](./basic/subfolders/README.md) | This example demonstrates how to use subfolders in RIOT applications. | ## RIOT Language Bindings @@ -28,26 +28,26 @@ Here is a quick overview of the examples available in the RIOT: | Example | Description | |---------|-------------| -| [rust-hello-world](./language_bindings/officially_supported/rust-hello-world/README.md) | This example demonstrates how to write a simple RIOT application in Rust. | -| [rust-gcoap](./language_bindings/officially_supported/rust-gcoap/README.md) | This example demonstrates how to write a coap server application in Rust using the RIOTs gcoap module. | -| [rust-async](./language_bindings/officially_supported/rust-async/README.md) | This example demonstrates how to use Rusts async/await syntax in a RIOT application. | +| [rust-hello-world](./lang_support/official/rust-hello-world/README.md) | This example demonstrates how to write a simple RIOT application in Rust. | +| [rust-gcoap](./lang_support/official/rust-gcoap/README.md) | This example demonstrates how to write a coap server application in Rust using the RIOTs gcoap module. | +| [rust-async](./lang_support/official/rust-async/README.md) | This example demonstrates how to use Rusts async/await syntax in a RIOT application. | ##### _C++_ | Example | Description | |---------|-------------| -| [riot_and_cpp](./language_bindings/officially_supported/riot_and_cpp/README.md) | Example of using C++ in RIOT applications. | +| [riot_and_cpp](./lang_support/official/riot_and_cpp/README.md) | Example of using C++ in RIOT applications. | #### Community Supported | Example | Description | |---------|-------------| -| [javascript](./language_bindings/community_supported/javascript/README.md) | How to write IoT applications using javascript using JerryScript. | -| [lua_basic](./language_bindings/community_supported/lua_basic/README.md) | How to write IoT applications using Lua. | -| [lua_REPL](./language_bindings/community_supported/lua_REPL/README.md) | This example demonstrates how to use the Lua Read-Eval-Print Loop (REPL) in RIOT. | -| [micropython](./language_bindings/community_supported/micropython/README.md) | How to use the MicroPython port for RIOT. | -| [wasm](./language_bindings/community_supported/wasm/README.md) | How to use WebAssembly in RIOT. | -| [arduino_hello-world](./language_bindings/community_supported/arduino_hello-world/README.md) | This application demonstrates the usage of Arduino sketches in RIOT. | +| [javascript](./lang_support/community/javascript/README.md) | How to write IoT applications using javascript using JerryScript. | +| [lua_basic](./lang_support/community/lua_basic/README.md) | How to write IoT applications using Lua. | +| [lua_REPL](./lang_support/community/lua_REPL/README.md) | This example demonstrates how to use the Lua Read-Eval-Print Loop (REPL) in RIOT. | +| [micropython](./lang_support/community/micropython/README.md) | How to use the MicroPython port for RIOT. | +| [wasm](./lang_support/community/wasm/README.md) | How to use WebAssembly in RIOT. | +| [arduino_hello-world](./lang_support/community/arduino_hello-world/README.md) | This application demonstrates the usage of Arduino sketches in RIOT. | ## Networking @@ -67,16 +67,16 @@ Here is a quick overview of the examples available in the RIOT: | Example | Description | |---------|-------------| -| [nimble_scanner](./networking/bluetooth_low_energy/nimble/nimble_scanner/README.md) | This example showcases the usage of the `NimBLE` BLE stack as a scanner. | -| [nimble_gatt](./networking/bluetooth_low_energy/nimble/nimble_gatt/README.md) | This example application configures and runs the NimBLE BLE stack as simple GATT server. | -| [nimble_heart_rate_sensor](./networking/bluetooth_low_energy/nimble/nimble_heart_rate_sensor/README.md) | This example demonstrates how to implement asynchronous data transfer using GATT notifications by implementing a mock-up BLE heart rate sensor. | +| [nimble_scanner](./networking/ble/nimble/nimble_scanner/README.md) | This example showcases the usage of the `NimBLE` BLE stack as a scanner. | +| [nimble_gatt](./networking/ble/nimble/nimble_gatt/README.md) | This example application configures and runs the NimBLE BLE stack as simple GATT server. | +| [nimble_heart_rate_sensor](./networking/ble/nimble/nimble_heart_rate_sensor/README.md) | This example demonstrates how to implement asynchronous data transfer using GATT notifications by implementing a mock-up BLE heart rate sensor. | #### Misc BLE Examples | Example | Description | |---------|-------------| -| [skald_eddystone](./networking/bluetooth_low_energy/misc_ble_examples/skald_eddystone/README.md) | This example demonstrates the usage of `Skald` for creating an Google `Eddystone` beacon. | -| [skald_ibeacon](./networking/bluetooth_low_energy/misc_ble_examples/skald_ibeacon/README.md) | This example demonstrates the usage of `Skald` for creating an Apple `iBeacon`. | +| [skald_eddystone](./networking/ble/misc/skald_eddystone/README.md) | This example demonstrates the usage of `Skald` for creating an Google `Eddystone` beacon. | +| [skald_ibeacon](./networking/ble/misc/skald_ibeacon/README.md) | This example demonstrates the usage of `Skald` for creating an Apple `iBeacon`. | ### MQTT @@ -90,20 +90,20 @@ Here is a quick overview of the examples available in the RIOT: | Example | Description | |---------|-------------| -| [cord_ep](./networking/core_resource_directory/cord_ep/README.md) | Example of RIOT's Resource Directory (RD) endpoint module, called `cord_ep` | -| [cord_lc](./networking/core_resource_directory/cord_lc/README.md) | Example of RIOT's Resource Directory (RD) lookup module, called `cord_lc` | -| [cord_epsim](./networking/core_resource_directory/cord_epsim/README.md) | This example shows how a node can register with a CoRE resource directory | +| [cord_ep](./networking/cord/cord_ep/README.md) | Example of RIOT's Resource Directory (RD) endpoint module, called `cord_ep` | +| [cord_lc](./networking/cord/cord_lc/README.md) | Example of RIOT's Resource Directory (RD) lookup module, called `cord_lc` | +| [cord_epsim](./networking/cord/cord_epsim/README.md) | This example shows how a node can register with a CoRE resource directory | ### GNRC Networking | Example | Description | |---------|-------------| -| [gnrc_minimal](./networking/gnrc_networking/gnrc_minimal/README.md) | This is a minimalistic example for RIOT's gnrc network stack. | -| [gnrc_networking](./networking/gnrc_networking/gnrc_networking/README.md) | This example demonstrates the usage of the GNRC network stack in RIOT. | -| [gnrc_networking_subnets](./networking/gnrc_networking/gnrc_networking_subnets/README.md) | This example demonstrates IPv6 subnet auto-configuration for networks on a tree topology. | -| [gnrc_border_router](./networking/gnrc_networking/gnrc_border_router/README.md) | Example of `gnrc_border_router` using automatic configuration | -| [gnrc_lorawan](./networking/gnrc_networking/gnrc_lorawan/README.md) | Send and receive LoRaWAN packets and perform basic LoRaWAN commands | -| [gnrc_networking_mac](./networking/gnrc_networking/gnrc_networking_mac/README.md) | This example shows you how to try out communications between RIOT instances with duty-cycled MAC layer protocols | +| [gnrc_minimal](./networking/gnrc/gnrc_minimal/README.md) | This is a minimalistic example for RIOT's gnrc network stack. | +| [gnrc_networking](./networking/gnrc/gnrc_networking/README.md) | This example demonstrates the usage of the GNRC network stack in RIOT. | +| [gnrc_networking_subnets](./networking/gnrc/gnrc_networking_subnets/README.md) | This example demonstrates IPv6 subnet auto-configuration for networks on a tree topology. | +| [gnrc_border_router](./networking/gnrc/gnrc_border_router/README.md) | Example of `gnrc_border_router` using automatic configuration | +| [gnrc_lorawan](./networking/gnrc/gnrc_lorawan/README.md) | Send and receive LoRaWAN packets and perform basic LoRaWAN commands | +| [gnrc_networking_mac](./networking/gnrc/gnrc_networking_mac/README.md) | This example shows you how to try out communications between RIOT instances with duty-cycled MAC layer protocols | ### DTLS @@ -132,13 +132,13 @@ Here is a quick overview of the examples available in the RIOT: | Example | Description | |---------|-------------| -| [bindist](./advanced_examples/bindist/README.md) | RIOT allows for creating a "binary distribution", which can be used to ship proprietary, compiled objects in a way that makes it possible to re-link them against a freshly compiled RIOT. This application serves as a simple example. | -| [usbus_minimal](./advanced_examples/usbus_minimal/README.md) | This is a minimalistic example for RIOT's USB stack. | -| [suit_update](./advanced_examples/advanced_examples/suit_update/README.md) | This example shows how to integrate SUIT-compliant firmware updates into a RIOT application. | -| [thread_duel](./advanced_examples/thread_duel/README.md) | This is a thread duel application to show RIOTs abilities to run multiple-threads concurrently, even if they are neither cooperative nor dividable into different scheduler priorities, by using the optional round-robin scheduler module. | -| [posix_select](./advanced_examples/posix_select/README.md) | This example is a showcase for RIOT's POSIX select support | -| [psa_crypto](./advanced_examples/psa_crypto/README.md) | Basic functions of the PSA Crypto API | -| [pio_blink](./advanced_examples/pio_blink/README.md) | How to use the PIO peripheral on the RaspberryPi Pico to blink an LED. | -| [twr_aloha](./advanced_examples/twr_aloha/README.md) | This example allows testing different two-way ranging algorithms between two boards supporting a dw1000 device. This makes use of the uwb-core pkg. | -| [senml_saul](./advanced_examples/senml_saul/README.md) | This example demonstrates the usage of the SAUL (Sensor Actuator Uber Layer) module with the SenML (Sensor Measurement Lists) format. | -| [opendsme](./advanced_examples/opendsme/README.md) | This example demonstrates the usage of the OpenDSME module in RIOT. | +| [bindist](./advanced/bindist/README.md) | RIOT allows for creating a "binary distribution", which can be used to ship proprietary, compiled objects in a way that makes it possible to re-link them against a freshly compiled RIOT. This application serves as a simple example. | +| [usbus_minimal](./advanced/usbus_minimal/README.md) | This is a minimalistic example for RIOT's USB stack. | +| [suit_update](./advanced/advanced/suit_update/README.md) | This example shows how to integrate SUIT-compliant firmware updates into a RIOT application. | +| [thread_duel](./advanced/thread_duel/README.md) | This is a thread duel application to show RIOTs abilities to run multiple-threads concurrently, even if they are neither cooperative nor dividable into different scheduler priorities, by using the optional round-robin scheduler module. | +| [posix_select](./advanced/posix_select/README.md) | This example is a showcase for RIOT's POSIX select support | +| [psa_crypto](./advanced/psa_crypto/README.md) | Basic functions of the PSA Crypto API | +| [pio_blink](./advanced/pio_blink/README.md) | How to use the PIO peripheral on the RaspberryPi Pico to blink an LED. | +| [twr_aloha](./advanced/twr_aloha/README.md) | This example allows testing different two-way ranging algorithms between two boards supporting a dw1000 device. This makes use of the uwb-core pkg. | +| [senml_saul](./advanced/senml_saul/README.md) | This example demonstrates the usage of the SAUL (Sensor Actuator Uber Layer) module with the SenML (Sensor Measurement Lists) format. | +| [opendsme](./advanced/opendsme/README.md) | This example demonstrates the usage of the OpenDSME module in RIOT. | diff --git a/examples/advanced_examples/bindist/Makefile b/examples/advanced/bindist/Makefile similarity index 100% rename from examples/advanced_examples/bindist/Makefile rename to examples/advanced/bindist/Makefile diff --git a/examples/advanced_examples/bindist/README.md b/examples/advanced/bindist/README.md similarity index 100% rename from examples/advanced_examples/bindist/README.md rename to examples/advanced/bindist/README.md diff --git a/examples/advanced_examples/bindist/abc/Makefile b/examples/advanced/bindist/abc/Makefile similarity index 100% rename from examples/advanced_examples/bindist/abc/Makefile rename to examples/advanced/bindist/abc/Makefile diff --git a/examples/advanced_examples/bindist/abc/abc.c b/examples/advanced/bindist/abc/abc.c similarity index 100% rename from examples/advanced_examples/bindist/abc/abc.c rename to examples/advanced/bindist/abc/abc.c diff --git a/examples/advanced_examples/bindist/main.c b/examples/advanced/bindist/main.c similarity index 100% rename from examples/advanced_examples/bindist/main.c rename to examples/advanced/bindist/main.c diff --git a/examples/advanced_examples/opendsme/Makefile b/examples/advanced/opendsme/Makefile similarity index 100% rename from examples/advanced_examples/opendsme/Makefile rename to examples/advanced/opendsme/Makefile diff --git a/examples/advanced_examples/opendsme/Makefile.ci b/examples/advanced/opendsme/Makefile.ci similarity index 100% rename from examples/advanced_examples/opendsme/Makefile.ci rename to examples/advanced/opendsme/Makefile.ci diff --git a/examples/advanced_examples/opendsme/README.md b/examples/advanced/opendsme/README.md similarity index 100% rename from examples/advanced_examples/opendsme/README.md rename to examples/advanced/opendsme/README.md diff --git a/examples/advanced_examples/opendsme/main.c b/examples/advanced/opendsme/main.c similarity index 100% rename from examples/advanced_examples/opendsme/main.c rename to examples/advanced/opendsme/main.c diff --git a/examples/advanced_examples/pio_blink/Makefile b/examples/advanced/pio_blink/Makefile similarity index 100% rename from examples/advanced_examples/pio_blink/Makefile rename to examples/advanced/pio_blink/Makefile diff --git a/examples/advanced_examples/pio_blink/README.md b/examples/advanced/pio_blink/README.md similarity index 100% rename from examples/advanced_examples/pio_blink/README.md rename to examples/advanced/pio_blink/README.md diff --git a/examples/advanced_examples/pio_blink/main.c b/examples/advanced/pio_blink/main.c similarity index 100% rename from examples/advanced_examples/pio_blink/main.c rename to examples/advanced/pio_blink/main.c diff --git a/examples/advanced_examples/pio_blink/rpx0xx_pio_blink/Makefile b/examples/advanced/pio_blink/rpx0xx_pio_blink/Makefile similarity index 100% rename from examples/advanced_examples/pio_blink/rpx0xx_pio_blink/Makefile rename to examples/advanced/pio_blink/rpx0xx_pio_blink/Makefile diff --git a/examples/advanced_examples/pio_blink/rpx0xx_pio_blink/blink.c b/examples/advanced/pio_blink/rpx0xx_pio_blink/blink.c similarity index 100% rename from examples/advanced_examples/pio_blink/rpx0xx_pio_blink/blink.c rename to examples/advanced/pio_blink/rpx0xx_pio_blink/blink.c diff --git a/examples/advanced_examples/pio_blink/rpx0xx_pio_blink/blink.pio b/examples/advanced/pio_blink/rpx0xx_pio_blink/blink.pio similarity index 100% rename from examples/advanced_examples/pio_blink/rpx0xx_pio_blink/blink.pio rename to examples/advanced/pio_blink/rpx0xx_pio_blink/blink.pio diff --git a/examples/advanced_examples/posix_select/Makefile b/examples/advanced/posix_select/Makefile similarity index 100% rename from examples/advanced_examples/posix_select/Makefile rename to examples/advanced/posix_select/Makefile diff --git a/examples/advanced_examples/posix_select/Makefile.ci b/examples/advanced/posix_select/Makefile.ci similarity index 100% rename from examples/advanced_examples/posix_select/Makefile.ci rename to examples/advanced/posix_select/Makefile.ci diff --git a/examples/advanced_examples/posix_select/README.md b/examples/advanced/posix_select/README.md similarity index 100% rename from examples/advanced_examples/posix_select/README.md rename to examples/advanced/posix_select/README.md diff --git a/examples/advanced_examples/posix_select/main.c b/examples/advanced/posix_select/main.c similarity index 100% rename from examples/advanced_examples/posix_select/main.c rename to examples/advanced/posix_select/main.c diff --git a/examples/advanced_examples/psa_crypto/Makefile b/examples/advanced/psa_crypto/Makefile similarity index 100% rename from examples/advanced_examples/psa_crypto/Makefile rename to examples/advanced/psa_crypto/Makefile diff --git a/examples/advanced_examples/psa_crypto/Makefile.ci b/examples/advanced/psa_crypto/Makefile.ci similarity index 100% rename from examples/advanced_examples/psa_crypto/Makefile.ci rename to examples/advanced/psa_crypto/Makefile.ci diff --git a/examples/advanced_examples/psa_crypto/README.md b/examples/advanced/psa_crypto/README.md similarity index 100% rename from examples/advanced_examples/psa_crypto/README.md rename to examples/advanced/psa_crypto/README.md diff --git a/examples/advanced_examples/psa_crypto/app.config.base b/examples/advanced/psa_crypto/app.config.base similarity index 100% rename from examples/advanced_examples/psa_crypto/app.config.base rename to examples/advanced/psa_crypto/app.config.base diff --git a/examples/advanced_examples/psa_crypto/app.config.multi_se b/examples/advanced/psa_crypto/app.config.multi_se similarity index 100% rename from examples/advanced_examples/psa_crypto/app.config.multi_se rename to examples/advanced/psa_crypto/app.config.multi_se diff --git a/examples/advanced_examples/psa_crypto/app.config.se b/examples/advanced/psa_crypto/app.config.se similarity index 100% rename from examples/advanced_examples/psa_crypto/app.config.se rename to examples/advanced/psa_crypto/app.config.se diff --git a/examples/advanced_examples/psa_crypto/custom_atca_params.h b/examples/advanced/psa_crypto/custom_atca_params.h similarity index 100% rename from examples/advanced_examples/psa_crypto/custom_atca_params.h rename to examples/advanced/psa_crypto/custom_atca_params.h diff --git a/examples/advanced_examples/psa_crypto/example_cipher_aes_128.c b/examples/advanced/psa_crypto/example_cipher_aes_128.c similarity index 100% rename from examples/advanced_examples/psa_crypto/example_cipher_aes_128.c rename to examples/advanced/psa_crypto/example_cipher_aes_128.c diff --git a/examples/advanced_examples/psa_crypto/example_ecdsa_p256.c b/examples/advanced/psa_crypto/example_ecdsa_p256.c similarity index 100% rename from examples/advanced_examples/psa_crypto/example_ecdsa_p256.c rename to examples/advanced/psa_crypto/example_ecdsa_p256.c diff --git a/examples/advanced_examples/psa_crypto/example_eddsa.c b/examples/advanced/psa_crypto/example_eddsa.c similarity index 100% rename from examples/advanced_examples/psa_crypto/example_eddsa.c rename to examples/advanced/psa_crypto/example_eddsa.c diff --git a/examples/advanced_examples/psa_crypto/example_hash.c b/examples/advanced/psa_crypto/example_hash.c similarity index 100% rename from examples/advanced_examples/psa_crypto/example_hash.c rename to examples/advanced/psa_crypto/example_hash.c diff --git a/examples/advanced_examples/psa_crypto/example_hmac_sha256.c b/examples/advanced/psa_crypto/example_hmac_sha256.c similarity index 100% rename from examples/advanced_examples/psa_crypto/example_hmac_sha256.c rename to examples/advanced/psa_crypto/example_hmac_sha256.c diff --git a/examples/advanced_examples/psa_crypto/main.c b/examples/advanced/psa_crypto/main.c similarity index 100% rename from examples/advanced_examples/psa_crypto/main.c rename to examples/advanced/psa_crypto/main.c diff --git a/examples/advanced_examples/psa_crypto/tests/01-run.py b/examples/advanced/psa_crypto/tests/01-run.py similarity index 100% rename from examples/advanced_examples/psa_crypto/tests/01-run.py rename to examples/advanced/psa_crypto/tests/01-run.py diff --git a/examples/advanced_examples/senml_saul/Makefile b/examples/advanced/senml_saul/Makefile similarity index 100% rename from examples/advanced_examples/senml_saul/Makefile rename to examples/advanced/senml_saul/Makefile diff --git a/examples/advanced_examples/senml_saul/Makefile.ci b/examples/advanced/senml_saul/Makefile.ci similarity index 100% rename from examples/advanced_examples/senml_saul/Makefile.ci rename to examples/advanced/senml_saul/Makefile.ci diff --git a/examples/advanced_examples/senml_saul/README.md b/examples/advanced/senml_saul/README.md similarity index 100% rename from examples/advanced_examples/senml_saul/README.md rename to examples/advanced/senml_saul/README.md diff --git a/examples/advanced_examples/senml_saul/main.c b/examples/advanced/senml_saul/main.c similarity index 100% rename from examples/advanced_examples/senml_saul/main.c rename to examples/advanced/senml_saul/main.c diff --git a/examples/advanced_examples/suit_update/Makefile b/examples/advanced/suit_update/Makefile similarity index 100% rename from examples/advanced_examples/suit_update/Makefile rename to examples/advanced/suit_update/Makefile diff --git a/examples/advanced_examples/suit_update/Makefile.board.dep b/examples/advanced/suit_update/Makefile.board.dep similarity index 100% rename from examples/advanced_examples/suit_update/Makefile.board.dep rename to examples/advanced/suit_update/Makefile.board.dep diff --git a/examples/advanced_examples/suit_update/Makefile.ci b/examples/advanced/suit_update/Makefile.ci similarity index 100% rename from examples/advanced_examples/suit_update/Makefile.ci rename to examples/advanced/suit_update/Makefile.ci diff --git a/examples/advanced_examples/suit_update/Makefile.suit.custom b/examples/advanced/suit_update/Makefile.suit.custom similarity index 100% rename from examples/advanced_examples/suit_update/Makefile.suit.custom rename to examples/advanced/suit_update/Makefile.suit.custom diff --git a/examples/advanced_examples/suit_update/README.hardware.md b/examples/advanced/suit_update/README.hardware.md similarity index 94% rename from examples/advanced_examples/suit_update/README.hardware.md rename to examples/advanced/suit_update/README.hardware.md index 8f2667158205..12ec58ec437b 100644 --- a/examples/advanced_examples/suit_update/README.hardware.md +++ b/examples/advanced/suit_update/README.hardware.md @@ -45,7 +45,7 @@ properly. In order to get a SUIT capable firmware onto the node, run - $ BOARD=samr21-xpro make -C examples/advanced_examples/suit_update clean flash -j4 + $ BOARD=samr21-xpro make -C examples/advanced/suit_update clean flash -j4 This command also generates the cryptographic keys (private/public) used to sign and verify the manifest and images. See the "Key generation" section in @@ -58,7 +58,7 @@ interface: In another terminal, run: - $ BOARD=samr21-xpro make -C examples/advanced_examples/suit_update/ term + $ BOARD=samr21-xpro make -C examples/advanced/suit_update/ term ### Alternative: Setup a wireless device behind a border router [setup-wireless]: #Setup-a-wireless-device-behind-a-border-router @@ -107,11 +107,11 @@ First un-comment L28 in the application [Makefile](Makefile) so `netdev_default` is included in the build. In this scenario the node will be connected through a border router. Ethos must be disabled in the firmware when building and flashing the firmware: - $ USE_ETHOS=0 BOARD=samr21-xpro make -C examples/advanced_examples/suit_update clean flash -j4 + $ USE_ETHOS=0 BOARD=samr21-xpro make -C examples/advanced/suit_update clean flash -j4 Open a serial terminal on the device to get its global address: - $ USE_ETHOS=0 BOARD=samr21-xpro make -C examples/advanced_examples/suit_update term + $ USE_ETHOS=0 BOARD=samr21-xpro make -C examples/advanced/suit_update term If the Border Router is already set up when opening the terminal you should get @@ -150,13 +150,13 @@ the prefix (`2001:db8::`) and the EUI64 suffix, in this case `7b7e:3255:1313:8d9 - Provision the wireless ble device: ``` - $ CFLAGS=-DCONFIG_GNRC_IPV6_NIB_SLAAC=1 USEMODULE+=nimble_autoconn_ipsp USE_ETHOS=0 BOARD=nrf52dk make -C examples/advanced_examples/suit_update clean flash -j4 + $ CFLAGS=-DCONFIG_GNRC_IPV6_NIB_SLAAC=1 USEMODULE+=nimble_autoconn_ipsp USE_ETHOS=0 BOARD=nrf52dk make -C examples/advanced/suit_update clean flash -j4 ``` - Open a serial terminal on the device to get its local address: ``` - $ USE_ETHOS=0 BOARD=nrf52dk make -C examples/advanced_examples/suit_update term + $ USE_ETHOS=0 BOARD=nrf52dk make -C examples/advanced/suit_update term ``` ... @@ -294,20 +294,20 @@ For this example, aiocoap-fileserver serves the files via CoAP. - To publish an update for a node in wired mode (behind ethos): - $ BOARD=samr21-xpro SUIT_COAP_SERVER=[2001:db8::1] make -C examples/advanced_examples/suit_update suit/publish + $ BOARD=samr21-xpro SUIT_COAP_SERVER=[2001:db8::1] make -C examples/advanced/suit_update suit/publish - To publish an update for a node in wireless mode (behind a border router): - $ BOARD=samr21-xpro USE_ETHOS=0 SUIT_COAP_SERVER=[2001:db8::1] make -C examples/advanced_examples/suit_update suit/publish + $ BOARD=samr21-xpro USE_ETHOS=0 SUIT_COAP_SERVER=[2001:db8::1] make -C examples/advanced/suit_update suit/publish This publishes into the server a new firmware for a samr21-xpro board. You should see 6 pairs of messages indicating where (filepath) the file was published and the corresponding coap resource URI ... - published "${RIOTBASE}/examples/advanced_examples/suit_update/bin/samr21-xpro/suit_files/riot.suit.1632124156.bin" + published "${RIOTBASE}/examples/advanced/suit_update/bin/samr21-xpro/suit_files/riot.suit.1632124156.bin" as "coap://[2001:db8::1]/fw/suit_update/samr21-xpro/riot.suit.1632124156.bin" - published "${RIOTBASE}/examples/advanced_examples/suit_update/bin/samr21-xpro/suit_files/riot.suit.latest.bin" + published "${RIOTBASE}/examples/advanced/suit_update/bin/samr21-xpro/suit_files/riot.suit.latest.bin" as "coap://[2001:db8::1]/fw/suit_update/samr21-xpro/riot.suit.latest.bin" ... @@ -357,11 +357,11 @@ SUIT_CLIENT=[2001:db8::7b7e:3255:1313:8d96]. - In wired mode: - $ SUIT_COAP_SERVER=[2001:db8::1] SUIT_CLIENT=[fe80::7b7e:3255:1313:8d96%riot] BOARD=samr21-xpro make -C examples/advanced_examples/suit_update suit/notify + $ SUIT_COAP_SERVER=[2001:db8::1] SUIT_CLIENT=[fe80::7b7e:3255:1313:8d96%riot] BOARD=samr21-xpro make -C examples/advanced/suit_update suit/notify - In wireless mode: - $ SUIT_COAP_SERVER=[2001:db8::1] SUIT_CLIENT=[2001:db8::7b7e:3255:1313:8d96] BOARD=samr21-xpro make -C examples/advanced_examples/suit_update suit/notify + $ SUIT_COAP_SERVER=[2001:db8::1] SUIT_CLIENT=[2001:db8::7b7e:3255:1313:8d96] BOARD=samr21-xpro make -C examples/advanced/suit_update suit/notify This notifies the node of a new available manifest. Once the notification is @@ -455,7 +455,7 @@ The flash memory will be divided in the following way: The riotboot part of the flash will not be changed during suit_updates but be flashed a first time with at least one slot with suit_capable fw. - $ BOARD=samr21-xpro make -C examples/advanced_examples/suit_update clean flash + $ BOARD=samr21-xpro make -C examples/advanced/suit_update clean flash When calling make with the `flash` argument it will flash the bootloader and then to slot0 a copy of the firmware you intend to build. @@ -504,7 +504,7 @@ updatable RIOT image with `riotboot` or `suit/publish` make targets. This is simply done using the `suit/genkey` make target: - $ BOARD=samr21-xpro make -C examples/advanced_examples/suit_update suit/genkey + $ BOARD=samr21-xpro make -C examples/advanced/suit_update suit/genkey You will get this message in the terminal: @@ -637,7 +637,7 @@ To run the test, - compile and flash the application and bootloader: ``` - $ make -C examples/advanced_examples/suit_update clean all flash -j4 + $ make -C examples/advanced/suit_update clean all flash -j4 ``` - [set up the network][setup-wired-network] (in another shell): @@ -649,5 +649,5 @@ To run the test, - run the test: ``` - $ make -C examples/advanced_examples/suit_update test-with-config + $ make -C examples/advanced/suit_update test-with-config ``` diff --git a/examples/advanced_examples/suit_update/README.md b/examples/advanced/suit_update/README.md similarity index 100% rename from examples/advanced_examples/suit_update/README.md rename to examples/advanced/suit_update/README.md diff --git a/examples/advanced_examples/suit_update/README.native.md b/examples/advanced/suit_update/README.native.md similarity index 98% rename from examples/advanced_examples/suit_update/README.native.md rename to examples/advanced/suit_update/README.native.md index 94356a893e9b..d3245b1b8938 100644 --- a/examples/advanced_examples/suit_update/README.native.md +++ b/examples/advanced/suit_update/README.native.md @@ -31,7 +31,7 @@ $ aiocoap-fileserver coaproot 3. Build and start the native instance: ``` -$ BOARD=native make -C examples/advanced_examples/suit_update all term +$ BOARD=native make -C examples/advanced/suit_update all term ``` and add an address from the same range to the interface in RIOT ```console @@ -135,13 +135,13 @@ Before the natice instance can be started, it must be compiled first. Compilation can be started from the root of your RIOT directory with: ``` -$ BOARD=native make -C examples/advanced_examples/suit_update +$ BOARD=native make -C examples/advanced/suit_update ``` Then start the example with: ```console -$ BOARD=native make -C examples/advanced_examples/suit_update term +$ BOARD=native make -C examples/advanced/suit_update term ``` This starts an instance of the suit_update example as a process on your diff --git a/examples/advanced_examples/suit_update/coap_handler.c b/examples/advanced/suit_update/coap_handler.c similarity index 100% rename from examples/advanced_examples/suit_update/coap_handler.c rename to examples/advanced/suit_update/coap_handler.c diff --git a/examples/advanced_examples/suit_update/main.c b/examples/advanced/suit_update/main.c similarity index 100% rename from examples/advanced_examples/suit_update/main.c rename to examples/advanced/suit_update/main.c diff --git a/examples/advanced_examples/suit_update/native_steps.svg b/examples/advanced/suit_update/native_steps.svg similarity index 100% rename from examples/advanced_examples/suit_update/native_steps.svg rename to examples/advanced/suit_update/native_steps.svg diff --git a/examples/advanced_examples/suit_update/tests-with-config/01-run.py b/examples/advanced/suit_update/tests-with-config/01-run.py similarity index 100% rename from examples/advanced_examples/suit_update/tests-with-config/01-run.py rename to examples/advanced/suit_update/tests-with-config/01-run.py diff --git a/examples/advanced_examples/suit_update/tests-with-config/check-config.sh b/examples/advanced/suit_update/tests-with-config/check-config.sh similarity index 100% rename from examples/advanced_examples/suit_update/tests-with-config/check-config.sh rename to examples/advanced/suit_update/tests-with-config/check-config.sh diff --git a/examples/advanced_examples/thread_duel/Makefile b/examples/advanced/thread_duel/Makefile similarity index 100% rename from examples/advanced_examples/thread_duel/Makefile rename to examples/advanced/thread_duel/Makefile diff --git a/examples/advanced_examples/thread_duel/Makefile.ci b/examples/advanced/thread_duel/Makefile.ci similarity index 100% rename from examples/advanced_examples/thread_duel/Makefile.ci rename to examples/advanced/thread_duel/Makefile.ci diff --git a/examples/advanced_examples/thread_duel/README.md b/examples/advanced/thread_duel/README.md similarity index 100% rename from examples/advanced_examples/thread_duel/README.md rename to examples/advanced/thread_duel/README.md diff --git a/examples/advanced_examples/thread_duel/main.c b/examples/advanced/thread_duel/main.c similarity index 100% rename from examples/advanced_examples/thread_duel/main.c rename to examples/advanced/thread_duel/main.c diff --git a/examples/advanced_examples/twr_aloha/Makefile b/examples/advanced/twr_aloha/Makefile similarity index 100% rename from examples/advanced_examples/twr_aloha/Makefile rename to examples/advanced/twr_aloha/Makefile diff --git a/examples/advanced_examples/twr_aloha/Makefile.ci b/examples/advanced/twr_aloha/Makefile.ci similarity index 100% rename from examples/advanced_examples/twr_aloha/Makefile.ci rename to examples/advanced/twr_aloha/Makefile.ci diff --git a/examples/advanced_examples/twr_aloha/README.md b/examples/advanced/twr_aloha/README.md similarity index 100% rename from examples/advanced_examples/twr_aloha/README.md rename to examples/advanced/twr_aloha/README.md diff --git a/examples/advanced_examples/twr_aloha/control.c b/examples/advanced/twr_aloha/control.c similarity index 100% rename from examples/advanced_examples/twr_aloha/control.c rename to examples/advanced/twr_aloha/control.c diff --git a/examples/advanced_examples/twr_aloha/control.h b/examples/advanced/twr_aloha/control.h similarity index 100% rename from examples/advanced_examples/twr_aloha/control.h rename to examples/advanced/twr_aloha/control.h diff --git a/examples/advanced_examples/twr_aloha/main.c b/examples/advanced/twr_aloha/main.c similarity index 100% rename from examples/advanced_examples/twr_aloha/main.c rename to examples/advanced/twr_aloha/main.c diff --git a/examples/advanced_examples/twr_aloha/tests-with-config/01-run.py b/examples/advanced/twr_aloha/tests-with-config/01-run.py similarity index 100% rename from examples/advanced_examples/twr_aloha/tests-with-config/01-run.py rename to examples/advanced/twr_aloha/tests-with-config/01-run.py diff --git a/examples/advanced_examples/twr_aloha/twr_shell.c b/examples/advanced/twr_aloha/twr_shell.c similarity index 100% rename from examples/advanced_examples/twr_aloha/twr_shell.c rename to examples/advanced/twr_aloha/twr_shell.c diff --git a/examples/advanced_examples/twr_aloha/twr_shell.py b/examples/advanced/twr_aloha/twr_shell.py similarity index 100% rename from examples/advanced_examples/twr_aloha/twr_shell.py rename to examples/advanced/twr_aloha/twr_shell.py diff --git a/examples/advanced_examples/usbus_minimal/Makefile b/examples/advanced/usbus_minimal/Makefile similarity index 100% rename from examples/advanced_examples/usbus_minimal/Makefile rename to examples/advanced/usbus_minimal/Makefile diff --git a/examples/advanced_examples/usbus_minimal/README.md b/examples/advanced/usbus_minimal/README.md similarity index 100% rename from examples/advanced_examples/usbus_minimal/README.md rename to examples/advanced/usbus_minimal/README.md diff --git a/examples/advanced_examples/usbus_minimal/main.c b/examples/advanced/usbus_minimal/main.c similarity index 100% rename from examples/advanced_examples/usbus_minimal/main.c rename to examples/advanced/usbus_minimal/main.c diff --git a/examples/essentials/blinky/Makefile b/examples/basic/blinky/Makefile similarity index 100% rename from examples/essentials/blinky/Makefile rename to examples/basic/blinky/Makefile diff --git a/examples/essentials/blinky/Makefile.board.dep b/examples/basic/blinky/Makefile.board.dep similarity index 100% rename from examples/essentials/blinky/Makefile.board.dep rename to examples/basic/blinky/Makefile.board.dep diff --git a/examples/essentials/blinky/Makefile.ci b/examples/basic/blinky/Makefile.ci similarity index 100% rename from examples/essentials/blinky/Makefile.ci rename to examples/basic/blinky/Makefile.ci diff --git a/examples/essentials/blinky/README.md b/examples/basic/blinky/README.md similarity index 100% rename from examples/essentials/blinky/README.md rename to examples/basic/blinky/README.md diff --git a/examples/essentials/blinky/main.c b/examples/basic/blinky/main.c similarity index 100% rename from examples/essentials/blinky/main.c rename to examples/basic/blinky/main.c diff --git a/examples/essentials/default/Makefile b/examples/basic/default/Makefile similarity index 100% rename from examples/essentials/default/Makefile rename to examples/basic/default/Makefile diff --git a/examples/essentials/default/Makefile.board.dep b/examples/basic/default/Makefile.board.dep similarity index 100% rename from examples/essentials/default/Makefile.board.dep rename to examples/basic/default/Makefile.board.dep diff --git a/examples/essentials/default/Makefile.ci b/examples/basic/default/Makefile.ci similarity index 100% rename from examples/essentials/default/Makefile.ci rename to examples/basic/default/Makefile.ci diff --git a/examples/essentials/default/README.md b/examples/basic/default/README.md similarity index 99% rename from examples/essentials/default/README.md rename to examples/basic/default/README.md index eca877a21199..3c6983f25746 100644 --- a/examples/essentials/default/README.md +++ b/examples/basic/default/README.md @@ -1,4 +1,4 @@ -examples/essentials/default +examples/basic/default ================ This application is a showcase for RIOT's hardware support. Using it for your board, you should be able to interactively use any hardware diff --git a/examples/essentials/default/main.c b/examples/basic/default/main.c similarity index 100% rename from examples/essentials/default/main.c rename to examples/basic/default/main.c diff --git a/examples/essentials/filesystem/Makefile b/examples/basic/filesystem/Makefile similarity index 100% rename from examples/essentials/filesystem/Makefile rename to examples/basic/filesystem/Makefile diff --git a/examples/essentials/filesystem/Makefile.ci b/examples/basic/filesystem/Makefile.ci similarity index 100% rename from examples/essentials/filesystem/Makefile.ci rename to examples/basic/filesystem/Makefile.ci diff --git a/examples/essentials/filesystem/README.md b/examples/basic/filesystem/README.md similarity index 100% rename from examples/essentials/filesystem/README.md rename to examples/basic/filesystem/README.md diff --git a/examples/essentials/filesystem/main.c b/examples/basic/filesystem/main.c similarity index 100% rename from examples/essentials/filesystem/main.c rename to examples/basic/filesystem/main.c diff --git a/examples/essentials/hello-world/Makefile b/examples/basic/hello-world/Makefile similarity index 100% rename from examples/essentials/hello-world/Makefile rename to examples/basic/hello-world/Makefile diff --git a/examples/essentials/hello-world/README.md b/examples/basic/hello-world/README.md similarity index 100% rename from examples/essentials/hello-world/README.md rename to examples/basic/hello-world/README.md diff --git a/examples/essentials/hello-world/main.c b/examples/basic/hello-world/main.c similarity index 100% rename from examples/essentials/hello-world/main.c rename to examples/basic/hello-world/main.c diff --git a/examples/essentials/ipc_pingpong/Makefile b/examples/basic/ipc_pingpong/Makefile similarity index 100% rename from examples/essentials/ipc_pingpong/Makefile rename to examples/basic/ipc_pingpong/Makefile diff --git a/examples/essentials/ipc_pingpong/Makefile.ci b/examples/basic/ipc_pingpong/Makefile.ci similarity index 100% rename from examples/essentials/ipc_pingpong/Makefile.ci rename to examples/basic/ipc_pingpong/Makefile.ci diff --git a/examples/essentials/ipc_pingpong/README.md b/examples/basic/ipc_pingpong/README.md similarity index 100% rename from examples/essentials/ipc_pingpong/README.md rename to examples/basic/ipc_pingpong/README.md diff --git a/examples/essentials/ipc_pingpong/main.c b/examples/basic/ipc_pingpong/main.c similarity index 100% rename from examples/essentials/ipc_pingpong/main.c rename to examples/basic/ipc_pingpong/main.c diff --git a/examples/essentials/leds_shell/Makefile b/examples/basic/leds_shell/Makefile similarity index 100% rename from examples/essentials/leds_shell/Makefile rename to examples/basic/leds_shell/Makefile diff --git a/examples/essentials/leds_shell/Makefile.ci b/examples/basic/leds_shell/Makefile.ci similarity index 100% rename from examples/essentials/leds_shell/Makefile.ci rename to examples/basic/leds_shell/Makefile.ci diff --git a/examples/essentials/leds_shell/README.md b/examples/basic/leds_shell/README.md similarity index 100% rename from examples/essentials/leds_shell/README.md rename to examples/basic/leds_shell/README.md diff --git a/examples/essentials/leds_shell/main.c b/examples/basic/leds_shell/main.c similarity index 100% rename from examples/essentials/leds_shell/main.c rename to examples/basic/leds_shell/main.c diff --git a/examples/essentials/saul/Makefile b/examples/basic/saul/Makefile similarity index 100% rename from examples/essentials/saul/Makefile rename to examples/basic/saul/Makefile diff --git a/examples/essentials/saul/Makefile.ci b/examples/basic/saul/Makefile.ci similarity index 100% rename from examples/essentials/saul/Makefile.ci rename to examples/basic/saul/Makefile.ci diff --git a/examples/essentials/saul/README.md b/examples/basic/saul/README.md similarity index 100% rename from examples/essentials/saul/README.md rename to examples/basic/saul/README.md diff --git a/examples/essentials/saul/main.c b/examples/basic/saul/main.c similarity index 100% rename from examples/essentials/saul/main.c rename to examples/basic/saul/main.c diff --git a/examples/essentials/subfolders/Makefile b/examples/basic/subfolders/Makefile similarity index 100% rename from examples/essentials/subfolders/Makefile rename to examples/basic/subfolders/Makefile diff --git a/examples/essentials/subfolders/README.md b/examples/basic/subfolders/README.md similarity index 100% rename from examples/essentials/subfolders/README.md rename to examples/basic/subfolders/README.md diff --git a/examples/essentials/subfolders/folder/a.c b/examples/basic/subfolders/folder/a.c similarity index 100% rename from examples/essentials/subfolders/folder/a.c rename to examples/basic/subfolders/folder/a.c diff --git a/examples/essentials/subfolders/folder/subfolder/b.c b/examples/basic/subfolders/folder/subfolder/b.c similarity index 100% rename from examples/essentials/subfolders/folder/subfolder/b.c rename to examples/basic/subfolders/folder/subfolder/b.c diff --git a/examples/essentials/subfolders/folder/subfolder/c.c b/examples/basic/subfolders/folder/subfolder/c.c similarity index 100% rename from examples/essentials/subfolders/folder/subfolder/c.c rename to examples/basic/subfolders/folder/subfolder/c.c diff --git a/examples/essentials/subfolders/main.c b/examples/basic/subfolders/main.c similarity index 100% rename from examples/essentials/subfolders/main.c rename to examples/basic/subfolders/main.c diff --git a/examples/essentials/subfolders/module/Makefile b/examples/basic/subfolders/module/Makefile similarity index 100% rename from examples/essentials/subfolders/module/Makefile rename to examples/basic/subfolders/module/Makefile diff --git a/examples/essentials/subfolders/module/a.c b/examples/basic/subfolders/module/a.c similarity index 100% rename from examples/essentials/subfolders/module/a.c rename to examples/basic/subfolders/module/a.c diff --git a/examples/essentials/subfolders/module/b.c b/examples/basic/subfolders/module/b.c similarity index 100% rename from examples/essentials/subfolders/module/b.c rename to examples/basic/subfolders/module/b.c diff --git a/examples/essentials/timer_periodic_wakeup/Makefile b/examples/basic/timer_periodic_wakeup/Makefile similarity index 100% rename from examples/essentials/timer_periodic_wakeup/Makefile rename to examples/basic/timer_periodic_wakeup/Makefile diff --git a/examples/essentials/timer_periodic_wakeup/Makefile.ci b/examples/basic/timer_periodic_wakeup/Makefile.ci similarity index 100% rename from examples/essentials/timer_periodic_wakeup/Makefile.ci rename to examples/basic/timer_periodic_wakeup/Makefile.ci diff --git a/examples/essentials/timer_periodic_wakeup/README.md b/examples/basic/timer_periodic_wakeup/README.md similarity index 100% rename from examples/essentials/timer_periodic_wakeup/README.md rename to examples/basic/timer_periodic_wakeup/README.md diff --git a/examples/essentials/timer_periodic_wakeup/main.c b/examples/basic/timer_periodic_wakeup/main.c similarity index 100% rename from examples/essentials/timer_periodic_wakeup/main.c rename to examples/basic/timer_periodic_wakeup/main.c diff --git a/examples/language_bindings/community_supported/arduino_hello-world/Makefile b/examples/lang_support/community/arduino_hello-world/Makefile similarity index 100% rename from examples/language_bindings/community_supported/arduino_hello-world/Makefile rename to examples/lang_support/community/arduino_hello-world/Makefile diff --git a/examples/language_bindings/community_supported/arduino_hello-world/Makefile.ci b/examples/lang_support/community/arduino_hello-world/Makefile.ci similarity index 100% rename from examples/language_bindings/community_supported/arduino_hello-world/Makefile.ci rename to examples/lang_support/community/arduino_hello-world/Makefile.ci diff --git a/examples/language_bindings/community_supported/arduino_hello-world/README.md b/examples/lang_support/community/arduino_hello-world/README.md similarity index 100% rename from examples/language_bindings/community_supported/arduino_hello-world/README.md rename to examples/lang_support/community/arduino_hello-world/README.md diff --git a/examples/language_bindings/community_supported/arduino_hello-world/hello-world.sketch b/examples/lang_support/community/arduino_hello-world/hello-world.sketch similarity index 100% rename from examples/language_bindings/community_supported/arduino_hello-world/hello-world.sketch rename to examples/lang_support/community/arduino_hello-world/hello-world.sketch diff --git a/examples/language_bindings/community_supported/javascript/Makefile b/examples/lang_support/community/javascript/Makefile similarity index 100% rename from examples/language_bindings/community_supported/javascript/Makefile rename to examples/lang_support/community/javascript/Makefile diff --git a/examples/language_bindings/community_supported/javascript/Makefile.ci b/examples/lang_support/community/javascript/Makefile.ci similarity index 100% rename from examples/language_bindings/community_supported/javascript/Makefile.ci rename to examples/lang_support/community/javascript/Makefile.ci diff --git a/examples/language_bindings/community_supported/javascript/README.md b/examples/lang_support/community/javascript/README.md similarity index 100% rename from examples/language_bindings/community_supported/javascript/README.md rename to examples/lang_support/community/javascript/README.md diff --git a/examples/language_bindings/community_supported/javascript/main.c b/examples/lang_support/community/javascript/main.c similarity index 100% rename from examples/language_bindings/community_supported/javascript/main.c rename to examples/lang_support/community/javascript/main.c diff --git a/examples/language_bindings/community_supported/javascript/main.js b/examples/lang_support/community/javascript/main.js similarity index 100% rename from examples/language_bindings/community_supported/javascript/main.js rename to examples/lang_support/community/javascript/main.js diff --git a/examples/language_bindings/community_supported/lua_REPL/Makefile b/examples/lang_support/community/lua_REPL/Makefile similarity index 100% rename from examples/language_bindings/community_supported/lua_REPL/Makefile rename to examples/lang_support/community/lua_REPL/Makefile diff --git a/examples/language_bindings/community_supported/lua_REPL/Makefile.ci b/examples/lang_support/community/lua_REPL/Makefile.ci similarity index 100% rename from examples/language_bindings/community_supported/lua_REPL/Makefile.ci rename to examples/lang_support/community/lua_REPL/Makefile.ci diff --git a/examples/language_bindings/community_supported/lua_REPL/README.md b/examples/lang_support/community/lua_REPL/README.md similarity index 100% rename from examples/language_bindings/community_supported/lua_REPL/README.md rename to examples/lang_support/community/lua_REPL/README.md diff --git a/examples/language_bindings/community_supported/lua_REPL/main.c b/examples/lang_support/community/lua_REPL/main.c similarity index 100% rename from examples/language_bindings/community_supported/lua_REPL/main.c rename to examples/lang_support/community/lua_REPL/main.c diff --git a/examples/language_bindings/community_supported/lua_REPL/repl.lua b/examples/lang_support/community/lua_REPL/repl.lua similarity index 100% rename from examples/language_bindings/community_supported/lua_REPL/repl.lua rename to examples/lang_support/community/lua_REPL/repl.lua diff --git a/examples/language_bindings/community_supported/lua_basic/Makefile b/examples/lang_support/community/lua_basic/Makefile similarity index 100% rename from examples/language_bindings/community_supported/lua_basic/Makefile rename to examples/lang_support/community/lua_basic/Makefile diff --git a/examples/language_bindings/community_supported/lua_basic/Makefile.ci b/examples/lang_support/community/lua_basic/Makefile.ci similarity index 100% rename from examples/language_bindings/community_supported/lua_basic/Makefile.ci rename to examples/lang_support/community/lua_basic/Makefile.ci diff --git a/examples/language_bindings/community_supported/lua_basic/README.md b/examples/lang_support/community/lua_basic/README.md similarity index 100% rename from examples/language_bindings/community_supported/lua_basic/README.md rename to examples/lang_support/community/lua_basic/README.md diff --git a/examples/language_bindings/community_supported/lua_basic/main.c b/examples/lang_support/community/lua_basic/main.c similarity index 100% rename from examples/language_bindings/community_supported/lua_basic/main.c rename to examples/lang_support/community/lua_basic/main.c diff --git a/examples/language_bindings/community_supported/lua_basic/main.lua b/examples/lang_support/community/lua_basic/main.lua similarity index 100% rename from examples/language_bindings/community_supported/lua_basic/main.lua rename to examples/lang_support/community/lua_basic/main.lua diff --git a/examples/language_bindings/community_supported/micropython/Makefile b/examples/lang_support/community/micropython/Makefile similarity index 100% rename from examples/language_bindings/community_supported/micropython/Makefile rename to examples/lang_support/community/micropython/Makefile diff --git a/examples/language_bindings/community_supported/micropython/Makefile.ci b/examples/lang_support/community/micropython/Makefile.ci similarity index 100% rename from examples/language_bindings/community_supported/micropython/Makefile.ci rename to examples/lang_support/community/micropython/Makefile.ci diff --git a/examples/language_bindings/community_supported/micropython/README.md b/examples/lang_support/community/micropython/README.md similarity index 100% rename from examples/language_bindings/community_supported/micropython/README.md rename to examples/lang_support/community/micropython/README.md diff --git a/examples/language_bindings/community_supported/micropython/boot.py b/examples/lang_support/community/micropython/boot.py similarity index 100% rename from examples/language_bindings/community_supported/micropython/boot.py rename to examples/lang_support/community/micropython/boot.py diff --git a/examples/language_bindings/community_supported/micropython/main.c b/examples/lang_support/community/micropython/main.c similarity index 100% rename from examples/language_bindings/community_supported/micropython/main.c rename to examples/lang_support/community/micropython/main.c diff --git a/examples/language_bindings/community_supported/micropython/tests/01-run.py b/examples/lang_support/community/micropython/tests/01-run.py similarity index 100% rename from examples/language_bindings/community_supported/micropython/tests/01-run.py rename to examples/lang_support/community/micropython/tests/01-run.py diff --git a/examples/language_bindings/community_supported/wasm/.gitignore b/examples/lang_support/community/wasm/.gitignore similarity index 100% rename from examples/language_bindings/community_supported/wasm/.gitignore rename to examples/lang_support/community/wasm/.gitignore diff --git a/examples/language_bindings/community_supported/wasm/Makefile b/examples/lang_support/community/wasm/Makefile similarity index 100% rename from examples/language_bindings/community_supported/wasm/Makefile rename to examples/lang_support/community/wasm/Makefile diff --git a/examples/language_bindings/community_supported/wasm/Makefile.ci b/examples/lang_support/community/wasm/Makefile.ci similarity index 100% rename from examples/language_bindings/community_supported/wasm/Makefile.ci rename to examples/lang_support/community/wasm/Makefile.ci diff --git a/examples/language_bindings/community_supported/wasm/README.md b/examples/lang_support/community/wasm/README.md similarity index 100% rename from examples/language_bindings/community_supported/wasm/README.md rename to examples/lang_support/community/wasm/README.md diff --git a/examples/language_bindings/community_supported/wasm/config.cmake b/examples/lang_support/community/wasm/config.cmake similarity index 100% rename from examples/language_bindings/community_supported/wasm/config.cmake rename to examples/lang_support/community/wasm/config.cmake diff --git a/examples/language_bindings/community_supported/wasm/iwasmt.c b/examples/lang_support/community/wasm/iwasmt.c similarity index 100% rename from examples/language_bindings/community_supported/wasm/iwasmt.c rename to examples/lang_support/community/wasm/iwasmt.c diff --git a/examples/language_bindings/community_supported/wasm/test.wasm b/examples/lang_support/community/wasm/test.wasm similarity index 100% rename from examples/language_bindings/community_supported/wasm/test.wasm rename to examples/lang_support/community/wasm/test.wasm diff --git a/examples/language_bindings/community_supported/wasm/wasm-main.c b/examples/lang_support/community/wasm/wasm-main.c similarity index 100% rename from examples/language_bindings/community_supported/wasm/wasm-main.c rename to examples/lang_support/community/wasm/wasm-main.c diff --git a/examples/language_bindings/community_supported/wasm/wasm_sample/Makefile b/examples/lang_support/community/wasm/wasm_sample/Makefile similarity index 100% rename from examples/language_bindings/community_supported/wasm/wasm_sample/Makefile rename to examples/lang_support/community/wasm/wasm_sample/Makefile diff --git a/examples/language_bindings/community_supported/wasm/wasm_sample/hello.c b/examples/lang_support/community/wasm/wasm_sample/hello.c similarity index 100% rename from examples/language_bindings/community_supported/wasm/wasm_sample/hello.c rename to examples/lang_support/community/wasm/wasm_sample/hello.c diff --git a/examples/language_bindings/community_supported/wasm/wasm_sample/hello_prebuild.wasm b/examples/lang_support/community/wasm/wasm_sample/hello_prebuild.wasm similarity index 100% rename from examples/language_bindings/community_supported/wasm/wasm_sample/hello_prebuild.wasm rename to examples/lang_support/community/wasm/wasm_sample/hello_prebuild.wasm diff --git a/examples/language_bindings/officially_supported/riot_and_cpp/Makefile b/examples/lang_support/official/riot_and_cpp/Makefile similarity index 100% rename from examples/language_bindings/officially_supported/riot_and_cpp/Makefile rename to examples/lang_support/official/riot_and_cpp/Makefile diff --git a/examples/language_bindings/officially_supported/riot_and_cpp/Makefile.ci b/examples/lang_support/official/riot_and_cpp/Makefile.ci similarity index 100% rename from examples/language_bindings/officially_supported/riot_and_cpp/Makefile.ci rename to examples/lang_support/official/riot_and_cpp/Makefile.ci diff --git a/examples/language_bindings/officially_supported/riot_and_cpp/README.md b/examples/lang_support/official/riot_and_cpp/README.md similarity index 100% rename from examples/language_bindings/officially_supported/riot_and_cpp/README.md rename to examples/lang_support/official/riot_and_cpp/README.md diff --git a/examples/language_bindings/officially_supported/riot_and_cpp/c_functions.c b/examples/lang_support/official/riot_and_cpp/c_functions.c similarity index 100% rename from examples/language_bindings/officially_supported/riot_and_cpp/c_functions.c rename to examples/lang_support/official/riot_and_cpp/c_functions.c diff --git a/examples/language_bindings/officially_supported/riot_and_cpp/c_functions.h b/examples/lang_support/official/riot_and_cpp/c_functions.h similarity index 100% rename from examples/language_bindings/officially_supported/riot_and_cpp/c_functions.h rename to examples/lang_support/official/riot_and_cpp/c_functions.h diff --git a/examples/language_bindings/officially_supported/riot_and_cpp/cpp_class.cpp b/examples/lang_support/official/riot_and_cpp/cpp_class.cpp similarity index 100% rename from examples/language_bindings/officially_supported/riot_and_cpp/cpp_class.cpp rename to examples/lang_support/official/riot_and_cpp/cpp_class.cpp diff --git a/examples/language_bindings/officially_supported/riot_and_cpp/cpp_class.hpp b/examples/lang_support/official/riot_and_cpp/cpp_class.hpp similarity index 100% rename from examples/language_bindings/officially_supported/riot_and_cpp/cpp_class.hpp rename to examples/lang_support/official/riot_and_cpp/cpp_class.hpp diff --git a/examples/language_bindings/officially_supported/riot_and_cpp/main.cpp b/examples/lang_support/official/riot_and_cpp/main.cpp similarity index 100% rename from examples/language_bindings/officially_supported/riot_and_cpp/main.cpp rename to examples/lang_support/official/riot_and_cpp/main.cpp diff --git a/examples/language_bindings/officially_supported/rust-async/Cargo.lock b/examples/lang_support/official/rust-async/Cargo.lock similarity index 100% rename from examples/language_bindings/officially_supported/rust-async/Cargo.lock rename to examples/lang_support/official/rust-async/Cargo.lock diff --git a/examples/language_bindings/officially_supported/rust-async/Cargo.toml b/examples/lang_support/official/rust-async/Cargo.toml similarity index 100% rename from examples/language_bindings/officially_supported/rust-async/Cargo.toml rename to examples/lang_support/official/rust-async/Cargo.toml diff --git a/examples/language_bindings/officially_supported/rust-async/Makefile b/examples/lang_support/official/rust-async/Makefile similarity index 100% rename from examples/language_bindings/officially_supported/rust-async/Makefile rename to examples/lang_support/official/rust-async/Makefile diff --git a/examples/language_bindings/officially_supported/rust-async/Makefile.ci b/examples/lang_support/official/rust-async/Makefile.ci similarity index 100% rename from examples/language_bindings/officially_supported/rust-async/Makefile.ci rename to examples/lang_support/official/rust-async/Makefile.ci diff --git a/examples/language_bindings/officially_supported/rust-async/README.md b/examples/lang_support/official/rust-async/README.md similarity index 100% rename from examples/language_bindings/officially_supported/rust-async/README.md rename to examples/lang_support/official/rust-async/README.md diff --git a/examples/language_bindings/officially_supported/rust-async/src/lib.rs b/examples/lang_support/official/rust-async/src/lib.rs similarity index 100% rename from examples/language_bindings/officially_supported/rust-async/src/lib.rs rename to examples/lang_support/official/rust-async/src/lib.rs diff --git a/examples/language_bindings/officially_supported/rust-gcoap/Cargo.lock b/examples/lang_support/official/rust-gcoap/Cargo.lock similarity index 100% rename from examples/language_bindings/officially_supported/rust-gcoap/Cargo.lock rename to examples/lang_support/official/rust-gcoap/Cargo.lock diff --git a/examples/language_bindings/officially_supported/rust-gcoap/Cargo.toml b/examples/lang_support/official/rust-gcoap/Cargo.toml similarity index 100% rename from examples/language_bindings/officially_supported/rust-gcoap/Cargo.toml rename to examples/lang_support/official/rust-gcoap/Cargo.toml diff --git a/examples/language_bindings/officially_supported/rust-gcoap/Makefile b/examples/lang_support/official/rust-gcoap/Makefile similarity index 100% rename from examples/language_bindings/officially_supported/rust-gcoap/Makefile rename to examples/lang_support/official/rust-gcoap/Makefile diff --git a/examples/language_bindings/officially_supported/rust-gcoap/Makefile.ci b/examples/lang_support/official/rust-gcoap/Makefile.ci similarity index 100% rename from examples/language_bindings/officially_supported/rust-gcoap/Makefile.ci rename to examples/lang_support/official/rust-gcoap/Makefile.ci diff --git a/examples/language_bindings/officially_supported/rust-gcoap/README.md b/examples/lang_support/official/rust-gcoap/README.md similarity index 100% rename from examples/language_bindings/officially_supported/rust-gcoap/README.md rename to examples/lang_support/official/rust-gcoap/README.md diff --git a/examples/language_bindings/officially_supported/rust-gcoap/src/lib.rs b/examples/lang_support/official/rust-gcoap/src/lib.rs similarity index 100% rename from examples/language_bindings/officially_supported/rust-gcoap/src/lib.rs rename to examples/lang_support/official/rust-gcoap/src/lib.rs diff --git a/examples/language_bindings/officially_supported/rust-gcoap/vfs.c b/examples/lang_support/official/rust-gcoap/vfs.c similarity index 100% rename from examples/language_bindings/officially_supported/rust-gcoap/vfs.c rename to examples/lang_support/official/rust-gcoap/vfs.c diff --git a/examples/language_bindings/officially_supported/rust-hello-world/Cargo.lock b/examples/lang_support/official/rust-hello-world/Cargo.lock similarity index 100% rename from examples/language_bindings/officially_supported/rust-hello-world/Cargo.lock rename to examples/lang_support/official/rust-hello-world/Cargo.lock diff --git a/examples/language_bindings/officially_supported/rust-hello-world/Cargo.toml b/examples/lang_support/official/rust-hello-world/Cargo.toml similarity index 100% rename from examples/language_bindings/officially_supported/rust-hello-world/Cargo.toml rename to examples/lang_support/official/rust-hello-world/Cargo.toml diff --git a/examples/language_bindings/officially_supported/rust-hello-world/Makefile b/examples/lang_support/official/rust-hello-world/Makefile similarity index 100% rename from examples/language_bindings/officially_supported/rust-hello-world/Makefile rename to examples/lang_support/official/rust-hello-world/Makefile diff --git a/examples/language_bindings/officially_supported/rust-hello-world/README.md b/examples/lang_support/official/rust-hello-world/README.md similarity index 100% rename from examples/language_bindings/officially_supported/rust-hello-world/README.md rename to examples/lang_support/official/rust-hello-world/README.md diff --git a/examples/language_bindings/officially_supported/rust-hello-world/src/lib.rs b/examples/lang_support/official/rust-hello-world/src/lib.rs similarity index 100% rename from examples/language_bindings/officially_supported/rust-hello-world/src/lib.rs rename to examples/lang_support/official/rust-hello-world/src/lib.rs diff --git a/examples/networking/bluetooth_low_energy/misc_ble_examples/skald_eddystone/Makefile b/examples/networking/ble/misc/skald_eddystone/Makefile similarity index 100% rename from examples/networking/bluetooth_low_energy/misc_ble_examples/skald_eddystone/Makefile rename to examples/networking/ble/misc/skald_eddystone/Makefile diff --git a/examples/networking/bluetooth_low_energy/misc_ble_examples/skald_eddystone/README.md b/examples/networking/ble/misc/skald_eddystone/README.md similarity index 100% rename from examples/networking/bluetooth_low_energy/misc_ble_examples/skald_eddystone/README.md rename to examples/networking/ble/misc/skald_eddystone/README.md diff --git a/examples/networking/bluetooth_low_energy/misc_ble_examples/skald_eddystone/main.c b/examples/networking/ble/misc/skald_eddystone/main.c similarity index 100% rename from examples/networking/bluetooth_low_energy/misc_ble_examples/skald_eddystone/main.c rename to examples/networking/ble/misc/skald_eddystone/main.c diff --git a/examples/networking/bluetooth_low_energy/misc_ble_examples/skald_ibeacon/Makefile b/examples/networking/ble/misc/skald_ibeacon/Makefile similarity index 100% rename from examples/networking/bluetooth_low_energy/misc_ble_examples/skald_ibeacon/Makefile rename to examples/networking/ble/misc/skald_ibeacon/Makefile diff --git a/examples/networking/bluetooth_low_energy/misc_ble_examples/skald_ibeacon/README.md b/examples/networking/ble/misc/skald_ibeacon/README.md similarity index 100% rename from examples/networking/bluetooth_low_energy/misc_ble_examples/skald_ibeacon/README.md rename to examples/networking/ble/misc/skald_ibeacon/README.md diff --git a/examples/networking/bluetooth_low_energy/misc_ble_examples/skald_ibeacon/main.c b/examples/networking/ble/misc/skald_ibeacon/main.c similarity index 100% rename from examples/networking/bluetooth_low_energy/misc_ble_examples/skald_ibeacon/main.c rename to examples/networking/ble/misc/skald_ibeacon/main.c diff --git a/examples/networking/bluetooth_low_energy/nimble/nimble_gatt/Makefile b/examples/networking/ble/nimble/nimble_gatt/Makefile similarity index 100% rename from examples/networking/bluetooth_low_energy/nimble/nimble_gatt/Makefile rename to examples/networking/ble/nimble/nimble_gatt/Makefile diff --git a/examples/networking/bluetooth_low_energy/nimble/nimble_gatt/README.md b/examples/networking/ble/nimble/nimble_gatt/README.md similarity index 100% rename from examples/networking/bluetooth_low_energy/nimble/nimble_gatt/README.md rename to examples/networking/ble/nimble/nimble_gatt/README.md diff --git a/examples/networking/bluetooth_low_energy/nimble/nimble_gatt/main.c b/examples/networking/ble/nimble/nimble_gatt/main.c similarity index 100% rename from examples/networking/bluetooth_low_energy/nimble/nimble_gatt/main.c rename to examples/networking/ble/nimble/nimble_gatt/main.c diff --git a/examples/networking/bluetooth_low_energy/nimble/nimble_heart_rate_sensor/Makefile b/examples/networking/ble/nimble/nimble_heart_rate_sensor/Makefile similarity index 100% rename from examples/networking/bluetooth_low_energy/nimble/nimble_heart_rate_sensor/Makefile rename to examples/networking/ble/nimble/nimble_heart_rate_sensor/Makefile diff --git a/examples/networking/bluetooth_low_energy/nimble/nimble_heart_rate_sensor/README.md b/examples/networking/ble/nimble/nimble_heart_rate_sensor/README.md similarity index 100% rename from examples/networking/bluetooth_low_energy/nimble/nimble_heart_rate_sensor/README.md rename to examples/networking/ble/nimble/nimble_heart_rate_sensor/README.md diff --git a/examples/networking/bluetooth_low_energy/nimble/nimble_heart_rate_sensor/main.c b/examples/networking/ble/nimble/nimble_heart_rate_sensor/main.c similarity index 100% rename from examples/networking/bluetooth_low_energy/nimble/nimble_heart_rate_sensor/main.c rename to examples/networking/ble/nimble/nimble_heart_rate_sensor/main.c diff --git a/examples/networking/bluetooth_low_energy/nimble/nimble_scanner/Makefile b/examples/networking/ble/nimble/nimble_scanner/Makefile similarity index 100% rename from examples/networking/bluetooth_low_energy/nimble/nimble_scanner/Makefile rename to examples/networking/ble/nimble/nimble_scanner/Makefile diff --git a/examples/networking/bluetooth_low_energy/nimble/nimble_scanner/README.md b/examples/networking/ble/nimble/nimble_scanner/README.md similarity index 100% rename from examples/networking/bluetooth_low_energy/nimble/nimble_scanner/README.md rename to examples/networking/ble/nimble/nimble_scanner/README.md diff --git a/examples/networking/bluetooth_low_energy/nimble/nimble_scanner/main.c b/examples/networking/ble/nimble/nimble_scanner/main.c similarity index 100% rename from examples/networking/bluetooth_low_energy/nimble/nimble_scanner/main.c rename to examples/networking/ble/nimble/nimble_scanner/main.c diff --git a/examples/networking/coap/gcoap/README.md b/examples/networking/coap/gcoap/README.md index 4955037a5bc0..a00339d96f0e 100644 --- a/examples/networking/coap/gcoap/README.md +++ b/examples/networking/coap/gcoap/README.md @@ -93,5 +93,5 @@ implementations: [1]: https://tools.ietf.org/html/rfc7252 "CoAP spec" -[2]: https://github.com/RIOT-OS/RIOT/tree/master/examples/networking/gnrc_networking "instructions" -[3]: https://github.com/RIOT-OS/RIOT/tree/master/examples/networking/gnrc_borader_router "SLIP instructions" +[2]: https://github.com/RIOT-OS/RIOT/tree/master/examples/networking/gnrc/gnrc_networking "instructions" +[3]: https://github.com/RIOT-OS/RIOT/tree/master/examples/networking/gnrc/gnrc_border_router "SLIP instructions" diff --git a/examples/networking/core_resource_directory/cord_ep/Makefile b/examples/networking/cord/cord_ep/Makefile similarity index 100% rename from examples/networking/core_resource_directory/cord_ep/Makefile rename to examples/networking/cord/cord_ep/Makefile diff --git a/examples/networking/core_resource_directory/cord_ep/Makefile.ci b/examples/networking/cord/cord_ep/Makefile.ci similarity index 100% rename from examples/networking/core_resource_directory/cord_ep/Makefile.ci rename to examples/networking/cord/cord_ep/Makefile.ci diff --git a/examples/networking/core_resource_directory/cord_ep/README.md b/examples/networking/cord/cord_ep/README.md similarity index 100% rename from examples/networking/core_resource_directory/cord_ep/README.md rename to examples/networking/cord/cord_ep/README.md diff --git a/examples/networking/core_resource_directory/cord_ep/main.c b/examples/networking/cord/cord_ep/main.c similarity index 100% rename from examples/networking/core_resource_directory/cord_ep/main.c rename to examples/networking/cord/cord_ep/main.c diff --git a/examples/networking/core_resource_directory/cord_epsim/Makefile b/examples/networking/cord/cord_epsim/Makefile similarity index 100% rename from examples/networking/core_resource_directory/cord_epsim/Makefile rename to examples/networking/cord/cord_epsim/Makefile diff --git a/examples/networking/core_resource_directory/cord_epsim/Makefile.ci b/examples/networking/cord/cord_epsim/Makefile.ci similarity index 100% rename from examples/networking/core_resource_directory/cord_epsim/Makefile.ci rename to examples/networking/cord/cord_epsim/Makefile.ci diff --git a/examples/networking/core_resource_directory/cord_epsim/README.md b/examples/networking/cord/cord_epsim/README.md similarity index 100% rename from examples/networking/core_resource_directory/cord_epsim/README.md rename to examples/networking/cord/cord_epsim/README.md diff --git a/examples/networking/core_resource_directory/cord_epsim/main.c b/examples/networking/cord/cord_epsim/main.c similarity index 100% rename from examples/networking/core_resource_directory/cord_epsim/main.c rename to examples/networking/cord/cord_epsim/main.c diff --git a/examples/networking/core_resource_directory/cord_lc/Makefile b/examples/networking/cord/cord_lc/Makefile similarity index 100% rename from examples/networking/core_resource_directory/cord_lc/Makefile rename to examples/networking/cord/cord_lc/Makefile diff --git a/examples/networking/core_resource_directory/cord_lc/Makefile.ci b/examples/networking/cord/cord_lc/Makefile.ci similarity index 100% rename from examples/networking/core_resource_directory/cord_lc/Makefile.ci rename to examples/networking/cord/cord_lc/Makefile.ci diff --git a/examples/networking/core_resource_directory/cord_lc/README.md b/examples/networking/cord/cord_lc/README.md similarity index 100% rename from examples/networking/core_resource_directory/cord_lc/README.md rename to examples/networking/cord/cord_lc/README.md diff --git a/examples/networking/core_resource_directory/cord_lc/cord_lc_cli.c b/examples/networking/cord/cord_lc/cord_lc_cli.c similarity index 100% rename from examples/networking/core_resource_directory/cord_lc/cord_lc_cli.c rename to examples/networking/cord/cord_lc/cord_lc_cli.c diff --git a/examples/networking/core_resource_directory/cord_lc/main.c b/examples/networking/cord/cord_lc/main.c similarity index 100% rename from examples/networking/core_resource_directory/cord_lc/main.c rename to examples/networking/cord/cord_lc/main.c diff --git a/examples/networking/gnrc_networking/gnrc_border_router/Kconfig b/examples/networking/gnrc/gnrc_border_router/Kconfig similarity index 100% rename from examples/networking/gnrc_networking/gnrc_border_router/Kconfig rename to examples/networking/gnrc/gnrc_border_router/Kconfig diff --git a/examples/networking/gnrc_networking/gnrc_border_router/Makefile b/examples/networking/gnrc/gnrc_border_router/Makefile similarity index 100% rename from examples/networking/gnrc_networking/gnrc_border_router/Makefile rename to examples/networking/gnrc/gnrc_border_router/Makefile diff --git a/examples/networking/gnrc_networking/gnrc_border_router/Makefile.board.dep b/examples/networking/gnrc/gnrc_border_router/Makefile.board.dep similarity index 100% rename from examples/networking/gnrc_networking/gnrc_border_router/Makefile.board.dep rename to examples/networking/gnrc/gnrc_border_router/Makefile.board.dep diff --git a/examples/networking/gnrc_networking/gnrc_border_router/Makefile.cdc-ecm.conf b/examples/networking/gnrc/gnrc_border_router/Makefile.cdc-ecm.conf similarity index 100% rename from examples/networking/gnrc_networking/gnrc_border_router/Makefile.cdc-ecm.conf rename to examples/networking/gnrc/gnrc_border_router/Makefile.cdc-ecm.conf diff --git a/examples/networking/gnrc_networking/gnrc_border_router/Makefile.ci b/examples/networking/gnrc/gnrc_border_router/Makefile.ci similarity index 100% rename from examples/networking/gnrc_networking/gnrc_border_router/Makefile.ci rename to examples/networking/gnrc/gnrc_border_router/Makefile.ci diff --git a/examples/networking/gnrc_networking/gnrc_border_router/Makefile.ethos.conf b/examples/networking/gnrc/gnrc_border_router/Makefile.ethos.conf similarity index 100% rename from examples/networking/gnrc_networking/gnrc_border_router/Makefile.ethos.conf rename to examples/networking/gnrc/gnrc_border_router/Makefile.ethos.conf diff --git a/examples/networking/gnrc_networking/gnrc_border_router/Makefile.native.conf b/examples/networking/gnrc/gnrc_border_router/Makefile.native.conf similarity index 100% rename from examples/networking/gnrc_networking/gnrc_border_router/Makefile.native.conf rename to examples/networking/gnrc/gnrc_border_router/Makefile.native.conf diff --git a/examples/networking/gnrc_networking/gnrc_border_router/Makefile.slip.conf b/examples/networking/gnrc/gnrc_border_router/Makefile.slip.conf similarity index 100% rename from examples/networking/gnrc_networking/gnrc_border_router/Makefile.slip.conf rename to examples/networking/gnrc/gnrc_border_router/Makefile.slip.conf diff --git a/examples/networking/gnrc_networking/gnrc_border_router/Makefile.wifi.conf b/examples/networking/gnrc/gnrc_border_router/Makefile.wifi.conf similarity index 100% rename from examples/networking/gnrc_networking/gnrc_border_router/Makefile.wifi.conf rename to examples/networking/gnrc/gnrc_border_router/Makefile.wifi.conf diff --git a/examples/networking/gnrc_networking/gnrc_border_router/README.md b/examples/networking/gnrc/gnrc_border_router/README.md similarity index 99% rename from examples/networking/gnrc_networking/gnrc_border_router/README.md rename to examples/networking/gnrc/gnrc_border_router/README.md index 557e85356208..062780c09156 100644 --- a/examples/networking/gnrc_networking/gnrc_border_router/README.md +++ b/examples/networking/gnrc/gnrc_border_router/README.md @@ -123,7 +123,7 @@ This is done through the same serial interface. By typing `help` you will get the list of available shell commands. At this point you should be able to ping motes using their global address. -For instance, if you use the [`gnrc_networking`](https://github.com/RIOT-OS/RIOT/tree/master/examples/networking/gnrc_networking) example on the mote, you can +For instance, if you use the [`gnrc_networking`](https://github.com/RIOT-OS/RIOT/tree/master/examples/networking/gnrc/gnrc_networking) example on the mote, you can ping it from your machine with: ``` diff --git a/examples/networking/gnrc_networking/gnrc_border_router/main.c b/examples/networking/gnrc/gnrc_border_router/main.c similarity index 100% rename from examples/networking/gnrc_networking/gnrc_border_router/main.c rename to examples/networking/gnrc/gnrc_border_router/main.c diff --git a/examples/networking/gnrc_networking/gnrc_lorawan/Makefile b/examples/networking/gnrc/gnrc_lorawan/Makefile similarity index 100% rename from examples/networking/gnrc_networking/gnrc_lorawan/Makefile rename to examples/networking/gnrc/gnrc_lorawan/Makefile diff --git a/examples/networking/gnrc_networking/gnrc_lorawan/Makefile.ci b/examples/networking/gnrc/gnrc_lorawan/Makefile.ci similarity index 100% rename from examples/networking/gnrc_networking/gnrc_lorawan/Makefile.ci rename to examples/networking/gnrc/gnrc_lorawan/Makefile.ci diff --git a/examples/networking/gnrc_networking/gnrc_lorawan/README.md b/examples/networking/gnrc/gnrc_lorawan/README.md similarity index 100% rename from examples/networking/gnrc_networking/gnrc_lorawan/README.md rename to examples/networking/gnrc/gnrc_lorawan/README.md diff --git a/examples/networking/gnrc_networking/gnrc_lorawan/main.c b/examples/networking/gnrc/gnrc_lorawan/main.c similarity index 100% rename from examples/networking/gnrc_networking/gnrc_lorawan/main.c rename to examples/networking/gnrc/gnrc_lorawan/main.c diff --git a/examples/networking/gnrc_networking/gnrc_minimal/Makefile b/examples/networking/gnrc/gnrc_minimal/Makefile similarity index 100% rename from examples/networking/gnrc_networking/gnrc_minimal/Makefile rename to examples/networking/gnrc/gnrc_minimal/Makefile diff --git a/examples/networking/gnrc_networking/gnrc_minimal/Makefile.ci b/examples/networking/gnrc/gnrc_minimal/Makefile.ci similarity index 100% rename from examples/networking/gnrc_networking/gnrc_minimal/Makefile.ci rename to examples/networking/gnrc/gnrc_minimal/Makefile.ci diff --git a/examples/networking/gnrc_networking/gnrc_minimal/Makefile.gnu.dep b/examples/networking/gnrc/gnrc_minimal/Makefile.gnu.dep similarity index 100% rename from examples/networking/gnrc_networking/gnrc_minimal/Makefile.gnu.dep rename to examples/networking/gnrc/gnrc_minimal/Makefile.gnu.dep diff --git a/examples/networking/gnrc_networking/gnrc_minimal/README.md b/examples/networking/gnrc/gnrc_minimal/README.md similarity index 100% rename from examples/networking/gnrc_networking/gnrc_minimal/README.md rename to examples/networking/gnrc/gnrc_minimal/README.md diff --git a/examples/networking/gnrc_networking/gnrc_minimal/main.c b/examples/networking/gnrc/gnrc_minimal/main.c similarity index 100% rename from examples/networking/gnrc_networking/gnrc_minimal/main.c rename to examples/networking/gnrc/gnrc_minimal/main.c diff --git a/examples/networking/gnrc_networking/gnrc_networking/Makefile b/examples/networking/gnrc/gnrc_networking/Makefile similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking/Makefile rename to examples/networking/gnrc/gnrc_networking/Makefile diff --git a/examples/networking/gnrc_networking/gnrc_networking/Makefile.ci b/examples/networking/gnrc/gnrc_networking/Makefile.ci similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking/Makefile.ci rename to examples/networking/gnrc/gnrc_networking/Makefile.ci diff --git a/examples/networking/gnrc_networking/gnrc_networking/README.md b/examples/networking/gnrc/gnrc_networking/README.md similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking/README.md rename to examples/networking/gnrc/gnrc_networking/README.md diff --git a/examples/networking/gnrc_networking/gnrc_networking/main.c b/examples/networking/gnrc/gnrc_networking/main.c similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking/main.c rename to examples/networking/gnrc/gnrc_networking/main.c diff --git a/examples/networking/gnrc_networking/gnrc_networking_mac/Makefile b/examples/networking/gnrc/gnrc_networking_mac/Makefile similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking_mac/Makefile rename to examples/networking/gnrc/gnrc_networking_mac/Makefile diff --git a/examples/networking/gnrc_networking/gnrc_networking_mac/README.md b/examples/networking/gnrc/gnrc_networking_mac/README.md similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking_mac/README.md rename to examples/networking/gnrc/gnrc_networking_mac/README.md diff --git a/examples/networking/gnrc_networking/gnrc_networking_mac/mac.c b/examples/networking/gnrc/gnrc_networking_mac/mac.c similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking_mac/mac.c rename to examples/networking/gnrc/gnrc_networking_mac/mac.c diff --git a/examples/networking/gnrc_networking/gnrc_networking_mac/main.c b/examples/networking/gnrc/gnrc_networking_mac/main.c similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking_mac/main.c rename to examples/networking/gnrc/gnrc_networking_mac/main.c diff --git a/examples/networking/gnrc_networking/gnrc_networking_mac/udp.c b/examples/networking/gnrc/gnrc_networking_mac/udp.c similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking_mac/udp.c rename to examples/networking/gnrc/gnrc_networking_mac/udp.c diff --git a/examples/networking/gnrc_networking/gnrc_networking_subnets/Makefile b/examples/networking/gnrc/gnrc_networking_subnets/Makefile similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking_subnets/Makefile rename to examples/networking/gnrc/gnrc_networking_subnets/Makefile diff --git a/examples/networking/gnrc_networking/gnrc_networking_subnets/Makefile.ci b/examples/networking/gnrc/gnrc_networking_subnets/Makefile.ci similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking_subnets/Makefile.ci rename to examples/networking/gnrc/gnrc_networking_subnets/Makefile.ci diff --git a/examples/networking/gnrc_networking/gnrc_networking_subnets/README.md b/examples/networking/gnrc/gnrc_networking_subnets/README.md similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking_subnets/README.md rename to examples/networking/gnrc/gnrc_networking_subnets/README.md diff --git a/examples/networking/gnrc_networking/gnrc_networking_subnets/main.c b/examples/networking/gnrc/gnrc_networking_subnets/main.c similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking_subnets/main.c rename to examples/networking/gnrc/gnrc_networking_subnets/main.c diff --git a/examples/networking/gnrc_networking/gnrc_networking_subnets/setup_taps.sh b/examples/networking/gnrc/gnrc_networking_subnets/setup_taps.sh similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking_subnets/setup_taps.sh rename to examples/networking/gnrc/gnrc_networking_subnets/setup_taps.sh diff --git a/examples/networking/gnrc_networking/gnrc_networking_subnets/tapology.txt b/examples/networking/gnrc/gnrc_networking_subnets/tapology.txt similarity index 100% rename from examples/networking/gnrc_networking/gnrc_networking_subnets/tapology.txt rename to examples/networking/gnrc/gnrc_networking_subnets/tapology.txt diff --git a/makefiles/app_dirs.blacklist b/makefiles/app_dirs.blacklist index 08ef93449ceb..ff3e1055e12a 100644 --- a/makefiles/app_dirs.blacklist +++ b/makefiles/app_dirs.blacklist @@ -1,7 +1,7 @@ -examples/advanced_examples/bindist/ -examples/advanced_examples/pio_blink/ -examples/essentials/subfolders/ -examples/language_bindings/community_supported/wasm/ +examples/advanced/bindist/ +examples/advanced/pio_blink/ +examples/basic/subfolders/ +examples/lang_support/community/wasm/ tests/build_system/blob/ tests/build_system/cpp_exclude/external_modules/ tests/build_system/cpp_ext/external_modules/ diff --git a/makefiles/arch/native.inc.mk b/makefiles/arch/native.inc.mk index 364ef254589a..bb1ef3a88dab 100644 --- a/makefiles/arch/native.inc.mk +++ b/makefiles/arch/native.inc.mk @@ -72,7 +72,7 @@ LINKFLAGS += -T$(RIOTBASE)/cpu/native/ldscripts/xfa.ld # fix this warning: # ``` -# /usr/bin/ld: examples/essentials/hello-world/bin/native/cpu/tramp.o: warning: relocation against `_native_saved_eip' in read-only section `.text' +# /usr/bin/ld: examples/basic/hello-world/bin/native/cpu/tramp.o: warning: relocation against `_native_saved_eip' in read-only section `.text' # /usr/bin/ld: warning: creating DT_TEXTREL in a PIE # ``` LINKFLAGS += -no-pie diff --git a/makefiles/tests/boards_supported/README.md b/makefiles/tests/boards_supported/README.md index 4a583d870161..5d493dd9a5a0 100644 --- a/makefiles/tests/boards_supported/README.md +++ b/makefiles/tests/boards_supported/README.md @@ -9,7 +9,7 @@ especially true since this list is used by the CI to check which boards to build Right now, only a single test case is added: It will run the logic behind `make info-boards-supported` without any modules used other than the default modules and subtracts the result from the list of all available boards. The resulting difference is the set of boards -which will never be build by the CI - not even for `examples/essentials/hello-world`. If this result is empty, +which will never be build by the CI - not even for `examples/basic/hello-world`. If this result is empty, the test succeeds. Otherwise the list of never build boards will be printed and the test fails. It is intended that some more advanced unit tests will be added later on. diff --git a/pkg/cryptoauthlib/doc.txt b/pkg/cryptoauthlib/doc.txt index 161275c4ae50..86015c840d36 100644 --- a/pkg/cryptoauthlib/doc.txt +++ b/pkg/cryptoauthlib/doc.txt @@ -28,7 +28,7 @@ * config zone, to lock the config zone (this will lock the config zone permanently * and cannot be undone) and to check whether config and data zone are locked. * The shell handler is enabled, if cryptoauthlib is included as a package in the - * Makefile of an application that also includes the shell (e.g. examples/essentials/default). + * Makefile of an application that also includes the shell (e.g. examples/basic/default). * * ### No poll mode * @@ -84,7 +84,7 @@ * * If you want to use more than one device, the best way is to create a file called * `custom_atca_params.h` in your application folder (you can see an example of this in - * `examples/advanced_examples/psa_crypto`). + * `examples/advanced/psa_crypto`). * * In your custom file you can now add a second device to `ATCA_PARAMS`: * @code @@ -232,7 +232,7 @@ * { ATCA_SLOTS_DEVX } * @endcode * - * A usage example for this can be found in `examples/advanced_examples/psa_crypto`. + * A usage example for this can be found in `examples/advanced/psa_crypto`. * * ## Troubleshooting * diff --git a/pkg/micropython/doc.txt b/pkg/micropython/doc.txt index 13e092a015d4..456b981bc3c8 100644 --- a/pkg/micropython/doc.txt +++ b/pkg/micropython/doc.txt @@ -27,7 +27,7 @@ * * Example on the command line: * ``` - * MP_RIOT_HEAPSIZE=2048 make -C examples/language_bindings/community_supported/micropython + * MP_RIOT_HEAPSIZE=2048 make -C examples/lang_support/community/micropython * ``` * * ## Implementation details @@ -45,8 +45,8 @@ * * Steps: * - * 1. make -Cexamples/language_bindings/community_supported/micropython flash - * 2. cd examples/language_bindings/community_supported/micropython/bin/pkg/${BOARD}/micropython + * 1. make -C examples/lang_support/community/micropython flash + * 2. cd examples/lang_support/community/micropython/bin/pkg/${BOARD}/micropython * 3. git apply ports/riot/slow_uart_writes.patch * 4. cd tests * 5. ./run-tests --target pyboard --device ${PORT} @@ -82,6 +82,6 @@ * * ## How to use * - * See examples/language_bindings/community_supported/micropython for example code. + * See examples/lang_support/community/micropython for example code. * */ diff --git a/pkg/nimble/README.ipv6-over-ble.md b/pkg/nimble/README.ipv6-over-ble.md index a55383b95e31..ddfe0a55832c 100644 --- a/pkg/nimble/README.ipv6-over-ble.md +++ b/pkg/nimble/README.ipv6-over-ble.md @@ -25,7 +25,7 @@ following: ## Preparing the RIOT node -First, you compile and flash the `examples/networking/gnrc_networking/gnrc_networking` application to your +First, you compile and flash the `examples/networking/gnrc/gnrc_networking` application to your RIOT device. When doing this, make sure to enable SLAAC (`CFLAGS=-DCONFIG_GNRC_IPV6_NIB_SLAAC=1`), see note above. diff --git a/pkg/uwb-core/doc.txt b/pkg/uwb-core/doc.txt index 4281b483be79..ef2a26b5ecb3 100644 --- a/pkg/uwb-core/doc.txt +++ b/pkg/uwb-core/doc.txt @@ -35,7 +35,7 @@ this in RIOT when using this pkg an event thread is started which will run as this default event thread. To work this library needs to be built on top of an UWB device -implementing the `uwb` api (see [uwb](https://github.com/Decawave/uwb-core/tree/master/hw/drivers/uwb). +implementing the `uwb` api (see [uwb](https://github.com/Decawave/uwb-core/tree/master/hw/drivers/uwb)). This port uses [uwb-dw1000](https://github.com/Decawave/uwb-dw1000) as device driver for dw1000 modules. @@ -90,7 +90,7 @@ is considered awake. The following can be wrapped into a timer callback to setup a blinking tag. For more examples check the [uwb-apps](https://github.com/Decawave/uwb-apps) -repository as well as [examples/advanced_examples/twr_aloha](https://github.com/RIOT-OS/RIOT/tree/master/examples/twr-aloha) +repository as well as [examples/advanced/twr_aloha](https://github.com/RIOT-OS/RIOT/tree/master/examples/advanced/twr-aloha) ## Watchout! diff --git a/pkg/wamr/doc.txt b/pkg/wamr/doc.txt index 9d2669e55bb1..15f4ed34687f 100644 --- a/pkg/wamr/doc.txt +++ b/pkg/wamr/doc.txt @@ -30,7 +30,7 @@ * * WASM files can be linked to use just a part of the first page. * In this case the VM can be run with less ram. - * (see `wasm_sample/Makefile` in `examples/language_bindings/community_supported/wasm` for linker options to help with this) + * (see `wasm_sample/Makefile` in `examples/lang_support/community/wasm` for linker options to help with this) * While running the example configured with 8KiB Heap and 8KiB Stack, * ~24KiB of System Heap are used. * The thread, the WAMR interpreter (iwasm) is executed in, @@ -40,7 +40,7 @@ * ## building wasm-bytecode * * `clang` and `wasm-ld` of the *same version* must be used - * The Makefile in `examples/language_bindings/community_supported/wasm/wasm_sample/Makefile` will try to guess + * The Makefile in `examples/lang_support/community/wasm/wasm_sample/Makefile` will try to guess * a matching clang, wasm-ld pair, if they do not match linking will fail. * * ## Configuration @@ -55,7 +55,7 @@ * WAMR should be used using the functions provided by the WAMR project their API-headers * they can be found in `/build/pkg/wamr/core/iwasm/include/`. * pkg/wamr adds no RIOT specific API to that. - * For simple usages like in the example `iwasm.c` in `examples/language_bindings/community_supported/wasm` might be useful and + * For simple usages like in the example `iwasm.c` in `examples/lang_support/community/wasm` might be useful and * if used should be copied and adapt to the application need. * * While WebAssembly does not define a set native functions. WAMR provides its own builtin-libc. diff --git a/sys/include/auto_init.h b/sys/include/auto_init.h index c2a4ee238aa1..71c7746e2bba 100644 --- a/sys/include/auto_init.h +++ b/sys/include/auto_init.h @@ -44,7 +44,7 @@ * - by passing them via the `CFLAGS` variable on the build command line: * * ``` - * CFLAGS=-DBMP180_PARAM_OVERSAMPLING=1 USEMODULE=bmp180 make BOARD=arduino-zero -C examples/essentials/default + * CFLAGS=-DBMP180_PARAM_OVERSAMPLING=1 USEMODULE=bmp180 make BOARD=arduino-zero -C examples/basic/default * ``` * * - by setting the `CFLAGS` variable in the application `Makefile`: diff --git a/sys/include/stdio_nimble.h b/sys/include/stdio_nimble.h index e4c64a2644cb..0cbf7a499839 100644 --- a/sys/include/stdio_nimble.h +++ b/sys/include/stdio_nimble.h @@ -10,7 +10,7 @@ * @defgroup sys_stdio_nimble STDIO over NimBLE * @ingroup sys_stdio * - * @experimental This feature is experimental as some use-cases, such as examples/advanced_examples/twr_aloha, show + * @experimental This feature is experimental as some use-cases, such as examples/advanced/twr_aloha, show * unexpected behaviour. * * @brief Standard input/output backend using NimBLE. diff --git a/sys/psa_crypto/doc.txt b/sys/psa_crypto/doc.txt index 60d783a65ce2..518501ceede9 100644 --- a/sys/psa_crypto/doc.txt +++ b/sys/psa_crypto/doc.txt @@ -24,7 +24,7 @@ * without exposing them to applications. To learn how to use keys with PSA, * read [Using Keys](#using-keys). * - * A basic usage and configuration example can be found in `examples/advanced_examples/psa_crypto`. + * A basic usage and configuration example can be found in `examples/advanced/psa_crypto`. * For more usage instructions, please read the documentation. * * If you want to add your own crypto backend, see [Porting Guide](#porting-guide). @@ -143,7 +143,7 @@ * Configuration {#configuration} * === * Currently there are two ways to configure PSA Crypto: Kconfig and Makefiles. An example for both - * can be found in `RIOT/examples/advanced_examples/psa_crypto`. + * can be found in `RIOT/examples/advanced/psa_crypto`. * * ## Kconfig * We recommend using Kconfig and choosing your features in `menuconfig`. @@ -164,7 +164,7 @@ * configurations. * * Alternatively you can create an `app.config.test` file in your application folder - * and choose your symbols there (see `examples/advanced_examples/psa_crypto`). + * and choose your symbols there (see `examples/advanced/psa_crypto`). * * In the `app.config.test` file, modules can be chosen with the following syntax: * `CONFIG_MODULE_=y`, as shown below. @@ -389,7 +389,7 @@ * Secure Elements {#secure-elements} * === * - * An example showing the use of SEs can be found in `examples/advanced_examples/psa_crypto`. + * An example showing the use of SEs can be found in `examples/advanced/psa_crypto`. * * To use secure elements, you first need to assign a static location value to each device, * so PSA can find it. If you only use one device, you can use diff --git a/tests/net/gnrc_sixlowpan_frag_sfr_congure_impl/README.md b/tests/net/gnrc_sixlowpan_frag_sfr_congure_impl/README.md index 46ba325c06c0..d62f46eb2657 100644 --- a/tests/net/gnrc_sixlowpan_frag_sfr_congure_impl/README.md +++ b/tests/net/gnrc_sixlowpan_frag_sfr_congure_impl/README.md @@ -5,4 +5,4 @@ so SFR with different CongURE implementations can be tested. When `CONGURE_IMPL` is not set in the environment, `gnrc_sixlowpan_frag_sfr_congure_sfr` is used, other implementations can be used with `congure_`. -[1]: https://github.com/RIOT-OS/RIOT/tree/master/examples/networking/gnrc_networking/gnrc_networking +[1]: https://github.com/RIOT-OS/RIOT/tree/master/examples/networking/gnrc/gnrc_networking diff --git a/tests/net/gnrc_udp/README.md b/tests/net/gnrc_udp/README.md index 80aea896c5d8..fb9a76b255f9 100644 --- a/tests/net/gnrc_udp/README.md +++ b/tests/net/gnrc_udp/README.md @@ -8,4 +8,4 @@ The server is also modified as it outputs the number of currently received packets when a new packet is received instead of the content of the new packet. This counter can be reset using `udp reset` -[1]: https://github.com/RIOT-OS/RIOT/tree/master/examples/networking/gnrc_networking/gnrc_networking +[1]: https://github.com/RIOT-OS/RIOT/tree/master/examples/networking/gnrc/gnrc_networking diff --git a/tests/riotboot_flashwrite/README.md b/tests/riotboot_flashwrite/README.md index 4802b50b5487..41a67b82da77 100644 --- a/tests/riotboot_flashwrite/README.md +++ b/tests/riotboot_flashwrite/README.md @@ -27,7 +27,7 @@ Then provide de device and test: On another device setup a BR and start `start_network.sh` on that device serial port. - $ BOARD= make -C examples/networking/gnrc_networking/gnrc_borader_router flash + $ BOARD= make -C examples/networking/gnrc/gnrc_border_router flash $ sudo dist/tools/ethos/start_network.sh /dev/ttyACMx riot0 2001:db8::/64 diff --git a/tests/sys/psa_crypto_cipher/README.md b/tests/sys/psa_crypto_cipher/README.md index 06c2adf53ef8..18510a6f3f35 100644 --- a/tests/sys/psa_crypto_cipher/README.md +++ b/tests/sys/psa_crypto_cipher/README.md @@ -1,4 +1,4 @@ # PSA Crypto Cipher Test This is a configuration test for only the cipher of the PSA crypto module. -It is based off the [psa_crypto example](../../../examples/advanced_examples/psa_crypto/README.md). +It is based off the [psa_crypto example](../../../examples/advanced/psa_crypto/README.md). diff --git a/tests/sys/psa_crypto_cipher/example_cipher_aes_128.c b/tests/sys/psa_crypto_cipher/example_cipher_aes_128.c index 1e7f1f6b98c2..5a57dc6077d6 100644 --- a/tests/sys/psa_crypto_cipher/example_cipher_aes_128.c +++ b/tests/sys/psa_crypto_cipher/example_cipher_aes_128.c @@ -11,7 +11,7 @@ * @{ * * @brief Tests the PSA cipher configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann diff --git a/tests/sys/psa_crypto_cipher/example_cipher_chacha20.c b/tests/sys/psa_crypto_cipher/example_cipher_chacha20.c index be8475e97684..2d7a46c15be0 100644 --- a/tests/sys/psa_crypto_cipher/example_cipher_chacha20.c +++ b/tests/sys/psa_crypto_cipher/example_cipher_chacha20.c @@ -11,7 +11,7 @@ * @{ * * @brief Tests the PSA cipher configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann diff --git a/tests/sys/psa_crypto_ecdsa/README.md b/tests/sys/psa_crypto_ecdsa/README.md index 1363fe36ca42..f34ae6769b69 100644 --- a/tests/sys/psa_crypto_ecdsa/README.md +++ b/tests/sys/psa_crypto_ecdsa/README.md @@ -1,4 +1,4 @@ # PSA Crypto ECDSA Test This is a configuration test for only the ecdsa of the PSA crypto module. -It is based off the [psa_crypto example](../../../examples/advanced_examples/psa_crypto/README.md). +It is based off the [psa_crypto example](../../../examples/advanced/psa_crypto/README.md). diff --git a/tests/sys/psa_crypto_ecdsa/example_ecdsa_p256.c b/tests/sys/psa_crypto_ecdsa/example_ecdsa_p256.c index 84cb3453739b..641ca59c87e5 100644 --- a/tests/sys/psa_crypto_ecdsa/example_ecdsa_p256.c +++ b/tests/sys/psa_crypto_ecdsa/example_ecdsa_p256.c @@ -11,7 +11,7 @@ * @{ * * @brief Tests the PSA ECDSA configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann diff --git a/tests/sys/psa_crypto_eddsa/README.md b/tests/sys/psa_crypto_eddsa/README.md index 8c3738d94b69..34bf44faabc2 100644 --- a/tests/sys/psa_crypto_eddsa/README.md +++ b/tests/sys/psa_crypto_eddsa/README.md @@ -1,4 +1,4 @@ # PSA Crypto EDDSA Test This is a configuration test for only the eddsa of the PSA crypto module. -It is based off the [psa_crypto example](../../../examples/advanced_examples/psa_crypto/README.md). +It is based off the [psa_crypto example](../../../examples/advanced/psa_crypto/README.md). diff --git a/tests/sys/psa_crypto_eddsa/example_eddsa.c b/tests/sys/psa_crypto_eddsa/example_eddsa.c index 677ffaacf501..543d8cc5c788 100644 --- a/tests/sys/psa_crypto_eddsa/example_eddsa.c +++ b/tests/sys/psa_crypto_eddsa/example_eddsa.c @@ -11,7 +11,7 @@ * @{ * * @brief Tests the PSA EDDSA configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann diff --git a/tests/sys/psa_crypto_hashes/README.md b/tests/sys/psa_crypto_hashes/README.md index b6bfe1cb7087..a74385ff28ef 100644 --- a/tests/sys/psa_crypto_hashes/README.md +++ b/tests/sys/psa_crypto_hashes/README.md @@ -1,4 +1,4 @@ # PSA Crypto Hashes Test This is a configuration test for only the hashes of the PSA crypto module. -It is based off the [psa_crypto example](../../../examples/advanced_examples/psa_crypto/README.md). +It is based off the [psa_crypto example](../../../examples/advanced/psa_crypto/README.md). diff --git a/tests/sys/psa_crypto_hashes/example_hash.c b/tests/sys/psa_crypto_hashes/example_hash.c index 8412f8912d8d..dbc20b8a338f 100644 --- a/tests/sys/psa_crypto_hashes/example_hash.c +++ b/tests/sys/psa_crypto_hashes/example_hash.c @@ -12,7 +12,7 @@ * @{ * * @brief Tests the PSA hash configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann diff --git a/tests/sys/psa_crypto_mac/README.md b/tests/sys/psa_crypto_mac/README.md index 62f1e5d7fed5..b4e8929f8ef2 100644 --- a/tests/sys/psa_crypto_mac/README.md +++ b/tests/sys/psa_crypto_mac/README.md @@ -1,4 +1,4 @@ # PSA Crypto Mac Test This is a configuration test for only the mac of the PSA crypto module. -It is based off the [psa_crypto example](../../../examples/advanced_examples/psa_crypto/README.md). +It is based off the [psa_crypto example](../../../examples/advanced/psa_crypto/README.md). diff --git a/tests/sys/psa_crypto_mac/example_hmac_sha256.c b/tests/sys/psa_crypto_mac/example_hmac_sha256.c index 04c366ba5bc0..ecf03021a3e8 100644 --- a/tests/sys/psa_crypto_mac/example_hmac_sha256.c +++ b/tests/sys/psa_crypto_mac/example_hmac_sha256.c @@ -11,7 +11,7 @@ * @{ * * @brief Tests the PSA HMAC SHA256 configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann diff --git a/tests/sys/psa_crypto_se/README.md b/tests/sys/psa_crypto_se/README.md index 6d42c5f02d3c..864fb9ffd16a 100644 --- a/tests/sys/psa_crypto_se/README.md +++ b/tests/sys/psa_crypto_se/README.md @@ -1,4 +1,4 @@ # PSA Crypto Secure Element Test This is a configuration test for all PSA crypto modules using a secure element. -It is based off the [psa_crypto example](../../../examples/advanced_examples/psa_crypto/README.md). +It is based off the [psa_crypto example](../../../examples/advanced/psa_crypto/README.md). diff --git a/tests/sys/psa_crypto_se/custom_atca_params.h b/tests/sys/psa_crypto_se/custom_atca_params.h index 236c71508a6a..a32b6f687e5e 120000 --- a/tests/sys/psa_crypto_se/custom_atca_params.h +++ b/tests/sys/psa_crypto_se/custom_atca_params.h @@ -1 +1 @@ -../../../examples/advanced_examples/psa_crypto/custom_atca_params.h \ No newline at end of file +../../../examples/advanced/psa_crypto/custom_atca_params.h \ No newline at end of file diff --git a/tests/sys/psa_crypto_se/example_cipher_aes_128.c b/tests/sys/psa_crypto_se/example_cipher_aes_128.c index 3e71428a3380..d53733d5946e 100644 --- a/tests/sys/psa_crypto_se/example_cipher_aes_128.c +++ b/tests/sys/psa_crypto_se/example_cipher_aes_128.c @@ -11,7 +11,7 @@ * @{ * * @brief Tests the PSA secure element configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann diff --git a/tests/sys/psa_crypto_se/example_ecdsa_p256.c b/tests/sys/psa_crypto_se/example_ecdsa_p256.c index c2056a7f6bf2..09c069de9ae2 100644 --- a/tests/sys/psa_crypto_se/example_ecdsa_p256.c +++ b/tests/sys/psa_crypto_se/example_ecdsa_p256.c @@ -11,7 +11,7 @@ * @{ * * @brief Tests the PSA secure element configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann diff --git a/tests/sys/psa_crypto_se/example_hmac_sha256.c b/tests/sys/psa_crypto_se/example_hmac_sha256.c index 5afcba77a596..cc7f9df06015 100644 --- a/tests/sys/psa_crypto_se/example_hmac_sha256.c +++ b/tests/sys/psa_crypto_se/example_hmac_sha256.c @@ -11,7 +11,7 @@ * @{ * * @brief Tests the PSA secure element configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann diff --git a/tests/sys/psa_crypto_se_cipher/README.md b/tests/sys/psa_crypto_se_cipher/README.md index 22349e892953..fc253a84071e 100644 --- a/tests/sys/psa_crypto_se_cipher/README.md +++ b/tests/sys/psa_crypto_se_cipher/README.md @@ -2,4 +2,4 @@ This is a configuration test for only the cipher of the PSA crypto module using secure element. -It is based off the [psa_crypto example](../../../examples/advanced_examples/psa_crypto/README.md). +It is based off the [psa_crypto example](../../../examples/advanced/psa_crypto/README.md). diff --git a/tests/sys/psa_crypto_se_cipher/custom_atca_params.h b/tests/sys/psa_crypto_se_cipher/custom_atca_params.h index 236c71508a6a..a32b6f687e5e 120000 --- a/tests/sys/psa_crypto_se_cipher/custom_atca_params.h +++ b/tests/sys/psa_crypto_se_cipher/custom_atca_params.h @@ -1 +1 @@ -../../../examples/advanced_examples/psa_crypto/custom_atca_params.h \ No newline at end of file +../../../examples/advanced/psa_crypto/custom_atca_params.h \ No newline at end of file diff --git a/tests/sys/psa_crypto_se_cipher/example_cipher_aes_128.c b/tests/sys/psa_crypto_se_cipher/example_cipher_aes_128.c index a666eac6e220..7feedff5ab16 100644 --- a/tests/sys/psa_crypto_se_cipher/example_cipher_aes_128.c +++ b/tests/sys/psa_crypto_se_cipher/example_cipher_aes_128.c @@ -11,7 +11,7 @@ * @{ * * @brief Tests the PSA secure element cipher configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann diff --git a/tests/sys/psa_crypto_se_ecdsa/README.md b/tests/sys/psa_crypto_se_ecdsa/README.md index ee1aae1ed138..9cfb06eabd82 100644 --- a/tests/sys/psa_crypto_se_ecdsa/README.md +++ b/tests/sys/psa_crypto_se_ecdsa/README.md @@ -2,4 +2,4 @@ This is a configuration test for only the ecdsa of the PSA crypto module using secure element. -It is based off the [psa_crypto example](../../../examples/advanced_examples/psa_crypto/README.md). +It is based off the [psa_crypto example](../../../examples/advanced/psa_crypto/README.md). diff --git a/tests/sys/psa_crypto_se_ecdsa/custom_atca_params.h b/tests/sys/psa_crypto_se_ecdsa/custom_atca_params.h index 236c71508a6a..a32b6f687e5e 120000 --- a/tests/sys/psa_crypto_se_ecdsa/custom_atca_params.h +++ b/tests/sys/psa_crypto_se_ecdsa/custom_atca_params.h @@ -1 +1 @@ -../../../examples/advanced_examples/psa_crypto/custom_atca_params.h \ No newline at end of file +../../../examples/advanced/psa_crypto/custom_atca_params.h \ No newline at end of file diff --git a/tests/sys/psa_crypto_se_ecdsa/example_ecdsa_p256.c b/tests/sys/psa_crypto_se_ecdsa/example_ecdsa_p256.c index 09d2a7e37ccf..2f394ed0011a 100644 --- a/tests/sys/psa_crypto_se_ecdsa/example_ecdsa_p256.c +++ b/tests/sys/psa_crypto_se_ecdsa/example_ecdsa_p256.c @@ -11,7 +11,7 @@ * @{ * * @brief Tests the PSA secure element ECDSA configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann diff --git a/tests/sys/psa_crypto_se_mac/README.md b/tests/sys/psa_crypto_se_mac/README.md index 5262a2e433a8..d4b489af70f5 100644 --- a/tests/sys/psa_crypto_se_mac/README.md +++ b/tests/sys/psa_crypto_se_mac/README.md @@ -2,4 +2,4 @@ This is a configuration test for only the mac of the PSA crypto module using secure element. -It is based off the [psa_crypto example](../../../examples/advanced_examples/psa_crypto/README.md). +It is based off the [psa_crypto example](../../../examples/advanced/psa_crypto/README.md). diff --git a/tests/sys/psa_crypto_se_mac/custom_atca_params.h b/tests/sys/psa_crypto_se_mac/custom_atca_params.h index 236c71508a6a..a32b6f687e5e 120000 --- a/tests/sys/psa_crypto_se_mac/custom_atca_params.h +++ b/tests/sys/psa_crypto_se_mac/custom_atca_params.h @@ -1 +1 @@ -../../../examples/advanced_examples/psa_crypto/custom_atca_params.h \ No newline at end of file +../../../examples/advanced/psa_crypto/custom_atca_params.h \ No newline at end of file diff --git a/tests/sys/psa_crypto_se_mac/example_hmac_sha256.c b/tests/sys/psa_crypto_se_mac/example_hmac_sha256.c index f55eaa6d86a2..cb3812f514c6 100644 --- a/tests/sys/psa_crypto_se_mac/example_hmac_sha256.c +++ b/tests/sys/psa_crypto_se_mac/example_hmac_sha256.c @@ -11,7 +11,7 @@ * @{ * * @brief Tests the PSA secure element HMAC SHA256 configurations - * Contents have been copied from `examples/advanced_examples/psa_crypto` + * Contents have been copied from `examples/advanced/psa_crypto` * * @author Mikolai Gütschow * @author Lena Boeckmann