> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperwisor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ESP-IDF — Configuration

> Kconfig feature toggles, connection settings, and the board port.

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

```kconfig theme={null}
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.

<Card title="Next: API reference" icon="book" href="/firmware/esp-idf/api-reference">
  The C API across the umbrella header.
</Card>