Published February 2, 2026

UNIHIKER K10: WiFiManager Phone Setup

UNIHIKER K10 — WiFi Setup via WiFiManager (Phone-based)

BeginnerFull instructions provided1 hour60

Things used in this project

Hardware components

USB Cable, USB Type C Plug

DFRobot UNIHIKER K10

Software apps and online services

Microsoft VS Code

PlatformIO IDE

Arduino IDE

wifi manager

Story

This guide shows how to use WiFiManager on the UNIHIKER K10 (ESP32) so users can configure WiFi via their phone by connecting to a temporary AP (K10_Config). The device will display status and IP on its screen and sync time via NTP.

Open VSCode Package Manager
Search for the official platformio ideextension

Install PlatformIO IDE.

Install Unihiker K10 SDK

Click on “PlatformIO Home” button on the bottom PlatformIO Toolbar

Click on “New Project”, select a random DFRobot board and create new PlatformIO Project.

Open platformio.ini file, then copy and paste the following configure text in it. And use ctrl+s to save the configure file.Wait for the SDK download.

platformio.ini

[env:unihiker]
platform = https://github.com/DFRobot/platform-unihiker.git
board = unihiker_k10
framework = arduino
build_flags =
-DARDUINO_USB_CDC_ON_BOOT=1
-DARDUINO_USB_MODE=1
-DModel=None
PlatformIO:
- In platformio.ini add:
lib_deps =
tzapu/WiFiManager@^0.16.0
- Or run:
pio lib install "WiFiManager"
Arduino IDE:
- Open Library Manager → search "WiFiManager" → install tzapu / ESP32-compatible version.

open Platform IO

Libraries

search wifi manager by tzapu

add to project

choose the project you want to add

How It Works (User Flow)

1. Power on the K10. It opens an AP named `K10_Config`.

2. On your phone open Wi‑Fi settings and connect to `K10_Config` (usually open).

3. Open a browser (or it may auto-redirect) and go to `http://192.168.4.1`.

4. Enter your home WiFi SSID and password, submit.

5. K10 will attempt to connect to the provided network. On success it shows `Connected` and `IP: x.x.x.x`, then syncs NTP time.

##Key Code Points

- Start config portal:

wifiManager.startConfigPortal("K10_Config");

- AP callback for UI:

wifiManager.setAPCallback(...)

- Save callback:

wifiManager.setSaveConfigCallback(...)

- Clear stored credentials (long press):

wifiManager.resetSettings(); WiFi.disconnect(true, true);

- Auto-connect uses WiFi.begin() or WiFiManager.autoConnect().

##Button Behavior

- Short press A: open config portal.

- Long press A (≈3s): clear saved WiFi credentials and restart portal.

## Tips for Display

- Keep each displayed line short and place IP on its own line to avoid truncation.

- Use landscape orientation if text is wider.

## Troubleshooting

- If browser doesn’t open automatically, visit: http://192.168.4.1

- If not connecting after setup: verify SSID/password and router settings (e.g., MAC filtering).

- Compilation error referencing `ESP8266WiFi.h`: ensure you're using the ESP32-compatible WiFiManager and include `<WiFi.h>` for ESP32.

## Conclusion

This approach allows non-technical users to configure WiFi on-site using their phone without editing code. The provided example displays concise English messages and ensures the IP/date/time are visible after connection.

Wifi Manager on K10

#include <Arduino.h>
#include <WiFi.h>
#include <WiFiManager.h>
#include <time.h>
#include "unihiker_k10.h"

UNIHIKER_K10 k10;
WiFiManager wifiManager;
uint8_t screen_dir = 1; // set landscape orientation (horizontal)

const char* ntpServer = "ntp.aliyun.com";
const long gmtOffsetSec = 8 * 3600;
const int daylightOffsetSec = 0;

unsigned long lastTimeUpdate = 0;
unsigned long buttonPressStart = 0;
const unsigned long longPressMs = 3000;
bool shouldSaveConfig = false;
bool portalRunning = false;

void drawStatus(const String& status, const String& detail = "") {
    // Reworked layout for landscape: short lines, separate rows to avoid truncation
    k10.canvas->canvasClear();
    k10.setScreenBackground(0x000000);

    // title at top-left
    k10.canvas->canvasText("WiFi Manager", 0, 0xFFFFFF);

    // primary status next
    k10.canvas->canvasText(status.c_str(), 1, 0x00FF00);

    // detail on its own line (short)
    if (detail.length()) {
        k10.canvas->canvasText(detail.c_str(), 2, 0x00FFFF);
    }

    // concise instructions arranged for horizontal layout
    if (!portalRunning) {
        k10.canvas->canvasText("Short press A to cfg", 4, 0x00FFFF);
    } else {
        k10.canvas->canvasText("Complete setup on phone", 4, 0x00FFFF);
    }
    k10.canvas->canvasText("Long press A to clear", 5, 0xFF0000);
    k10.canvas->updateCanvas();
}

