Ethernet_Manager_Portenta_H7 Library

Important Notes for Portenta_H7
Why do we need this Ethernet_Manager_Portenta_H7 library
- Features
- Currently supported Boards
- Currently supported Ethernet shields/modules
Changelog
Prerequisites
Installation
- Use Arduino Library Manager
- Manual Install
- VS Code & PlatformIO
Packages' Patches
- 1. For Portenta_H7 boards using Arduino IDE in Linux
Libraries' Patches
- 1. For Adafruit_MQTT_Library
How to use default Credentials and have them pre-loaded onto Config Portal
How to use
- 1. Basic usage
- 2. Add custom parameters
- 3. Not using custom parameters
- 4. To open Config Portal
- 5. To use custom HTML Style
- 6. To use custom Head Elements
- 7. To use CORS Header
Important Notes for using Dynamic Parameters' ids
Examples
- 1. Ethernet_Portenta_H7
- 2. MQTT_Ethernet_Portenta_H7
So, how it works?
Example Ethernet_Portenta_H7
- 1. File Ethernet_Portenta_H7.ino
- 2. File defines.h
- 3. File Credentials.h
- 4. File dynamicParams.h
Debug Terminal Output Samples
- 1. Ethernet_Portenta_H7 on PORTENTA_H7_M7
  - 1.1 Initial start, LittleFS format and Config Portal
  - 1.2. Save and Exit Config Portal
- 2. MQTT_Ethernet_Portenta_H7 on PORTENTA_H7_M7
  - 2.1 Initial start, LittleFS format and Config Portal
  - 2.2. Save and Exit Config Portal
Debug
Troubleshooting
Issues
TO DO
DONE
Contributions and Thanks
Contributing
License
Copyright

Important Notes for Portenta_H7

The LittleFS of the new Portenta_H7 board currently tested OK with only maximum 8 files. The files, from 9 and up, somehow strangely can't be written and / or read. This is possibly a bug in the ArduinoCore-mbed mbed_portenta core. The same behaviour is observed from core v2.0.0 up to v3.4.1.

If LittleFS size is reduced to 1024KB, test is OK with only maximum 4 files.

Beware and keep checking for updates.

Why do we need this Ethernet_Manager_Portenta_H7 library

Features

This is the new library, adding to the current WiFiManager sets of libraries. It's designed to help you eliminate hardcoding your Credentials in Portenta_H7 boards using Ethernet from Portenta Vision shields. It's currently not supporting SSL. Will support soon.
You can update Credentials any time you need to change via Configure Portal. Data are saved in configurable locations in Portenta_H7 LittleFS.
DoubleDetectDetector feature to force Config Portal when double reset is detected within predetermined time, default 10s.
Configurable Config Portal Title to be either BoardName or default undistinguishable names.
Examples are redesigned to separate Credentials / Defines / Dynamic Params / Code so that you can change Credentials / Dynamic Params quickly for each device

The Portenta_H7 boards, are currently supported using ArduinoCore-mbed mbed_portenta core.

New recent features:

DoubleDetectDetector feature to force Config Portal when double reset is detected within predetermined time, default 10s.
Configurable Config Portal Title to be either BoardName or default undistinguishable names.
Examples are redesigned to separate Credentials / Defines / Dynamic Params / Code so that you can change Credentials / Dynamic Params quickly for each device

Currently Supported Boards

This Ethernet_Manager_Portenta_H7 library currently supports these following boards:

Portenta_H7 boards, using ArduinoCore-mbed mbed_portenta core

Currently supported Ethernet shields/modules

Portenta_H7 using Ethernet from Portenta Vision shields

Prerequisites

Arduino IDE 1.8.19+ for Arduino.
ArduinoCore-mbed mbed_portenta core 3.4.1+ for Arduino Portenta_H7 boards, such as Portenta_H7 Rev2 ABX00042, etc..
Functional-Vlpp library v1.0.2+ to use server's lambda function. To install. check
EthernetWebServer library v2.3.0+. To install. check
DoubleResetDetector_Generic v1.8.1+. To install, check
LittleFS_Portenta_H7 v1.2.0+. To install, check

Installation

The suggested way to install is to:

Use Arduino Library Manager

The best way is to use Arduino Library Manager. Search for Ethernet_Manager_Portenta_H7, then select / install the latest version. You can also use this link for more detailed instructions.

Manual Install

Navigate to Ethernet_Manager_Portenta_H7 page.
Download the latest release Ethernet_Manager_Portenta_H7-main.zip.
Extract the zip file to Ethernet_Manager_Portenta_H7-main directory
Copy the whole Ethernet_Manager_Portenta_H7-main folder to Arduino libraries' directory such as ~/Arduino/libraries/.

VS Code & PlatformIO

Install VS Code
Install PlatformIO
Install Ethernet_Manager_Portenta_H7 library by using Library Manager. Search for Ethernet_Manager_Portenta_H7 in Platform.io Author's Libraries
Use included platformio.ini file from examples to ensure that all dependent libraries will installed automatically. Please visit documentation for the other options and examples at Project Configuration File

Packages' Patches

1. For Portenta_H7 boards using Arduino IDE in Linux

To be able to upload firmware to Portenta_H7 using Arduino IDE in Linux (Ubuntu, etc.), you have to copy the file portenta_post_install.sh into mbed_portenta directory (~/.arduino15/packages/arduino/hardware/mbed_portenta/3.4.1/portenta_post_install.sh).

Then run the following command using sudo

$ cd ~/.arduino15/packages/arduino/hardware/mbed_portenta/3.4.1
$ chmod 755 portenta_post_install.sh
$ sudo ./portenta_post_install.sh

This will create the file /etc/udev/rules.d/49-portenta_h7.rules as follows:

# Portenta H7 bootloader mode UDEV rules

SUBSYSTEMS=="usb", ATTRS{idVendor}=="2341", ATTRS{idProduct}=="035b", GROUP="plugdev", MODE="0666"

Supposing the ArduinoCore-mbed core version is 3.4.1. Now only one file must be copied into the directory:

~/.arduino15/packages/arduino/hardware/mbed_portenta/3.4.1/portenta_post_install.sh

Whenever a new version is installed, remember to copy this files into the new version directory. For example, new version is x.yy.zz

This file must be copied into the directory:

~/.arduino15/packages/arduino/hardware/mbed_portenta/x.yy.zz/portenta_post_install.sh

Libraries' Patches

1. For Adafruit_MQTT_Library

To fix Adafruit_MQTT_Library library, just copy the following file into the Adafruit_MQTT_Library library installed directory to overwrite the old files:

Adafruit_MQTT.cpp

