Add ESP IDF example

.github/workflows/esp-idf.yml

@@ -0,0 +1,21 @@
+on:
+  push:
+  schedule:
+    - cron: "0 2 * * *"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          submodules: 'recursive'
+          path: ${{ github.workspace }}/app
+
+      - name: esp-idf build
+        uses: espressif/esp-idf-ci-action@v1
+        with:
+          esp_idf_version: v4.4.6
+          target: esp32
+          path: app/examples/esp-idf

.gitmodules

@@ -0,0 +1,14 @@
+[submodule "examples/esp-idf/components/UrlEncode"]
+	path = examples/esp-idf/components/UrlEncode
+	url = https://github.com/dzungpv/UrlEncode
+[submodule "examples/esp-idf/components/ArduinoTrace"]
+	path = examples/esp-idf/components/ArduinoTrace
+	url = https://github.com/dzungpv/ArduinoTrace
+[submodule "examples/esp-idf/components/ArduinoJson"]
+	path = examples/esp-idf/components/ArduinoJson
+	url = https://github.com/bblanchon/ArduinoJson
+	branch = 7.x
+[submodule "examples/esp-idf/components/arduino-esp32"]
+	path = examples/esp-idf/components/arduino-esp32
+	url = https://github.com/espressif/arduino-esp32
+	branch = release/v2.x

examples/esp-idf/CMakeLists.txt

@@ -0,0 +1,14 @@
+# The following lines of boilerplate have to be in your project's
+# CMakeLists in this exact order for cmake to work correctly
+cmake_minimum_required(VERSION 3.5)
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+
+if(DEFINED ENV{HTTP_PATH})
+  set(HTTP_PATH $ENV{HTTP_PATH})
+else()
+  set(HTTP_PATH ${CMAKE_CURRENT_LIST_DIR}/../../../PsychicHttp)
+endif(DEFINED ENV{HTTP_PATH})
+
+set(EXTRA_COMPONENT_DIRS ${HTTP_PATH})
+
+project(PsychicHttp_IDF)

examples/esp-idf/README.md

