Skip to content

Start an idryer-core device in 5 minutes

This page helps you quickly check that an ESP32 device can start with idryer-core, connect to the network, and exchange data. Use it as the first technical test before building your own dryer, heated chamber, lighting, or another module.

After this page your ESP32 will be flashed, will connect to WiFi, and will appear in portal.idryer.org with status Online. Requirements: ESP32-C3 (DevKit, Super Mini, or compatible), USB cable, PlatformIO in VS Code.

1. Prepare secrets.h

Copy examples/secrets.h.example to include/secrets.h in your project and set your WiFi SSID and password (2.4 GHz only):

#define WIFI_SSID      "your-ssid"
#define WIFI_PASSWORD  "your-password"

Add include/secrets.h to .gitignore.

2. Configure platformio.ini

Create platformio.ini in the project root:

[env:blink-demo]
platform    = espressif32
framework   = arduino
board       = esp32-c3-devkitm-1

lib_deps =
    file://path/to/idryer-core
    bblanchon/ArduinoJson @ ^6.21.0
    knolleary/PubSubClient

build_flags =
    -DIDRYER_API_BASE='"https://portal.idryer.org/api"'
    -DMQTT_USE_TLS=1

Change board to match your board. Replace path/to/idryer-core with the actual path to the library.

Copy the contents of examples/01_blink_status/01_blink_status.ino into src/main.cpp of your project. The example requires no sensors or additional dependencies — only a minimal composition root.

4. Flash

pio run -e blink-demo -t upload

5. Open Serial Monitor

pio device monitor -b 115200

Expected log sequence:

[CLOUD] Init: serial=DEVICE_XXXXXXXXXXXX deviceId=
[CLOUD] Connecting to WiFi...
[CLOUD] WiFi connected, IP: 192.168.1.42, RSSI: -47 dBm
[CLOUD] Provisioning device...
[CLOUD] Provision OK: isNew=1 isClaimed=0
[CLOUD] Registering device for claim...
[CLOUD] PIN: 1234567 (expires in 600s)

After entering the PIN in the portal (step 6):

[CLOUD] Device claimed! deviceId=...
[CLOUD] Connecting to MQTT...
[CLOUD] MQTT connected!
[RT] Cloud Online

If the device stopped at the PIN: ... message — that is expected; proceed to step 6.

6. Claim the device in the portal

Open portal.idryer.org, go to Add device, and enter the PIN from Serial Monitor. After a successful claim the device will transition to Online and the built-in LED will blink every 500 ms.

Detailed claim flow: Onboarding.

What to do next