How to use default Credentials and have them pre-loaded onto Config Portal

See this example and modify as necessary

To load Default Credentials

bool LOAD_DEFAULT_CONFIG_DATA = true;

To use system default to load "blank" when there is no valid Credentials

bool LOAD_DEFAULT_CONFIG_DATA = false;

Example of Default Credentials

/// Start Default Config Data //////////////////

/*
typedef struct Configuration
{
  char header         [16];
  char static_IP      [16];
  char board_name     [24];
  int  checkSum;
} Ethernet_Configuration;
*/

#define TO_LOAD_DEFAULT_CONFIG_DATA      true

#if TO_LOAD_DEFAULT_CONFIG_DATA

bool LOAD_DEFAULT_CONFIG_DATA = false;

Ethernet_Configuration defaultConfig =
{
  //char header[16], dummy, not used
#if USE_SSL
  "Eth_SSL",
#else
  "Eth_NonSSL",
#endif

  // char static_IP      [16];
  //"192.168.2.230",
  // Use dynamic DHCP IP
  "",
  //char board_name     [24];
  "Air-Control",
  // terminate the list
  //int  checkSum, dummy, not used
  0
  /////////// End Default Config Data /////////////
};

#else

bool LOAD_DEFAULT_CONFIG_DATA = false;

Ethernet_Configuration defaultConfig;

#endif    // TO_LOAD_DEFAULT_CONFIG_DATA

/////////// End Default Config Data /////////////

How to use

1. Basic usage

Include in your sketch

// Must be before #include <Ethernet_Manager_Portenta_H7.h>
#include <Ethernet_Manager_Portenta_H7.h>

Ethernet_Manager ethernet_manager;

2. Add custom parameters

To add custom parameters, just add

#ifndef dynamicParams_h
#define dynamicParams_h

#include "defines.h"

// USE_DYNAMIC_PARAMETERS defined in defines.h

/////////////// Start dynamic Credentials ///////////////

/**************************************
  #define MAX_ID_LEN                5
  #define MAX_DISPLAY_NAME_LEN      16

  typedef struct
  {
  char id             [MAX_ID_LEN + 1];
  char displayName    [MAX_DISPLAY_NAME_LEN + 1];
  char *pdata;
  uint8_t maxlen;
  } MenuItem;
**************************************/

#if USE_DYNAMIC_PARAMETERS

  #define MAX_MQTT_SERVER_LEN      34
  char MQTT_Server  [MAX_MQTT_SERVER_LEN + 1]   = "default-mqtt-server";
  
  #define MAX_MQTT_PORT_LEN        6
  char MQTT_Port   [MAX_MQTT_PORT_LEN + 1]  = "1883";
  
  #define MAX_MQTT_USERNAME_LEN      34
  char MQTT_UserName  [MAX_MQTT_USERNAME_LEN + 1]   = "default-mqtt-username";
  
  #define MAX_MQTT_PW_LEN        34
  char MQTT_PW   [MAX_MQTT_PW_LEN + 1]  = "default-mqtt-password";
  
  #define MAX_MQTT_SUBS_TOPIC_LEN      34
  char MQTT_SubsTopic  [MAX_MQTT_SUBS_TOPIC_LEN + 1]   = "default-mqtt-SubTopic";
  
  #define MAX_MQTT_PUB_TOPIC_LEN       34
  char MQTT_PubTopic   [MAX_MQTT_PUB_TOPIC_LEN + 1]  = "default-mqtt-PubTopic";
  
  MenuItem myMenuItems [] =
  {
    { "mqtt", "MQTT Server",      MQTT_Server,      MAX_MQTT_SERVER_LEN },
    { "mqpt", "Port",             MQTT_Port,        MAX_MQTT_PORT_LEN   },
    { "user", "MQTT UserName",    MQTT_UserName,    MAX_MQTT_USERNAME_LEN },
    { "mqpw", "MQTT PWD",         MQTT_PW,          MAX_MQTT_PW_LEN },
    { "subs", "Subs Topics",      MQTT_SubsTopic,   MAX_MQTT_SUBS_TOPIC_LEN },
    { "pubs", "Pubs Topics",      MQTT_PubTopic,    MAX_MQTT_PUB_TOPIC_LEN },
  };
  
  uint16_t NUM_MENU_ITEMS = sizeof(myMenuItems) / sizeof(MenuItem);  //MenuItemSize;

#else

  MenuItem myMenuItems [] = {};
  
  uint16_t NUM_MENU_ITEMS = 0;
#endif

/////// // End dynamic Credentials ///////////

#endif      //dynamicParams_h

3. Not using custom parameters

If you don't need to add dynamic parameters, use the following in sketch

#define USE_DYNAMIC_PARAMETERS      false

4. To open Config Portal

When you want to open a config portal, just add

ethernet_manager.begin();

5. To use custom HTML Style

const char NewCustomsStyle[] /*PROGMEM*/ = "<style>div,input{padding:5px;font-size:1em;}input{width:95%;}body{text-align: center;}\
button{background-color:blue;color:white;line-height:2.4rem;font-size:1.2rem;width:100%;}fieldset{border-radius:0.3rem;margin:0px;}</style>";

...

ethernet_manager.setCustomsStyle(NewCustomsStyle);

6. To use custom Head Elements

ethernet_manager.setCustomsHeadElement("<style>html{filter: invert(10%);}</style>");

7. To use CORS Header

ethernet_manager.setCORSHeader("Your Access-Control-Allow-Origin");

While in AP mode, connect to it using its SSID (ESP_XXXXXX) / Password ("MyESP_XXXXXX"), then open a browser to the Portal AP IP, default 192.168.4.1, configure wifi then click Save. The Credentials / WiFi connection information will be saved in non-volatile memory. It will then autoconnect.

Once Credentials / WiFi network information is saved in the host non-volatile memory, it will try to autoconnect to WiFi every time it is started, without requiring any function calls in the sketch.

Important Notes for using Dynamic Parameters' ids

These ids (such as "mqtt" in example) must be unique.

Please be noted that the following reserved names are already used in library:

"ip"    for Static IP Address
"nm"    for Board Name

Examples

So, how it works?

If no valid config data are stored in LittleFS, it will switch to Configuration Mode. Connect to access point at the IP address displayed on Terminal or Router's DHCP server :

After you connected to, for example, 192.168.2.132, the Browser will display the following picture:

Enter your credentials (Blynk Servers/Tokens and Port). If you prefer static IP, input it (for example 192.168.2.222) in the corresponding field. Otherwise, just leave it blank or nothing to use auto IP assigned by DHCP server.

Then click Save. After the board auto-restarted, you will see if it's connected to your Blynk server successfully as in the following picture:

