Several example sketches fail

sonofcy · September 1, 2025, 9:34pm

The example sketch scan networks fails on NANO R4, it works on UNO R4
Here is the code

/*
  This example  prints the board's MAC address, and
  scans for available WiFi networks using the NINA module.
  Every ten seconds, it scans again. It doesn't actually
  connect to any network, so no encryption scheme is specified.

  Circuit:
   * Uno R4 WiFi

  created 13 July 2010
  by dlf (Metodo2 srl)
  modified 21 Junn 2012
  by Tom Igoe and Jaymes Dec

  Find the full UNO R4 WiFi Network documentation here:
  https://docs.arduino.cc/tutorials/uno-r4-wifi/wifi-examples#scan-networks
 */



#include <WiFiS3.h>

void setup() {
  //Initialize serial and wait for port to open:
  Serial.begin(9600);
  while (!Serial) {
    ; // wait for serial port to connect. Needed for native USB port only
  }

  // check for the WiFi module:
  if (WiFi.status() == WL_NO_MODULE) {
    Serial.println("Communication with WiFi module failed!");
    // don't continue
    while (true);
  }

  String fv = WiFi.firmwareVersion();
  if (fv < WIFI_FIRMWARE_LATEST_VERSION) {
    Serial.println("Please upgrade the firmware");
  }
}

void loop() {
  byte mac[6];
  // scan for existing networks:
  Serial.println("Scanning available networks...");
  listNetworks();
  WiFi.macAddress(mac);
  Serial.println();
  Serial.print("Your MAC Address is: ");
  printMacAddress(mac);
  delay(10000);
}

void listNetworks() {
  // scan for nearby networks:
  Serial.println("** Scan Networks **");
  int numSsid = WiFi.scanNetworks();
  if (numSsid == -1) {
    Serial.println("Couldn't get a WiFi connection");
    while (true);
  }

  // print the list of networks seen:
  Serial.print("number of available networks:");
  Serial.println(numSsid);

  // print the network number and name for each network found:
  for (int thisNet = 0; thisNet < numSsid; thisNet++) {
    Serial.print(thisNet);
    Serial.print(") ");
    Serial.print(WiFi.SSID(thisNet));
    Serial.print(" Signal: ");
    Serial.print(WiFi.RSSI(thisNet));
    Serial.print(" dBm");
    Serial.print(" Encryption: ");
    printEncryptionType(WiFi.encryptionType(thisNet));
  }
}

void printEncryptionType(int thisType) {
  // read the encryption type and print out the name:
  switch (thisType) {
    case ENC_TYPE_WEP:
      Serial.println("WEP");
      break;
    case ENC_TYPE_WPA:
      Serial.println("WPA");
      break;
    case ENC_TYPE_WPA2:
      Serial.println("WPA2");
      break;
    case ENC_TYPE_WPA3:
      Serial.println("WPA3");
      break;   
    case ENC_TYPE_NONE:
      Serial.println("None");
      break;
    case ENC_TYPE_AUTO:
      Serial.println("Auto");
      break;
    case ENC_TYPE_UNKNOWN:
    default:
      Serial.println("Unknown");
      break;
  }
}


void printMacAddress(byte mac[]) {
  for (int i = 0; i < 6; i++) {
    if (i > 0) {
      Serial.print(":");
    }
    if (mac[i] < 16) {
      Serial.print("0");
    }
    Serial.print(mac[i], HEX);
  }
  Serial.println();
}

Here are the errors

FQBN: arduino:renesas_uno:nanor4
Using board 'nanor4' from platform in folder: /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1
Using core 'arduino' from platform in folder: /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1

Detecting libraries used...
/Users/ronalexander/Library/Arduino15/packages/arduino/tools/arm-none-eabi-gcc/7-2017q4/bin/arm-none-eabi-g++ -c -w -Os -g3 -fno-use-cxa-atexit -fno-rtti -fno-exceptions -nostdlib -DF_CPU=48000000 -DARDUINO_NANO_R4 -DARDUINO_UNOR4_MINIMA -std=gnu++17 -mcpu=cortex-m4 -mfloat-abi=hard -mfpu=fpv4-sp-d16 -fsigned-char -ffunction-sections -fdata-sections -fmessage-length=0 -fno-builtin -w -x c++ -E -CC -DARDUINO=10607 -DPROJECT_NAME="/Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/ScanNetworks.ino" -DARDUINO_nanor4 -DARDUINO_ARCH_RENESAS_UNO -DARDUINO_ARCH_RENESAS -DARDUINO_FSP -D_XOPEN_SOURCE=700 -mthumb @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/defines.txt -DCFG_TUSB_MCU=OPT_MCU_RAXXX -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/tinyusb -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated-avr-comp -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4 -iprefix/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1 @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/includes.txt /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/sketch/ScanNetworks.ino.cpp -o /dev/null
Alternatives for WiFiS3.h: [WiFiS3@0.0.0]
ResolveLibrary(WiFiS3.h)
  -> candidates: [WiFiS3@0.0.0]
