ESP-IDF — Configuration - Hyperwisor

The component is configured through Kconfig (idf.py menuconfig or sdkconfig.defaults). Features compile in only when enabled, so you pay for what you use.

Feature toggles

Symbol	Default	Purpose
`HYPERWISOR_ENABLE_SYSTEM`	y	Built-in `restart`, `status` commands
`HYPERWISOR_ENABLE_NTP`	y	SNTP time sync after Wi-Fi up
`HYPERWISOR_ENABLE_HTTP`	y	`hyperwisor_http_get/post` helpers
`HYPERWISOR_ENABLE_WIDGET`	y	Push live values to dashboard widgets
`HYPERWISOR_ENABLE_OTA`	n	OTA via the `OTA_UPDATE` cloud command
`HYPERWISOR_ENABLE_GPIO`	n	Cloud-driven GPIO read/write
`HYPERWISOR_ENABLE_DISPLAY`	n	Backlight control via the board port

Connection settings

CONFIG_HYPERWISOR_HTTP_BASE_URL="https://your.api/functions/v1"
CONFIG_HYPERWISOR_WS_HOST="your.realtime.host"
CONFIG_HYPERWISOR_WS_PORT=443

The defaults point at the official Hyperwisor cloud. Override these only when self-hosting.

Board port (optional)

For production boards, provide a hyperwisor_port_t struct of function pointers to integrate with a specific board’s GPIO whitelist, display backlight, or sensor APIs. See hyperwisor_port.h for the full interface.

Next: API reference

The C API across the umbrella header.