This ethernet_manager.run() is not a blocking call, so you can use it for critical functions requiring in loop().

In operation, if Ethernet or connection is lost, ethernet_manager.run() will try reconnecting automatically. Therefore, ethernet_manager.run() must be called in the loop() function.

void loop()
{
  ethernet_manager.run();
  ...
}

Example Ethernet_Portenta_H7

1. File Ethernet_Portenta_H7.ino

Ethernet_Manager_Portenta_H7/examples/Ethernet_Portenta_H7/Ethernet_Portenta_H7.ino

Lines 12 to 166 in 37c94fe

    
           #include "defines.h" 
        
           #include "Credentials.h" 
        
           #include "dynamicParams.h" 
        
           Ethernet_Manager ethernet_manager; 
        
           IPAddress localEthernetIP; 
        
           void heartBeatPrint() 
        
           { 
        
             static int num        = 1; 
        
             static int linkStatus = 0; 
        
             localEthernetIP = Ethernet.localIP(); 
        
             // The linkStatus() is not working with W5100. Just using IP != 0.0.0.0 
        
             // Better to use ping for W5100 
        
             linkStatus = (int) Ethernet.linkStatus(); 
        
             ET_LOGINFO3("localEthernetIP = ", localEthernetIP, ", linkStatus = ", (linkStatus == LinkON) ? "LinkON" : "LinkOFF" ); 
        
             if ( ( (linkStatus == LinkON) ) && ((uint32_t) localEthernetIP != 0) ) 
        
             { 
        
               Serial.print(F("H")); 
        
             } 
        
             else 
        
               Serial.print(F("F")); 
        
             if (num == 80) 
        
             { 
        
               Serial.println(); 
        
               num = 1; 
        
             } 
        
             else if (num++ % 10 == 0) 
        
             { 
        
               Serial.print(F(" ")); 
        
             } 
        
           } 
        
           void check_status() 
        
           { 
        
           #define STATUS_CHECK_INTERVAL     10000L 
        
             static unsigned long checkstatus_timeout = STATUS_CHECK_INTERVAL; 
        
             static bool ledPowerOn = false; 
        
             // Send status report every STATUS_REPORT_INTERVAL (10) seconds: we don't need to send updates frequently if there is no status change. 
        
             if ((millis() > checkstatus_timeout)) 
        
             { 
        
               heartBeatPrint(); 
        
               digitalWrite(LEDB, ledPowerOn ? HIGH : LOW); 
        
               ledPowerOn = !ledPowerOn; 
        
               checkstatus_timeout = millis() + STATUS_CHECK_INTERVAL; 
        
             } 
        
           } 
        
           #if USING_CUSTOMS_STYLE 
        
             const char NewCustomsStyle[] /*PROGMEM*/ = 
        
             "<style>div,input{padding:5px;font-size:1em;}input{width:95%;}body{text-align: center;}\ 
        
             button{background-color:blue;color:white;line-height:2.4rem;font-size:1.2rem;width:100%;}fieldset{border-radius:0.3rem;margin:0px;}</style>"; 
        
           #endif 
        
           void setup() 
        
           { 
        
             pinMode(LEDB, OUTPUT); 
        
             digitalWrite(LEDB, LED_OFF); 
        
             // Debug console 
        
             Serial.begin(115200); 
        
             while (!Serial); 
        
             Serial.print("\nStart Ethernet_Portenta_H7 on "); 
        
             Serial.println(BOARD_NAME); 
        
             Serial.print("Ethernet Shield type : "); 
        
             Serial.println(SHIELD_TYPE); 
        
             Serial.println(ETHERNET_MANAGER_PORTENTA_H7_VERSION); 
        
             Serial.println(DOUBLERESETDETECTOR_GENERIC_VERSION); 
        
             ////////////////////////////////////////////// 
        
           #if USING_CUSTOMS_STYLE 
        
             ethernet_manager.setCustomsStyle(NewCustomsStyle); 
        
           #endif 
        
           #if USING_CUSTOMS_HEAD_ELEMENT 
        
             ethernet_manager.setCustomsHeadElement("<style>html{filter: invert(10%);}</style>"); 
        
           #endif 
        
           #if USING_CORS_FEATURE 
        
             ethernet_manager.setCORSHeader("Your Access-Control-Allow-Origin"); 
        
           #endif 
        
             ethernet_manager.begin(); 
        
             ////////////////////////////////////////////// 
        
             localEthernetIP = Ethernet.localIP(); 
        
             if ( (uint32_t) localEthernetIP != 0 ) 
        
             { 
        
               Serial.print(F("Connected! IP address: ")); 
        
               Serial.println(localEthernetIP); 
        
             } 
        
             else 
        
             { 
        
               Serial.println(F("Ethernet not Connected! Please check.")); 
        
             } 
        
           } 
        
           #if (USE_DYNAMIC_PARAMETERS) 
        
           void displayCredentials() 
        
           { 
        
             Serial.println("\nYour stored Credentials :"); 
        
             for (int i = 0; i < NUM_MENU_ITEMS; i++) 
        
             { 
        
               Serial.println(String(myMenuItems[i].displayName) + " = " + myMenuItems[i].pdata); 
        
             } 
        
           } 
        
           void displayCredentialsOnce() 
        
           { 
        
             static bool displayedCredentials = false; 
        
             if (!displayedCredentials) 
        
             { 
        
               for (int i = 0; i < NUM_MENU_ITEMS; i++) 
        
               { 
        
                 if (!strlen(myMenuItems[i].pdata)) 
        
                 { 
        
                   break; 
        
                 } 
        
                 if ( i == (NUM_MENU_ITEMS - 1) ) 
        
                 { 
        
                   displayedCredentials = true; 
        
                   displayCredentials(); 
        
                 } 
        
               } 
        
             } 
        
           } 
        
           #endif 
        
           void loop() 
        
           { 
        
             ethernet_manager.run(); 
        
             check_status(); 
        
           #if (USE_DYNAMIC_PARAMETERS) 
        
             displayCredentialsOnce(); 
        
           #endif 
        
           }

2. File defines.h

Ethernet_Manager_Portenta_H7/examples/Ethernet_Portenta_H7/defines.h