/Users/ronalexander/Library/Arduino15/packages/arduino/tools/arm-none-eabi-gcc/7-2017q4/bin/arm-none-eabi-g++ -c -w -Os -g3 -fno-use-cxa-atexit -fno-rtti -fno-exceptions -nostdlib -DF_CPU=48000000 -DARDUINO_NANO_R4 -DARDUINO_UNOR4_MINIMA -std=gnu++17 -mcpu=cortex-m4 -mfloat-abi=hard -mfpu=fpv4-sp-d16 -fsigned-char -ffunction-sections -fdata-sections -fmessage-length=0 -fno-builtin -w -x c++ -E -CC -DARDUINO=10607 -DPROJECT_NAME="/Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/ScanNetworks.ino" -DARDUINO_nanor4 -DARDUINO_ARCH_RENESAS_UNO -DARDUINO_ARCH_RENESAS -DARDUINO_FSP -D_XOPEN_SOURCE=700 -mthumb @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/defines.txt -DCFG_TUSB_MCU=OPT_MCU_RAXXX -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/tinyusb -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated-avr-comp -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4 -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src -iprefix/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1 @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/includes.txt /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/sketch/ScanNetworks.ino.cpp -o /dev/null
/Users/ronalexander/Library/Arduino15/packages/arduino/tools/arm-none-eabi-gcc/7-2017q4/bin/arm-none-eabi-g++ -c -w -Os -g3 -fno-use-cxa-atexit -fno-rtti -fno-exceptions -nostdlib -DF_CPU=48000000 -DARDUINO_NANO_R4 -DARDUINO_UNOR4_MINIMA -std=gnu++17 -mcpu=cortex-m4 -mfloat-abi=hard -mfpu=fpv4-sp-d16 -fsigned-char -ffunction-sections -fdata-sections -fmessage-length=0 -fno-builtin -w -x c++ -E -CC -DARDUINO=10607 -DPROJECT_NAME="/Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/ScanNetworks.ino" -DARDUINO_nanor4 -DARDUINO_ARCH_RENESAS_UNO -DARDUINO_ARCH_RENESAS -DARDUINO_FSP -D_XOPEN_SOURCE=700 -mthumb @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/defines.txt -DCFG_TUSB_MCU=OPT_MCU_RAXXX -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/tinyusb -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated-avr-comp -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4 -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src -iprefix/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1 @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/includes.txt /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/Modem.cpp -o /dev/null
Using cached library dependencies for file: /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/StringHelpers.cpp
Using cached library dependencies for file: /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/WiFi.cpp
Using cached library dependencies for file: /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/WiFiClient.cpp
Using cached library dependencies for file: /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/WiFiFileSystem.cpp
Using cached library dependencies for file: /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/WiFiSSLClient.cpp
Using cached library dependencies for file: /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/WiFiServer.cpp
Using cached library dependencies for file: /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/WiFiUdp.cpp
Generating function prototypes...
/Users/ronalexander/Library/Arduino15/packages/arduino/tools/arm-none-eabi-gcc/7-2017q4/bin/arm-none-eabi-g++ -c -w -Os -g3 -fno-use-cxa-atexit -fno-rtti -fno-exceptions -nostdlib -DF_CPU=48000000 -DARDUINO_NANO_R4 -DARDUINO_UNOR4_MINIMA -std=gnu++17 -mcpu=cortex-m4 -mfloat-abi=hard -mfpu=fpv4-sp-d16 -fsigned-char -ffunction-sections -fdata-sections -fmessage-length=0 -fno-builtin -w -x c++ -E -CC -DARDUINO=10607 -DPROJECT_NAME="/Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/ScanNetworks.ino" -DARDUINO_nanor4 -DARDUINO_ARCH_RENESAS_UNO -DARDUINO_ARCH_RENESAS -DARDUINO_FSP -D_XOPEN_SOURCE=700 -mthumb @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/defines.txt -DCFG_TUSB_MCU=OPT_MCU_RAXXX -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/tinyusb -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated-avr-comp -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4 -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src -iprefix/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1 @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/includes.txt /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/sketch/ScanNetworks.ino.cpp -o /private/var/folders/r5/fjhtttf952x9mvr0j_pdkt9h0000gn/T/2434236282/sketch_merged.cpp
/Users/ronalexander/Library/Arduino15/packages/builtin/tools/ctags/5.8-arduino11/ctags -u --language-force=c++ -f - --c++-kinds=svpf --fields=KSTtzns --line-directives /private/var/folders/r5/fjhtttf952x9mvr0j_pdkt9h0000gn/T/2434236282/sketch_merged.cpp

