Skip to content

Console · Points & Profiles

Points and profiles are the definition side of the data: a profile describes what a class of devices can do (points / commands / events), and points under it carry the actual data. This page covers managing both layers in the console — creating a profile, defining its points, binding devices to it — and the API behind each UI action.

You are here: you've created devices in Device Management and now need to define "what data this device has". Field-level semantics are in Profile and Point; how attributes get filled is in Attributes & Config.

Profile management

Open Profile Management. The layout mirrors device management: toolbar (search / filters / Add) + profile card list + pagination; card actions are enable/disable (the thing-model switch) and delete.

Adding a profile: fill in the name and code (profileCode, unique per tenant) and save — the profile itself is just the shell; its capabilities come from the point / command / event definitions below.

Profile detail has four tabs:

TabContent
Profile infoName, code, enable status and other base fields
Related pointsThe points this profile defines (read/write attributes, unit, type)
Related commandsDevice-level custom command definitions
Related eventsEvent definitions (externally reported events)

Disabling a profile (thing-model switch off) stops its capability definitions from participating in collection and command validation for the devices under it — cheaper than disabling devices one by one when pausing a whole class.

Point management

Open Points (from the profile detail's related-points tab, or directly from the navigation). The toolbar searches by device / profile / name and filters by enable status; card actions: edit, enable/disable, delete, detail.

Key fields when adding / editing a point:

FieldNotes
Name / codeDisplay name + pointCode (unique per profile)
Read/write typerwFlag: read-only / write-only / read-write — decides whether write commands are possible
Unit & precisionFor display and conversion
Driver attribute configThe point's protocol-level parameters (e.g. Modbus slaveId/functionCode/offset) — point-level commands take their values from here, not from command attributes

Read/write semantics for point values (latest/list endpoints, command polling) are in Data & Commands.

UI actions mapped to APIs

UI actionAPI (via gateway, manager center)Semantics
Profile searchPOST …/profile/listPaginated query, tenant-isolated
Add profilePOST …/profile/addCreates the profile (no ID returned)
Profile enable/disablePOST …/profile/update (enableFlag)Thing-model switch
Point searchPOST …/point/listFilters by device / profile supported
Add / edit pointPOST …/point/add / …/point/updateAttribute config submitted together
Point enable/disable / delete…/point/update / …/point/delete

Further reading

Released under the AGPL-3.0 License