Lines 12 to 102 in 37c94fe

    
           #ifndef defines_h 
        
           #define defines_h 
        
           #if ( ( defined(ARDUINO_PORTENTA_H7_M7) || defined(ARDUINO_PORTENTA_H7_M4) ) && defined(ARDUINO_ARCH_MBED) ) 
        
             #warning Use MBED ARDUINO_PORTENTA_H7 and LittleFS 
        
             #if defined(BOARD_NAME) 
        
               #undef BOARD_NAME 
        
             #endif 
        
             #if defined(CORE_CM7) 
        
               #warning Using Portenta H7 M7 core 
        
               #define BOARD_NAME              "PORTENTA_H7_M7" 
        
             #else 
        
               #warning Using Portenta H7 M4 core 
        
               #define BOARD_NAME              "PORTENTA_H7_M4" 
        
             #endif 
        
             #define USE_ETHERNET_PORTENTA_H7    true 
        
             #include <Portenta_Ethernet.h> 
        
             #include <Ethernet.h> 
        
             #warning Using Portenta_Ethernet lib for Portenta_H7. 
        
             #define SHIELD_TYPE           "Ethernet using Portenta_Ethernet Library" 
        
           #else 
        
             #error This code is intended to run on the MBED ARDUINO_PORTENTA_H7 platform! Please check your Tools->Board setting. 
        
           #endif 
        
           ///////////////////////////////////////////// 
        
           /* Comment this out to disable prints and save space */ 
        
           #define DEBUG_ETHERNET_WEBSERVER_PORT       Serial 
        
           // Debug Level from 0 to 4 
        
           #define _ETHERNET_WEBSERVER_LOGLEVEL_       2 
        
           #define _ETHERNET_MANAGER_LOGLEVEL_         2 
        
           #define DRD_GENERIC_DEBUG                   true 
        
           ///////////////////////////////////////////// 
        
           // You have to select true for the first time for any board 
        
           #define FORCE_REFORMAT            false 
        
           ///////////////////////////////////////////// 
        
           #if 0 
        
             //#define SS_PIN_DEFAULT        USE_THIS_SS_PIN 
        
             //#include <SPI.h> 
        
             //#define USE_ETHERNET_WRAPPER    true 
        
             #define USE_ETHERNET_WRAPPER    false 
        
             // Use true  for ENC28J60 and UIPEthernet library (https://github.com/UIPEthernet/UIPEthernet) 
        
             // Use false for W5x00 and Ethernetx library      (https://www.arduino.cc/en/Reference/Ethernet) 
        
             // Only one if the following to be true 
        
             #define USE_UIP_ETHERNET      false 
        
             #define USE_ETHERNET          false 
        
             #define USE_ETHERNET2         false 
        
             #define USE_ETHERNET3         false 
        
             #define USE_ETHERNET_LARGE    false 
        
             #define USE_ETHERNET_ESP8266  false 
        
             #define USE_ETHERNET_ENC      false 
        
             #define USE_CUSTOM_ETHERNET   false 
        
           #endif 
        
           ///////////////////////////////////////////// 
        
           // Add customs headers from v1.2.0 
        
           #define USING_CUSTOMS_STYLE                 true 
        
           #define USING_CUSTOMS_HEAD_ELEMENT          true 
        
           #define USING_CORS_FEATURE                  true 
        
           ///////////////////////////////////////////// 
        
           // Config Timeout 120s (default 60s) 
        
           #define CONFIG_TIMEOUT                      120000L 
        
           #define USE_DYNAMIC_PARAMETERS              true 
        
           ////////////////////////////////////////// 
        
           #include <Ethernet_Manager_Portenta_H7.h> 
        
           #define ETHERNET_HOST_NAME   "Portenta-Ethernet" 
        
           #endif      //defines_h

3. File Credentials.h

Ethernet_Manager_Portenta_H7/examples/Ethernet_Portenta_H7/Credentials.h

Lines 12 to 66 in 37c94fe

    
           #ifndef Credentials_h 
        
           #define Credentials_h 
        
           #include "defines.h" 
        
           /// Start Default Config Data ////////////////// 
        
           /* 
        
             typedef struct Configuration 
        
             { 
        
             char header         [24]; 
        
             char static_IP      [16]; 
        
             char board_name     [24]; 
        
             int  checkSum; 
        
             } Ethernet_Configuration; 
        
           */ 
        
           #define TO_LOAD_DEFAULT_CONFIG_DATA      false 
        
           #if TO_LOAD_DEFAULT_CONFIG_DATA 
        
           bool LOAD_DEFAULT_CONFIG_DATA = false; 
        
           Ethernet_Configuration defaultConfig = 
        
           { 
        
             //char header[24], dummy, not used 
        
           #if USE_SSL 
        
             "Eth_SSL", 
        
           #else 
        
             "Eth_NonSSL", 
        
           #endif 
        
             // char static_IP      [16]; 
        
             //"192.168.2.230", 
        
             // Use dynamic DHCP IP 
        
             "", 
        
             //char board_name     [24]; 
        
             "Portenta-Ethernet", 
        
             // terminate the list 
        
             //int  checkSum, dummy, not used 
        
             0 
        
             /////////// End Default Config Data ///////////// 
        
           }; 
        
           #else 
        
           bool LOAD_DEFAULT_CONFIG_DATA = false; 
        
           Ethernet_Configuration defaultConfig; 
        
           #endif    // TO_LOAD_DEFAULT_CONFIG_DATA 
        
           /////////// End Default Config Data ///////////// 
        
           #endif    //Credentials_h

4. File dynamicParams.h

Ethernet_Manager_Portenta_H7/examples/Ethernet_Portenta_H7/dynamicParams.h