Compiling sketch...
/Users/ronalexander/Library/Arduino15/packages/arduino/tools/arm-none-eabi-gcc/7-2017q4/bin/arm-none-eabi-g++ -c -w -Os -g3 -fno-use-cxa-atexit -fno-rtti -fno-exceptions -MMD -nostdlib -DF_CPU=48000000 -DARDUINO_NANO_R4 -DARDUINO_UNOR4_MINIMA -MMD -std=gnu++17 -mcpu=cortex-m4 -mfloat-abi=hard -mfpu=fpv4-sp-d16 -fsigned-char -ffunction-sections -fdata-sections -fmessage-length=0 -fno-builtin -DARDUINO=10607 "-DPROJECT_NAME=\"/Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/ScanNetworks.ino\"" -DARDUINO_nanor4 -DARDUINO_ARCH_RENESAS_UNO -DARDUINO_ARCH_RENESAS -DARDUINO_FSP -D_XOPEN_SOURCE=700 -mthumb @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/defines.txt -DCFG_TUSB_MCU=OPT_MCU_RAXXX -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/tinyusb -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated-avr-comp -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4 -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src -iprefix/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1 @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/includes.txt /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/sketch/ScanNetworks.ino.cpp -o /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/sketch/ScanNetworks.ino.cpp.o
Compiling libraries...
Compiling library "WiFiS3"
/Users/ronalexander/Library/Arduino15/packages/arduino/tools/arm-none-eabi-gcc/7-2017q4/bin/arm-none-eabi-g++ -c -w -Os -g3 -fno-use-cxa-atexit -fno-rtti -fno-exceptions -MMD -nostdlib -DF_CPU=48000000 -DARDUINO_NANO_R4 -DARDUINO_UNOR4_MINIMA -MMD -std=gnu++17 -mcpu=cortex-m4 -mfloat-abi=hard -mfpu=fpv4-sp-d16 -fsigned-char -ffunction-sections -fdata-sections -fmessage-length=0 -fno-builtin -DARDUINO=10607 "-DPROJECT_NAME=\"/Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/ScanNetworks.ino\"" -DARDUINO_nanor4 -DARDUINO_ARCH_RENESAS_UNO -DARDUINO_ARCH_RENESAS -DARDUINO_FSP -D_XOPEN_SOURCE=700 -mthumb @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/defines.txt -DCFG_TUSB_MCU=OPT_MCU_RAXXX -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/tinyusb -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino/api/deprecated-avr-comp -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/cores/arduino -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4 -I/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src -iprefix/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1 @/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/variants/NANOR4/includes.txt /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/Modem.cpp -o /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/libraries/WiFiS3/Modem.cpp.o
Using previously compiled file: /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/libraries/WiFiS3/StringHelpers.cpp.o
Using previously compiled file: /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/libraries/WiFiS3/WiFiUdp.cpp.o
Using previously compiled file: /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/libraries/WiFiS3/WiFi.cpp.o
Using previously compiled file: /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/libraries/WiFiS3/WiFiSSLClient.cpp.o
Using previously compiled file: /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/libraries/WiFiS3/WiFiFileSystem.cpp.o
Using previously compiled file: /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/libraries/WiFiS3/WiFiClient.cpp.o
Using previously compiled file: /Users/ronalexander/Library/Caches/arduino/sketches/AB6184A5AFE2826AEF76471B0305AE60/libraries/WiFiS3/WiFiServer.cpp.o
/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/Modem.cpp:426:34: error: 'D24' was not declared in this scope
    ModemClass modem = ModemClass(D24,D25);
                                  ^~~
/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/Modem.cpp:426:34: note: suggested alternative: 'D14'
    ModemClass modem = ModemClass(D24,D25);
                                  ^~~
                                  D14
