Engineer Onboarding

ENGINEER This guide helps engineers get started on Sensorclouds. Engineers can manage users and work with their own or assigned applications, devices, and dashboards.

What Engineers Can Do

Feature	Access
Users	Manage users within the tenant
Applications	View own/assigned, create new ones
Devices	Manage own/assigned devices, register new devices in own applications
Device Profiles	View TENANT-visible profiles + your own, create new profiles
Dashboards	View own/assigned, create new ones, assign to own user
Alarms	View all, create alarm rules
Commands	Send commands to own/assigned devices
OTA Updates	Upload firmware, manage OTA campaigns

Engineers can manage users but cannot delete any resources (applications, devices, profiles, firmware) and cannot manage tenant settings.

Getting Started

Log In

Use the credentials provided by your tenant admin. On first login, you may be prompted to change your temporary password.

After logging in, you'll see the tenant dashboard with all existing applications and devices.

Explore Existing Resources

Browse the sidebar to see what's already set up:

Applications — View all applications in your organization
Devices — See all registered devices and their status
Dashboards — View all dashboards created by the team
Alarms — Check existing alarm rules and active instances

Create an Application (if needed)

Go to Applications and click Add Application.

Name: Name your project (e.g., "Building A Climate Sensors")
Description: Brief summary of the project

Applications are your top-level organizational unit. Each groups a set of related devices.

Set Up a Device Profile

Go to Device Profiles and click Create Profile.

Name: Describe the device type (e.g., "DHT22 Sensor Node")
MQTT Settings: Configure topic structure (or use defaults)
Payload Decoder: Set to NONE for JSON, or CUSTOM for binary payloads
Visibility: Set to TENANT to share with the team, or PRIVATE to keep it yours

If your devices send non-JSON data, see the Writing Payload Decoders guide.

Register Devices

Navigate to your application's Devices tab and click Add Device.

Name: Unique device name
Device Profile: Select your profile

After registration, go to the device's Settings tab and click Generate Password to create MQTT credentials.

Verify Data Flow

Once your device is connected and sending data:

Check the Devices list — your device should show Online
Open the device detail → Telemetry tab to see incoming data
Check the Live Data view on your application to see all devices' data in real time

Build a Dashboard

Go to Dashboards and click Create Dashboard.

Add widgets to visualize your data:

Value widgets for current readings
Line charts for trends
Gauges for threshold monitoring
Toggle widgets for device control

See the Building Dashboards guide for detailed instructions.

Set Up Alarms

Go to Alarms and click Create Alarm Rule.

Configure alerts for critical conditions (e.g., temperature above 80, battery below 20%). You'll receive notifications in the Notification Center when alarms trigger.

See the Setting Up Alarms guide for details.

Key Differences from Admin

Capability	Admin	Engineer
View all applications	Yes	Yes
Create applications	Yes	Yes
Delete applications	Yes	No
Manage users	Yes	No
Delete devices / profiles / firmware	Yes	No
Assign dashboards to users	Yes	No
View all dashboards	Yes	Yes
Create dashboards / alarms	Yes	Yes

Tips

Use meaningful names: Good naming conventions (SiteA-Sensor-001) help when you have many devices
Set profile visibility: Use TENANT visibility for profiles the whole team should use, PRIVATE for work in progress
Test decoders early: If your devices send binary data, write and test the payload decoder before deploying devices in the field
Check notifications regularly: The Notification Center shows alarm triggers and system events for all devices in the tenant

On this page