Lines 12 to 75 in 37c94fe

    
           #ifndef dynamicParams_h 
        
           #define dynamicParams_h 
        
           #include "defines.h" 
        
           // USE_DYNAMIC_PARAMETERS defined in defines.h 
        
           /////////////// Start dynamic Credentials /////////////// 
        
           /************************************** 
        
             #define MAX_ID_LEN                5 
        
             #define MAX_DISPLAY_NAME_LEN      16 
        
             typedef struct 
        
             { 
        
             char id             [MAX_ID_LEN + 1]; 
        
             char displayName    [MAX_DISPLAY_NAME_LEN + 1]; 
        
             char *pdata; 
        
             uint8_t maxlen; 
        
             } MenuItem; 
        
           **************************************/ 
        
           #if USE_DYNAMIC_PARAMETERS 
        
           #define MAX_MQTT_SERVER_LEN      34 
        
           char MQTT_Server  [MAX_MQTT_SERVER_LEN + 1]   = "default-mqtt-server"; 
        
           #define MAX_MQTT_PORT_LEN        6 
        
           char MQTT_Port   [MAX_MQTT_PORT_LEN + 1]  = "1883"; 
        
           #define MAX_MQTT_USERNAME_LEN      34 
        
           char MQTT_UserName  [MAX_MQTT_USERNAME_LEN + 1]   = "default-mqtt-username"; 
        
           #define MAX_MQTT_PW_LEN        34 
        
           char MQTT_PW   [MAX_MQTT_PW_LEN + 1]  = "default-mqtt-password"; 
        
           #define MAX_MQTT_SUBS_TOPIC_LEN      34 
        
           char MQTT_SubsTopic  [MAX_MQTT_SUBS_TOPIC_LEN + 1]   = "default-mqtt-SubTopic"; 
        
           #define MAX_MQTT_PUB_TOPIC_LEN       34 
        
           char MQTT_PubTopic   [MAX_MQTT_PUB_TOPIC_LEN + 1]  = "default-mqtt-PubTopic"; 
        
           MenuItem myMenuItems [] = 
        
           { 
        
             { "mqtt", "MQTT Server",      MQTT_Server,      MAX_MQTT_SERVER_LEN }, 
        
             { "mqpt", "Port",             MQTT_Port,        MAX_MQTT_PORT_LEN   }, 
        
             { "user", "MQTT UserName",    MQTT_UserName,    MAX_MQTT_USERNAME_LEN }, 
        
             { "mqpw", "MQTT PWD",         MQTT_PW,          MAX_MQTT_PW_LEN }, 
        
             { "subs", "Subs Topics",      MQTT_SubsTopic,   MAX_MQTT_SUBS_TOPIC_LEN }, 
        
             { "pubs", "Pubs Topics",      MQTT_PubTopic,    MAX_MQTT_PUB_TOPIC_LEN }, 
        
           }; 
        
           uint16_t NUM_MENU_ITEMS = sizeof(myMenuItems) / sizeof(MenuItem);  //MenuItemSize; 
        
           #else 
        
           MenuItem myMenuItems [] = {}; 
        
           uint16_t NUM_MENU_ITEMS = 0; 
        
           #endif 
        
           /////// // End dynamic Credentials /////////// 
        
           #endif      //dynamicParams_h

Debug Terminal Output Samples

1. Ethernet_Portenta_H7 on PORTENTA_H7_M7

This is the terminal output of PORTENTA_H7_M7 with Ethernet from Portenta Vision shield, running Ethernet_Portenta_H7 example.

1.1 Initial start, LittleFS format and Config Portal

Start Ethernet_Portenta_H7 on PORTENTA_H7_M7
Ethernet Shield type : Ethernet using Portenta_Ethernet Library
EthernetManager_Portenta_H7 v1.6.1
DoubleResetDetector_Generic v1.7.3
Flash Size: (KB) = 2048.00
FlashIAP Start Address: = 0x8080000
LittleFS size (KB) = 1536.00
LittleFS Mount OK
LittleFS Flag read = 0xd0d01234
Flag read = 0xd0d01234
doubleResetDetected
Saving to DRD file : 0xd0d04321
Saving DRD file OK
LittleFS Flag read = 0xd0d04321
ClearFlag write = 0xd0d04321
[ETM] =====================
[ETM] DRD. Run ConfigPortal
[ETM] =====================
[ETM] Start connectEthernet using DHCP
[ETM] MAC:FE-9F-FE-D9-D4-BA
[ETM] IP: 192.168.2.132
[ETM] bg: isForcedConfigPortal = false
[ETM] bg:Stay forever in CP: DRD/MRD
[ETM] clearForcedCP
[ETM] SaveCPFile 
[ETM] OK
[ETM] CfgIP= 192.168.2.132
Connected! IP address: 192.168.2.132

Your stored Credentials :
MQTT Server = default-mqtt-server
Port = 1883
MQTT UserName = default-mqtt-username
MQTT PWD = default-mqtt-password
Subs Topics = default-mqtt-SubTopic
Pubs Topics = default-mqtt-PubTopic
HHHHHHHHHHETM] 
h:Updating LittleFS: /littlefs/config.etm
[ETM] WCSum=0x c1f
[ETM] CrWCSum=0x 219f
[ETM] h:Rst

1.2 Save and Exit Config Portal

Start Ethernet_Portenta_H7 on PORTENTA_H7_M7
Ethernet Shield type : Ethernet using Portenta_Ethernet Library
EthernetManager_Portenta_H7 v1.6.1
DoubleResetDetector_Generic v1.7.3
Flash Size: (KB) = 2048.00
FlashIAP Start Address: = 0x8080000
LittleFS size (KB) = 1536.00
LittleFS Mount OK
LittleFS Flag read = 0xd0d04321
Flag read = 0xd0d04321
No doubleResetDetected
Saving DOUBLERESETDETECTOR_FLAG to DRD file : 0xd0d01234
Saving DRD file OK
SetFlag write = 0xd0d01234
[ETM] CCSum=0x c1f ,RCSum=0x c1f
[ETM] CrCCsum=0x 219f ,CrRCsum=0x 219f
[ETM] CrCCsum=0x 219f ,CrRCsum=0x 219f
[ETM] Valid Stored Dynamic Data
[ETM] ======= Start Stored Config Data =======
[ETM] Header= PORTENTA-H7-ETH , BoardName= Portenta_H7_ETH
[ETM] StaticIP= 192.168.2.222
[ETM] Start connectEthernet using Static IP = 192.168.2.222
[ETM] MAC:FE-9D-FD-DA-DC-83
[ETM] IP: 192.168.2.222
[ETM] begin:Ethernet Connected.
Connected! IP address: 192.168.2.222
Stop doubleResetDetecting
Saving to DRD file : 0xd0d04321
Saving DRD file OK
LittleFS Flag read = 0xd0d04321
ClearFlag write = 0xd0d04321
H
Your stored Credentials :
MQTT Server = new-mqtt-server
Port = 1883
MQTT UserName = new-mqtt-username
MQTT PWD = new-mqtt-password
Subs Topics = new-mqtt-SubTopic
Pubs Topics = new-mqtt-PubTopic

2. MQTT_Ethernet_Portenta_H7 on PORTENTA_H7_M7

This is the terminal output of PORTENTA_H7_M7 with Ethernet from Portenta Vision shield, running MQTT_Ethernet_Portenta_H7 example.

2.1 Initial start, LittleFS format and Config Portal