/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/Modem.cpp:426:38: error: 'D25' was not declared in this scope
    ModemClass modem = ModemClass(D24,D25);
                                      ^~~
/Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3/src/Modem.cpp:426:38: note: suggested alternative: 'D15'
    ModemClass modem = ModemClass(D24,D25);
                                      ^~~
                                      D15
Using library WiFiS3 at version 0.0.0 in folder: /Users/ronalexander/Library/Arduino15/packages/arduino/hardware/renesas_uno/1.5.1/libraries/WiFiS3 
exit status 1

Compilation error: exit status 1

BitSeeker · September 1, 2025, 9:49pm

I didn't think that the Nano R4 had WiFi?
Its more like the UNO R4 Minima.

sonofcy · September 1, 2025, 10:11pm

Well, that would explain it. I just assumed all NANOs had wifi. So I bought a bunch for no good reason.

sonofcy · September 1, 2025, 10:17pm

Then why are there board specific examples and

And the core files look lke there should be wifi

I am not saying you are wrong, but it's dam confusing!

ptillisch · September 2, 2025, 12:56am

Hi @sonofcy.

These are not actually board-specific. They are platform-specific. They are all the example sketches of the libraries bundled with the "Arduino UNO R4 Boards" platform. In addition to the Nano R4, that platform provides support for the UNO R4 WiFi board. For this reason, the "WiFiS3" library is bundled with the platform, and so that library's examples are shown in the File > Examples menu when any board of the "Arduino UNO R4 Boards" platform is selected in Arduino IDE.

So the "Examples for Arduino Nano R4" heading in the menu is misleading. I have made a proposal for changing this to an appropriate description of the examples:

github.com/arduino/arduino-ide

Use accurate description for platform bundled library examples in menu

opened 02:31PM - 07 Aug 22 UTC

per1234

type: enhancement topic: code

### Describe the request Change the heading text of the platform bundled librar…ies section of the **File > Examples** menu from the current format: > Examples for \<board name\> to: > Examples for \<platform name\> 🙂 The IDE will no longer make unsubstantiated claims of board-specific compatibility of platform bundled examples to the users accessing them via the **File > Examples** menu. ### Describe the current behavior The installations of Arduino boards platforms may contain ["platform bundled libraries"](https://arduino.github.io/arduino-cli/dev/platform-specification/#platform-bundled-libraries), which are only accessible when a board of that platform is selected in the Arduino IDE. The Arduino IDE places the example sketches of platform bundled libraries in a dedicated section under the **File > Examples** menu. The heading text of this section follows the format "Examples for \<board name\>", where "\<board name\>" is the name of the currently selected board. This description is not guaranteed to be correct because all examples of all libraries of the platform are listed here, while the libraries or examples may only be compatible with a specific board of the platform. There is no mechanism for the Arduino IDE to determine whether a sketch or library is compatible with a specific board. 🙁 The **File > Examples** menu section makes incorrect claims of board compatibility for some platform bundled library examples. An arbitrary example of this is the ["**SAMD_BootloaderUpdater**"](https://github.com/arduino/ArduinoCore-samd/tree/1.8.13/libraries/SAMD_BootloaderUpdater) library bundled with the official ["**Arduino SAMD (32-bits ARM Cortex-M0+) Boards**"](https://github.com/arduino/ArduinoCore-samd) platform. This library is written to be used only with the ["**MKR Vidor 4000**" board](https://docs.arduino.cc/hardware/mkr-vidor-4000), and attempting to compile its example sketch for any other board [will result in an error](https://github.com/arduino/ArduinoCore-samd/blob/1.8.13/libraries/SAMD_BootloaderUpdater/src/SAMD_BootloaderUpdater.cpp#L29-L33). Yet, the "**UpdateBootloader**" example of this library is described as being "for" the currently selected board even when it is not a **MKR Vidor 4000**. ![image](https://user-images.githubusercontent.com/8572152/183295429-0fd8dc36-840c-40cd-91d3-d445a57d6159.png) ### Arduino IDE version 2.0.0-rc9.1-snapshot-0b33b51 ### Operating system All ### Operating system version Any ### Additional context Real world example of the current menu selection heading causing confusion: https://github.com/arduino/ArduinoCore-mbed/issues/529#issuecomment-1201117968 #### Related - https://github.com/arduino/arduino-ide/issues/2259 - https://forum.arduino.cc/t/opamp-library-needs-updating-for-nano-r4/1403919/3 - https://forum.arduino.cc/t/several-example-sketches-fail/1405063/4 ### Issue checklist - [X] I searched for previous requests in [the issue tracker](https://github.com/arduino/arduino-ide/issues?q=) - [X] I verified the feature was still missing when using the latest [nightly build](https://github.com/arduino/arduino-ide#nightly-builds) - [X] My request contains all necessary details

