64 lines
1.6 KiB
C
64 lines
1.6 KiB
C
#ifndef HTTP_SERVER_H
|
|
#define HTTP_SERVER_H
|
|
|
|
#include "esp_err.h"
|
|
#include "esp_http_server.h"
|
|
|
|
/**
|
|
* @brief Initialize and start the HTTP server
|
|
*
|
|
* Sets up all URI handlers and starts the web server on the configured port.
|
|
* Provides a REST API for motor control and a web interface.
|
|
*
|
|
* @return ESP_OK on success, ESP_FAIL on error
|
|
*/
|
|
esp_err_t http_server_init(void);
|
|
|
|
/**
|
|
* @brief Stop the HTTP server
|
|
*
|
|
* Gracefully shuts down the HTTP server and frees resources.
|
|
*
|
|
* @return ESP_OK on success, ESP_FAIL on error
|
|
*/
|
|
esp_err_t http_server_stop(void);
|
|
|
|
/**
|
|
* @brief Check if HTTP server is running
|
|
*
|
|
* @return true if server is running, false otherwise
|
|
*/
|
|
bool http_server_is_running(void);
|
|
|
|
/**
|
|
* @brief Get the HTTP server handle
|
|
*
|
|
* Returns the internal server handle for advanced operations.
|
|
* Can return NULL if server is not running.
|
|
*
|
|
* @return HTTP server handle or NULL
|
|
*/
|
|
httpd_handle_t http_server_get_handle(void);
|
|
|
|
/**
|
|
* @brief Get server statistics
|
|
*
|
|
* Provides information about server performance and usage.
|
|
*
|
|
* @param total_requests Pointer to store total request count
|
|
* @param active_connections Pointer to store current active connections
|
|
* @param last_request_time Pointer to store timestamp of last request
|
|
* @return ESP_OK on success, ESP_ERR_INVALID_ARG if pointers are NULL
|
|
*/
|
|
esp_err_t http_server_get_stats(uint32_t* total_requests, uint32_t* active_connections, uint32_t* last_request_time);
|
|
|
|
/**
|
|
* @brief Reset server statistics
|
|
*
|
|
* Resets all server statistics counters to zero.
|
|
*
|
|
* @return ESP_OK on success
|
|
*/
|
|
esp_err_t http_server_reset_stats(void);
|
|
|
|
#endif // HTTP_SERVER_H
|