Start MQTT_Ethernet_Portenta_H7 on PORTENTA_H7_M7
Ethernet Shield type : Ethernet using Portenta_Ethernet Library
EthernetManager_Portenta_H7 v1.6.1
DoubleResetDetector_Generic v1.7.3
Flash Size: (KB) = 2048.00
FlashIAP Start Address: = 0x8080000
LittleFS size (KB) = 1536.00
LittleFS Mount OK
LittleFS Flag read = 0xd0d01234
Flag read = 0xd0d01234
doubleResetDetected
Saving to DRD file : 0xd0d04321
Saving DRD file OK
LittleFS Flag read = 0xd0d04321
ClearFlag write = 0xd0d04321
[ETM] =====================
[ETM] DRD. Run ConfigPortal
[ETM] =====================
[ETM] CCSum=0x 8e7 ,RCSum=0x 8e7
[ETM] CrCCsum=0x 19fa ,CrRCsum=0x 19fa
[ETM] CrCCsum=0x 19fa ,CrRCsum=0x 19fa
[ETM] Valid Stored Dynamic Data
[ETM] ======= Start Stored Config Data =======
[ETM] Header= PORTENTA-H7-ETH , BoardName= Portenta-MQTT
[ETM] StaticIP= 
[ETM] Start connectEthernet using DHCP
[ETM] MAC:FE-98-FB-D7-D5-BA
[ETM] IP: 192.168.2.132
[ETM] bg: isForcedConfigPortal = false
[ETM] bg:Stay forever in CP: DRD/MRD
[ETM] clearForcedCP
[ETM] SaveCPFile 
[ETM] OK
[ETM] CfgIP= 192.168.2.132
Connected! IP address: 192.168.2.132
H
Your stored Credentials :
AIO_SERVER = io.adafruit.com
AIO_SERVERPORT = 1883
AIO_USERNAME = private
AIO_KEY = private
AIO_PUB_TOPIC = /feeds/Temperature
AIO_SUB_TOPIC = /feeds/LED_Control
HHHHHHHHH HHHHHHHHHH HH

2.2 Save and Exit Config Portal

Start MQTT_Ethernet_Portenta_H7 on PORTENTA_H7_M7
Ethernet Shield type : Ethernet using Portenta_Ethernet Library
EthernetManager_Portenta_H7 v1.6.1
DoubleResetDetector_Generic v1.7.3
Flash Size: (KB) = 2048.00
FlashIAP Start Address: = 0x8080000
LittleFS size (KB) = 1536.00
[ETM] CCSum=0x adb ,RCSum=0x adb
[ETM] CrCCsum=0x 2236 ,CrRCsum=0x 2236
[ETM] CrCCsum=0x 2236 ,CrRCsum=0x 2236
[ETM] Valid Stored Dynamic Data
[ETM] ======= Start Stored Config Data =======
[ETM] Header= PORTENTA-H7-ETH , BoardName= PORTENTA-H7-ETH
[ETM] StaticIP= 192.168.2.222
[ETM] Start connectEthernet using Static IP = 192.168.2.222
[ETM] MAC:FE-9E-FF-D6-DA-BA
[ETM] IP: 192.168.2.222
[ETM] begin:Ethernet Connected.
Connected! IP address: 192.168.2.222
H
Your stored Credentials :
AIO_SERVER = io.adafruit.com
AIO_SERVERPORT = 1883
AIO_USERNAME = user_name
AIO_KEY = aio_key
AIO_PUB_TOPIC = /feeds/Temperature
AIO_SUB_TOPIC = /feeds/LED_Control

Creating new Ethernet client object OK
Creating new MQTT object OK
AIO_SERVER = io.adafruit.com, AIO_SERVERPORT = 1883
AIO_USERNAME = user_name, AIO_KEY = aio_key
Creating new MQTT_Pub_Topic,  Temperature = user_name/feeds/Temperature
Creating new Temperature object OK
Temperature MQTT_Pub_Topic = user_name/feeds/Temperature
Creating new AIO_SUB_TOPIC, LED_Control = user_name/feeds/LED_Control
Creating new LED_Control object OK
LED_Control AIO_SUB_TOPIC = user_name/feeds/LED_Control
THTHTHT

Debug

Debug is enabled by default on Serial.

You can also change the debugging level from 0 to 4

/* Comment this out to disable prints and save space */
#define DEBUG_ETHERNET_WEBSERVER_PORT       Serial

// Debug Level from 0 to 4
#define _ETHERNET_WEBSERVER_LOGLEVEL_       0
#define _Ethernet_Manager_Portenta_H7_LOGLEVEL_         2

Troubleshooting

If you get compilation errors, more often than not, you may need to install a newer version of the core for Arduino boards.

Sometimes, the library will only work if you update the board core to the latest version because I am using newly added functions.

Issues

Submit issues to: Ethernet_Manager_Portenta_H7 issues

TO DO

Same features for other boards with new Ethernet shields.
Add SSL/TLS feature.
Bug Searching and Killing
Support more non-compatible Ethernet Libraries such as Ethernet_Shield_W5200, EtherCard, EtherSia.

DONE

Add support to Portenta_H7 using Ethernet from Portenta Vision shields
More flexible to configure reconnection timeout.
For fresh config data, don't need to wait for connecting timeout before entering config portal.
If the config data not entered completely (Credentials, etc.), entering config portal
Add configurable Config Portal IP
Change Synch XMLHttpRequest to Async
Add configurable Static IP, GW, Subnet Mask and 2 DNS Servers' IP Addresses.
Add checksums
Add auto(re)connect
Easy-to-use Dynamic Parameters without the necessity to write complicated ArduinoJSon functions
Default Credentials and dynamic parameters
DoubleDetectDetector to force Config Portal when double reset is detected within predetermined time, default 10s.
Configurable Config Portal Title
Re-structure all examples to separate Credentials / Defines / Dynamic Params / Code so that you can change Credentials / Dyamic Params quickly for each device.
Add Table of Contents and Version String
Configurable Customs HTML Headers, including Customs Style, Customs Head Elements, CORS Header
Add functions to control Config Portal from software or Virtual Switches.
Add LibraryPatches for Adafruit_MQTT_Library to fix compiler error for Portenta_H7, RP2040-based and many other boards.

Contributions and Thanks

Please help contribute to this project and add your name here.

Contributing

If you want to contribute to this project:

Report bugs and errors
Ask for enhancements
Create issues and pull requests
Tell other people about this library

License

The library is licensed under MIT

