Adding Devices

Learn how to add new devices to your SiliconWit.IO account, configure data fields and commands, and use the JSON import tool for quick setup.

From the Dashboard

1. Log in to your Dashboard
2. Click “Add Device” on the devices page
3. Fill in the required details (see sections below)
4. Click “Create Device”
5. Copy and save your Device ID and Access Token

Caution

Save your Access Token immediately! It is only shown once for security.

Basic Information

Field	Required	Description
Name	Yes	A descriptive name (e.g., “Living Room Sensor”)
Type	Yes	Sensor, Actuator, Controller, Tracker, Meter, or Gateway
Description	No	Optional notes about this device

Device types explained:

• Sensor - Collects and sends data (temperature, humidity, motion)
• Actuator - Receives commands and performs actions (relay, motor, LED)
• Controller - Runs logic and controls processes (PLC, RTU, ESP32)
• Tracker - Reports location or movement (GPS, asset, fleet)
• Meter - Measures consumption or flow (energy, water, gas)
• Gateway - Bridges multiple devices or protocols

Configuration

Data Direction

Controls whether the device sends data, receives commands, or both:

• Send Only - Device sends telemetry data to the cloud
• Receive Only - Device receives commands from the dashboard
• Bidirectional - Device sends data and receives commands

Selecting Bidirectional (or choosing Actuator/Controller as the device type) reveals the Commands section.

Connectivity

Choose how your device connects:

• WiFi + MQTT, Ethernet + MQTT, 4G/LTE + MQTT, 2G/GPRS + MQTT
• WiFi + HTTP, 4G/LTE + HTTP
• NB-IoT, LoRaWAN

Data Interval

How often the device sends data. Choose from presets (1s, 10s, 30s, 1m, 5m, 15m, 1h, 6h, 24h) or set a custom value in seconds, minutes, or hours.

Schema Mode

• Strict (default for free plan) - Only data matching your defined fields is accepted; unknown fields are silently dropped
• Flexible (paid plans) - Any valid JSON payload is accepted and stored

Camera Snapshots

Enable this if your device uploads images via HTTP POST. Images are stored and viewable on the device detail page.

Data Fields

Data fields define the telemetry values your device sends. Each field has:

Property	Required	Description
Name	Yes	Machine-readable key (lowercase, numbers, underscores, 1-50 chars). Example: temp
Label	Yes	Human-readable display name (1-100 chars). Example: Temperature
Unit	No	Measurement unit. Example: °C

Plan limits:

Plan	Max Fields
Free	5
Starter	20
Business	50
Scale	50
Enterprise	Admin-configured

Adding Fields Manually

Click Add in the Data Fields section header to add fields one at a time. Fill in the name, label, and unit for each.

JSON Import for Fields

For devices with many data points, use the JSON import tool instead of adding fields one by one:

1. Click Import in the Data Fields section header
2. Paste a JSON array or click Browse File to load a .json file
3. Click Validate to check for errors
4. Click Import Fields to populate the form

Example JSON:

[
  { "name": "temp", "label": "Temperature", "unit": "°C" },
  { "name": "humidity", "label": "Humidity", "unit": "%" },
  { "name": "pressure", "label": "Pressure", "unit": "hPa" },
  { "name": "battery", "label": "Battery Level", "unit": "%" },
  { "name": "rssi", "label": "Signal Strength", "unit": "dBm" }
]

Tip

Click Export Current to get the current fields as JSON. You can edit the output, copy it, or download it as a file - handy for duplicating a device’s configuration.

Other Field Actions

• Copy - Copies current fields to clipboard as JSON
• Clear - Removes all fields at once
• Trash icon - Removes a single field

Commands

Commands let you control your device from the dashboard. They appear when the device type is Actuator or Controller, or the direction is Receive Only or Bidirectional.

Each command has:

Property	Required	Description
Name	Yes	Machine-readable key (same rules as field names)
Label	Yes	Human-readable display name
Type	Yes	Toggle, Button, Slider, or JSON

Command types:

Type	Description	Example
Toggle	On/off switch	Relay control, LED on/off
Button	One-shot trigger	Reboot device, take a reading
Slider	Numeric range (requires min and max)	Fan speed 0-100, brightness 0-255
JSON	Custom JSON payload (paid plans only)	Multi-field configuration

JSON Import for Commands

Works the same way as field import:

1. Click Import in the Commands section header
2. Paste or browse for a JSON array
3. Validate and import

Example JSON:

[
  { "name": "relay", "label": "Light Relay", "type": "toggle" },
  { "name": "fan_speed", "label": "Fan Speed", "type": "slider", "min": 0, "max": 255 },
  { "name": "reboot", "label": "Reboot Device", "type": "button" }
]

For slider commands, min and max are required and min must be less than max.

After Creating a Device

Once created, the device detail page shows:

• Device ID and Access Token for MQTT/HTTP connection
• Connection code snippets in Arduino, Python, MicroPython, and Node.js
• Telemetry chart once data starts arriving
• Control panel for sending commands (if applicable)

Next Steps

• ESP32 Setup - Connect an ESP32 sensor
• ESP32 Relay Control - Bidirectional control example
• MQTT Topics & Payloads - Message format reference
• Dashboard Alerts - Set up threshold alerts