Add Ethernet support for Portenta + Ethernet Shield

keywords.txt

@@ -10,6 +10,7 @@ WiFiConnectionHandler	KEYWORD1
 GSMConnectionHandler	KEYWORD1
 NBConnectionHandler	KEYWORD1
 LoRaConnectionHandler	KEYWORD1
+EthernetConnectionHandler	KEYWORD1
 
 ####################################################
 # Methods and Functions (KEYWORD2)

src/Arduino_ConnectionHandler.cpp

@@ -25,8 +25,9 @@
    CONSTRUCTOR/DESTRUCTOR
  ******************************************************************************/
 
-ConnectionHandler::ConnectionHandler(bool const keep_alive)
+ConnectionHandler::ConnectionHandler(bool const keep_alive, NetworkAdapter interface)
 : _keep_alive{keep_alive}
+, _interface{interface}
 , _lastConnectionTickTime{millis()}
 , _current_net_connection_state{NetworkConnectionState::INIT}
 {

src/Arduino_ConnectionHandler.h

@@ -43,7 +43,18 @@
   #define WIFI_FIRMWARE_VERSION_REQUIRED WIFI_FIRMWARE_LATEST_VERSION
 #endif
 
-#if defined(ARDUINO_PORTENTA_H7_M7) || defined(ARDUINO_NICLA_VISION)
+#if defined(ARDUINO_PORTENTA_H7_M7)
+  #include <WiFi.h>
+  #include <WiFiUdp.h>
+
+  #define BOARD_HAS_WIFI
+  #define BOARD_HAS_PORTENTA_VISION_SHIELD
+  #define NETWORK_HARDWARE_ERROR WL_NO_SHIELD
+  #define NETWORK_IDLE_STATUS WL_IDLE_STATUS
+  #define NETWORK_CONNECTED WL_CONNECTED
+#endif
+
+#if defined(ARDUINO_NICLA_VISION)
   #include <WiFi.h>
   #include <WiFiUdp.h>
 
@@ -96,6 +107,12 @@
   #define WIFI_FIRMWARE_VERSION_REQUIRED WIFI_FIRMWARE_REQUIRED
 #endif
 
+#if defined(BOARD_HAS_PORTENTA_VISION_SHIELD)
+  #define BOARD_HAS_ETHERNET
+
+  #include <Ethernet.h>
+#endif
+
 /******************************************************************************
    INCLUDES
  ******************************************************************************/
@@ -124,6 +141,14 @@ enum class NetworkConnectionEvent {
   ERROR
 };
 
+enum class NetworkAdapter {
+  WIFI,
+  ETHERNET,
+  NB,
+  GSM,
+  LORA
+};
+
 typedef void (*OnNetworkEventCallback)();
 
 /******************************************************************************
@@ -148,12 +173,12 @@ static unsigned int const CHECK_INTERVAL_TABLE[] =
 class ConnectionHandler {
   public:
 
-    ConnectionHandler(bool const keep_alive);
+    ConnectionHandler(bool const keep_alive, NetworkAdapter interface);
 
 
     NetworkConnectionState check();
 
-    #if defined(BOARD_HAS_WIFI) || defined(BOARD_HAS_GSM) || defined(BOARD_HAS_NB)
+    #if defined(BOARD_HAS_WIFI) || defined(BOARD_HAS_GSM) || defined(BOARD_HAS_NB) || defined(BOARD_HAS_ETHERNET)
       virtual unsigned long getTime() = 0;
       virtual Client &getClient() = 0;
       virtual UDP &getUDP() = 0;
@@ -169,6 +194,10 @@ class ConnectionHandler {
       return _current_net_connection_state;
     }
 
+    NetworkAdapter getInterface() {
+      return _interface;
+    }
+
     void connect();
     void disconnect();
 
@@ -180,6 +209,7 @@ class ConnectionHandler {
   protected:
 
     bool _keep_alive;
+    NetworkAdapter _interface;
 
     virtual NetworkConnectionState update_handleInit         () = 0;
     virtual NetworkConnectionState update_handleConnecting   () = 0;
@@ -207,4 +237,8 @@ class ConnectionHandler {
   #include "Arduino_LoRaConnectionHandler.h"
 #endif
 
+#if defined(BOARD_HAS_ETHERNET)
+  #include "Arduino_EthernetConnectionHandler.h"
+#endif
+
 #endif /* CONNECTION_HANDLER_H_ */

src/Arduino_EthernetConnectionHandler.cpp

@@ -0,0 +1,119 @@
+/*
+   This file is part of ArduinoIoTCloud.
+   Copyright 2020 ARDUINO SA (http://www.arduino.cc/)
+   This software is released under the GNU General Public License version 3,
+   which covers the main part of arduino-cli.
+   The terms of this license can be found at:
+   https://www.gnu.org/licenses/gpl-3.0.en.html
+   You can be released from the requirements of the above licenses by purchasing
+   a commercial license. Buying such a license is mandatory if you want to modify or
+   otherwise use the software for commercial activities involving the Arduino
+   software without disclosing the source code of your own applications. To purchase
+   a commercial license, send an email to [email protected].
+*/
+
+/******************************************************************************
+   INCLUDE
+ ******************************************************************************/
+
+#include "Arduino_EthernetConnectionHandler.h"
+
+#ifdef BOARD_HAS_ETHERNET /* Only compile if the board has ethernet */
+
+/******************************************************************************
+   CTOR/DTOR
+ ******************************************************************************/
+
+EthernetConnectionHandler::EthernetConnectionHandler(bool const keep_alive)
+: ConnectionHandler{keep_alive, NetworkAdapter::ETHERNET}
+,_ip{INADDR_NONE}
+,_dns{INADDR_NONE}
+,_gateway{INADDR_NONE}
+,_subnet{INADDR_NONE}
+{
+
+}
+
+EthernetConnectionHandler::EthernetConnectionHandler(IPAddress ip, IPAddress dns, IPAddress gateway, IPAddress subnet, bool const keep_alive)
+: ConnectionHandler{keep_alive, NetworkAdapter::ETHERNET}
+,_ip{ip}
+,_dns{dns}
+,_gateway{gateway}
+,_subnet{subnet}
+{
+
+}
+
+/******************************************************************************
+   PROTECTED MEMBER FUNCTIONS
+ ******************************************************************************/
+
+NetworkConnectionState EthernetConnectionHandler::update_handleInit()
+{
+  if (Ethernet.hardwareStatus() == EthernetNoHardware) {
+#if !defined(__AVR__)
+    Debug.print(DBG_ERROR, F("Error, ethernet shield was not found."));
+#endif
+    return NetworkConnectionState::ERROR;
+  }
+  return NetworkConnectionState::CONNECTING;
+}
+
+NetworkConnectionState EthernetConnectionHandler::update_handleConnecting()
+{
+  if (_ip != INADDR_NONE) {
+    if (Ethernet.begin(nullptr, _ip, _dns, _gateway, _subnet, 15000, 4000) == 0) {
+#if !defined(__AVR__)
+      Debug.print(DBG_ERROR, F("Failed to configure Ethernet, check cable connection"));
+#endif
+      return NetworkConnectionState::CONNECTING;
+    }
+  } else {
+    if (Ethernet.begin(nullptr, 15000, 4000) == 0) {
+#if !defined(__AVR__)
+      Debug.print(DBG_ERROR, F("Waiting Ethernet configuration from DHCP server, check cable connection"));
+#endif
+      return NetworkConnectionState::CONNECTING;
+    }
+  }
+  return NetworkConnectionState::CONNECTED;
+}
+
+NetworkConnectionState EthernetConnectionHandler::update_handleConnected()
+{
+  if (Ethernet.linkStatus() == LinkOFF) {
+#if !defined(__AVR__)
+    Debug.print(DBG_VERBOSE, F("Ethernet.status(): %d"), Ethernet.status());
+    Debug.print(DBG_ERROR, F("Connection lost."));
+#endif
+    if (_keep_alive)
+    {
+#if !defined(__AVR__)
+      Debug.print(DBG_ERROR, F("Attempting reconnection"));
+#endif
+    }
+    return NetworkConnectionState::DISCONNECTED;
+  }
+  return NetworkConnectionState::CONNECTED;
+}
+
+NetworkConnectionState EthernetConnectionHandler::update_handleDisconnecting()
+{
+  Ethernet.disconnect();
+  return NetworkConnectionState::DISCONNECTED;
+}
+
+NetworkConnectionState EthernetConnectionHandler::update_handleDisconnected()
+{
+  Ethernet.end();
+  if (_keep_alive)
+  {
+    return NetworkConnectionState::INIT;
+  }
+  else
+  {
+    return NetworkConnectionState::CLOSED;
+  }
+}
+
+#endif /* #ifdef BOARD_HAS_ETHERNET */

src/Arduino_EthernetConnectionHandler.h

@@ -0,0 +1,65 @@
+/*
+   This file is part of ArduinoIoTCloud.
+   Copyright 2020 ARDUINO SA (http://www.arduino.cc/)
+   This software is released under the GNU General Public License version 3,
+   which covers the main part of arduino-cli.
+   The terms of this license can be found at:
+   https://www.gnu.org/licenses/gpl-3.0.en.html
+   You can be released from the requirements of the above licenses by purchasing
+   a commercial license. Buying such a license is mandatory if you want to modify or
+   otherwise use the software for commercial activities involving the Arduino
+   software without disclosing the source code of your own applications. To purchase
+   a commercial license, send an email to [email protected].
+*/
+
+#ifndef ARDUINO_ETHERNET_CONNECTION_HANDLER_H_
+#define ARDUINO_ETHERNET_CONNECTION_HANDLER_H_
+
+/******************************************************************************
+   INCLUDE
+ ******************************************************************************/
+
+#include "Arduino_ConnectionHandler.h"
+
+#ifdef BOARD_HAS_ETHERNET /* Only compile if the board has ethernet */
+
+/******************************************************************************
+   CLASS DECLARATION
+ ******************************************************************************/
+
+class EthernetConnectionHandler : public ConnectionHandler
+{
+  public:
+
+    EthernetConnectionHandler(bool const keep_alive = true);
+    EthernetConnectionHandler(IPAddress ip, IPAddress dns, IPAddress gateway, IPAddress subnet, bool const keep_alive = true);
+
+
+    virtual unsigned long getTime() override { return 0; }
+    virtual Client & getClient() override{ return _eth_client; }
+    virtual UDP & getUDP() override { return _eth_udp; }
+
+
+  protected:
+
+    virtual NetworkConnectionState update_handleInit         () override;
+    virtual NetworkConnectionState update_handleConnecting   () override;
+    virtual NetworkConnectionState update_handleConnected    () override;
+    virtual NetworkConnectionState update_handleDisconnecting() override;
+    virtual NetworkConnectionState update_handleDisconnected () override;
+
+  private:
+
+    IPAddress _ip;
+    IPAddress _dns;
+    IPAddress _gateway;
+    IPAddress _subnet;
+
+    EthernetUDP _eth_udp;
+    EthernetClient _eth_client;
+
+};
+
+#endif /* #ifdef BOARD_HAS_ETHERNET */
+
+#endif /* ARDUINO_ETHERNET_CONNECTION_HANDLER_H_ */

src/Arduino_GSMConnectionHandler.cpp

@@ -47,7 +47,7 @@ __attribute__((weak)) void mkr_gsm_feed_watchdog()
  ******************************************************************************/
 
 GSMConnectionHandler::GSMConnectionHandler(const char * pin, const char * apn, const char * login, const char * pass, bool const keep_alive)
-: ConnectionHandler{keep_alive}
+: ConnectionHandler{keep_alive, NetworkAdapter::GSM}
 , _pin(pin)
 , _apn(apn)
 , _login(login)

src/Arduino_LoRaConnectionHandler.cpp

@@ -44,7 +44,7 @@ typedef enum
    CTOR/DTOR
  ******************************************************************************/
 LoRaConnectionHandler::LoRaConnectionHandler(char const * appeui, char const * appkey, _lora_band const band, char const * channelMask, _lora_class const device_class)
-: ConnectionHandler{false}
+: ConnectionHandler{false, NetworkAdapter::LORA}
 , _appeui(appeui)
 , _appkey(appkey)
 , _band(band)

src/Arduino_NBConnectionHandler.cpp

@@ -57,7 +57,7 @@ NBConnectionHandler::NBConnectionHandler(char const * pin, char const * apn, boo
 }
 
 NBConnectionHandler::NBConnectionHandler(char const * pin, char const * apn, char const * login, char const * pass, bool const keep_alive)
-: ConnectionHandler{keep_alive}
+: ConnectionHandler{keep_alive, NetworkAdapter::NB}
 , _pin(pin)
 , _apn(apn)
 , _login(login)

src/Arduino_WiFiConnectionHandler.cpp

@@ -28,7 +28,7 @@
  ******************************************************************************/
 
 WiFiConnectionHandler::WiFiConnectionHandler(char const * ssid, char const * pass, bool const keep_alive)
-: ConnectionHandler{keep_alive}
+: ConnectionHandler{keep_alive, NetworkAdapter::WIFI}
 , _ssid{ssid}
 , _pass{pass}
 {