Initial project setup: ESP-IDF + C++ + FreeRTOS + WiFi + web server

This commit is contained in:
2026-04-01 20:34:59 -05:00
commit 4651d4c88a
24 changed files with 1032 additions and 0 deletions

7
main/CMakeLists.txt Normal file
View File

@@ -0,0 +1,7 @@
idf_component_register(SRCS "main.cpp"
"app_config.cpp"
"wifi_manager.cpp"
"web_server.cpp"
"display_manager.cpp"
INCLUDE_DIRS "."
REQUIRES freertos esp_wifi esp_http_server esp_event esp_netif nvs_flash)

33
main/app_config.cpp Normal file
View File

@@ -0,0 +1,33 @@
#include "app_config.hpp"
#include "wifi_manager.hpp"
#include "display_manager.hpp"
#include "web_server.hpp"
#include <esp_log.h>
static const char *TAG = "app_config";
void app_init(void)
{
ESP_LOGI(TAG, "Initializing application components");
// Initialize display (LVGL)
ESP_LOGI(TAG, "Initializing display...");
DisplayManager& display = DisplayManager::getInstance();
display.init();
display.createMainScreen();
display.updateStatusText("Initializing WiFi...");
// Initialize WiFi
ESP_LOGI(TAG, "Initializing WiFi...");
WiFiManager& wifi = WiFiManager::getInstance();
wifi.init(DEFAULT_SSID, DEFAULT_PASSWORD);
wifi.connect();
// Initialize Web Server
ESP_LOGI(TAG, "Starting web server...");
WebServer& web = WebServer::getInstance();
web.start(WEB_SERVER_PORT);
ESP_LOGI(TAG, "Application initialized successfully");
display.updateStatusText("Ready");
}

22
main/app_config.hpp Normal file
View File

@@ -0,0 +1,22 @@
#ifndef APP_CONFIG_HPP
#define APP_CONFIG_HPP
#include <esp_system.h>
// WiFi Configuration
#define DEFAULT_SSID "LittlePeppers"
#define DEFAULT_PASSWORD "SoliDeoGloria"
// Display Configuration (Waveshare ESP32-S3-Touch-LCD 4.3")
#define DISPLAY_WIDTH 800
#define DISPLAY_HEIGHT 480
#define DISPLAY_COLOR_DEPTH 16
// Web Server Configuration
#define WEB_SERVER_PORT 80
#define WEB_SERVER_STACK_SIZE 4096
// Initialize all application components
void app_init(void);
#endif // APP_CONFIG_HPP

44
main/display_manager.cpp Normal file
View File

@@ -0,0 +1,44 @@
#include "display_manager.hpp"
#include <esp_log.h>
static const char *TAG = "display_manager";
DisplayManager DisplayManager::instance;
DisplayManager& DisplayManager::getInstance()
{
return instance;
}
void DisplayManager::init()
{
ESP_LOGI(TAG, "Initializing display (800x480)");
// TODO: Initialize actual display hardware
// - RGB LCD configuration
// - SPI/I2C initialization
// - GPIO setup
ESP_LOGI(TAG, "Display initialized successfully");
}
void DisplayManager::update()
{
// TODO: Update display with frame buffer
}
void DisplayManager::createMainScreen()
{
ESP_LOGI(TAG, "Creating main screen");
// TODO: LVGL screen creation
}
void DisplayManager::createStatusBar()
{
ESP_LOGI(TAG, "Creating status bar");
// TODO: Status bar UI
}
void DisplayManager::updateStatusText(const char* text)
{
ESP_LOGI(TAG, "Status: %s", text);
// TODO: Update LVGL label
}

31
main/display_manager.hpp Normal file
View File

@@ -0,0 +1,31 @@
#ifndef DISPLAY_MANAGER_HPP
#define DISPLAY_MANAGER_HPP
// #include <lvgl.h>
class DisplayManager {
public:
static DisplayManager& getInstance();
void init();
void update();
// lv_disp_t* getDisplay() const;
// Helper methods to create common UI elements
void createMainScreen();
void createStatusBar();
void updateStatusText(const char* text);
private:
DisplayManager() = default;
static DisplayManager instance;
// lv_disp_t* display = nullptr;
// lv_obj_t* main_screen = nullptr;
// lv_obj_t* status_label = nullptr;
// Display callbacks
// static void flush_cb(lv_disp_drv_t* disp_drv, const lv_area_t* area, lv_color_t* color_p);
// static void read_cb(lv_indev_drv_t* indev_drv, lv_indev_data_t* data);
};
#endif // DISPLAY_MANAGER_HPP