@@ -0,0 +1,8 @@
+# PsychicHttp - ESP IDF Example
+*  Install ESP IDF 4.4.6 follow the guide: [ESP-IDF Guide](https://docs.espressif.com/projects/esp-idf/en/v4.4/esp32/get-started/index.html#step-2-get-esp-idf)
+*  Clone the project with command --recusive to include all sub module
+*  Run build command: idf.py build in the examples/esp-idf folder
+*  Flash the spiffs with data folder with command: esptool.py write_flash --flash_mode dio --flash_freq 40m --flash_size 4MB 0x317000 build/spiffs.bin
+*  Flash the app with command: idf.py flash monitor and enter the IP address show in console.
+*  Learn more about [Arduino as ESP-IDF Component](https://docs.espressif.com/projects/arduino-esp32/en/latest/esp-idf_component.html)
+

examples/esp-idf/data/custom.txt

@@ -0,0 +1 @@
+Custom text file.

examples/esp-idf/data/server.crt

@@ -0,0 +1,19 @@
+-----BEGIN CERTIFICATE-----
+MIIDKzCCAhOgAwIBAgIUBxM3WJf2bP12kAfqhmhhjZWv0ukwDQYJKoZIhvcNAQEL
+BQAwJTEjMCEGA1UEAwwaRVNQMzIgSFRUUFMgc2VydmVyIGV4YW1wbGUwHhcNMTgx
+MDE3MTEzMjU3WhcNMjgxMDE0MTEzMjU3WjAlMSMwIQYDVQQDDBpFU1AzMiBIVFRQ
+UyBzZXJ2ZXIgZXhhbXBsZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
+ALBint6nP77RCQcmKgwPtTsGK0uClxg+LwKJ3WXuye3oqnnjqJCwMEneXzGdG09T
+sA0SyNPwrEgebLCH80an3gWU4pHDdqGHfJQa2jBL290e/5L5MB+6PTs2NKcojK/k
+qcZkn58MWXhDW1NpAnJtjVniK2Ksvr/YIYSbyD+JiEs0MGxEx+kOl9d7hRHJaIzd
+GF/vO2pl295v1qXekAlkgNMtYIVAjUy9CMpqaQBCQRL+BmPSJRkXBsYk8GPnieS4
+sUsp53DsNvCCtWDT6fd9D1v+BB6nDk/FCPKhtjYOwOAZlX4wWNSZpRNr5dfrxKsb
+jAn4PCuR2akdF4G8WLUeDWECAwEAAaNTMFEwHQYDVR0OBBYEFMnmdJKOEepXrHI/
+ivM6mVqJgAX8MB8GA1UdIwQYMBaAFMnmdJKOEepXrHI/ivM6mVqJgAX8MA8GA1Ud
+EwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBADiXIGEkSsN0SLSfCF1VNWO3
+emBurfOcDq4EGEaxRKAU0814VEmU87btIDx80+z5Dbf+GGHCPrY7odIkxGNn0DJY
+W1WcF+DOcbiWoUN6DTkAML0SMnp8aGj9ffx3x+qoggT+vGdWVVA4pgwqZT7Ybntx
+bkzcNFW0sqmCv4IN1t4w6L0A87ZwsNwVpre/j6uyBw7s8YoJHDLRFT6g7qgn0tcN
+ZufhNISvgWCVJQy/SZjNBHSpnIdCUSJAeTY2mkM4sGxY0Widk8LnjydxZUSxC3Nl
+hb6pnMh3jRq4h0+5CZielA4/a+TdrNPv/qok67ot/XJdY3qHCCd8O2b14OVq9jo=
+-----END CERTIFICATE-----

examples/esp-idf/data/server.key

@@ -0,0 +1,28 @@
+-----BEGIN PRIVATE KEY-----
+MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCwYp7epz++0QkH
+JioMD7U7BitLgpcYPi8Cid1l7snt6Kp546iQsDBJ3l8xnRtPU7ANEsjT8KxIHmyw
+h/NGp94FlOKRw3ahh3yUGtowS9vdHv+S+TAfuj07NjSnKIyv5KnGZJ+fDFl4Q1tT
+aQJybY1Z4itirL6/2CGEm8g/iYhLNDBsRMfpDpfXe4URyWiM3Rhf7ztqZdveb9al
+3pAJZIDTLWCFQI1MvQjKamkAQkES/gZj0iUZFwbGJPBj54nkuLFLKedw7DbwgrVg
+0+n3fQ9b/gQepw5PxQjyobY2DsDgGZV+MFjUmaUTa+XX68SrG4wJ+DwrkdmpHReB
+vFi1Hg1hAgMBAAECggEAaTCnZkl/7qBjLexIryC/CBBJyaJ70W1kQ7NMYfniWwui
+f0aRxJgOdD81rjTvkINsPp+xPRQO6oOadjzdjImYEuQTqrJTEUnntbu924eh+2D9
+Mf2CAanj0mglRnscS9mmljZ0KzoGMX6Z/EhnuS40WiJTlWlH6MlQU/FDnwC6U34y
+JKy6/jGryfsx+kGU/NRvKSru6JYJWt5v7sOrymHWD62IT59h3blOiP8GMtYKeQlX
+49om9Mo1VTIFASY3lrxmexbY+6FG8YO+tfIe0tTAiGrkb9Pz6tYbaj9FjEWOv4Vc
++3VMBUVdGJjgqvE8fx+/+mHo4Rg69BUPfPSrpEg7sQKBgQDlL85G04VZgrNZgOx6
+pTlCCl/NkfNb1OYa0BELqWINoWaWQHnm6lX8YjrUjwRpBF5s7mFhguFjUjp/NW6D
+0EEg5BmO0ePJ3dLKSeOA7gMo7y7kAcD/YGToqAaGljkBI+IAWK5Su5yldrECTQKG
+YnMKyQ1MWUfCYEwHtPvFvE5aPwKBgQDFBWXekpxHIvt/B41Cl/TftAzE7/f58JjV
+MFo/JCh9TDcH6N5TMTRS1/iQrv5M6kJSSrHnq8pqDXOwfHLwxetpk9tr937VRzoL
+CuG1Ar7c1AO6ujNnAEmUVC2DppL/ck5mRPWK/kgLwZSaNcZf8sydRgphsW1ogJin
+7g0nGbFwXwKBgQCPoZY07Pr1TeP4g8OwWTu5F6dSvdU2CAbtZthH5q98u1n/cAj1
+noak1Srpa3foGMTUn9CHu+5kwHPIpUPNeAZZBpq91uxa5pnkDMp3UrLIRJ2uZyr8
+4PxcknEEh8DR5hsM/IbDcrCJQglM19ZtQeW3LKkY4BsIxjDf45ymH407IQKBgE/g
+Ul6cPfOxQRlNLH4VMVgInSyyxWx1mODFy7DRrgCuh5kTVh+QUVBM8x9lcwAn8V9/
+nQT55wR8E603pznqY/jX0xvAqZE6YVPcw4kpZcwNwL1RhEl8GliikBlRzUL3SsW3
+q30AfqEViHPE3XpE66PPo6Hb1ymJCVr77iUuC3wtAoGBAIBrOGunv1qZMfqmwAY2
+lxlzRgxgSiaev0lTNxDzZkmU/u3dgdTwJ5DDANqPwJc6b8SGYTp9rQ0mbgVHnhIB
+jcJQBQkTfq6Z0H6OoTVi7dPs3ibQJFrtkoyvYAbyk36quBmNRjVh6rc8468bhXYr
+v/t+MeGJP/0Zw8v/X2CFll96
+-----END PRIVATE KEY-----

examples/esp-idf/data/www-ap/index.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <title>PsychicHTTP SoftAP Demo</title>
+        <link rel="icon" href="./favicon.ico" type="image/x-icon">
+    </head>
+    <body>
+        <main>
+            <h1>SoftAP Demo</h1>
+            <p>You are connected to the ESP in SoftAP mode.</p>
+        </main>
+    </body>
+</html>

examples/esp-idf/data/www/index.html

@@ -0,0 +1,236 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <title>PsychicHTTP Demo</title>
+        <link rel="icon" href="./favicon.ico" type="image/x-icon">
+    </head>
+    <body>
+        <main>
+            <h1>Basic Request Examples</h1>
+            <ul>
+                <li><a href="/api?foo=bar">API Call</a></li>
+                <li><a href="/redirect">Redirection</a></li>
+                <li><a href="/auth-digest">Authentication (Digest)</a></li>
+                <li><a href="/auth-basic">Authentication (Basic)</a></li>
+                <li><a href="/cookies">Cookies Demo</a></li>
+                <li><a href="/404">404</a></li>
+            </ul>
+
+            <h1>Static Serving</h1>
+            <p>
+                <a href="/alien.png"><img width="60" src="/alien.png"></a>
+                <a href="/img/request_flow.png"><img width="60" src="/img/request_flow.png"></a>
+            </p>
+            <p><a href="/myfile.txt">Text File</a></p>
+
+            <h1>Simple POST Form</h1>
+            <form action="/post" method="post">
+                <label for="param1">Parameter 1:</label>
+                <input type="text" id="param1" name="param1" value="Parameter 1">            
+                <br>
+                <label for="param2">Parameter 2:</label>
+                <input type="text" id="param2" name="param2" value="Parameter 2">            
+                <br>
+                <input type="submit" value="Submit">
+            </form>            
+
+            <h1>Basic File Upload</h1>
+            <table border="0">
+                <tr>
+                    <td>
+                        <label for="newfile">Upload a file</label>
+                    </td>
+                    <td colspan="2">
+                        <input id="newfile" type="file" onchange="setpath()" style="width:100%;">
+                    </td>
+                </tr>
+                <tr>
+                    <td>
+                        <label for="filepath">Set path on server</label>
+                    </td>
+                    <td>
+                        <input id="filepath" type="text" style="width:100%;">
+                    </td>
+                </tr>
+                <tr>
+                    <td>
+                        <button id="upload" type="button" onclick="upload()">Upload</button>
+                    </td>
+                </tr>
+            </table>
+            <script>
+            function setpath() {
+                var default_path = document.getElementById("newfile").files[0].name;
+                document.getElementById("filepath").value = default_path;
+            }
+            function upload() {
+                var filePath = document.getElementById("filepath").value;
+                var upload_path = "/upload/" + filePath;
+                var fileInput = document.getElementById("newfile").files;
+
+                /* Max size of an individual file. Make sure this
+                * value is same as that set in file_server.c */
+                var MAX_FILE_SIZE = 2048*1024;
+                var MAX_FILE_SIZE_STR = "2MB";
+
+                if (fileInput.length == 0) {
+                    alert("No file selected!");
+                } else if (filePath.length == 0) {
+                    alert("File path on server is not set!");
+                } else if (filePath.indexOf(' ') >= 0) {
+                    alert("File path on server cannot have spaces!");
+                } else if (filePath[filePath.length-1] == '/') {
+                    alert("File name not specified after path!");
+                } else if (fileInput[0].size > 200*1024) {
+                    alert("File size must be less than 200KB!");
+                } else {
+                    document.getElementById("newfile").disabled = true;
+                    document.getElementById("filepath").disabled = true;
+                    document.getElementById("upload").disabled = true;
+
+                    var file = fileInput[0];
+                    var xhttp = new XMLHttpRequest();
+                    xhttp.onreadystatechange = function() {
+                        if (xhttp.readyState == 4) {
+                            if (xhttp.status == 200) {
+                                document.open();
+                                document.write(xhttp.responseText);
+                                document.close();
+                            } else if (xhttp.status == 0) {
+                                alert("Server closed the connection abruptly!");
+                                location.reload()
+                            } else {
+                                alert(xhttp.status + " Error!\n" + xhttp.responseText);
+                                location.reload()
+                            }
+                        }
+                    };
+                    xhttp.open("POST", upload_path, true);
+                    xhttp.send(file);
+                }
+            }
+            </script>
+
+            <h1>Multipart POST Form</h1>
+            <form action="/multipart" method="post" enctype="multipart/form-data">
+                <label for="param1">Parameter 1:</label>
+                <input type="text" id="param1" name="param1" value="Parameter 1">            
+                <br>
+
+                <label for="param2">Parameter 2:</label>
+                <input type="text" id="param2" name="param2" value="Parameter 2">            
+                <br>
+
+                <label for="file-upload">File Upload:</label>
+                <input type="file" id="file-upload" name="file_upload" accept=".txt, .html, .pdf, .png, .jpg, .gif" required>
+                <br>
+
+                <input type="submit" value="Upload File">
+            </form>
+
+            <h1>Websocket Demo</h1>
+            <input type="text" id="message_input" placeholder="Type your message">
+            <button onclick="sendMessage()">Send Message</button>
+            <button onclick="websocketConnect()">Connect</button>
+            <div>
+                <textarea id="websocket_output" style="width: 50%; height: 250px;"></textarea>
+            </div>
+
+            <script>
+                let socket;
+                const outputText = document.getElementById('websocket_output');
+                const messageInput = document.getElementById('message_input');
+
+                function websocketConnect()
+                {
+                    // Create a WebSocket connection
+                    socket = new WebSocket('ws://' + window.location.host + '/ws');
+
+                    // Event handler for when the WebSocket connection is open
+                    socket.addEventListener('open', (event) => {
+                        outputText.value += `[socket] connection opened!\n`;
+                        outputText.scrollTop = outputText.scrollHeight;
+                    });
+
+                    // Event handler for when a message is received from the WebSocket server
+                    socket.addEventListener('message', (event) => {
+                        // Echo the received message into the output div
+                        let data = event.data.trim();
+                        outputText.value += `[received] ${data}\n`;
+                        outputText.scrollTop = outputText.scrollHeight;
+                    });
+
+                    // Event handler for when an error occurs with the WebSocket connection
+                    socket.addEventListener('error', (event) => {
+                        let data = event.data.trim();
+                        outputText.value += `[error] ${event.data}\n`;
+                        outputText.scrollTop = outputText.scrollHeight;
+                    });
+
+                    // Event handler for when the WebSocket connection is closed
+                    socket.addEventListener('close', (event) => {
+                        outputText.value += `[socket] connection opened!\n`;
+                    });
+                }
+
+                // Function to send a message to the WebSocket server
+                function sendMessage() {
+                    if (socket.readyState == WebSocket.OPEN) {
+                        const message = messageInput.value.trim();
+                        if (message) {
+                            socket.send(message);
+                            messageInput.value = ''; // Clear the input field after sending the message
+                            outputText.value += `[sent] ${message}\n`;
+                            outputText.scrollTop = outputText.scrollHeight;
+                        }
+                    }
+                    else
+                    {
+                        outputText.value += `[error] Not Connected\n`;
+                        outputText.scrollTop = outputText.scrollHeight;
+                    }
+                }
+            </script>
+
+            <h1>EventSource Demo</h1>
+            <button onclick="eventSourceConnect()">Connect</button>
+            <div>
+                <textarea id="eventsource_output" style="width: 50%; height: 250px;"></textarea>
+            </div>
+
+            <script>
+                const dataElement = document.getElementById('eventsource_output');
+
+                function eventSourceConnect()
+                {
+                    const eventSource = new EventSource('/events');
+
+                    eventSource.onopen = () => {
+                        dataElement.value += `[connected]\n`;
+                        dataElement.scrollTop = dataElement.scrollHeight;
+                    };
+
+                    eventSource.addEventListener('millis', (event) => {
+                        let data = event.data.trim()
+                        dataElement.value += `[millis] ${data}\n`;
+                        dataElement.scrollTop = dataElement.scrollHeight;
+                    });
+
+                    eventSource.onmessage = (event) => {
+                        let data = event.data.trim()
+                        dataElement.value += `[message] ${data}\n`;
+                        dataElement.scrollTop = dataElement.scrollHeight;
+                    };
+
+                    eventSource.onerror = (error) => {
+                        dataElement.value += `[error] ${error}\n`;
+                        dataElement.scrollTop = dataElement.scrollHeight;
+                        eventSource.close();
+                    };
+                }
+              </script>
+        </main>
+    </body>
+</html>

examples/esp-idf/data/www/text.txt

@@ -0,0 +1 @@
+Test File.