Tutorials · 15 min
Your first device in 15 minutes
In 15 minutes you go through the whole Lab path with a simulated 2 kW water heater: a workspace, a profile from an example, validation, a compatibility report, a source and binding the profile. No hardware needed.
Before you start
You need a Lab Owner, Admin or Developer role to create workspaces and profiles. Your roles are in the account menu at the top right.
Everything in this tutorial runs on the simulator. Results are marked Simulator only and say nothing about a real water heater.
Steps
Create a workspace
On the Lab home page, find the New workspace panel, enter a name such as Water heater test and press Create workspace. The Lab opens its page.
Add the example profile
Open Examples in the left menu. On the Electric water heater 2 kW card press Add to workspace. The Lab creates a draft profile version and opens it.
Look at what the profile describes
Baseline 2 kW, power floor 0 kW, cap 2 kW: the heater can be switched off for a command but cannot be made to draw more. Minimum on and off times of 10 seconds protect the relay.
Run validation
On the Validation and deterministic tests panel press Validate saved version and run tests. The Lab checks schema, meaning and safety, then runs the standard scenario pack on the simulator. Wait until the status changes to Validated.
Open the compatibility report
In the test run list open the latest run. The verdict should be Pass with no blockers. You can download the report as JSON or Markdown.
Add a source
Go back to the workspace. In the Connect a source form create a project, then a source: type Controllable load, connection Simulator, baseline 2, floor 0, cap 2.
Initialize the simulator
On the source page press Initialize the simulator on the Step 3. Initialize the simulator panel. The digital twin shows power and limits.
Bind the profile
On the Device profile version panel on the source page choose the validated version and press Bind validated version. Only a validated version of the same type and connection can be bound, and the source's limits must fit within the profile's.
What just happened
- SchemaEvery field is present, with the right types and limits.
- MeaningLimits agree with each other and the required telemetry is there.
- SafetyTTL is required, failure closes control, restore goes to baseline.
- TestsThe standard scenario pack on the deterministic simulator.
- ReportVerdict, blockers and hashes so the report can be checked.
If any stage fails, the report names the reason and the version stays unvalidated.
The profile passed the same checks as any producer's profile. You can now change fields to match your device, create a new version and compare it with this one.
Next
To connect a real water heater, read the BOILER-FLEX-001 guide and the MQTT guide. Test commands on a source need separate owner consent and fresh telemetry.