i
IoTSpark
Back

Quick Start

From the welcome link to a running project, or creating a new project yourself in minutes.

Quick Test Wizard — 3 steps to flash firmware onto a real board

Opens at /workspace/projects/{id}/quick-test (or you're automatically redirected here from Trial Run — see the previous article — or from a welcome link — see the next article).

Step 1 — Connection Diagram

  1. View the connection diagram image and wire up the real hardware exactly as shown.
  2. Check "I have connected the hardware according to the diagram above".
  3. Click "Next" (only enabled once checked).

Step 2 — Plug in the board and connect

  1. Plug the ESP32 board into your computer using a USB cable capable of data transfer.
  2. Click "Connect Board", then choose the correct COM/ttyUSB port when the browser prompts you.

Result: a green box shows "Connected Successfully" along with the port name (click "Disconnect" to cancel). On error, a red box shows the error message plus a "Retry" button.

  1. Click "Next" (only enabled once connected successfully); "Back" returns you to Step 1.

Step 3 — Flash firmware

  1. The system automatically checks MQTT and shows "MQTT Connection is ready."
  2. The "Build Firmware" area:
    • Project owner: sees a "Build Project" button (first time) / "Rebuild" to build right here.
    • Not the project owner: only sees a read-only status — "Firmware ready from the author's build", or a warning "The author has not built firmware yet. Please contact the author."
  3. Once "Firmware Ready", click "Flash Firmware" in the "Flash Firmware to Board" area.
  4. Watch "Flashing firmware…".

Result: a green box shows "Firmware flashed successfully!", and the Serial Monitor opens automatically right below to show the data sent by the board. Click "Flash Again" if you want to flash it again.

  1. After flashing:
    • Project owner: a "Confirm Build Works" box — click "Confirm Build Successful" to attach a "Tested" label.
    • Others: a "Code not working?" box — enter a description of the issue, then click "Report Issue to Owner".

Example

With the "Room Temperature & Humidity Monitoring Station" project (ESP32 + DHT22): after wiring the DHT22 correctly according to the diagram and flashing the firmware, the Serial Monitor will continuously print lines like Nhiet do: 27.4C - Do am: 61% — this is proof the board is genuinely running, not simulated.