Merge branch '2.x.x' into server_end

Author: pennam

.github/workflows/check-arduino.yml

@@ -19,7 +19,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Arduino Lint
-        uses: arduino/arduino-lint-action@v1
+        uses: arduino/arduino-lint-action@v2
         with:
           compliance: specification
           library-manager: update

.github/workflows/compile-examples.yml

@@ -29,17 +29,80 @@ jobs:
 
     env:
       SKETCHES_REPORTS_PATH: sketches-reports
-
+      UNIVERSAL_SKETCH_PATHS: |
+        - examples/AP_SimpleWebServer
+        - examples/ConnectNoEncryption
+        - examples/ConnectWithWEP
+        - examples/ConnectWithWPA
+        - examples/ConnectWithWPA2Enterprise
+        - examples/Prefs2Struct
+        - examples/ScanNetworks
+        - examples/ScanNetworksAdvanced
+        - examples/SimpleWebServerWiFi
+        - examples/WiFiAdvancedChatServer
+        - examples/WiFiChatServer
+        - examples/WiFiPing
+        - examples/WiFiSSLClient
+        - examples/WiFiStorage
+        - examples/WiFiUdpNtpClient
+        - examples/WiFiUdpSendReceiveString
+        - examples/WiFiWebClient
+        - examples/WiFiWebClientRepeating
+        - examples/WiFiWebServer
     strategy:
       fail-fast: false
 
       matrix:
         board:
           - fqbn: arduino:samd:mkrwifi1010
+            platforms: |
+              - name: arduino:samd
+            artifact-name-suffix: arduino-samd-mkrwifi1010
           - fqbn: arduino:samd:mkrvidor4000
+            platforms: |
+              - name: arduino:samd
+            artifact-name-suffix: arduino-samd-mkrvidor4000
           - fqbn: arduino:samd:nano_33_iot
+            platforms: |
+              - name: arduino:samd
+            artifact-name-suffix: arduino-samd-nano_33_iot
           - fqbn: arduino:megaavr:uno2018:mode=on
+            platforms: |
+              - name: arduino:megaavr
+            artifact-name-suffix: arduino-megaavr-uno2018
           - fqbn: arduino:mbed_nano:nanorp2040connect
+            platforms: |
+              - name: arduino:mbed_nano
+            artifact-name-suffix: arduino-mbed_nano-nanorp2040connect
+
+        include:
+          # mkrwifi1010
+          - board:
+              fqbn: arduino:samd:mkrwifi1010
+            sketch-paths: |
+              - examples/PreferencesCounter
+              - examples/PreferencesValidation
+          # mkrvidor4000
+          - board:
+              fqbn: arduino:samd:mkrvidor4000
+            sketch-paths: |
+              - examples/PreferencesCounter
+              - examples/PreferencesValidation
+          # nano_33_iot
+          - board:
+              fqbn: arduino:samd:nano_33_iot
+            sketch-paths: |
+              - examples/PreferencesCounter
+              - examples/PreferencesValidation
+          # uno2018
+          - board:
+              fqbn: arduino:megaavr:uno2018:mode=on
+          # nanorp2040connect
+          - board:
+              fqbn: arduino:mbed_nano:nanorp2040connect
+            sketch-paths: |
+              - examples/PreferencesCounter
+              - examples/PreferencesValidation
 
     steps:
       - name: Checkout
@@ -56,13 +119,13 @@ jobs:
             # Install library dependencies.
             - name: VidorPeripherals
           sketch-paths: |
-            - ./examples/
+            ${{ matrix.sketch-paths }}
           enable-deltas-report: true
           sketches-report-path: ${{ env.SKETCHES_REPORTS_PATH }}
 
       - name: Save memory usage change report as artifact
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           if-no-files-found: error
-          name: ${{ env.SKETCHES_REPORTS_PATH }}
           path: ${{ env.SKETCHES_REPORTS_PATH }}
+          name: sketches-report-${{ matrix.board.artifact-name-suffix }}

.github/workflows/report-size-deltas.yml

@@ -20,5 +20,5 @@ jobs:
       - name: Comment size deltas reports to PRs
         uses: arduino/report-size-deltas@v1
         with:
-          # The name of the workflow artifact created by the "Compile Examples" workflow
-          sketches-reports-source: sketches-reports
+          # Regex matching the names of the workflow artifacts created by the "Compile Examples" workflow
+          sketches-reports-source: ^sketches-report-.+

.github/workflows/sync-labels.yml

@@ -70,7 +70,7 @@ jobs:
           file-url: https://raw.githubusercontent.com/arduino/tooling-project-assets/main/workflow-templates/assets/sync-labels/${{ matrix.filename }}
 
       - name: Pass configuration files to next job via workflow artifact
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           path: |
             *.yaml
@@ -108,13 +108,13 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Download configuration files artifact
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: ${{ env.CONFIGURATIONS_ARTIFACT }}
           path: ${{ env.CONFIGURATIONS_FOLDER }}
 
       - name: Remove unneeded artifact
-        uses: geekyeggo/delete-artifact@v2
+        uses: geekyeggo/delete-artifact@v5
         with:
           name: ${{ env.CONFIGURATIONS_ARTIFACT }}
 

docs/api.md