Name		Name	Last commit message	Last commit date
Latest commit History 21 Commits
.github		.github
LibraryPatches/Adafruit_MQTT_Library		LibraryPatches/Adafruit_MQTT_Library
Packages_Patches/arduino/hardware/mbed_portenta		Packages_Patches/arduino/hardware/mbed_portenta
examples		examples
pics		pics
platformio		platformio
src		src
utils		utils
.codespellrc		.codespellrc
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
changelog.md		changelog.md
keywords.txt		keywords.txt
library.json		library.json
library.properties		library.properties

	#include "defines.h"
	#include "Credentials.h"
	#include "dynamicParams.h"

	Ethernet_Manager ethernet_manager;

	IPAddress localEthernetIP;

	void heartBeatPrint()
	{
	static int num = 1;
	static int linkStatus = 0;

	localEthernetIP = Ethernet.localIP();

	// The linkStatus() is not working with W5100. Just using IP != 0.0.0.0
	// Better to use ping for W5100
	linkStatus = (int) Ethernet.linkStatus();
	ET_LOGINFO3("localEthernetIP = ", localEthernetIP, ", linkStatus = ", (linkStatus == LinkON) ? "LinkON" : "LinkOFF" );

	if ( ( (linkStatus == LinkON) ) && ((uint32_t) localEthernetIP != 0) )
	{
	Serial.print(F("H"));
	}
	else
	Serial.print(F("F"));

	if (num == 80)
	{
	Serial.println();
	num = 1;
	}
	else if (num++ % 10 == 0)
	{
	Serial.print(F(" "));
	}
	}

	void check_status()
	{
	#define STATUS_CHECK_INTERVAL 10000L

	static unsigned long checkstatus_timeout = STATUS_CHECK_INTERVAL;
	static bool ledPowerOn = false;

	// Send status report every STATUS_REPORT_INTERVAL (10) seconds: we don't need to send updates frequently if there is no status change.
	if ((millis() > checkstatus_timeout))
	{
	heartBeatPrint();

	digitalWrite(LEDB, ledPowerOn ? HIGH : LOW);
	ledPowerOn = !ledPowerOn;

	checkstatus_timeout = millis() + STATUS_CHECK_INTERVAL;
	}
	}

	#if USING_CUSTOMS_STYLE
	const char NewCustomsStyle[] /PROGMEM/ =
	"<style>div,input{padding:5px;font-size:1em;}input{width:95%;}body{text-align: center;}\
	button{background-color:blue;color:white;line-height:2.4rem;font-size:1.2rem;width:100%;}fieldset{border-radius:0.3rem;margin:0px;}</style>";
	#endif

	void setup()
	{
	pinMode(LEDB, OUTPUT);
	digitalWrite(LEDB, LED_OFF);

	// Debug console
	Serial.begin(115200);

	while (!Serial);

	Serial.print("\nStart Ethernet_Portenta_H7 on ");
	Serial.println(BOARD_NAME);
	Serial.print("Ethernet Shield type : ");
	Serial.println(SHIELD_TYPE);
	Serial.println(ETHERNET_MANAGER_PORTENTA_H7_VERSION);
	Serial.println(DOUBLERESETDETECTOR_GENERIC_VERSION);

	//////////////////////////////////////////////

	#if USING_CUSTOMS_STYLE
	ethernet_manager.setCustomsStyle(NewCustomsStyle);
	#endif

	#if USING_CUSTOMS_HEAD_ELEMENT
	ethernet_manager.setCustomsHeadElement("<style>html{filter: invert(10%);}</style>");
	#endif

	#if USING_CORS_FEATURE
	ethernet_manager.setCORSHeader("Your Access-Control-Allow-Origin");
	#endif

	ethernet_manager.begin();

	//////////////////////////////////////////////

	localEthernetIP = Ethernet.localIP();

	if ( (uint32_t) localEthernetIP != 0 )
	{
	Serial.print(F("Connected! IP address: "));
	Serial.println(localEthernetIP);
	}
	else
	{
	Serial.println(F("Ethernet not Connected! Please check."));
	}
	}

	#if (USE_DYNAMIC_PARAMETERS)
	void displayCredentials()
	{
	Serial.println("\nYour stored Credentials :");

	for (int i = 0; i < NUM_MENU_ITEMS; i++)
	{
	Serial.println(String(myMenuItems[i].displayName) + " = " + myMenuItems[i].pdata);
	}
	}

	void displayCredentialsOnce()
	{
	static bool displayedCredentials = false;

	if (!displayedCredentials)
	{
	for (int i = 0; i < NUM_MENU_ITEMS; i++)
	{
	if (!strlen(myMenuItems[i].pdata))
	{
	break;
	}

	if ( i == (NUM_MENU_ITEMS - 1) )
	{
	displayedCredentials = true;
	displayCredentials();
	}
	}
	}
	}
	#endif

	void loop()
	{
	ethernet_manager.run();

	check_status();

	#if (USE_DYNAMIC_PARAMETERS)
	displayCredentialsOnce();
	#endif
	}

	#ifndef defines_h
	#define defines_h

	#if ( ( defined(ARDUINO_PORTENTA_H7_M7) \|\| defined(ARDUINO_PORTENTA_H7_M4) ) && defined(ARDUINO_ARCH_MBED) )
	#warning Use MBED ARDUINO_PORTENTA_H7 and LittleFS

	#if defined(BOARD_NAME)
	#undef BOARD_NAME
	#endif

	#if defined(CORE_CM7)
	#warning Using Portenta H7 M7 core
	#define BOARD_NAME "PORTENTA_H7_M7"
	#else
	#warning Using Portenta H7 M4 core
	#define BOARD_NAME "PORTENTA_H7_M4"
	#endif

	#define USE_ETHERNET_PORTENTA_H7 true

	#include <Portenta_Ethernet.h>
	#include <Ethernet.h>
	#warning Using Portenta_Ethernet lib for Portenta_H7.
	#define SHIELD_TYPE "Ethernet using Portenta_Ethernet Library"

	#else
	#error This code is intended to run on the MBED ARDUINO_PORTENTA_H7 platform! Please check your Tools->Board setting.
	#endif

	/////////////////////////////////////////////

	/* Comment this out to disable prints and save space */
	#define DEBUG_ETHERNET_WEBSERVER_PORT Serial

	// Debug Level from 0 to 4
	#define _ETHERNET_WEBSERVER_LOGLEVEL_ 2
	#define _ETHERNET_MANAGER_LOGLEVEL_ 2

	#define DRD_GENERIC_DEBUG true

	/////////////////////////////////////////////

	// You have to select true for the first time for any board
	#define FORCE_REFORMAT false

	/////////////////////////////////////////////

	#if 0
	//#define SS_PIN_DEFAULT USE_THIS_SS_PIN

	//#include <SPI.h>

	//#define USE_ETHERNET_WRAPPER true
	#define USE_ETHERNET_WRAPPER false

	// Use true for ENC28J60 and UIPEthernet library (https://github.com/UIPEthernet/UIPEthernet)
	// Use false for W5x00 and Ethernetx library (https://www.arduino.cc/en/Reference/Ethernet)

	// Only one if the following to be true
	#define USE_UIP_ETHERNET false
	#define USE_ETHERNET false
	#define USE_ETHERNET2 false
	#define USE_ETHERNET3 false
	#define USE_ETHERNET_LARGE false
	#define USE_ETHERNET_ESP8266 false
	#define USE_ETHERNET_ENC false
	#define USE_CUSTOM_ETHERNET false

	#endif

	/////////////////////////////////////////////

	// Add customs headers from v1.2.0
	#define USING_CUSTOMS_STYLE true
	#define USING_CUSTOMS_HEAD_ELEMENT true
	#define USING_CORS_FEATURE true

	/////////////////////////////////////////////

	// Config Timeout 120s (default 60s)
	#define CONFIG_TIMEOUT 120000L

	#define USE_DYNAMIC_PARAMETERS true

	//////////////////////////////////////////

	#include <Ethernet_Manager_Portenta_H7.h>

	#define ETHERNET_HOST_NAME "Portenta-Ethernet"

	#endif //defines_h

	#ifndef Credentials_h
	#define Credentials_h

	#include "defines.h"

	/// Start Default Config Data //////////////////

	/*
	typedef struct Configuration
	{
	char header [24];
	char static_IP [16];
	char board_name [24];
	int checkSum;
	} Ethernet_Configuration;
	*/

	#define TO_LOAD_DEFAULT_CONFIG_DATA false

	#if TO_LOAD_DEFAULT_CONFIG_DATA

	bool LOAD_DEFAULT_CONFIG_DATA = false;

	Ethernet_Configuration defaultConfig =
	{
	//char header[24], dummy, not used
	#if USE_SSL
	"Eth_SSL",
	#else
	"Eth_NonSSL",
	#endif

	// char static_IP [16];
	//"192.168.2.230",
	// Use dynamic DHCP IP
	"",
	//char board_name [24];
	"Portenta-Ethernet",
	// terminate the list
	//int checkSum, dummy, not used
	0
	/////////// End Default Config Data /////////////
	};

	#else

	bool LOAD_DEFAULT_CONFIG_DATA = false;

	Ethernet_Configuration defaultConfig;

	#endif // TO_LOAD_DEFAULT_CONFIG_DATA

	/////////// End Default Config Data /////////////

	#endif //Credentials_h

	#ifndef dynamicParams_h
	#define dynamicParams_h

	#include "defines.h"

	// USE_DYNAMIC_PARAMETERS defined in defines.h

	/////////////// Start dynamic Credentials ///////////////

	/**************************************
	#define MAX_ID_LEN 5
	#define MAX_DISPLAY_NAME_LEN 16

	typedef struct
	{
	char id [MAX_ID_LEN + 1];
	char displayName [MAX_DISPLAY_NAME_LEN + 1];
	char *pdata;
	uint8_t maxlen;
	} MenuItem;
	**************************************/

	#if USE_DYNAMIC_PARAMETERS

	#define MAX_MQTT_SERVER_LEN 34
	char MQTT_Server [MAX_MQTT_SERVER_LEN + 1] = "default-mqtt-server";

	#define MAX_MQTT_PORT_LEN 6
	char MQTT_Port [MAX_MQTT_PORT_LEN + 1] = "1883";

	#define MAX_MQTT_USERNAME_LEN 34
	char MQTT_UserName [MAX_MQTT_USERNAME_LEN + 1] = "default-mqtt-username";

	#define MAX_MQTT_PW_LEN 34
	char MQTT_PW [MAX_MQTT_PW_LEN + 1] = "default-mqtt-password";

	#define MAX_MQTT_SUBS_TOPIC_LEN 34
	char MQTT_SubsTopic [MAX_MQTT_SUBS_TOPIC_LEN + 1] = "default-mqtt-SubTopic";

	#define MAX_MQTT_PUB_TOPIC_LEN 34
	char MQTT_PubTopic [MAX_MQTT_PUB_TOPIC_LEN + 1] = "default-mqtt-PubTopic";

	MenuItem myMenuItems [] =
	{
	{ "mqtt", "MQTT Server", MQTT_Server, MAX_MQTT_SERVER_LEN },
	{ "mqpt", "Port", MQTT_Port, MAX_MQTT_PORT_LEN },
	{ "user", "MQTT UserName", MQTT_UserName, MAX_MQTT_USERNAME_LEN },
	{ "mqpw", "MQTT PWD", MQTT_PW, MAX_MQTT_PW_LEN },
	{ "subs", "Subs Topics", MQTT_SubsTopic, MAX_MQTT_SUBS_TOPIC_LEN },
	{ "pubs", "Pubs Topics", MQTT_PubTopic, MAX_MQTT_PUB_TOPIC_LEN },
	};

	uint16_t NUM_MENU_ITEMS = sizeof(myMenuItems) / sizeof(MenuItem); //MenuItemSize;

	#else

	MenuItem myMenuItems [] = {};

	uint16_t NUM_MENU_ITEMS = 0;
	#endif

	/////// // End dynamic Credentials ///////////

	#endif //dynamicParams_h