void drawClock() {
    struct tm timeInfo;
    if (!getLocalTime(&timeInfo)) return;

    char buf[32];
    strftime(buf, sizeof(buf), "%Y-%m-%d", &timeInfo);

    k10.canvas->canvasClear();
    k10.setScreenBackground(0x000000);

    // landscape-friendly lines: each short and on separate row
    k10.canvas->canvasText("Connected", 0, 0x00FF00);
    String ipLine = "IP: " + WiFi.localIP().toString();
    k10.canvas->canvasText(ipLine.c_str(), 1, 0x00FFFF);
    k10.canvas->canvasText(buf, 3, 0xFFFFFF);
    strftime(buf, sizeof(buf), "%H:%M:%S", &timeInfo);
    k10.canvas->canvasText(buf, 4, 0xFF00FF);
    k10.canvas->updateCanvas();
}

void apModeCallback(WiFiManager* wmInstance) {
    (void)wmInstance;
    // short single-line SSID and mode
    drawStatus("AP Mode Active", "SSID: K10_Config");
}

void saveConfigCallback() {
    shouldSaveConfig = true;
    Serial.println("[WiFi] Credentials saved callback");
}

void startConfigPortal() {
    if (portalRunning) return;
    portalRunning = true;

    drawStatus("Starting portal", "Connect SSID: K10_Config");
    Serial.println("[WiFi] Starting config portal");

    wifiManager.setAPCallback(apModeCallback);
    wifiManager.setSaveConfigCallback(saveConfigCallback);
    wifiManager.setConfigPortalTimeout(180);

    bool res = wifiManager.startConfigPortal("K10_Config");
    if (res && WiFi.status() == WL_CONNECTED) {
        Serial.print("[WiFi] Connected after portal, IP: ");
        Serial.println(WiFi.localIP());
        if (shouldSaveConfig) {
            Serial.println("[WiFi] Credentials stored");
            shouldSaveConfig = false;
        }
        drawStatus("Connected", WiFi.localIP().toString());
        configTime(gmtOffsetSec, daylightOffsetSec, ntpServer);
        lastTimeUpdate = 0;
        delay(500);
        drawClock();
    } else {
        Serial.println("[WiFi] Portal exited without connection");
        drawStatus("Setup not completed", "Short press A to retry");
    }

    portalRunning = false;
}

void tryAutoConnectStored(unsigned long timeoutMs = 12000) {
    // kept for possible future use; not used when we clear credentials at startup
    drawStatus("Trying stored network...");
    WiFi.mode(WIFI_STA);
    WiFi.setAutoReconnect(true);
    WiFi.begin();
    unsigned long start = millis();
    while (millis() - start < timeoutMs) {
        if (WiFi.status() == WL_CONNECTED) {
            Serial.print("[WiFi] Connected (stored), IP: ");
            Serial.println(WiFi.localIP());
            drawStatus("Connected", WiFi.localIP().toString());
            configTime(gmtOffsetSec, daylightOffsetSec, ntpServer);
            lastTimeUpdate = 0;
            delay(300);
            drawClock();
            return;
        }
        delay(200);
    }
    Serial.println("[WiFi] Stored network connect timeout");
}

void setup() {
    Serial.begin(115200);
    k10.begin();
    k10.initScreen(screen_dir); // ensure initialization uses landscape
    k10.creatCanvas();

    drawStatus("Initializing");

    // Clear saved WiFi credentials and start portal (keep screen orientation)
    wifiManager.resetSettings();
    WiFi.disconnect(true, true);
    delay(300);
    // re-init screen to ensure orientation after reset
    k10.initScreen(screen_dir);
    drawStatus("Saved WiFi cleared", "Launching portal");
    Serial.println("[WiFi] Cleared saved WiFi credentials; launching portal now");

    // ensure callbacks are registered
    wifiManager.setAPCallback(apModeCallback);
    wifiManager.setSaveConfigCallback(saveConfigCallback);

    // immediately start config portal so user can set SSID/password again
    startConfigPortal();
}

void loop() {
    bool buttonAPressed = k10.buttonA->isPressed();

    if (buttonAPressed) {
        if (buttonPressStart == 0) {
            buttonPressStart = millis();
        }
        if (millis() - buttonPressStart >= longPressMs) {
            // long press: clear saved credentials
            wifiManager.resetSettings();
            WiFi.disconnect(true, true);
            drawStatus("WiFi cleared", "Short press A to configure");
            Serial.println("[WiFi] WiFi settings cleared");
            delay(1200);
            buttonPressStart = 0;
            return;
        }
    } else if (buttonPressStart != 0) {
        unsigned long duration = millis() - buttonPressStart;
        buttonPressStart = 0;
        if (duration < longPressMs) {
            // short press: start config portal
            startConfigPortal();
        }
    }

    if (portalRunning) {
        delay(50);
        return;
    }

    if (WiFi.status() == WL_CONNECTED) {
        if (millis() - lastTimeUpdate > 1000) {
            lastTimeUpdate = millis();
            drawClock();
        }
    } else {
        static unsigned long lastStatus = 0;
        if (millis() - lastStatus > 2000) {
            lastStatus = millis();
            drawStatus("Not connected", "Short press A to configure");
            WiFi.reconnect();
        }
    }

    delay(10);
}