@@ -1720,6 +1720,71 @@ void setup()
 void loop () {}
 ```
 
+### `WiFi.dnsIP()`
+
+#### Description
+
+Returns the DNS server IP address for the device.
+
+
+#### Syntax
+
+```
+WiFi.dnsIP()
+WiFi.dnsIP(n)
+
+```
+
+#### Parameters
+optional parameter n for the number of the DNS server to get the second DNS serverv
+
+#### Returns
+- the DNS server IP address for the device (IPAddress).
+
+#### Example
+
+```
+#include <WiFiNINA.h>
+
+#include "arduino_secrets.h"
+char ssid[] = SECRET_SSID;
+char pass[] = SECRET_PASS;
+
+IPAddress emptyIP;
+
+void setup() {
+
+  Serial.begin(115200);
+  while (!Serial) {}
+
+  Serial.print("Attempting to connect to SSID: ");
+  Serial.println(ssid);
+  int status = WiFi.begin(ssid, pass);
+  if ( status != WL_CONNECTED) {
+    Serial.println("Couldn't get a WiFi connection");
+    while(true);
+  }
+
+  Serial.print("DHCP assigned DNS server: ");
+  IPAddress dns1 = WiFi.dnsIP();
+  if (dns1 == emptyIP) {
+    Serial.println("not set");
+  } else {
+    dns1.printTo(Serial);
+    Serial.println();
+    IPAddress dns2 = WiFi.dnsIP(1);
+    if (dns2 != emptyIP) {
+      Serial.print("DNS server2: ");
+      dns2.printTo(Serial);
+      Serial.println();
+    }
+  }
+
+}
+
+void loop() {
+}
+```
 ### `WiFi.getTime()`
 
 #### Description
@@ -2764,6 +2829,63 @@ void loop() {
  
 ```
 
+### `if(server)`
+
+#### Description
+Indicates whether the server is listening for new clients. You can use this to detect whether server.begin() was successful.
+
+
+#### Syntax
+
+```
+if (server)
+if (!server)
+
+```
+
+#### Parameters
+none
+
+#### Returns
+- whether the server is listening for new clients (bool).
+
+#### Example
+
+```
+#include <WiFiNINA.h>
+
+char ssid[] = "Network";          //  your network SSID (name)
+char pass[] = "myPassword";   // your network password
+
+WiFiServer server(23);
+
+void setup() {
+
+  Serial.begin(115200);
+  while (!Serial) {}
+
+  int status = WiFi.begin(ssid, pass);
+  if ( status != WL_CONNECTED) {
+    Serial.println("Couldn't get a WiFi connection");
+    while(true);
+  }
+
+  server.begin();
+  if (!server) {
+    Serial.println("Server failed to start.");
+    while(true);
+  }
+}
+
+void loop() {
+  WiFiClient client = server.available();
+  if (client) {
+    String s = client.readStringUntil('\n');
+    server.println(s);
+  }
+}
+```
+
 ### `server.status()`
 
 #### Description
@@ -2973,6 +3095,112 @@ void loop() {
  
 ```
 
+### `server.accept()`
+
+#### Description
+
+The traditional server.available() function would only tell you of a new client after it sent data, which makes some protocols like FTP impossible to properly implement.
+
+The intention is programs will use either available() or accept(), but not both. With available(), the client connection continues to be managed by WiFiServer. You don’t need to keep a client object, since calling available() will give you whatever client has sent data. Simple servers can be written with very little code using available().
+
+With accept(), WiFiServer gives you the client only once, regardless of whether it has sent any data. You must keep track of the connected clients. This requires more code, but you gain more control.
+
+
+#### Syntax
+
+```
+server.accept()
+
+```
+
+#### Parameters
+none
+
+#### Returns
+- a Client object. If no client has data available for reading, this object will evaluate to false in an if-statement. (WiFiClient).
+
+#### Example
+
+```
+#include <SPI.h>
+#include <WiFiNINA.h>
+
+char ssid[] = "Network";          //  your network SSID (name)
+char pass[] = "myPassword";   // your network password
+
+int status = WL_IDLE_STATUS;
+
+// telnet defaults to port 23
+WiFiServer server(23);
+
+WiFiClient clients[8];
+
+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
+  }
+
+  // attempt to connect to WiFi network:
+  status = WiFi.begin(ssid, pass);
+  if ( status != WL_CONNECTED) {
+    Serial.println("Couldn't get a WiFi connection");
+    while(true);
+  }
+
+  // start the server:
+  server.begin();
+
+  Serial.print("Chat server address:");
+  Serial.println(WiFi.localIP());
+}
+
+void loop() {
+  // check for any new client connecting, and say hello (before any incoming data)
+  WiFiClient newClient = server.accept();
+  if (newClient) {
+    for (byte i=0; i < 8; i++) {
+      if (!clients[i]) {
+        Serial.print("We have a new client #");
+        Serial.println(i);
+        newClient.print("Hello, client number: ");
+        newClient.println(i);
+        // Once we "accept", the client is no longer tracked by WiFiServer
+        // so we must store it into our list of clients
+        clients[i] = newClient;
+        break;
+      }
+    }
+  }
+
+  // check for incoming data from all clients
+  for (byte i=0; i < 8; i++) {
+    if (clients[i] && clients[i].available() > 0) {
+      // read bytes from a client
+      byte buffer[80];
+      int count = clients[i].read(buffer, 80);
+      // write the bytes to all other connected clients
+      for (byte j=0; j < 8; j++) {
+        if (j != i && clients[j].connected()) {
+          clients[j].write(buffer, count);
+        }
+      }
+    }
+  }
+
+  // stop any clients which disconnect
+  for (byte i=0; i < 8; i++) {
+    if (clients[i] && !clients[i].connected()) {
+      Serial.print("disconnect client #");
+      Serial.println(i);
+      clients[i].stop();
+    }
+  }
+
+}
+```
+
 ### `server.peek()`
 
 #### Description