Files
tactility/Modules/http-module/source/module.cpp
Ken Van Hoeylandt 1b16184a72 Multi-platform http server (#646)
- Add server support to `http-module`
- Ensure `DevelopmentService` works on all platforms (including posix)
- Ensure the built-in web server with dashboard works on all platforms (inluding posix). It still has some issues with certain featuers, but the basics work.
2026-09-06 14:16:23 +02:00

173 lines
7.9 KiB
C++

// SPDX-License-Identifier: Apache-2.0
#include <http/download.h>
#include <http/module.h>
#include <tactility/error.h>
#include <stddef.h>
#include <stdint.h>
#ifdef ESP_PLATFORM
#include <sdkconfig.h>
#include <esp_http_client.h>
#include <lwip/sockets.h>
#include <lwip/netdb.h>
#include <esp_sntp.h>
#include <esp_netif.h>
#if CONFIG_MBEDTLS_CERTIFICATE_BUNDLE
#include <esp_crt_bundle.h>
#endif
#endif
#include <sys/select.h>
extern "C" {
enum HttpMethod : int;
typedef uint16_t status_code_t;
struct HttpServerRequest;
struct HttpServer;
struct HttpServerConfig;
// Deliberately not #include <http/server.h> or <http/types.h>: their HttpMethod enum shares
// enumerator names with esp_http_client.h's own, so this file forward-declares exactly the
// functions it needs instead of including either header.
struct HttpServer* http_server_alloc(const struct HttpServerConfig* config);
void http_server_free(struct HttpServer* server);
error_t http_server_start(struct HttpServer* server);
void http_server_stop(struct HttpServer* server);
bool http_server_is_started(struct HttpServer* server);
uint16_t http_server_get_port(struct HttpServer* server);
enum HttpMethod http_server_request_get_method(struct HttpServerRequest* request);
size_t http_server_request_get_uri(struct HttpServerRequest* request, char* buffer, size_t buffer_size);
size_t http_server_request_get_query(struct HttpServerRequest* request, char* buffer, size_t buffer_size);
size_t http_server_request_get_header(struct HttpServerRequest* request, const char* name, char* buffer, size_t buffer_size);
uint64_t http_server_request_get_content_length(struct HttpServerRequest* request);
int http_server_request_receive(struct HttpServerRequest* request, void* buffer, size_t buffer_size);
void http_server_request_set_status(struct HttpServerRequest* request, status_code_t status_code);
void http_server_request_set_content_type(struct HttpServerRequest* request, const char* content_type);
void http_server_request_set_header(struct HttpServerRequest* request, const char* name, const char* value);
error_t http_server_request_send(struct HttpServerRequest* request, const void* data, size_t length);
error_t http_server_request_send_string(struct HttpServerRequest* request, const char* text);
error_t http_server_request_send_error(struct HttpServerRequest* request, int status_code, const char* message);
error_t http_server_request_send_chunk_start(struct HttpServerRequest* request);
error_t http_server_request_send_chunk(struct HttpServerRequest* request, const void* data, size_t length);
error_t http_server_request_send_chunk_end(struct HttpServerRequest* request);
const char* http_method_to_string(enum HttpMethod method);
error_t http_method_from_string(const char* text, enum HttpMethod* out_method);
error_t status_code_to_string(status_code_t code, const char** text);
static const ModuleSymbol SYMBOLS[] = {
DEFINE_MODULE_SYMBOL(http_download_subscribe),
DEFINE_MODULE_SYMBOL(http_download_unsubscribe),
DEFINE_MODULE_SYMBOL(http_download_poll),
DEFINE_MODULE_SYMBOL(http_download_start),
DEFINE_MODULE_SYMBOL(http_download_cancel),
DEFINE_MODULE_SYMBOL(http_server_alloc),
DEFINE_MODULE_SYMBOL(http_server_free),
DEFINE_MODULE_SYMBOL(http_server_start),
DEFINE_MODULE_SYMBOL(http_server_stop),
DEFINE_MODULE_SYMBOL(http_server_is_started),
DEFINE_MODULE_SYMBOL(http_server_get_port),
DEFINE_MODULE_SYMBOL(http_server_request_get_method),
DEFINE_MODULE_SYMBOL(http_server_request_get_query),
DEFINE_MODULE_SYMBOL(http_server_request_get_header),
DEFINE_MODULE_SYMBOL(http_server_request_get_content_length),
DEFINE_MODULE_SYMBOL(http_server_request_receive),
DEFINE_MODULE_SYMBOL(http_server_request_set_status),
DEFINE_MODULE_SYMBOL(http_server_request_set_content_type),
DEFINE_MODULE_SYMBOL(http_server_request_send),
DEFINE_MODULE_SYMBOL(http_server_request_send_string),
DEFINE_MODULE_SYMBOL(http_server_request_send_error),
DEFINE_MODULE_SYMBOL(http_server_request_get_uri),
DEFINE_MODULE_SYMBOL(http_server_request_set_header),
DEFINE_MODULE_SYMBOL(http_server_request_send_chunk_start),
DEFINE_MODULE_SYMBOL(http_server_request_send_chunk),
DEFINE_MODULE_SYMBOL(http_server_request_send_chunk_end),
// types
DEFINE_MODULE_SYMBOL(http_method_to_string),
DEFINE_MODULE_SYMBOL(http_method_from_string),
DEFINE_MODULE_SYMBOL(status_code_to_string),
// posix
DEFINE_MODULE_SYMBOL(select),
#ifdef ESP_PLATFORM
// esp_netif.h
DEFINE_MODULE_SYMBOL(esp_netif_get_ip_info),
DEFINE_MODULE_SYMBOL(esp_netif_get_handle_from_ifkey),
// lwip/sockets.h
DEFINE_MODULE_SYMBOL(lwip_setsockopt),
DEFINE_MODULE_SYMBOL(lwip_socket),
DEFINE_MODULE_SYMBOL(lwip_recv),
DEFINE_MODULE_SYMBOL(lwip_getpeername),
DEFINE_MODULE_SYMBOL(lwip_bind),
DEFINE_MODULE_SYMBOL(lwip_listen),
DEFINE_MODULE_SYMBOL(lwip_close),
DEFINE_MODULE_SYMBOL(lwip_accept),
DEFINE_MODULE_SYMBOL(lwip_getsockname),
DEFINE_MODULE_SYMBOL(lwip_send),
DEFINE_MODULE_SYMBOL(lwip_connect),
DEFINE_MODULE_SYMBOL(lwip_select),
DEFINE_MODULE_SYMBOL(lwip_gethostbyname),
DEFINE_MODULE_SYMBOL(ipaddr_addr),
// esp_sntp.h
DEFINE_MODULE_SYMBOL(sntp_get_sync_status),
// esp_http
#if CONFIG_MBEDTLS_CERTIFICATE_BUNDLE
// Needed for HTTPS: an app passes this as crt_bundle_attach to validate certificates against
// the bundle already compiled into the firmware (CONFIG_MBEDTLS_CERTIFICATE_BUNDLE).
DEFINE_MODULE_SYMBOL(esp_crt_bundle_attach),
#endif
DEFINE_MODULE_SYMBOL(esp_http_client_init),
DEFINE_MODULE_SYMBOL(esp_http_client_perform),
DEFINE_MODULE_SYMBOL(esp_http_client_cancel_request),
DEFINE_MODULE_SYMBOL(esp_http_client_set_url),
DEFINE_MODULE_SYMBOL(esp_http_client_set_post_field),
DEFINE_MODULE_SYMBOL(esp_http_client_get_post_field),
DEFINE_MODULE_SYMBOL(esp_http_client_set_header),
DEFINE_MODULE_SYMBOL(esp_http_client_get_header),
DEFINE_MODULE_SYMBOL(esp_http_client_get_username),
DEFINE_MODULE_SYMBOL(esp_http_client_set_username),
DEFINE_MODULE_SYMBOL(esp_http_client_get_password),
DEFINE_MODULE_SYMBOL(esp_http_client_set_password),
DEFINE_MODULE_SYMBOL(esp_http_client_set_authtype),
DEFINE_MODULE_SYMBOL(esp_http_client_get_user_data),
DEFINE_MODULE_SYMBOL(esp_http_client_set_user_data),
DEFINE_MODULE_SYMBOL(esp_http_client_get_errno),
DEFINE_MODULE_SYMBOL(esp_http_client_get_and_clear_last_tls_error),
DEFINE_MODULE_SYMBOL(esp_http_client_set_method),
DEFINE_MODULE_SYMBOL(esp_http_client_set_timeout_ms),
DEFINE_MODULE_SYMBOL(esp_http_client_delete_header),
DEFINE_MODULE_SYMBOL(esp_http_client_delete_all_headers),
DEFINE_MODULE_SYMBOL(esp_http_client_open),
DEFINE_MODULE_SYMBOL(esp_http_client_write),
DEFINE_MODULE_SYMBOL(esp_http_client_fetch_headers),
DEFINE_MODULE_SYMBOL(esp_http_client_is_chunked_response),
DEFINE_MODULE_SYMBOL(esp_http_client_read),
DEFINE_MODULE_SYMBOL(esp_http_client_get_status_code),
DEFINE_MODULE_SYMBOL(esp_http_client_get_content_length),
DEFINE_MODULE_SYMBOL(esp_http_client_close),
DEFINE_MODULE_SYMBOL(esp_http_client_cleanup),
DEFINE_MODULE_SYMBOL(esp_http_client_get_transport_type),
DEFINE_MODULE_SYMBOL(esp_http_client_set_redirection),
DEFINE_MODULE_SYMBOL(esp_http_client_reset_redirect_counter),
DEFINE_MODULE_SYMBOL(esp_http_client_set_auth_data),
DEFINE_MODULE_SYMBOL(esp_http_client_add_auth),
DEFINE_MODULE_SYMBOL(esp_http_client_is_complete_data_received),
DEFINE_MODULE_SYMBOL(esp_http_client_read_response),
DEFINE_MODULE_SYMBOL(esp_http_client_flush_response),
DEFINE_MODULE_SYMBOL(esp_http_client_get_url),
DEFINE_MODULE_SYMBOL(esp_http_client_get_chunk_length),
#endif
MODULE_SYMBOL_TERMINATOR,
};
Module http_module = {
.name = "http",
.start = nullptr,
.stop = nullptr,
.drivers = nullptr,
.symbols = SYMBOLS,
.internal = nullptr,
};
}