Services

⚙️ Services

Connectivity | Device | Display | Web server

🌐 Connectivity

Hostname:

Configure in .env:

HOSTNAME='frekvens'

Time zone:

Time zone in IANA format, eg. America/New_York, Asia/Shanghai or Europe/London.

Configure in .env:

TIME_ZONE='Etc/Universal'

Wi-Fi client:

Configure in secrets.h:

#define WIFI_SSID "name"
#define WIFI_KEY "secret"

Tip

Additional Wi-Fi credentials can be added later via the Web app.

Wi-Fi hotspot:

Long press any button during startup to activate the Wi-Fi hotspot. The Web app can then be used to add new Wi-Fi credentials if needed.

Wi-Fi country:

Regulatory country code in ISO 3166-1 alpha-2 format.

Configure in secrets.h:

#define WIFI_COUNTRY "01"

Note

Only a subset of country codes are supported by Espressif.

🖥️ Device

Name:

Configure in .env:

NAME='Frekvens'

Power off:

API payload example:

{
    "action": "power"
}

Reboot:

API payload example:

{
    "action": "reboot"
}

Restore:

Performs a full reset of the device’s non-volatile storage (NVS), clearing all user preferences, settings, and extra Wi-Fi credentials. This is functionally equivalent to a factory reset.

API payload example:

{
    "action": "restore"
}

Note

The device will shut down automatically. A manual power cycle is required to power it back on again.

📺 Display

Frame rate:

The frame rate is automatically scaled based on the ESP32 variant's CPU frequency. While this ranges from 120 fps (400 MHz) down to 36 fps (120 MHz), most common variants running at 240 MHz will result in 72 fps.

To manually set a fixed frame rate, define it in secrets.h:

#define FRAME_RATE 72 // fps

PWM bit depth:

To maximize visual quality, the bit depth is dynamically balanced against the frame rate. Higher frame rates favor fluid motion with lower bit depth (e.g. 8-bit at 120 fps), while lower frame rates allow for greater brightness control (e.g. 15-bit at 24 fps). For the common 72 fps configuration, this results in a 10-bit depth by default.

To manually lock the bit depth, define it in secrets.h:

#define PWM_DEPTH 10 // bit