There is also a proposal for making it possible for compatibility to be specified to a board level granularity in library metadata here:

github.com/arduino/arduino-cli

Add libraries super compatibility and explicit incompatibility in the spec

opened 02:33PM - 17 Apr 23 UTC

umbynos

type: enhancement topic: documentation status: waiting for information topic: code phase: design

### Describe the request Add support for a field named `supported` in [the `lib…rary.properties` library metadata file](https://arduino.github.io/arduino-cli/dev/library-specification/#library-metadata). This field is a comma-separated list of patterns to match against an FQBN. This will allow library developers to define the supported boards for the library down to board-level granularity. The result would be something like this in the `library.properties` file: ```text name=Camera version=1.0 author=Arduino maintainer=Arduino <info@arduino.cc> sentence=Camera library for Portenta H7 Vision Shield paragraph= category=Other url=https://github.com/arduino/ArduinoCore-mbed/tree/master/libraries/Camera architectures=mbed,!avr supported=*:mbed:portenta,!*:*:nano33ble #supported=mbed:portenta,!mbed:nano33ble <- without wildcards ``` This information could be used for applications such as: - Accurately populate the "**Compatibility**" lists in [the Arduino Library Reference](https://www.arduino.cc/reference/en/libraries/) (this would require also changing [the **libraries-repository-engine** tool](https://github.com/arduino/libraries-repository-engine) to include the information in [the Library Manager index](http://downloads.arduino.cc/libraries/library_index.json)). - Select the best library for the selected board during [library discovery](https://arduino.github.io/arduino-cli/dev/sketch-build-process/#dependency-resolution). - Print a warning when compiling the library for an unsupported board. - Disallow compilation of the library for boards that are explicitly specified as being unsupported. ### Describe the current behavior Library developers can only indicate compatibility at architecture-level granularity. A library may have dependencies on attributes that only present on a subset of boards of a given architecture. This means it is not possible for tools to accurately determine whether a specific board is supported by a library. For example, the "**Keyboard**" library specifies compatibility with the `avr` architecture: https://github.com/arduino-libraries/Keyboard/blob/1.0.4/library.properties#L9 ```text architectures=avr, samd, sam ``` However, not all AVR microcontrollers have the required native USB capability. This results in inaccurate information about the library's support for those boards. The library is listed in `lib list` command output when the FQBN of an unsupported board (e.g., [**Uno**](https://docs.arduino.cc/hardware/uno-rev3)) is specified via the `--fqbn` flag: ```text $ arduino-cli lib install Keyboard Downloading Keyboard@1.0.4... Keyboard@1.0.4 Keyboard@1.0.4 already downloaded Installing Keyboard@1.0.4... Installed Keyboard@1.0.4 $ arduino-cli lib list Keyboard --fqbn arduino:avr:uno Name Installed Available Location Description Keyboard 1.0.4 - LIBRARY_LOCATION_USER - ``` Unsupported boards are included in the automatically generated "**Compatibility**" list of the library's reference page: https://www.arduino.cc/reference/en/libraries/keyboard/ ### Arduino CLI version 0.32.2 ### Operating system N/A ### Operating system version N/A ### Additional context The newly added field should be ignored by versions of Arduino development tools that don't have support for the new field. If so, this change would not result in any backwards incompatibility of the libraries that use it. --- Relevant code: https://github.com/arduino/arduino-cli/blob/743c3e9b3c94eded62b44081a03650d571fa230c/arduino/libraries/libraries.go#L78 #### Related - https://github.com/arduino/Arduino/issues/11871 - https://github.com/arduino/ArduinoCore-mbed/issues/529#issuecomment-1201117968 - https://github.com/arduino/arduino-ide/issues/1304 - https://github.com/arduino-libraries/ArduinoIoTCloud/pull/380#issuecomment-1737244158 - https://forum.arduino.cc/t/documentation-for-keyboard-library-needs-some-correction/1126221 - https://forum.arduino.cc/t/arduino-keyboard-not-working-on-arduino-uno-r3/1102400 - https://forum.arduino.cc/t/sketch-funktioniert-nicht-keyboard/1099364/6 - https://forum.arduino.cc/t/issue-on-keyboard-library/1065385 - https://forum.arduino.cc/t/what-is-wrong-here/1080550/7 - https://forum.arduino.cc/t/comments-on-arduino-1-5-specifications/162030/72 / https://forum.arduino.cc/t/comments-on-arduino-1-5-specifications/162030/83 - https://forum.arduino.cc/t/comments-on-arduino-1-5-specifications/162030/84 - https://forum.arduino.cc/t/opamp-library-needs-updating-for-nano-r4/1403919/3 ### Issue checklist - [X] I searched for previous requests in [the issue tracker](https://github.com/arduino/arduino-cli/issues?q=) - [X] I verified the feature was still missing when using the [nightly build](https://arduino.github.io/arduino-cli/dev/installation/#nightly-builds) - [X] My request contains all necessary details

