v1.5.0 to fix multiple-definitions linker error

### Releases v1.5.0

1. Fix `multiple-definitions` linker error and weird bug related to `src_cpp`. Check [Different behaviour using the src_cpp or src_h lib #80](https://github.com/khoih-prog/ESPAsync_WiFiManager/discussions/80)
2. Optimize library code by using `reference-passing` instead of `value-passing`
3. Update all examples

CONTRIBUTING.md

@@ -14,8 +14,8 @@ If you don't find anything, please [open a new issue](https://github.com/khoih-p
 
 Please ensure to specify the following:
 
-* Arduino IDE version (e.g. 1.8.16) or Platform.io version
-* `ESP8266`,`ESP32` or `STM32` Core Version (e.g. ESP8266 core v3.0.2, ESP32 v2.0.1 or STM32 v2.1.0)
+* Arduino IDE version (e.g. 1.8.19) or Platform.io version
+* `ESP8266`,`ESP32` or `STM32` Core Version (e.g. ESP8266 core v3.0.2, ESP32 v2.0.2 or STM32 v2.2.0)
 * Contextual information (e.g. what you were trying to achieve)
 * Simplest possible steps to reproduce
 * Anything that might be relevant in your opinion, such as:
@@ -26,10 +26,10 @@ Please ensure to specify the following:
 ### Example
 
 ```
-Arduino IDE version: 1.8.16
-ESP32 Core Version 2.0.1
+Arduino IDE version: 1.8.19
+ESP32 Core Version 2.0.2
 OS: Ubuntu 20.04 LTS
-Linux xy-Inspiron-3593 5.4.0-90-generic #101-Ubuntu SMP Fri Oct 15 20:00:55 UTC 2021 x86_64 x86_64 x86_64 GNU/Linux
+Linux xy-Inspiron-3593 5.4.0-91-generic #102-Ubuntu SMP Fri Nov 5 16:31:28 UTC 2021 x86_64 x86_64 x86_64 GNU/Linux
 
 Context:
 I encountered an endless loop while trying to connect to Local WiFi.

Packages_Patches/Maixduino/hardware/k210/0.3.10/cores/arduino/Stream.h

@@ -0,0 +1,129 @@
+/*
+  Stream.h - base class for character-based streams.
+  Copyright (c) 2010 David A. Mellis.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
+  parsing functions based on TextFinder library by Michael Margolis
+*/
+
+#ifndef Stream_h
+#define Stream_h
+
+#include <inttypes.h>
+#include "Print.h"
+
+// compatability macros for testing
+/*
+#define   getInt()            parseInt()
+#define   getInt(ignore)    parseInt(ignore)
+#define   getFloat()          parseFloat()
+#define   getFloat(ignore)  parseFloat(ignore)
+#define   getString( pre_string, post_string, buffer, length)
+readBytesBetween( pre_string, terminator, buffer, length)
+*/
+
+// This enumeration provides the lookahead options for parseInt(), parseFloat()
+// The rules set out here are used until either the first valid character is found
+// or a time out occurs due to lack of input.
+enum LookaheadMode{
+    SKIP_ALL,       // All invalid characters are ignored.
+    SKIP_NONE,      // Nothing is skipped, and the stream is not touched unless the first waiting character is valid.
+    SKIP_WHITESPACE // Only tabs, spaces, line feeds & carriage returns are skipped.
+};
+
+#define NO_IGNORE_CHAR  '\x01' // a char not found in a valid ASCII numeric field
+
+class Stream : public Print
+{
+  protected:
+    unsigned long _timeout;      // number of milliseconds to wait for the next char before aborting timed read
+    unsigned long _startMillis = 0;  // used for timeout measurement
+    int timedRead();    // read stream with timeout
+    int timedPeek();    // peek stream with timeout
+    int peekNextDigit(LookaheadMode lookahead, bool detectDecimal); // returns the next numeric digit in the stream or -1 if timeout
+
+  public:
+    virtual int available() = 0;
+    virtual int read() = 0;
+    virtual int peek() = 0;
+
+    Stream() {_timeout=1000;}
+
+// parsing methods
+
+  void setTimeout(unsigned long timeout);  // sets maximum milliseconds to wait for stream data, default is 1 second
+  unsigned long getTimeout(void) { return _timeout; }
+  
+  bool find(char *target);   // reads data from the stream until the target string is found
+  bool find(uint8_t *target) { return find ((char *)target); }
+  // returns true if target string is found, false if timed out (see setTimeout)
+
+  bool find(char *target, size_t length);   // reads data from the stream until the target string of given length is found
+  bool find(uint8_t *target, size_t length) { return find ((char *)target, length); }
+  // returns true if target string is found, false if timed out
+
+  bool find(char target) { return find (&target, 1); }
+
+  bool findUntil(char *target, char *terminator);   // as find but search ends if the terminator string is found
+  bool findUntil(uint8_t *target, char *terminator) { return findUntil((char *)target, terminator); }
+
+  bool findUntil(char *target, size_t targetLen, char *terminate, size_t termLen);   // as above but search ends if the terminate string is found
+  bool findUntil(uint8_t *target, size_t targetLen, char *terminate, size_t termLen) {return findUntil((char *)target, targetLen, terminate, termLen); }
+
+  long parseInt(LookaheadMode lookahead = SKIP_ALL, char ignore = NO_IGNORE_CHAR);
+  // returns the first valid (long) integer value from the current position.
+  // lookahead determines how parseInt looks ahead in the stream.
+  // See LookaheadMode enumeration at the top of the file.
+  // Lookahead is terminated by the first character that is not a valid part of an integer.
+  // Once parsing commences, 'ignore' will be skipped in the stream.
+
+  float parseFloat(LookaheadMode lookahead = SKIP_ALL, char ignore = NO_IGNORE_CHAR);
+  // float version of parseInt
+
+  size_t readBytes( char *buffer, size_t length); // read chars from stream into buffer
+  size_t readBytes( uint8_t *buffer, size_t length) { return readBytes((char *)buffer, length); }
+  // terminates if length characters have been read or timeout (see setTimeout)
+  // returns the number of characters placed in the buffer (0 means no valid data found)
+
+  size_t readBytesUntil( char terminator, char *buffer, size_t length); // as readBytes with terminator character
+  size_t readBytesUntil( char terminator, uint8_t *buffer, size_t length) { return readBytesUntil(terminator, (char *)buffer, length); }
+  // terminates if length characters have been read, timeout, or if the terminator character  detected
+  // returns the number of characters placed in the buffer (0 means no valid data found)
+
+  // Arduino String functions to be added here
+  String readString();
+  String readStringUntil(char terminator);
+
+  protected:
+  long parseInt(char ignore) { return parseInt(SKIP_ALL, ignore); }
+  float parseFloat(char ignore) { return parseFloat(SKIP_ALL, ignore); }
+  // These overload exists for compatibility with any class that has derived
+  // Stream and used parseFloat/Int with a custom ignore character. To keep
+  // the public API simple, these overload remains protected.
+
+  struct MultiTarget {
+    const char *str;  // string you're searching for
+    size_t len;       // length of string you're searching for
+    size_t index;     // index used by the search routine.
+  };
+
+  // This allows you to search for an arbitrary number of strings.
+  // Returns index of the target that is found first or -1 if timeout occurs.
+  int findMulti(struct MultiTarget *targets, int tCount);
+};
+
+#undef NO_IGNORE_CHAR
+#endif

Packages_Patches/Maixduino/hardware/k210/0.3.11/cores/arduino/Stream.h

@@ -0,0 +1,129 @@
+/*
+  Stream.h - base class for character-based streams.
+  Copyright (c) 2010 David A. Mellis.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
+  parsing functions based on TextFinder library by Michael Margolis
+*/
+
+#ifndef Stream_h
+#define Stream_h
+
+#include <inttypes.h>
+#include "Print.h"
+
+// compatability macros for testing
+/*
+#define   getInt()            parseInt()
+#define   getInt(ignore)    parseInt(ignore)
+#define   getFloat()          parseFloat()
+#define   getFloat(ignore)  parseFloat(ignore)
+#define   getString( pre_string, post_string, buffer, length)
+readBytesBetween( pre_string, terminator, buffer, length)
+*/
+
+// This enumeration provides the lookahead options for parseInt(), parseFloat()
+// The rules set out here are used until either the first valid character is found
+// or a time out occurs due to lack of input.
+enum LookaheadMode{
+    SKIP_ALL,       // All invalid characters are ignored.
+    SKIP_NONE,      // Nothing is skipped, and the stream is not touched unless the first waiting character is valid.
+    SKIP_WHITESPACE // Only tabs, spaces, line feeds & carriage returns are skipped.
+};
+
+#define NO_IGNORE_CHAR  '\x01' // a char not found in a valid ASCII numeric field
+
+class Stream : public Print
+{
+  protected:
+    unsigned long _timeout;      // number of milliseconds to wait for the next char before aborting timed read
+    unsigned long _startMillis = 0;  // used for timeout measurement
+    int timedRead();    // read stream with timeout
+    int timedPeek();    // peek stream with timeout
+    int peekNextDigit(LookaheadMode lookahead, bool detectDecimal); // returns the next numeric digit in the stream or -1 if timeout
+
+  public:
+    virtual int available() = 0;
+    virtual int read() = 0;
+    virtual int peek() = 0;
+
+    Stream() {_timeout=1000;}
+
+// parsing methods
+
+  void setTimeout(unsigned long timeout);  // sets maximum milliseconds to wait for stream data, default is 1 second
+  unsigned long getTimeout(void) { return _timeout; }
+  
+  bool find(char *target);   // reads data from the stream until the target string is found
+  bool find(uint8_t *target) { return find ((char *)target); }
+  // returns true if target string is found, false if timed out (see setTimeout)
+
+  bool find(char *target, size_t length);   // reads data from the stream until the target string of given length is found
+  bool find(uint8_t *target, size_t length) { return find ((char *)target, length); }
+  // returns true if target string is found, false if timed out
+
+  bool find(char target) { return find (&target, 1); }
+
+  bool findUntil(char *target, char *terminator);   // as find but search ends if the terminator string is found
+  bool findUntil(uint8_t *target, char *terminator) { return findUntil((char *)target, terminator); }
+
+  bool findUntil(char *target, size_t targetLen, char *terminate, size_t termLen);   // as above but search ends if the terminate string is found
+  bool findUntil(uint8_t *target, size_t targetLen, char *terminate, size_t termLen) {return findUntil((char *)target, targetLen, terminate, termLen); }
+
+  long parseInt(LookaheadMode lookahead = SKIP_ALL, char ignore = NO_IGNORE_CHAR);
+  // returns the first valid (long) integer value from the current position.
+  // lookahead determines how parseInt looks ahead in the stream.
+  // See LookaheadMode enumeration at the top of the file.
+  // Lookahead is terminated by the first character that is not a valid part of an integer.
+  // Once parsing commences, 'ignore' will be skipped in the stream.
+
+  float parseFloat(LookaheadMode lookahead = SKIP_ALL, char ignore = NO_IGNORE_CHAR);
+  // float version of parseInt
+
+  size_t readBytes( char *buffer, size_t length); // read chars from stream into buffer
+  size_t readBytes( uint8_t *buffer, size_t length) { return readBytes((char *)buffer, length); }
+  // terminates if length characters have been read or timeout (see setTimeout)
+  // returns the number of characters placed in the buffer (0 means no valid data found)
+
+  size_t readBytesUntil( char terminator, char *buffer, size_t length); // as readBytes with terminator character
+  size_t readBytesUntil( char terminator, uint8_t *buffer, size_t length) { return readBytesUntil(terminator, (char *)buffer, length); }
+  // terminates if length characters have been read, timeout, or if the terminator character  detected
+  // returns the number of characters placed in the buffer (0 means no valid data found)
+
+  // Arduino String functions to be added here
+  String readString();
+  String readStringUntil(char terminator);
+
+  protected:
+  long parseInt(char ignore) { return parseInt(SKIP_ALL, ignore); }
+  float parseFloat(char ignore) { return parseFloat(SKIP_ALL, ignore); }
+  // These overload exists for compatibility with any class that has derived
+  // Stream and used parseFloat/Int with a custom ignore character. To keep
+  // the public API simple, these overload remains protected.
+
+  struct MultiTarget {
+    const char *str;  // string you're searching for
+    size_t len;       // length of string you're searching for
+    size_t index;     // index used by the search routine.
+  };
+
+  // This allows you to search for an arbitrary number of strings.
+  // Returns index of the target that is found first or -1 if timeout occurs.
+  int findMulti(struct MultiTarget *targets, int tCount);
+};
+
+#undef NO_IGNORE_CHAR
+#endif

Packages_Patches/STM32/hardware/stm32/2.1.0/system/STM32F4xx/stm32f4xx_hal_conf_default.h

@@ -237,7 +237,7 @@ in voltage and temperature. */
 //#define LAN8742A_PHY_ADDRESS            0x00U
 /* Section 2: PHY configuration section */
 #if !defined  (LAN8742A_PHY_ADDRESS)
-  /* LAN8742A PHY Address*/
+  /* KH, LAN8742A PHY Address*/
   #define LAN8742A_PHY_ADDRESS            0x00U
 #endif
 ////////////////////////////////

Packages_Patches/STM32/hardware/stm32/2.1.0/system/STM32F7xx/stm32f7xx_hal_conf_default.h

@@ -232,7 +232,7 @@ in voltage and temperature.  */
 //#define LAN8742A_PHY_ADDRESS            0x00U
 /* Section 2: PHY configuration section */
 #if !defined  (LAN8742A_PHY_ADDRESS)
-  /* LAN8742A PHY Address*/
+  /* KH, LAN8742A PHY Address*/
   #define LAN8742A_PHY_ADDRESS            0x00U
 #endif
 ////////////////////////////////

Packages_Patches/STM32/hardware/stm32/2.2.0/system/STM32F4xx/stm32f4xx_hal_conf_default.h

@@ -0,0 +1,519 @@
+/**
+  ******************************************************************************
+  * @file    stm32f4xx_hal_conf_default.h
+  * @brief   HAL default configuration file.
+  ******************************************************************************
+  * @attention
+  *
+  * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
+  * All rights reserved.</center></h2>
+  *
+  * This software component is licensed by ST under BSD 3-Clause license,
+  * the "License"; You may not use this file except in compliance with the
+  * License. You may obtain a copy of the License at:
+  *                        opensource.org/licenses/BSD-3-Clause
+  *
+  ******************************************************************************
+  */
+
+/* Define to prevent recursive inclusion -------------------------------------*/
+#ifndef __STM32F4xx_HAL_CONF_DEFAULT_H
+#define __STM32F4xx_HAL_CONF_DEFAULT_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Exported types ------------------------------------------------------------*/
+/* Exported constants --------------------------------------------------------*/
+
+/* ########################## Module Selection ############################## */
+/**
+  * @brief Include the default list of modules to be used in the HAL driver
+  *        and manage module deactivation
+  */
+#include "stm32yyxx_hal_conf.h"
+#if 0
+/**
+  * @brief This is the list of modules to be used in the HAL driver
+  */
+#define HAL_MODULE_ENABLED
+#define HAL_ADC_MODULE_ENABLED
+#define HAL_CAN_MODULE_ENABLED
+/*#define HAL_CAN_LEGACY_MODULE_ENABLED*/
+#define HAL_CRC_MODULE_ENABLED
+#define HAL_CEC_MODULE_ENABLED
+#define HAL_CRYP_MODULE_ENABLED
+#define HAL_DAC_MODULE_ENABLED
+#define HAL_DCMI_MODULE_ENABLED
+#define HAL_DMA_MODULE_ENABLED
+#define HAL_DMA2D_MODULE_ENABLED
+#define HAL_ETH_MODULE_ENABLED
+#define HAL_FLASH_MODULE_ENABLED
+#define HAL_NAND_MODULE_ENABLED
+#define HAL_NOR_MODULE_ENABLED
+#define HAL_PCCARD_MODULE_ENABLED
+#define HAL_SRAM_MODULE_ENABLED
+#define HAL_SDRAM_MODULE_ENABLED
+#define HAL_HASH_MODULE_ENABLED
+#define HAL_GPIO_MODULE_ENABLED
+#define HAL_EXTI_MODULE_ENABLED
+#define HAL_I2C_MODULE_ENABLED
+#define HAL_SMBUS_MODULE_ENABLED
+#define HAL_I2S_MODULE_ENABLED
+#define HAL_IWDG_MODULE_ENABLED
+#define HAL_LTDC_MODULE_ENABLED
+#define HAL_DSI_MODULE_ENABLED
+#define HAL_PWR_MODULE_ENABLED
+#define HAL_QSPI_MODULE_ENABLED
+#define HAL_RCC_MODULE_ENABLED
+#define HAL_RNG_MODULE_ENABLED
+#define HAL_RTC_MODULE_ENABLED
+#define HAL_SAI_MODULE_ENABLED
+#define HAL_SD_MODULE_ENABLED
+#define HAL_SPI_MODULE_ENABLED
+#define HAL_TIM_MODULE_ENABLED
+#define HAL_UART_MODULE_ENABLED
+#define HAL_USART_MODULE_ENABLED
+#define HAL_IRDA_MODULE_ENABLED
+#define HAL_SMARTCARD_MODULE_ENABLED
+#define HAL_WWDG_MODULE_ENABLED
+#define HAL_CORTEX_MODULE_ENABLED
+#define HAL_PCD_MODULE_ENABLED
+#define HAL_HCD_MODULE_ENABLED
+#define HAL_FMPI2C_MODULE_ENABLED
+#define HAL_FMPSMBUS_MODULE_ENABLED
+#define HAL_SPDIFRX_MODULE_ENABLED
+#define HAL_DFSDM_MODULE_ENABLED
+#define HAL_LPTIM_MODULE_ENABLED
+#define HAL_MMC_MODULE_ENABLED
+#endif
+
+/* ########################## HSE/HSI Values adaptation ##################### */
+/**
+  * @brief Adjust the value of External High Speed oscillator (HSE) used in your application.
+  *        This value is used by the RCC HAL module to compute the system frequency
+  *        (when HSE is used as system clock source, directly or through the PLL).
+  */
+#if !defined  (HSE_VALUE)
+#define HSE_VALUE              8000000U /*!< Value of the External oscillator in Hz */
+#endif /* HSE_VALUE */
+
+#if !defined  (HSE_STARTUP_TIMEOUT)
+#define HSE_STARTUP_TIMEOUT    100U      /*!< Time out for HSE start up, in ms */
+#endif /* HSE_STARTUP_TIMEOUT */
+
+/**
+  * @brief Internal High Speed oscillator (HSI) value.
+  *        This value is used by the RCC HAL module to compute the system frequency
+  *        (when HSI is used as system clock source, directly or through the PLL).
+  */
+#if !defined  (HSI_VALUE)
+#define HSI_VALUE              16000000U /*!< Value of the Internal oscillator in Hz */
+#endif /* HSI_VALUE */
+
+/**
+  * @brief Internal Low Speed oscillator (LSI) value.
+  */
+#if !defined  (LSI_VALUE)
+#define LSI_VALUE               32000U    /*!< LSI Typical Value in Hz */
+#endif /* LSI_VALUE */                     /*!< Value of the Internal Low Speed oscillator in Hz
+The real value may vary depending on the variations
+in voltage and temperature. */
+/**
+  * @brief External Low Speed oscillator (LSE) value.
+  */
+#if !defined  (LSE_VALUE)
+#define LSE_VALUE               32768U    /*!< Value of the External Low Speed oscillator in Hz */
+#endif /* LSE_VALUE */
+
+#if !defined  (LSE_STARTUP_TIMEOUT)
+#define LSE_STARTUP_TIMEOUT    5000U     /*!< Time out for LSE start up, in ms */
+#endif /* LSE_STARTUP_TIMEOUT */
+
+/**
+  * @brief External clock source for I2S peripheral
+  *        This value is used by the I2S HAL module to compute the I2S clock source
+  *        frequency, this source is inserted directly through I2S_CKIN pad.
+  */
+#if !defined  (EXTERNAL_CLOCK_VALUE)
+#define EXTERNAL_CLOCK_VALUE     12288000U /*!< Value of the External oscillator in Hz*/
+#endif /* EXTERNAL_CLOCK_VALUE */
+
+/* Tip: To avoid modifying this file each time you need to use different HSE,
+   ===  you can define the HSE value in your toolchain compiler preprocessor. */
+
+/* ########################### System Configuration ######################### */
+/**
+  * @brief This is the HAL system configuration section
+  */
+#if !defined (VDD_VALUE)
+#define  VDD_VALUE                    3300U /*!< Value of VDD in mv */
+#endif
+#if !defined (TICK_INT_PRIORITY)
+#define  TICK_INT_PRIORITY            0x00U /*!< tick interrupt priority */
+#endif
+#if !defined (USE_RTOS)
+#define  USE_RTOS                     0U
+#endif
+#if !defined (PREFETCH_ENABLE)
+#define  PREFETCH_ENABLE              1U
+#endif
+#if !defined (INSTRUCTION_CACHE_ENABLE)
+#define  INSTRUCTION_CACHE_ENABLE     1U
+#endif
+#if !defined (DATA_CACHE_ENABLE)
+#define  DATA_CACHE_ENABLE            1U
+#endif
+
+#define  USE_HAL_ADC_REGISTER_CALLBACKS         0U /* ADC register callback disabled       */
+#define  USE_HAL_CAN_REGISTER_CALLBACKS         0U /* CAN register callback disabled       */
+#define  USE_HAL_CEC_REGISTER_CALLBACKS         0U /* CEC register callback disabled       */
+#define  USE_HAL_CRYP_REGISTER_CALLBACKS        0U /* CRYP register callback disabled      */
+#define  USE_HAL_DAC_REGISTER_CALLBACKS         0U /* DAC register callback disabled       */
+#define  USE_HAL_DCMI_REGISTER_CALLBACKS        0U /* DCMI register callback disabled      */
+#define  USE_HAL_DFSDM_REGISTER_CALLBACKS       0U /* DFSDM register callback disabled     */
+#define  USE_HAL_DMA2D_REGISTER_CALLBACKS       0U /* DMA2D register callback disabled     */
+#define  USE_HAL_DSI_REGISTER_CALLBACKS         0U /* DSI register callback disabled       */
+#define  USE_HAL_ETH_REGISTER_CALLBACKS         0U /* ETH register callback disabled       */
+#define  USE_HAL_HASH_REGISTER_CALLBACKS        0U /* HASH register callback disabled      */
+#define  USE_HAL_HCD_REGISTER_CALLBACKS         0U /* HCD register callback disabled       */
+#define  USE_HAL_I2C_REGISTER_CALLBACKS         0U /* I2C register callback disabled       */
+#define  USE_HAL_FMPI2C_REGISTER_CALLBACKS      0U /* FMPI2C register callback disabled    */
+#define  USE_HAL_FMPSMBUS_REGISTER_CALLBACKS    0U /* FMPSMBUS register callback disabled  */
+#define  USE_HAL_I2S_REGISTER_CALLBACKS         0U /* I2S register callback disabled       */
+#define  USE_HAL_IRDA_REGISTER_CALLBACKS        0U /* IRDA register callback disabled      */
+#define  USE_HAL_LPTIM_REGISTER_CALLBACKS       0U /* LPTIM register callback disabled     */
+#define  USE_HAL_LTDC_REGISTER_CALLBACKS        0U /* LTDC register callback disabled      */
+#define  USE_HAL_MMC_REGISTER_CALLBACKS         0U /* MMC register callback disabled       */
+#define  USE_HAL_NAND_REGISTER_CALLBACKS        0U /* NAND register callback disabled      */
+#define  USE_HAL_NOR_REGISTER_CALLBACKS         0U /* NOR register callback disabled       */
+#define  USE_HAL_PCCARD_REGISTER_CALLBACKS      0U /* PCCARD register callback disabled    */
+#define  USE_HAL_PCD_REGISTER_CALLBACKS         0U /* PCD register callback disabled       */
+#define  USE_HAL_QSPI_REGISTER_CALLBACKS        0U /* QSPI register callback disabled      */
+#define  USE_HAL_RNG_REGISTER_CALLBACKS         0U /* RNG register callback disabled       */
+#define  USE_HAL_RTC_REGISTER_CALLBACKS         0U /* RTC register callback disabled       */
+#define  USE_HAL_SAI_REGISTER_CALLBACKS         0U /* SAI register callback disabled       */
+#define  USE_HAL_SD_REGISTER_CALLBACKS          0U /* SD register callback disabled        */
+#define  USE_HAL_SMARTCARD_REGISTER_CALLBACKS   0U /* SMARTCARD register callback disabled */
+#define  USE_HAL_SDRAM_REGISTER_CALLBACKS       0U /* SDRAM register callback disabled     */
+#define  USE_HAL_SRAM_REGISTER_CALLBACKS        0U /* SRAM register callback disabled      */
+#define  USE_HAL_SPDIFRX_REGISTER_CALLBACKS     0U /* SPDIFRX register callback disabled   */
+#define  USE_HAL_SMBUS_REGISTER_CALLBACKS       0U /* SMBUS register callback disabled     */
+#define  USE_HAL_SPI_REGISTER_CALLBACKS         0U /* SPI register callback disabled       */
+#define  USE_HAL_TIM_REGISTER_CALLBACKS         0U /* TIM register callback disabled       */
+#define  USE_HAL_UART_REGISTER_CALLBACKS        0U /* UART register callback disabled      */
+#define  USE_HAL_USART_REGISTER_CALLBACKS       0U /* USART register callback disabled     */
+#define  USE_HAL_WWDG_REGISTER_CALLBACKS        0U /* WWDG register callback disabled      */
+
+/* ########################## Assert Selection ############################## */
+/**
+  * @brief Uncomment the line below to expanse the "assert_param" macro in the
+  *        HAL drivers code
+  */
+/* #define USE_FULL_ASSERT    1U */
+
+/* ################## Ethernet peripheral configuration ##################### */
+
+/* Section 1 : Ethernet peripheral configuration */
+
+/* MAC ADDRESS: MAC_ADDR0:MAC_ADDR1:MAC_ADDR2:MAC_ADDR3:MAC_ADDR4:MAC_ADDR5 */
+#define MAC_ADDR0   2U
+#define MAC_ADDR1   0U
+#define MAC_ADDR2   0U
+#define MAC_ADDR3   0U
+#define MAC_ADDR4   0U
+#define MAC_ADDR5   0U
+
+/* Definition of the Ethernet driver buffers size and count */
+#define ETH_RX_BUF_SIZE                ETH_MAX_PACKET_SIZE /* buffer size for receive               */
+#define ETH_TX_BUF_SIZE                ETH_MAX_PACKET_SIZE /* buffer size for transmit              */
+#define ETH_RXBUFNB                    (5U)                /* 5 Rx buffers of size ETH_RX_BUF_SIZE  */
+#define ETH_TXBUFNB                    (5U)                /* 5 Tx buffers of size ETH_TX_BUF_SIZE  */
+
+/* Section 2: PHY configuration section */
+/* LAN8742A PHY Address*/
+////////////////////////////////
+//#define LAN8742A_PHY_ADDRESS            0x00U
+/* Section 2: PHY configuration section */
+#if !defined  (LAN8742A_PHY_ADDRESS)
+  /* KH, LAN8742A PHY Address*/
+  #define LAN8742A_PHY_ADDRESS            0x00U
+#endif
+////////////////////////////////
+/* PHY Reset delay these values are based on a 1 ms Systick interrupt*/
+#define PHY_RESET_DELAY                 0x000000FFU
+/* PHY Configuration delay */
+#define PHY_CONFIG_DELAY                0x00000FFFU
+
+#define PHY_READ_TO                     0x0000FFFFU
+#define PHY_WRITE_TO                    0x0000FFFFU
+
+/* Section 3: Common PHY Registers */
+
+#define PHY_BCR                         ((uint16_t)0x0000)  /*!< Transceiver Basic Control Register   */
+#define PHY_BSR                         ((uint16_t)0x0001)  /*!< Transceiver Basic Status Register    */
+
+#define PHY_RESET                       ((uint16_t)0x8000)  /*!< PHY Reset */
+#define PHY_LOOPBACK                    ((uint16_t)0x4000)  /*!< Select loop-back mode */
+#define PHY_FULLDUPLEX_100M             ((uint16_t)0x2100)  /*!< Set the full-duplex mode at 100 Mb/s */
+#define PHY_HALFDUPLEX_100M             ((uint16_t)0x2000)  /*!< Set the half-duplex mode at 100 Mb/s */
+#define PHY_FULLDUPLEX_10M              ((uint16_t)0x0100)  /*!< Set the full-duplex mode at 10 Mb/s  */
+#define PHY_HALFDUPLEX_10M              ((uint16_t)0x0000)  /*!< Set the half-duplex mode at 10 Mb/s  */
+#define PHY_AUTONEGOTIATION             ((uint16_t)0x1000)  /*!< Enable auto-negotiation function     */
+#define PHY_RESTART_AUTONEGOTIATION     ((uint16_t)0x0200)  /*!< Restart auto-negotiation function    */
+#define PHY_POWERDOWN                   ((uint16_t)0x0800)  /*!< Select the power down mode           */
+#define PHY_ISOLATE                     ((uint16_t)0x0400)  /*!< Isolate PHY from MII                 */
+
+#define PHY_AUTONEGO_COMPLETE           ((uint16_t)0x0020)  /*!< Auto-Negotiation process completed   */
+#define PHY_LINKED_STATUS               ((uint16_t)0x0004)  /*!< Valid link established               */
+#define PHY_JABBER_DETECTION            ((uint16_t)0x0002)  /*!< Jabber condition detected            */
+
+/* Section 4: Extended PHY Registers */
+
+#define PHY_SR                          ((uint16_t)0x1F)    /*!< PHY special control/ status register Offset     */
+
+#define PHY_SPEED_STATUS                ((uint16_t)0x0004)  /*!< PHY Speed mask                                  */
+#define PHY_DUPLEX_STATUS               ((uint16_t)0x0010)  /*!< PHY Duplex mask                                 */
+
+
+#define PHY_ISFR                        ((uint16_t)0x1D)    /*!< PHY Interrupt Source Flag register Offset       */
+#define PHY_IMR                         ((uint16_t)0x1E)    /*!< PHY Interrupt Mask register Offset              */
+#define PHY_ISFR_INT4                   ((uint16_t)0x0010)  /*!< PHY Link down inturrupt                         */
+
+/* ################## SPI peripheral configuration ########################## */
+
+/* CRC FEATURE: Use to activate CRC feature inside HAL SPI Driver
+* Activated: CRC code is present inside driver
+* Deactivated: CRC code cleaned from driver
+*/
+#if !defined (USE_SPI_CRC)
+#define USE_SPI_CRC                     0U
+#endif
+
+/* Includes ------------------------------------------------------------------*/
+/**
+  * @brief Include module's header file
+  */
+
+#ifdef HAL_RCC_MODULE_ENABLED
+#include "stm32f4xx_hal_rcc.h"
+#endif /* HAL_RCC_MODULE_ENABLED */
+
+#ifdef HAL_GPIO_MODULE_ENABLED
+#include "stm32f4xx_hal_gpio.h"
+#endif /* HAL_GPIO_MODULE_ENABLED */
+
+#ifdef HAL_EXTI_MODULE_ENABLED
+#include "stm32f4xx_hal_exti.h"
+#endif /* HAL_EXTI_MODULE_ENABLED */
+
+#ifdef HAL_DMA_MODULE_ENABLED
+#include "stm32f4xx_hal_dma.h"
+#endif /* HAL_DMA_MODULE_ENABLED */
+
+#ifdef HAL_CORTEX_MODULE_ENABLED
+#include "stm32f4xx_hal_cortex.h"
+#endif /* HAL_CORTEX_MODULE_ENABLED */
+
+#ifdef HAL_ADC_MODULE_ENABLED
+#include "stm32f4xx_hal_adc.h"
+#endif /* HAL_ADC_MODULE_ENABLED */
+
+#ifdef HAL_CAN_MODULE_ENABLED
+#include "stm32f4xx_hal_can.h"
+#endif /* HAL_CAN_MODULE_ENABLED */
+
+#ifdef HAL_CAN_LEGACY_MODULE_ENABLED
+#include "stm32f4xx_hal_can_legacy.h"
+#endif /* HAL_CAN_LEGACY_MODULE_ENABLED */
+
+#ifdef HAL_CRC_MODULE_ENABLED
+#include "stm32f4xx_hal_crc.h"
+#endif /* HAL_CRC_MODULE_ENABLED */
+
+#ifdef HAL_CRYP_MODULE_ENABLED
+#include "stm32f4xx_hal_cryp.h"
+#endif /* HAL_CRYP_MODULE_ENABLED */
+
+#ifdef HAL_DMA2D_MODULE_ENABLED
+#include "stm32f4xx_hal_dma2d.h"
+#endif /* HAL_DMA2D_MODULE_ENABLED */
+
+#ifdef HAL_DAC_MODULE_ENABLED
+#include "stm32f4xx_hal_dac.h"
+#endif /* HAL_DAC_MODULE_ENABLED */
+
+#ifdef HAL_DCMI_MODULE_ENABLED
+#include "stm32f4xx_hal_dcmi.h"
+#endif /* HAL_DCMI_MODULE_ENABLED */
+
+#ifdef HAL_ETH_MODULE_ENABLED
+#include "stm32f4xx_hal_eth.h"
+#endif /* HAL_ETH_MODULE_ENABLED */
+
+#ifdef HAL_FLASH_MODULE_ENABLED
+#include "stm32f4xx_hal_flash.h"
+#endif /* HAL_FLASH_MODULE_ENABLED */
+
+#ifdef HAL_SRAM_MODULE_ENABLED
+#include "stm32f4xx_hal_sram.h"
+#endif /* HAL_SRAM_MODULE_ENABLED */
+
+#ifdef HAL_NOR_MODULE_ENABLED
+#include "stm32f4xx_hal_nor.h"
+#endif /* HAL_NOR_MODULE_ENABLED */
+
+#ifdef HAL_NAND_MODULE_ENABLED
+#include "stm32f4xx_hal_nand.h"
+#endif /* HAL_NAND_MODULE_ENABLED */
+
+#ifdef HAL_PCCARD_MODULE_ENABLED
+#include "stm32f4xx_hal_pccard.h"
+#endif /* HAL_PCCARD_MODULE_ENABLED */
+
+#ifdef HAL_SDRAM_MODULE_ENABLED
+#include "stm32f4xx_hal_sdram.h"
+#endif /* HAL_SDRAM_MODULE_ENABLED */
+
+#ifdef HAL_HASH_MODULE_ENABLED
+#include "stm32f4xx_hal_hash.h"
+#endif /* HAL_HASH_MODULE_ENABLED */
+
+#ifdef HAL_I2C_MODULE_ENABLED
+#include "stm32f4xx_hal_i2c.h"
+#endif /* HAL_I2C_MODULE_ENABLED */
+
+#ifdef HAL_SMBUS_MODULE_ENABLED
+#include "stm32f4xx_hal_smbus.h"
+#endif /* HAL_SMBUS_MODULE_ENABLED */
+
+#ifdef HAL_I2S_MODULE_ENABLED
+#include "stm32f4xx_hal_i2s.h"
+#endif /* HAL_I2S_MODULE_ENABLED */
+
+#ifdef HAL_IWDG_MODULE_ENABLED
+#include "stm32f4xx_hal_iwdg.h"
+#endif /* HAL_IWDG_MODULE_ENABLED */
+
+#ifdef HAL_LTDC_MODULE_ENABLED
+#include "stm32f4xx_hal_ltdc.h"
+#endif /* HAL_LTDC_MODULE_ENABLED */
+
+#ifdef HAL_PWR_MODULE_ENABLED
+#include "stm32f4xx_hal_pwr.h"
+#endif /* HAL_PWR_MODULE_ENABLED */
+
+#ifdef HAL_RNG_MODULE_ENABLED
+#include "stm32f4xx_hal_rng.h"
+#endif /* HAL_RNG_MODULE_ENABLED */
+
+#ifdef HAL_RTC_MODULE_ENABLED
+#include "stm32f4xx_hal_rtc.h"
+#endif /* HAL_RTC_MODULE_ENABLED */
+
+#ifdef HAL_SAI_MODULE_ENABLED
+#include "stm32f4xx_hal_sai.h"
+#endif /* HAL_SAI_MODULE_ENABLED */
+
+#ifdef HAL_SD_MODULE_ENABLED
+#include "stm32f4xx_hal_sd.h"
+#endif /* HAL_SD_MODULE_ENABLED */
+
+#ifdef HAL_SPI_MODULE_ENABLED
+#include "stm32f4xx_hal_spi.h"
+#endif /* HAL_SPI_MODULE_ENABLED */
+
+#ifdef HAL_TIM_MODULE_ENABLED
+#include "stm32f4xx_hal_tim.h"
+#endif /* HAL_TIM_MODULE_ENABLED */
+
+#ifdef HAL_UART_MODULE_ENABLED
+#include "stm32f4xx_hal_uart.h"
+#endif /* HAL_UART_MODULE_ENABLED */
+
+#ifdef HAL_USART_MODULE_ENABLED
+#include "stm32f4xx_hal_usart.h"
+#endif /* HAL_USART_MODULE_ENABLED */
+
+#ifdef HAL_IRDA_MODULE_ENABLED
+#include "stm32f4xx_hal_irda.h"
+#endif /* HAL_IRDA_MODULE_ENABLED */
+
+#ifdef HAL_SMARTCARD_MODULE_ENABLED
+#include "stm32f4xx_hal_smartcard.h"
+#endif /* HAL_SMARTCARD_MODULE_ENABLED */
+
+#ifdef HAL_WWDG_MODULE_ENABLED
+#include "stm32f4xx_hal_wwdg.h"
+#endif /* HAL_WWDG_MODULE_ENABLED */
+
+#ifdef HAL_PCD_MODULE_ENABLED
+#include "stm32f4xx_hal_pcd.h"
+#endif /* HAL_PCD_MODULE_ENABLED */
+
+#ifdef HAL_HCD_MODULE_ENABLED
+#include "stm32f4xx_hal_hcd.h"
+#endif /* HAL_HCD_MODULE_ENABLED */
+
+#ifdef HAL_DSI_MODULE_ENABLED
+#include "stm32f4xx_hal_dsi.h"
+#endif /* HAL_DSI_MODULE_ENABLED */
+
+#ifdef HAL_QSPI_MODULE_ENABLED
+#include "stm32f4xx_hal_qspi.h"
+#endif /* HAL_QSPI_MODULE_ENABLED */
+
+#ifdef HAL_CEC_MODULE_ENABLED
+#include "stm32f4xx_hal_cec.h"
+#endif /* HAL_CEC_MODULE_ENABLED */
+
+#ifdef HAL_FMPI2C_MODULE_ENABLED
+#include "stm32f4xx_hal_fmpi2c.h"
+#endif /* HAL_FMPI2C_MODULE_ENABLED */
+
+#ifdef HAL_FMPSMBUS_MODULE_ENABLED
+#include "stm32f4xx_hal_fmpsmbus.h"
+#endif /* HAL_FMPSMBUS_MODULE_ENABLED */
+
+#ifdef HAL_SPDIFRX_MODULE_ENABLED
+#include "stm32f4xx_hal_spdifrx.h"
+#endif /* HAL_SPDIFRX_MODULE_ENABLED */
+
+#ifdef HAL_DFSDM_MODULE_ENABLED
+#include "stm32f4xx_hal_dfsdm.h"
+#endif /* HAL_DFSDM_MODULE_ENABLED */
+
+#ifdef HAL_LPTIM_MODULE_ENABLED
+#include "stm32f4xx_hal_lptim.h"
+#endif /* HAL_LPTIM_MODULE_ENABLED */
+
+#ifdef HAL_MMC_MODULE_ENABLED
+#include "stm32f4xx_hal_mmc.h"
+#endif /* HAL_MMC_MODULE_ENABLED */
+
+/* Exported macro ------------------------------------------------------------*/
+#ifdef  USE_FULL_ASSERT
+/**
+  * @brief  The assert_param macro is used for function's parameters check.
+  * @param  expr If expr is false, it calls assert_failed function
+  *         which reports the name of the source file and the source
+  *         line number of the call that failed.
+  *         If expr is true, it returns no value.
+  * @retval None
+  */
+#define assert_param(expr) ((expr) ? (void)0U : assert_failed((uint8_t *)__FILE__, __LINE__))
+/* Exported functions ------------------------------------------------------- */
+void assert_failed(uint8_t *file, uint32_t line);
+#else
+#define assert_param(expr) ((void)0U)
+#endif /* USE_FULL_ASSERT */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __STM32F4xx_HAL_CONF_DEFAULT_H */
+
+
+/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/

Packages_Patches/STM32/hardware/stm32/2.2.0/system/STM32F7xx/stm32f7xx_hal_conf_default.h

@@ -0,0 +1,511 @@
+/**
+  ******************************************************************************
+  * @file    stm32f7xx_hal_conf_default.h
+  * @brief   HAL default configuration file.
+  ******************************************************************************
+  * @attention
+  *
+  * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
+  * All rights reserved.</center></h2>
+  *
+  * This software component is licensed by ST under BSD 3-Clause license,
+  * the "License"; You may not use this file except in compliance with the
+  * License. You may obtain a copy of the License at:
+  *                        opensource.org/licenses/BSD-3-Clause
+  *
+  ******************************************************************************
+  */
+
+/* Define to prevent recursive inclusion -------------------------------------*/
+#ifndef __STM32F7xx_HAL_CONF_DEFAULT_H
+#define __STM32F7xx_HAL_CONF_DEFAULT_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Exported types ------------------------------------------------------------*/
+/* Exported constants --------------------------------------------------------*/
+
+/* ########################## Module Selection ############################## */
+/**
+  * @brief Include the default list of modules to be used in the HAL driver
+  *        and manage module deactivation
+  */
+#include "stm32yyxx_hal_conf.h"
+#if 0
+/**
+  * @brief This is the list of modules to be used in the HAL driver
+  */
+#define HAL_MODULE_ENABLED
+#define HAL_ADC_MODULE_ENABLED
+#define HAL_CAN_MODULE_ENABLED
+#define HAL_CAN_LEGACY_MODULE_ENABLED
+#define HAL_CEC_MODULE_ENABLED
+#define HAL_CRC_MODULE_ENABLED
+#define HAL_CRYP_MODULE_ENABLED
+#define HAL_DAC_MODULE_ENABLED
+#define HAL_DCMI_MODULE_ENABLED
+#define HAL_DMA_MODULE_ENABLED
+#define HAL_DMA2D_MODULE_ENABLED
+#define HAL_ETH_MODULE_ENABLED
+#define HAL_EXTI_MODULE_ENABLED
+#define HAL_FLASH_MODULE_ENABLED
+#define HAL_NAND_MODULE_ENABLED
+#define HAL_NOR_MODULE_ENABLED
+#define HAL_SRAM_MODULE_ENABLED
+#define HAL_SDRAM_MODULE_ENABLED
+#define HAL_HASH_MODULE_ENABLED
+#define HAL_GPIO_MODULE_ENABLED
+#define HAL_I2C_MODULE_ENABLED
+#define HAL_I2S_MODULE_ENABLED
+#define HAL_IWDG_MODULE_ENABLED
+#define HAL_LPTIM_MODULE_ENABLED
+#define HAL_LTDC_MODULE_ENABLED
+#define HAL_PWR_MODULE_ENABLED
+#define HAL_QSPI_MODULE_ENABLED
+#define HAL_RCC_MODULE_ENABLED
+#define HAL_RNG_MODULE_ENABLED
+#define HAL_RTC_MODULE_ENABLED
+#define HAL_SAI_MODULE_ENABLED
+#define HAL_SD_MODULE_ENABLED
+#define HAL_SPDIFRX_MODULE_ENABLED
+#define HAL_SPI_MODULE_ENABLED
+#define HAL_TIM_MODULE_ENABLED
+#define HAL_UART_MODULE_ENABLED
+#define HAL_USART_MODULE_ENABLED
+#define HAL_IRDA_MODULE_ENABLED
+#define HAL_SMARTCARD_MODULE_ENABLED
+#define HAL_WWDG_MODULE_ENABLED
+#define HAL_CORTEX_MODULE_ENABLED
+#define HAL_PCD_MODULE_ENABLED
+#define HAL_HCD_MODULE_ENABLED
+#define HAL_DFSDM_MODULE_ENABLED
+#define HAL_DSI_MODULE_ENABLED
+#define HAL_JPEG_MODULE_ENABLED
+#define HAL_MDIOS_MODULE_ENABLED
+#define HAL_SMBUS_MODULE_ENABLED
+#define HAL_MMC_MODULE_ENABLED
+#endif
+
+/* ########################## HSE/HSI Values adaptation ##################### */
+/**
+  * @brief Adjust the value of External High Speed oscillator (HSE) used in your application.
+  *        This value is used by the RCC HAL module to compute the system frequency
+  *        (when HSE is used as system clock source, directly or through the PLL).
+  */
+#if !defined  (HSE_VALUE)
+#define HSE_VALUE    25000000U /*!< Value of the External oscillator in Hz */
+#endif /* HSE_VALUE */
+
+#if !defined  (HSE_STARTUP_TIMEOUT)
+#define HSE_STARTUP_TIMEOUT    100U   /*!< Time out for HSE start up, in ms */
+#endif /* HSE_STARTUP_TIMEOUT */
+
+/**
+  * @brief Internal High Speed oscillator (HSI) value.
+  *        This value is used by the RCC HAL module to compute the system frequency
+  *        (when HSI is used as system clock source, directly or through the PLL).
+  */
+#if !defined  (HSI_VALUE)
+#define HSI_VALUE    16000000U /*!< Value of the Internal oscillator in Hz*/
+#endif /* HSI_VALUE */
+
+/**
+  * @brief Internal Low Speed oscillator (LSI) value.
+  */
+#if !defined  (LSI_VALUE)
+#define LSI_VALUE  32000U                  /*!< LSI Typical Value in Hz*/
+#endif /* LSI_VALUE */                      /*!< Value of the Internal Low Speed oscillator in Hz
+The real value may vary depending on the variations
+in voltage and temperature.  */
+/**
+  * @brief External Low Speed oscillator (LSE) value.
+  */
+#if !defined  (LSE_VALUE)
+#define LSE_VALUE  32768U    /*!< Value of the External Low Speed oscillator in Hz */
+#endif /* LSE_VALUE */
+
+#if !defined  (LSE_STARTUP_TIMEOUT)
+#define LSE_STARTUP_TIMEOUT    5000U   /*!< Time out for LSE start up, in ms */
+#endif /* LSE_STARTUP_TIMEOUT */
+
+/**
+  * @brief External clock source for I2S peripheral
+  *        This value is used by the I2S HAL module to compute the I2S clock source
+  *        frequency, this source is inserted directly through I2S_CKIN pad.
+  */
+#if !defined  (EXTERNAL_CLOCK_VALUE)
+#define EXTERNAL_CLOCK_VALUE    12288000U /*!< Value of the Internal oscillator in Hz*/
+#endif /* EXTERNAL_CLOCK_VALUE */
+
+/* Tip: To avoid modifying this file each time you need to use different HSE,
+   ===  you can define the HSE value in your toolchain compiler preprocessor. */
+
+/* ########################### System Configuration ######################### */
+/**
+  * @brief This is the HAL system configuration section
+  */
+#if !defined (VDD_VALUE)
+#define  VDD_VALUE                    3300U /*!< Value of VDD in mv */
+#endif
+#if !defined (TICK_INT_PRIORITY)
+#define  TICK_INT_PRIORITY            0x00U /*!< tick interrupt priority */
+#endif
+#if !defined (USE_RTOS)
+#define  USE_RTOS                     0U
+#endif
+#if !defined (PREFETCH_ENABLE)
+#define  PREFETCH_ENABLE              1U /* To enable prefetch */
+#endif
+#if !defined (ART_ACCLERATOR_ENABLE)
+#define  ART_ACCLERATOR_ENABLE        1U /* To enable ART Accelerator */
+#endif
+
+#define  USE_HAL_ADC_REGISTER_CALLBACKS         0U /* ADC register callback disabled       */
+#define  USE_HAL_CAN_REGISTER_CALLBACKS         0U /* CAN register callback disabled       */
+#define  USE_HAL_CEC_REGISTER_CALLBACKS         0U /* CEC register callback disabled       */
+#define  USE_HAL_CRYP_REGISTER_CALLBACKS        0U /* CRYP register callback disabled      */
+#define  USE_HAL_DAC_REGISTER_CALLBACKS         0U /* DAC register callback disabled       */
+#define  USE_HAL_DCMI_REGISTER_CALLBACKS        0U /* DCMI register callback disabled      */
+#define  USE_HAL_DFSDM_REGISTER_CALLBACKS       0U /* DFSDM register callback disabled     */
+#define  USE_HAL_DMA2D_REGISTER_CALLBACKS       0U /* DMA2D register callback disabled     */
+#define  USE_HAL_DSI_REGISTER_CALLBACKS         0U /* DSI register callback disabled       */
+#define  USE_HAL_ETH_REGISTER_CALLBACKS         0U /* ETH register callback disabled       */
+#define  USE_HAL_HASH_REGISTER_CALLBACKS        0U /* HASH register callback disabled      */
+#define  USE_HAL_HCD_REGISTER_CALLBACKS         0U /* HCD register callback disabled       */
+#define  USE_HAL_I2C_REGISTER_CALLBACKS         0U /* I2C register callback disabled       */
+#define  USE_HAL_I2S_REGISTER_CALLBACKS         0U /* I2S register callback disabled       */
+#define  USE_HAL_IRDA_REGISTER_CALLBACKS        0U /* IRDA register callback disabled      */
+#define  USE_HAL_JPEG_REGISTER_CALLBACKS        0U /* JPEG register callback disabled      */
+#define  USE_HAL_LPTIM_REGISTER_CALLBACKS       0U /* LPTIM register callback disabled     */
+#define  USE_HAL_LTDC_REGISTER_CALLBACKS        0U /* LTDC register callback disabled      */
+#define  USE_HAL_MDIOS_REGISTER_CALLBACKS       0U /* MDIOS register callback disabled     */
+#define  USE_HAL_MMC_REGISTER_CALLBACKS         0U /* MMC register callback disabled       */
+#define  USE_HAL_NAND_REGISTER_CALLBACKS        0U /* NAND register callback disabled      */
+#define  USE_HAL_NOR_REGISTER_CALLBACKS         0U /* NOR register callback disabled       */
+#define  USE_HAL_PCD_REGISTER_CALLBACKS         0U /* PCD register callback disabled       */
+#define  USE_HAL_QSPI_REGISTER_CALLBACKS        0U /* QSPI register callback disabled      */
+#define  USE_HAL_RNG_REGISTER_CALLBACKS         0U /* RNG register callback disabled       */
+#define  USE_HAL_RTC_REGISTER_CALLBACKS         0U /* RTC register callback disabled       */
+#define  USE_HAL_SAI_REGISTER_CALLBACKS         0U /* SAI register callback disabled       */
+#define  USE_HAL_SD_REGISTER_CALLBACKS          0U /* SD register callback disabled        */
+#define  USE_HAL_SMARTCARD_REGISTER_CALLBACKS   0U /* SMARTCARD register callback disabled */
+#define  USE_HAL_SDRAM_REGISTER_CALLBACKS       0U /* SDRAM register callback disabled     */
+#define  USE_HAL_SRAM_REGISTER_CALLBACKS        0U /* SRAM register callback disabled      */
+#define  USE_HAL_SPDIFRX_REGISTER_CALLBACKS     0U /* SPDIFRX register callback disabled   */
+#define  USE_HAL_SMBUS_REGISTER_CALLBACKS       0U /* SMBUS register callback disabled     */
+#define  USE_HAL_SPI_REGISTER_CALLBACKS         0U /* SPI register callback disabled       */
+#define  USE_HAL_TIM_REGISTER_CALLBACKS         0U /* TIM register callback disabled       */
+#define  USE_HAL_UART_REGISTER_CALLBACKS        0U /* UART register callback disabled      */
+#define  USE_HAL_USART_REGISTER_CALLBACKS       0U /* USART register callback disabled     */
+#define  USE_HAL_WWDG_REGISTER_CALLBACKS        0U /* WWDG register callback disabled      */
+
+/* ########################## Assert Selection ############################## */
+/**
+  * @brief Uncomment the line below to expanse the "assert_param" macro in the
+  *        HAL drivers code
+  */
+/* #define USE_FULL_ASSERT    1 */
+
+/* ################## Ethernet peripheral configuration ##################### */
+
+/* Section 1 : Ethernet peripheral configuration */
+
+/* MAC ADDRESS: MAC_ADDR0:MAC_ADDR1:MAC_ADDR2:MAC_ADDR3:MAC_ADDR4:MAC_ADDR5 */
+#define MAC_ADDR0   2U
+#define MAC_ADDR1   0U
+#define MAC_ADDR2   0U
+#define MAC_ADDR3   0U
+#define MAC_ADDR4   0U
+#define MAC_ADDR5   0U
+
+/* Definition of the Ethernet driver buffers size and count */
+#define ETH_RX_BUF_SIZE                ETH_MAX_PACKET_SIZE /* buffer size for receive               */
+#define ETH_TX_BUF_SIZE                ETH_MAX_PACKET_SIZE /* buffer size for transmit              */
+#define ETH_RXBUFNB                    4U       /* 4 Rx buffers of size ETH_RX_BUF_SIZE  */
+#define ETH_TXBUFNB                    4U       /* 4 Tx buffers of size ETH_TX_BUF_SIZE  */
+
+/* Section 2: PHY configuration section */
+/* LAN8742A PHY Address*/
+////////////////////////////////
+//#define LAN8742A_PHY_ADDRESS            0x00U
+/* Section 2: PHY configuration section */
+#if !defined  (LAN8742A_PHY_ADDRESS)
+  /* KH, LAN8742A PHY Address*/
+  #define LAN8742A_PHY_ADDRESS            0x00U
+#endif
+////////////////////////////////
+/* PHY Reset delay these values are based on a 1 ms Systick interrupt*/
+#define PHY_RESET_DELAY                 0x00000FFFU
+/* PHY Configuration delay */
+#define PHY_CONFIG_DELAY                0x00000FFFU
+
+#define PHY_READ_TO                     0x0000FFFFU
+#define PHY_WRITE_TO                    0x0000FFFFU
+
+/* Section 3: Common PHY Registers */
+
+#define PHY_BCR                         ((uint16_t)0x00U)    /*!< Transceiver Basic Control Register   */
+#define PHY_BSR                         ((uint16_t)0x01U)    /*!< Transceiver Basic Status Register    */
+
+#define PHY_RESET                       ((uint16_t)0x8000U)  /*!< PHY Reset */
+#define PHY_LOOPBACK                    ((uint16_t)0x4000U)  /*!< Select loop-back mode */
+#define PHY_FULLDUPLEX_100M             ((uint16_t)0x2100U)  /*!< Set the full-duplex mode at 100 Mb/s */
+#define PHY_HALFDUPLEX_100M             ((uint16_t)0x2000U)  /*!< Set the half-duplex mode at 100 Mb/s */
+#define PHY_FULLDUPLEX_10M              ((uint16_t)0x0100U)  /*!< Set the full-duplex mode at 10 Mb/s  */
+#define PHY_HALFDUPLEX_10M              ((uint16_t)0x0000U)  /*!< Set the half-duplex mode at 10 Mb/s  */
+#define PHY_AUTONEGOTIATION             ((uint16_t)0x1000U)  /*!< Enable auto-negotiation function     */
+#define PHY_RESTART_AUTONEGOTIATION     ((uint16_t)0x0200U)  /*!< Restart auto-negotiation function    */
+#define PHY_POWERDOWN                   ((uint16_t)0x0800U)  /*!< Select the power down mode           */
+#define PHY_ISOLATE                     ((uint16_t)0x0400U)  /*!< Isolate PHY from MII                 */
+
+#define PHY_AUTONEGO_COMPLETE           ((uint16_t)0x0020U)  /*!< Auto-Negotiation process completed   */
+#define PHY_LINKED_STATUS               ((uint16_t)0x0004U)  /*!< Valid link established               */
+#define PHY_JABBER_DETECTION            ((uint16_t)0x0002U)  /*!< Jabber condition detected            */
+
+/* Section 4: Extended PHY Registers */
+
+#define PHY_SR                          ((uint16_t)0x1FU)    /*!< PHY special control/ status register Offset     */
+
+#define PHY_SPEED_STATUS                ((uint16_t)0x0004U)  /*!< PHY Speed mask                                  */
+#define PHY_DUPLEX_STATUS               ((uint16_t)0x0010U)  /*!< PHY Duplex mask                                 */
+
+
+#define PHY_ISFR                        ((uint16_t)0x01DU)   /*!< PHY Interrupt Source Flag register Offset       */
+#define PHY_IMR                         ((uint16_t)0x001E)   /*!< PHY Interrupt Mask register Offset              */
+#define PHY_ISFR_INT4                   ((uint16_t)0x0010U)  /*!< PHY Link down inturrupt                         */
+
+/* ################## SPI peripheral configuration ########################## */
+
+/* CRC FEATURE: Use to activate CRC feature inside HAL SPI Driver
+* Activated: CRC code is present inside driver
+* Deactivated: CRC code cleaned from driver
+*/
+#if !defined (USE_SPI_CRC)
+#define USE_SPI_CRC                     0U
+#endif
+
+/* Includes ------------------------------------------------------------------*/
+/**
+  * @brief Include module's header file
+  */
+
+#ifdef HAL_RCC_MODULE_ENABLED
+#include "stm32f7xx_hal_rcc.h"
+#endif /* HAL_RCC_MODULE_ENABLED */
+
+#ifdef HAL_GPIO_MODULE_ENABLED
+#include "stm32f7xx_hal_gpio.h"
+#endif /* HAL_GPIO_MODULE_ENABLED */
+
+#ifdef HAL_DMA_MODULE_ENABLED
+#include "stm32f7xx_hal_dma.h"
+#endif /* HAL_DMA_MODULE_ENABLED */
+
+#ifdef HAL_CORTEX_MODULE_ENABLED
+#include "stm32f7xx_hal_cortex.h"
+#endif /* HAL_CORTEX_MODULE_ENABLED */
+
+#ifdef HAL_ADC_MODULE_ENABLED
+#include "stm32f7xx_hal_adc.h"
+#endif /* HAL_ADC_MODULE_ENABLED */
+
+#ifdef HAL_CAN_MODULE_ENABLED
+#include "stm32f7xx_hal_can.h"
+#endif /* HAL_CAN_MODULE_ENABLED */
+
+#ifdef HAL_CAN_LEGACY_MODULE_ENABLED
+#include "stm32f7xx_hal_can_legacy.h"
+#endif /* HAL_CAN_LEGACY_MODULE_ENABLED */
+
+#ifdef HAL_CEC_MODULE_ENABLED
+#include "stm32f7xx_hal_cec.h"
+#endif /* HAL_CEC_MODULE_ENABLED */
+
+#ifdef HAL_CRC_MODULE_ENABLED
+#include "stm32f7xx_hal_crc.h"
+#endif /* HAL_CRC_MODULE_ENABLED */
+
+#ifdef HAL_CRYP_MODULE_ENABLED
+#include "stm32f7xx_hal_cryp.h"
+#endif /* HAL_CRYP_MODULE_ENABLED */
+
+#ifdef HAL_DMA2D_MODULE_ENABLED
+#include "stm32f7xx_hal_dma2d.h"
+#endif /* HAL_DMA2D_MODULE_ENABLED */
+
+#ifdef HAL_DAC_MODULE_ENABLED
+#include "stm32f7xx_hal_dac.h"
+#endif /* HAL_DAC_MODULE_ENABLED */
+
+#ifdef HAL_DCMI_MODULE_ENABLED
+#include "stm32f7xx_hal_dcmi.h"
+#endif /* HAL_DCMI_MODULE_ENABLED */
+
+#ifdef HAL_ETH_MODULE_ENABLED
+#include "stm32f7xx_hal_eth.h"
+#endif /* HAL_ETH_MODULE_ENABLED */
+
+#ifdef HAL_EXTI_MODULE_ENABLED
+#include "stm32f7xx_hal_exti.h"
+#endif /* HAL_EXTI_MODULE_ENABLED */
+
+#ifdef HAL_FLASH_MODULE_ENABLED
+#include "stm32f7xx_hal_flash.h"
+#endif /* HAL_FLASH_MODULE_ENABLED */
+
+#ifdef HAL_SRAM_MODULE_ENABLED
+#include "stm32f7xx_hal_sram.h"
+#endif /* HAL_SRAM_MODULE_ENABLED */
+
+#ifdef HAL_NOR_MODULE_ENABLED
+#include "stm32f7xx_hal_nor.h"
+#endif /* HAL_NOR_MODULE_ENABLED */
+
+#ifdef HAL_NAND_MODULE_ENABLED
+#include "stm32f7xx_hal_nand.h"
+#endif /* HAL_NAND_MODULE_ENABLED */
+
+#ifdef HAL_SDRAM_MODULE_ENABLED
+#include "stm32f7xx_hal_sdram.h"
+#endif /* HAL_SDRAM_MODULE_ENABLED */
+
+#ifdef HAL_HASH_MODULE_ENABLED
+#include "stm32f7xx_hal_hash.h"
+#endif /* HAL_HASH_MODULE_ENABLED */
+
+#ifdef HAL_I2C_MODULE_ENABLED
+#include "stm32f7xx_hal_i2c.h"
+#endif /* HAL_I2C_MODULE_ENABLED */
+
+#ifdef HAL_I2S_MODULE_ENABLED
+#include "stm32f7xx_hal_i2s.h"
+#endif /* HAL_I2S_MODULE_ENABLED */
+
+#ifdef HAL_IWDG_MODULE_ENABLED
+#include "stm32f7xx_hal_iwdg.h"
+#endif /* HAL_IWDG_MODULE_ENABLED */
+
+#ifdef HAL_LPTIM_MODULE_ENABLED
+#include "stm32f7xx_hal_lptim.h"
+#endif /* HAL_LPTIM_MODULE_ENABLED */
+
+#ifdef HAL_LTDC_MODULE_ENABLED
+#include "stm32f7xx_hal_ltdc.h"
+#endif /* HAL_LTDC_MODULE_ENABLED */
+
+#ifdef HAL_PWR_MODULE_ENABLED
+#include "stm32f7xx_hal_pwr.h"
+#endif /* HAL_PWR_MODULE_ENABLED */
+
+#ifdef HAL_QSPI_MODULE_ENABLED
+#include "stm32f7xx_hal_qspi.h"
+#endif /* HAL_QSPI_MODULE_ENABLED */
+
+#ifdef HAL_RNG_MODULE_ENABLED
+#include "stm32f7xx_hal_rng.h"
+#endif /* HAL_RNG_MODULE_ENABLED */
+
+#ifdef HAL_RTC_MODULE_ENABLED
+#include "stm32f7xx_hal_rtc.h"
+#endif /* HAL_RTC_MODULE_ENABLED */
+
+#ifdef HAL_SAI_MODULE_ENABLED
+#include "stm32f7xx_hal_sai.h"
+#endif /* HAL_SAI_MODULE_ENABLED */
+
+#ifdef HAL_SD_MODULE_ENABLED
+#include "stm32f7xx_hal_sd.h"
+#endif /* HAL_SD_MODULE_ENABLED */
+
+#ifdef HAL_SPDIFRX_MODULE_ENABLED
+#include "stm32f7xx_hal_spdifrx.h"
+#endif /* HAL_SPDIFRX_MODULE_ENABLED */
+
+#ifdef HAL_SPI_MODULE_ENABLED
+#include "stm32f7xx_hal_spi.h"
+#endif /* HAL_SPI_MODULE_ENABLED */
+
+#ifdef HAL_TIM_MODULE_ENABLED
+#include "stm32f7xx_hal_tim.h"
+#endif /* HAL_TIM_MODULE_ENABLED */
+
+#ifdef HAL_UART_MODULE_ENABLED
+#include "stm32f7xx_hal_uart.h"
+#endif /* HAL_UART_MODULE_ENABLED */
+
+#ifdef HAL_USART_MODULE_ENABLED
+#include "stm32f7xx_hal_usart.h"
+#endif /* HAL_USART_MODULE_ENABLED */
+
+#ifdef HAL_IRDA_MODULE_ENABLED
+#include "stm32f7xx_hal_irda.h"
+#endif /* HAL_IRDA_MODULE_ENABLED */
+
+#ifdef HAL_SMARTCARD_MODULE_ENABLED
+#include "stm32f7xx_hal_smartcard.h"
+#endif /* HAL_SMARTCARD_MODULE_ENABLED */
+
+#ifdef HAL_WWDG_MODULE_ENABLED
+#include "stm32f7xx_hal_wwdg.h"
+#endif /* HAL_WWDG_MODULE_ENABLED */
+
+#ifdef HAL_PCD_MODULE_ENABLED
+#include "stm32f7xx_hal_pcd.h"
+#endif /* HAL_PCD_MODULE_ENABLED */
+
+#ifdef HAL_HCD_MODULE_ENABLED
+#include "stm32f7xx_hal_hcd.h"
+#endif /* HAL_HCD_MODULE_ENABLED */
+
+#ifdef HAL_DFSDM_MODULE_ENABLED
+#include "stm32f7xx_hal_dfsdm.h"
+#endif /* HAL_DFSDM_MODULE_ENABLED */
+
+#ifdef HAL_DSI_MODULE_ENABLED
+#include "stm32f7xx_hal_dsi.h"
+#endif /* HAL_DSI_MODULE_ENABLED */
+
+#ifdef HAL_JPEG_MODULE_ENABLED
+#include "stm32f7xx_hal_jpeg.h"
+#endif /* HAL_JPEG_MODULE_ENABLED */
+
+#ifdef HAL_MDIOS_MODULE_ENABLED
+#include "stm32f7xx_hal_mdios.h"
+#endif /* HAL_MDIOS_MODULE_ENABLED */
+
+#ifdef HAL_SMBUS_MODULE_ENABLED
+#include "stm32f7xx_hal_smbus.h"
+#endif /* HAL_SMBUS_MODULE_ENABLED */
+
+#ifdef HAL_MMC_MODULE_ENABLED
+#include "stm32f7xx_hal_mmc.h"
+#endif /* HAL_MMC_MODULE_ENABLED */
+
+/* Exported macro ------------------------------------------------------------*/
+#ifdef  USE_FULL_ASSERT
+/**
+  * @brief  The assert_param macro is used for function's parameters check.
+  * @param  expr If expr is false, it calls assert_failed function
+  *         which reports the name of the source file and the source
+  *         line number of the call that failed.
+  *         If expr is true, it returns no value.
+  * @retval None
+  */
+#define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t *)__FILE__, __LINE__))
+/* Exported functions ------------------------------------------------------- */
+void assert_failed(uint8_t *file, uint32_t line);
+#else
+#define assert_param(expr) ((void)0U)
+#endif /* USE_FULL_ASSERT */
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __STM32F7xx_HAL_CONF_DEFAULT_H */
+
+
+/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/

Packages_Patches/STM32/hardware/stm32/2.2.0/variants/STM32F7xx/F765Z(G-I)T_F767Z(G-I)T_F777ZIT/variant_NUCLEO_F767ZI.h

@@ -0,0 +1,274 @@
+/*
+ *******************************************************************************
+ * Copyright (c) 2020-2021, STMicroelectronics
+ * All rights reserved.
+ *
+ * This software component is licensed by ST under BSD 3-Clause license,
+ * the "License"; You may not use this file except in compliance with the
+ * License. You may obtain a copy of the License at:
+ *                        opensource.org/licenses/BSD-3-Clause
+ *
+ *******************************************************************************
+*/
+#pragma once
+
+/*----------------------------------------------------------------------------
+ *        Pins
+ *----------------------------------------------------------------------------*/
+
+#define PG9                     0
+#define PG14                    1
+#define PF15                    2
+#define PE13                    3
+#define PF14                    4
+#define PE11                    5
+#define PE9                     6
+#define PF13                    7
+#define PF12                    8
+#define PD15                    9
+#define PD14                    10
+#define PA7                     PIN_A10
+#define PA6                     PIN_A11
+#define PA5                     PIN_A12
+#define PB9                     14
+#define PB8                     15
+#define PC6                     16
+#define PB15                    17
+#define PB13                    18
+#define PB12                    19
+#define PA15                    20
+#define PC7                     21
+#define PB5                     22
+#define PB3                     23
+#define PA4                     PIN_A13
+#define PB4                     25
+#define PB6                     26
+#define PB2                     27
+#define PD13                    28
+#define PD12                    29
+#define PD11                    30
+#define PE2                     31
+#define PA0                     PIN_A14
+#define PB0                     PIN_A23 // LED_GREEN
+#define PE0                     34
+#define PB11                    35
+#define PB10                    36
+#define PE15                    37
+#define PE14                    38
+#define PE12                    39
+#define PE10                    40
+#define PE7                     41
+#define PE8                     42
+#define PC8                     43
+#define PC9                     44
+#define PC10                    45
+#define PC11                    46
+#define PC12                    47
+#define PD2                     48
+#define PG2                     49
+#define PG3                     50
+#define PD7                     51
+#define PD6                     52
+#define PD5                     53
+#define PD4                     54
+#define PD3                     55
+// 56 is PE2                    (31)
+#define PE4                     57
+#define PE5                     58
+#define PE6                     59
+#define PE3                     60
+#define PF8                     PIN_A15
+#define PF7                     PIN_A16
+#define PF9                     PIN_A17
+#define PG1                     64
+#define PG0                     65
+#define PD1                     66
+#define PD0                     67
+#define PF0                     68
+#define PF1                     69
+#define PF2                     70
+// 71 is PA7                    (11)
+// 72 is NC
+#define PB7                     73 // LED_BLUE
+#define PB14                    74 // LED_RED
+#define PC13                    75 // USER_BTN
+#define PD9                     76 // Serial Rx
+#define PD8                     77 // Serial Tx
+#define PA3                     PIN_A0
+#define PC0                     PIN_A1
+#define PC3                     PIN_A2
+#define PF3                     PIN_A3
+#define PF5                     PIN_A4
+#define PF10                    PIN_A5
+#define PB1                     PIN_A6
+#define PC2                     PIN_A7
+#define PF4                     PIN_A8
+#define PF6                     PIN_A9
+// ST Morpho
+#define PA1                     PIN_A18
+#define PA2                     PIN_A19
+#define PA8                     90
+#define PA9                     91
+#define PA10                    92
+#define PA11                    93
+#define PA12                    94
+#define PA13                    95 // SWD
+#define PA14                    96 // SWD
+#define PC1                     PIN_A20
+#define PC4                     PIN_A21
+#define PC5                     PIN_A22
+#define PC14                    100
+#define PC15                    101
+#define PD10                    102
+#define PE1                     103
+#define PF11                    104
+#define PG4                     105
+#define PG5                     106
+#define PG6                     107
+#define PG7                     108
+#define PG8                     109
+#define PG10                    110
+#define PG11                    111
+#define PG12                    112
+#define PG13                    113
+#define PG15                    114
+#define PH0                     115 // MCO
+#define PH1                     116
+
+// Alternate pins number
+#define PA0_ALT1                (PA0  | ALT1)
+#define PA0_ALT2                (PA0  | ALT2)
+#define PA1_ALT1                (PA1  | ALT1)
+#define PA1_ALT2                (PA1  | ALT2)
+#define PA2_ALT1                (PA2  | ALT1)
+#define PA2_ALT2                (PA2  | ALT2)
+#define PA3_ALT1                (PA3  | ALT1)
+#define PA3_ALT2                (PA3  | ALT2)
+#define PA4_ALT1                (PA4  | ALT1)
+#define PA5_ALT1                (PA5  | ALT1)
+#define PA6_ALT1                (PA6  | ALT1)
+#define PA7_ALT1                (PA7  | ALT1)
+#define PA7_ALT2                (PA7  | ALT2)
+#define PA7_ALT3                (PA7  | ALT3)
+#define PA15_ALT1               (PA15 | ALT1)
+#define PB0_ALT1                (PB0  | ALT1)
+#define PB0_ALT2                (PB0  | ALT2)
+#define PB1_ALT1                (PB1  | ALT1)
+#define PB1_ALT2                (PB1  | ALT2)
+#define PB3_ALT1                (PB3  | ALT1)
+#define PB4_ALT1                (PB4  | ALT1)
+#define PB5_ALT1                (PB5  | ALT1)
+#define PB8_ALT1                (PB8  | ALT1)
+#define PB9_ALT1                (PB9  | ALT1)
+#define PB14_ALT1               (PB14 | ALT1)
+#define PB14_ALT2               (PB14 | ALT2)
+#define PB15_ALT1               (PB15 | ALT1)
+#define PB15_ALT2               (PB15 | ALT2)
+#define PC0_ALT1                (PC0  | ALT1)
+#define PC0_ALT2                (PC0  | ALT2)
+#define PC1_ALT1                (PC1  | ALT1)
+#define PC1_ALT2                (PC1  | ALT2)
+#define PC2_ALT1                (PC2  | ALT1)
+#define PC2_ALT2                (PC2  | ALT2)
+#define PC3_ALT1                (PC3  | ALT1)
+#define PC3_ALT2                (PC3  | ALT2)
+#define PC4_ALT1                (PC4  | ALT1)
+#define PC5_ALT1                (PC5  | ALT1)
+#define PC6_ALT1                (PC6  | ALT1)
+#define PC7_ALT1                (PC7  | ALT1)
+#define PC8_ALT1                (PC8  | ALT1)
+#define PC9_ALT1                (PC9  | ALT1)
+#define PC10_ALT1               (PC10 | ALT1)
+#define PC11_ALT1               (PC11 | ALT1)
+
+// This must be a literal
+#define NUM_DIGITAL_PINS        117
+// This must be a literal with a value less than or equal to to MAX_ANALOG_INPUTS
+#define NUM_ANALOG_INPUTS       24
+
+// On-board LED pin number
+#ifndef LED_BUILTIN
+  #define LED_BUILTIN           PB0
+#endif
+#define LED_GREEN               LED_BUILTIN
+#define LED_BLUE                PB7
+#define LED_RED                 PB14
+
+// On-board user button
+#ifndef USER_BTN
+  #define USER_BTN              PC13
+#endif
+
+// Timer Definitions
+// Use TIM6/TIM7 when possible as servo and tone don't need GPIO output pin
+#ifndef TIMER_TONE
+  #define TIMER_TONE            TIM6
+#endif
+#ifndef TIMER_SERVO
+  #define TIMER_SERVO           TIM7
+#endif
+
+// UART Definitions
+#ifndef SERIAL_UART_INSTANCE
+  #define SERIAL_UART_INSTANCE  3 //Connected to ST-Link
+#endif
+// Serial pin used for console (ex: stlink)
+// Rerquired by Firmata
+#ifndef PIN_SERIAL_RX
+  #define PIN_SERIAL_RX         PD9
+#endif
+#ifndef PIN_SERIAL_TX
+  #define PIN_SERIAL_TX         PD8
+#endif
+
+// Value of the External oscillator in Hz
+#define HSE_VALUE               8000000U
+
+/* Extra HAL modules */
+#if !defined(HAL_DAC_MODULE_DISABLED)
+  #define HAL_DAC_MODULE_ENABLED
+#endif
+#if !defined(HAL_ETH_MODULE_DISABLED)
+  #define HAL_ETH_MODULE_ENABLED
+#endif
+#if !defined(HAL_QSPI_MODULE_DISABLED)
+  #define HAL_QSPI_MODULE_ENABLED
+#endif
+#if !defined(HAL_SD_MODULE_DISABLED)
+  #define HAL_SD_MODULE_ENABLED
+#endif
+
+// Last Flash sector used for EEPROM emulation, address/sector depends on single/dual bank configuration.
+// By default 2MB single bank
+#define FLASH_BASE_ADDRESS      0x081C0000
+#define FLASH_DATA_SECTOR       11
+
+/*----------------------------------------------------------------------------
+ *        Arduino objects - C++ only
+ *----------------------------------------------------------------------------*/
+
+#ifdef __cplusplus
+  // These serial port names are intended to allow libraries and architecture-neutral
+  // sketches to automatically default to the correct port name for a particular type
+  // of use.  For example, a GPS module would normally connect to SERIAL_PORT_HARDWARE_OPEN,
+  // the first hardware serial port whose RX/TX pins are not dedicated to another use.
+  //
+  // SERIAL_PORT_MONITOR        Port which normally prints to the Arduino Serial Monitor
+  //
+  // SERIAL_PORT_USBVIRTUAL     Port which is USB virtual serial
+  //
+  // SERIAL_PORT_LINUXBRIDGE    Port which connects to a Linux system via Bridge library
+  //
+  // SERIAL_PORT_HARDWARE       Hardware serial port, physical RX & TX pins.
+  //
+  // SERIAL_PORT_HARDWARE_OPEN  Hardware serial ports which are open for use.  Their RX & TX
+  //                            pins are NOT connected to anything by default.
+  #ifndef SERIAL_PORT_MONITOR
+    #define SERIAL_PORT_MONITOR     Serial
+  #endif
+  #ifndef SERIAL_PORT_HARDWARE
+    // KH mod to add Serial1, for ESP-AT
+    //#define SERIAL_PORT_HARDWARE    Serial
+    #define SERIAL_PORT_HARDWARE    Serial1
+  #endif
+#endif

Packages_Patches/STM32/hardware/stm32/2.2.0/variants/STM32L0xx/L052R(6-8)T_L053R(6-8)T_L063R8T/variant_generic.h

@@ -0,0 +1,173 @@
+/*
+ *******************************************************************************
+ * Copyright (c) 2020-2021, STMicroelectronics
+ * All rights reserved.
+ *
+ * This software component is licensed by ST under BSD 3-Clause license,
+ * the "License"; You may not use this file except in compliance with the
+ * License. You may obtain a copy of the License at:
+ *                        opensource.org/licenses/BSD-3-Clause
+ *
+ *******************************************************************************
+ */
+#pragma once
+
+/*----------------------------------------------------------------------------
+ *        STM32 pins number
+ *----------------------------------------------------------------------------*/
+#define PA0                     PIN_A0
+#define PA1                     PIN_A1
+#define PA2                     PIN_A2
+#define PA3                     PIN_A3
+#define PA4                     PIN_A4
+#define PA5                     PIN_A5
+#define PA6                     PIN_A6
+#define PA7                     PIN_A7
+#define PA8                     8
+#define PA9                     9
+#define PA10                    10
+#define PA11                    11
+#define PA12                    12
+#define PA13                    13
+#define PA14                    14
+#define PA15                    15
+#define PB0                     PIN_A8
+#define PB1                     PIN_A9
+#define PB2                     18
+#define PB3                     19
+#define PB4                     20
+#define PB5                     21
+#define PB6                     22
+#define PB7                     23
+#define PB8                     24
+#define PB9                     25
+#define PB10                    26
+#define PB11                    27
+#define PB12                    28
+#define PB13                    29
+#define PB14                    30
+#define PB15                    31
+#define PC0                     PIN_A10
+#define PC1                     PIN_A11
+#define PC2                     PIN_A12
+#define PC4                     PIN_A13
+#define PC5                     PIN_A14
+#define PC6                     37
+#define PC7                     38
+#define PC8                     39
+#define PC9                     40
+#define PC10                    41
+#define PC11                    42
+#define PC12                    43
+#define PC13                    44
+#define PC14                    45
+#define PC15                    46
+#define PD2                     47
+#define PH0                     48
+#define PH1                     49
+
+// Alternate pins number
+#define PA2_ALT1                (PA2 | ALT1)
+#define PA3_ALT1                (PA3 | ALT1)
+
+#define NUM_DIGITAL_PINS        50
+#define NUM_ANALOG_INPUTS       15
+
+// On-board LED pin number
+#ifndef LED_BUILTIN
+  #define LED_BUILTIN           PNUM_NOT_DEFINED
+#endif
+
+// On-board user button
+#ifndef USER_BTN
+  #define USER_BTN              PNUM_NOT_DEFINED
+#endif
+
+// SPI definitions
+#ifndef PIN_SPI_SS
+  #define PIN_SPI_SS            PA4
+#endif
+#ifndef PIN_SPI_SS1
+  #define PIN_SPI_SS1           PA15
+#endif
+#ifndef PIN_SPI_SS2
+  #define PIN_SPI_SS2           PNUM_NOT_DEFINED
+#endif
+#ifndef PIN_SPI_SS3
+  #define PIN_SPI_SS3           PNUM_NOT_DEFINED
+#endif
+#ifndef PIN_SPI_MOSI
+  #define PIN_SPI_MOSI          PA7
+#endif
+#ifndef PIN_SPI_MISO
+  #define PIN_SPI_MISO          PA6
+#endif
+#ifndef PIN_SPI_SCK
+  #define PIN_SPI_SCK           PA5
+#endif
+
+// I2C definitions
+#ifndef PIN_WIRE_SDA
+  #define PIN_WIRE_SDA          PB7
+#endif
+#ifndef PIN_WIRE_SCL
+  #define PIN_WIRE_SCL          PB6
+#endif
+
+// Timer Definitions
+// Use TIM6/TIM7 when possible as servo and tone don't need GPIO output pin
+#ifndef TIMER_TONE
+  #define TIMER_TONE            TIM6
+#endif
+#ifndef TIMER_SERVO
+  #define TIMER_SERVO           TIM21
+#endif
+
+// UART Definitions
+#ifndef SERIAL_UART_INSTANCE
+  #define SERIAL_UART_INSTANCE  2
+#endif
+
+// Default pin used for generic 'Serial' instance
+// Mandatory for Firmata
+#ifndef PIN_SERIAL_RX
+  #define PIN_SERIAL_RX         PA3
+#endif
+#ifndef PIN_SERIAL_TX
+  #define PIN_SERIAL_TX         PA2
+#endif
+
+// Extra HAL modules
+#if !defined(HAL_DAC_MODULE_DISABLED)
+  #define HAL_DAC_MODULE_ENABLED
+#endif
+
+/*----------------------------------------------------------------------------
+ *        Arduino objects - C++ only
+ *----------------------------------------------------------------------------*/
+
+#ifdef __cplusplus
+  // These serial port names are intended to allow libraries and architecture-neutral
+  // sketches to automatically default to the correct port name for a particular type
+  // of use.  For example, a GPS module would normally connect to SERIAL_PORT_HARDWARE_OPEN,
+  // the first hardware serial port whose RX/TX pins are not dedicated to another use.
+  //
+  // SERIAL_PORT_MONITOR        Port which normally prints to the Arduino Serial Monitor
+  //
+  // SERIAL_PORT_USBVIRTUAL     Port which is USB virtual serial
+  //
+  // SERIAL_PORT_LINUXBRIDGE    Port which connects to a Linux system via Bridge library
+  //
+  // SERIAL_PORT_HARDWARE       Hardware serial port, physical RX & TX pins.
+  //
+  // SERIAL_PORT_HARDWARE_OPEN  Hardware serial ports which are open for use.  Their RX & TX
+  //                            pins are NOT connected to anything by default.
+  #ifndef SERIAL_PORT_MONITOR
+    #define SERIAL_PORT_MONITOR   Serial
+  #endif
+  #ifndef SERIAL_PORT_HARDWARE
+    // KH mod to add Serial1, for ESP-AT
+    //#define SERIAL_PORT_HARDWARE    Serial
+    #define SERIAL_PORT_HARDWARE    Serial1
+  #endif
+#endif

Packages_Patches/SparkFun/hardware/samd/1.8.3/cores/arduino/Print.cpp

@@ -0,0 +1,420 @@
+/*
+  Copyright (c) 2014 Arduino.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+  See the GNU Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#include <stdlib.h>
+
+#include <stdarg.h>
+
+#include <stdio.h>
+#include <string.h>
+#include <math.h>
+
+#include "Arduino.h"
+
+#include "Print.h"
+
+//using namespace arduino;
+
+// Public Methods //////////////////////////////////////////////////////////////
+
+/* default implementation: may be overridden */
+size_t Print::write(const uint8_t *buffer, size_t size)
+{
+  size_t n = 0;
+  while (size--) {
+    if (write(*buffer++)) n++;
+    else break;
+  }
+  return n;
+}
+
+size_t Print::print(const __FlashStringHelper *ifsh)
+{
+  return print(reinterpret_cast<const char *>(ifsh));
+}
+
+size_t Print::print(const String &s)
+{
+  return write(s.c_str(), s.length());
+}
+
+size_t Print::print(const char str[])
+{
+  return write(str);
+}
+
+size_t Print::print(char c)
+{
+  return write(c);
+}
+
+size_t Print::print(unsigned char b, int base)
+{
+  return print((unsigned long) b, base);
+}
+
+size_t Print::print(int n, int base)
+{
+  return print((long) n, base);
+}
+
+size_t Print::print(unsigned int n, int base)
+{
+  return print((unsigned long) n, base);
+}
+
+size_t Print::print(long n, int base)
+{
+  if (base == 0) {
+    return write(n);
+  } else if (base == 10) {
+    if (n < 0) {
+      int t = print('-');
+      n = -n;
+      return printNumber(n, 10) + t;
+    }
+    return printNumber(n, 10);
+  } else {
+    return printNumber(n, base);
+  }
+}
+
+size_t Print::print(unsigned long n, int base)
+{
+  if (base == 0) return write(n);
+  else return printNumber(n, base);
+}
+
+size_t Print::print(long long n, int base)
+{
+  if (base == 0) {
+    return write(n);
+  } else if (base == 10) {
+    if (n < 0) {
+      int t = print('-');
+      n = -n;
+      return printULLNumber(n, 10) + t;
+    }
+    return printULLNumber(n, 10);
+  } else {
+    return printULLNumber(n, base);
+  }
+}
+
+size_t Print::print(unsigned long long n, int base)
+{
+  if (base == 0) return write(n);
+  else return printULLNumber(n, base);
+}
+
+size_t Print::print(double n, int digits)
+{
+  return printFloat(n, digits);
+}
+
+size_t Print::println(const __FlashStringHelper *ifsh)
+{
+  size_t n = print(ifsh);
+  n += println();
+  return n;
+}
+
+size_t Print::print(const Printable& x)
+{
+  return x.printTo(*this);
+}
+
+size_t Print::println(void)
+{
+  return write("\r\n");
+}
+
+size_t Print::println(const String &s)
+{
+  size_t n = print(s);
+  n += println();
+  return n;
+}
+
+size_t Print::println(const char c[])
+{
+  size_t n = print(c);
+  n += println();
+  return n;
+}
+
+size_t Print::println(char c)
+{
+  size_t n = print(c);
+  n += println();
+  return n;
+}
+
+size_t Print::println(unsigned char b, int base)
+{
+  size_t n = print(b, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(int num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(unsigned int num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(long num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(unsigned long num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(long long num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(unsigned long long num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(double num, int digits)
+{
+  size_t n = print(num, digits);
+  n += println();
+  return n;
+}
+
+size_t Print::println(const Printable& x)
+{
+  size_t n = print(x);
+  n += println();
+  return n;
+}
+
+size_t Print::printf(const char * format, ...)
+{
+  char buf[256];
+  int len;
+
+  va_list ap;
+  va_start(ap, format);
+
+  len = vsnprintf(buf, 256, format, ap);
+  this->write(buf, len);
+
+  va_end(ap);
+  return len;
+}
+
+// Private Methods /////////////////////////////////////////////////////////////
+
+size_t Print::printNumber(unsigned long n, uint8_t base)
+{
+  char buf[8 * sizeof(long) + 1]; // Assumes 8-bit chars plus zero byte.
+  char *str = &buf[sizeof(buf) - 1];
+
+  *str = '\0';
+
+  // prevent crash if called with base == 1
+  if (base < 2) base = 10;
+
+  do {
+    char c = n % base;
+    n /= base;
+
+    *--str = c < 10 ? c + '0' : c + 'A' - 10;
+  } while(n);
+
+  return write(str);
+}
+
+// REFERENCE IMPLEMENTATION FOR ULL
+// size_t Print::printULLNumber(unsigned long long n, uint8_t base)
+// {
+  // // if limited to base 10 and 16 the bufsize can be smaller
+  // char buf[65];
+  // char *str = &buf[64];
+
+  // *str = '\0';
+
+  // // prevent crash if called with base == 1
+  // if (base < 2) base = 10;
+
+    // do {
+      // unsigned long long t = n / base;
+      // char c = n - t * base;  // faster than c = n%base;
+      // n = t;
+      // *--str = c < 10 ? c + '0' : c + 'A' - 10;
+  // } while(n);
+
+  // return write(str);
+// }
+
+// FAST IMPLEMENTATION FOR ULL
+size_t Print::printULLNumber(unsigned long long n64, uint8_t base)
+{
+  // if limited to base 10 and 16 the bufsize can be 20
+  char buf[64];
+  uint8_t i = 0;
+  uint8_t innerLoops = 0;
+
+  // prevent crash if called with base == 1
+  if (base < 2) base = 10;
+
+  // process chunks that fit in "16 bit math".
+  uint16_t top = 0xFFFF / base;
+  uint16_t th16 = 1;
+  while (th16 < top)
+  {
+    th16 *= base;
+    innerLoops++;
+  }
+
+  while (n64 > th16)
+  {
+    // 64 bit math part
+    uint64_t q = n64 / th16;
+    uint16_t r = n64 - q*th16;
+    n64 = q;
+
+    // 16 bit math loop to do remainder. (note buffer is filled reverse)
+    for (uint8_t j=0; j < innerLoops; j++)
+    {
+      uint16_t qq = r/base;
+      buf[i++] = r - qq*base;
+      r = qq;
+    }
+  }
+
+  uint16_t n16 = n64;
+  while (n16 > 0)
+  {
+    uint16_t qq = n16/base;
+    buf[i++] = n16 - qq*base;
+    n16 = qq;
+  }
+
+  size_t bytes = i;
+  for (; i > 0; i--)
+    write((char) (buf[i - 1] < 10 ?
+    '0' + buf[i - 1] :
+    'A' + buf[i - 1] - 10));
+
+  return bytes;
+}
+
+size_t Print::printFloat(double number, int digits)
+{
+  if (digits < 0)
+    digits = 2;
+
+  size_t n = 0;
+
+  if (isnan(number)) return print("nan");
+  if (isinf(number)) return print("inf");
+  if (number > 4294967040.0) return print ("ovf");  // constant determined empirically
+  if (number <-4294967040.0) return print ("ovf");  // constant determined empirically
+
+  // Handle negative numbers
+  if (number < 0.0)
+  {
+     n += print('-');
+     number = -number;
+  }
+
+  // Round correctly so that print(1.999, 2) prints as "2.00"
+  double rounding = 0.5;
+  for (uint8_t i=0; i<digits; ++i)
+    rounding /= 10.0;
+
+  number += rounding;
+
+  // Extract the integer part of the number and print it
+  unsigned long int_part = (unsigned long)number;
+  double remainder = number - (double)int_part;
+  n += print(int_part);
+
+  // Print the decimal point, but only if there are digits beyond
+  if (digits > 0) {
+    n += print(".");
+  }
+
+  // Extract digits from the remainder one at a time
+  while (digits-- > 0)
+  {
+    remainder *= 10.0;
+    unsigned int toPrint = (unsigned int)remainder;
+    n += print(toPrint);
+    remainder -= toPrint;
+  }
+
+  return n;
+}
+
+size_t Print::printBuffer(uint8_t const buffer[], int len, char delim, int byteline)
+{
+  if (buffer == NULL || len == 0) return 0;
+
+  for(int i=0; i<len; i++)
+  {
+    if ( i != 0 ) print(delim);
+    if ( byteline && (i%byteline == 0) ) println();
+
+    this->printf("%02X", buffer[i]);
+  }
+
+  return (len*3 - 1);
+}
+
+size_t Print::printBufferReverse(uint8_t const buffer[], int len, char delim, int byteline)
+{
+  if (buffer == NULL || len == 0) return 0;
+
+  for(int i=0; i<len; i++)
+  {
+    if (i != 0) print(delim);
+    if ( byteline && (i%byteline == 0) ) println();
+
+    this->printf("%02X", buffer[len-1-i]);
+  }
+
+  return (len*3 - 1);
+}
+

Packages_Patches/SparkFun/hardware/samd/1.8.3/cores/arduino/Print.h

@@ -0,0 +1,107 @@
+/*
+  Copyright (c) 2016 Arduino LLC.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+  See the GNU Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#pragma once
+
+#include <inttypes.h>
+#include <stdio.h> // for size_t
+
+#include "WString.h"
+#include "Printable.h"
+
+#define DEC 10
+#define HEX 16
+#define OCT 8
+#define BIN 2
+
+class Print
+{
+  private:
+    int write_error;
+    size_t printNumber(unsigned long, uint8_t);
+    size_t printULLNumber(unsigned long long, uint8_t);
+    size_t printFloat(double, int);
+  protected:
+    void setWriteError(int err = 1) { write_error = err; }
+  public:
+    Print() : write_error(0) {}
+
+    int getWriteError() { return write_error; }
+    void clearWriteError() { setWriteError(0); }
+
+    virtual size_t write(uint8_t) = 0;
+    size_t write(const char *str) {
+      if (str == NULL) return 0;
+      return write((const uint8_t *)str, strlen(str));
+    }
+    virtual size_t write(const uint8_t *buffer, size_t size);
+    size_t write(const char *buffer, size_t size) {
+      return write((const uint8_t *)buffer, size);
+    }
+
+    // default to zero, meaning "a single write may block"
+    // should be overridden by subclasses with buffering
+    virtual int availableForWrite() { return 0; }
+
+    size_t print(const __FlashStringHelper *);
+    size_t print(const String &);
+    size_t print(const char[]);
+    size_t print(char);
+    size_t print(unsigned char, int = DEC);
+    size_t print(int, int = DEC);
+    size_t print(unsigned int, int = DEC);
+    size_t print(long, int = DEC);
+    size_t print(unsigned long, int = DEC);
+    size_t print(long long, int = DEC);
+    size_t print(unsigned long long, int = DEC);
+    size_t print(double, int = 2);
+    size_t print(const Printable&);
+
+    size_t println(const __FlashStringHelper *);
+    size_t println(const String &s);
+    size_t println(const char[]);
+    size_t println(char);
+    size_t println(unsigned char, int = DEC);
+    size_t println(int, int = DEC);
+    size_t println(unsigned int, int = DEC);
+    size_t println(long, int = DEC);
+    size_t println(unsigned long, int = DEC);
+    size_t println(long long, int = DEC);
+    size_t println(unsigned long long, int = DEC);
+    size_t println(double, int = 2);
+    size_t println(const Printable&);
+    size_t println(void);
+    
+    size_t printf(const char * format, ...);
+    
+    size_t printBuffer(uint8_t const buffer[], int len, char delim=' ', int byteline = 0);
+    size_t printBuffer(char const buffer[], int size, char delim=' ', int byteline = 0)
+    {
+      return printBuffer((uint8_t const*) buffer, size, delim, byteline);
+    }
+
+    size_t printBufferReverse(uint8_t const buffer[], int len, char delim=' ', int byteline = 0);
+    size_t printBufferReverse(char const buffer[], int size, char delim=' ', int byteline = 0)
+    {
+      return printBufferReverse((uint8_t const*) buffer, size, delim, byteline);
+    }
+
+    virtual void flush() { /* Empty implementation for backward compatibility */ }
+};
+
+

Packages_Patches/SparkFun/hardware/samd/1.8.3/cores/arduino51/Print.cpp

@@ -0,0 +1,420 @@
+/*
+  Copyright (c) 2014 Arduino.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+  See the GNU Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#include <stdlib.h>
+
+#include <stdarg.h>
+
+#include <stdio.h>
+#include <string.h>
+#include <math.h>
+
+#include "Arduino.h"
+
+#include "Print.h"
+
+//using namespace arduino;
+
+// Public Methods //////////////////////////////////////////////////////////////
+
+/* default implementation: may be overridden */
+size_t Print::write(const uint8_t *buffer, size_t size)
+{
+  size_t n = 0;
+  while (size--) {
+    if (write(*buffer++)) n++;
+    else break;
+  }
+  return n;
+}
+
+size_t Print::print(const __FlashStringHelper *ifsh)
+{
+  return print(reinterpret_cast<const char *>(ifsh));
+}
+
+size_t Print::print(const String &s)
+{
+  return write(s.c_str(), s.length());
+}
+
+size_t Print::print(const char str[])
+{
+  return write(str);
+}
+
+size_t Print::print(char c)
+{
+  return write(c);
+}
+
+size_t Print::print(unsigned char b, int base)
+{
+  return print((unsigned long) b, base);
+}
+
+size_t Print::print(int n, int base)
+{
+  return print((long) n, base);
+}
+
+size_t Print::print(unsigned int n, int base)
+{
+  return print((unsigned long) n, base);
+}
+
+size_t Print::print(long n, int base)
+{
+  if (base == 0) {
+    return write(n);
+  } else if (base == 10) {
+    if (n < 0) {
+      int t = print('-');
+      n = -n;
+      return printNumber(n, 10) + t;
+    }
+    return printNumber(n, 10);
+  } else {
+    return printNumber(n, base);
+  }
+}
+
+size_t Print::print(unsigned long n, int base)
+{
+  if (base == 0) return write(n);
+  else return printNumber(n, base);
+}
+
+size_t Print::print(long long n, int base)
+{
+  if (base == 0) {
+    return write(n);
+  } else if (base == 10) {
+    if (n < 0) {
+      int t = print('-');
+      n = -n;
+      return printULLNumber(n, 10) + t;
+    }
+    return printULLNumber(n, 10);
+  } else {
+    return printULLNumber(n, base);
+  }
+}
+
+size_t Print::print(unsigned long long n, int base)
+{
+  if (base == 0) return write(n);
+  else return printULLNumber(n, base);
+}
+
+size_t Print::print(double n, int digits)
+{
+  return printFloat(n, digits);
+}
+
+size_t Print::println(const __FlashStringHelper *ifsh)
+{
+  size_t n = print(ifsh);
+  n += println();
+  return n;
+}
+
+size_t Print::print(const Printable& x)
+{
+  return x.printTo(*this);
+}
+
+size_t Print::println(void)
+{
+  return write("\r\n");
+}
+
+size_t Print::println(const String &s)
+{
+  size_t n = print(s);
+  n += println();
+  return n;
+}
+
+size_t Print::println(const char c[])
+{
+  size_t n = print(c);
+  n += println();
+  return n;
+}
+
+size_t Print::println(char c)
+{
+  size_t n = print(c);
+  n += println();
+  return n;
+}
+
+size_t Print::println(unsigned char b, int base)
+{
+  size_t n = print(b, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(int num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(unsigned int num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(long num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(unsigned long num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(long long num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(unsigned long long num, int base)
+{
+  size_t n = print(num, base);
+  n += println();
+  return n;
+}
+
+size_t Print::println(double num, int digits)
+{
+  size_t n = print(num, digits);
+  n += println();
+  return n;
+}
+
+size_t Print::println(const Printable& x)
+{
+  size_t n = print(x);
+  n += println();
+  return n;
+}
+
+size_t Print::printf(const char * format, ...)
+{
+  char buf[256];
+  int len;
+
+  va_list ap;
+  va_start(ap, format);
+
+  len = vsnprintf(buf, 256, format, ap);
+  this->write(buf, len);
+
+  va_end(ap);
+  return len;
+}
+
+// Private Methods /////////////////////////////////////////////////////////////
+
+size_t Print::printNumber(unsigned long n, uint8_t base)
+{
+  char buf[8 * sizeof(long) + 1]; // Assumes 8-bit chars plus zero byte.
+  char *str = &buf[sizeof(buf) - 1];
+
+  *str = '\0';
+
+  // prevent crash if called with base == 1
+  if (base < 2) base = 10;
+
+  do {
+    char c = n % base;
+    n /= base;
+
+    *--str = c < 10 ? c + '0' : c + 'A' - 10;
+  } while(n);
+
+  return write(str);
+}
+
+// REFERENCE IMPLEMENTATION FOR ULL
+// size_t Print::printULLNumber(unsigned long long n, uint8_t base)
+// {
+  // // if limited to base 10 and 16 the bufsize can be smaller
+  // char buf[65];
+  // char *str = &buf[64];
+
+  // *str = '\0';
+
+  // // prevent crash if called with base == 1
+  // if (base < 2) base = 10;
+
+    // do {
+      // unsigned long long t = n / base;
+      // char c = n - t * base;  // faster than c = n%base;
+      // n = t;
+      // *--str = c < 10 ? c + '0' : c + 'A' - 10;
+  // } while(n);
+
+  // return write(str);
+// }
+
+// FAST IMPLEMENTATION FOR ULL
+size_t Print::printULLNumber(unsigned long long n64, uint8_t base)
+{
+  // if limited to base 10 and 16 the bufsize can be 20
+  char buf[64];
+  uint8_t i = 0;
+  uint8_t innerLoops = 0;
+
+  // prevent crash if called with base == 1
+  if (base < 2) base = 10;
+
+  // process chunks that fit in "16 bit math".
+  uint16_t top = 0xFFFF / base;
+  uint16_t th16 = 1;
+  while (th16 < top)
+  {
+    th16 *= base;
+    innerLoops++;
+  }
+
+  while (n64 > th16)
+  {
+    // 64 bit math part
+    uint64_t q = n64 / th16;
+    uint16_t r = n64 - q*th16;
+    n64 = q;
+
+    // 16 bit math loop to do remainder. (note buffer is filled reverse)
+    for (uint8_t j=0; j < innerLoops; j++)
+    {
+      uint16_t qq = r/base;
+      buf[i++] = r - qq*base;
+      r = qq;
+    }
+  }
+
+  uint16_t n16 = n64;
+  while (n16 > 0)
+  {
+    uint16_t qq = n16/base;
+    buf[i++] = n16 - qq*base;
+    n16 = qq;
+  }
+
+  size_t bytes = i;
+  for (; i > 0; i--)
+    write((char) (buf[i - 1] < 10 ?
+    '0' + buf[i - 1] :
+    'A' + buf[i - 1] - 10));
+
+  return bytes;
+}
+
+size_t Print::printFloat(double number, int digits)
+{
+  if (digits < 0)
+    digits = 2;
+
+  size_t n = 0;
+
+  if (isnan(number)) return print("nan");
+  if (isinf(number)) return print("inf");
+  if (number > 4294967040.0) return print ("ovf");  // constant determined empirically
+  if (number <-4294967040.0) return print ("ovf");  // constant determined empirically
+
+  // Handle negative numbers
+  if (number < 0.0)
+  {
+     n += print('-');
+     number = -number;
+  }
+
+  // Round correctly so that print(1.999, 2) prints as "2.00"
+  double rounding = 0.5;
+  for (uint8_t i=0; i<digits; ++i)
+    rounding /= 10.0;
+
+  number += rounding;
+
+  // Extract the integer part of the number and print it
+  unsigned long int_part = (unsigned long)number;
+  double remainder = number - (double)int_part;
+  n += print(int_part);
+
+  // Print the decimal point, but only if there are digits beyond
+  if (digits > 0) {
+    n += print(".");
+  }
+
+  // Extract digits from the remainder one at a time
+  while (digits-- > 0)
+  {
+    remainder *= 10.0;
+    unsigned int toPrint = (unsigned int)remainder;
+    n += print(toPrint);
+    remainder -= toPrint;
+  }
+
+  return n;
+}
+
+size_t Print::printBuffer(uint8_t const buffer[], int len, char delim, int byteline)
+{
+  if (buffer == NULL || len == 0) return 0;
+
+  for(int i=0; i<len; i++)
+  {
+    if ( i != 0 ) print(delim);
+    if ( byteline && (i%byteline == 0) ) println();
+
+    this->printf("%02X", buffer[i]);
+  }
+
+  return (len*3 - 1);
+}
+
+size_t Print::printBufferReverse(uint8_t const buffer[], int len, char delim, int byteline)
+{
+  if (buffer == NULL || len == 0) return 0;
+
+  for(int i=0; i<len; i++)
+  {
+    if (i != 0) print(delim);
+    if ( byteline && (i%byteline == 0) ) println();
+
+    this->printf("%02X", buffer[len-1-i]);
+  }
+
+  return (len*3 - 1);
+}
+

Packages_Patches/SparkFun/hardware/samd/1.8.3/cores/arduino51/Print.h

@@ -0,0 +1,107 @@
+/*
+  Copyright (c) 2016 Arduino LLC.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+  See the GNU Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#pragma once
+
+#include <inttypes.h>
+#include <stdio.h> // for size_t
+
+#include "WString.h"
+#include "Printable.h"
+
+#define DEC 10
+#define HEX 16
+#define OCT 8
+#define BIN 2
+
+class Print
+{
+  private:
+    int write_error;
+    size_t printNumber(unsigned long, uint8_t);
+    size_t printULLNumber(unsigned long long, uint8_t);
+    size_t printFloat(double, int);
+  protected:
+    void setWriteError(int err = 1) { write_error = err; }
+  public:
+    Print() : write_error(0) {}
+
+    int getWriteError() { return write_error; }
+    void clearWriteError() { setWriteError(0); }
+
+    virtual size_t write(uint8_t) = 0;
+    size_t write(const char *str) {
+      if (str == NULL) return 0;
+      return write((const uint8_t *)str, strlen(str));
+    }
+    virtual size_t write(const uint8_t *buffer, size_t size);
+    size_t write(const char *buffer, size_t size) {
+      return write((const uint8_t *)buffer, size);
+    }
+
+    // default to zero, meaning "a single write may block"
+    // should be overridden by subclasses with buffering
+    virtual int availableForWrite() { return 0; }
+
+    size_t print(const __FlashStringHelper *);
+    size_t print(const String &);
+    size_t print(const char[]);
+    size_t print(char);
+    size_t print(unsigned char, int = DEC);
+    size_t print(int, int = DEC);
+    size_t print(unsigned int, int = DEC);
+    size_t print(long, int = DEC);
+    size_t print(unsigned long, int = DEC);
+    size_t print(long long, int = DEC);
+    size_t print(unsigned long long, int = DEC);
+    size_t print(double, int = 2);
+    size_t print(const Printable&);
+
+    size_t println(const __FlashStringHelper *);
+    size_t println(const String &s);
+    size_t println(const char[]);
+    size_t println(char);
+    size_t println(unsigned char, int = DEC);
+    size_t println(int, int = DEC);
+    size_t println(unsigned int, int = DEC);
+    size_t println(long, int = DEC);
+    size_t println(unsigned long, int = DEC);
+    size_t println(long long, int = DEC);
+    size_t println(unsigned long long, int = DEC);
+    size_t println(double, int = 2);
+    size_t println(const Printable&);
+    size_t println(void);
+    
+    size_t printf(const char * format, ...);
+    
+    size_t printBuffer(uint8_t const buffer[], int len, char delim=' ', int byteline = 0);
+    size_t printBuffer(char const buffer[], int size, char delim=' ', int byteline = 0)
+    {
+      return printBuffer((uint8_t const*) buffer, size, delim, byteline);
+    }
+
+    size_t printBufferReverse(uint8_t const buffer[], int len, char delim=' ', int byteline = 0);
+    size_t printBufferReverse(char const buffer[], int size, char delim=' ', int byteline = 0)
+    {
+      return printBufferReverse((uint8_t const*) buffer, size, delim, byteline);
+    }
+
+    virtual void flush() { /* Empty implementation for backward compatibility */ }
+};
+
+

Packages_Patches/industrialshields/hardware/avr/1.1.36/cores/industrialshields/Udp.h

@@ -0,0 +1,89 @@
+/*
+ *  Udp.cpp: Library to send/receive UDP packets.
+ *
+ * NOTE: UDP is fast, but has some important limitations (thanks to Warren Gray for mentioning these)
+ * 1) UDP does not guarantee the order in which assembled UDP packets are received. This
+ * might not happen often in practice, but in larger network topologies, a UDP
+ * packet can be received out of sequence. 
+ * 2) UDP does not guard against lost packets - so packets *can* disappear without the sender being
+ * aware of it. Again, this may not be a concern in practice on small local networks.
+ * For more information, see http://www.cafeaulait.org/course/week12/35.html
+ *
+ * MIT License:
+ * Copyright (c) 2008 Bjoern Hartmann
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ * bjoern@cs.stanford.edu 12/30/2008
+ */
+
+#ifndef udp_h
+#define udp_h
+
+#include <Stream.h>
+#include <IPAddress.h>
+
+class UDP : public Stream {
+
+public:
+  virtual uint8_t begin(uint16_t) =0;	// initialize, start listening on specified port. Returns 1 if successful, 0 if there are no sockets available to use
+  virtual uint8_t beginMulticast(IPAddress, uint16_t) { return 0; }  // initialize, start listening on specified multicast IP address and port. Returns 1 if successful, 0 on failure
+  virtual void stop() =0;  // Finish with the UDP socket
+
+  // Sending UDP packets
+  
+  // Start building up a packet to send to the remote host specific in ip and port
+  // Returns 1 if successful, 0 if there was a problem with the supplied IP address or port
+  virtual int beginPacket(IPAddress ip, uint16_t port) =0;
+  // Start building up a packet to send to the remote host specific in host and port
+  // Returns 1 if successful, 0 if there was a problem resolving the hostname or port
+  virtual int beginPacket(const char *host, uint16_t port) =0;
+  // Finish off this packet and send it
+  // Returns 1 if the packet was sent successfully, 0 if there was an error
+  virtual int endPacket() =0;
+  // Write a single byte into the packet
+  virtual size_t write(uint8_t) =0;
+  // Write size bytes from buffer into the packet
+  virtual size_t write(const uint8_t *buffer, size_t size) =0;
+
+  // Start processing the next available incoming packet
+  // Returns the size of the packet in bytes, or 0 if no packets are available
+  virtual int parsePacket() =0;
+  // Number of bytes remaining in the current packet
+  virtual int available() =0;
+  // Read a single byte from the current packet
+  virtual int read() =0;
+  // Read up to len bytes from the current packet and place them into buffer
+  // Returns the number of bytes read, or 0 if none are available
+  virtual int read(unsigned char* buffer, size_t len) =0;
+  // Read up to len characters from the current packet and place them into buffer
+  // Returns the number of characters read, or 0 if none are available
+  virtual int read(char* buffer, size_t len) =0;
+  // Return the next byte from the current packet without moving on to the next byte
+  virtual int peek() =0;
+  virtual void flush() =0;	// Finish reading the current packet
+
+  // Return the IP address of the host who sent the current incoming packet
+  virtual IPAddress remoteIP() =0;
+  // Return the port of the host who sent the current incoming packet
+  virtual uint16_t remotePort() =0;
+protected:
+  uint8_t* rawIPAddress(IPAddress& addr) { return addr.raw_address(); };
+};
+
+#endif

Packages_Patches/industrialshields/hardware/avr/1.1.37/cores/industrialshields/Udp.h

@@ -0,0 +1,89 @@
+/*
+ *  Udp.cpp: Library to send/receive UDP packets.
+ *
+ * NOTE: UDP is fast, but has some important limitations (thanks to Warren Gray for mentioning these)
+ * 1) UDP does not guarantee the order in which assembled UDP packets are received. This
+ * might not happen often in practice, but in larger network topologies, a UDP
+ * packet can be received out of sequence. 
+ * 2) UDP does not guard against lost packets - so packets *can* disappear without the sender being
+ * aware of it. Again, this may not be a concern in practice on small local networks.
+ * For more information, see http://www.cafeaulait.org/course/week12/35.html
+ *
+ * MIT License:
+ * Copyright (c) 2008 Bjoern Hartmann
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ * bjoern@cs.stanford.edu 12/30/2008
+ */
+
+#ifndef udp_h
+#define udp_h
+
+#include <Stream.h>
+#include <IPAddress.h>
+
+class UDP : public Stream {
+
+public:
+  virtual uint8_t begin(uint16_t) =0;	// initialize, start listening on specified port. Returns 1 if successful, 0 if there are no sockets available to use
+  virtual uint8_t beginMulticast(IPAddress, uint16_t) { return 0; }  // initialize, start listening on specified multicast IP address and port. Returns 1 if successful, 0 on failure
+  virtual void stop() =0;  // Finish with the UDP socket
+
+  // Sending UDP packets
+  
+  // Start building up a packet to send to the remote host specific in ip and port
+  // Returns 1 if successful, 0 if there was a problem with the supplied IP address or port
+  virtual int beginPacket(IPAddress ip, uint16_t port) =0;
+  // Start building up a packet to send to the remote host specific in host and port
+  // Returns 1 if successful, 0 if there was a problem resolving the hostname or port
+  virtual int beginPacket(const char *host, uint16_t port) =0;
+  // Finish off this packet and send it
+  // Returns 1 if the packet was sent successfully, 0 if there was an error
+  virtual int endPacket() =0;
+  // Write a single byte into the packet
+  virtual size_t write(uint8_t) =0;
+  // Write size bytes from buffer into the packet
+  virtual size_t write(const uint8_t *buffer, size_t size) =0;
+
+  // Start processing the next available incoming packet
+  // Returns the size of the packet in bytes, or 0 if no packets are available
+  virtual int parsePacket() =0;
+  // Number of bytes remaining in the current packet
+  virtual int available() =0;
+  // Read a single byte from the current packet
+  virtual int read() =0;
+  // Read up to len bytes from the current packet and place them into buffer
+  // Returns the number of bytes read, or 0 if none are available
+  virtual int read(unsigned char* buffer, size_t len) =0;
+  // Read up to len characters from the current packet and place them into buffer
+  // Returns the number of characters read, or 0 if none are available
+  virtual int read(char* buffer, size_t len) =0;
+  // Return the next byte from the current packet without moving on to the next byte
+  virtual int peek() =0;
+  virtual void flush() =0;	// Finish reading the current packet
+
+  // Return the IP address of the host who sent the current incoming packet
+  virtual IPAddress remoteIP() =0;
+  // Return the port of the host who sent the current incoming packet
+  virtual uint16_t remotePort() =0;
+protected:
+  uint8_t* rawIPAddress(IPAddress& addr) { return addr.raw_address(); };
+};
+
+#endif

Packages_Patches/realtek/hardware/AmebaD/3.0.10/cores/arduino/avr/pgmspace.h

@@ -0,0 +1,122 @@
+/*
+  pgmspace.h - Definitions for compatibility with AVR pgmspace macros
+
+  Copyright (c) 2015 Arduino LLC
+
+  Based on work of Paul Stoffregen on Teensy 3 (http://pjrc.com)
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in
+  all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+  THE SOFTWARE
+*/
+
+#ifndef __PGMSPACE_H_
+#define __PGMSPACE_H_ 1
+
+#include <inttypes.h>
+
+#define PROGMEM
+#define PGM_P  const char *
+#define PSTR(str) (str)
+
+#define _SFR_BYTE(n) (n)
+
+typedef void prog_void;
+typedef char prog_char;
+typedef unsigned char prog_uchar;
+typedef int8_t prog_int8_t;
+typedef uint8_t prog_uint8_t;
+typedef int16_t prog_int16_t;
+typedef uint16_t prog_uint16_t;
+typedef int32_t prog_int32_t;
+typedef uint32_t prog_uint32_t;
+typedef int64_t prog_int64_t;
+typedef uint64_t prog_uint64_t;
+
+typedef const void* int_farptr_t;
+typedef const void* uint_farptr_t;
+
+#define memchr_P(s, c, n) memchr((s), (c), (n))
+#define memcmp_P(s1, s2, n) memcmp((s1), (s2), (n))
+#define memccpy_P(dest, src, c, n) memccpy((dest), (src), (c), (n))
+#define memcpy_P(dest, src, n) memcpy((dest), (src), (n))
+#define memmem_P(haystack, haystacklen, needle, needlelen) memmem((haystack), (haystacklen), (needle), (needlelen))
+#define memrchr_P(s, c, n) memrchr((s), (c), (n))
+#define strcat_P(dest, src) strcat((dest), (src))
+#define strchr_P(s, c) strchr((s), (c))
+#define strchrnul_P(s, c) strchrnul((s), (c))
+#define strcmp_P(a, b) strcmp((a), (b))
+#define strcpy_P(dest, src) strcpy((dest), (src))
+#define strcasecmp_P(s1, s2) strcasecmp((s1), (s2))
+#define strcasestr_P(haystack, needle) strcasestr((haystack), (needle))
+#define strcspn_P(s, accept) strcspn((s), (accept))
+#define strlcat_P(s1, s2, n) strlcat((s1), (s2), (n))
+#define strlcpy_P(s1, s2, n) strlcpy((s1), (s2), (n))
+#define strlen_P(a) strlen((a))
+#define strnlen_P(s, n) strnlen((s), (n))
+#define strncmp_P(s1, s2, n) strncmp((s1), (s2), (n))
+#define strncasecmp_P(s1, s2, n) strncasecmp((s1), (s2), (n))
+#define strncat_P(s1, s2, n) strncat((s1), (s2), (n))
+#define strncpy_P(s1, s2, n) strncpy((s1), (s2), (n))
+#define strpbrk_P(s, accept) strpbrk((s), (accept))
+#define strrchr_P(s, c) strrchr((s), (c))
+#define strsep_P(sp, delim) strsep((sp), (delim))
+#define strspn_P(s, accept) strspn((s), (accept))
+#define strstr_P(a, b) strstr((a), (b))
+#define strtok_P(s, delim) strtok((s), (delim))
+#define strtok_rP(s, delim, last) strtok((s), (delim), (last))
+
+#define strlen_PF(a) strlen((a))
+#define strnlen_PF(src, len) strnlen((src), (len))
+#define memcpy_PF(dest, src, len) memcpy((dest), (src), (len))
+#define strcpy_PF(dest, src) strcpy((dest), (src))
+#define strncpy_PF(dest, src, len) strncpy((dest), (src), (len))
+#define strcat_PF(dest, src) strcat((dest), (src))
+#define strlcat_PF(dest, src, len) strlcat((dest), (src), (len))
+#define strncat_PF(dest, src, len) strncat((dest), (src), (len))
+#define strcmp_PF(s1, s2) strcmp((s1), (s2))
+#define strncmp_PF(s1, s2, n) strncmp((s1), (s2), (n))
+#define strcasecmp_PF(s1, s2) strcasecmp((s1), (s2))
+#define strncasecmp_PF(s1, s2, n) strncasecmp((s1), (s2), (n))
+#define strstr_PF(s1, s2) strstr((s1), (s2))
+#define strlcpy_PF(dest, src, n) strlcpy((dest), (src), (n))
+#define memcmp_PF(s1, s2, n) memcmp((s1), (s2), (n))
+
+#define sprintf_P(s, f, ...) sprintf((s), (f), __VA_ARGS__)
+#define snprintf_P(s, f, ...) snprintf((s), (f), __VA_ARGS__)
+
+#define pgm_read_byte(addr) (*(const unsigned char *)(addr))
+#define pgm_read_word(addr) (*(const unsigned short *)(addr))
+#define pgm_read_dword(addr) (*(const unsigned long *)(addr))
+#define pgm_read_float(addr) (*(const float *)(addr))
+#define pgm_read_ptr(addr) (*(const void **)(addr))
+
+#define pgm_read_byte_near(addr) pgm_read_byte(addr)
+#define pgm_read_word_near(addr) pgm_read_word(addr)
+#define pgm_read_dword_near(addr) pgm_read_dword(addr)
+#define pgm_read_float_near(addr) pgm_read_float(addr)
+#define pgm_read_ptr_near(addr) pgm_read_ptr(addr)
+
+#define pgm_read_byte_far(addr) pgm_read_byte(addr)
+#define pgm_read_word_far(addr) pgm_read_word(addr)
+#define pgm_read_dword_far(addr) pgm_read_dword(addr)
+#define pgm_read_float_far(addr) pgm_read_float(addr)
+#define pgm_read_ptr_far(addr) pgm_read_ptr(addr)
+
+#define pgm_get_far_address(addr) (&(addr))
+
+#endif

Packages_Patches/realtek/hardware/AmebaD/3.0.8/cores/arduino/avr/pgmspace.h

@@ -0,0 +1,122 @@
+/*
+  pgmspace.h - Definitions for compatibility with AVR pgmspace macros
+
+  Copyright (c) 2015 Arduino LLC
+
+  Based on work of Paul Stoffregen on Teensy 3 (http://pjrc.com)
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in
+  all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+  THE SOFTWARE
+*/
+
+#ifndef __PGMSPACE_H_
+#define __PGMSPACE_H_ 1
+
+#include <inttypes.h>
+
+#define PROGMEM
+#define PGM_P  const char *
+#define PSTR(str) (str)
+
+#define _SFR_BYTE(n) (n)
+
+typedef void prog_void;
+typedef char prog_char;
+typedef unsigned char prog_uchar;
+typedef int8_t prog_int8_t;
+typedef uint8_t prog_uint8_t;
+typedef int16_t prog_int16_t;
+typedef uint16_t prog_uint16_t;
+typedef int32_t prog_int32_t;
+typedef uint32_t prog_uint32_t;
+typedef int64_t prog_int64_t;
+typedef uint64_t prog_uint64_t;
+
+typedef const void* int_farptr_t;
+typedef const void* uint_farptr_t;
+
+#define memchr_P(s, c, n) memchr((s), (c), (n))
+#define memcmp_P(s1, s2, n) memcmp((s1), (s2), (n))
+#define memccpy_P(dest, src, c, n) memccpy((dest), (src), (c), (n))
+#define memcpy_P(dest, src, n) memcpy((dest), (src), (n))
+#define memmem_P(haystack, haystacklen, needle, needlelen) memmem((haystack), (haystacklen), (needle), (needlelen))
+#define memrchr_P(s, c, n) memrchr((s), (c), (n))
+#define strcat_P(dest, src) strcat((dest), (src))
+#define strchr_P(s, c) strchr((s), (c))
+#define strchrnul_P(s, c) strchrnul((s), (c))
+#define strcmp_P(a, b) strcmp((a), (b))
+#define strcpy_P(dest, src) strcpy((dest), (src))
+#define strcasecmp_P(s1, s2) strcasecmp((s1), (s2))
+#define strcasestr_P(haystack, needle) strcasestr((haystack), (needle))
+#define strcspn_P(s, accept) strcspn((s), (accept))
+#define strlcat_P(s1, s2, n) strlcat((s1), (s2), (n))
+#define strlcpy_P(s1, s2, n) strlcpy((s1), (s2), (n))
+#define strlen_P(a) strlen((a))
+#define strnlen_P(s, n) strnlen((s), (n))
+#define strncmp_P(s1, s2, n) strncmp((s1), (s2), (n))
+#define strncasecmp_P(s1, s2, n) strncasecmp((s1), (s2), (n))
+#define strncat_P(s1, s2, n) strncat((s1), (s2), (n))
+#define strncpy_P(s1, s2, n) strncpy((s1), (s2), (n))
+#define strpbrk_P(s, accept) strpbrk((s), (accept))
+#define strrchr_P(s, c) strrchr((s), (c))
+#define strsep_P(sp, delim) strsep((sp), (delim))
+#define strspn_P(s, accept) strspn((s), (accept))
+#define strstr_P(a, b) strstr((a), (b))
+#define strtok_P(s, delim) strtok((s), (delim))
+#define strtok_rP(s, delim, last) strtok((s), (delim), (last))
+
+#define strlen_PF(a) strlen((a))
+#define strnlen_PF(src, len) strnlen((src), (len))
+#define memcpy_PF(dest, src, len) memcpy((dest), (src), (len))
+#define strcpy_PF(dest, src) strcpy((dest), (src))
+#define strncpy_PF(dest, src, len) strncpy((dest), (src), (len))
+#define strcat_PF(dest, src) strcat((dest), (src))
+#define strlcat_PF(dest, src, len) strlcat((dest), (src), (len))
+#define strncat_PF(dest, src, len) strncat((dest), (src), (len))
+#define strcmp_PF(s1, s2) strcmp((s1), (s2))
+#define strncmp_PF(s1, s2, n) strncmp((s1), (s2), (n))
+#define strcasecmp_PF(s1, s2) strcasecmp((s1), (s2))
+#define strncasecmp_PF(s1, s2, n) strncasecmp((s1), (s2), (n))
+#define strstr_PF(s1, s2) strstr((s1), (s2))
+#define strlcpy_PF(dest, src, n) strlcpy((dest), (src), (n))
+#define memcmp_PF(s1, s2, n) memcmp((s1), (s2), (n))
+
+#define sprintf_P(s, f, ...) sprintf((s), (f), __VA_ARGS__)
+#define snprintf_P(s, f, ...) snprintf((s), (f), __VA_ARGS__)
+
+#define pgm_read_byte(addr) (*(const unsigned char *)(addr))
+#define pgm_read_word(addr) (*(const unsigned short *)(addr))
+#define pgm_read_dword(addr) (*(const unsigned long *)(addr))
+#define pgm_read_float(addr) (*(const float *)(addr))
+#define pgm_read_ptr(addr) (*(const void **)(addr))
+
+#define pgm_read_byte_near(addr) pgm_read_byte(addr)
+#define pgm_read_word_near(addr) pgm_read_word(addr)
+#define pgm_read_dword_near(addr) pgm_read_dword(addr)
+#define pgm_read_float_near(addr) pgm_read_float(addr)
+#define pgm_read_ptr_near(addr) pgm_read_ptr(addr)
+
+#define pgm_read_byte_far(addr) pgm_read_byte(addr)
+#define pgm_read_word_far(addr) pgm_read_word(addr)
+#define pgm_read_dword_far(addr) pgm_read_dword(addr)
+#define pgm_read_float_far(addr) pgm_read_float(addr)
+#define pgm_read_ptr_far(addr) pgm_read_ptr(addr)
+
+#define pgm_get_far_address(addr) (&(addr))
+
+#endif

Packages_Patches/realtek/hardware/AmebaD/3.1.0/cores/arduino/avr/pgmspace.h

@@ -0,0 +1,122 @@
+/*
+  pgmspace.h - Definitions for compatibility with AVR pgmspace macros
+
+  Copyright (c) 2015 Arduino LLC
+
+  Based on work of Paul Stoffregen on Teensy 3 (http://pjrc.com)
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in
+  all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+  THE SOFTWARE
+*/
+
+#ifndef __PGMSPACE_H_
+#define __PGMSPACE_H_ 1
+
+#include <inttypes.h>
+
+#define PROGMEM
+#define PGM_P  const char *
+#define PSTR(str) (str)
+
+#define _SFR_BYTE(n) (n)
+
+typedef void prog_void;
+typedef char prog_char;
+typedef unsigned char prog_uchar;
+typedef int8_t prog_int8_t;
+typedef uint8_t prog_uint8_t;
+typedef int16_t prog_int16_t;
+typedef uint16_t prog_uint16_t;
+typedef int32_t prog_int32_t;
+typedef uint32_t prog_uint32_t;
+typedef int64_t prog_int64_t;
+typedef uint64_t prog_uint64_t;
+
+typedef const void* int_farptr_t;
+typedef const void* uint_farptr_t;
+
+#define memchr_P(s, c, n) memchr((s), (c), (n))
+#define memcmp_P(s1, s2, n) memcmp((s1), (s2), (n))
+#define memccpy_P(dest, src, c, n) memccpy((dest), (src), (c), (n))
+#define memcpy_P(dest, src, n) memcpy((dest), (src), (n))
+#define memmem_P(haystack, haystacklen, needle, needlelen) memmem((haystack), (haystacklen), (needle), (needlelen))
+#define memrchr_P(s, c, n) memrchr((s), (c), (n))
+#define strcat_P(dest, src) strcat((dest), (src))
+#define strchr_P(s, c) strchr((s), (c))
+#define strchrnul_P(s, c) strchrnul((s), (c))
+#define strcmp_P(a, b) strcmp((a), (b))
+#define strcpy_P(dest, src) strcpy((dest), (src))
+#define strcasecmp_P(s1, s2) strcasecmp((s1), (s2))
+#define strcasestr_P(haystack, needle) strcasestr((haystack), (needle))
+#define strcspn_P(s, accept) strcspn((s), (accept))
+#define strlcat_P(s1, s2, n) strlcat((s1), (s2), (n))
+#define strlcpy_P(s1, s2, n) strlcpy((s1), (s2), (n))
+#define strlen_P(a) strlen((a))
+#define strnlen_P(s, n) strnlen((s), (n))
+#define strncmp_P(s1, s2, n) strncmp((s1), (s2), (n))
+#define strncasecmp_P(s1, s2, n) strncasecmp((s1), (s2), (n))
+#define strncat_P(s1, s2, n) strncat((s1), (s2), (n))
+#define strncpy_P(s1, s2, n) strncpy((s1), (s2), (n))
+#define strpbrk_P(s, accept) strpbrk((s), (accept))
+#define strrchr_P(s, c) strrchr((s), (c))
+#define strsep_P(sp, delim) strsep((sp), (delim))
+#define strspn_P(s, accept) strspn((s), (accept))
+#define strstr_P(a, b) strstr((a), (b))
+#define strtok_P(s, delim) strtok((s), (delim))
+#define strtok_rP(s, delim, last) strtok((s), (delim), (last))
+
+#define strlen_PF(a) strlen((a))
+#define strnlen_PF(src, len) strnlen((src), (len))
+#define memcpy_PF(dest, src, len) memcpy((dest), (src), (len))
+#define strcpy_PF(dest, src) strcpy((dest), (src))
+#define strncpy_PF(dest, src, len) strncpy((dest), (src), (len))
+#define strcat_PF(dest, src) strcat((dest), (src))
+#define strlcat_PF(dest, src, len) strlcat((dest), (src), (len))
+#define strncat_PF(dest, src, len) strncat((dest), (src), (len))
+#define strcmp_PF(s1, s2) strcmp((s1), (s2))
+#define strncmp_PF(s1, s2, n) strncmp((s1), (s2), (n))
+#define strcasecmp_PF(s1, s2) strcasecmp((s1), (s2))
+#define strncasecmp_PF(s1, s2, n) strncasecmp((s1), (s2), (n))
+#define strstr_PF(s1, s2) strstr((s1), (s2))
+#define strlcpy_PF(dest, src, n) strlcpy((dest), (src), (n))
+#define memcmp_PF(s1, s2, n) memcmp((s1), (s2), (n))
+
+#define sprintf_P(s, f, ...) sprintf((s), (f), __VA_ARGS__)
+#define snprintf_P(s, f, ...) snprintf((s), (f), __VA_ARGS__)
+
+#define pgm_read_byte(addr) (*(const unsigned char *)(addr))
+#define pgm_read_word(addr) (*(const unsigned short *)(addr))
+#define pgm_read_dword(addr) (*(const unsigned long *)(addr))
+#define pgm_read_float(addr) (*(const float *)(addr))
+#define pgm_read_ptr(addr) (*(const void **)(addr))
+
+#define pgm_read_byte_near(addr) pgm_read_byte(addr)
+#define pgm_read_word_near(addr) pgm_read_word(addr)
+#define pgm_read_dword_near(addr) pgm_read_dword(addr)
+#define pgm_read_float_near(addr) pgm_read_float(addr)
+#define pgm_read_ptr_near(addr) pgm_read_ptr(addr)
+
+#define pgm_read_byte_far(addr) pgm_read_byte(addr)
+#define pgm_read_word_far(addr) pgm_read_word(addr)
+#define pgm_read_dword_far(addr) pgm_read_dword(addr)
+#define pgm_read_float_far(addr) pgm_read_float(addr)
+#define pgm_read_ptr_far(addr) pgm_read_ptr(addr)
+
+#define pgm_get_far_address(addr) (&(addr))
+
+#endif

README.md

@@ -149,16 +149,16 @@ This library is based on, modified from:
 
 ## Prerequisites
 
- 1. [`Arduino IDE 1.8.16+` for Arduino](https://www.arduino.cc/en/Main/Software)
+ 1. [`Arduino IDE 1.8.19+` for Arduino](https://www.arduino.cc/en/Main/Software)
  2. [`ESP8266 Core 3.0.2+`](https://github.com/esp8266/Arduino) for ESP8266-based boards. [![Latest release](https://img.shields.io/github/release/esp8266/Arduino.svg)](https://github.com/esp8266/Arduino/releases/latest/)
- 3. [`ESP32 Core 2.0.1+`](https://github.com/espressif/arduino-esp32) for ESP32-based boards. [Latest stable release ![Release Version](https://img.shields.io/github/release/espressif/arduino-esp32.svg?style=plastic)
- 5. [`Arduino Core for STM32 2.1.0+`](https://github.com/stm32duino/Arduino_Core_STM32) for for STM32 using built-in Ethernet LAN8742A. [![GitHub release](https://img.shields.io/github/release/stm32duino/Arduino_Core_STM32.svg)](https://github.com/stm32duino/Arduino_Core_STM32/releases/latest)
+ 3. [`ESP32 Core 2.0.2+`](https://github.com/espressif/arduino-esp32) for ESP32-based boards. [Latest stable release ![Release Version](https://img.shields.io/github/release/espressif/arduino-esp32.svg?style=plastic)
+ 5. [`Arduino Core for STM32 2.2.0+`](https://github.com/stm32duino/Arduino_Core_STM32) for for STM32 using built-in Ethernet LAN8742A. [![GitHub release](https://img.shields.io/github/release/stm32duino/Arduino_Core_STM32.svg)](https://github.com/stm32duino/Arduino_Core_STM32/releases/latest)
  6. [`ESPAsyncTCP v1.2.2+`](https://github.com/me-no-dev/ESPAsyncTCP) for ESP8266.
  7. [`AsyncTCP v1.1.1+`](https://github.com/me-no-dev/AsyncTCP) for ESP32.
  8. [`STM32Ethernet library v1.2.0+`](https://github.com/stm32duino/STM32Ethernet) for STM32 using built-in Ethernet LAN8742A on (Nucleo-144, Discovery). [![GitHub release](https://img.shields.io/github/release/stm32duino/STM32Ethernet.svg)](https://github.com/stm32duino/STM32Ethernet/releases/latest)
  9. [`LwIP library v2.1.2+`](https://github.com/stm32duino/LwIP) for STM32 using built-in Ethernet LAN8742A on (Nucleo-144, Discovery). [![GitHub release](https://img.shields.io/github/release/stm32duino/LwIP.svg)](https://github.com/stm32duino/LwIP/releases/latest)
 10. [`STM32AsyncTCP library v1.0.1+`](https://github.com/khoih-prog/STM32AsyncTCP) for built-in Ethernet on (Nucleo-144, Discovery). To install manually for Arduino IDE.
-11. [`ESPAsync_WiFiManager library v1.9.6+`](https://github.com/khoih-prog/ESPAsync_WiFiManager) for ESP32/ESP8266 using some examples. [![GitHub release](https://img.shields.io/github/release/khoih-prog/ESPAsync_WiFiManager.svg)](https://github.com/khoih-prog/ESPAsync_WiFiManager/releases)
+11. [`ESPAsync_WiFiManager library v1.10.0+`](https://github.com/khoih-prog/ESPAsync_WiFiManager) for ESP32/ESP8266 using some examples. [![GitHub release](https://img.shields.io/github/release/khoih-prog/ESPAsync_WiFiManager.svg)](https://github.com/khoih-prog/ESPAsync_WiFiManager/releases)
 12.  [`LittleFS_esp32 v1.0.6+`](https://github.com/lorol/LITTLEFS) for ESP32-based boards using LittleFS. To install, check [![arduino-library-badge](https://www.ardu-badge.com/badge/LittleFS_esp32.svg?)](https://www.ardu-badge.com/LittleFS_esp32).
 13. [`WebServer_WT32_ETH01 library v1.4.1+`](https://github.com/khoih-prog/WebServer_WT32_ETH01) if necessary to use WT32_ETH01 boards. To install, check [![arduino-library-badge](https://www.ardu-badge.com/badge/WebServer_WT32_ETH01.svg?)](https://www.ardu-badge.com/WebServer_WT32_ETH01)
 
@@ -254,13 +254,22 @@ Thanks to [Roshan](https://github.com/solroshan) to report the issue in [Error e
 
 ### HOWTO Fix `Multiple Definitions` Linker Error
 
-The current library implementation, using xyz-Impl.h instead of standard xyz.cpp, possibly creates certain `Multiple Definitions` Linker error in certain use cases. Although it's simple to just modify several lines of code, either in the library or in the application, the library is adding a separate source directory, named src_cpp, besides the standard src directory.
+The current library implementation, using `xyz-Impl.h` instead of standard `xyz.cpp`, possibly creates certain `Multiple Definitions` Linker error in certain use cases.
 
-To use the old standard cpp way, just 
+You can use
 
-1. **Rename the h-only src directory into src_h.**
-2. **Then rename the cpp src_cpp directory into src.**
-3. Close then reopen the application code in Arduino IDE, etc. to recompile from scratch.
+```
+#include <AsyncHTTPRequest_Generic.h>           //https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+```
+
+in many files. But be sure to use the following `#include <AsyncHTTPRequest_Impl_Generic.h>` **in just 1 `.h`, `.cpp` or `.ino` file**, which must **not be included in any other file**, to avoid `Multiple Definitions` Linker Error
+
+```
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>      // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+```
+
+Have a look at the discussion in [Different behaviour using the src_cpp or src_h lib #80](https://github.com/khoih-prog/ESPAsync_WiFiManager/discussions/80)
 
 ---
 ---
@@ -429,10 +438,16 @@ Please take a look at other examples, as well.
 ```cpp
 #include "defines.h"
 
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
+
 // 600s = 10 minutes to not flooding, 60s in testing
 #define HTTP_REQUEST_INTERVAL_MS     60000  //600000
 
-#include <AsyncHTTPRequest_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                   // https://github.com/sstaub/Ticker
 
@@ -490,6 +505,14 @@ void setup(void)
   Serial.println("\nStart AsyncHTTPRequest_STM32 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif  
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;
@@ -648,44 +671,47 @@ IPAddress ip(192, 168, 2, 232);
 #### 1. [AsyncHTTPRequest_STM32](examples/AsyncHTTPRequest_STM32) running on STM32F7 Nucleo-144 NUCLEO_F767ZI using built-in LAN8742A 
 
 ```
+
 Start AsyncHTTPRequest_STM32 on NUCLEO_F767ZI
-AsyncHTTPRequest_Generic v1.4.1
-AsyncHTTPRequest @ IP : 192.168.2.72
+AsyncHTTPRequest_Generic v1.5.0
+Warning. Must use this example on Version equal or later than : AsyncHTTPRequest_Generic v1.5.0
+AsyncHTTPRequest @ IP : 192.168.2.178
 
 **************************************
-abbreviation: EDT
+abbreviation: EST
 client_ip: aaa.bbb.ccc.ddd
-datetime: 2020-09-13T18:22:59.555816-04:00
-day_of_week: 0
-day_of_year: 257
-dst: true
-dst_from: 2020-03-08T07:00:00+00:00
-dst_offset: 3600
-dst_until: 2020-11-01T06:00:00+00:00
+datetime: 2021-12-30T13:53:51.012921-05:00
+day_of_week: 4
+day_of_year: 364
+dst: false
+dst_from: 
+dst_offset: 0
+dst_until: 
 raw_offset: -18000
 timezone: America/Toronto
-unixtime: 1600035779
-utc_datetime: 2020-09-13T22:22:59.555816+00:00
-utc_offset: -04:00
-week_number: 37
+unixtime: 1640890431
+utc_datetime: 2021-12-30T18:53:51.012921+00:00
+utc_offset: -05:00
+week_number: 52
+**************************************
 
 **************************************
-abbreviation: EDT
+abbreviation: EST
 client_ip: aaa.bbb.ccc.ddd
-datetime: 2020-09-13T18:27:57.586325-04:00
-day_of_week: 0
-day_of_year: 257
-dst: true
-dst_from: 2020-03-08T07:00:00+00:00
-dst_offset: 3600
-dst_until: 2020-11-01T06:00:00+00:00
+datetime: 2021-12-30T13:54:50.320646-05:00
+day_of_week: 4
+day_of_year: 364
+dst: false
+dst_from: 
+dst_offset: 0
+dst_until: 
 raw_offset: -18000
 timezone: America/Toronto
-unixtime: 1600036077
-utc_datetime: 2020-09-13T22:27:57.586325+00:00
-utc_offset: -04:00
-week_number: 37
-**************************************
+unixtime: 1640890490
+utc_datetime: 2021-12-30T18:54:50.320646+00:00
+utc_offset: -05:00
+week_number: 52
+
 ```
 
 ---
@@ -694,28 +720,28 @@ week_number: 37
 
 ```
 Starting AsyncHTTPRequest_ESP_WiFiManager using LittleFS on ESP8266_NODEMCU
-AsyncHTTPRequest_Generic v1.4.1
+AsyncHTTPRequest_Generic v1.5.0
 Stored: SSID = HueNet1, Pass = 12345678
 Got stored Credentials. Timeout 120s
 ConnectMultiWiFi in setup
 After waiting 3.43 secs more in setup(), connection result is connected. Local IP: 192.168.2.186
 H
 **************************************
-abbreviation: EDT
+abbreviation: EST
 client_ip: aaa.bbb.ccc.ddd
-datetime: 2020-09-13T19:35:37.951609-04:00
-day_of_week: 0
-day_of_year: 257
-dst: true
-dst_from: 2020-03-08T07:00:00+00:00
-dst_offset: 3600
-dst_until: 2020-11-01T06:00:00+00:00
+datetime: 2021-12-30T13:54:50.320646-05:00
+day_of_week: 4
+day_of_year: 364
+dst: false
+dst_from: 
+dst_offset: 0
+dst_until: 
 raw_offset: -18000
 timezone: America/Toronto
-unixtime: 1600040137
-utc_datetime: 2020-09-13T23:35:37.951609+00:00
-utc_offset: -04:00
-week_number: 37
+unixtime: 1640890490
+utc_datetime: 2021-12-30T18:54:50.320646+00:00
+utc_offset: -05:00
+week_number: 52
 **************************************
 HHHHHH
 
@@ -727,46 +753,46 @@ HHHHHH
 
 ```
 Starting AsyncHTTPRequest_ESP_WiFiManager using SPIFFS on ESP32_DEV
-AsyncHTTPRequest_Generic v1.4.1
+AsyncHTTPRequest_Generic v1.5.0
 Stored: SSID = HueNet1, Pass = 12345678
 Got stored Credentials. Timeout 120s
 ConnectMultiWiFi in setup
 After waiting 2.35 secs more in setup(), connection result is connected. Local IP: 192.168.2.232
 H
 **************************************
-abbreviation: EDT
+abbreviation: EST
 client_ip: aaa.bbb.ccc.ddd
-datetime: 2020-09-13T19:37:02.118166-04:00
-day_of_week: 0
-day_of_year: 257
-dst: true
-dst_from: 2020-03-08T07:00:00+00:00
-dst_offset: 3600
-dst_until: 2020-11-01T06:00:00+00:00
+datetime: 2021-12-30T13:54:50.320646-05:00
+day_of_week: 4
+day_of_year: 364
+dst: false
+dst_from: 
+dst_offset: 0
+dst_until: 
 raw_offset: -18000
 timezone: America/Toronto
-unixtime: 1600040222
-utc_datetime: 2020-09-13T23:37:02.118166+00:00
-utc_offset: -04:00
-week_number: 37
+unixtime: 1640890490
+utc_datetime: 2021-12-30T18:54:50.320646+00:00
+utc_offset: -05:00
+week_number: 52
 **************************************
 HHHHHHHHH HHHHHHHHHH HHHHHHHHHH H
 **************************************
-abbreviation: EDT
+abbreviation: EST
 client_ip: aaa.bbb.ccc.ddd
-datetime: 2020-09-13T19:42:01.507586-04:00
-day_of_week: 0
-day_of_year: 257
-dst: true
-dst_from: 2020-03-08T07:00:00+00:00
-dst_offset: 3600
-dst_until: 2020-11-01T06:00:00+00:00
+datetime: 2021-12-30T13:56:49.026396-05:00
+day_of_week: 4
+day_of_year: 364
+dst: false
+dst_from: 
+dst_offset: 0
+dst_until: 
 raw_offset: -18000
 timezone: America/Toronto
-unixtime: 1600040521
-utc_datetime: 2020-09-13T23:42:01.507586+00:00
-utc_offset: -04:00
-week_number: 37
+unixtime: 1640890609
+utc_datetime: 2021-12-30T18:56:49.026396+00:00
+utc_offset: -05:00
+week_number: 52
 **************************************
 HHHHHHHHH HHHHHHHHHH HHHHHHHHHH 
 
@@ -778,27 +804,28 @@ HHHHHHHHH HHHHHHHHHH HHHHHHHHHH
 
 ```
 Starting AsyncHTTPRequest_ESP using ESP8266_NODEMCU
-AsyncHTTPRequest_Generic v1.4.1
+AsyncHTTPRequest_Generic v1.5.0
 Connecting to WiFi SSID: HueNet1
 ...........
 HTTP WebServer is @ IP : 192.168.2.81
 
 **************************************
-abbreviation: EDT
+abbreviation: EST
 client_ip: aaa.bbb.ccc.ddd
-datetime: 2020-09-13T19:56:28.295033-04:00
-day_of_week: 0
-day_of_year: 257
-dst: true
-dst_from: 2020-03-08T07:00:00+00:00
-dst_offset: 3600
-dst_until: 2020-11-01T06:00:00+00:00
+datetime: 2021-12-30T14:02:45.199491-05:00
+day_of_week: 4
+day_of_year: 364
+dst: false
+dst_from: 
+dst_offset: 0
+dst_until: 
 raw_offset: -18000
 timezone: America/Toronto
-unixtime: 1600041388
-utc_datetime: 2020-09-13T23:56:28.295033+00:00
-utc_offset: -04:00
-week_number: 37
+unixtime: 1640890965
+utc_datetime: 2021-12-30T19:02:45.199491+00:00
+utc_offset: -05:00
+week_number: 52
+
 **************************************
 HHHHHHHHH HHHHHHHHHH HHHHHHHHHH H
 ```
@@ -810,7 +837,7 @@ HHHHHHHHH HHHHHHHHHH HHHHHHHHHH H
 
 ```
 Start AsyncWebClientRepeating_STM32 on NUCLEO_F767ZI
-AsyncHTTPRequest_Generic v1.4.1
+AsyncHTTPRequest_Generic v1.5.0
 AsyncHTTPRequest @ IP : 192.168.2.72
 
 **************************************
@@ -865,7 +892,7 @@ AsyncHTTPRequest @ IP : 192.168.2.72
 
 ```
 Start AsyncWebClientRepeating_STM32_LAN8720 on BLACK_F407VE
-AsyncHTTPRequest_Generic v1.4.1
+AsyncHTTPRequest_Generic v1.5.0
 AsyncHTTPRequest @ IP : 192.168.2.150
 
 
@@ -921,7 +948,7 @@ AsyncHTTPRequest @ IP : 192.168.2.150
 ```
 Starting AsyncHTTPRequest_WT32_ETH01 on ESP32_DEV with ETH_PHY_LAN8720
 WebServer_WT32_ETH01 v1.4.1
-AsyncHTTPRequest_Generic v1.4.1
+AsyncHTTPRequest_Generic v1.5.0
 ETH MAC: A8:03:2A:A1:61:73, IPv4: 192.168.2.232, FULL_DUPLEX, 100Mbps
 AsyncHTTPRequest @ IP : 192.168.2.232
 
@@ -947,26 +974,27 @@ H
 ```
 Starting AsyncHTTPRequest_WT32_ETH01 on ESP32_DEV with ETH_PHY_LAN8720
 WebServer_WT32_ETH01 v1.4.1
-AsyncHTTPRequest_Generic v1.4.1
+AsyncHTTPRequest_Generic v1.5.0
 ETH MAC: A8:03:2A:A1:61:73, IPv4: 192.168.2.232, FULL_DUPLEX, 100Mbps
 AsyncHTTPRequest @ IP : 192.168.2.232
 
 **************************************
-abbreviation: EDT
-client_ip: 45.72.193.56
-datetime: 2021-07-09T23:16:50.506413-04:00
-day_of_week: 5
-day_of_year: 190
-dst: true
-dst_from: 2021-03-14T07:00:00+00:00
-dst_offset: 3600
-dst_until: 2021-11-07T06:00:00+00:00
+abbreviation: EST
+client_ip: aaa.bbb.ccc.ddd
+datetime: 2021-12-30T14:08:41.290808-05:00
+day_of_week: 4
+day_of_year: 364
+dst: false
+dst_from: 
+dst_offset: 0
+dst_until: 
 raw_offset: -18000
 timezone: America/Toronto
-unixtime: 1625887010
-utc_datetime: 2021-07-10T03:16:50.506413+00:00
-utc_offset: -04:00
-week_number: 27
+unixtime: 1640891321
+utc_datetime: 2021-12-30T19:08:41.290808+00:00
+utc_offset: -05:00
+week_number: 52
+
 **************************************
 ```
 
@@ -1021,6 +1049,8 @@ Submit issues to: [AsyncHTTPRequest_Generic issues](https://github.com/khoih-pro
  6. Add support to **WT32_ETH01** using ESP32-based boards and LAN8720 Ethernet
  7. Auto detect ESP32 core to use for WT32_ETH01
  8. Fix bug in WT32_ETH01 examples to reduce connection time
+ 9. Fix `multiple-definitions` linker error and weird bug related to `src_cpp`.
+10. Optimize library code by using `reference-passing` instead of `value-passing`
 
 ---
 ---

changelog.md

@@ -12,6 +12,7 @@
 ## Table of Contents
 
 * [Changelog](#changelog)
+  * [Releases v1.5.0](#releases-v150)
   * [Releases v1.4.1](#releases-v141)
   * [Releases v1.4.0](#releases-v140)
   * [Releases v1.3.1](#releases-v131)
@@ -32,6 +33,12 @@
 
 ## Changelog
 
+### Releases v1.5.0
+
+1. Fix `multiple-definitions` linker error and weird bug related to `src_cpp`. Check [Different behaviour using the src_cpp or src_h lib #80](https://github.com/khoih-prog/ESPAsync_WiFiManager/discussions/80)
+2. Optimize library code by using `reference-passing` instead of `value-passing`
+3. Update all examples
+
 #### Releases v1.4.1
 
 ##### Warning: Releases v1.4.1+ can be used and autodetect ESP32 core v2.0.0+ or v1.0.6- for WT32_ETH01

examples/AsyncCustomHeader_STM32/AsyncCustomHeader_STM32.ino

@@ -24,10 +24,16 @@
 //char GET_ServerAddress[]      = "192.168.2.110/";
 char GET_ServerAddress[]    = "http://worldtimeapi.org/api/timezone/America/Toronto.txt";
 
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
+
 // 600s = 10 minutes to not flooding, 60s in testing
 #define HTTP_REQUEST_INTERVAL_MS     60000  //600000
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                             // https://github.com/sstaub/Ticker
 
@@ -86,6 +92,14 @@ void setup(void)
   Serial.println("\nStart AsyncCustomHeader_STM32 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/AsyncDweetGet_STM32/AsyncDweetGet_STM32.ino

@@ -35,10 +35,16 @@ const char GET_ServerAddress[] = "dweet.io";
 // use your own thing name here
 String dweetName = "/dweet/for/currentSecond?second=";
 
-// 60s = 60 seconds to not flooding the server
-#define HTTP_REQUEST_INTERVAL_MS     60000
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+// 600s = 10 minutes to not flooding, 60s in testing
+#define HTTP_REQUEST_INTERVAL_MS     60000  //600000
+
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                             // https://github.com/sstaub/Ticker
 
@@ -134,6 +140,14 @@ void setup(void)
   Serial.println("\nStart AsyncDweetGET_STM32 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/AsyncDweetPost_STM32/AsyncDweetPost_STM32.ino

@@ -29,10 +29,16 @@ const char POST_ServerAddress[] = "dweet.io";
 // use your own thing name here
 String dweetName = "/dweet/for/pinA0-Read?";
 
-// 60s = 60 seconds to not flooding the server
-#define HTTP_REQUEST_INTERVAL_MS     10000
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+// 600s = 10 minutes to not flooding, 60s in testing
+#define HTTP_REQUEST_INTERVAL_MS     60000  //600000
+
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                             // https://github.com/sstaub/Ticker
 
@@ -133,6 +139,14 @@ void setup(void)
   Serial.println("\nStart AsyncDweetPOST_STM32 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/AsyncHTTPMultiRequests_ESP/AsyncHTTPMultiRequests_ESP.ino

@@ -44,6 +44,12 @@
   #error This code is intended to run on the ESP8266 or ESP32 platform! Please check your Tools->Board setting.
 #endif
 
+#define ESP_WIFIMANAGER_VERSION_MIN_TARGET                  "ESP_WiFiManager v1.8.0"
+#define ESP_WIFIMANAGER_VERSION_MIN                         1008000
+
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET       "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN              1005000
+
 // Level from 0-4
 #define ASYNC_HTTP_DEBUG_PORT     Serial
 #define _ASYNC_HTTP_LOGLEVEL_     1
@@ -65,7 +71,11 @@ const char* password    = "your_pass";
   #include <WiFi.h>
 #endif
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
 #include <Ticker.h>
 
 AsyncHTTPRequest request;
@@ -172,6 +182,14 @@ void setup()
   
   Serial.println("\nStarting AsyncHTTPMultiRequests using " + String(ARDUINO_BOARD));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
+  
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
 
   WiFi.mode(WIFI_STA);
 

examples/AsyncHTTPRequest_ESP/AsyncHTTPRequest_ESP.ino

@@ -65,7 +65,14 @@ const char* password    = "your_pass";
   #include <WiFi.h>
 #endif
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
+
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
 #include <Ticker.h>
 
 AsyncHTTPRequest request;

examples/AsyncHTTPRequest_ESP_WiFiManager/AsyncHTTPRequest_ESP_WiFiManager.ino

@@ -46,6 +46,12 @@
   #error This code is intended to run on the ESP8266 or ESP32 platform! Please check your Tools->Board setting.
 #endif
 
+#define ESP_ASYNC_WIFIMANAGER_VERSION_MIN_TARGET          "ESPAsync_WiFiManager v1.10.0"
+#define ESP_ASYNC_WIFIMANAGER_VERSION_MIN                 1010000
+
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
+
 // Level from 0-4
 #define ASYNC_HTTP_DEBUG_PORT     Serial
 
@@ -238,12 +244,19 @@ IPAddress APStaticSN  = IPAddress(255, 255, 255, 0);
 
 #include <ESPAsync_WiFiManager.h>              //https://github.com/khoih-prog/ESPAsync_WiFiManager
 
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <ESPAsync_WiFiManager-Impl.h>         //https://github.com/khoih-prog/ESPAsync_WiFiManager
+
 #define HTTP_PORT           80
 
 AsyncWebServer webServer(HTTP_PORT);
 DNSServer dnsServer;
 
-#include <AsyncHTTPRequest_Generic.h>         // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
 #include <Ticker.h>
 
 AsyncHTTPRequest request;
@@ -549,6 +562,22 @@ void setup()
   Serial.println(ESP_ASYNC_WIFIMANAGER_VERSION);
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ESP_ASYNC_WIFIMANAGER_VERSION_INT)
+  if (ESP_ASYNC_WIFIMANAGER_VERSION_INT < ESP_ASYNC_WIFIMANAGER_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version later than : ");
+    Serial.println(ESP_ASYNC_WIFIMANAGER_VERSION_MIN_TARGET);
+  }
+#endif
+
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   if (FORMAT_FILESYSTEM) 
     FileFS.format();
 

examples/AsyncHTTPRequest_STM32/AsyncHTTPRequest_STM32.ino

@@ -42,10 +42,16 @@
 
 #include "defines.h"
 
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
+
 // 600s = 10 minutes to not flooding, 60s in testing
 #define HTTP_REQUEST_INTERVAL_MS     60000  //600000
 
-#include <AsyncHTTPRequest_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                   // https://github.com/sstaub/Ticker
 
@@ -103,6 +109,14 @@ void setup(void)
   Serial.println("\nStart AsyncHTTPRequest_STM32 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif  
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/AsyncSimpleGET_STM32/AsyncSimpleGET_STM32.ino

@@ -24,10 +24,16 @@
 //char GET_ServerAddress[]    = "ipv4bot.whatismyipaddress.com/";
 char GET_ServerAddress[]    = "http://worldtimeapi.org/api/timezone/America/Toronto.txt";
 
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
+
 // 600s = 10 minutes to not flooding, 60s in testing
 #define HTTP_REQUEST_INTERVAL_MS     60000  //600000
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                             // https://github.com/sstaub/Ticker
 
@@ -84,6 +90,14 @@ void setup(void)
   Serial.println("\nStart AsyncSimpleGET_STM32 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/AsyncWebClientRepeating_STM32/AsyncWebClientRepeating_STM32.ino

@@ -26,10 +26,16 @@ const char GET_ServerAddress[] = "arduino.cc";
 // GET location
 String GET_Location = "/asciilogo.txt";
 
-// 60s = 60 seconds to not flooding the server
-#define HTTP_REQUEST_INTERVAL_MS     60000
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+// 600s = 10 minutes to not flooding, 60s in testing
+#define HTTP_REQUEST_INTERVAL_MS     60000  //600000
+
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                             // https://github.com/sstaub/Ticker
 
@@ -86,6 +92,13 @@ void setup(void)
   Serial.println("\nStart AsyncWebClientRepeating_STM32 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/STM32_LAN8720/AsyncCustomHeader_STM32_LAN8720/AsyncCustomHeader_STM32_LAN8720.ino

@@ -24,10 +24,16 @@
 //char GET_ServerAddress[]      = "192.168.2.110/";
 char GET_ServerAddress[]    = "http://worldtimeapi.org/api/timezone/America/Toronto.txt";
 
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
+
 // 600s = 10 minutes to not flooding, 60s in testing
 #define HTTP_REQUEST_INTERVAL_MS     60000  //600000
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                             // https://github.com/sstaub/Ticker
 
@@ -86,6 +92,14 @@ void setup(void)
   Serial.println("\nStart AsyncCustomHeader_STM32_LAN8720 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/STM32_LAN8720/AsyncDweetGet_STM32_LAN8720/AsyncDweetGet_STM32_LAN8720.ino

@@ -35,10 +35,16 @@ const char GET_ServerAddress[] = "dweet.io";
 // use your own thing name here
 String dweetName = "/dweet/for/currentSecond?second=";
 
-// 60s = 60 seconds to not flooding the server
-#define HTTP_REQUEST_INTERVAL_MS     60000
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+// 600s = 10 minutes to not flooding, 60s in testing
+#define HTTP_REQUEST_INTERVAL_MS     60000  //600000
+
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                             // https://github.com/sstaub/Ticker
 
@@ -134,6 +140,14 @@ void setup(void)
   Serial.println("\nStart AsyncDweetGET_STM32_LAN8720 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/STM32_LAN8720/AsyncDweetPost_STM32_LAN8720/AsyncDweetPost_STM32_LAN8720.ino

@@ -29,10 +29,16 @@ const char POST_ServerAddress[] = "dweet.io";
 // use your own thing name here
 String dweetName = "/dweet/for/pinA0-Read?";
 
-// 60s = 60 seconds to not flooding the server
-#define HTTP_REQUEST_INTERVAL_MS     10000
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+// 600s = 10 minutes to not flooding, 60s in testing
+#define HTTP_REQUEST_INTERVAL_MS     60000  //600000
+
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                             // https://github.com/sstaub/Ticker
 
@@ -133,6 +139,14 @@ void setup(void)
   Serial.println("\nStart AsyncDweetPOST_STM32_LAN8720 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/STM32_LAN8720/AsyncHTTPRequest_STM32_LAN8720/AsyncHTTPRequest_STM32_LAN8720.ino

@@ -42,10 +42,16 @@
 
 #include "defines.h"
 
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
+
 // 600s = 10 minutes to not flooding, 60s in testing
 #define HTTP_REQUEST_INTERVAL_MS     60000  //600000
 
-#include <AsyncHTTPRequest_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                   // https://github.com/sstaub/Ticker
 
@@ -103,6 +109,14 @@ void setup(void)
   Serial.println("\nStart AsyncHTTPRequest_STM32_LAN8720 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/STM32_LAN8720/AsyncSimpleGET_STM32_LAN8720/AsyncSimpleGET_STM32_LAN8720.ino

@@ -24,10 +24,16 @@
 //char GET_ServerAddress[]    = "ipv4bot.whatismyipaddress.com/";
 char GET_ServerAddress[]    = "http://worldtimeapi.org/api/timezone/America/Toronto.txt";
 
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
+
 // 600s = 10 minutes to not flooding, 60s in testing
 #define HTTP_REQUEST_INTERVAL_MS     60000  //600000
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                             // https://github.com/sstaub/Ticker
 
@@ -84,6 +90,14 @@ void setup(void)
   Serial.println("\nStart AsyncSimpleGET_STM32_LAN8720 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/STM32_LAN8720/AsyncWebClientRepeating_STM32_LAN8720/AsyncWebClientRepeating_STM32_LAN8720.ino

@@ -26,10 +26,16 @@ const char GET_ServerAddress[] = "arduino.cc";
 // GET location
 String GET_Location = "/asciilogo.txt";
 
-// 60s = 60 seconds to not flooding the server
-#define HTTP_REQUEST_INTERVAL_MS     60000
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+// 600s = 10 minutes to not flooding, 60s in testing
+#define HTTP_REQUEST_INTERVAL_MS     60000  //600000
+
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
 
 #include <Ticker.h>                             // https://github.com/sstaub/Ticker
 
@@ -86,6 +92,14 @@ void setup(void)
   Serial.println("\nStart AsyncWebClientRepeating_STM32_LAN8720 on " + String(BOARD_NAME));
   Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // start the ethernet connection and the server
   // Use random mac
   uint16_t index = millis() % NUMBER_OF_MAC;

examples/WT32_ETH01/AsyncHTTPMultiRequests_WT32_ETH01/AsyncHTTPMultiRequests_WT32_ETH01.ino

@@ -57,7 +57,14 @@
 
 #include <WebServer_WT32_ETH01.h>               // https://github.com/khoih-prog/WebServer_WT32_ETH01
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
+
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
 #include <Ticker.h>
 
 AsyncHTTPRequest request;
@@ -184,6 +191,14 @@ void setup()
 
   Serial.setDebugOutput(true);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // To be called before ETH.begin()
   WT32_ETH01_onEvent();
 

examples/WT32_ETH01/AsyncHTTPRequest_WT32_ETH01/AsyncHTTPRequest_WT32_ETH01.ino

@@ -57,7 +57,14 @@
 
 #include <WebServer_WT32_ETH01.h>               // https://github.com/khoih-prog/WebServer_WT32_ETH01
 
-#include <AsyncHTTPRequest_Generic.h>           // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET      "AsyncHTTPRequest_Generic v1.5.0"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN             1005000
+
+#include <AsyncHTTPRequest_Generic.h>             // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include <AsyncHTTPRequest_Impl_Generic.h>        // https://github.com/khoih-prog/AsyncHTTPRequest_Generic
+
 #include <Ticker.h>
 
 AsyncHTTPRequest request;
@@ -150,6 +157,14 @@ void setup()
 
   Serial.setDebugOutput(true);
 
+#if defined(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  if (ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT < ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN)
+  {
+    Serial.print("Warning. Must use this example on Version equal or later than : ");
+    Serial.println(ASYNC_HTTP_REQUEST_GENERIC_VERSION_MIN_TARGET);
+  }
+#endif
+
   // To be called before ETH.begin()
   WT32_ETH01_onEvent();
 

keywords.txt

@@ -40,6 +40,12 @@ version  KEYWORD2
 # Constants (LITERAL1)
 #######################################
 
+ASYNC_HTTP_REQUEST_GENERIC_VERSION  LITERAL1
+ASYNC_HTTP_REQUEST_GENERIC_VERSION_MAJOR  LITERAL1
+ASYNC_HTTP_REQUEST_GENERIC_VERSION_MINOR  LITERAL1
+ASYNC_HTTP_REQUEST_GENERIC_VERSION_PATCH  LITERAL1
+ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT  LITERAL1
+
 HTTPCODE_CONNECTION_REFUSED LITERAL1
 HTTPCODE_SEND_HEADER_FAILED LITERAL1
 HTTPCODE_SEND_PAYLOAD_FAILED  LITERAL1

library.json

@@ -1,6 +1,6 @@
 {
   "name":"AsyncHTTPRequest_Generic",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description":"Simple Async HTTP Request library, supporting GET, POST, PUT, PATCH, DELETE and HEAD, on top of AsyncTCP libraries, such as AsyncTCP, ESPAsyncTCP, AsyncTCP_STM32, etc.. for ESP32 (including ESP32-S2), WT32_ETH01 (ESP32 + LAN8720), ESP8266 and currently STM32 with LAN8720 or built-in LAN8742A Ethernet.",
   "keywords":"communication, async, tcp, http, ESP8266, ESP32, ESP32-S2, wt32-eth01, ESPAsyncTCP, AsyncTCP, stm32, ethernet, wifi, lan8742a, lan8720, f407ve, nucleo, nucleo-144, stm32f7, stm32f4",
   "authors": [

library.properties

@@ -1,5 +1,5 @@
 name=AsyncHTTPRequest_Generic
-version=1.4.1
+version=1.5.0
 author=Bob Lemaire,Khoi Hoang <khoih.prog@gmail.com>
 maintainer=Khoi Hoang <khoih.prog@gmail.com>
 license=MIT

platformio/platformio.ini

@@ -43,7 +43,7 @@ lib_deps =
 ;  https://github.com/khoih-prog/STM32AsyncTCP.git
 ;  STM32duino LwIP@>=2.1.2
 ;  STM32duino STM32Ethernet@>=1.2.0
-;  ESPAsync_WiFiManager@>=1.9.6
+;  ESPAsync_WiFiManager@>=1.10.0
 ;  LittleFS_esp32@>=1.0.6
 ;  WebServer_WT32_ETH01@>=1.4.1
 ; PlatformIO 5.x  
@@ -53,7 +53,7 @@ lib_deps =
 ; https://github.com/khoih-prog/STM32AsyncTCP.git
 ; stm32duino/STM32duino LwIP@>=2.1.2
 ; stm32duino/STM32duino STM32Ethernet@>=1.2.0
- khoih-prog/ESPAsync_WiFiManager@>=1.9.6
+ khoih-prog/ESPAsync_WiFiManager@>=1.10.0
  lorol/LittleFS_esp32@>=1.0.6
 ; khoih-prog/WebServer_WT32_ETH01@>=1.4.1
   

src/AsyncHTTPRequest_Debug_Generic.h

@@ -17,7 +17,7 @@
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
   You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
  
-  Version: 1.4.1
+  Version: 1.5.0
   
   Version Modified By   Date      Comments
   ------- -----------  ---------- -----------
@@ -35,6 +35,7 @@
   1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
   1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
   1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
+  1.5.0    K Hoang     30/12/2021 Fix `multiple-definitions` linker error
  *****************************************************************************************************************************/
 
 #pragma once

src/AsyncHTTPRequest_Generic.h

@@ -17,7 +17,7 @@
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
   You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
  
-  Version: 1.4.1
+  Version: 1.5.0
   
   Version Modified By   Date      Comments
   ------- -----------  ---------- -----------
@@ -35,6 +35,7 @@
   1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
   1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
   1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
+  1.5.0    K Hoang     30/12/2021 Fix `multiple-definitions` linker error
  *****************************************************************************************************************************/
 
 #pragma once
@@ -42,7 +43,13 @@
 #ifndef ASYNC_HTTP_REQUEST_GENERIC_H
 #define ASYNC_HTTP_REQUEST_GENERIC_H
 
-#define ASYNC_HTTP_REQUEST_GENERIC_VERSION   "AsyncHTTPRequest_Generic v1.4.1"
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION            "AsyncHTTPRequest_Generic v1.5.0"
+
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MAJOR      1
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_MINOR      5
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_PATCH      0
+
+#define ASYNC_HTTP_REQUEST_GENERIC_VERSION_INT        1005000
 
 #include <Arduino.h>
 
@@ -98,7 +105,110 @@
 #endif
 
 #include <pgmspace.h>
-#include <utility/xbuf.h>
+
+// Merge xbuf
+////////////////////////////////////////////////////////////////////////////
+
+struct xseg 
+{
+  xseg    *next;
+  uint8_t data[];
+};
+
+class xbuf: public Print 
+{
+  public:
+
+    xbuf(const uint16_t segSize = 64);
+    virtual ~xbuf();
+
+    size_t      write(const uint8_t);
+    size_t      write(const char*);
+    size_t      write(const uint8_t*, const size_t);
+    size_t      write(xbuf*, const size_t);
+    size_t      write(const String& string);
+    size_t      available();
+    int         indexOf(const char, const size_t begin = 0);
+    int         indexOf(const char*, const size_t begin = 0);
+    uint8_t     read();
+    size_t      read(uint8_t*, size_t);
+    String      readStringUntil(const char);
+    String      readStringUntil(const char*);
+    String      readString(int);
+    
+    String      readString() 
+    {
+      return readString(available());
+    }
+    
+    void        flush();
+
+    uint8_t     peek();
+    size_t      peek(uint8_t*, const size_t);
+    
+    String      peekStringUntil(const char target) 
+    {
+      return peekString(indexOf(target, 0));
+    }
+    
+    String      peekStringUntil(const char* target) 
+    {
+      return peekString(indexOf(target, 0));
+    }
+    
+    String      peekString() 
+    {
+      return peekString(_used);
+    }
+    
+    String      peekString(int);
+
+    /*      In addition to the above functions,
+    the following inherited functions from the Print class are available.
+    
+    size_t printf(const char * format, ...)  __attribute__ ((format (printf, 2, 3)));
+    size_t printf_P(PGM_P format, ...) __attribute__((format(printf, 2, 3)));
+    size_t print(const __FlashStringHelper *);
+    size_t print(const String &);
+    size_t print(const char[]);
+    size_t print(char);
+    size_t print(unsigned char, int = DEC);
+    size_t print(int, int = DEC);
+    size_t print(unsigned int, int = DEC);
+    size_t print(long, int = DEC);
+    size_t print(unsigned long, int = DEC);
+    size_t print(double, int = 2);
+    size_t print(const Printable&);
+    
+    size_t println(const __FlashStringHelper *);
+    size_t println(const String &s);
+    size_t println(const char[]);
+    size_t println(char);
+    size_t println(unsigned char, int = DEC);
+    size_t println(int, int = DEC);
+    size_t println(unsigned int, int = DEC);
+    size_t println(long, int = DEC);
+    size_t println(unsigned long, int = DEC);
+    size_t println(double, int = 2);
+    size_t println(const Printable&);
+    size_t println(void);
+    */
+
+  protected:
+
+    xseg        *_head;
+    xseg        *_tail;
+    uint16_t     _used;
+    uint16_t     _free;
+    uint16_t     _offset;
+    uint16_t     _segSize;
+
+    void        addSeg();
+    void        remSeg();
+
+};
+
+////////////////////////////////////////////////////////////////////////////
 
 #define DEBUG_HTTP(format,...)  if(_debug){\
     DEBUG_IOTA_PORT.printf("Debug(%3ld): ", millis()-_requestStartTime);\
@@ -205,7 +315,7 @@ class AsyncHTTPRequest
 #endif
 
     bool        send();                                                 // Send the request (GET)
-    bool        send(String body);                                      // Send the request (POST)
+    bool        send(const String& body);                                      // Send the request (POST)
     bool        send(const char* body);                                 // Send the request (POST)
     bool        send(const uint8_t* buffer, size_t len);                // Send the request (POST) (binary data?)
     bool        send(xbuf* body, size_t len);                           // Send the request (POST) data in an xbuf
@@ -292,7 +402,7 @@ class AsyncHTTPRequest
     header*     _getHeader(int);
     bool        _buildRequest();
     bool        _parseURL(const char*);
-    bool        _parseURL(String);
+    bool        _parseURL(const String& url);
     void        _processChunks();
     bool        _connect();
     size_t      _send();
@@ -312,6 +422,4 @@ class AsyncHTTPRequest
     bool        _collectHeaders();
 };
 
-#include "AsyncHTTPRequest_Impl_Generic.h"
-
 #endif    // ASYNC_HTTP_REQUEST_GENERIC_H

src/AsyncHTTPRequest_Impl_Generic.h

@@ -17,7 +17,7 @@
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
   You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
  
-  Version: 1.4.1
+  Version: 1.5.0
   
   Version Modified By   Date      Comments
   ------- -----------  ---------- -----------
@@ -35,6 +35,7 @@
   1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
   1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
   1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
+  1.5.0    K Hoang     30/12/2021 Fix `multiple-definitions` linker error
  *****************************************************************************************************************************/
  
 #pragma once
@@ -44,6 +45,394 @@
 
 #define CANT_SEND_BAD_REQUEST       F("Can't send() bad request")
 
+// Merge xbuf
+////////////////////////////////////////////////////////////////////////////
+
+xbuf::xbuf(const uint16_t segSize) : _head(nullptr), _tail(nullptr), _used(0), _free(0), _offset(0) 
+{
+  _segSize = (segSize + 3) & -4;//((segSize + 3) >> 2) << 2;
+}
+
+//*******************************************************************************************************************
+xbuf::~xbuf() 
+{
+  flush();
+}
+
+//*******************************************************************************************************************
+size_t xbuf::write(const uint8_t byte) 
+{
+  return write((uint8_t*) &byte, 1);
+}
+
+//*******************************************************************************************************************
+size_t xbuf::write(const char* buf) 
+{
+  return write((uint8_t*)buf, strlen(buf));
+}
+
+//*******************************************************************************************************************
+size_t xbuf::write(const String& string) 
+{
+  return write((uint8_t*)string.c_str(), string.length());
+}
+
+//*******************************************************************************************************************
+size_t xbuf::write(const uint8_t* buf, const size_t len) 
+{
+  size_t supply = len;
+  
+  while (supply) 
+  {
+    if (!_free) 
+    {
+      addSeg();
+    }
+    
+    size_t demand = _free < supply ? _free : supply;
+    memcpy(_tail->data + ((_offset + _used) % _segSize), buf + (len - supply), demand);
+    _free -= demand;
+    _used += demand;
+    supply -= demand;
+  }
+  
+  return len;
+}
+
+//*******************************************************************************************************************
+size_t xbuf::write(xbuf* buf, const size_t len) 
+{
+  size_t supply = len;
+  
+  if (supply > buf->available()) 
+  {
+    supply = buf->available();
+  }
+  
+  size_t read = 0;
+  
+  while (supply) 
+  {
+    if (!_free) 
+    {
+      addSeg();
+    }
+    
+    size_t demand = _free < supply ? _free : supply;
+    read += buf->read(_tail->data + ((_offset + _used) % _segSize), demand);
+    _free -= demand;
+    _used += demand;
+    supply -= demand;
+  }
+  
+  return read;
+}
+
+//*******************************************************************************************************************
+uint8_t xbuf::read() 
+{
+  uint8_t byte = 0;
+  read((uint8_t*) &byte, 1);
+  
+  return byte;
+}
+
+//*******************************************************************************************************************
+uint8_t xbuf::peek() 
+{
+  uint8_t byte = 0;
+  peek((uint8_t*) &byte, 1);
+  
+  return byte;
+}
+
+//*******************************************************************************************************************
+size_t xbuf::read(uint8_t* buf, const size_t len) 
+{
+  size_t read = 0;
+  
+  while (read < len && _used) 
+  {
+    size_t supply = (_offset + _used) > _segSize ? _segSize - _offset : _used;
+    size_t demand = len - read;
+    size_t chunk = supply < demand ? supply : demand;
+    memcpy(buf + read, _head->data + _offset, chunk);
+    _offset += chunk;
+    _used -= chunk;
+    read += chunk;
+    
+    if (_offset == _segSize) 
+    {
+      remSeg();
+      _offset = 0;
+    }
+  }
+  
+  if ( ! _used) 
+  {
+    flush();
+  }
+  
+  return read;
+}
+
+//*******************************************************************************************************************
+size_t xbuf::peek(uint8_t* buf, const size_t len) 
+{
+  size_t read   = 0;
+  xseg* seg     = _head;
+  size_t offset = _offset;
+  size_t used   = _used;
+  
+  while (read < len && used) 
+  {
+    size_t supply = (offset + used) > _segSize ? _segSize - offset : used;
+    size_t demand = len - read;
+    size_t chunk  = supply < demand ? supply : demand;
+    
+    memcpy(buf + read, seg->data + offset, chunk);
+    
+    offset  += chunk;
+    used    -= chunk;
+    read    += chunk;
+    
+    if (offset == _segSize) 
+    {
+      seg = seg->next;
+      offset = 0;
+    }
+  }
+  
+  return read;
+}
+
+//*******************************************************************************************************************
+size_t xbuf::available() 
+{
+  return _used;
+}
+
+//*******************************************************************************************************************
+int xbuf::indexOf(const char target, const size_t begin) 
+{
+  char targetstr[2] = " ";
+  targetstr[0] = target;
+  
+  return indexOf(targetstr, begin);
+}
+
+//*******************************************************************************************************************
+int xbuf::indexOf(const char* target, const size_t begin) 
+{
+  size_t targetLen = strlen(target);
+  
+  if (targetLen > _segSize || targetLen > _used) 
+    return -1;
+    
+  size_t searchPos = _offset + begin;
+  size_t searchEnd = _offset + _used - targetLen;
+  
+  if (searchPos > searchEnd) 
+    return -1;
+    
+  size_t searchSeg = searchPos / _segSize;
+  xseg* seg = _head;
+  
+  while (searchSeg) 
+  {
+    seg = seg->next;
+    searchSeg --;
+  }
+  
+  size_t segPos = searchPos % _segSize;
+  
+  while (searchPos <= searchEnd) 
+  {
+    size_t compLen = targetLen;
+    
+    if (compLen <= (_segSize - segPos)) 
+    {
+      if (memcmp(target, seg->data + segPos, compLen) == 0) 
+      {
+        return searchPos - _offset;
+      }
+    }
+    else 
+    {
+      size_t compLen = _segSize - segPos;
+      
+      if (memcmp(target, seg->data + segPos, compLen) == 0) 
+      {
+        compLen = targetLen - compLen;
+        
+        if (memcmp(target + targetLen - compLen, seg->next->data, compLen) == 0) 
+        {
+          return searchPos - _offset;
+        }
+      }
+    }
+    
+    searchPos++;
+    segPos++;
+    
+    if (segPos == _segSize) 
+    {
+      seg = seg->next;
+      segPos = 0;
+    }
+  }
+  
+  return -1;
+}
+
+//*******************************************************************************************************************
+String xbuf::readStringUntil(const char target) 
+{
+  return readString(indexOf(target) + 1);
+}
+
+//*******************************************************************************************************************
+String xbuf::readStringUntil(const char* target) 
+{
+  int index = indexOf(target);
+  
+  if (index < 0) 
+    return String();
+    
+  return readString(index + strlen(target));
+}
+
+//*******************************************************************************************************************
+String xbuf::readString(int endPos) 
+{
+  String result;
+  
+  if ( ! result.reserve(endPos + 1)) 
+  {
+    // KH, to remove
+    AHTTP_LOGDEBUG1("xbuf::readString: can't reserve size = ", endPos + 1);
+    ///////
+      
+    return result;
+  }
+  
+  // KH, to remove
+    AHTTP_LOGDEBUG1("xbuf::readString: Reserved size = ", endPos + 1);
+    ///////
+  
+  if (endPos > _used) 
+  {
+    endPos = _used;
+  }
+  
+  if (endPos > 0 && result.reserve(endPos + 1)) 
+  {
+    while (endPos--) 
+    {
+      result += (char)_head->data[_offset++];
+      _used--;
+      
+      if (_offset >= _segSize) 
+      {
+        remSeg();
+      }
+    }
+  }
+  
+  return result;
+}
+
+//*******************************************************************************************************************
+String xbuf::peekString(int endPos) 
+{
+  String result;
+  
+  xseg* seg     = _head;
+  size_t offset = _offset;
+  
+  if (endPos > _used) 
+  {
+    endPos = _used;
+  }
+  
+  if (endPos > 0 && result.reserve(endPos + 1)) 
+  {
+    while (endPos--) 
+    {
+      result += (char)seg->data[offset++];
+      
+      if ( offset >= _segSize) 
+      {
+        seg = seg->next;
+        offset = 0;
+      }
+    }
+  }
+  
+  return result;
+}
+
+//*******************************************************************************************************************
+void xbuf::flush() 
+{
+  while (_head) 
+    remSeg();
+  
+  _tail = nullptr;
+  _offset = 0;
+  _used = 0;
+  _free = 0;
+}
+
+//*******************************************************************************************************************
+void xbuf::addSeg() 
+{
+  if (_tail) 
+  {
+    _tail->next = (xseg*) new uint32_t[_segSize / 4 + 1];
+    
+    if (_tail->next == NULL)
+      AHTTP_LOGERROR("xbuf::addSeg: error new 1");
+    
+    // KH, Must check NULL here
+    _tail = _tail->next;
+  }
+  else 
+  {
+    // KH, Must check NULL here
+    _tail = _head = (xseg*) new uint32_t[_segSize / 4 + 1];
+    
+    if (_tail == NULL)
+      AHTTP_LOGERROR("xbuf::addSeg: error new 2");
+  }
+  
+  // KH, Must check NULL here
+  if (_tail)
+    _tail->next = nullptr;
+    
+  _free += _segSize;
+}
+
+//*******************************************************************************************************************
+void xbuf::remSeg() 
+{
+  if (_head) 
+  {
+    xseg *next = _head->next;
+    delete[] (uint32_t*) _head;
+    _head = next;
+    
+    if ( ! _head) 
+    {
+      _tail = nullptr;
+    }
+  }
+  
+  _offset = 0;
+}
+
+////////////////////////////////////////////////////////////////////////////
+
 //**************************************************************************************************************
 AsyncHTTPRequest::AsyncHTTPRequest(): _readyState(readyStateUnsent), _HTTPcode(0), _chunked(false), _debug(DEBUG_IOTA_HTTP_SET)
   , _timeout(DEFAULT_RX_TIMEOUT), _lastActivity(0), _requestStartTime(0), _requestEndTime(0), _URL(nullptr)
@@ -248,7 +637,7 @@ bool  AsyncHTTPRequest::send()
 }
 
 //**************************************************************************************************************
-bool AsyncHTTPRequest::send(String body)
+bool AsyncHTTPRequest::send(const String& body)
 {
   // New in v1.1.1
   if (_requestReadyToSend)
@@ -602,7 +991,7 @@ bool  AsyncHTTPRequest::_parseURL(const char* url)
 }
 
 //**************************************************************************************************************
-bool  AsyncHTTPRequest::_parseURL(String url)
+bool  AsyncHTTPRequest::_parseURL(const String& url)
 {
   SAFE_DELETE(_URL)
   

src/utility/xbuf.h

@@ -1,167 +0,0 @@
-/****************************************************************************************************************************
-  xbuf.h - Dead simple AsyncHTTPRequest for ESP8266, ESP32 and currently STM32 with built-in LAN8742A Ethernet
-  
-  For ESP8266, ESP32 and STM32 with built-in LAN8742A Ethernet (Nucleo-144, DISCOVERY, etc)
-  
-  AsyncHTTPRequest_STM32 is a library for the ESP8266, ESP32 and currently STM32 run built-in Ethernet WebServer
-  
-  Based on and modified from asyncHTTPrequest Library (https://github.com/boblemaire/asyncHTTPrequest)
-  
-  Built by Khoi Hoang https://github.com/khoih-prog/AsyncHTTPRequest_Generic
-  Licensed under MIT license
-  
-  Copyright (C) <2018>  <Bob Lemaire, IoTaWatt, Inc.>
-  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
-  as published bythe Free Software Foundation, either version 3 of the License, or (at your option) any later version.
-  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
-  You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
- 
-  Version: 1.4.1
-  
-  Version Modified By   Date      Comments
-  ------- -----------  ---------- -----------
-  1.0.0    K Hoang     14/09/2020 Initial coding to add support to STM32 using built-in Ethernet (Nucleo-144, DISCOVERY, etc).
-  1.0.1    K Hoang     09/10/2020 Restore cpp code besides Impl.h code.
-  1.0.2    K Hoang     09/11/2020 Make Mutex Lock and delete more reliable and error-proof
-  1.1.0    K Hoang     23/12/2020 Add HTTP PUT, PATCH, DELETE and HEAD methods
-  1.1.1    K Hoang     24/12/2020 Prevent crash if request and/or method not correct.
-  1.1.2    K Hoang     11/02/2021 Rename _lock and _unlock to avoid conflict with AsyncWebServer library
-  1.1.3    K Hoang     25/02/2021 Fix non-persistent Connection header bug
-  1.1.4    K Hoang     21/03/2021 Fix `library.properties` dependency
-  1.1.5    K Hoang     22/03/2021 Fix dependency on STM32AsyncTCP Library
-  1.2.0    K Hoang     11/04/2021 Add support to LAN8720 using STM32F4 or STM32F7
-  1.3.0    K Hoang     09/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720) boards
-  1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
-  1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
-  1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
- *****************************************************************************************************************************/
- 
-/********************************************************************************************
-  xbuf is a dynamic buffering system that supports reading and writing much like cbuf.
-  The class has it's own provision for writing from buffers, Strings and other xbufs
-  as well as the inherited Print functions.
-  Rather than use a large contiguous heap allocation, xbuf uses a linked chain of segments
-  to dynamically grow and shrink with the contents.
-  There are other benefits as well to using smaller heap allocation units:
-  1) A buffer can work fine in a fragmented heap environment (admittedly contributing to it)
-  2) xbuf contents can be copied from one buffer to another without the need for 
-     2x heap during the copy.
-  The segment size defaults to 64 but can be dynamically set in the constructor at creation.   
-  The inclusion of indexOf and read/peek until functions make it useful for handling
-  data streams like HTTP, and in fact is why it was created.
-
-  NOTE: The size of the indexOf() search string is limited to the segment size.
-        It could be extended but didn't seem to be a practical consideration.    
-   
-********************************************************************************************/
-#pragma once
-
-#ifndef XBUF_H
-#define XBUF_H
-
-#include <Arduino.h>
-
-struct xseg 
-{
-  xseg    *next;
-  uint8_t data[];
-};
-
-class xbuf: public Print 
-{
-  public:
-
-    xbuf(const uint16_t segSize = 64);
-    virtual ~xbuf();
-
-    size_t      write(const uint8_t);
-    size_t      write(const char*);
-    size_t      write(const uint8_t*, const size_t);
-    size_t      write(xbuf*, const size_t);
-    size_t      write(String);
-    size_t      available();
-    int         indexOf(const char, const size_t begin = 0);
-    int         indexOf(const char*, const size_t begin = 0);
-    uint8_t     read();
-    size_t      read(uint8_t*, size_t);
-    String      readStringUntil(const char);
-    String      readStringUntil(const char*);
-    String      readString(int);
-    
-    String      readString() 
-    {
-      return readString(available());
-    }
-    
-    void        flush();
-
-    uint8_t     peek();
-    size_t      peek(uint8_t*, const size_t);
-    
-    String      peekStringUntil(const char target) 
-    {
-      return peekString(indexOf(target, 0));
-    }
-    
-    String      peekStringUntil(const char* target) 
-    {
-      return peekString(indexOf(target, 0));
-    }
-    
-    String      peekString() 
-    {
-      return peekString(_used);
-    }
-    
-    String      peekString(int);
-
-    /*      In addition to the above functions,
-    the following inherited functions from the Print class are available.
-    
-    size_t printf(const char * format, ...)  __attribute__ ((format (printf, 2, 3)));
-    size_t printf_P(PGM_P format, ...) __attribute__((format(printf, 2, 3)));
-    size_t print(const __FlashStringHelper *);
-    size_t print(const String &);
-    size_t print(const char[]);
-    size_t print(char);
-    size_t print(unsigned char, int = DEC);
-    size_t print(int, int = DEC);
-    size_t print(unsigned int, int = DEC);
-    size_t print(long, int = DEC);
-    size_t print(unsigned long, int = DEC);
-    size_t print(double, int = 2);
-    size_t print(const Printable&);
-    
-    size_t println(const __FlashStringHelper *);
-    size_t println(const String &s);
-    size_t println(const char[]);
-    size_t println(char);
-    size_t println(unsigned char, int = DEC);
-    size_t println(int, int = DEC);
-    size_t println(unsigned int, int = DEC);
-    size_t println(long, int = DEC);
-    size_t println(unsigned long, int = DEC);
-    size_t println(double, int = 2);
-    size_t println(const Printable&);
-    size_t println(void);
-    */
-
-  protected:
-
-    xseg        *_head;
-    xseg        *_tail;
-    uint16_t     _used;
-    uint16_t     _free;
-    uint16_t     _offset;
-    uint16_t     _segSize;
-
-    void        addSeg();
-    void        remSeg();
-
-};
-
-#include "utility/xbuf_Impl.h"
-
-#endif    // XBUF_H
-

src/utility/xbuf_Impl.h

@@ -1,429 +0,0 @@
-/****************************************************************************************************************************
-  xbuf_Impl.h - Dead simple AsyncHTTPRequest for ESP8266, ESP32 and currently STM32 with built-in LAN8742A Ethernet
-  
-  For ESP8266, ESP32 and STM32 with built-in LAN8742A Ethernet (Nucleo-144, DISCOVERY, etc)
-  
-  AsyncHTTPRequest_STM32 is a library for the ESP8266, ESP32 and currently STM32 run built-in Ethernet WebServer
-  
-  Based on and modified from asyncHTTPrequest Library (https://github.com/boblemaire/asyncHTTPrequest)
-  
-  Built by Khoi Hoang https://github.com/khoih-prog/AsyncHTTPRequest_Generic
-  Licensed under MIT license
-  
-  Copyright (C) <2018>  <Bob Lemaire, IoTaWatt, Inc.>
-  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
-  as published bythe Free Software Foundation, either version 3 of the License, or (at your option) any later version.
-  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
-  You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
- 
-  Version: 1.4.1
-  
-  Version Modified By   Date      Comments
-  ------- -----------  ---------- -----------
-  1.0.0    K Hoang     14/09/2020 Initial coding to add support to STM32 using built-in Ethernet (Nucleo-144, DISCOVERY, etc).
-  1.0.1    K Hoang     09/10/2020 Restore cpp code besides Impl.h code.
-  1.0.2    K Hoang     09/11/2020 Make Mutex Lock and delete more reliable and error-proof
-  1.1.0    K Hoang     23/12/2020 Add HTTP PUT, PATCH, DELETE and HEAD methods
-  1.1.1    K Hoang     24/12/2020 Prevent crash if request and/or method not correct.
-  1.1.2    K Hoang     11/02/2021 Rename _lock and _unlock to avoid conflict with AsyncWebServer library
-  1.1.3    K Hoang     25/02/2021 Fix non-persistent Connection header bug
-  1.1.4    K Hoang     21/03/2021 Fix `library.properties` dependency
-  1.1.5    K Hoang     22/03/2021 Fix dependency on STM32AsyncTCP Library
-  1.2.0    K Hoang     11/04/2021 Add support to LAN8720 using STM32F4 or STM32F7
-  1.3.0    K Hoang     09/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720) boards
-  1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
-  1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
-  1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
- *****************************************************************************************************************************/
-
-#pragma once
-
-#ifndef XBUF_IMPL_H
-#define XBUF_IMPL_H
-
-xbuf::xbuf(const uint16_t segSize) : _head(nullptr), _tail(nullptr), _used(0), _free(0), _offset(0) 
-{
-  _segSize = (segSize + 3) & -4;//((segSize + 3) >> 2) << 2;
-}
-
-//*******************************************************************************************************************
-xbuf::~xbuf() 
-{
-  flush();
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(const uint8_t byte) 
-{
-  return write((uint8_t*) &byte, 1);
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(const char* buf) 
-{
-  return write((uint8_t*)buf, strlen(buf));
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(String string) 
-{
-  return write((uint8_t*)string.c_str(), string.length());
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(const uint8_t* buf, const size_t len) 
-{
-  size_t supply = len;
-  
-  while (supply) 
-  {
-    if (!_free) 
-    {
-      addSeg();
-    }
-    
-    size_t demand = _free < supply ? _free : supply;
-    memcpy(_tail->data + ((_offset + _used) % _segSize), buf + (len - supply), demand);
-    _free -= demand;
-    _used += demand;
-    supply -= demand;
-  }
-  
-  return len;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(xbuf* buf, const size_t len) 
-{
-  size_t supply = len;
-  
-  if (supply > buf->available()) 
-  {
-    supply = buf->available();
-  }
-  
-  size_t read = 0;
-  
-  while (supply) 
-  {
-    if (!_free) 
-    {
-      addSeg();
-    }
-    
-    size_t demand = _free < supply ? _free : supply;
-    read += buf->read(_tail->data + ((_offset + _used) % _segSize), demand);
-    _free -= demand;
-    _used += demand;
-    supply -= demand;
-  }
-  
-  return read;
-}
-
-//*******************************************************************************************************************
-uint8_t xbuf::read() 
-{
-  uint8_t byte = 0;
-  read((uint8_t*) &byte, 1);
-  
-  return byte;
-}
-
-//*******************************************************************************************************************
-uint8_t xbuf::peek() 
-{
-  uint8_t byte = 0;
-  peek((uint8_t*) &byte, 1);
-  
-  return byte;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::read(uint8_t* buf, const size_t len) 
-{
-  size_t read = 0;
-  
-  while (read < len && _used) 
-  {
-    size_t supply = (_offset + _used) > _segSize ? _segSize - _offset : _used;
-    size_t demand = len - read;
-    size_t chunk = supply < demand ? supply : demand;
-    memcpy(buf + read, _head->data + _offset, chunk);
-    _offset += chunk;
-    _used -= chunk;
-    read += chunk;
-    
-    if (_offset == _segSize) 
-    {
-      remSeg();
-      _offset = 0;
-    }
-  }
-  
-  if ( ! _used) 
-  {
-    flush();
-  }
-  
-  return read;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::peek(uint8_t* buf, const size_t len) 
-{
-  size_t read   = 0;
-  xseg* seg     = _head;
-  size_t offset = _offset;
-  size_t used   = _used;
-  
-  while (read < len && used) 
-  {
-    size_t supply = (offset + used) > _segSize ? _segSize - offset : used;
-    size_t demand = len - read;
-    size_t chunk  = supply < demand ? supply : demand;
-    
-    memcpy(buf + read, seg->data + offset, chunk);
-    
-    offset  += chunk;
-    used    -= chunk;
-    read    += chunk;
-    
-    if (offset == _segSize) 
-    {
-      seg = seg->next;
-      offset = 0;
-    }
-  }
-  
-  return read;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::available() 
-{
-  return _used;
-}
-
-//*******************************************************************************************************************
-int xbuf::indexOf(const char target, const size_t begin) 
-{
-  char targetstr[2] = " ";
-  targetstr[0] = target;
-  
-  return indexOf(targetstr, begin);
-}
-
-//*******************************************************************************************************************
-int xbuf::indexOf(const char* target, const size_t begin) 
-{
-  size_t targetLen = strlen(target);
-  
-  if (targetLen > _segSize || targetLen > _used) 
-    return -1;
-    
-  size_t searchPos = _offset + begin;
-  size_t searchEnd = _offset + _used - targetLen;
-  
-  if (searchPos > searchEnd) 
-    return -1;
-    
-  size_t searchSeg = searchPos / _segSize;
-  xseg* seg = _head;
-  
-  while (searchSeg) 
-  {
-    seg = seg->next;
-    searchSeg --;
-  }
-  
-  size_t segPos = searchPos % _segSize;
-  
-  while (searchPos <= searchEnd) 
-  {
-    size_t compLen = targetLen;
-    
-    if (compLen <= (_segSize - segPos)) 
-    {
-      if (memcmp(target, seg->data + segPos, compLen) == 0) 
-      {
-        return searchPos - _offset;
-      }
-    }
-    else 
-    {
-      size_t compLen = _segSize - segPos;
-      
-      if (memcmp(target, seg->data + segPos, compLen) == 0) 
-      {
-        compLen = targetLen - compLen;
-        
-        if (memcmp(target + targetLen - compLen, seg->next->data, compLen) == 0) 
-        {
-          return searchPos - _offset;
-        }
-      }
-    }
-    
-    searchPos++;
-    segPos++;
-    
-    if (segPos == _segSize) 
-    {
-      seg = seg->next;
-      segPos = 0;
-    }
-  }
-  
-  return -1;
-}
-
-//*******************************************************************************************************************
-String xbuf::readStringUntil(const char target) 
-{
-  return readString(indexOf(target) + 1);
-}
-
-//*******************************************************************************************************************
-String xbuf::readStringUntil(const char* target) 
-{
-  int index = indexOf(target);
-  
-  if (index < 0) 
-    return String();
-    
-  return readString(index + strlen(target));
-}
-
-//*******************************************************************************************************************
-String xbuf::readString(int endPos) 
-{
-  String result;
-  
-  if ( ! result.reserve(endPos + 1)) 
-  {
-    // KH, to remove
-    AHTTP_LOGDEBUG1("xbuf::readString: can't reserve size = ", endPos + 1);
-    ///////
-      
-    return result;
-  }
-  
-  // KH, to remove
-    AHTTP_LOGDEBUG1("xbuf::readString: Reserved size = ", endPos + 1);
-    ///////
-  
-  if (endPos > _used) 
-  {
-    endPos = _used;
-  }
-  
-  if (endPos > 0 && result.reserve(endPos + 1)) 
-  {
-    while (endPos--) 
-    {
-      result += (char)_head->data[_offset++];
-      _used--;
-      
-      if (_offset >= _segSize) 
-      {
-        remSeg();
-      }
-    }
-  }
-  
-  return result;
-}
-
-//*******************************************************************************************************************
-String xbuf::peekString(int endPos) 
-{
-  String result;
-  
-  xseg* seg     = _head;
-  size_t offset = _offset;
-  
-  if (endPos > _used) 
-  {
-    endPos = _used;
-  }
-  
-  if (endPos > 0 && result.reserve(endPos + 1)) 
-  {
-    while (endPos--) 
-    {
-      result += (char)seg->data[offset++];
-      
-      if ( offset >= _segSize) 
-      {
-        seg = seg->next;
-        offset = 0;
-      }
-    }
-  }
-  
-  return result;
-}
-
-//*******************************************************************************************************************
-void xbuf::flush() 
-{
-  while (_head) 
-    remSeg();
-  
-  _tail = nullptr;
-  _offset = 0;
-  _used = 0;
-  _free = 0;
-}
-
-//*******************************************************************************************************************
-void xbuf::addSeg() 
-{
-  if (_tail) 
-  {
-    _tail->next = (xseg*) new uint32_t[_segSize / 4 + 1];
-    
-    if (_tail->next == NULL)
-      AHTTP_LOGERROR("xbuf::addSeg: error new 1");
-    
-    // KH, Must check NULL here
-    _tail = _tail->next;
-  }
-  else 
-  {
-    // KH, Must check NULL here
-    _tail = _head = (xseg*) new uint32_t[_segSize / 4 + 1];
-    
-    if (_tail == NULL)
-      AHTTP_LOGERROR("xbuf::addSeg: error new 2");
-  }
-  
-  // KH, Must check NULL here
-  if (_tail)
-    _tail->next = nullptr;
-    
-  _free += _segSize;
-}
-
-//*******************************************************************************************************************
-void xbuf::remSeg() 
-{
-  if (_head) 
-  {
-    xseg *next = _head->next;
-    delete[] (uint32_t*) _head;
-    _head = next;
-    
-    if ( ! _head) 
-    {
-      _tail = nullptr;
-    }
-  }
-  
-  _offset = 0;
-}
-
-#endif    // XBUF_IMPL_H
-

src_cpp/AsyncHTTPRequest_Debug_Generic.h

@@ -1,107 +0,0 @@
-/****************************************************************************************************************************
-  AsyncHTTPRequest_Debug_Generic.h - Dead simple AsyncHTTPRequest for ESP8266, ESP32 and currently STM32 with built-in LAN8742A Ethernet
-  
-  For ESP8266, ESP32 and STM32 with built-in LAN8742A Ethernet (Nucleo-144, DISCOVERY, etc)
-  
-  AsyncHTTPRequest_STM32 is a library for the ESP8266, ESP32 and currently STM32 run built-in Ethernet WebServer
-  
-  Based on and modified from asyncHTTPrequest Library (https://github.com/boblemaire/asyncHTTPrequest)
-  
-  Built by Khoi Hoang https://github.com/khoih-prog/AsyncHTTPRequest_Generic
-  Licensed under MIT license
-  
-  Copyright (C) <2018>  <Bob Lemaire, IoTaWatt, Inc.>
-  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
-  as published bythe Free Software Foundation, either version 3 of the License, or (at your option) any later version.
-  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
-  You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
- 
-  Version: 1.4.1
-  
-  Version Modified By   Date      Comments
-  ------- -----------  ---------- -----------
-  1.0.0    K Hoang     14/09/2020 Initial coding to add support to STM32 using built-in Ethernet (Nucleo-144, DISCOVERY, etc).
-  1.0.1    K Hoang     09/10/2020 Restore cpp code besides Impl.h code.
-  1.0.2    K Hoang     09/11/2020 Make Mutex Lock and delete more reliable and error-proof
-  1.1.0    K Hoang     23/12/2020 Add HTTP PUT, PATCH, DELETE and HEAD methods
-  1.1.1    K Hoang     24/12/2020 Prevent crash if request and/or method not correct.
-  1.1.2    K Hoang     11/02/2021 Rename _lock and _unlock to avoid conflict with AsyncWebServer library
-  1.1.3    K Hoang     25/02/2021 Fix non-persistent Connection header bug
-  1.1.4    K Hoang     21/03/2021 Fix `library.properties` dependency
-  1.1.5    K Hoang     22/03/2021 Fix dependency on STM32AsyncTCP Library
-  1.2.0    K Hoang     11/04/2021 Add support to LAN8720 using STM32F4 or STM32F7
-  1.3.0    K Hoang     09/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720) boards
-  1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
-  1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
-  1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
- *****************************************************************************************************************************/
-
-#pragma once
-
-#ifndef ASYNC_HTTP_REQUEST_DEBUG_GENERIC_H
-#define ASYNC_HTTP_REQUEST_DEBUG_GENERIC_H
-
-#ifdef ASYNC_HTTP_DEBUG_PORT
-  #define A_DBG_PORT      ASYNC_HTTP_DEBUG_PORT
-#else
-  #define A_DBG_PORT      Serial
-#endif
-
-// Change _ASYNC_HTTP_LOGLEVEL_ to set tracing and logging verbosity
-// 0: DISABLED: no logging
-// 1: ERROR: errors
-// 2: WARN: errors and warnings
-// 3: INFO: errors, warnings and informational (default)
-// 4: DEBUG: errors, warnings, informational and debug
-
-#ifndef _ASYNC_HTTP_LOGLEVEL_
-  #define _ASYNC_HTTP_LOGLEVEL_       0
-#endif
-
-/////////////////////////////////////////////////////////
-
-const char AHTTP_MARK[] = "[AHTTP] ";
-
-#define AHTTP_PRINT_MARK   AHTTP_PRINT(AHTTP_MARK)
-#define AHTTP_PRINT_SP     A_DBG_PORT.print(" ")
-
-#define AHTTP_PRINT        A_DBG_PORT.print
-#define AHTTP_PRINTLN      A_DBG_PORT.println
-
-/////////////////////////////////////////////////////////
-
-#define AHTTP_LOGERROR(x)         if(_ASYNC_HTTP_LOGLEVEL_>0) { AHTTP_PRINT_MARK; AHTTP_PRINTLN(x); }
-#define AHTTP_LOGERROR0(x)        if(_ASYNC_HTTP_LOGLEVEL_>0) { AHTTP_PRINT(x); }
-#define AHTTP_LOGERROR1(x,y)      if(_ASYNC_HTTP_LOGLEVEL_>0) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINTLN(y); }
-#define AHTTP_LOGERROR2(x,y,z)    if(_ASYNC_HTTP_LOGLEVEL_>0) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINTLN(z); }
-#define AHTTP_LOGERROR3(x,y,z,w)  if(_ASYNC_HTTP_LOGLEVEL_>0) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINT(z); AHTTP_PRINT_SP; AHTTP_PRINTLN(w); }
-
-/////////////////////////////////////////////////////////
-
-#define AHTTP_LOGWARN(x)          if(_ASYNC_HTTP_LOGLEVEL_>1) { AHTTP_PRINT_MARK; AHTTP_PRINTLN(x); }
-#define AHTTP_LOGWARN0(x)         if(_ASYNC_HTTP_LOGLEVEL_>1) { AHTTP_PRINT(x); }
-#define AHTTP_LOGWARN1(x,y)       if(_ASYNC_HTTP_LOGLEVEL_>1) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINTLN(y); }
-#define AHTTP_LOGWARN2(x,y,z)     if(_ASYNC_HTTP_LOGLEVEL_>1) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINTLN(z); }
-#define AHTTP_LOGWARN3(x,y,z,w)   if(_ASYNC_HTTP_LOGLEVEL_>1) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINT(z); AHTTP_PRINT_SP; AHTTP_PRINTLN(w); }
-
-/////////////////////////////////////////////////////////
-
-#define AHTTP_LOGINFO(x)          if(_ASYNC_HTTP_LOGLEVEL_>2) { AHTTP_PRINT_MARK; AHTTP_PRINTLN(x); }
-#define AHTTP_LOGINFO0(x)         if(_ASYNC_HTTP_LOGLEVEL_>2) { AHTTP_PRINT(x); }
-#define AHTTP_LOGINFO1(x,y)       if(_ASYNC_HTTP_LOGLEVEL_>2) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINTLN(y); }
-#define AHTTP_LOGINFO2(x,y,z)     if(_ASYNC_HTTP_LOGLEVEL_>2) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINTLN(z); }
-#define AHTTP_LOGINFO3(x,y,z,w)   if(_ASYNC_HTTP_LOGLEVEL_>2) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINT(z); AHTTP_PRINT_SP; AHTTP_PRINTLN(w); }
-
-/////////////////////////////////////////////////////////
-
-#define AHTTP_LOGDEBUG(x)         if(_ASYNC_HTTP_LOGLEVEL_>3) { AHTTP_PRINT_MARK; AHTTP_PRINTLN(x); }
-#define AHTTP_LOGDEBUG0(x)        if(_ASYNC_HTTP_LOGLEVEL_>3) { AHTTP_PRINT(x); }
-#define AHTTP_LOGDEBUG1(x,y)      if(_ASYNC_HTTP_LOGLEVEL_>3) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINTLN(y); }
-#define AHTTP_LOGDEBUG2(x,y,z)    if(_ASYNC_HTTP_LOGLEVEL_>3) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINTLN(z); }
-#define AHTTP_LOGDEBUG3(x,y,z,w)  if(_ASYNC_HTTP_LOGLEVEL_>3) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINT(z); AHTTP_PRINT_SP; AHTTP_PRINTLN(w); }
-
-/////////////////////////////////////////////////////////
-
-#endif    // ASYNC_HTTP_REQUEST_DEBUG_GENERIC_H
-

src_cpp/AsyncHTTPRequest_Generic.h

@@ -1,317 +0,0 @@
-/****************************************************************************************************************************
-  AsyncHTTPRequest_Generic.h - Dead simple AsyncHTTPRequest for ESP8266, ESP32 and currently STM32 with built-in LAN8742A Ethernet
-  
-  For ESP8266, ESP32 and STM32 with built-in LAN8742A Ethernet (Nucleo-144, DISCOVERY, etc)
-  
-  AsyncHTTPRequest_STM32 is a library for the ESP8266, ESP32 and currently STM32 run built-in Ethernet WebServer
-  
-  Based on and modified from asyncHTTPrequest Library (https://github.com/boblemaire/asyncHTTPrequest)
-  
-  Built by Khoi Hoang https://github.com/khoih-prog/AsyncHTTPRequest_Generic
-  Licensed under MIT license
-  
-  Copyright (C) <2018>  <Bob Lemaire, IoTaWatt, Inc.>
-  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
-  as published bythe Free Software Foundation, either version 3 of the License, or (at your option) any later version.
-  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
-  You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
- 
-  Version: 1.4.1
-  
-  Version Modified By   Date      Comments
-  ------- -----------  ---------- -----------
-  1.0.0    K Hoang     14/09/2020 Initial coding to add support to STM32 using built-in Ethernet (Nucleo-144, DISCOVERY, etc).
-  1.0.1    K Hoang     09/10/2020 Restore cpp code besides Impl.h code.
-  1.0.2    K Hoang     09/11/2020 Make Mutex Lock and delete more reliable and error-proof
-  1.1.0    K Hoang     23/12/2020 Add HTTP PUT, PATCH, DELETE and HEAD methods
-  1.1.1    K Hoang     24/12/2020 Prevent crash if request and/or method not correct.
-  1.1.2    K Hoang     11/02/2021 Rename _lock and _unlock to avoid conflict with AsyncWebServer library
-  1.1.3    K Hoang     25/02/2021 Fix non-persistent Connection header bug
-  1.1.4    K Hoang     21/03/2021 Fix `library.properties` dependency
-  1.1.5    K Hoang     22/03/2021 Fix dependency on STM32AsyncTCP Library
-  1.2.0    K Hoang     11/04/2021 Add support to LAN8720 using STM32F4 or STM32F7
-  1.3.0    K Hoang     09/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720) boards
-  1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
-  1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
-  1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
- *****************************************************************************************************************************/
-
-#pragma once
-
-#ifndef ASYNC_HTTP_REQUEST_GENERIC_H
-#define ASYNC_HTTP_REQUEST_GENERIC_H
-
-#define ASYNC_HTTP_REQUEST_GENERIC_VERSION   "AsyncHTTPRequest_Generic v1.4.1"
-
-#include <Arduino.h>
-
-#include "AsyncHTTPRequest_Debug_Generic.h"
-
-#ifndef DEBUG_IOTA_PORT
-  #define DEBUG_IOTA_PORT Serial
-#endif
-
-#ifdef DEBUG_IOTA_HTTP
-  #define DEBUG_IOTA_HTTP_SET     true
-#else
-  #define DEBUG_IOTA_HTTP_SET     false
-#endif
-
-
-// KH add
-#define SAFE_DELETE(object)         if (object) { delete object;}
-#define SAFE_DELETE_ARRAY(object)   if (object) { delete[] object;}
-
-#if ESP32
-
-  #include <AsyncTCP.h>
-  
-  // KH mod
-  #define MUTEX_LOCK_NR           if (xSemaphoreTakeRecursive(threadLock,portMAX_DELAY) != pdTRUE) { return;}
-  #define MUTEX_LOCK(returnVal)   if (xSemaphoreTakeRecursive(threadLock,portMAX_DELAY) != pdTRUE) { return returnVal;}
-  
-  #define _AHTTP_lock       xSemaphoreTakeRecursive(threadLock,portMAX_DELAY)
-  #define _AHTTP_unlock     xSemaphoreGiveRecursive(threadLock)
-  
-#elif ESP8266
-
-  #include <ESPAsyncTCP.h>
-  
-  #define MUTEX_LOCK_NR
-  #define MUTEX_LOCK(returnVal)
-  
-  #define _AHTTP_lock
-  #define _AHTTP_unlock
-  
-#elif ( defined(STM32F0) || defined(STM32F1) || defined(STM32F2) || defined(STM32F3)  ||defined(STM32F4) || defined(STM32F7) || \
-       defined(STM32L0) || defined(STM32L1) || defined(STM32L4) || defined(STM32H7)  ||defined(STM32G0) || defined(STM32G4) || \
-       defined(STM32WB) || defined(STM32MP1) )
-       
-  #include "STM32AsyncTCP.h"
-  
-  #define MUTEX_LOCK_NR
-  #define MUTEX_LOCK(returnVal)
-  #define _AHTTP_lock
-  #define _AHTTP_unlock
-  
-#endif
-
-#include <pgmspace.h>
-#include <utility/xbuf.h>
-
-#define DEBUG_HTTP(format,...)  if(_debug){\
-    DEBUG_IOTA_PORT.printf("Debug(%3ld): ", millis()-_requestStartTime);\
-    DEBUG_IOTA_PORT.printf_P(PSTR(format),##__VA_ARGS__);}
-
-#define DEFAULT_RX_TIMEOUT 3                    // Seconds for timeout
-
-#define HTTPCODE_CONNECTION_REFUSED  (-1)
-#define HTTPCODE_SEND_HEADER_FAILED  (-2)
-#define HTTPCODE_SEND_PAYLOAD_FAILED (-3)
-#define HTTPCODE_NOT_CONNECTED       (-4)
-#define HTTPCODE_CONNECTION_LOST     (-5)
-#define HTTPCODE_NO_STREAM           (-6)
-#define HTTPCODE_NO_HTTP_SERVER      (-7)
-#define HTTPCODE_TOO_LESS_RAM        (-8)
-#define HTTPCODE_ENCODING            (-9)
-#define HTTPCODE_STREAM_WRITE        (-10)
-#define HTTPCODE_TIMEOUT             (-11)
-
-typedef enum
-{
-  readyStateUnsent      = 0,            // Client created, open not yet called
-  readyStateOpened      = 1,            // open() has been called, connected
-  readyStateHdrsRecvd   = 2,            // send() called, response headers available
-  readyStateLoading     = 3,            // receiving, partial data available
-  readyStateDone        = 4             // Request complete, all data available.
-} reqStates;
-    
-class AsyncHTTPRequest
-{
-    struct header
-    {
-      header*   next;
-      char*     name;
-      char*     value;
-      
-      header(): next(nullptr), name(nullptr), value(nullptr)
-      {};
-      
-      ~header() 
-      {
-        SAFE_DELETE_ARRAY(name)
-        SAFE_DELETE_ARRAY(value)
-        SAFE_DELETE(next)
-        //delete[] name;
-        //delete[] value;
-        //delete next;
-      }
-    };
-
-    struct  URL 
-    {
-      char*   scheme;
-      char*   user;
-      char*   pwd;
-      char*   host;
-      int     port;
-      char*   path;
-      char*   query;
-      char*   fragment;
-      
-      URL():  scheme(nullptr), user(nullptr), pwd(nullptr), host(nullptr),
-              port(80), path(nullptr), query(nullptr), fragment(nullptr)
-      {};
-      
-      ~URL() 
-      {
-        SAFE_DELETE_ARRAY(scheme)
-        SAFE_DELETE_ARRAY(user)
-        SAFE_DELETE_ARRAY(pwd)
-        SAFE_DELETE_ARRAY(host)
-        SAFE_DELETE_ARRAY(path)
-        SAFE_DELETE_ARRAY(query)
-        SAFE_DELETE_ARRAY(fragment)
-      }
-    };
-
-    typedef std::function<void(void*, AsyncHTTPRequest*, int readyState)> readyStateChangeCB;
-    typedef std::function<void(void*, AsyncHTTPRequest*, size_t available)> onDataCB;
-
-  public:
-    AsyncHTTPRequest();
-    ~AsyncHTTPRequest();
-
-
-    //External functions in typical order of use:
-    //__________________________________________________________________________________________________________*/
-    void        setDebug(bool);                                         // Turn debug message on/off
-    bool        debug();                                                // is debug on or off?
-
-    bool        open(const char* /*GET/POST*/, const char* URL);        // Initiate a request
-    void        onReadyStateChange(readyStateChangeCB, void* arg = 0);  // Optional event handler for ready state change
-    // or you can simply poll readyState()
-    void        setTimeout(int);                                        // overide default timeout (seconds)
-
-    void        setReqHeader(const char* name, const char* value);      // add a request header
-    void        setReqHeader(const char* name, int32_t value);          // overload to use integer value
-    
-#if (ESP32 || ESP8266)
-    void        setReqHeader(const char* name, const __FlashStringHelper* value);
-    void        setReqHeader(const __FlashStringHelper *name, const char* value);
-    void        setReqHeader(const __FlashStringHelper *name, const __FlashStringHelper* value);
-    void        setReqHeader(const __FlashStringHelper *name, int32_t value);
-#endif
-
-    bool        send();                                                 // Send the request (GET)
-    bool        send(String body);                                      // Send the request (POST)
-    bool        send(const char* body);                                 // Send the request (POST)
-    bool        send(const uint8_t* buffer, size_t len);                // Send the request (POST) (binary data?)
-    bool        send(xbuf* body, size_t len);                           // Send the request (POST) data in an xbuf
-    void        abort();                                                // Abort the current operation
-
-    reqStates   readyState();                                           // Return the ready state
-
-    int         respHeaderCount();                                      // Retrieve count of response headers
-    char*       respHeaderName(int index);                              // Return header name by index
-    char*       respHeaderValue(int index);                             // Return header value by index
-    char*       respHeaderValue(const char* name);                      // Return header value by name
-    
-    bool        respHeaderExists(const char* name);                     // Does header exist by name?
-    
-#if (ESP32 || ESP8266)
-    char*       respHeaderValue(const __FlashStringHelper *name);
-    bool        respHeaderExists(const __FlashStringHelper *name);
-#endif
-    
-    String      headers();                                              // Return all headers as String
-
-    void        onData(onDataCB, void* arg = 0);                        // Notify when min data is available
-    size_t      available();                                            // response available
-    size_t      responseLength();                                       // indicated response length or sum of chunks to date
-    int         responseHTTPcode();                                     // HTTP response code or (negative) error code
-    String      responseText();                                         // response (whole* or partial* as string)
-    
-    char*       responseLongText();                                     // response long (whole* or partial* as string)
-    
-    size_t      responseRead(uint8_t* buffer, size_t len);              // Read response into buffer
-    uint32_t    elapsedTime();                                          // Elapsed time of in progress transaction or last completed (ms)
-    String      version();                                              // Version of AsyncHTTPRequest
-    //___________________________________________________________________________________________________________________________________
-
-  private:
-
-    // New in v1.1.1
-    bool _requestReadyToSend;
-    //////
-    
-    // New in v1.1.0
-    typedef enum  { HTTPmethodGET, HTTPmethodPOST, HTTPmethodPUT, HTTPmethodPATCH, HTTPmethodDELETE, HTTPmethodHEAD, HTTPmethodMAX } HTTPmethod;
-    
-    HTTPmethod _HTTPmethod;
-    
-    const char* _HTTPmethodStringwithSpace[HTTPmethodMAX] = {"GET ", "POST ", "PUT ", "PATCH ", "DELETE ", "HEAD "};
-    //////
-    
-    reqStates       _readyState;
-
-    int16_t         _HTTPcode;                  // HTTP response code or (negative) exception code
-    bool            _chunked;                   // Processing chunked response
-    bool            _debug;                     // Debug state
-    uint32_t        _timeout;                   // Default or user overide RxTimeout in seconds
-    uint32_t        _lastActivity;              // Time of last activity
-    uint32_t        _requestStartTime;          // Time last open() issued
-    uint32_t        _requestEndTime;            // Time of last disconnect
-    URL*            _URL;                       // -> URL data structure
-    char*           _connectedHost;             // Host when connected
-    int             _connectedPort;             // Port when connected
-    AsyncClient*    _client;                    // ESPAsyncTCP AsyncClient instance
-    size_t          _contentLength;             // content-length header value or sum of chunk headers
-    size_t          _contentRead;               // number of bytes retrieved by user since last open()
-    readyStateChangeCB  _readyStateChangeCB;    // optional callback for readyState change
-    void*           _readyStateChangeCBarg;     // associated user argument
-    onDataCB        _onDataCB;                  // optional callback when data received
-    void*           _onDataCBarg;               // associated user argument
-
-#ifdef ESP32
-    SemaphoreHandle_t threadLock;
-#endif
-
-    // request and response String buffers and header list (same queue for request and response).
-
-    xbuf*       _request;                       // Tx data buffer
-    xbuf*       _response;                      // Rx data buffer for headers
-    xbuf*       _chunks;                        // First stage for chunked response
-    header*     _headers;                       // request or (readyState > readyStateHdrsRcvd) response headers
-
-    // Protected functions
-
-    header*     _addHeader(const char*, const char*);
-    header*     _getHeader(const char*);
-    header*     _getHeader(int);
-    bool        _buildRequest();
-    bool        _parseURL(const char*);
-    bool        _parseURL(String);
-    void        _processChunks();
-    bool        _connect();
-    size_t      _send();
-    void        _setReadyState(reqStates);
-    
-#if (ESP32 || ESP8266)    
-    char*       _charstar(const __FlashStringHelper *str);
-#endif
-
-    // callbacks
-
-    void        _onConnect(AsyncClient*);
-    void        _onDisconnect(AsyncClient*);
-    void        _onData(void*, size_t);
-    void        _onError(AsyncClient*, int8_t);
-    void        _onPoll(AsyncClient*);
-    bool        _collectHeaders();
-};
-
-#endif    // ASYNC_HTTP_REQUEST_GENERIC_H
-
-

src_cpp/utility/xbuf.cpp

@@ -1,410 +0,0 @@
-/****************************************************************************************************************************
-  xbuf_Impl.h - Dead simple AsyncHTTPRequest for ESP8266, ESP32 and currently STM32 with built-in LAN8742A Ethernet
-  
-  For ESP8266, ESP32 and STM32 with built-in LAN8742A Ethernet (Nucleo-144, DISCOVERY, etc)
-  
-  AsyncHTTPRequest_STM32 is a library for the ESP8266, ESP32 and currently STM32 run built-in Ethernet WebServer
-  
-  Based on and modified from asyncHTTPrequest Library (https://github.com/boblemaire/asyncHTTPrequest)
-  
-  Built by Khoi Hoang https://github.com/khoih-prog/AsyncHTTPRequest_Generic
-  Licensed under MIT license
-  
-  Copyright (C) <2018>  <Bob Lemaire, IoTaWatt, Inc.>
-  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
-  as published bythe Free Software Foundation, either version 3 of the License, or (at your option) any later version.
-  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
-  You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
- 
-  Version: 1.4.1
-  
-  Version Modified By   Date      Comments
-  ------- -----------  ---------- -----------
-  1.0.0    K Hoang     14/09/2020 Initial coding to add support to STM32 using built-in Ethernet (Nucleo-144, DISCOVERY, etc).
-  1.0.1    K Hoang     09/10/2020 Restore cpp code besides Impl.h code.
-  1.0.2    K Hoang     09/11/2020 Make Mutex Lock and delete more reliable and error-proof
-  1.1.0    K Hoang     23/12/2020 Add HTTP PUT, PATCH, DELETE and HEAD methods
-  1.1.1    K Hoang     24/12/2020 Prevent crash if request and/or method not correct.
-  1.1.2    K Hoang     11/02/2021 Rename _lock and _unlock to avoid conflict with AsyncWebServer library
-  1.1.3    K Hoang     25/02/2021 Fix non-persistent Connection header bug
-  1.1.4    K Hoang     21/03/2021 Fix `library.properties` dependency
-  1.1.5    K Hoang     22/03/2021 Fix dependency on STM32AsyncTCP Library
-  1.2.0    K Hoang     11/04/2021 Add support to LAN8720 using STM32F4 or STM32F7
-  1.3.0    K Hoang     09/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720) boards
-  1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
-  1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
-  1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
- *****************************************************************************************************************************/
-
-#include "utility/xbuf.h"
-
-xbuf::xbuf(const uint16_t segSize) : _head(nullptr), _tail(nullptr), _used(0), _free(0), _offset(0) 
-{
-  _segSize = (segSize + 3) & -4;//((segSize + 3) >> 2) << 2;
-}
-
-//*******************************************************************************************************************
-xbuf::~xbuf() 
-{
-  flush();
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(const uint8_t byte) 
-{
-  return write((uint8_t*) &byte, 1);
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(const char* buf) 
-{
-  return write((uint8_t*)buf, strlen(buf));
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(String string) 
-{
-  return write((uint8_t*)string.c_str(), string.length());
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(const uint8_t* buf, const size_t len) 
-{
-  size_t supply = len;
-  
-  while (supply) 
-  {
-    if (!_free) 
-    {
-      addSeg();
-    }
-    
-    size_t demand = _free < supply ? _free : supply;
-    memcpy(_tail->data + ((_offset + _used) % _segSize), buf + (len - supply), demand);
-    _free -= demand;
-    _used += demand;
-    supply -= demand;
-  }
-  
-  return len;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(xbuf* buf, const size_t len) 
-{
-  size_t supply = len;
-  
-  if (supply > buf->available()) 
-  {
-    supply = buf->available();
-  }
-  
-  size_t read = 0;
-  
-  while (supply) 
-  {
-    if (!_free) 
-    {
-      addSeg();
-    }
-    
-    size_t demand = _free < supply ? _free : supply;
-    read += buf->read(_tail->data + ((_offset + _used) % _segSize), demand);
-    _free -= demand;
-    _used += demand;
-    supply -= demand;
-  }
-  
-  return read;
-}
-
-//*******************************************************************************************************************
-uint8_t xbuf::read() 
-{
-  uint8_t byte = 0;
-  read((uint8_t*) &byte, 1);
-  
-  return byte;
-}
-
-//*******************************************************************************************************************
-uint8_t xbuf::peek() 
-{
-  uint8_t byte = 0;
-  peek((uint8_t*) &byte, 1);
-  
-  return byte;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::read(uint8_t* buf, const size_t len) 
-{
-  size_t read = 0;
-  
-  while (read < len && _used) 
-  {
-    size_t supply = (_offset + _used) > _segSize ? _segSize - _offset : _used;
-    size_t demand = len - read;
-    size_t chunk = supply < demand ? supply : demand;
-    memcpy(buf + read, _head->data + _offset, chunk);
-    _offset += chunk;
-    _used -= chunk;
-    read += chunk;
-    
-    if (_offset == _segSize) 
-    {
-      remSeg();
-      _offset = 0;
-    }
-  }
-  
-  if ( ! _used) 
-  {
-    flush();
-  }
-  
-  return read;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::peek(uint8_t* buf, const size_t len) 
-{
-  size_t read   = 0;
-  xseg* seg     = _head;
-  size_t offset = _offset;
-  size_t used   = _used;
-  
-  while (read < len && used) 
-  {
-    size_t supply = (offset + used) > _segSize ? _segSize - offset : used;
-    size_t demand = len - read;
-    size_t chunk  = supply < demand ? supply : demand;
-    
-    memcpy(buf + read, seg->data + offset, chunk);
-    
-    offset  += chunk;
-    used    -= chunk;
-    read    += chunk;
-    
-    if (offset == _segSize) 
-    {
-      seg = seg->next;
-      offset = 0;
-    }
-  }
-  
-  return read;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::available() 
-{
-  return _used;
-}
-
-//*******************************************************************************************************************
-int xbuf::indexOf(const char target, const size_t begin) 
-{
-  char targetstr[2] = " ";
-  targetstr[0] = target;
-  
-  return indexOf(targetstr, begin);
-}
-
-//*******************************************************************************************************************
-int xbuf::indexOf(const char* target, const size_t begin) 
-{
-  size_t targetLen = strlen(target);
-  
-  if (targetLen > _segSize || targetLen > _used) 
-    return -1;
-    
-  size_t searchPos = _offset + begin;
-  size_t searchEnd = _offset + _used - targetLen;
-  
-  if (searchPos > searchEnd) 
-    return -1;
-    
-  size_t searchSeg = searchPos / _segSize;
-  xseg* seg = _head;
-  
-  while (searchSeg) 
-  {
-    seg = seg->next;
-    searchSeg --;
-  }
-  
-  size_t segPos = searchPos % _segSize;
-  
-  while (searchPos <= searchEnd) 
-  {
-    size_t compLen = targetLen;
-    
-    if (compLen <= (_segSize - segPos)) 
-    {
-      if (memcmp(target, seg->data + segPos, compLen) == 0) 
-      {
-        return searchPos - _offset;
-      }
-    }
-    else 
-    {
-      size_t compLen = _segSize - segPos;
-      
-      if (memcmp(target, seg->data + segPos, compLen) == 0) 
-      {
-        compLen = targetLen - compLen;
-        
-        if (memcmp(target + targetLen - compLen, seg->next->data, compLen) == 0) 
-        {
-          return searchPos - _offset;
-        }
-      }
-    }
-    
-    searchPos++;
-    segPos++;
-    
-    if (segPos == _segSize) 
-    {
-      seg = seg->next;
-      segPos = 0;
-    }
-  }
-  
-  return -1;
-}
-
-//*******************************************************************************************************************
-String xbuf::readStringUntil(const char target) 
-{
-  return readString(indexOf(target) + 1);
-}
-
-//*******************************************************************************************************************
-String xbuf::readStringUntil(const char* target) 
-{
-  int index = indexOf(target);
-  
-  if (index < 0) 
-    return String();
-    
-  return readString(index + strlen(target));
-}
-
-//*******************************************************************************************************************
-String xbuf::readString(int endPos) 
-{
-  String result;
-  
-  if ( ! result.reserve(endPos + 1)) 
-  {
-    return result;
-  }
-  
-  if (endPos > _used) 
-  {
-    endPos = _used;
-  }
-  
-  if (endPos > 0 && result.reserve(endPos + 1)) 
-  {
-    while (endPos--) 
-    {
-      result += (char)_head->data[_offset++];
-      _used--;
-      
-      if (_offset >= _segSize) 
-      {
-        remSeg();
-      }
-    }
-  }
-  
-  return result;
-}
-
-//*******************************************************************************************************************
-String xbuf::peekString(int endPos) 
-{
-  String result;
-  
-  xseg* seg     = _head;
-  size_t offset = _offset;
-  
-  if (endPos > _used) 
-  {
-    endPos = _used;
-  }
-  
-  if (endPos > 0 && result.reserve(endPos + 1)) 
-  {
-    while (endPos--) 
-    {
-      result += (char)seg->data[offset++];
-      
-      if ( offset >= _segSize) 
-      {
-        seg = seg->next;
-        offset = 0;
-      }
-    }
-  }
-  
-  return result;
-}
-
-//*******************************************************************************************************************
-void xbuf::flush() 
-{
-  while (_head) 
-    remSeg();
-  
-  _tail = nullptr;
-  _offset = 0;
-  _used = 0;
-  _free = 0;
-}
-
-//*******************************************************************************************************************
-void xbuf::addSeg() 
-{
-  if (_tail) 
-  {
-    _tail->next = (xseg*) new uint32_t[_segSize / 4 + 1];
-    
-    // KH, Must check NULL here
-    _tail = _tail->next;
-  }
-  else 
-  {
-    // KH, Must check NULL here
-    _tail = _head = (xseg*) new uint32_t[_segSize / 4 + 1];
-  }
-  
-  // KH, Must check NULL here
-  if (_tail)
-    _tail->next = nullptr;
-    
-  _free += _segSize;
-}
-
-//*******************************************************************************************************************
-void xbuf::remSeg() 
-{
-  if (_head) 
-  {
-    xseg *next = _head->next;
-    delete[] (uint32_t*) _head;
-    _head = next;
-    
-    if ( ! _head) 
-    {
-      _tail = nullptr;
-    }
-  }
-  
-  _offset = 0;
-}
-

src_cpp/utility/xbuf.h

@@ -1,166 +0,0 @@
-/****************************************************************************************************************************
-  xbuf.h - Dead simple AsyncHTTPRequest for ESP8266, ESP32 and currently STM32 with built-in LAN8742A Ethernet
-  
-  For ESP8266, ESP32 and STM32 with built-in LAN8742A Ethernet (Nucleo-144, DISCOVERY, etc)
-  
-  AsyncHTTPRequest_STM32 is a library for the ESP8266, ESP32 and currently STM32 run built-in Ethernet WebServer
-  
-  Based on and modified from asyncHTTPrequest Library (https://github.com/boblemaire/asyncHTTPrequest)
-  
-  Built by Khoi Hoang https://github.com/khoih-prog/AsyncHTTPRequest_Generic
-  Licensed under MIT license
-  
-  Copyright (C) <2018>  <Bob Lemaire, IoTaWatt, Inc.>
-  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
-  as published bythe Free Software Foundation, either version 3 of the License, or (at your option) any later version.
-  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
-  You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
- 
-  Version: 1.4.1
-  
-  Version Modified By   Date      Comments
-  ------- -----------  ---------- -----------
-  1.0.0    K Hoang     14/09/2020 Initial coding to add support to STM32 using built-in Ethernet (Nucleo-144, DISCOVERY, etc).
-  1.0.1    K Hoang     09/10/2020 Restore cpp code besides Impl.h code.
-  1.0.2    K Hoang     09/11/2020 Make Mutex Lock and delete more reliable and error-proof
-  1.1.0    K Hoang     23/12/2020 Add HTTP PUT, PATCH, DELETE and HEAD methods
-  1.1.1    K Hoang     24/12/2020 Prevent crash if request and/or method not correct.
-  1.1.2    K Hoang     11/02/2021 Rename _lock and _unlock to avoid conflict with AsyncWebServer library
-  1.1.3    K Hoang     25/02/2021 Fix non-persistent Connection header bug
-  1.1.4    K Hoang     21/03/2021 Fix `library.properties` dependency
-  1.1.5    K Hoang     22/03/2021 Fix dependency on STM32AsyncTCP Library
-  1.2.0    K Hoang     11/04/2021 Add support to LAN8720 using STM32F4 or STM32F7
-  1.3.0    K Hoang     09/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720) boards
-  1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
-  1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
-  1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
- *****************************************************************************************************************************/
- 
-/********************************************************************************************
-  xbuf is a dynamic buffering system that supports reading and writing much like cbuf.
-  The class has it's own provision for writing from buffers, Strings and other xbufs
-  as well as the inherited Print functions.
-  Rather than use a large contiguous heap allocation, xbuf uses a linked chain of segments
-  to dynamically grow and shrink with the contents.
-  There are other benefits as well to using smaller heap allocation units:
-  1) A buffer can work fine in a fragmented heap environment (admittedly contributing to it)
-  2) xbuf contents can be copied from one buffer to another without the need for 
-     2x heap during the copy.
-  The segment size defaults to 64 but can be dynamically set in the constructor at creation.   
-  The inclusion of indexOf and read/peek until functions make it useful for handling
-  data streams like HTTP, and in fact is why it was created.
-
-  NOTE: The size of the indexOf() search string is limited to the segment size.
-        It could be extended but didn't seem to be a practical consideration.    
-   
-********************************************************************************************/
-#pragma once
-
-#ifndef XBUF_H
-#define XBUF_H
-
-#include <Arduino.h>
-
-struct xseg 
-{
-  xseg    *next;
-  uint8_t data[];
-};
-
-class xbuf: public Print 
-{
-  public:
-
-    xbuf(const uint16_t segSize = 64);
-    virtual ~xbuf();
-
-    size_t      write(const uint8_t);
-    size_t      write(const char*);
-    size_t      write(const uint8_t*, const size_t);
-    size_t      write(xbuf*, const size_t);
-    size_t      write(String);
-    size_t      available();
-    int         indexOf(const char, const size_t begin = 0);
-    int         indexOf(const char*, const size_t begin = 0);
-    uint8_t     read();
-    size_t      read(uint8_t*, size_t);
-    String      readStringUntil(const char);
-    String      readStringUntil(const char*);
-    String      readString(int);
-    
-    String      readString() 
-    {
-      return readString(available());
-    }
-    
-    void        flush();
-
-    uint8_t     peek();
-    size_t      peek(uint8_t*, const size_t);
-    
-    String      peekStringUntil(const char target) 
-    {
-      return peekString(indexOf(target, 0));
-    }
-    
-    String      peekStringUntil(const char* target) 
-    {
-      return peekString(indexOf(target, 0));
-    }
-    
-    String      peekString() 
-    {
-      return peekString(_used);
-    }
-    
-    String      peekString(int);
-
-    /*      In addition to the above functions,
-    the following inherited functions from the Print class are available.
-    
-    size_t printf(const char * format, ...)  __attribute__ ((format (printf, 2, 3)));
-    size_t printf_P(PGM_P format, ...) __attribute__((format(printf, 2, 3)));
-    size_t print(const __FlashStringHelper *);
-    size_t print(const String &);
-    size_t print(const char[]);
-    size_t print(char);
-    size_t print(unsigned char, int = DEC);
-    size_t print(int, int = DEC);
-    size_t print(unsigned int, int = DEC);
-    size_t print(long, int = DEC);
-    size_t print(unsigned long, int = DEC);
-    size_t print(double, int = 2);
-    size_t print(const Printable&);
-    
-    size_t println(const __FlashStringHelper *);
-    size_t println(const String &s);
-    size_t println(const char[]);
-    size_t println(char);
-    size_t println(unsigned char, int = DEC);
-    size_t println(int, int = DEC);
-    size_t println(unsigned int, int = DEC);
-    size_t println(long, int = DEC);
-    size_t println(unsigned long, int = DEC);
-    size_t println(double, int = 2);
-    size_t println(const Printable&);
-    size_t println(void);
-    */
-
-  protected:
-
-    xseg        *_head;
-    xseg        *_tail;
-    uint16_t     _used;
-    uint16_t     _free;
-    uint16_t     _offset;
-    uint16_t     _segSize;
-
-    void        addSeg();
-    void        remSeg();
-
-};
-
-
-#endif    // XBUF_H
-

src_h/AsyncHTTPRequest_Debug_Generic.h

@@ -1,107 +0,0 @@
-/****************************************************************************************************************************
-  AsyncHTTPRequest_Debug_Generic.h - Dead simple AsyncHTTPRequest for ESP8266, ESP32 and currently STM32 with built-in LAN8742A Ethernet
-  
-  For ESP8266, ESP32 and STM32 with built-in LAN8742A Ethernet (Nucleo-144, DISCOVERY, etc)
-  
-  AsyncHTTPRequest_STM32 is a library for the ESP8266, ESP32 and currently STM32 run built-in Ethernet WebServer
-  
-  Based on and modified from asyncHTTPrequest Library (https://github.com/boblemaire/asyncHTTPrequest)
-  
-  Built by Khoi Hoang https://github.com/khoih-prog/AsyncHTTPRequest_Generic
-  Licensed under MIT license
-  
-  Copyright (C) <2018>  <Bob Lemaire, IoTaWatt, Inc.>
-  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
-  as published bythe Free Software Foundation, either version 3 of the License, or (at your option) any later version.
-  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
-  You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
- 
-  Version: 1.4.1
-  
-  Version Modified By   Date      Comments
-  ------- -----------  ---------- -----------
-  1.0.0    K Hoang     14/09/2020 Initial coding to add support to STM32 using built-in Ethernet (Nucleo-144, DISCOVERY, etc).
-  1.0.1    K Hoang     09/10/2020 Restore cpp code besides Impl.h code.
-  1.0.2    K Hoang     09/11/2020 Make Mutex Lock and delete more reliable and error-proof
-  1.1.0    K Hoang     23/12/2020 Add HTTP PUT, PATCH, DELETE and HEAD methods
-  1.1.1    K Hoang     24/12/2020 Prevent crash if request and/or method not correct.
-  1.1.2    K Hoang     11/02/2021 Rename _lock and _unlock to avoid conflict with AsyncWebServer library
-  1.1.3    K Hoang     25/02/2021 Fix non-persistent Connection header bug
-  1.1.4    K Hoang     21/03/2021 Fix `library.properties` dependency
-  1.1.5    K Hoang     22/03/2021 Fix dependency on STM32AsyncTCP Library
-  1.2.0    K Hoang     11/04/2021 Add support to LAN8720 using STM32F4 or STM32F7
-  1.3.0    K Hoang     09/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720) boards
-  1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
-  1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
-  1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
- *****************************************************************************************************************************/
-
-#pragma once
-
-#ifndef ASYNC_HTTP_REQUEST_DEBUG_GENERIC_H
-#define ASYNC_HTTP_REQUEST_DEBUG_GENERIC_H
-
-#ifdef ASYNC_HTTP_DEBUG_PORT
-  #define A_DBG_PORT      ASYNC_HTTP_DEBUG_PORT
-#else
-  #define A_DBG_PORT      Serial
-#endif
-
-// Change _ASYNC_HTTP_LOGLEVEL_ to set tracing and logging verbosity
-// 0: DISABLED: no logging
-// 1: ERROR: errors
-// 2: WARN: errors and warnings
-// 3: INFO: errors, warnings and informational (default)
-// 4: DEBUG: errors, warnings, informational and debug
-
-#ifndef _ASYNC_HTTP_LOGLEVEL_
-  #define _ASYNC_HTTP_LOGLEVEL_       0
-#endif
-
-/////////////////////////////////////////////////////////
-
-const char AHTTP_MARK[] = "[AHTTP] ";
-
-#define AHTTP_PRINT_MARK   AHTTP_PRINT(AHTTP_MARK)
-#define AHTTP_PRINT_SP     A_DBG_PORT.print(" ")
-
-#define AHTTP_PRINT        A_DBG_PORT.print
-#define AHTTP_PRINTLN      A_DBG_PORT.println
-
-/////////////////////////////////////////////////////////
-
-#define AHTTP_LOGERROR(x)         if(_ASYNC_HTTP_LOGLEVEL_>0) { AHTTP_PRINT_MARK; AHTTP_PRINTLN(x); }
-#define AHTTP_LOGERROR0(x)        if(_ASYNC_HTTP_LOGLEVEL_>0) { AHTTP_PRINT(x); }
-#define AHTTP_LOGERROR1(x,y)      if(_ASYNC_HTTP_LOGLEVEL_>0) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINTLN(y); }
-#define AHTTP_LOGERROR2(x,y,z)    if(_ASYNC_HTTP_LOGLEVEL_>0) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINTLN(z); }
-#define AHTTP_LOGERROR3(x,y,z,w)  if(_ASYNC_HTTP_LOGLEVEL_>0) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINT(z); AHTTP_PRINT_SP; AHTTP_PRINTLN(w); }
-
-/////////////////////////////////////////////////////////
-
-#define AHTTP_LOGWARN(x)          if(_ASYNC_HTTP_LOGLEVEL_>1) { AHTTP_PRINT_MARK; AHTTP_PRINTLN(x); }
-#define AHTTP_LOGWARN0(x)         if(_ASYNC_HTTP_LOGLEVEL_>1) { AHTTP_PRINT(x); }
-#define AHTTP_LOGWARN1(x,y)       if(_ASYNC_HTTP_LOGLEVEL_>1) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINTLN(y); }
-#define AHTTP_LOGWARN2(x,y,z)     if(_ASYNC_HTTP_LOGLEVEL_>1) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINTLN(z); }
-#define AHTTP_LOGWARN3(x,y,z,w)   if(_ASYNC_HTTP_LOGLEVEL_>1) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINT(z); AHTTP_PRINT_SP; AHTTP_PRINTLN(w); }
-
-/////////////////////////////////////////////////////////
-
-#define AHTTP_LOGINFO(x)          if(_ASYNC_HTTP_LOGLEVEL_>2) { AHTTP_PRINT_MARK; AHTTP_PRINTLN(x); }
-#define AHTTP_LOGINFO0(x)         if(_ASYNC_HTTP_LOGLEVEL_>2) { AHTTP_PRINT(x); }
-#define AHTTP_LOGINFO1(x,y)       if(_ASYNC_HTTP_LOGLEVEL_>2) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINTLN(y); }
-#define AHTTP_LOGINFO2(x,y,z)     if(_ASYNC_HTTP_LOGLEVEL_>2) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINTLN(z); }
-#define AHTTP_LOGINFO3(x,y,z,w)   if(_ASYNC_HTTP_LOGLEVEL_>2) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINT(z); AHTTP_PRINT_SP; AHTTP_PRINTLN(w); }
-
-/////////////////////////////////////////////////////////
-
-#define AHTTP_LOGDEBUG(x)         if(_ASYNC_HTTP_LOGLEVEL_>3) { AHTTP_PRINT_MARK; AHTTP_PRINTLN(x); }
-#define AHTTP_LOGDEBUG0(x)        if(_ASYNC_HTTP_LOGLEVEL_>3) { AHTTP_PRINT(x); }
-#define AHTTP_LOGDEBUG1(x,y)      if(_ASYNC_HTTP_LOGLEVEL_>3) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINTLN(y); }
-#define AHTTP_LOGDEBUG2(x,y,z)    if(_ASYNC_HTTP_LOGLEVEL_>3) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINTLN(z); }
-#define AHTTP_LOGDEBUG3(x,y,z,w)  if(_ASYNC_HTTP_LOGLEVEL_>3) { AHTTP_PRINT_MARK; AHTTP_PRINT(x); AHTTP_PRINT_SP; AHTTP_PRINT(y); AHTTP_PRINT_SP; AHTTP_PRINT(z); AHTTP_PRINT_SP; AHTTP_PRINTLN(w); }
-
-/////////////////////////////////////////////////////////
-
-#endif    // ASYNC_HTTP_REQUEST_DEBUG_GENERIC_H
-

src_h/AsyncHTTPRequest_Generic.h

@@ -1,317 +0,0 @@
-/****************************************************************************************************************************
-  AsyncHTTPRequest_Generic.h - Dead simple AsyncHTTPRequest for ESP8266, ESP32 and currently STM32 with built-in LAN8742A Ethernet
-  
-  For ESP8266, ESP32 and STM32 with built-in LAN8742A Ethernet (Nucleo-144, DISCOVERY, etc)
-  
-  AsyncHTTPRequest_STM32 is a library for the ESP8266, ESP32 and currently STM32 run built-in Ethernet WebServer
-  
-  Based on and modified from asyncHTTPrequest Library (https://github.com/boblemaire/asyncHTTPrequest)
-  
-  Built by Khoi Hoang https://github.com/khoih-prog/AsyncHTTPRequest_Generic
-  Licensed under MIT license
-  
-  Copyright (C) <2018>  <Bob Lemaire, IoTaWatt, Inc.>
-  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
-  as published bythe Free Software Foundation, either version 3 of the License, or (at your option) any later version.
-  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
-  You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
- 
-  Version: 1.4.1
-  
-  Version Modified By   Date      Comments
-  ------- -----------  ---------- -----------
-  1.0.0    K Hoang     14/09/2020 Initial coding to add support to STM32 using built-in Ethernet (Nucleo-144, DISCOVERY, etc).
-  1.0.1    K Hoang     09/10/2020 Restore cpp code besides Impl.h code.
-  1.0.2    K Hoang     09/11/2020 Make Mutex Lock and delete more reliable and error-proof
-  1.1.0    K Hoang     23/12/2020 Add HTTP PUT, PATCH, DELETE and HEAD methods
-  1.1.1    K Hoang     24/12/2020 Prevent crash if request and/or method not correct.
-  1.1.2    K Hoang     11/02/2021 Rename _lock and _unlock to avoid conflict with AsyncWebServer library
-  1.1.3    K Hoang     25/02/2021 Fix non-persistent Connection header bug
-  1.1.4    K Hoang     21/03/2021 Fix `library.properties` dependency
-  1.1.5    K Hoang     22/03/2021 Fix dependency on STM32AsyncTCP Library
-  1.2.0    K Hoang     11/04/2021 Add support to LAN8720 using STM32F4 or STM32F7
-  1.3.0    K Hoang     09/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720) boards
-  1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
-  1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
-  1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
- *****************************************************************************************************************************/
-
-#pragma once
-
-#ifndef ASYNC_HTTP_REQUEST_GENERIC_H
-#define ASYNC_HTTP_REQUEST_GENERIC_H
-
-#define ASYNC_HTTP_REQUEST_GENERIC_VERSION   "AsyncHTTPRequest_Generic v1.4.1"
-
-#include <Arduino.h>
-
-#include "AsyncHTTPRequest_Debug_Generic.h"
-
-#ifndef DEBUG_IOTA_PORT
-  #define DEBUG_IOTA_PORT Serial
-#endif
-
-#ifdef DEBUG_IOTA_HTTP
-  #define DEBUG_IOTA_HTTP_SET     true
-#else
-  #define DEBUG_IOTA_HTTP_SET     false
-#endif
-
-
-// KH add
-#define SAFE_DELETE(object)         if (object) { delete object;}
-#define SAFE_DELETE_ARRAY(object)   if (object) { delete[] object;}
-
-#if ESP32
-
-  #include <AsyncTCP.h>
-  
-  // KH mod
-  #define MUTEX_LOCK_NR           if (xSemaphoreTakeRecursive(threadLock,portMAX_DELAY) != pdTRUE) { return;}
-  #define MUTEX_LOCK(returnVal)   if (xSemaphoreTakeRecursive(threadLock,portMAX_DELAY) != pdTRUE) { return returnVal;}
-  
-  #define _AHTTP_lock       xSemaphoreTakeRecursive(threadLock,portMAX_DELAY)
-  #define _AHTTP_unlock     xSemaphoreGiveRecursive(threadLock)
-  
-#elif ESP8266
-
-  #include <ESPAsyncTCP.h>
-  
-  #define MUTEX_LOCK_NR
-  #define MUTEX_LOCK(returnVal)
-  
-  #define _AHTTP_lock
-  #define _AHTTP_unlock
-  
-#elif ( defined(STM32F0) || defined(STM32F1) || defined(STM32F2) || defined(STM32F3)  ||defined(STM32F4) || defined(STM32F7) || \
-       defined(STM32L0) || defined(STM32L1) || defined(STM32L4) || defined(STM32H7)  ||defined(STM32G0) || defined(STM32G4) || \
-       defined(STM32WB) || defined(STM32MP1) )
-       
-  #include "STM32AsyncTCP.h"
-  
-  #define MUTEX_LOCK_NR
-  #define MUTEX_LOCK(returnVal)
-  #define _AHTTP_lock
-  #define _AHTTP_unlock
-  
-#endif
-
-#include <pgmspace.h>
-#include <utility/xbuf.h>
-
-#define DEBUG_HTTP(format,...)  if(_debug){\
-    DEBUG_IOTA_PORT.printf("Debug(%3ld): ", millis()-_requestStartTime);\
-    DEBUG_IOTA_PORT.printf_P(PSTR(format),##__VA_ARGS__);}
-
-#define DEFAULT_RX_TIMEOUT 3                    // Seconds for timeout
-
-#define HTTPCODE_CONNECTION_REFUSED  (-1)
-#define HTTPCODE_SEND_HEADER_FAILED  (-2)
-#define HTTPCODE_SEND_PAYLOAD_FAILED (-3)
-#define HTTPCODE_NOT_CONNECTED       (-4)
-#define HTTPCODE_CONNECTION_LOST     (-5)
-#define HTTPCODE_NO_STREAM           (-6)
-#define HTTPCODE_NO_HTTP_SERVER      (-7)
-#define HTTPCODE_TOO_LESS_RAM        (-8)
-#define HTTPCODE_ENCODING            (-9)
-#define HTTPCODE_STREAM_WRITE        (-10)
-#define HTTPCODE_TIMEOUT             (-11)
-
-typedef enum
-{
-  readyStateUnsent      = 0,            // Client created, open not yet called
-  readyStateOpened      = 1,            // open() has been called, connected
-  readyStateHdrsRecvd   = 2,            // send() called, response headers available
-  readyStateLoading     = 3,            // receiving, partial data available
-  readyStateDone        = 4             // Request complete, all data available.
-} reqStates;
-    
-class AsyncHTTPRequest
-{
-    struct header
-    {
-      header*   next;
-      char*     name;
-      char*     value;
-      
-      header(): next(nullptr), name(nullptr), value(nullptr)
-      {};
-      
-      ~header() 
-      {
-        SAFE_DELETE_ARRAY(name)
-        SAFE_DELETE_ARRAY(value)
-        SAFE_DELETE(next)
-        //delete[] name;
-        //delete[] value;
-        //delete next;
-      }
-    };
-
-    struct  URL 
-    {
-      char*   scheme;
-      char*   user;
-      char*   pwd;
-      char*   host;
-      int     port;
-      char*   path;
-      char*   query;
-      char*   fragment;
-      
-      URL():  scheme(nullptr), user(nullptr), pwd(nullptr), host(nullptr),
-              port(80), path(nullptr), query(nullptr), fragment(nullptr)
-      {};
-      
-      ~URL() 
-      {
-        SAFE_DELETE_ARRAY(scheme)
-        SAFE_DELETE_ARRAY(user)
-        SAFE_DELETE_ARRAY(pwd)
-        SAFE_DELETE_ARRAY(host)
-        SAFE_DELETE_ARRAY(path)
-        SAFE_DELETE_ARRAY(query)
-        SAFE_DELETE_ARRAY(fragment)
-      }
-    };
-
-    typedef std::function<void(void*, AsyncHTTPRequest*, int readyState)> readyStateChangeCB;
-    typedef std::function<void(void*, AsyncHTTPRequest*, size_t available)> onDataCB;
-
-  public:
-    AsyncHTTPRequest();
-    ~AsyncHTTPRequest();
-
-
-    //External functions in typical order of use:
-    //__________________________________________________________________________________________________________*/
-    void        setDebug(bool);                                         // Turn debug message on/off
-    bool        debug();                                                // is debug on or off?
-
-    bool        open(const char* /*GET/POST*/, const char* URL);        // Initiate a request
-    void        onReadyStateChange(readyStateChangeCB, void* arg = 0);  // Optional event handler for ready state change
-    // or you can simply poll readyState()
-    void        setTimeout(int);                                        // overide default timeout (seconds)
-
-    void        setReqHeader(const char* name, const char* value);      // add a request header
-    void        setReqHeader(const char* name, int32_t value);          // overload to use integer value
-    
-#if (ESP32 || ESP8266)
-    void        setReqHeader(const char* name, const __FlashStringHelper* value);
-    void        setReqHeader(const __FlashStringHelper *name, const char* value);
-    void        setReqHeader(const __FlashStringHelper *name, const __FlashStringHelper* value);
-    void        setReqHeader(const __FlashStringHelper *name, int32_t value);
-#endif
-
-    bool        send();                                                 // Send the request (GET)
-    bool        send(String body);                                      // Send the request (POST)
-    bool        send(const char* body);                                 // Send the request (POST)
-    bool        send(const uint8_t* buffer, size_t len);                // Send the request (POST) (binary data?)
-    bool        send(xbuf* body, size_t len);                           // Send the request (POST) data in an xbuf
-    void        abort();                                                // Abort the current operation
-
-    reqStates   readyState();                                           // Return the ready state
-
-    int         respHeaderCount();                                      // Retrieve count of response headers
-    char*       respHeaderName(int index);                              // Return header name by index
-    char*       respHeaderValue(int index);                             // Return header value by index
-    char*       respHeaderValue(const char* name);                      // Return header value by name
-    
-    bool        respHeaderExists(const char* name);                     // Does header exist by name?
-    
-#if (ESP32 || ESP8266)
-    char*       respHeaderValue(const __FlashStringHelper *name);
-    bool        respHeaderExists(const __FlashStringHelper *name);
-#endif
-    
-    String      headers();                                              // Return all headers as String
-
-    void        onData(onDataCB, void* arg = 0);                        // Notify when min data is available
-    size_t      available();                                            // response available
-    size_t      responseLength();                                       // indicated response length or sum of chunks to date
-    int         responseHTTPcode();                                     // HTTP response code or (negative) error code
-    String      responseText();                                         // response (whole* or partial* as string)
-    
-    char*       responseLongText();                                     // response long (whole* or partial* as string)
-    
-    size_t      responseRead(uint8_t* buffer, size_t len);              // Read response into buffer
-    uint32_t    elapsedTime();                                          // Elapsed time of in progress transaction or last completed (ms)
-    String      version();                                              // Version of AsyncHTTPRequest
-    //___________________________________________________________________________________________________________________________________
-
-  private:
-
-    // New in v1.1.1
-    bool _requestReadyToSend;
-    //////
-    
-    // New in v1.1.0
-    typedef enum  { HTTPmethodGET, HTTPmethodPOST, HTTPmethodPUT, HTTPmethodPATCH, HTTPmethodDELETE, HTTPmethodHEAD, HTTPmethodMAX } HTTPmethod;
-    
-    HTTPmethod _HTTPmethod;
-    
-    const char* _HTTPmethodStringwithSpace[HTTPmethodMAX] = {"GET ", "POST ", "PUT ", "PATCH ", "DELETE ", "HEAD "};
-    //////
-    
-    reqStates       _readyState;
-
-    int16_t         _HTTPcode;                  // HTTP response code or (negative) exception code
-    bool            _chunked;                   // Processing chunked response
-    bool            _debug;                     // Debug state
-    uint32_t        _timeout;                   // Default or user overide RxTimeout in seconds
-    uint32_t        _lastActivity;              // Time of last activity
-    uint32_t        _requestStartTime;          // Time last open() issued
-    uint32_t        _requestEndTime;            // Time of last disconnect
-    URL*            _URL;                       // -> URL data structure
-    char*           _connectedHost;             // Host when connected
-    int             _connectedPort;             // Port when connected
-    AsyncClient*    _client;                    // ESPAsyncTCP AsyncClient instance
-    size_t          _contentLength;             // content-length header value or sum of chunk headers
-    size_t          _contentRead;               // number of bytes retrieved by user since last open()
-    readyStateChangeCB  _readyStateChangeCB;    // optional callback for readyState change
-    void*           _readyStateChangeCBarg;     // associated user argument
-    onDataCB        _onDataCB;                  // optional callback when data received
-    void*           _onDataCBarg;               // associated user argument
-
-#ifdef ESP32
-    SemaphoreHandle_t threadLock;
-#endif
-
-    // request and response String buffers and header list (same queue for request and response).
-
-    xbuf*       _request;                       // Tx data buffer
-    xbuf*       _response;                      // Rx data buffer for headers
-    xbuf*       _chunks;                        // First stage for chunked response
-    header*     _headers;                       // request or (readyState > readyStateHdrsRcvd) response headers
-
-    // Protected functions
-
-    header*     _addHeader(const char*, const char*);
-    header*     _getHeader(const char*);
-    header*     _getHeader(int);
-    bool        _buildRequest();
-    bool        _parseURL(const char*);
-    bool        _parseURL(String);
-    void        _processChunks();
-    bool        _connect();
-    size_t      _send();
-    void        _setReadyState(reqStates);
-    
-#if (ESP32 || ESP8266)    
-    char*       _charstar(const __FlashStringHelper *str);
-#endif
-
-    // callbacks
-
-    void        _onConnect(AsyncClient*);
-    void        _onDisconnect(AsyncClient*);
-    void        _onData(void*, size_t);
-    void        _onError(AsyncClient*, int8_t);
-    void        _onPoll(AsyncClient*);
-    bool        _collectHeaders();
-};
-
-#include "AsyncHTTPRequest_Impl_Generic.h"
-
-#endif    // ASYNC_HTTP_REQUEST_GENERIC_H

src_h/utility/xbuf.h

@@ -1,167 +0,0 @@
-/****************************************************************************************************************************
-  xbuf.h - Dead simple AsyncHTTPRequest for ESP8266, ESP32 and currently STM32 with built-in LAN8742A Ethernet
-  
-  For ESP8266, ESP32 and STM32 with built-in LAN8742A Ethernet (Nucleo-144, DISCOVERY, etc)
-  
-  AsyncHTTPRequest_STM32 is a library for the ESP8266, ESP32 and currently STM32 run built-in Ethernet WebServer
-  
-  Based on and modified from asyncHTTPrequest Library (https://github.com/boblemaire/asyncHTTPrequest)
-  
-  Built by Khoi Hoang https://github.com/khoih-prog/AsyncHTTPRequest_Generic
-  Licensed under MIT license
-  
-  Copyright (C) <2018>  <Bob Lemaire, IoTaWatt, Inc.>
-  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
-  as published bythe Free Software Foundation, either version 3 of the License, or (at your option) any later version.
-  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
-  You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
- 
-  Version: 1.4.1
-  
-  Version Modified By   Date      Comments
-  ------- -----------  ---------- -----------
-  1.0.0    K Hoang     14/09/2020 Initial coding to add support to STM32 using built-in Ethernet (Nucleo-144, DISCOVERY, etc).
-  1.0.1    K Hoang     09/10/2020 Restore cpp code besides Impl.h code.
-  1.0.2    K Hoang     09/11/2020 Make Mutex Lock and delete more reliable and error-proof
-  1.1.0    K Hoang     23/12/2020 Add HTTP PUT, PATCH, DELETE and HEAD methods
-  1.1.1    K Hoang     24/12/2020 Prevent crash if request and/or method not correct.
-  1.1.2    K Hoang     11/02/2021 Rename _lock and _unlock to avoid conflict with AsyncWebServer library
-  1.1.3    K Hoang     25/02/2021 Fix non-persistent Connection header bug
-  1.1.4    K Hoang     21/03/2021 Fix `library.properties` dependency
-  1.1.5    K Hoang     22/03/2021 Fix dependency on STM32AsyncTCP Library
-  1.2.0    K Hoang     11/04/2021 Add support to LAN8720 using STM32F4 or STM32F7
-  1.3.0    K Hoang     09/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720) boards
-  1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
-  1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
-  1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
- *****************************************************************************************************************************/
- 
-/********************************************************************************************
-  xbuf is a dynamic buffering system that supports reading and writing much like cbuf.
-  The class has it's own provision for writing from buffers, Strings and other xbufs
-  as well as the inherited Print functions.
-  Rather than use a large contiguous heap allocation, xbuf uses a linked chain of segments
-  to dynamically grow and shrink with the contents.
-  There are other benefits as well to using smaller heap allocation units:
-  1) A buffer can work fine in a fragmented heap environment (admittedly contributing to it)
-  2) xbuf contents can be copied from one buffer to another without the need for 
-     2x heap during the copy.
-  The segment size defaults to 64 but can be dynamically set in the constructor at creation.   
-  The inclusion of indexOf and read/peek until functions make it useful for handling
-  data streams like HTTP, and in fact is why it was created.
-
-  NOTE: The size of the indexOf() search string is limited to the segment size.
-        It could be extended but didn't seem to be a practical consideration.    
-   
-********************************************************************************************/
-#pragma once
-
-#ifndef XBUF_H
-#define XBUF_H
-
-#include <Arduino.h>
-
-struct xseg 
-{
-  xseg    *next;
-  uint8_t data[];
-};
-
-class xbuf: public Print 
-{
-  public:
-
-    xbuf(const uint16_t segSize = 64);
-    virtual ~xbuf();
-
-    size_t      write(const uint8_t);
-    size_t      write(const char*);
-    size_t      write(const uint8_t*, const size_t);
-    size_t      write(xbuf*, const size_t);
-    size_t      write(String);
-    size_t      available();
-    int         indexOf(const char, const size_t begin = 0);
-    int         indexOf(const char*, const size_t begin = 0);
-    uint8_t     read();
-    size_t      read(uint8_t*, size_t);
-    String      readStringUntil(const char);
-    String      readStringUntil(const char*);
-    String      readString(int);
-    
-    String      readString() 
-    {
-      return readString(available());
-    }
-    
-    void        flush();
-
-    uint8_t     peek();
-    size_t      peek(uint8_t*, const size_t);
-    
-    String      peekStringUntil(const char target) 
-    {
-      return peekString(indexOf(target, 0));
-    }
-    
-    String      peekStringUntil(const char* target) 
-    {
-      return peekString(indexOf(target, 0));
-    }
-    
-    String      peekString() 
-    {
-      return peekString(_used);
-    }
-    
-    String      peekString(int);
-
-    /*      In addition to the above functions,
-    the following inherited functions from the Print class are available.
-    
-    size_t printf(const char * format, ...)  __attribute__ ((format (printf, 2, 3)));
-    size_t printf_P(PGM_P format, ...) __attribute__((format(printf, 2, 3)));
-    size_t print(const __FlashStringHelper *);
-    size_t print(const String &);
-    size_t print(const char[]);
-    size_t print(char);
-    size_t print(unsigned char, int = DEC);
-    size_t print(int, int = DEC);
-    size_t print(unsigned int, int = DEC);
-    size_t print(long, int = DEC);
-    size_t print(unsigned long, int = DEC);
-    size_t print(double, int = 2);
-    size_t print(const Printable&);
-    
-    size_t println(const __FlashStringHelper *);
-    size_t println(const String &s);
-    size_t println(const char[]);
-    size_t println(char);
-    size_t println(unsigned char, int = DEC);
-    size_t println(int, int = DEC);
-    size_t println(unsigned int, int = DEC);
-    size_t println(long, int = DEC);
-    size_t println(unsigned long, int = DEC);
-    size_t println(double, int = 2);
-    size_t println(const Printable&);
-    size_t println(void);
-    */
-
-  protected:
-
-    xseg        *_head;
-    xseg        *_tail;
-    uint16_t     _used;
-    uint16_t     _free;
-    uint16_t     _offset;
-    uint16_t     _segSize;
-
-    void        addSeg();
-    void        remSeg();
-
-};
-
-#include "utility/xbuf_Impl.h"
-
-#endif    // XBUF_H
-

src_h/utility/xbuf_Impl.h

@@ -1,429 +0,0 @@
-/****************************************************************************************************************************
-  xbuf_Impl.h - Dead simple AsyncHTTPRequest for ESP8266, ESP32 and currently STM32 with built-in LAN8742A Ethernet
-  
-  For ESP8266, ESP32 and STM32 with built-in LAN8742A Ethernet (Nucleo-144, DISCOVERY, etc)
-  
-  AsyncHTTPRequest_STM32 is a library for the ESP8266, ESP32 and currently STM32 run built-in Ethernet WebServer
-  
-  Based on and modified from asyncHTTPrequest Library (https://github.com/boblemaire/asyncHTTPrequest)
-  
-  Built by Khoi Hoang https://github.com/khoih-prog/AsyncHTTPRequest_Generic
-  Licensed under MIT license
-  
-  Copyright (C) <2018>  <Bob Lemaire, IoTaWatt, Inc.>
-  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
-  as published bythe Free Software Foundation, either version 3 of the License, or (at your option) any later version.
-  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
-  You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  
- 
-  Version: 1.4.1
-  
-  Version Modified By   Date      Comments
-  ------- -----------  ---------- -----------
-  1.0.0    K Hoang     14/09/2020 Initial coding to add support to STM32 using built-in Ethernet (Nucleo-144, DISCOVERY, etc).
-  1.0.1    K Hoang     09/10/2020 Restore cpp code besides Impl.h code.
-  1.0.2    K Hoang     09/11/2020 Make Mutex Lock and delete more reliable and error-proof
-  1.1.0    K Hoang     23/12/2020 Add HTTP PUT, PATCH, DELETE and HEAD methods
-  1.1.1    K Hoang     24/12/2020 Prevent crash if request and/or method not correct.
-  1.1.2    K Hoang     11/02/2021 Rename _lock and _unlock to avoid conflict with AsyncWebServer library
-  1.1.3    K Hoang     25/02/2021 Fix non-persistent Connection header bug
-  1.1.4    K Hoang     21/03/2021 Fix `library.properties` dependency
-  1.1.5    K Hoang     22/03/2021 Fix dependency on STM32AsyncTCP Library
-  1.2.0    K Hoang     11/04/2021 Add support to LAN8720 using STM32F4 or STM32F7
-  1.3.0    K Hoang     09/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720) boards
-  1.3.1    K Hoang     09/10/2021 Update `platform.ini` and `library.json`
-  1.4.0    K Hoang     23/11/2021 Fix crashing bug when request a non-existing IP
-  1.4.1    K Hoang     29/11/2021 Auto detect ESP32 core version and improve connection time for WT32_ETH01
- *****************************************************************************************************************************/
-
-#pragma once
-
-#ifndef XBUF_IMPL_H
-#define XBUF_IMPL_H
-
-xbuf::xbuf(const uint16_t segSize) : _head(nullptr), _tail(nullptr), _used(0), _free(0), _offset(0) 
-{
-  _segSize = (segSize + 3) & -4;//((segSize + 3) >> 2) << 2;
-}
-
-//*******************************************************************************************************************
-xbuf::~xbuf() 
-{
-  flush();
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(const uint8_t byte) 
-{
-  return write((uint8_t*) &byte, 1);
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(const char* buf) 
-{
-  return write((uint8_t*)buf, strlen(buf));
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(String string) 
-{
-  return write((uint8_t*)string.c_str(), string.length());
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(const uint8_t* buf, const size_t len) 
-{
-  size_t supply = len;
-  
-  while (supply) 
-  {
-    if (!_free) 
-    {
-      addSeg();
-    }
-    
-    size_t demand = _free < supply ? _free : supply;
-    memcpy(_tail->data + ((_offset + _used) % _segSize), buf + (len - supply), demand);
-    _free -= demand;
-    _used += demand;
-    supply -= demand;
-  }
-  
-  return len;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::write(xbuf* buf, const size_t len) 
-{
-  size_t supply = len;
-  
-  if (supply > buf->available()) 
-  {
-    supply = buf->available();
-  }
-  
-  size_t read = 0;
-  
-  while (supply) 
-  {
-    if (!_free) 
-    {
-      addSeg();
-    }
-    
-    size_t demand = _free < supply ? _free : supply;
-    read += buf->read(_tail->data + ((_offset + _used) % _segSize), demand);
-    _free -= demand;
-    _used += demand;
-    supply -= demand;
-  }
-  
-  return read;
-}
-
-//*******************************************************************************************************************
-uint8_t xbuf::read() 
-{
-  uint8_t byte = 0;
-  read((uint8_t*) &byte, 1);
-  
-  return byte;
-}
-
-//*******************************************************************************************************************
-uint8_t xbuf::peek() 
-{
-  uint8_t byte = 0;
-  peek((uint8_t*) &byte, 1);
-  
-  return byte;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::read(uint8_t* buf, const size_t len) 
-{
-  size_t read = 0;
-  
-  while (read < len && _used) 
-  {
-    size_t supply = (_offset + _used) > _segSize ? _segSize - _offset : _used;
-    size_t demand = len - read;
-    size_t chunk = supply < demand ? supply : demand;
-    memcpy(buf + read, _head->data + _offset, chunk);
-    _offset += chunk;
-    _used -= chunk;
-    read += chunk;
-    
-    if (_offset == _segSize) 
-    {
-      remSeg();
-      _offset = 0;
-    }
-  }
-  
-  if ( ! _used) 
-  {
-    flush();
-  }
-  
-  return read;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::peek(uint8_t* buf, const size_t len) 
-{
-  size_t read   = 0;
-  xseg* seg     = _head;
-  size_t offset = _offset;
-  size_t used   = _used;
-  
-  while (read < len && used) 
-  {
-    size_t supply = (offset + used) > _segSize ? _segSize - offset : used;
-    size_t demand = len - read;
-    size_t chunk  = supply < demand ? supply : demand;
-    
-    memcpy(buf + read, seg->data + offset, chunk);
-    
-    offset  += chunk;
-    used    -= chunk;
-    read    += chunk;
-    
-    if (offset == _segSize) 
-    {
-      seg = seg->next;
-      offset = 0;
-    }
-  }
-  
-  return read;
-}
-
-//*******************************************************************************************************************
-size_t xbuf::available() 
-{
-  return _used;
-}
-
-//*******************************************************************************************************************
-int xbuf::indexOf(const char target, const size_t begin) 
-{
-  char targetstr[2] = " ";
-  targetstr[0] = target;
-  
-  return indexOf(targetstr, begin);
-}
-
-//*******************************************************************************************************************
-int xbuf::indexOf(const char* target, const size_t begin) 
-{
-  size_t targetLen = strlen(target);
-  
-  if (targetLen > _segSize || targetLen > _used) 
-    return -1;
-    
-  size_t searchPos = _offset + begin;
-  size_t searchEnd = _offset + _used - targetLen;
-  
-  if (searchPos > searchEnd) 
-    return -1;
-    
-  size_t searchSeg = searchPos / _segSize;
-  xseg* seg = _head;
-  
-  while (searchSeg) 
-  {
-    seg = seg->next;
-    searchSeg --;
-  }
-  
-  size_t segPos = searchPos % _segSize;
-  
-  while (searchPos <= searchEnd) 
-  {
-    size_t compLen = targetLen;
-    
-    if (compLen <= (_segSize - segPos)) 
-    {
-      if (memcmp(target, seg->data + segPos, compLen) == 0) 
-      {
-        return searchPos - _offset;
-      }
-    }
-    else 
-    {
-      size_t compLen = _segSize - segPos;
-      
-      if (memcmp(target, seg->data + segPos, compLen) == 0) 
-      {
-        compLen = targetLen - compLen;
-        
-        if (memcmp(target + targetLen - compLen, seg->next->data, compLen) == 0) 
-        {
-          return searchPos - _offset;
-        }
-      }
-    }
-    
-    searchPos++;
-    segPos++;
-    
-    if (segPos == _segSize) 
-    {
-      seg = seg->next;
-      segPos = 0;
-    }
-  }
-  
-  return -1;
-}
-
-//*******************************************************************************************************************
-String xbuf::readStringUntil(const char target) 
-{
-  return readString(indexOf(target) + 1);
-}
-
-//*******************************************************************************************************************
-String xbuf::readStringUntil(const char* target) 
-{
-  int index = indexOf(target);
-  
-  if (index < 0) 
-    return String();
-    
-  return readString(index + strlen(target));
-}
-
-//*******************************************************************************************************************
-String xbuf::readString(int endPos) 
-{
-  String result;
-  
-  if ( ! result.reserve(endPos + 1)) 
-  {
-    // KH, to remove
-    AHTTP_LOGDEBUG1("xbuf::readString: can't reserve size = ", endPos + 1);
-    ///////
-      
-    return result;
-  }
-  
-  // KH, to remove
-    AHTTP_LOGDEBUG1("xbuf::readString: Reserved size = ", endPos + 1);
-    ///////
-  
-  if (endPos > _used) 
-  {
-    endPos = _used;
-  }
-  
-  if (endPos > 0 && result.reserve(endPos + 1)) 
-  {
-    while (endPos--) 
-    {
-      result += (char)_head->data[_offset++];
-      _used--;
-      
-      if (_offset >= _segSize) 
-      {
-        remSeg();
-      }
-    }
-  }
-  
-  return result;
-}
-
-//*******************************************************************************************************************
-String xbuf::peekString(int endPos) 
-{
-  String result;
-  
-  xseg* seg     = _head;
-  size_t offset = _offset;
-  
-  if (endPos > _used) 
-  {
-    endPos = _used;
-  }
-  
-  if (endPos > 0 && result.reserve(endPos + 1)) 
-  {
-    while (endPos--) 
-    {
-      result += (char)seg->data[offset++];
-      
-      if ( offset >= _segSize) 
-      {
-        seg = seg->next;
-        offset = 0;
-      }
-    }
-  }
-  
-  return result;
-}
-
-//*******************************************************************************************************************
-void xbuf::flush() 
-{
-  while (_head) 
-    remSeg();
-  
-  _tail = nullptr;
-  _offset = 0;
-  _used = 0;
-  _free = 0;
-}
-
-//*******************************************************************************************************************
-void xbuf::addSeg() 
-{
-  if (_tail) 
-  {
-    _tail->next = (xseg*) new uint32_t[_segSize / 4 + 1];
-    
-    if (_tail->next == NULL)
-      AHTTP_LOGERROR("xbuf::addSeg: error new 1");
-    
-    // KH, Must check NULL here
-    _tail = _tail->next;
-  }
-  else 
-  {
-    // KH, Must check NULL here
-    _tail = _head = (xseg*) new uint32_t[_segSize / 4 + 1];
-    
-    if (_tail == NULL)
-      AHTTP_LOGERROR("xbuf::addSeg: error new 2");
-  }
-  
-  // KH, Must check NULL here
-  if (_tail)
-    _tail->next = nullptr;
-    
-  _free += _segSize;
-}
-
-//*******************************************************************************************************************
-void xbuf::remSeg() 
-{
-  if (_head) 
-  {
-    xseg *next = _head->next;
-    delete[] (uint32_t*) _head;
-    _head = next;
-    
-    if ( ! _head) 
-    {
-      _tail = nullptr;
-    }
-  }
-  
-  _offset = 0;
-}
-
-#endif    // XBUF_IMPL_H
-