45
main/lv_conf.h Normal file
View File

@@ -0,0 +1,45 @@
#ifndef LV_CONF_H
#define LV_CONF_H
/* Display */
#define LV_HOR_RES_MAX 800
#define LV_VER_RES_MAX 480
#define LV_COLOR_DEPTH 16
#define LV_COLOR_16_SWAP 0
#define LV_COLOR_SCREEN_ON_BW_THRESH 127
/* Memory */
#define LV_MEM_CUSTOM 0
#define LV_MEM_SIZE (48 * 1024)
#define LV_MEM_ADR 0
#define LV_MEM_AUTO_DEFRAG 1
/* Drawing */
#define LV_DISP_DEF_REFR_PERIOD 30
#define LV_INDEV_DEF_READ_PERIOD 30
/* Logging */
#define LV_USE_LOG 1
#define LV_LOG_LEVEL LV_LOG_LEVEL_WARN
#define LV_LOG_MEM_USAGE 1
#define LV_LOG_TIMER 1
/* LVGL Version */
#define LV_VERSION_CHECK 1
/* Extended features */
#define LV_USE_DRAW_SIMPLE_IMG 1
#define LV_USE_DRAW_TRANSFORM 1
#define LV_USE_DRAW_DITHER 1
#define LV_USE_DRAW_MASK 1
/* Themes */
#define LV_USE_THEME_DEFAULT 1
/* Image decoder */
#define LV_USE_IMG_DECODER_EXTERNAL 1
/* Touch input */
#define LV_USE_TOUCH_INPUT 1
#endif

6
main/main.c Normal file
View File

@@ -0,0 +1,6 @@
#include <stdio.h>
void app_main(void)
{
}

22
main/main.cpp Normal file
View File

@@ -0,0 +1,22 @@
#include <stdio.h>
#include <freertos/FreeRTOS.h>
#include <freertos/task.h>
#include <esp_log.h>
#include "app_config.hpp"
static const char *TAG = "main";
extern "C" void app_main(void)
{
ESP_LOGI(TAG, "ZoneBridge Application Starting");
ESP_LOGI(TAG, "ESP32-S3 Touch LCD 4.3\" (Waveshare)");
// Initialize application components
app_init();
// Main application loop
while (1) {
vTaskDelay(pdMS_TO_TICKS(1000));
//ESP_LOGI(TAG, "heartbeat");
}
}

104
main/web_server.cpp Normal file
View File

