В этом уроке мы научимся создавать веб-сервер на ESP32, используя SPIFFS и ESP-IDF. ESP32 имеет файловую систему SPI Flash, которая используется для хранения различных типов данных и файлов. В предыдущем уроке мы создали веб-сервер на ESP32, где жестко закодировали HTML/CSS-ответы в виде строковых литералов. Но в этом уроке мы будем хранить HTML/CSS-файлы в SPIFFS и создадим веб-сервер, который будет предоставлять эти файлы в HTTP GET-ответах веб-клиентам.
В этом проекте веб-сервера на ESP32 с использованием ESP-IDF и SPIFFS мы будем создавать и сохранять HTML- и CSS-файлы в файловой системе SPI-флэш-памяти, с помощью которых будем строить веб-сервер, управляющий выходными контактами GPIO модуля ESP32 путем переключения встроенного светодиода.
Мы будем программировать ESP32 с помощью ESP-IDF в VS Code. Прежде чем продолжить, убедитесь, что у вас установлена последняя версия VS Code и настроено расширение ESP-IDF:
- Установка ESP32 ESP-IDF на Windows и его интеграция с Visual Studio Code
- Установка ESP32 ESP-IDF на Linux Ubuntu
Как работает веб-сервер на ESP32 с использованием SPIFFS?
Когда пользователь пытается получить доступ к этому веб-серверу по IP-адресу, веб-сервер ESP32 SPIFFS отвечает на этот HTTP-запрос простыми HTML- и CSS-файлами, которые отображают кнопки управления светодиодами, состояние светодиодов, заголовок «ESP32 WEB SERVER» и символ лампы. Во время запуска программы содержимое HTML/CSS-файлов считывается из SPI-флэш-памяти и сохраняется в буфере.
Мы создадим веб-сервер SPIFFS с использованием библиотеки HTTP-веб-сервера, доступной в esp-idf. Кроме того, мы создадим HTML- и CSS-файлы и сохраним их в SPIFFS на ESP32. Когда пользователь отправит HTTP GET-запрос, введя IP-адрес в веб-браузере, ESP32 ответит буфером, содержащим HTML- и CSS-файлы.
На графическом интерфейсе пользователя есть две кнопки: «ВКЛ» и «ВЫКЛ». Пользователь сможет управлять выводами GPIO ESP32 с помощью этих кнопок. При нажатии кнопки «ВКЛ» URL-адрес перенаправляет на IP-адрес, за которым следует /led2on, и аналогично при нажатии кнопки «ВЫКЛ» URL-адрес перенаправляет на IP-адрес, за которым следует /led2off. Используя эти подпути URL-адреса, мы запускаем соответствующую функцию обратного вызова в нашем коде для управления светодиодом и отправки ответа веб-клиенту.
Создание проекта веб-сервера ESP32 в ESP-IDF
В этом разделе давайте создадим веб-сервер SPIFFS для ESP32, работающий с ESP-IDF.
Создание примера проекта
Откройте VS Code и перейдите в меню View > Command Palette («Вид» > «Палитра команд»). Введите в строке поиска ESP-IDF: New Project и нажмите Enter.
Укажите название проекта и каталог, а также плату и целевое устройство ESP-IDF. Мы назвали наш проект «esp32_spiffs_webserver». Для платы ESP-IDF мы выбрали опцию custom board («пользовательская плата»). Для целевого устройства ESP-IDF мы выбрали модуль ESP32. Нажмите кнопку ‘Choose Template’ («Выбрать шаблон»), чтобы продолжить.
В разделе «Расширение» выберите опцию ESP-IDF:
На вкладке get-started («Начало работы») мы щелкнем по пункту «sample_project». Затем нажмем ‘Create project using template sample_project’) («Создать проект, используя шаблон sample_project»).
Вы получите уведомление о создании проекта. Чтобы открыть проект в новом окне, нажмите «Да».
Это открывает наш проект esp32_spiffs_webserver, который мы создали на вкладке EXPLORER. Внутри папки проекта находится несколько папок. Это справедливо для всех проектов, которые вы будете создавать с помощью ESP-IDF Explorer.
Создание в ESP-IDF раздела для SPIFFS
В этом разделе мы создадим раздел для SPIFFS, где будем хранить HTML/CSS для веб-сервера.
Создайте новый файл и назовите его «partitions.csv». Скопируйте в этот файл приведенные ниже данные и сохраните его. Нам нужно добавить собственную пользовательскую таблицу разделов, поэтому мы будем использовать этот файл.
|
1 2 3 4 5 6 |
# Name, Type, SubType, Offset, Size, Flags # Note: if you change the phy_init or app partition offset, make sure to change the offset in Kconfig.projbuild nvs, data, nvs, , 0x6000, phy_init, data, phy, , 0x1000, factory, app, factory, , 1M, storage, data, spiffs, , 1M |
После создания файла partitions.csv создайте в каталоге проекта папку с именем ‘data‘. Внутри этой папки создайте текстовый файл с именем ‘index.html‘.
Файл index.htm определяет структуру и содержимое веб-страницы, которую веб-сервер ESP32 будет отправлять в ответ на HTTP-запросы от веб-клиентов.
Веб-страница веб-сервера на ESP32 и SPIFSS
Этот код представляет собой HTML-файл, определяющий макет и содержимое веб-страницы. Веб-страница содержит заголовок, сетку карточек и две кнопки. Сетка карточек отображает информацию о конкретном выводе GPIO (универсального ввода/вывода) микроконтроллера ESP32, а кнопки позволяют пользователю управлять состоянием вывода GPIO.
HTML-код определяет общую структуру страницы, включая разделы head и body. Раздел head содержит метаданные и ссылки на внешние ресурсы, такие как таблица стилей и библиотека шрифтов. Раздел body содержит содержимое страницы, включая заголовок и сетку карточек.
Раздел style в коде определяет расположение и внешний вид элементов страницы. Он задает семейство шрифтов, выравнивание текста и цвет заголовка, а также определяет внешний вид кнопок и карточек.
Тело страницы содержит заголовок, элемент div с классом «content» и элемент div с классом «card-grid». Элемент div «content» содержит элемент div «card-grid», который, в свою очередь, содержит несколько элементов div «card». Каждый элемент div «card» представляет собой отдельную карточку в сетке и содержит информацию о конкретном контакте GPIO, включая его состояние и две кнопки для управления состоянием контакта. Заполнитель %s в элементе div «card» указывает, что строковое значение будет вставлено в это место в HTML-коде при отрисовке страницы.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 |
<!DOCTYPE html> <html> <style> html { font-family: Arial; display: inline-block; margin: 0px auto; text-align: center; } h1 { color: #070812; padding: 2vh; } .button { display: inline-block; background-color: #b30000; //red color border: none; border-radius: 4px; color: white; padding: 16px 40px; text-decoration: none; font-size: 30px; margin: 2px; cursor: pointer; } .button2 { background-color: #364cf4; //blue color } .content { padding: 50px; } .card-grid { max-width: 800px; margin: 0 auto; display: grid; grid-gap: 2rem; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); } .card { background-color: white; box-shadow: 2px 2px 12px 1px rgba(140, 140, 140, .5); } .card-title { font-size: 1.2rem; font-weight: bold; color: #034078 } </style> <head> <title>ESP32 WEB SERVER</title> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="icon" href="data:,"> <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.7.2/css/all.css" integrity="sha384-fnmOCqbTlWIlj8LyTjo7mOUStjsKC4pOpQbqyi7RrhN7udi9RwhKkMHpvLbHG9Sr" crossorigin="anonymous"> </head> <body> <h2>ESP32 WEB SERVER</h2> <div class="content"> <div class="card-grid"> <div class="card"> <p><i class="fas fa-lightbulb fa-2x" style="color:#c81919;"></i> <strong>GPIO2</strong></p> <p>GPIO state: <strong> %s </strong></p> <p> <a href="/led2on"><button class="button">ON</button></a> <a href="/led2off"><button class="button button2">OFF</button></a> </p> </div> </div> </div> </body> </html> |
Перейдите в папку с именем ‘main’ и откройте файл CMakeLists.txt. Добавьте в конец этого файла следующую строку и сохраните его.
|
1 |
spiffs_create_partition_image(storage ../data FLASH_IN_PROJECT) |
Настройка веб-сервера на ESP32 и SPIFFS в ESP-IDF
Теперь давайте настроим некоторые параметры для ESP32 и создадим файл Kconfig.projbuild для настройки учетных данных Wi-Fi.
Настройка пользовательского файла разделов в ESP-IDF
Сначала перейдите в меню menuconfig. Щелкните значок, показанный ниже. Откроется редактор конфигурации ESP-IDF SDK.
Прокрутите вниз и откройте конфигурацию Serial Flasher. Здесь вы можете установить режим SPI для флэш-памяти, режим выборки флэш-памяти, скорость SPI для флэш-памяти, размер флэш-памяти и т. д. Установите параметры, как показано ниже, и сохраните изменения. Обратите внимание, что мы установили размер флэш-памяти равным 4 МБ.
Далее прокрутите вниз и нажмите Partition Table («Таблица разделов»). Здесь мы выберем опцию ‘custom partition table CSV’ («Пользовательская таблица разделов CSV») в разделе «Таблица разделов», укажем имя созданного нами CSV-файла и смещение таблицы разделов.
Настройка учетных данных Wi-Fi
Создайте новый файл с именем ‘Kconfig.projbuild‘ в основной папке. Скопируйте приведенный ниже код в этот новый файл.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
menu "Example Configuration" config ESP_WIFI_SSID string "WiFi SSID" default "myssid" help SSID (network name) for the example to connect to. config ESP_WIFI_PASSWORD string "WiFi Password" default "mypassword" help WiFi password (WPA or WPA2) for the example to use. config ESP_MAXIMUM_RETRY int "Maximum retry" default 5 help Set the Maximum retry to avoid station reconnecting to the AP unlimited when the AP is really inexistent. endmenu |
Теперь перейдите в меню menuconfig. Щелкните значок, показанный ниже. Откроется редактор конфигурации ESP-IDF SDK.
Прокрутите вниз и откройте Example Configuration (пример конфигурации). Здесь мы можем установить параметры конфигурации для этого примера в соответствии с нашими потребностями. Это включает в себя SSID сети Wi-Fi, пароль сети Wi-Fi и максимальное количество попыток повтора. Укажите SSID и пароль сети Wi-Fi вашего маршрутизатора, к которому будет подключаться плата ESP32. По умолчанию максимальное количество попыток повтора установлено на 5. Вы можете изменить это значение по своему усмотрению. После указания параметров конфигурации нажмите кнопку «Сохранить» вверху.
Код веб-сервера на ESP32 и SPIFFS
Этот код настраивает простой HTTP-сервер на микроконтроллере ESP32. Сервер принимает HTTP-запросы и отвечает содержимым веб-страницы. Сервер выполняет три основные функции: отображение главной веб-страницы, включение светодиода и выключение светодиода.
На главной веб-странице отображается текущее состояние светодиода (включен или выключен) и имеются две кнопки для управления им. При нажатии кнопки «ВКЛ» сервер отправляет запрос на включение светодиода. При нажатии кнопки «ВЫКЛ» сервер отправляет запрос на выключение светодиода.
Скопируйте эту копию в файл main.c вашего проекта.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 |
#include <stdio.h> #include <stdlib.h> #include <string.h> //Requires by memset #include "freertos/FreeRTOS.h" #include "freertos/task.h" #include "esp_system.h" #include "esp_spi_flash.h" #include <esp_http_server.h> #include "esp_spiffs.h" #include "connect_wifi.h" #define LED_PIN 2 static const char *TAG = "espressif"; // TAG for debug int led_state = 0; #define INDEX_HTML_PATH "/spiffs/index.html" char index_html[4096]; char response_data[4096]; static void initi_web_page_buffer(void) { esp_vfs_spiffs_conf_t conf = { .base_path = "/spiffs", .partition_label = NULL, .max_files = 5, .format_if_mount_failed = true}; ESP_ERROR_CHECK(esp_vfs_spiffs_register(&conf)); memset((void *)index_html, 0, sizeof(index_html)); struct stat st; if (stat(INDEX_HTML_PATH, &st)) { ESP_LOGE(TAG, "index.html not found"); return; } FILE *fp = fopen(INDEX_HTML_PATH, "r"); if (fread(index_html, st.st_size, 1, fp) == 0) { ESP_LOGE(TAG, "fread failed"); } fclose(fp); } esp_err_t send_web_page(httpd_req_t *req) { int response; if(led_state) { sprintf(response_data, index_html, "ON"); } else { sprintf(response_data, index_html, "OFF"); } response = httpd_resp_send(req, response_data, HTTPD_RESP_USE_STRLEN); return response; } esp_err_t get_req_handler(httpd_req_t *req) { return send_web_page(req); } esp_err_t led_on_handler(httpd_req_t *req) { gpio_set_level(LED_PIN, 1); led_state = 1; return send_web_page(req); } esp_err_t led_off_handler(httpd_req_t *req) { gpio_set_level(LED_PIN, 0); led_state = 0; return send_web_page(req); } httpd_uri_t uri_get = { .uri = "/", .method = HTTP_GET, .handler = get_req_handler, .user_ctx = NULL}; httpd_uri_t uri_on = { .uri = "/led2on", .method = HTTP_GET, .handler = led_on_handler, .user_ctx = NULL}; httpd_uri_t uri_off = { .uri = "/led2off", .method = HTTP_GET, .handler = led_off_handler, .user_ctx = NULL}; httpd_handle_t setup_server(void) { httpd_config_t config = HTTPD_DEFAULT_CONFIG(); httpd_handle_t server = NULL; if (httpd_start(&server, &config) == ESP_OK) { httpd_register_uri_handler(server, &uri_get); httpd_register_uri_handler(server, &uri_on); httpd_register_uri_handler(server, &uri_off); } return server; } void app_main() { // Initialize NVS esp_err_t ret = nvs_flash_init(); if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) { ESP_ERROR_CHECK(nvs_flash_erase()); ret = nvs_flash_init(); } ESP_ERROR_CHECK(ret); connect_wifi(); // GPIO initialization if (wifi_connect_status) { gpio_pad_select_gpio(LED_PIN); gpio_set_direction(LED_PIN, GPIO_MODE_OUTPUT); led_state = 0; ESP_LOGI(TAG, "LED Control SPIFFS Web Server is running ... ...\n"); initi_web_page_buffer(); setup_server(); } } |
Теперь давайте посмотрим, как работает приведенный выше код.
Сначала добавьте несколько заголовочных файлов для различных библиотек и функций, используемых в программе. Функциональность каждого заголовочного файла описана ниже:
“stdio.h” – стандартная библиотека ввода/вывода. Эта библиотека предоставляет функции для ввода и вывода, такие как “printf()” и “fopen()”.
“stdlib.h” – Стандартная библиотека. Эта библиотека предоставляет функции общего назначения, такие как “malloc()” и “exit()”.
“string.h” – библиотека для работы со строками. Эта библиотека предоставляет функции для обработки строк, такие как “memset()” и “strlen()”.
“freertos/FreeRTOS.h” – библиотека FreeRTOS. FreeRTOS – это операционная система для микроконтроллеров, позволяющая одновременно выполнять несколько задач. Этот заголовочный файл предоставляет доступ к API FreeRTOS.
“freertos/task.h” – библиотека задач FreeRTOS. Эта библиотека предоставляет функции для создания и управления задачами в FreeRTOS, такие как “xTaskCreate()” и “vTaskDelete()”.
“esp_system.h” – системная библиотека ESP. Эта библиотека предоставляет функции для доступа к системной информации и выполнения операций системного уровня на микроконтроллерах ESP32.
“esp_spi_flash.h” – библиотека для работы с SPI-флэш-памятью ESP. Эта библиотека предоставляет функции для доступа к SPI-флэш-памяти микроконтроллеров ESP32.
“esp_http_server.h” – библиотека HTTP-сервера для ESP. Эта библиотека предоставляет функции для создания и управления HTTP-веб-сервером на ESP32.
“esp_spiffs.h” – библиотека ESP SPIFFS. Эта библиотека предоставляет функции для доступа к SPIFFS (SPI Flash File System) на микроконтроллерах ESP32.
Считывание содержимого файла index.html из SPIFSS в буфер (initi_web_page_buffer)
В коде веб-сервера ESP32 SPIFFS функция initi_web_page_buffer() инициализирует буфер с именем «index_html» содержимым файла «index.html», хранящегося в файловой системе SPIFFS (SPI Flash File System).
Функция начинается с определения структуры с именем «conf» типа «esp_vfs_spiffs_conf_t» и инициализации её несколькими полями. Поле «base_path» задаёт корневой каталог файловой системы SPIFFS, поле «partition_label» задаёт метку раздела SPIFFS (в данном случае она устанавливается в NULL), поле «max_files» задаёт максимальное количество файлов, которые могут быть открыты одновременно, а поле «format_if_mount_failed» указывает, следует ли форматировать файловую систему в случае неудачного монтирования.
Затем функция вызывает функцию «esp_vfs_spiffs_register()», передавая ей в качестве аргумента указатель на структуру «conf». Эта функция монтирует файловую систему SPIFFS, используя указанную конфигурацию.
Затем функция обнуляет все байты в буфере «index_html» с помощью функции «memset()». После этого она объявляет структуру с именем «st» типа «struct stat» и проверяет, существует ли файл «index.html», используя функцию «stat()». Если файл не существует, она выводит сообщение об ошибке в лог и завершает работу функции.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
static void initi_web_page_buffer(void) { esp_vfs_spiffs_conf_t conf = { .base_path = "/spiffs", .partition_label = NULL, .max_files = 5, .format_if_mount_failed = true}; ESP_ERROR_CHECK(esp_vfs_spiffs_register(&conf)); memset((void *)index_html, 0, sizeof(index_html)); struct stat st; if (stat(INDEX_HTML_PATH, &st)) { ESP_LOGE(TAG, "index.html not found"); return; } FILE *fp = fopen(INDEX_HTML_PATH, "r"); if (fread(index_html, st.st_size, 1, fp) == 0) { ESP_LOGE(TAG, "fread failed"); } fclose(fp); } |
Настройка HTTP-веб-сервера на ESP32
Для создания веб-сервера SPIFFS на ESP32 мы используем библиотеку httpd_server, доступную в ESP-IDF. В этом фрагменте кода определены три структуры типа «httpd_uri_t» с именами «uri_get», «uri_on» и «uri_off». Эти структуры представляют три различных URI (Uniform Resource Identifier), которые может обрабатывать HTTP-сервер.
Структура “uri_get” представляет собой корневой URI “/”. Она указывает, что обрабатывает HTTP-запросы “GET” и использует функцию “get_req_handler()” в качестве обработчика запросов. Поле “user_ctx” устанавливается в значение NULL.
Структура “uri_on” представляет собой URI “/led2on”. Она указывает, что обрабатывает HTTP-запросы типа “GET” и использует функцию “led_on_handler()” в качестве обработчика запросов. Поле “user_ctx” устанавливается в значение NULL.
Структура “uri_off” представляет собой URI “/led2off”. Она указывает, что обрабатывает HTTP-запросы типа “GET” и использует функцию “led_off_handler()” в качестве обработчика запросов. Поле “user_ctx” устанавливается в значение NULL.
В коде также определена функция «setup_server()», которая настраивает HTTP-сервер. Функция начинается с определения структуры «config» типа «httpd_config_t» и инициализации её конфигурацией по умолчанию с помощью макроса «HTTPD_DEFAULT_CONFIG()». Затем она объявляет переменную «server» типа «httpd_handle_t» и присваивает ей значение NULL.
Затем функция вызывает функцию «httpd_start()», передавая ей в качестве аргументов указатель на переменную «server» и указатель на структуру «config». Если функция возвращает «ESP_OK», указывающий на успешный запуск HTTP-сервера, она регистрирует три конечные точки URI с помощью функции «httpd_register_uri_handler()». В качестве аргументов она передает дескриптор «server» и указатель на каждую из структур «httpd_uri_t».
Наконец, функция возвращает дескриптор «сервера». Этот дескриптор можно использовать для доступа к HTTP-серверу и управления им.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 |
httpd_uri_t uri_get = { .uri = "/", .method = HTTP_GET, .handler = get_req_handler, .user_ctx = NULL}; httpd_uri_t uri_on = { .uri = "/led2on", .method = HTTP_GET, .handler = led_on_handler, .user_ctx = NULL}; httpd_uri_t uri_off = { .uri = "/led2off", .method = HTTP_GET, .handler = led_off_handler, .user_ctx = NULL}; httpd_handle_t setup_server(void) { httpd_config_t config = HTTPD_DEFAULT_CONFIG(); httpd_handle_t server = NULL; if (httpd_start(&server, &config) == ESP_OK) { httpd_register_uri_handler(server, &uri_get); httpd_register_uri_handler(server, &uri_on); httpd_register_uri_handler(server, &uri_off); } return server; } |
Обработчики HTTP-запросов
Далее нам необходимо определить обработчики HTTP-запросов. Эти обработчики выполняются всякий раз, когда веб-сервер ESP32 SPIFFS получает запрос от веб-клиента. Этот код определяет три функции, которые используются в качестве обработчиков запросов для HTTP-сервера.
Функция «get_req_handler()» используется в качестве обработчика запроса для корневого URI «/». В качестве аргумента она принимает указатель на структуру «httpd_req_t», которая представляет собой HTTP-запрос. Функция просто вызывает функцию «send_web_page()» и возвращает её значение.
Функция “led_on_handler()” используется в качестве обработчика запроса для URI “/led2on”. В качестве аргумента она принимает указатель на структуру “httpd_req_t”, представляющую HTTP-запрос. Функция устанавливает уровень светодиода на контакте 2 в 1 с помощью функции “gpio_set_level()”, устанавливает глобальную переменную “led_state” в 1, а затем вызывает функцию “send_web_page()” и возвращает её значение.
Функция “led_off_handler()” используется в качестве обработчика запроса для URI “/led2off”. В качестве аргумента она принимает указатель на структуру “httpd_req_t”, представляющую HTTP-запрос. Функция устанавливает уровень светодиода на контакте 2 в 0 с помощью функции “gpio_set_level()”, устанавливает глобальную переменную “led_state” в 0, а затем вызывает функцию “send_web_page()” и возвращает её значение. Функция “send_web_page()” описана в следующем разделе.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
esp_err_t get_req_handler(httpd_req_t *req) { return send_web_page(req); } esp_err_t led_on_handler(httpd_req_t *req) { gpio_set_level(LED_PIN, 1); led_state = 1; return send_web_page(req); } esp_err_t led_off_handler(httpd_req_t *req) { gpio_set_level(LED_PIN, 0); led_state = 0; return send_web_page(req); } |
Функция ответа HTTP на веб-сервере ESP32
Это две основные функции, которые отправляют ответ веб-клиентам. В этом коде определены две функции: «send_web_page()» и «get_req_handler()».
Функция “send_web_page()” используется для отправки веб-страницы клиенту в ответ на HTTP-запрос. В качестве аргумента она принимает указатель на структуру “httpd_req_t”, которая представляет собой HTTP-запрос.
Функция начинается с объявления переменной «response» типа «int». Затем она проверяет значение глобальной переменной «led_state». Если оно истинно, функция использует функцию «sprintf()» для форматирования содержимого буфера «index_html» и строки «ON» в буфер «response_data». Если «led_state» ложно, функция форматирует содержимое буфера «index_html» и строку «OFF» в буфер «response_data».
Затем функция вызывает функцию «httpd_resp_send()», передавая ей в качестве аргументов указатель на аргумент «req», указатель на буфер «response_data» и значение «HTTPD_RESP_USE_STRLEN». Это отправляет содержимое буфера «response_data» в качестве ответа на HTTP-запрос. Затем функция возвращает значение, возвращаемое функцией «httpd_resp_send()».
Функция «get_req_handler()» используется в качестве обработчика запроса для корневого URI «/». В качестве аргумента она принимает указатель на структуру «httpd_req_t», которая представляет собой HTTP-запрос. Функция просто вызывает функцию «send_web_page()» и возвращает её значение.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
esp_err_t send_web_page(httpd_req_t *req) { int response; if(led_state) { sprintf(response_data, index_html, "ON"); } else { sprintf(response_data, index_html, "OFF"); } response = httpd_resp_send(req, response_data, HTTPD_RESP_USE_STRLEN); return response; } esp_err_t get_req_handler(httpd_req_t *req) { return send_web_page(req); } |
Основная функция веб-сервера на ESP32 и SPIFFS
Это основная функция веб-сервера ESP32 SPIFFS. Он отвечает за инициализацию модуля энергонезависимой памяти (NVS) микроконтроллера ESP32, подключение к сети Wi-Fi и настройку HTTP-сервера.
Инициализация модуля NVS осуществляется вызовом функции «nvs_flash_init()». Если эта функция возвращает ошибку, указывающую на отсутствие свободных страниц или на обнаружение новой версии модуля NVS, она вызывает функцию «nvs_flash_erase()» для удаления модуля NVS, а затем снова вызывает «nvs_flash_init()» для его инициализации.
После инициализации модуля NVS функция вызывает функцию «connect_wifi()» для подключения к сети Wi-Fi, определенной в файле «connect_wifi.h». Если подключение прошло успешно, функция инициализирует вывод GPIO, указанный макросом «LED_PIN», как выходной вывод, устанавливает его начальное состояние в низкое и записывает сообщение в лог. Затем она вызывает функцию «initi_web_page_buffer()» для инициализации буфера веб-страницы и функцию «setup_server()» для настройки HTTP-сервера.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
void app_main() { // Initialize NVS esp_err_t ret = nvs_flash_init(); if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) { ESP_ERROR_CHECK(nvs_flash_erase()); ret = nvs_flash_init(); } ESP_ERROR_CHECK(ret); connect_wifi(); // GPIO initialization if (wifi_connect_status) { gpio_pad_select_gpio(LED_PIN); gpio_set_direction(LED_PIN, GPIO_MODE_OUTPUT); led_state = 0; ESP_LOGI(TAG, "LED Control SPIFFS Web Server is running ... ...\n"); initi_web_page_buffer(); setup_server(); } } |
Демонстрация работы веб-сервера на ESP32 и SPIFFS
В этом разделе мы рассмотрим демонстрацию работы нашего веб-сервера на ESP32 и SPIFFS. Для начала скачайте полный проект по следующей ссылке и соберите его.
Для прошивки микросхемы введите следующую команду в последовательном терминале. Не забудьте заменить COM-порт на тот, через который подключена ваша плата.
|
1 |
idf.py -p COMX flash monitor |
После успешной прошивки кода вы можете просмотреть все информационные журналы. Сначала инициализируется Wi-Fi станции. Затем мы можем просмотреть esp_netif_handlers, который включает IP-адрес, маску и адрес шлюза. Затем мы получаем запись «получен IP-адрес», за которой следует сам IP-адрес. Мы будем использовать этот IP-адрес для доступа к веб-серверу.
Откройте новый веб-браузер и введите IP-адрес, полученный в терминале, затем нажмите Enter. Откроется веб-сервер ESP32, на экране которого отобразятся две кнопки для управления GPIO2. Изначально светодиод выключен, что также отображается на веб-сервере.
Теперь нажмите кнопки ВКЛ и ВЫКЛ, и светодиод будет включаться/выключаться соответственно. Аналогичным образом, состояние GPIO2 также будет непрерывно обновляться на веб-сервере.
