Installation

This document explains the installation procedure for getting started with WebSerial.

Dependencies

WebSerial depends on the following libraries present in your libraries folder. Please stricly install the compatible versions of these dependencies only! Using any other version might break WebSerial or may cause WebSerial to work partially.

Note on Dependencies

As of v2, WebSerial has officially switched to using fork of ESPAsyncWebServer and its dependencies from @mathieucarbou. This fork of ESPAsyncWebServer is being maintained regularly and contains many bug fixes along with arduino-esp32 core v3 support.

It's suggested to migrate all your projects to using this fork as the original me-no-dev/ESPAsyncWebServer repo is not being maintained since years.

For ESP8266

• ESP8266 Arduino Core - v3.1.2
• (mathieucarbou) esphome-ESPAsyncTCP - v2.0.0
• (mathieucarbou) ESPAsyncWebServer - v3.1.1

For ESP32

• ESP32 Arduino Core @ v3.0.3
• (mathieucarbou) AsyncTCP @ v3.2.3
• (mathieucarbou) ESPAsyncWebServer - v3.1.1

Installing WebSerial

1. Directly Through Arduino IDE - Library Manager

Go to Sketch > Include Library > Library Manager > Search for "WebSerial" > Install

2. Manual Install

For Windows

• Download the Repository
• Extract the .zip in Documents > Arduino > Libraries > {Place "WebSerial" folder Here}

For Linux

• Download the Repository
• Extract the .zip in Sketchbook > Libraries > {Place "WebSerial" folder Here}

3. Import through Arduino IDE

• Download the Repository
• Go to Sketch > Include Library > Add .zip Library > Select the Downloaded .zip File.