@@ -0,0 +1,104 @@
#include "web_server.hpp"
#include "app_config.hpp"
#include <esp_log.h>
#include <string.h>
static const char *TAG = "web_server";
WebServer WebServer::instance;
// Root handler - serves a simple dashboard
static esp_err_t rootHandler(httpd_req_t* req)
{
const char* response = R"(
<!DOCTYPE html>
<html>
<head>
<title>ZoneBridge Dashboard</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<style>
body { font-family: Arial; margin: 20px; background-color: #f0f0f0; }
.container { max-width: 800px; margin: 0 auto; background: white; padding: 20px; border-radius: 8px; }
h1 { color: #333; }
.status { padding: 10px; margin: 10px 0; border-radius: 4px; }
.online { background-color: #d4edda; color: #155724; }
.offline { background-color: #f8d7da; color: #721c24; }
</style>
</head>
<body>
<div class="container">
<h1>ZoneBridge Control Panel</h1>
<div class="status online">System Online</div>
<p>ESP32-S3 Touch LCD 4.3" is running</p>
</div>
</body>
</html>
)";
httpd_resp_set_type(req, "text/html");
return httpd_resp_send(req, response, strlen(response));
}
// API handler for status
static esp_err_t apiStatusHandler(httpd_req_t* req)
{
const char* json_response = R"({"status":"online","uptime":0})";
httpd_resp_set_type(req, "application/json");
return httpd_resp_send(req, json_response, strlen(json_response));
}
WebServer& WebServer::getInstance()
{
return instance;
}
void WebServer::start(int port)
{
if (server != nullptr) {
ESP_LOGW(TAG, "Web server already running");
return;
}
httpd_config_t config = HTTPD_DEFAULT_CONFIG();
config.server_port = port;
config.stack_size = WEB_SERVER_STACK_SIZE;
config.max_uri_handlers = 16;
if (httpd_start(&server, &config) != ESP_OK) {
ESP_LOGE(TAG, "Failed to start web server");
return;
}
// Register URL handlers
httpd_uri_t root = {
.uri = "/",
.method = HTTP_GET,
.handler = rootHandler,
.user_ctx = nullptr
};
httpd_register_uri_handler(server, &root);
httpd_uri_t api_status = {
.uri = "/api/status",
.method = HTTP_GET,
.handler = apiStatusHandler,
.user_ctx = nullptr
};
httpd_register_uri_handler(server, &api_status);
ESP_LOGI(TAG, "Web server started on port %d", port);
}
void WebServer::stop()
{
if (server != nullptr) {
httpd_stop(server);
server = nullptr;
ESP_LOGI(TAG, "Web server stopped");
}
}
bool WebServer::isRunning() const
{
return server != nullptr;
}

24
main/web_server.hpp Normal file
View File

@@ -0,0 +1,24 @@
#ifndef WEB_SERVER_HPP
#define WEB_SERVER_HPP
#include <esp_http_server.h>
class WebServer {
public:
static WebServer& getInstance();
void start(int port = 80);
void stop();
bool isRunning() const;
private:
WebServer() = default;
static WebServer instance;
httpd_handle_t server = nullptr;
// HTTP request handlers
static esp_err_t handleRootRequest(httpd_req_t* req);
static esp_err_t handleApiRequest(httpd_req_t* req);
};
#endif // WEB_SERVER_HPP

163
main/wifi_manager.cpp Normal file
View File

@@ -0,0 +1,163 @@
#include "wifi_manager.hpp"
#include <esp_log.h>
#include <esp_netif.h>
#include <esp_event.h>
#include <nvs_flash.h>
#include <string.h>
static const char *TAG = "wifi_manager";
WiFiManager WiFiManager::instance;
WiFiManager& WiFiManager::getInstance()
{
return instance;
}
void WiFiManager::init(const char* ssid, const char* password)
{
ESP_LOGI(TAG, "Initializing WiFi with SSID: %s", ssid);
// Step 1: Initialize NVS (needed for WiFi storage)
esp_err_t ret = nvs_flash_init();
if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
ESP_LOGI(TAG, "Erasing NVS flash...");
nvs_flash_erase();
ret = nvs_flash_init();
}
if (ret != ESP_OK) {
ESP_LOGE(TAG, "NVS flash init failed: %s", esp_err_to_name(ret));
return;
}
// Step 2: Create event loop (needed for WiFi events)
ret = esp_event_loop_create_default();
if (ret != ESP_OK && ret != ESP_ERR_INVALID_STATE) {
ESP_LOGE(TAG, "Event loop creation failed: %s", esp_err_to_name(ret));
return;
}
// Step 3: Initialize network interface (needed for WiFi)
ret = esp_netif_init();
if (ret != ESP_OK) {
ESP_LOGE(TAG, "NetIF init failed: %s", esp_err_to_name(ret));
return;
}
// Step 4: Create default WiFi station interface
esp_netif_t *sta_netif = esp_netif_create_default_wifi_sta();
if (!sta_netif) {
ESP_LOGE(TAG, "Failed to create default WiFi station interface");
return;
}
// Step 5: Initialize WiFi driver
wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
ret = esp_wifi_init(&cfg);
if (ret != ESP_OK) {
ESP_LOGE(TAG, "WiFi init failed: %s", esp_err_to_name(ret));
return;
}
// Step 6: Set WiFi configuration
wifi_config_t wifi_config = {};
strncpy((char*)wifi_config.sta.ssid, ssid, sizeof(wifi_config.sta.ssid) - 1);
strncpy((char*)wifi_config.sta.password, password, sizeof(wifi_config.sta.password) - 1);
wifi_config.sta.scan_method = WIFI_ALL_CHANNEL_SCAN;
wifi_config.sta.sort_method = WIFI_CONNECT_AP_BY_SIGNAL;
wifi_config.sta.threshold.rssi = -127;
ret = esp_wifi_set_mode(WIFI_MODE_STA);
if (ret != ESP_OK) {
ESP_LOGE(TAG, "Set WiFi mode failed: %s", esp_err_to_name(ret));
return;
}
ret = esp_wifi_set_config(WIFI_IF_STA, &wifi_config);
if (ret != ESP_OK) {
ESP_LOGE(TAG, "Set WiFi config failed: %s", esp_err_to_name(ret));
return;
}
ESP_LOGI(TAG, "WiFi manager initialized successfully");
}
void WiFiManager::connect()
{
ESP_LOGI(TAG, "Connecting to WiFi...");
// Register event handlers
esp_err_t ret = esp_event_handler_register(WIFI_EVENT, ESP_EVENT_ANY_ID, &WiFiManager::eventHandler, nullptr);
if (ret != ESP_OK) {
ESP_LOGE(TAG, "Failed to register WiFi event handler: %s", esp_err_to_name(ret));
return;
}
ret = esp_event_handler_register(IP_EVENT, IP_EVENT_STA_GOT_IP, &WiFiManager::eventHandler, nullptr);
if (ret != ESP_OK) {
ESP_LOGE(TAG, "Failed to register IP event handler: %s", esp_err_to_name(ret));
return;
}
ret = esp_wifi_start();
if (ret != ESP_OK) {
ESP_LOGE(TAG, "WiFi start failed: %s", esp_err_to_name(ret));
return;
}
ESP_LOGI(TAG, "WiFi start initiated");
}
void WiFiManager::disconnect()
{
if (esp_wifi_stop() == ESP_OK) {
connected = false;
ESP_LOGI(TAG, "WiFi disconnected");
}
}
bool WiFiManager::isConnected() const
{
return connected;
}
const char* WiFiManager::getIpAddress() const
{
return ip_address;
}
void WiFiManager::eventHandler(void* arg, esp_event_base_t event_base,
int32_t event_id, void* event_data)
{
WiFiManager& self = getInstance();
if (event_base == WIFI_EVENT) {
if (event_id == WIFI_EVENT_STA_START) {
ESP_LOGI(TAG, "WiFi started, requesting connection...");
esp_err_t conn_ret = esp_wifi_connect();
if (conn_ret != ESP_OK) {
ESP_LOGE(TAG, "esp_wifi_connect failed on STA_START: %s", esp_err_to_name(conn_ret));
}
} else if (event_id == WIFI_EVENT_STA_DISCONNECTED) {
ESP_LOGW(TAG, "WiFi disconnected, retrying...");
self.connected = false;
esp_err_t conn_ret = esp_wifi_connect();
if (conn_ret != ESP_OK) {
ESP_LOGE(TAG, "esp_wifi_connect retry failed: %s", esp_err_to_name(conn_ret));
}
}
} else if (event_base == IP_EVENT) {
if (event_id == IP_EVENT_STA_GOT_IP) {
ip_event_got_ip_t* event = (ip_event_got_ip_t*) event_data;
uint32_t ip = event->ip_info.ip.addr;
snprintf(self.ip_address, sizeof(self.ip_address),
"%u.%u.%u.%u",
(unsigned int)((ip) & 0xFF),
(unsigned int)((ip >> 8) & 0xFF),
(unsigned int)((ip >> 16) & 0xFF),
(unsigned int)((ip >> 24) & 0xFF));
self.connected = true;
ESP_LOGI(TAG, "WiFi connected! IP: %s", self.ip_address);
}
}
}

27
main/wifi_manager.hpp Normal file
View File

@@ -0,0 +1,27 @@
#ifndef WIFI_MANAGER_HPP
#define WIFI_MANAGER_HPP
#include <esp_wifi.h>
#include <esp_event.h>
class WiFiManager {
public:
static WiFiManager& getInstance();
void init(const char* ssid, const char* password);
void connect();
void disconnect();
bool isConnected() const;
const char* getIpAddress() const;
private:
WiFiManager() = default;
static WiFiManager instance;
bool connected = false;
char ip_address[16] = {0};
static void eventHandler(void* arg, esp_event_base_t event_base,
int32_t event_id, void* event_data);
};
#endif // WIFI_MANAGER_HPP