License

khoih-prog/Ethernet_Manager_Portenta_H7

Folders and files

Latest commit

History

Repository files navigation

Ethernet_Manager_Portenta_H7 Library

Table of Contents

Important Notes for Portenta_H7

Why do we need this Ethernet_Manager_Portenta_H7 library

Features

Currently Supported Boards

Currently supported Ethernet shields/modules

Prerequisites

Installation

Use Arduino Library Manager

Manual Install

VS Code & PlatformIO

Packages' Patches

1. For Portenta_H7 boards using Arduino IDE in Linux

Libraries' Patches

1. For Adafruit_MQTT_Library

How to use default Credentials and have them pre-loaded onto Config Portal

How to use

1. Basic usage

2. Add custom parameters

3. Not using custom parameters

4. To open Config Portal

5. To use custom HTML Style

6. To use custom Head Elements

7. To use CORS Header

Important Notes for using Dynamic Parameters' ids

Examples

So, how it works?

Example Ethernet_Portenta_H7

1. File Ethernet_Portenta_H7.ino

2. File defines.h

3. File Credentials.h

4. File dynamicParams.h

Debug Terminal Output Samples

1. Ethernet_Portenta_H7 on PORTENTA_H7_M7

1.1 Initial start, LittleFS format and Config Portal

1.2 Save and Exit Config Portal

2. MQTT_Ethernet_Portenta_H7 on PORTENTA_H7_M7

2.1 Initial start, LittleFS format and Config Portal

2.2 Save and Exit Config Portal

Debug

Troubleshooting

Issues

TO DO

DONE

Contributions and Thanks

Contributing

License

Copyright

About

Topics

Resources

License

Stars

Watchers

Forks

Releases 2

Packages 0

Languages

Packages