Connector devices

What Is a Device Profile?

A device profile is a template that defines how a device communicates with the SolarTools platform. When connecting, every device declares which transport protocol (MQTT, HTTP, etc.) and which payload format (JSON, Binary, etc.) it uses — through a profile. The same profile can be assigned to multiple devices, allowing you to manage dozens of devices with a single configuration.

A profile also covers the telemetry keys the device will publish (e.g. voltage, current, temperature), attribute keys, and the MQTT topic configuration. With a correctly configured profile, incoming data is automatically mapped to the right fields by the platform.

Creating a Device Profile

To create a new device profile, navigate to Infrastructure → Devices → Device Profiles in the platform. Click the + Add Device Profile button at the top right of the screen. The modal that opens is divided into three tabs: Normal Profile Creation, Ready-made Templates, and Manage Templates.

Device Profiles — Screenshots

📋Profile List

Figure 1 — Device Profiles list; use the top-right button to add a new profile

⚙️Normal Profile

Figure 2 — Normal Profile form: name, protocol, telemetry/attribute keys and data rows

📡Topics & Save

Figure 3 — Continued: Topics configuration, Description field and the "Add Profile" button

📄Template

Figure 4 — Ready-made Templates: select a pre-saved template to create a profile instantly

🔗Template Detail

Figure 5 — Topics and telemetry config from the selected template are auto-filled

🛠️Manage Templates

Figure 6 — Manage Templates: edit or permanently remove saved templates

Normal Profile Creation

The Normal Profile Creation tab lets you configure a profile from scratch. Fill in the fields in order:

1. Profile Name — Enter a unique name that identifies the device (e.g. MQTT Inverter v1).
2. Transport Protocol — Choose the protocol your device supports (MQTT, HTTP, etc.).
3. Payload Format — Select the data format your device sends; JSON is recommended for most modern devices.
4. Telemetry Keys — Add the measurement keys the device will publish (e.g. voltage, current, temperature).
5. Attributes Keys — Enter static keys that describe device metadata (e.g. device_type, firmware_version).
6. Telemetry (key–value) — Add fixed key/value pairs row by row; used to pre-define default telemetry for the device.
7. Topics Configuration — If you are using MQTT, select the appropriate platform topic templates (telemetry_pub and attributes_pub are mandatory).
8. Once all fields are filled, click Add Profile.

Creating a Profile from Ready-made Templates

The Ready-made Templates tab lets you apply a pre-defined profile configuration with a single selection. When you choose a template from the dropdown, the transport protocol, payload format, telemetry/attribute keys, and topic configuration are filled in automatically. Edit the Profile Name if needed, then click Add Profile to save.

Managing Templates

The Manage Templates tab lists all previously saved templates. Click the edit (pencil) icon next to any template to update it, or the delete (trash) icon to permanently remove it. The delete action cannot be undone; any existing profiles created from that template continue to work independently.