If that compatibility information was available, it could be used by Arduino IDE to filter and tailor the content of the "Examples" menu.

As with the examples, the reason is that the "Arduino UNO R4 Boards" platform provides support for the UNO R4 WiFi board. For this reason, it contains files related to Wi-Fi and that board.

sonofcy · September 2, 2025, 1:49am

Thank you for the explanation, I don't feel quite so stupid now.

BitSeeker · September 2, 2025, 8:05am

I must admit that I also thought that the examples were board specific, so thank you @ptillisch for the explanation.

At one time one could more readily align the board name with a specific MCU - UNO/Nano=328P, Leonardo/Micro=32u4, Mega=2560 etc, none of the official Arduino boards had WiFi capability and to add WiFi one had to add a separate ESP8266 or ESP32 module, so this situation never arose. But as things have moved on, we have seen a proliferation of newer boards that now include onboard WiFi modules (Nano ESP32, Nano Connect, UNO WiFi Rev2, UNO R4 Wifi, Gigi Wifi etc) and that's without mentioning third party versions. Boards that have an onboard ESP32 have, in effect, two MCUs. We now also have versions of the same board with and without WiFi. The picture has become a little more complex. The board packages evidently remain categorized by their core MCU platform which is fair enough as the included WiFi module is a peripheral. It is also understandable to include of all examples - including the WiFiS3 related ones - pertaining to the platform, within the package. However, is there no way, for the purposes of clarity, to filter out and not show WiFi examples when a the board that has been selected does not have WiFi capability? Is there no #define value or some tag in the board definition within boards.txt that could be used to determine this? I think that would be useful to avoid this kind of confusion and address the increasing number of permutations.

ptillisch · September 2, 2025, 12:47pm

The "Arduino Mbed OS Nano Boards" platform provides support for the Nordic nRF52840-based Nano 33 BLE boards and the Raspberry Pi RP2040-based Nano RP2040 Connect.

And if you look at the "Arduino Mbed OS Boards" platform as a whole, the diversity of targets is even more diverse.

The same applies to the new Zephyr OS-based platform.

The "Teensy" platform supports the modern NXP-based boards as well as the older AVR-based boards.

Even though the "esp32" platform only supports microcontrollers of the "ESP32" family, there are actually very significant differences between the targets, to the point of even needing different toolchains.

Not in this context where we are talking about Arduino IDE populating the File > Examples menu.

In my previous reply, I mentioned that there is a proposal for allowing library compatibility to be specified via the library metadata to a board-level granularity. But there isn't anything like that currently.

Note that Arduino IDE doesn't have any understanding of the core, library, and sketch code when populating the menu. It only has the information provided by the platform configuration and library metadata.

Well, boards.txt defines a unique machine identifier for the board. This is probably all that is needed from the platform. That identifier can then be used in compatibility/incompatibility lists in the library metadata.

Of course, you could go further by taking the approach of instead defining arbitrary attributes of the board (e.g., wifi-s3, hid) in the platform's board definition and then specifying the required attributes in sketch metadata. However, this would be more difficult to implement since it requires coordination between the platform and sketch developers, whereas the current proposal doesn't require any work in the platforms.

Topic		Replies	Views
nuevo con dudas Hardware	12	4818	May 7, 2021
Where are WIFIS3 examples hiding? IDE 2.x	14	2048	April 13, 2024
Arduino Uno Wifi IDE 1.x	56	8187	May 5, 2021
ScanNetworks example works on Web editor but not on Arduino IDE Networking, Protocols, and Devices	2	401	May 6, 2021
discussion on supporting the TI CC3000 WiFi module Hardware Development	129	123268	May 6, 2021

Several example sketches fail

Related topics