Merge branch 'main' into main

libraries/WiFiS3/src/Modem.h

@@ -108,12 +108,9 @@ class ModemClass {
    * to be read is considered for processing.
    */
   void read_using_size() {
-    read_by_size = true;
-  } 
-
-  /**
-   * @brief Flag indicating whether the system has been initialized.
-   */
+    // read_by_size = true; // deprecated
+  }
+
   bool beginned;
 
   /* Calling this function with no argument will enable debug message to be printed

libraries/WiFiS3/src/WiFi.h

@@ -83,9 +83,21 @@ class CWifi {
      */
     int begin(const char* ssid);
 
-    /** 
-     * @brief start WiFi connection with passphrase the most secure
-     * supported mode will be automatically selected.
+    /*
+     * PING
+     */
+    int ping(IPAddress ip, uint8_t ttl = 128, uint8_t count = 1);
+    int ping(const String &hostname, uint8_t ttl = 128, uint8_t count = 1);
+    int ping(const char* host, uint8_t ttl = 128, uint8_t count = 1);
+
+    /*
+     * Start WiFi connection for OPEN networks
+     * param ssid: Pointer to the SSID string.
+     */
+    int begin(const char* ssid);
+
+    /* Start WiFi connection with passphrase
+     * the most secure supported mode will be automatically selected
      *
      * @param `ssid` Pointer to the SSID string.
      * @param `passphrase` Passphrase. Valid characters in a passphrase
@@ -186,7 +198,7 @@ class CWifi {
      * @param `subnet` The static subnet mask to use for the network.
      */
     void config(IPAddress local_ip, IPAddress dns_server, IPAddress gateway, IPAddress subnet);
-    
+
     /**
      * @brief Sets the primary DNS server for the Wi-Fi connection.
      *
@@ -221,7 +233,6 @@ class CWifi {
      */
     void end(void);
 
-
     /**
      * @brief Retrieves the MAC address of the device.
      * 
@@ -232,7 +243,7 @@ class CWifi {
      * 
      * @param `_mac` A pointer to a uint8_t array where the MAC address will be stored.
      * 
-     * @return uint8_t* The pointer to the array containing the MAC address.
+     * @return uint8_t* The pointer to the array with length WL_MAC_ADDR_LENGTH.
      */
     uint8_t* macAddress(uint8_t* mac);
 
@@ -277,7 +288,6 @@ class CWifi {
     */
    IPAddress dnsIP(int n = 0);
 
-
     /**
      * @brief Retrieves the IP address of the soft access point (AP).
      *