menu "ESPresso Frame Configuration" config ESP_AP_SSID string "Provisioning softAP SSID prefix" default "ESPRESSO" help SSID prefix of the softAP the device brings up when it needs provisioning; the device appends "_XXXXXX" (last 3 bytes of its WiFi MAC) so multiple frames never collide on the same SSID. The password is generated randomly per device on first boot and shown on the e-ink panel both as a WiFi-join QR code and as plaintext underneath it, so it can be typed in by hand on a desktop/laptop that can't scan the QR. config ESP_MAX_STA_CONN int "Maximal STA connections" default 4 range 1 4 if IDF_TARGET_ESP32C2 range 1 15 help Maximum number of STAs allowed to connect to the soft-AP (wifi_config_t.ap.max_connection). Upper bound matches ESP_WIFI_MAX_CONN_NUM in esp_wifi_types_native.h: 1-4 on ESP32-C2, 1-15 on other Wi-Fi chips. Soft-AP and ESP-NOW share encryption keys; see Wi-Fi driver documentation if ESP-NOW is enabled. config ESP_ENABLE_DHCP_CAPTIVEPORTAL bool "DHCP Captive portal" default y help Enables more modern DHCP-based Option 114 to provide clients with the captive portal URI config FRAME_STA_CONNECT_MAX_RETRIES int "Home WiFi connect max retries before falling back to provisioning" default 3 help Number of failed connection attempts to the stored home WiFi network before the device gives up and re-enters provisioning (softAP) mode. config FRAME_STA_CONNECT_TIMEOUT_MS int "Home WiFi connect timeout per attempt (ms)" default 15000 help How long to wait for an IP address on each connection attempt to the stored home WiFi network before counting it as a failed retry. config FRAME_SERVER_CHECK_TIMEOUT_MS int "Tools server /frame/config request timeout (ms)" default 3000 help How long to wait for a GET /frame/config response from the tools server -- doubles as both the reachability check for the post-connect status screen and the source of the server-configured refresh interval below. config FRAME_FETCH_TIMEOUT_MS int "Image fetch HTTP timeout (ms)" default 15000 help How long to wait on the GET /frame/image request before giving up. The server does real work per request (Immich download + resize + dither), so this is longer than the reachability check's timeout. config FRAME_SLEEP_INTERVAL_S int "Fallback deep sleep interval between refreshes (seconds)" default 3600 help The refresh interval is normally set server-side (the "Refresh interval" field in the server's web UI, delivered via GET /frame/config) so it can be changed without reflashing. This value is only a fallback: used before the device has ever successfully reached a configured server, or if the server's response doesn't include a valid interval (e.g. an older server version). Lower this for bench testing so you don't have to wait an hour per iteration. config FRAME_RETRY_INTERVAL_S int "Deep sleep interval after a failed cycle (seconds)" default 300 help How long the device deep-sleeps before retrying after the server was unreachable or the fetch/display failed, instead of waiting the full FRAME_SLEEP_INTERVAL_S. config FRAME_RESET_BUTTON_GPIO int "Factory-reset button GPIO (-1 to disable)" default 3 range -1 7 help Button wired between this GPIO and GND (active-low, internal pull-up enabled in firmware -- no external resistor needed). Holding it for FRAME_RESET_BUTTON_HOLD_MS clears the stored WiFi/server config and restarts the device into provisioning mode. Must be GPIO 0-7 -- the only pins the ESP32-C6 can use as an EXT1 deep-sleep wakeup source, which is what lets a press wake the device promptly instead of only being noticed during its brief awake windows. Set to -1 to disable the feature entirely. config FRAME_RESET_BUTTON_HOLD_MS int "Factory-reset button hold duration (ms)" default 10000 depends on FRAME_RESET_BUTTON_GPIO >= 0 help How long the reset button must be held continuously before the device clears its stored config and reboots into provisioning. Long enough that it won't trigger by accident. config FRAME_NEXT_BUTTON_GPIO int "Next-photo button GPIO (-1 to disable)" default 2 range -1 7 help Button wired between this GPIO and GND (active-low, internal pull-up enabled in firmware -- no external resistor needed). Pressing it wakes the device (if asleep), forces the server to advance to the next photo immediately (POST /frame/advance) regardless of the configured refresh interval, and displays it. Must be GPIO 0-7 for the same deep-sleep-wakeup reason as FRAME_RESET_BUTTON_GPIO above; defaults to a different pin than the reset button. Set to -1 to disable the feature. config FRAME_MANAGE_BUTTON_GPIO int "Manage button GPIO (-1 to disable)" default 1 range -1 7 help Button wired between this GPIO and GND (active-low, internal pull-up enabled in firmware -- no external resistor needed). Pressing it wakes the device (if asleep), displays the current photo with a small "scan to manage" QR code overlaid in the top-right corner (linking to the tools server's config page) for 30 seconds, then reverts to the plain photo. Must be GPIO 0-7 for the same deep-sleep-wakeup reason as FRAME_RESET_BUTTON_GPIO above; defaults to a different pin than the other two buttons. Set to -1 to disable the feature. endmenu