v1.9.3 to add support to Seeeduino nRF52

### Releases v1.9.3

1. Add support to Seeeduino nRF52840-based boards such as **Seeed XIAO_NRF52840 and XIAO_NRF52840_SENSE**, etc. using Seeed `mbed` or `nRF52` core
2. Add astyle using `allman` style. Restyle the library
3. Display warning only when `_ETHERNET_WEBSERVER_LOGLEVEL_` > 3
4. Update examples
5. Update `Packages' Patches` to add Seeeduino `nRF52` core

Author: khoih-prog

src/SSLClient/SSLClient.h

@@ -33,7 +33,7 @@
    Check out README.md for more info.
 */
 
-class EthernetSSLClient : public Client 
+class EthernetSSLClient : public Client
 {
   public:
     /**
@@ -44,7 +44,7 @@ class EthernetSSLClient : public Client
        checking the errors, you can do so with EthernetSSLClient::getWriteError(),
        which will return one of these values.
     */
-    enum Error 
+    enum Error
     {
       SSL_OK = 0,
       /** The underlying client failed to connect, probably not an issue with SSL */
@@ -67,7 +67,7 @@ class EthernetSSLClient : public Client
        Use these values when initializing EthernetSSLClient to set how many logs you
        would like to see in the Serial monitor.
     */
-    enum DebugLevel 
+    enum DebugLevel
     {
       /** No logging output */
       SSL_NONE = 0,
@@ -212,9 +212,9 @@ class EthernetSSLClient : public Client
        fails to become ready for writing data.
     */
     size_t write(const uint8_t *buf, size_t size) override;
-    
+
     /** @see EthernetSSLClient::write(uint8_t*, size_t) */
-    size_t write(uint8_t b) override 
+    size_t write(uint8_t b) override
     {
       return write(&b, 1);
     }
@@ -265,10 +265,10 @@ class EthernetSSLClient : public Client
        @brief Read a single byte, or -1 if none is available.
        @see EthernetSSLClient::read(uint8_t*, size_t)
     */
-    int read() override 
+    int read() override
     {
       uint8_t read_val;
-      
+
       return read(&read_val, 1) > 0 ? read_val : -1;
     };
 
@@ -361,7 +361,7 @@ class EthernetSSLClient : public Client
 
         @returns The SessionCache template parameter.
     */
-    size_t getSessionCount() const 
+    size_t getSessionCount() const
     {
       return m_sessions.size();
     }
@@ -371,13 +371,13 @@ class EthernetSSLClient : public Client
 
        @returns true if connected, false if not
     */
-    operator bool() 
+    operator bool()
     {
       return connected() > 0;
     }
 
     /** @brief Returns a reference to the client object stored in this class. Take care not to break it. */
-    Client& getClient() 
+    Client& getClient()
     {
       return m_client;
     }
@@ -386,7 +386,7 @@ class EthernetSSLClient : public Client
        @brief Set the timeout when waiting for an SSL response.
        @param t The timeout value, in milliseconds (defaults to 30 seconds if not set). Do not set to zero.
     */
-    void setTimeout(unsigned int t) 
+    void setTimeout(unsigned int t)
     {
       m_timeout = t;
     }
@@ -395,33 +395,33 @@ class EthernetSSLClient : public Client
        @brief Get the timeout when waiting for an SSL response.
        @returns The timeout value in milliseconds.
     */
-    unsigned int getTimeout() const 
+    unsigned int getTimeout() const
     {
       return m_timeout;
     }
-    
-		/**
-    @brief Change the time used during x509 verification to a different value.
 
-    This function directly calls br_x509_minimal_set_time to change the validation
-    time used by the minimal verification engine. You can use this function if the default value
-    of the compile time is causing issues. See https://bearssl.org/apidoc/bearssl__x509_8h.html#a7f3558b1999ce904084d578700b1002c
-    for more information what this function does and how to use it.
+    /**
+      @brief Change the time used during x509 verification to a different value.
 
-    @param days Days are counted in a proleptic Gregorian calendar since January 1st, 0 AD.
-    @param seconds Seconds are counted since midnight, from 0 to 86400 (a count of 86400 is possible only if a leap second happened).
+      This function directly calls br_x509_minimal_set_time to change the validation
+      time used by the minimal verification engine. You can use this function if the default value
+      of the compile time is causing issues. See https://bearssl.org/apidoc/bearssl__x509_8h.html#a7f3558b1999ce904084d578700b1002c
+      for more information what this function does and how to use it.
+
+      @param days Days are counted in a proleptic Gregorian calendar since January 1st, 0 AD.
+      @param seconds Seconds are counted since midnight, from 0 to 86400 (a count of 86400 is possible only if a leap second happened).
     */
-    
+
     void setVerificationTime(uint32_t days, uint32_t seconds);
 
   private:
     /** @brief Returns an instance of m_client that is polymorphic and can be used by EthernetSSLClient */
-    Client& get_arduino_client() 
+    Client& get_arduino_client()
     {
       return m_client;
     }
-    
-    const Client& get_arduino_client() const 
+
+    const Client& get_arduino_client() const
     {
       return m_client;
     }
@@ -451,12 +451,12 @@ class EthernetSSLClient : public Client
 
     /** @brief debugging print function, only prints if m_debug is true */
     template<typename T>
-    void m_print(const T str, const char* func_name, const DebugLevel level) const 
+    void m_print(const T str, const char* func_name, const DebugLevel level) const
     {
       // check the current debug level and serial status
-      if (level > m_debug || !Serial) 
+      if (level > m_debug || !Serial)
         return;
-        
+
       // print prefix
       m_print_prefix(func_name, level);
       // print the message
@@ -465,19 +465,19 @@ class EthernetSSLClient : public Client
 
     /** @brief Prints a info message to serial, if info messages are enabled */
     template<typename T>
-    void m_info(const T str, const char* func_name) const 
+    void m_info(const T str, const char* func_name) const
     {
       m_print(str, func_name, SSL_INFO);
     }
 
     template<typename T>
-    void m_warn(const T str, const char* func_name) const 
+    void m_warn(const T str, const char* func_name) const
     {
       m_print(str, func_name, SSL_WARN);
     }
 
     template<typename T>
-    void m_error(const T str, const char* func_name) const 
+    void m_error(const T str, const char* func_name) const
     {
       m_print(str, func_name, SSL_ERROR);
     }
@@ -487,7 +487,7 @@ class EthernetSSLClient : public Client
     //============================================
     // create a reference the client
     Client& m_client;
-    
+
     // also store an array of SSLSessions, so we can resume communication with multiple websites
     std::vector<SSLSession> m_sessions;
     // as well as the maximmum number of sessions we can store
@@ -520,7 +520,7 @@ class EthernetSSLClient : public Client
     unsigned char m_iobuf[2048];
     //unsigned char m_iobuf[4096];
     //////
-    
+
     // store the index of where we are writing in the buffer
     // so we can send our records all at once to prevent
     // weird timing issues

src/SSLClient/SSLClientParameters.cpp

@@ -27,19 +27,19 @@
 
 #include "SSLClient/SSLClientParameters.h"
 
-struct ssl_pem_decode_state 
+struct ssl_pem_decode_state
 {
   std::vector<char>* vect;
   size_t index = 0;
 };
 
-static void ssl_pem_decode_callback(void *dest_ctx, const void *src, size_t len) 
+static void ssl_pem_decode_callback(void *dest_ctx, const void *src, size_t len)
 {
   ssl_pem_decode_state* ctx = static_cast<ssl_pem_decode_state*>(dest_ctx);
-  
-  for (size_t i = 0; i < len; i++) 
+
+  for (size_t i = 0; i < len; i++)
     ctx->vect->emplace_back(static_cast<const char*>(src)[i]);
-    
+
   // update index
   ctx->index += len;
 }
@@ -52,50 +52,55 @@ static void ssl_pem_decode_callback(void *dest_ctx, const void *src, size_t len)
    @param len Number of characters to process, MUST include a whole certificate.
    @return A vector of bytes representing the certificate in DER format.
 */
-static std::vector<char> make_vector_pem(const char* data, const size_t len) 
+static std::vector<char> make_vector_pem(const char* data, const size_t len)
 {
-  if (data == nullptr || len < 80) 
+  if (data == nullptr || len < 80)
     return {};
-    
+
   // initialize the bearssl PEM context
   br_pem_decoder_context pctx;
+
   br_pem_decoder_init(&pctx);
-  
+
   // create a temporary vector
   std::vector<char> temp;
+
   // initialize the DER storage context
   ssl_pem_decode_state state;
+
   state.vect = &temp;
+
   state.index = 0;
-  
+
   // set the byte reciever
   br_pem_decoder_setdest(&pctx, &ssl_pem_decode_callback, &state);
-  
+
   // start decoding!
   int br_state = 0;
+
   size_t index = 0;
-  
-  do 
+
+  do
   {
     index += br_pem_decoder_push(&pctx, static_cast<const void*>(&data[index]), len - index);
     br_state = br_pem_decoder_event(&pctx);
-    
+
     // if we found the begining object, reserve the vector based on the remaining relavent bytes
-    if (br_state == BR_PEM_BEGIN_OBJ) 
+    if (br_state == BR_PEM_BEGIN_OBJ)
     {
       // 22 = five dashes for header and footer + four newlines - character difference between `BEGIN` and `END`
       const size_t relavant_bytes_base64 = len - (2 * strlen(br_pem_decoder_name(&pctx)) + 22);
       temp.reserve(relavant_bytes_base64 * 3 / 4);
     }
   } while (br_state != BR_PEM_ERROR && br_state != BR_PEM_END_OBJ && len != index);
-  
+
   // error check
-  if (br_state == BR_PEM_ERROR) 
+  if (br_state == BR_PEM_ERROR)
   {
     // set data to error
     temp.clear();
   }
-  
+
   // else we're good!
   return temp;
 }
@@ -108,30 +113,33 @@ static std::vector<char> make_vector_pem(const char* data, const size_t len)
    @returns context used by BearSSL to store information about the keys. You can
    use the br_skey_* family of APIs to access information from this context.
 */
-static br_skey_decoder_context make_key_from_der(const std::vector<char>& der) 
+static br_skey_decoder_context make_key_from_der(const std::vector<char>& der)
 {
   br_skey_decoder_context out;
   br_skey_decoder_init(&out);
   br_skey_decoder_push(&out, der.data(), der.size());
-  
+
   return out;
 }
 
 /* See SSLClientParams.h */
-SSLClientParameters::SSLClientParameters(const char* cert, const size_t cert_len, const char* key, const size_t key_len, bool is_der)
+SSLClientParameters::SSLClientParameters(const char* cert, const size_t cert_len, const char* key, const size_t key_len,
+                                         bool is_der)
   : m_cert(is_der ? std::vector<char>(cert, cert + cert_len) : make_vector_pem(cert, cert_len))
   , m_cert_struct{ const_cast<unsigned char*>(reinterpret_cast<const unsigned char*>(m_cert.data())), m_cert.size() }
-  , m_key_struct( make_key_from_der( is_der ? std::vector<char>(key, key + key_len) : make_vector_pem(key, key_len) ) ) 
+  , m_key_struct( make_key_from_der( is_der ? std::vector<char>(key, key + key_len) : make_vector_pem(key, key_len) ) )
 {}
 
 /* See SSLClientParams.h */
-SSLClientParameters SSLClientParameters::fromPEM(const char* cert_pem, const size_t cert_len, const char* key_pem, const size_t key_len) 
+SSLClientParameters SSLClientParameters::fromPEM(const char* cert_pem, const size_t cert_len, const char* key_pem,
+                                                 const size_t key_len)
 {
   return SSLClientParameters(cert_pem, cert_len, key_pem, key_len, false);
 }
 
 /* See SSLClientParams.h */
-SSLClientParameters SSLClientParameters::fromDER(const char* cert_der, const size_t cert_len, const char* key_der, const size_t key_len) 
+SSLClientParameters SSLClientParameters::fromDER(const char* cert_der, const size_t cert_len, const char* key_der,
+                                                 const size_t key_len)
 {
   return SSLClientParameters(cert_der, cert_len, key_der, key_len, true);
 }

src/SSLClient/SSLClientParameters.h

@@ -48,7 +48,7 @@
    ECC certificates if possible, as SSLClientParameters will make a copy of both the
    certificate and the private key in memory, and ECC keys tend to be smaller than RSA ones.
 */
-class SSLClientParameters 
+class SSLClientParameters
 {
   public:
     /**
@@ -81,7 +81,8 @@ class SSLClientParameters
        @param key_len The number of bytes in key_pem
        @return An SSLClientParameters context, to be used with SSLClient::setMutualAuthParams.
     */
-    static SSLClientParameters fromPEM(const char* cert_pem, const size_t cert_len, const char* key_pem, const size_t key_len);
+    static SSLClientParameters fromPEM(const char* cert_pem, const size_t cert_len, const char* key_pem,
+                                       const size_t key_len);
 
     /**
        @brief Create mutual authentication parameters from a DER certificate and private key
@@ -109,28 +110,29 @@ class SSLClientParameters
        @param key_len The number of bytes in key_ders
        @return An SSLClientParameters context, to be used with SSLClient::setMutualAuthParams.
     */
-    static SSLClientParameters fromDER(const char* cert_der, const size_t cert_len, const char* key_der, const size_t key_len);
+    static SSLClientParameters fromDER(const char* cert_der, const size_t cert_len, const char* key_der,
+                                       const size_t key_len);
 
     /** mTLS information used by SSLClient during authentication */
-    const br_x509_certificate* getCertChain() const 
+    const br_x509_certificate* getCertChain() const
     {
       return &m_cert_struct;
     }
 
     /** mTLS information used by SSLClient during authentication */
-    int getCertType() const 
+    int getCertType() const
     {
       return br_skey_decoder_key_type(&m_key_struct);
     }
 
     /** mTLS information used by SSLClient during authentication */
-    const br_ec_private_key* getECKey() const 
+    const br_ec_private_key* getECKey() const
     {
       return br_skey_decoder_get_ec(&m_key_struct);
     }
 
     /** mTLS information used by SSLClient during authentication */
-    const br_rsa_private_key* getRSAKey() const 
+    const br_rsa_private_key* getRSAKey() const
     {
       return br_skey_decoder_get_rsa(&m_key_struct);
     }