5分鐘快速開始¶
完成此頁面後,您的ESP32將被刷入,將連接到WiFi,並在portal.idryer.org上顯示為線上狀態。需求:ESP32-C3(DevKit、Super Mini 或相容)、USB線纜、VS Code中的PlatformIO。
1. 準備 secrets.h¶
將examples/secrets.h.example複製到您項目的include/secrets.h並設置您的WiFi SSID和密碼(僅2.4 GHz):
將include/secrets.h添加到.gitignore。
2. 配置 platformio.ini¶
在項目根目錄中創建platformio.ini:
[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
將board更改為匹配您的主機板。將path/to/idryer-core替換為庫的實際路徑。
3. 複製01_blink_status示例¶
將examples/01_blink_status/01_blink_status.ino的內容複製到您項目的src/main.cpp。此示例不需要傳感器或其他依賴項 — 只需要一個最小的組合根。
4. 刷入¶
5. 打開串行監視器¶
預期日誌序列:
[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)
在門戶中輸入PIN(步驟6)後:
[CLOUD] Device claimed! deviceId=...
[CLOUD] Connecting to MQTT...
[CLOUD] MQTT connected!
[RT] Cloud Online
如果設備在PIN: ...消息處停止 — 這是正常的;繼續執行步驟6。
6. 在門戶中聲稱設備¶
打開portal.idryer.org,轉到**添加設備**,然後輸入串行監視器中的PIN。成功聲稱後,設備將轉變為線上,內置LED將每500毫秒閃爍一次。
詳細的聲稱流程:登錄。
接下來做什麼¶
- 添加傳感器 — 04-patterns/01-add-sensor.md
- 添加外圍設備 — 04-patterns/02-add-peripheral.md
- 完整API參考 — 03-public-api/01-link-api-reference.md
- 內部工作原理 — 05-architecture/01-composition-root.md