Why do we need this WebSockets2_Generic library
Many Web services require WebSockets library, which is so far written only for ESP8266/ESP32 boards. The ESP boards so far rely on the Markus Sattler's WebSockets Library to connect to Alexa via Sinric or SinricPro skills.
This WebSockets2_Generic library is based on and modified from Gil Maimon's ArduinoWebSockets Library to provide support to many more boards, such as Arduino SAMD21, Adafruit SAMD21/SAMD51, Seeeduino SAMD21/SAMD51, nRF52, STM32F/L/H/G/WB/MP1, Teensy, SAM DUE, etc. and enable those boards to use WebSockets services, including voice-controlled Alexa along with Blynk. Those supported boards can also run WebSockets Server. The WebSockets can be used with ESP’s WiFi, WiFiNINA, W5x00/ENC28J60/LAN8742A Ethernet, ESP8266/ESP32-AT modules/shields.
- text frame
- binary frame
- connection close
- ping
- pong
- continuation frame
- Add non-blocking WebSockets Server feature to enable WS Server and WebServer running concurrently. See Support as Http server and the Websockets server on Arduino DUE and Running Http and Websocket Servers concurrently. Thanks to bug report and persistence of Jake.
- Add non-blocking WebSockets Server and WebServer examples.
- Add Ethernet Library Patches
- Add Arduino SAMD Packages_Patches to fix compiler errors when using Standard Template Library STL
- Sync with ArduinoWebsockets v0.4.18 to fix ESP8266 SSL bug. See Secured-Two-Way: Client certificate is not sent if used along with setTrustAnchors
- Add support to all STM32F/L/H/G/WB/MP1 (Nucleo-144 NUCLEO_F767ZI, Nucleo-64 NUCLEO_L053R8, etc.)
- Add support to Seeeduino SAMD21/SAMD51 boards (SEEED_WIO_TERMINAL, SEEED_FEMTO_M0, SEEED_XIAO_M0, Wio_Lite_MG126, WIO_GPS_BOARD, SEEEDUINO_ZERO, SEEEDUINO_LORAWAN, SEEED_GROVE_UI_WIRELESS, etc.)
- Add sample Packages_Patches for STM32 stm32 (Nucleo-144 NUCLEO_F767ZI, Nucleo-64 NUCLEO_L053R8)
- Add Packages' Patches for Seeeduino SAMD to enable displaying BOARD_NAME
- Add many examples
- Add support to STM32F boards with built-in Ethernet such as :
- Nucleo-144 (F429ZI, F767ZI)
- Discovery (STM32F746G-DISCOVERY)
- All STM32F Boards with Built-in Ethernet LAN8742A
- Add support to STM32F1,2,3,4,7 boards (with 64+K Flash) using Ethernet W5x00, ENC28J60 or LAN8742A
- Add Packages' Patches to Adafruit nRF52, SAMD, Arduino SAMD to enable displaying BOARD_NAME
- Enhance examples and update README.md
- Add support to Ethernet ENC28J60, using UIPEthernet library, for nRF52, SAMD21/SAMD51 and SAM DUE boards.
- Add support to SAM DUE boards.
- Add support to Ethernet W5x00, using either Ethernet, EthernetLarge or Ethernet2 library.
- Restructure code to provide flexibility to support many more WiFi/Ethernet modules/shields in the future. Please delete the *.cpp files, replaced with coresponding *.hpp files, in the library src directory, if the *.cpp files still exist after installing new version.
- Add support to nRF52 boards, such as AdaFruit Feather nRF52832, nRF52840 Express, BlueFruit Sense, Itsy-Bitsy nRF52840 Express, Metro nRF52840 Express, NINA_B302_ublox, NINA_B112_ublox, etc., using WiFiNINA with
WiFiNINA_Generic library
- Add support to SAMD51 (Itsy-Bitsy M4, Metro M4, Grand Central M4, Feather M4 Express, etc.) , using WiFiNINA with
WiFiNINA_Generic library
. - Add support to SAMD21 (ZERO, MKR, NANO_33_IOT, M0, M0 Pro, AdaFruit CIRCUITPLAYGROUND_EXPRESS, etc.), using WiFiNINA with
WiFiNINA_Generic library
. - Add Alexa/
SINRIC
examples and supports to those boards as well as ESP8266/ESP32
Arduino IDE v1.8.12+
for ArduinoESP32 core v1.0.4+
for ESP32 boards. Ready from v1.0.0.ESP8266 core v2.7.3+
for Arduino for ESP8266 boards. Ready from v1.0.0.Arduino AVR core v1.8.2+
for Arduino (Use Arduino Board Manager).Teensy core v1.53+
for Teensy (4.1, 4.0, 3.6, 3.5, 3,2, 3.1, 3.0) boards. Not yet ready in v1.0.6.Arduino SAM DUE core v1.6.12+
for SAM DUE ARM Cortex-M3 boards. Ready from v1.0.1.Arduino SAMD core v1.8.7+
for SAMD ARM Cortex-M0+ boards. Ready from v1.0.0.Adafruit SAMD core v1.6.0+
for SAMD ARM Cortex-M0+ and M4 boards (Nano 33 IoT, etc.). Ready from v1.0.0.Seeeduino SAMD core 1.7.7+
for SAMD21/SAMD51 boards (XIAO M0, Wio Terminal, etc.). Ready from v1.0.4.Adafruit nRF52 v0.20.5+
for nRF52 boards such as AdaFruit Feather nRF52840 Express, NINA_B302_ublox, NINA_B112_ublox, etc. Ready from v1.0.0.Arduino Core for STM32 v1.9.0+
for STM32F/L/H/G/WB/MP1 boards. To install go to Arduino IDE, select Boards Manager, search forSTM32
. Ready from v1.0.3.WiFiNINA_Generic library v1.6.2+
if for WiFiNINA. To install. check. Ready from v1.0.0.
- Depending on which Ethernet module/shield you're using :
Ethernet library v2.0.0+
for W5100, W5200 and W5500. Ready from v1.0.1.Ethernet2 library v1.0.4+
for W5500 (Deprecated, use Arduino Ethernet library). Ready from v1.0.1.Ethernet3 library v1.5.3+
for W5500/WIZ550io/WIZ850io/USR-ES1 with Wiznet W5500 chip. Not yet ready in v1.0.6.EthernetLarge library v2.0.0+
for W5100, W5200 and W5500. Ready from v1.0.1.UIPEthernet library v2.0.8+
for ENC28J60. Ready from v1.0.2.STM32Ethernet library v1.2.0+
for built-in Ethernet LAN8742A on (Nucleo-144, Discovery). To be used withSTM32duino_LwIP library v2.1.2+
. Ready from v1.0.3.
ESP_AT_Lib library v1.0.0+
if necessary to use ESP8288/ESP32-AT shields. To install, check. Not yet ready in v1.0.6.
The best and easiest way is to use Arduino Library Manager
. Search for WebSockets2_Generic
, then select / install the latest version.
You can also use this link for more detailed instructions.
Another way to install is to:
- Navigate to WebSockets2_Generic page.
- Download the latest release
WebSockets2_Generic-master.zip
. - Extract the zip file to
WebSockets2_Generic-master
directory - Copy whole
WebSockets2_Generic-master
folder to Arduino libraries' directory such as~/Arduino/libraries/
.
- Install VS Code
- Install PlatformIO
- Install WebSockets2_Generic library by using Library Manager. Search for WebSockets2_Generic in Platform.io Author's Libraries
- Use included platformio.ini file from examples to ensure that all dependent libraries will installed automatically.
- To be able to compile, run and automatically detect and display BOARD_NAME on nRF52840/nRF52832 boards, you have to copy the whole nRF52 0.20.5 directory into Adafruit nRF52 directory (~/.arduino15/packages/adafruit/hardware/nrf52/0.20.5).
Supposing the Adafruit nRF52 version is 0.20.5. These files must be copied into the directory:
~/.arduino15/packages/adafruit/hardware/nrf52/0.20.5/platform.txt
~/.arduino15/packages/adafruit/hardware/nrf52/0.20.5/boards.txt
~/.arduino15/packages/adafruit/hardware/nrf52/0.20.5/variants/NINA_B302_ublox/variant.h
~/.arduino15/packages/adafruit/hardware/nrf52/0.20.5/variants/NINA_B302_ublox/variant.cpp
~/.arduino15/packages/adafruit/hardware/nrf52/0.20.5/variants/NINA_B112_ublox/variant.h
~/.arduino15/packages/adafruit/hardware/nrf52/0.20.5/variants/NINA_B112_ublox/variant.cpp
~/.arduino15/packages/adafruit/hardware/nrf52/0.20.5/cores/nRF5/Udp.h
Whenever a new version is installed, remember to copy these files into the new version directory. For example, new version is x.yy.z These files must be copied into the directory:
~/.arduino15/packages/adafruit/hardware/nrf52/x.yy.z/platform.txt
~/.arduino15/packages/adafruit/hardware/nrf52/x.yy.z/boards.txt
~/.arduino15/packages/adafruit/hardware/nrf52/x.yy.z/variants/NINA_B302_ublox/variant.h
~/.arduino15/packages/adafruit/hardware/nrf52/x.yy.z/variants/NINA_B302_ublox/variant.cpp
~/.arduino15/packages/adafruit/hardware/nrf52/x.yy.z/variants/NINA_B112_ublox/variant.h
~/.arduino15/packages/adafruit/hardware/nrf52/x.yy.z/variants/NINA_B112_ublox/variant.cpp
~/.arduino15/packages/adafruit/hardware/nrf52/x.yy.z/cores/nRF5/Udp.h
- To be able to compile and run on Teensy boards, you have to copy the file Teensy boards.txt into Teensy hardware directory (./arduino-1.8.12/hardware/teensy/avr/boards.txt).
Supposing the Arduino version is 1.8.12. This file must be copied into the directory:
./arduino-1.8.12/hardware/teensy/avr/boards.txt
Whenever a new version is installed, remember to copy this file into the new version directory. For example, new version is x.yy.zz This file must be copied into the directory:
./arduino-x.yy.zz/hardware/teensy/avr/boards.txt
- To be able to compile and run on SAM DUE boards, you have to copy the whole SAM DUE directory into Arduino sam directory (~/.arduino15/packages/arduino/hardware/sam/1.6.12).
Supposing the Arduino SAM core version is 1.6.12. This file must be copied into the directory:
~/.arduino15/packages/arduino/hardware/sam/1.6.12/platform.txt
Whenever a new version is installed, remember to copy this file 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/sam/x.yy.zz/platform.txt
- To be able to compile without error and automatically detect and display BOARD_NAME on Arduino SAMD (Nano-33-IoT, etc) boards, you have to copy the whole Arduino SAMD cores 1.8.7 directory into Arduino SAMD directory (~/.arduino15/packages/arduino/hardware/samd/1.8.7).
Supposing the Arduino SAMD version is 1.8.7. These files must be copied into the directory:
~/.arduino15/packages/arduino/hardware/samd/1.8.7/platform.txt
~/.arduino15/packages/arduino/hardware/samd/1.8.7/cores/arduino/Arduino.h
Whenever a new version is installed, remember to copy these files into the new version directory. For example, new version is x.yy.z
These files must be copied into the directory:
~/.arduino15/packages/arduino/hardware/samd/x.yy.z/platform.txt
~/.arduino15/packages/arduino/hardware/samd/x.yy.z/cores/arduino/Arduino.h
This is mandatory to fix the notorious Arduino SAMD compiler error. See Improve Arduino compatibility with the STL (min and max macro)
...\arm-none-eabi\include\c++\7.2.1\bits\stl_algobase.h:243:56: error: macro "min" passed 3 arguments, but takes just 2
min(const _Tp& __a, const _Tp& __b, _Compare __comp)
Whenever the above-mentioned compiler error issue is fixed with the new Arduino SAMD release, you don't need to copy the Arduino.h
file anymore.
- To be able to automatically detect and display BOARD_NAME on Adafruit SAMD (Itsy-Bitsy M4, etc) boards, you have to copy the file Adafruit SAMD platform.txt into Adafruit samd directory (~/.arduino15/packages/adafruit/hardware/samd/1.6.0).
Supposing the Adafruit SAMD core version is 1.6.0. This file must be copied into the directory:
~/.arduino15/packages/adafruit/hardware/samd/1.6.0/platform.txt
Whenever a new version is installed, remember to copy this file into the new version directory. For example, new version is x.yy.zz This file must be copied into the directory:
~/.arduino15/packages/adafruit/hardware/samd/x.yy.zz/platform.txt
- To be able to automatically detect and display BOARD_NAME on Seeeduino SAMD (XIAO M0, Wio Terminal, etc) boards, you have to copy the file Seeeduino SAMD platform.txt into Adafruit samd directory (~/.arduino15/packages/Seeeduino/hardware/samd/1.7.7).
Supposing the Seeeduino SAMD core version is 1.7.7. This file must be copied into the directory:
~/.arduino15/packages/Seeeduino/hardware/samd/1.7.7/platform.txt
Whenever a new version is installed, remember to copy this file into the new version directory. For example, new version is x.yy.zz This file must be copied into the directory:
~/.arduino15/packages/Seeeduino/hardware/samd/x.yy.zz/platform.txt
- To use Serial1 on some STM32 boards without Serial1 definition (Nucleo-144 NUCLEO_F767ZI, Nucleo-64 NUCLEO_L053R8, etc.) boards, you have to copy the files STM32 variant.h into STM32 stm32 directory (~/.arduino15/packages/STM32/hardware/stm32/1.9.0). You have to modify the files corresponding to your boards, this is just an illustration how to do.
Supposing the STM32 stm32 core version is 1.9.0. These files must be copied into the directory:
~/.arduino15/packages/STM32/hardware/stm32/1.9.0/variants/NUCLEO_F767ZI/variant.h
for Nucleo-144 NUCLEO_F767ZI.~/.arduino15/packages/STM32/hardware/stm32/1.9.0/variants/NUCLEO_L053R8/variant.h
for Nucleo-64 NUCLEO_L053R8.
Whenever a new version is installed, remember to copy this file into the new version directory. For example, new version is x.yy.zz, theses files must be copied into the corresponding directory:
~/.arduino15/packages/STM32/hardware/stm32/x.yy.zz/variants/NUCLEO_F767ZI/variant.h
~/.arduino15/packages/STM32/hardware/stm32/x.yy.zz/variants/NUCLEO_L053R8/variant.h
-
If your application requires 2K+ HTML page, the current
Ethernet library
must be modified if you are using W5200/W5500 Ethernet shields. W5100 is not supported for 2K+ buffer. If you use boards requiring different CS/SS pin for W5x00 Ethernet shield, for example ESP32, ESP8266, nRF52, etc., you also have to modify the following libraries to be able to specify the CS/SS pin correctly. -
To fix
Ethernet library
, just copy these following files into theEthernet library
directory to overwrite the old files:
- To fix
EthernetLarge library
, just copy these following files into theEthernetLarge library
directory to overwrite the old files:
- To fix
Ethernet2 library
, just copy these following files into theEthernet2 library
directory to overwrite the old files:
- To fix
Ethernet3 library
, just copy these following files into theEthernet3 library
directory to overwrite the old files:
- To be able to compile and run on nRF52 boards with ENC28J60 using UIPEthernet library, you have to copy these following files into the UIPEthernet
utility
directory to overwrite the old files:
- To fix
ESP32 compile error
, just copy the following file into theESP32
cores/esp32 directory (e.g. ./arduino-1.8.12/hardware/espressif/cores/esp32) to overwrite the old file:
-
From v1.0.1, code is restructured to provide flexibility to make it easy to support many more WiFi/Ethernet modules/shields in the future. Please delete the *.cpp files, replaced by *.hpp files, in the src directory, if *.cpp files still exist after installing new version.
-
For Adafruit nRF52, use the SPI's pin as follows:
- SS/CS = 10
- SPI_MOSI = MO(SI)
- SPI_MISO = MI(SO)
- SPI_SCK = SCK
- For Adafruit SAMD21/SAMD51, use the SPI's CS/SS pin as follows:
- Itsy-Bitsy M0/M4, Feather M0 (Express), Hallowing M0 Express, Zero, Metro M0 => use CS = 16 = pin A2
- Feather M4 (SAMD51) => use SS/CS = 9
- Grand Central M4 => use SS/CS = 53
- Hallowing M4 => use SS/CS = 10
- Metro M4 AirLift => use SS/CS = 36
To know the default CS/SS pins of not listed boards, check the related variant.h
files in
~/.arduino15/packages/adafruit/hardware/samd/x.y.zz/variants/board_name/variant.h
- For Arduino SAM DUE, use the SPI's pin as follows:
- SS/CS = 10
- SPI_MOSI = 75 ( pin 4 @ ICSP connector )
- SPI_MISO = 74 ( pin 1 @ ICSP connector )
- SPI_SCK = 76 ( pin 3 @ ICSP connector )
WebsocketsClient client;
client.connect("ws://your-server-ip:port/uri");
client.send("Hello Server!");
- Using Lambda function
// run callback when messages are received
client.onMessage([&](WebsocketsMessage message)
{
Serial.print("Got Message: ");
Serial.println(message.data());
});
- Using normal calback function
// run callback when events are occuring
client.onMessage(onMessageCallback);
and
void onMessageCallback(WebsocketsMessage message)
{
//Doing something with received String message.data() type
Serial.print("Got Message: ");
Serial.println(message.data());
}
void loop()
{
client.poll();
}
WebsocketsServer server;
server.listen(8080);
WebsocketsClient client = server.accept();
// handle client as described before :)
// run callback when messages are received
client.onMessage([&](WebsocketsMessage message)
{
Serial.print("Got Message: ");
Serial.println(message.data());
});
Using this new feature to enable doing other tasks in the loop(), such as WebServer, control tasks, etc. Server, using library version before v1.0.6, can only read Client messages in blocking mode. Therefore, the WebSocket Server can't hang, waiting for Client, and block all other tasks from running.
// You can do some other tasks here, such as WebServer, controlling tasks, etc.
WebsocketsClient client = SocketsServer.accept();
if (client.available())
{
WebsocketsMessage msg = client.readNonBlocking();
// log
Serial.print("Got Message: ");
Serial.println(msg.data());
// return echo
client.send("Echo: " + msg.data());
// close the connection
client.close();
}
Please test using one of these following new examples with v1.0.6 and v1.0.5- to see the blocking effects. Please remember to change in loop() from
WebsocketsMessage msg = client.readNonBlocking();
to
WebsocketsMessage msg = client.readBlocking();
as client.readNonBlocking() is a new function in v1.0.6+.
- Esp32-AdvancedWebServer using ESP32
- Esp8266-AdvancedWebServer using ESP8266
- SAMD-AdvancedWebServer using Nano-33-IoT
- nRF52-AdvancedWebServer using Adafruit nRF52 NRF52840_FEATHER_EXPRESS, NINA_B302_ublox and WiFiNINA W102 module.
- STM32-AdvancedWebServer using STM32 Nucleo-64 L053R8, STM32F4 and WiFiNINA W102 module.
- SAMDUE-Ethernet_AdvancedWebServer using SAM DUE and W5100 Ethernet
- STM32-Ethernet_AdvancedWebServer using STM32F7 Nucleo-144 F676ZI and built-in LAN8742A Ethernet.
- SAMD-Ethernet_AdvancedWebServer using Adafruit SAMD51 Itsy_Bitsy_M4, Seeeduino SAMD21 XIAO_M0 and W5500 Ethernet.
- nRF52-Ethernet_AdvancedWebServer using Adafruit nRF52 NRF52840_FEATHER_EXPRESS, NINA_B302_ublox and W5500 Ethernet.
#define WEBSOCKETS_USE_WIFININA true
#define WEBSOCKETS_USE_ETHERNET true
#define USE_UIP_ETHERNET false
- To use
W5x00
module/shield withEthernet
library
#define WEBSOCKETS_USE_ETHERNET true
#define USE_ETHERNET_LIB true
#define USE_ETHERNET2_LIB false
#define USE_ETHERNET_LARGE_LIB false
#define USE_UIP_ETHERNET false
- To use
W5x00
module/shield withEthernet2
library
#define WEBSOCKETS_USE_ETHERNET true
#define USE_ETHERNET_LIB false
#define USE_ETHERNET2_LIB true
#define USE_ETHERNET_LARGE_LIB false
#define USE_UIP_ETHERNET false
- To use
W5x00
module/shield withEthernetLarge
library
#define WEBSOCKETS_USE_ETHERNET true
#define USE_ETHERNET_LIB false
#define USE_ETHERNET2_LIB false
#define USE_ETHERNET_LARGE_LIB true
#define USE_UIP_ETHERNET false
#define WEBSOCKETS_USE_ETHERNET true
#define USE_UIP_ETHERNET true
#define USE_ETHERNET_LIB false
#define USE_ETHERNET2_LIB false
#define USE_ETHERNET_LARGE_LIB false
#define WEBSOCKETS_USE_ETHERNET true
// Just select one to be true. If all is false, default is Ethernet.
// If more than one are true, the priority is USE_ETHERNET_LIB, USE_ETHERNET2_LIB, USE_ETHERNET_LARGE_LIB, USE_UIP_ETHERNET
#define USE_ETHERNET_LIB false
#define USE_ETHERNET2_LIB false
#define USE_ETHERNET_LARGE_LIB false
#define USE_UIP_ETHERNET false
#if USE_ETHERNET_LIB
// Also default to Ethernet library
#include <Ethernet.h>
#define ETHERNET_TYPE "W5x00 and Ethernet Library"
#elif USE_ETHERNET2_LIB
#include <Ethernet2.h>
#define ETHERNET_TYPE "W5x00 and Ethernet2 Library"
#elif USE_ETHERNET_LARGE_LIB
#include <EthernetLarge.h>
#define ETHERNET_TYPE "W5x00 and EthernetLarge Library"
#elif USE_UIP_ETHERNET
#include <UIPEthernet.h>
#include <utility/logging.h>
#define ETHERNET_TYPE "ENC28J60 and UIPEthernet Library"
#else
// Default to Ethernet library
#include <Ethernet.h>
#define ETHERNET_TYPE "W5x00 and Ethernet Library"
#define USE_ETHERNET_LIB true
#endif
#ifndef USE_THIS_SS_PIN
#define USE_THIS_SS_PIN 10 // For other boards
#endif
#define WEBSOCKETS_USE_ETHERNET true
#define USE_UIP_ETHERNET false
#define USE_LAN8742A_ETHERNET false
- To use
W5x00
module/shield withEthernet
library
#define WEBSOCKETS_USE_ETHERNET true
#define USE_ETHERNET_LIB true
#define USE_ETHERNET2_LIB false
#define USE_ETHERNET_LARGE_LIB false
#define USE_UIP_ETHERNET false
#define USE_LAN8742A_ETHERNET false
- To use
W5x00
module/shield withEthernet2
library
#define WEBSOCKETS_USE_ETHERNET true
#define USE_ETHERNET_LIB false
#define USE_ETHERNET2_LIB true
#define USE_ETHERNET_LARGE_LIB false
#define USE_UIP_ETHERNET false
#define USE_LAN8742A_ETHERNET false
- To use
W5x00
module/shield withEthernetLarge
library
#define WEBSOCKETS_USE_ETHERNET true
#define USE_ETHERNET_LIB false
#define USE_ETHERNET2_LIB false
#define USE_ETHERNET_LARGE_LIB true
#define USE_UIP_ETHERNET false
#define USE_LAN8742A_ETHERNET false
#define WEBSOCKETS_USE_ETHERNET true
#define USE_UIP_ETHERNET true
#define USE_LAN8742A_ETHERNET false
#define USE_ETHERNET_LIB false
#define USE_ETHERNET2_LIB false
#define USE_ETHERNET_LARGE_LIB false
#define WEBSOCKETS_USE_ETHERNET true
#define USE_UIP_ETHERNET false
#define USE_LAN8742A_ETHERNET true
#define USE_ETHERNET_LIB false
#define USE_ETHERNET2_LIB false
#define USE_ETHERNET_LARGE_LIB false
#define WEBSOCKETS_USE_ETHERNET true
// Just select one to be true. If all is false, default is Ethernet.
// If more than one are true, the priority is USE_ETHERNET_LIB, USE_ETHERNET2_LIB, USE_ETHERNET_LARGE_LIB, USE_UIP_ETHERNET, USE_BUILTIN_ETHERNET
#define USE_ETHERNET_LIB false
#define USE_ETHERNET2_LIB false
#define USE_ETHERNET_LARGE_LIB false
#define USE_UIP_ETHERNET false
#define USE_LAN8742A_ETHERNET true
#if USE_ETHERNET_LIB
// Also default to Ethernet library
#include <Ethernet.h>
#define ETHERNET_TYPE "W5x00 and Ethernet Library"
#elif USE_ETHERNET2_LIB
#include <Ethernet2.h>
#define ETHERNET_TYPE "W5x00 and Ethernet2 Library"
#elif USE_ETHERNET_LARGE_LIB
#include <EthernetLarge.h>
#define ETHERNET_TYPE "W5x00 and EthernetLarge Library"
#elif USE_UIP_ETHERNET
#include <UIPEthernet.h>
#include <utility/logging.h>
#define ETHERNET_TYPE "ENC28J60 and UIPEthernet Library"
#elif USE_LAN8742A_ETHERNET
#define USE_BUILTIN_ETHERNET true
#include <LwIP.h>
#include <STM32Ethernet.h>
#define ETHERNET_TYPE "LAN8742A and STM32Ethernet Library"
#else
// Default to Ethernet library
#include <Ethernet.h>
#define ETHERNET_TYPE "W5x00 and Ethernet Library"
#endif
Default is using ESP8266/ESP32 native WiFi
. You don't need to do anything special.
- Esp32-Client
- Minimal-Esp32-Client
- Secured-Esp32-Client
- ESP32-Client_SINRIC
- Esp32-Server
- Esp32-RepeatingClient
- Esp32-AdvancedWebServer. New in v1.0.6+
- Esp8266-Client
- Minimal-Esp8266-Client
- Secured-Esp8266-Client
- SecuredTwoWay-Esp8266-Client
- ESP8266-Client_SINRIC
- Esp8266-Server
- Esp8266-RepeatingClient
- Esp8266-AdvancedWebServer. New in v1.0.6+
- nRF52-Client
- nRF52-Minimal-Client
- nRF52-Client_SINRIC
- nRF52-Server
- nRF52-RepeatingClient
- nRF52_ServerAllFunctionsDemo
- nRF52-AdvancedWebServer. New in v1.0.6+
- SAMD-Client
- SAMD-Minimal-Client
- SAMD-Client_SINRIC
- SAMD-Server
- SAMD-RepeatingClient
- SAMD_ServerAllFunctionsDemo
- SAMD-AdvancedWebServer. New in v1.0.6+
- STM32-Client
- STM32-Minimal-Client
- STM32-Client_SINRIC
- STM32-Server
- STM32-RepeatingClient
- STM32_ServerAllFunctionsDemo
- STM32-AdvancedWebServer. New in v1.0.6+
- nRF52-Ethernet-Client
- nRF52-Ethernet-Minimal-Client
- nRF52-Ethernet-Client_SINRIC
- nRF52-Ethernet-Server
- nRF52-Ethernet-RepeatingClient
- nRF52-Ethernet_ServerAllFunctionsDemo
- nRF52-Ethernet_AdvancedWebServer. New in v1.0.6+
- SAMD-Ethernet-Client
- SAMD-Ethernet-Minimal-Client
- SAMD-Ethernet-Client_SINRIC
- SAMD-Ethernet-Server
- SAMD-Ethernet-RepeatingClient
- SAMD-Ethernet_ServerAllFunctionsDemo
- SAMD-Ethernet_AdvancedWebServer. New in v1.0.6+
- SAMDUE-Ethernet-Client
- SAMDUE-Ethernet-Minimal-Client
- SAMDUE-Ethernet-Client_SINRIC
- SAMDUE-Ethernet-Server
- SAMDUE-Ethernet-RepeatingClient
- SAMDUE-Ethernet_ServerAllFunctionsDemo
- SAMDUE-Ethernet_AdvancedWebServer. New in v1.0.6+
- STM32-Ethernet-Client
- STM32-Ethernet-Minimal-Client
- STM32-Ethernet-Client_SINRIC
- STM32-Ethernet-Server
- STM32-Ethernet-RepeatingClient
- STM32-Ethernet_ServerAllFunctionsDemo
- STM32-Ethernet_AdvancedWebServer. New in v1.0.6+
Example SAMD-Client_SINRIC
Please take a look at other examples, as well.
1. File SAMD-Client_SINRIC.ino
#include "defines.h"
#define DEBUG_LOCAL 2
#include <WebSockets2_Generic.h>
#include <ArduinoJson.h> // https://arduinojson.org/ or install via Arduino library manager
using namespace websockets2_generic;
WebsocketsClient client;
#define HEARTBEAT_INTERVAL 300000 // 5 Minutes
bool isConnected = false;
uint64_t heartbeatTimestamp = 0;
uint64_t now = 0;
//To increase no of devices as needed
void turnOn(String deviceId)
{
if (deviceId == SINRIC_Device_ID_1) // Device ID of 1st device
{
#if (DEBUG_LOCAL > 1)
Serial.print("Turn on device id: ");
Serial.println(deviceId);
#endif
digitalWrite(LED_PIN, HIGH);
}
else
{
#if (DEBUG_LOCAL > 1)
Serial.print("Turn on for unknown device id: ");
Serial.println(deviceId);
#endif
}
}
//To increase no of devices as needed
void turnOff(String deviceId)
{
if (deviceId == SINRIC_Device_ID_1) // Device ID of 1st device
{
#if (DEBUG_LOCAL > 1)
Serial.print("Turn off Device ID: ");
Serial.println(deviceId);
#endif
digitalWrite(LED_PIN, LOW);
}
else
{
#if (DEBUG_LOCAL > 1)
Serial.print("Turn off for unknown device id: ");
Serial.println(deviceId);
#endif
}
}
void onEventsCallback(WebsocketsEvent event, String data)
{
if (event == WebsocketsEvent::ConnectionOpened)
{
if (!isConnected)
isConnected = true;
Serial.println("Connnection Opened");
}
else if (event == WebsocketsEvent::ConnectionClosed)
{
if (isConnected)
isConnected = false;
Serial.println("Connnection Closed");
}
else if (event == WebsocketsEvent::GotPing)
{
if (!isConnected)
isConnected = true;
Serial.println("Got a Ping!");
}
else if (event == WebsocketsEvent::GotPong)
{
if (!isConnected)
isConnected = true;
Serial.println("Got a Pong!");
}
}
void onMessagesCallback(WebsocketsMessage message)
{
String SINRIC_message = message.data();
Serial.print("Got Message: ");
Serial.println(SINRIC_message /*message.data()*/);
// Example payloads
// For Switch or Light device types
// {"deviceId": xxxx, "action": "setPowerState", value: "ON"} // https://developer.amazon.com/docs/device-apis/alexa-powercontroller.html
// For Light device type
// Look at the light example in github
#if (ARDUINOJSON_VERSION_MAJOR >= 6)
DynamicJsonDocument json(1024);
//auto deserializeError = deserializeJson(json, (char*)message.data());
auto deserializeError = deserializeJson(json, SINRIC_message);
if ( deserializeError )
{
Serial.println("JSON parseObject() failed");
return;
}
//serializeJson(json, Serial);
#else
DynamicJsonBuffer jsonBuffer;
// Parse JSON string
JsonObject& json = jsonBuffer.parseObject(SINRIC_message);
// Test if parsing succeeds.
if (!json.success())
{
Serial.println("JSON parseObject() failed");
return;
}
#endif
String deviceId = json ["deviceId"];
String action = json ["action"];
if (action == "setPowerState")
{
// Switch or Light
String value = json ["value"];
if (value == "ON")
{
turnOn(deviceId);
}
else
{
turnOff(deviceId);
}
}
}
void setup()
{
pinMode(LED_PIN, OUTPUT);
digitalWrite(LED_PIN, LOW);
Serial.begin(115200);
while (!Serial);
Serial.println("\nStarting WebSockets2_Generic SAMD-Client_SINRIC with WiFiNINA on " + String(BOARD_NAME));
// check for the WiFi module:
if (WiFi.status() == WL_NO_MODULE)
{
Serial.println("Communication with WiFi module failed!");
// don't continue
return;
}
String fv = WiFi.firmwareVersion();
if (fv < WIFI_FIRMWARE_LATEST_VERSION)
{
Serial.println("Please upgrade the firmware");
}
Serial.print("Attempting to connect to SSID: ");
Serial.println(ssid);
// Connect to wifi
WiFi.begin(ssid, password);
// Wait some time to connect to wifi
for (int i = 0; i < 10 && WiFi.status() != WL_CONNECTED; i++)
{
Serial.print(".");
delay(1000);
}
if (WiFi.status() == WL_CONNECTED)
{
Serial.print("Connected to Wifi, IP address: ");
Serial.println(WiFi.localIP());
Serial.print("Connecting to WebSockets Server @");
Serial.println(websockets_server_host);
}
else
{
Serial.println("\nNo WiFi");
return;
}
// run callback when events are occuring
client.onMessage(onMessagesCallback);
// try to connect to Websockets server
client.addHeader("apikey", SINRIC_API_KEY);
client.setAuthorization("apikey", SINRIC_API_KEY);
bool connected = client.connect(websockets_server_host, websockets_server_port, "/");
if (connected)
{
Serial.println("Connected!");
}
else
{
Serial.println("Not Connected!");
}
}
void loop()
{
// let the websockets client check for incoming messages
if (client.available())
{
client.poll();
now = millis();
// Send heartbeat in order to avoid disconnections during ISP resetting IPs over night. Thanks @MacSass
if ((now - heartbeatTimestamp) > HEARTBEAT_INTERVAL)
{
heartbeatTimestamp = now;
client.send("H");
}
}
}
2. File defines.h
#ifndef defines_h
#define defines_h
#if ( defined(ARDUINO_SAMD_ZERO) || defined(ARDUINO_SAMD_MKR1000) || defined(ARDUINO_SAMD_MKRWIFI1010) \
|| defined(ARDUINO_SAMD_NANO_33_IOT) || defined(ARDUINO_SAMD_MKRFox1200) || defined(ARDUINO_SAMD_MKRWAN1300) || defined(ARDUINO_SAMD_MKRWAN1310) \
|| defined(ARDUINO_SAMD_MKRGSM1400) || defined(ARDUINO_SAMD_MKRNB1500) || defined(ARDUINO_SAMD_MKRVIDOR4000) || defined(__SAMD21G18A__) \
|| defined(ARDUINO_SAMD_CIRCUITPLAYGROUND_EXPRESS) || defined(__SAMD21E18A__) || defined(__SAMD51__) || defined(__SAMD51J20A__) || defined(__SAMD51J19A__) \
|| defined(__SAMD51G19A__) || defined(__SAMD51P19A__) || defined(__SAMD21G18A__) )
#if defined(WEBSOCKETS_WIFININA_USE_SAMD)
#undef WEBSOCKETS_WIFININA_USE_SAMD
#endif
#define WEBSOCKETS_USE_WIFININA true
#define WEBSOCKETS_WIFININA_USE_SAMD true
#else
#error This code is intended to run only on the SAMD boards ! Please check your Tools->Board setting.
#endif
#if defined(WEBSOCKETS_WIFININA_USE_SAMD)
#if defined(ARDUINO_SAMD_ZERO)
#define BOARD_TYPE "SAMD Zero"
#elif defined(ARDUINO_SAMD_MKR1000)
#define BOARD_TYPE "SAMD MKR1000"
#elif defined(ARDUINO_SAMD_MKRWIFI1010)
#define BOARD_TYPE "SAMD MKRWIFI1010"
#elif defined(ARDUINO_SAMD_NANO_33_IOT)
#define BOARD_TYPE "SAMD NANO_33_IOT"
#elif defined(ARDUINO_SAMD_MKRFox1200)
#define BOARD_TYPE "SAMD MKRFox1200"
#elif ( defined(ARDUINO_SAMD_MKRWAN1300) || defined(ARDUINO_SAMD_MKRWAN1310) )
#define BOARD_TYPE "SAMD MKRWAN13X0"
#elif defined(ARDUINO_SAMD_MKRGSM1400)
#define BOARD_TYPE "SAMD MKRGSM1400"
#elif defined(ARDUINO_SAMD_MKRNB1500)
#define BOARD_TYPE "SAMD MKRNB1500"
#elif defined(ARDUINO_SAMD_MKRVIDOR4000)
#define BOARD_TYPE "SAMD MKRVIDOR4000"
#elif defined(ARDUINO_SAMD_CIRCUITPLAYGROUND_EXPRESS)
#define BOARD_TYPE "SAMD ARDUINO_SAMD_CIRCUITPLAYGROUND_EXPRESS"
#elif defined(ADAFRUIT_FEATHER_M0_EXPRESS)
#define BOARD_TYPE "SAMD21 ADAFRUIT_FEATHER_M0_EXPRESS"
#elif defined(ADAFRUIT_METRO_M0_EXPRESS)
#define BOARD_TYPE "SAMD21 ADAFRUIT_METRO_M0_EXPRESS"
#elif defined(ADAFRUIT_CIRCUITPLAYGROUND_M0)
#define BOARD_TYPE "SAMD21 ADAFRUIT_CIRCUITPLAYGROUND_M0"
#elif defined(ADAFRUIT_GEMMA_M0)
#define BOARD_TYPE "SAMD21 ADAFRUIT_GEMMA_M0"
#elif defined(ADAFRUIT_TRINKET_M0)
#define BOARD_TYPE "SAMD21 ADAFRUIT_TRINKET_M0"
#elif defined(ADAFRUIT_ITSYBITSY_M0)
#define BOARD_TYPE "SAMD21 ADAFRUIT_ITSYBITSY_M0"
#elif defined(ARDUINO_SAMD_HALLOWING_M0)
#define BOARD_TYPE "SAMD21 ARDUINO_SAMD_HALLOWING_M0"
#elif defined(ADAFRUIT_METRO_M4_EXPRESS)
#define BOARD_TYPE "SAMD51 ADAFRUIT_METRO_M4_EXPRESS"
#elif defined(ADAFRUIT_GRAND_CENTRAL_M4)
#define BOARD_TYPE "SAMD51 ADAFRUIT_GRAND_CENTRAL_M4"
#elif defined(ADAFRUIT_FEATHER_M4_EXPRESS)
#define BOARD_TYPE "SAMD51 ADAFRUIT_FEATHER_M4_EXPRESS"
#elif defined(ADAFRUIT_ITSYBITSY_M4_EXPRESS)
#define BOARD_TYPE "SAMD51 ADAFRUIT_ITSYBITSY_M4_EXPRESS"
#elif defined(ADAFRUIT_TRELLIS_M4_EXPRESS)
#define BOARD_TYPE "SAMD51 ADAFRUIT_TRELLIS_M4_EXPRESS"
#elif defined(ADAFRUIT_PYPORTAL)
#define BOARD_TYPE "SAMD51 ADAFRUIT_PYPORTAL"
#elif defined(ADAFRUIT_PYPORTAL_M4_TITANO)
#define BOARD_TYPE "SAMD51 ADAFRUIT_PYPORTAL_M4_TITANO"
#elif defined(ADAFRUIT_PYBADGE_M4_EXPRESS)
#define BOARD_TYPE "SAMD51 ADAFRUIT_PYBADGE_M4_EXPRESS"
#elif defined(ADAFRUIT_METRO_M4_AIRLIFT_LITE)
#define BOARD_TYPE "SAMD51 ADAFRUIT_METRO_M4_AIRLIFT_LITE"
#elif defined(ADAFRUIT_PYGAMER_M4_EXPRESS)
#define BOARD_TYPE "SAMD51 ADAFRUIT_PYGAMER_M4_EXPRESS"
#elif defined(ADAFRUIT_PYGAMER_ADVANCE_M4_EXPRESS)
#define BOARD_TYPE "SAMD51 ADAFRUIT_PYGAMER_ADVANCE_M4_EXPRESS"
#elif defined(ADAFRUIT_PYBADGE_AIRLIFT_M4)
#define BOARD_TYPE "SAMD51 ADAFRUIT_PYBADGE_AIRLIFT_M4"
#elif defined(ADAFRUIT_MONSTER_M4SK_EXPRESS)
#define BOARD_TYPE "SAMD51 ADAFRUIT_MONSTER_M4SK_EXPRESS"
#elif defined(ADAFRUIT_HALLOWING_M4_EXPRESS)
#define BOARD_TYPE "SAMD51 ADAFRUIT_HALLOWING_M4_EXPRESS"
#elif defined(SEEED_WIO_TERMINAL)
#define BOARD_TYPE "SAMD SEEED_WIO_TERMINAL"
#elif defined(SEEED_FEMTO_M0)
#define BOARD_TYPE "SAMD SEEED_FEMTO_M0"
#elif defined(SEEED_XIAO_M0)
#define BOARD_TYPE "SAMD SEEED_XIAO_M0"
#elif defined(Wio_Lite_MG126)
#define BOARD_TYPE "SAMD SEEED Wio_Lite_MG126"
#elif defined(WIO_GPS_BOARD)
#define BOARD_TYPE "SAMD SEEED WIO_GPS_BOARD"
#elif defined(SEEEDUINO_ZERO)
#define BOARD_TYPE "SAMD SEEEDUINO_ZERO"
#elif defined(SEEEDUINO_LORAWAN)
#define BOARD_TYPE "SAMD SEEEDUINO_LORAWAN"
#elif defined(SEEED_GROVE_UI_WIRELESS)
#define BOARD_TYPE "SAMD SEEED_GROVE_UI_WIRELESS"
#elif defined(__SAMD21E18A__)
#define BOARD_TYPE "SAMD21E18A"
#elif defined(__SAMD21G18A__)
#define BOARD_TYPE "SAMD21G18A"
#elif defined(__SAMD51G19A__)
#define BOARD_TYPE "SAMD51G19A"
#elif defined(__SAMD51J19A__)
#define BOARD_TYPE "SAMD51J19A"
#elif defined(__SAMD51J20A__)
#define BOARD_TYPE "SAMD51J20A"
#elif defined(__SAM3X8E__)
#define BOARD_TYPE "SAM3X8E"
#elif defined(__CPU_ARC__)
#define BOARD_TYPE "CPU_ARC"
#elif defined(__SAMD51__)
#define BOARD_TYPE "SAMD51"
#else
#define BOARD_TYPE "SAMD Unknown"
#endif
#endif
#ifndef BOARD_NAME
#define BOARD_NAME BOARD_TYPE
#endif
#include <WiFiNINA_Generic.h>
#define DEBUG_WEBSOCKETS_PORT Serial
// Debug Level from 0 to 4
#define _WEBSOCKETS_LOGLEVEL_ 3
const char* ssid = "ssid"; //Enter SSID
const char* password = "password"; //Enter Password
#define SINRIC_WEBSERVER "iot.sinric.com"
#define SINRIC_WEBSERVER_PORT 80
#define SINRIC_API_KEY "11111111-2222-3333-4444-555555555555"
#define SINRIC_Device_ID_1 "012345678901234567890123" // Device ID, got from Sinric
const char* websockets_server_host = SINRIC_WEBSERVER; //Enter server address
const uint16_t websockets_server_port = SINRIC_WEBSERVER_PORT; // Enter server port
#ifdef LED_BUILTIN
#define LED_PIN LED_BUILTIN
#else
#define LED_PIN 13
#endif
#endif //defines_h
This is the terminal output when running SAMD-Client_SINRIC example on Nano-33 IoT:
Starting WebSockets2_Generic SAMD-Client_SINRIC with WiFiNINA on SAMD NANO_33_IOT
WiFi-begin: return1 = 3
WiFi-begin: return2 = 3
Connected to Wifi, Connecting to WebSockets Server @iot.sinric.com
[WS] WebsocketsClient::generateHandshake: base64Authorization = ***************
[WS] WebsocketsClient::generateHandshake: handshake = GET / HTTP/1.1
Host: iot.sinric.com
Sec-WebSocket-Key: *********
apikey: 11111111-2222-3333-4444-555555555555
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Version: 13
User-Agent: TinyWebsockets Client
Authorization: Basic ***************
Origin: https://github.com/khoih-prog/Websockets2_Generic
[WS] WebsocketsClient::generateHandshake: key = Server
[WS] WebsocketsClient::generateHandshake: value = nginx/1.10.3 (Ubuntu)
[WS] WebsocketsClient::generateHandshake: key = Date
[WS] WebsocketsClient::generateHandshake: value = Tue, 14 Jul 2020 02:27:30 GMT
[WS] WebsocketsClient::generateHandshake: key = Connection
[WS] WebsocketsClient::generateHandshake: value = upgrade
[WS] WebsocketsClient::generateHandshake: key = Upgrade
[WS] WebsocketsClient::generateHandshake: value = websocket
[WS] WebsocketsClient::generateHandshake: key = Sec-WebSocket-Accept
[WS] WebsocketsClient::generateHandshake: value = *********
Connected!
Got Message: {"deviceId":"012345678901234567890123","action":"setPowerState","value":"ON"}
Turn on device id: 012345678901234567890123
Got Message: {"deviceId":"012345678901234567890123","action":"setPowerState","value":"OFF"}
Turn off Device ID: 012345678901234567890123
For binary data it is recommended to use msg.rawData()
which returns a std::string
, or msg.c_str()
which returns a const char*
.
The reason is that msg.data()
returns an Arduino String
, which is great for Serial printing and very basic memory handling but bad for most binary usages.
See issue #32 for further information.
No matter what board you are using, in order to use WSS (websockets over SSL) you need to use
client.connect("wss://your-secured-server-ip:port/uri");
The next sections describe board-specific code for using WSS with the library.
With the esp8266 there are multiple ways for using WSS. By default, ArduinoWebsockets
does not validate the certificate chain. This can be set explicitly using:
client.setInsecure();
You can also use a SSL Fingerprint
to validate the SSL connection, for example:
const char ssl_fingerprint[] PROGMEM = "D5 07 4D 79 B2 D2 53 D7 74 E6 1B 46 C5 86 4E FE AD 00 F1 98";
client.setFingerprint(ssl_fingerprint);
or you could use the setKnownKey()
method to specify the public key of a certificate in order to validate the server you are connecting to.
PublicKey *publicKey = new PublicKey(public_key);
client.setKnownKey(publicKey);
or you can specify the Certificate Authority (CA) using setTrustAnchors
method, as follows:
X509List *serverTrustedCA = new X509List(ca_cert);
client.setTrustAnchors(serverTrustedCA);
For client-side certificate validation, you can use RSA or EC certificates, using the method setClientRSACert
or setClientECCert
.
With the ESP32 you could either provide the full certificate, or provide no certificate. An example for setting CA Certificate:
const char ssl_ca_cert[] PROGMEM = \
"-----BEGIN CERTIFICATE-----\n" \
"MIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/\n" \
"MSQwIgYDVQQKExtEaWdpdGFsIFNpZ25hdHVyZSBUcnVzdCBDby4xFzAVBgNVBAMT\n" \
"DkRTVCBSb290IENBIFgzMB4XDTE2MDMxNzE2NDA0NloXDTIxMDMxNzE2NDA0Nlow\n" \
"SjELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUxldCdzIEVuY3J5cHQxIzAhBgNVBAMT\n" \
"GkxldCdzIEVuY3J5cHQgQXV0aG9yaXR5IFgzMIIBIjANBgkqhkiG9w0BAQEFAAOC\n" \
"AQ8AMIIBCgKCAQEAnNMM8FrlLke3cl03g7NoYzDq1zUmGSXhvb418XCSL7e4S0EF\n" \
"q6meNQhY7LEqxGiHC6PjdeTm86dicbp5gWAf15Gan/PQeGdxyGkOlZHP/uaZ6WA8\n" \
"SMx+yk13EiSdRxta67nsHjcAHJyse6cF6s5K671B5TaYucv9bTyWaN8jKkKQDIZ0\n" \
"Z8h/pZq4UmEUEz9l6YKHy9v6Dlb2honzhT+Xhq+w3Brvaw2VFn3EK6BlspkENnWA\n" \
"a6xK8xuQSXgvopZPKiAlKQTGdMDQMc2PMTiVFrqoM7hD8bEfwzB/onkxEz0tNvjj\n" \
"/PIzark5McWvxI0NHWQWM6r6hCm21AvA2H3DkwIDAQABo4IBfTCCAXkwEgYDVR0T\n" \
"AQH/BAgwBgEB/wIBADAOBgNVHQ8BAf8EBAMCAYYwfwYIKwYBBQUHAQEEczBxMDIG\n" \
"CCsGAQUFBzABhiZodHRwOi8vaXNyZy50cnVzdGlkLm9jc3AuaWRlbnRydXN0LmNv\n" \
"bTA7BggrBgEFBQcwAoYvaHR0cDovL2FwcHMuaWRlbnRydXN0LmNvbS9yb290cy9k\n" \
"c3Ryb290Y2F4My5wN2MwHwYDVR0jBBgwFoAUxKexpHsscfrb4UuQdf/EFWCFiRAw\n" \
"VAYDVR0gBE0wSzAIBgZngQwBAgEwPwYLKwYBBAGC3xMBAQEwMDAuBggrBgEFBQcC\n" \
"ARYiaHR0cDovL2Nwcy5yb290LXgxLmxldHNlbmNyeXB0Lm9yZzA8BgNVHR8ENTAz\n" \
"MDGgL6AthitodHRwOi8vY3JsLmlkZW50cnVzdC5jb20vRFNUUk9PVENBWDNDUkwu\n" \
"Y3JsMB0GA1UdDgQWBBSoSmpjBH3duubRObemRWXv86jsoTANBgkqhkiG9w0BAQsF\n" \
"AAOCAQEA3TPXEfNjWDjdGBX7CVW+dla5cEilaUcne8IkCJLxWh9KEik3JHRRHGJo\n" \
"uM2VcGfl96S8TihRzZvoroed6ti6WqEBmtzw3Wodatg+VyOeph4EYpr/1wXKtx8/\n" \
"wApIvJSwtmVi4MFU5aMqrSDE6ea73Mj2tcMyo5jMd6jmeWUHK8so/joWUoHOUgwu\n" \
"X4Po1QYz+3dszkDqMp4fklxBwXRsW10KXzPMTZ+sOPAveyxindmjkW8lGy+QsRlG\n" \
"PfZ+G6Z6h7mjem0Y+iWlkYcV4PIWL1iwBi8saCbGS5jN2p8M+X+Q7UNKEkROb3N6\n" \
"KOqkqm57TH2H3eDJAkSnh6/DNFu0Qg==\n" \
"-----END CERTIFICATE-----\n";
client.setCACert(ssl_ca_cert);
- This is terminal debug output when running SAMD-Ethernet-Client_SINRIC on SAMD51 Adafruit Itsy-Bitsy M4 Express using ENC28J60 Ethernet module.
Starting WebSockets2_Generic SAMD-Ethernet-Client_SINRIC on SAMD ADAFRUIT_ITSYBITSY_M4_EXPRESS
Ethernet using ENC28J60 and UIPEthernet Library
[SETUP] BOOT WAIT 4
[SETUP] BOOT WAIT 3
[SETUP] BOOT WAIT 2
[SETUP] BOOT WAIT 1
ENC28J60_CONTROL_CS =16
SS =16
SPI_MOSI =25
SPI_MISO =23
SPI_SCK =24
WebSockets Client IP address: 192.168.2.137
Connecting to WebSockets Server @iot.sinric.com
[WS] WebsocketsClient::generateHandshake: base64Authorization = ********
[WS] WebsocketsClient::generateHandshake: handshake = GET / HTTP/1.1
Host: iot.sinric.com
Sec-WebSocket-Key: ********
apikey: 11111111-2222-3333-4444-555555555555
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Version: 13
User-Agent: TinyWebsockets Client
Authorization: Basic ********
Origin: https://github.com/khoih-prog/Websockets2_Generic
[WS] WebsocketsClient::connect: base64Authorization = ********
[WS] WebsocketsClient::doestStartsWith: str = HTTP/1.1 101 Switching Protocols
[WS] WebsocketsClient::doestStartsWith: prefix = HTTP/1.1 101
[WS] WebsocketsClient::generateHandshake: key = Server
[WS] WebsocketsClient::generateHandshake: value = nginx/1.10.3 (Ubuntu)
[WS] WebsocketsClient::generateHandshake: key = Date
[WS] WebsocketsClient::generateHandshake: value = Fri, 17 Jul 2020 00:04:17 GMT
[WS] WebsocketsClient::generateHandshake: key = Connection
[WS] WebsocketsClient::generateHandshake: value = upgrade
[WS] WebsocketsClient::generateHandshake: key = Upgrade
[WS] WebsocketsClient::generateHandshake: value = websocket
[WS] WebsocketsClient::generateHandshake: key = Sec-WebSocket-Accept
[WS] WebsocketsClient::generateHandshake: value = ********
Connected!
Got Message: {"deviceId":"012345678901234567890123","action":"setPowerState","value":"ON"}
Turn on device id: 012345678901234567890123
Got Message: {"deviceId":"012345678901234567890123","action":"setPowerState","value":"OFF"}
Turn off Device ID: 012345678901234567890123
- This is terminal debug output when running SAMDUE-Ethernet-Server on SAM DUE board with Ethernet W5100 shield using EthernetLarge library, and receiving WebSockets connection from an ESP8266 board.
Starting WebSockets2_Generic SAMDUE-Ethernet-Server on SAM DUE
Ethernet using W5x00 and EthernetLarge Library
[SETUP] BOOT WAIT 4
[SETUP] BOOT WAIT 3
[SETUP] BOOT WAIT 2
[SETUP] BOOT WAIT 1
W5100 init, using SS_PIN_DEFAULT = 10, new ss_pin = 10, W5100Class::ss_pin = 10
W5100::init: W5100, SSIZE =4096
WebSockets Server Running and Ready on SAM DUE
IP address: 192.168.2.153, Port: 8080
H[WS] WebsocketsServer::recvHandshakeRequest: value = 192.168.2.153
[WS] WebsocketsServer::recvHandshakeRequest: value = ********
[WS] WebsocketsServer::recvHandshakeRequest: value = websocket
[WS] WebsocketsServer::recvHandshakeRequest: value = Upgrade
[WS] WebsocketsServer::recvHandshakeRequest: value = 13
[WS] WebsocketsServer::recvHandshakeRequest: value = TinyWebsockets Client
[WS] WebsocketsServer::recvHandshakeRequest: value = Basic
[WS] WebsocketsServer::recvHandshakeRequest: value = https://github.com/khoih-prog/Websockets2_Generic
Got Message: Hello to Server from ESP8266
[WS] WebsocketsServer::recvHandshakeRequest: value = 192.168.2.153
[WS] WebsocketsServer::recvHandshakeRequest: value = ********
[WS] WebsocketsServer::recvHandshakeRequest: value = websocket
[WS] WebsocketsServer::recvHandshakeRequest: value = Upgrade
[WS] WebsocketsServer::recvHandshakeRequest: value = 13
[WS] WebsocketsServer::recvHandshakeRequest: value = TinyWebsockets Client
[WS] WebsocketsServer::recvHandshakeRequest: value = Basic
[WS] WebsocketsServer::recvHandshakeRequest: value = https://github.com/khoih-prog/Websockets2_Generic
Got Message: Hello to Server from ESP8266
HHHHHHHHH
- This is terminal debug output when running nRF52-Ethernet-Server on Adafruit nRF52840 Itsy-Bitsy Express board with Ethernet ENC28J60 shield using UIPEthernet library, and receiving WebSockets connection from an ESP8266 board.
Starting WebSockets2_Generic nRF52-Ethernet-Server on NRF52840_ITSYBITSY_EXPRESS
Ethernet using ENC28J60 and UIPEthernet Library
[SETUP] BOOT WAIT 4
[SETUP] BOOT WAIT 3
[SETUP] BOOT WAIT 2
[SETUP] BOOT WAIT 1
ENC28J60_CONTROL_CS =10
SS =5
SPI_MOSI =24
SPI_MISO =23
SPI_SCK =25
WebSockets Server Running and Ready on NRF52840_ITSYBITSY_EXPRESS
IP address: 192.168.2.95, Port: 8080
H[WS] WebsocketsServer::recvHandshakeRequest: value = 192.168.2.95
[WS] WebsocketsServer::recvHandshakeRequest: value = ********
[WS] WebsocketsServer::recvHandshakeRequest: value = websocket
[WS] WebsocketsServer::recvHandshakeRequest: value = Upgrade
[WS] WebsocketsServer::recvHandshakeRequest: value = 13
[WS] WebsocketsServer::recvHandshakeRequest: value = TinyWebsockets Client
[WS] WebsocketsServer::recvHandshakeRequest: value = Basic
[WS] WebsocketsServer::recvHandshakeRequest: value = https://github.com/khoih-prog/Websockets2_Generic
Got Message: Hello to Server from ESP8266
[WS] WebsocketsServer::recvHandshakeRequest: value = 192.168.2.95
[WS] WebsocketsServer::recvHandshakeRequest: value = ********
[WS] WebsocketsServer::recvHandshakeRequest: value = websocket
[WS] WebsocketsServer::recvHandshakeRequest: value = Upgrade
[WS] WebsocketsServer::recvHandshakeRequest: value = 13
[WS] WebsocketsServer::recvHandshakeRequest: value = TinyWebsockets Client
[WS] WebsocketsServer::recvHandshakeRequest: value = Basic
[WS] WebsocketsServer::recvHandshakeRequest: value = https://github.com/khoih-prog/Websockets2_Generic
Got Message: Hello to Server from ESP8266
HHHHHHHHH
- This is terminal debug output when running STM32-Ethernet-Client_SINRIC on Nucleo-144 NUCLEO_F767ZI board with built-in Ethernet LAN8742A using STMEthernet library.
Starting WebSockets2_Generic STM32-Ethernet-Client_SINRIC on NUCLEO_F767ZI
Ethernet using LAN8742A and STM32Ethernet Library
[SETUP] BOOT WAIT 4
[SETUP] BOOT WAIT 3
[SETUP] BOOT WAIT 2
[SETUP] BOOT WAIT 1
WebSockets Client IP address: 192.168.2.135
Connecting to WebSockets Server @iot.sinric.com
[WS] WebsocketsClient::generateHandshake: base64Authorization = ********
[WS] WebsocketsClient::generateHandshake: handshake = GET / HTTP/1.1
Host: iot.sinric.com
Sec-WebSocket-Key: ********
apikey: 11111111-2222-3333-4444-555555555555
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Version: 13
User-Agent: TinyWebsockets Client
Authorization: Basic ********
Origin: https://github.com/khoih-prog/Websockets2_Generic
[WS] WebsocketsClient::connect: base64Authorization = ********
[WS] WebsocketsClient::doestStartsWith: str = HTTP/1.1 101 Switching Protocols
[WS] WebsocketsClient::doestStartsWith: prefix = HTTP/1.1 101
[WS] WebsocketsClient::generateHandshake: key = Server
[WS] WebsocketsClient::generateHandshake: value = nginx/1.10.3 (Ubuntu)
[WS] WebsocketsClient::generateHandshake: key = Date
[WS] WebsocketsClient::generateHandshake: value = Sat, 18 Jul 2020 06:42:54 GMT
[WS] WebsocketsClient::generateHandshake: key = Connection
[WS] WebsocketsClient::generateHandshake: value = upgrade
[WS] WebsocketsClient::generateHandshake: key = Upgrade
[WS] WebsocketsClient::generateHandshake: value = websocket
[WS] WebsocketsClient::generateHandshake: key = Sec-WebSocket-Accept
[WS] WebsocketsClient::generateHandshake: value = ********
Connected!
Got Message: {"deviceId":"012345678901234567890123","action":"setPowerState","value":"ON"}
Turn on device id: 012345678901234567890123
Got Message: {"deviceId":"012345678901234567890123","action":"setPowerState","value":"OFF"}
Turn off Device ID: 012345678901234567890123
- This is the terminal debug output when running SAMDUE-Ethernet_ServerAllFunctionsDemo example on SAM DUE and W5100 Ethernet. There are 3 WebSockets Clients connecting to the WebSockets Server:
- ESP32 running Esp32-RepeatingClient
- ESP8266 running Esp8266-RepeatingClient
- STM32 Nucleo-144 NUCLEO_F767ZI running STM32-Ethernet-RepeatingClient
Start Generic_WebSocketServerAllFunctionsDemo_W5500
[SETUP] BOOT WAIT 4
[SETUP] BOOT WAIT 3
[SETUP] BOOT WAIT 2
[SETUP] BOOT WAIT 1
W5100 init, using SS_PIN_DEFAULT = 10, new ss_pin = 10, W5100Class::ss_pin = 10
W5100::init: W5100, SSIZE =4096
WebSockets Server IP address: 192.168.2.95
WebSockets Server Running and Ready on SAM DUE
IP address: 192.168.2.95, Port: 8080
[WS] WebsocketsServer::recvHandshakeRequest: value = 192.168.2.95
[WS] WebsocketsServer::recvHandshakeRequest: value = MDEyMzQ1Njc4OWFiY2RlZg==
[WS] WebsocketsServer::recvHandshakeRequest: value = websocket
[WS] WebsocketsServer::recvHandshakeRequest: value = Upgrade
[WS] WebsocketsServer::recvHandshakeRequest: value = 13
[WS] WebsocketsServer::recvHandshakeRequest: value = TinyWebsockets Client
[WS] WebsocketsServer::recvHandshakeRequest: value = Basic
[WS] WebsocketsServer::recvHandshakeRequest: value = https://github.com/khoih-prog/Websockets2_Generic
Got Message: Hello to Server from ESP8266
[WS] WebsocketsServer::recvHandshakeRequest: value = 192.168.2.95
[WS] WebsocketsServer::recvHandshakeRequest: value = MDEyMzQ1Njc4OWFiY2RlZg==
[WS] WebsocketsServer::recvHandshakeRequest: value = websocket
[WS] WebsocketsServer::recvHandshakeRequest: value = Upgrade
[WS] WebsocketsServer::recvHandshakeRequest: value = 13
[WS] WebsocketsServer::recvHandshakeRequest: value = TinyWebsockets Client
[WS] WebsocketsServer::recvHandshakeRequest: value = Basic
[WS] WebsocketsServer::recvHandshakeRequest: value = https://github.com/khoih-prog/Websockets2_Generic
Got Message: Hello to Server from ESP8266
[WS] WebsocketsServer::recvHandshakeRequest: value = 192.168.2.95
[WS] WebsocketsServer::recvHandshakeRequest: value = MDEyMzQ1Njc4OWFiY2RlZg==
[WS] WebsocketsServer::recvHandshakeRequest: value = websocket
[WS] WebsocketsServer::recvHandshakeRequest: value = Upgrade
[WS] WebsocketsServer::recvHandshakeRequest: value = 13
[WS] WebsocketsServer::recvHandshakeRequest: value = TinyWebsockets Client
[WS] WebsocketsServer::recvHandshakeRequest: value = Basic
[WS] WebsocketsServer::recvHandshakeRequest: value = https://github.com/khoih-prog/Websockets2_Generic
Got Message: Hello to Server from ESP32
[WS] WebsocketsServer::recvHandshakeRequest: value = 192.168.2.95
[WS] WebsocketsServer::recvHandshakeRequest: value = MDEyMzQ1Njc4OWFiY2RlZg==
[WS] WebsocketsServer::recvHandshakeRequest: value = websocket
[WS] WebsocketsServer::recvHandshakeRequest: value = Upgrade
[WS] WebsocketsServer::recvHandshakeRequest: value = 13
[WS] WebsocketsServer::recvHandshakeRequest: value = TinyWebsockets Client
[WS] WebsocketsServer::recvHandshakeRequest: value = Basic
[WS] WebsocketsServer::recvHandshakeRequest: value = https://github.com/khoih-prog/Websockets2_Generic
Got Message: Hello to Server from NUCLEO_F767ZI
[WS] WebsocketsServer::recvHandshakeRequest: value = 192.168.2.95
[WS] WebsocketsServer::recvHandshakeRequest: value = MDEyMzQ1Njc4OWFiY2RlZg==
[WS] WebsocketsServer::recvHandshakeRequest: value = websocket
[WS] WebsocketsServer::recvHandshakeRequest: value = Upgrade
[WS] WebsocketsServer::recvHandshakeRequest: value = 13
[WS] WebsocketsServer::recvHandshakeRequest: value = TinyWebsockets Client
[WS] WebsocketsServer::recvHandshakeRequest: value = Basic
[WS] WebsocketsServer::recvHandshakeRequest: value = https://github.com/khoih-prog/Websockets2_Generic
Got Message: Hello to Server from ESP32
...
- This is the screenshot when running STM32-Ethernet_AdvancedWebServer example on STM32F7 Nucleo-144 F767ZI and built-in LAN8742A Ethernet to demonstrate the new non-blocking feature of WebSockets Server enabling WebServer and WebSockets Server to run concurrently.
- This is the screenshot when running SAMD-AdvancedWebServer example on Arduino SAMD21 Nano-33-IoT and built-in WiFiNINA to demonstrate the new non-blocking feature of WebSockets Server enabling WebServer and WebSockets Server to run concurrently.
Debug is enabled by default on Serial. Debug Level from 0 to 4. To disable, change the WEBSOCKETS_LOGLEVEL to 0
// Use this to output debug msgs to Serial
#define DEBUG_WEBSOCKETS_PORT Serial
// Use this to disable all output debug msgs
//#define DEBUG_WEBSOCKETS_PORT
// Debug Level from 0 to 4
#define _WEBSOCKETS_LOGLEVEL_ 3
- Support more boards (Teensy, etc.)
- Support ESP8266/ESP32-AT shields.
- Add SSL support to SAMD21/SAMD51 and nRF52 using WiFiNINA.
- Support more non-compatible Ethernet Libraries such as Ethernet_Shield_W5200, EtherCard, EtherSia
- Add mDNS features.
- Add support to Arduino SAMD21 (ZERO, MKR, NANO_33_IOT, etc.)
- Add support to Adafruit SAMD21 (Itsy-Bitsy M0, Metro M0, Feather M0 Express, etc.).
- Add support to Adafruit SAMD51 (Itsy-Bitsy M4, Metro M4, Grand Central M4, Feather M4 Express, etc.).
- Add support to Adafruit nRF52 ( Feather nRF52832, nRF52840 Express, BlueFruit Sense, Itsy-Bitsy nRF52840 Express, Metro nRF52840 Express, NINA_B302_ublox, NINA_B112_ublox, etc..
- Add support to WiFiNINA using
WiFiNINA_Generic library
. - Add support to
SINRIC
- Split each example into several manageable files.
- Add support to SAM DUE.
- Add support to Ethernet W5x00, using either
Ethernet
,Ethernet2
orEthernetLarge
library - Add support to Ethernet ENC28J60, using
UIPEthernet
library - Add support to STM32F/L/H/G/WB/MP1.
- Add support to Ethernet LAN8742A, using
STM32Ethernet library
andSTM32duino_LwIP library
. - Add support to Seeeduino SAMD21/SAMD51: LoRaWAN, Zero, Femto M0, XIAO M0, Wio GPS Board, Wio Terminal, Grove UI Wireless, etc.
- Add non-blocking WebSockets Server feature to enable WS Server and WebServer running concurrently
- Add non-blocking WebSockets Server feature to enable WS Server and WebServer running concurrently. See Support as Http server and the Websockets server on Arduino DUE and Running Http and Websocket Servers concurrently. Thanks to bug report and persistence of Jake.
- Add non-blocking WebSockets Server and WebServer examples.
- Add Ethernet Library Patches
- Add Arduino SAMD Packages_Patches to fix compiler errors when using Standard Template Library STL
- Sync with ArduinoWebsockets v0.4.18 to fix ESP8266 SSL bug. See Secured-Two-Way: Client certificate is not sent if used along with setTrustAnchors
- Add support to all STM32F/L/H/G/WB/MP1 (Nucleo-144 NUCLEO_F767ZI, Nucleo-64 NUCLEO_L053R8, etc.)
- Add support to Seeeduino SAMD21/SAMD51 boards (SEEED_WIO_TERMINAL, SEEED_FEMTO_M0, SEEED_XIAO_M0, Wio_Lite_MG126, WIO_GPS_BOARD, SEEEDUINO_ZERO, SEEEDUINO_LORAWAN, SEEED_GROVE_UI_WIRELESS, etc.)
- Add sample Packages_Patches for STM32 stm32 (Nucleo-144 NUCLEO_F767ZI, Nucleo-64 NUCLEO_L053R8)
- Add Packages' Patches for Seeeduino SAMD to enable displaying BOARD_NAME
- Add many examples
- Add support to STM32F boards with built-in Ethernet such as :
- Nucleo-144 (F429ZI, F767ZI)
- Discovery (STM32F746G-DISCOVERY)
- All STM32 Boards with Built-in Ethernet LAN8742A
- Add support to STM32F1,2,3,4,7 boards (with 64+K Flash) using either Ethernet W5x00, ENC28J60 or LAN8742A
- Add Packages' Patches to Adafruit nRF52, SAMD, Arduino SAMD to enable displaying BOARD_NAME
- Enhance examples and update README.md
- Add support to Ethernet ENC28J60, using UIPEthernet library. for nRF52, SAMD21/SAMD51 and SAM DUE boards.
- Add support to SAM DUE boards.
- Add support to Ethernet W5x00, using either Ethernet, EthernetLarge or Ethernet2 library.
- Restructure code to provide flexibility to support many more WiFi/Ethernet modules/shields in the future. Please delete the *.cpp files, replaced by *.hpp files, in the src directory, if *.cpp files still exist after installing new version.
- Add support to nRF52 boards, such as AdaFruit Feather nRF52832, nRF52840 Express, BlueFruit Sense, Itsy-Bitsy nRF52840 Express, Metro nRF52840 Express, NINA_B302_ublox, NINA_B112_ublox, etc..
- Add support to SAMD51 (Itsy-Bitsy M4, Metro M4, Grand Central M4, Feather M4 Express, etc.).
- Add support to SAMD21 (ZERO, MKR, NANO_33_IOT, M0, M0 Pro, AdaFruit CIRCUITPLAYGROUND_EXPRESS, etc.).
- Add Alexa /
SINRIC
examples and supports to those boards as well as ESP8266/ESP32 - Add support to WiFiNINA using
WiFiNINA_Generic library
.
Submit issues to: WebSockets2_Generic issues
- Based on and modified from Gil Maimon's ArduinoWebsockets
- Thanks to good work of Miguel Alexandre Wisintainer for initiating, inspriring, working with, developing, debugging and testing. Without that, support to nRF52, especially NINA_B302_ublox running as nRF52840 and NINA_B112_ublox running as nRF52832, has never been started and finished. See u-blox nina b
- Thanks to bug report and persistence of Jake to help identify and add non-blocking WebSockets Server feature to v1.0.6 to enable WS Server and WebServer running concurrently. See Support as Http server and the Websockets server on Arduino DUE and Running Http and Websocket Servers concurrently.
![]() ⭐️⭐️ gilmaimon |
![]() ⭐️ tcpipchip |
![]() jakespeed1311 |
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
-
Most of the credits go to original author Gil Maimon as well as contributors in original library ArduinoWebsockets Contributors
-
base64
written by René Nyffenegger.
- Copyright (c) 2019- Gil Maimon
- Copyright (c) 2020- Khoi Hoang