Page History

Devices → Tutorial | Concept | How-to Guide | Reference

Creating Device Points

1. Navigate to Unified Namespace → Tags
2. Copy tags to be mapped
3. Go to Devices → Points
4. Paste copied tags
5. Configure point properties

Point Properties

Address Configuration

Static Addressing

Protocol-specific formats:

• Modbus: 40001, 30001, 10001
• ControlLogix: Controller.Tag[0]
• Siemens: DB100.DBW10
• OPC: ns=2;s=Channel.Device.Tag

Dynamic Addressing

Change addresses at runtime:

csharp

// Retrieve point configuration
DataTable dt

Adding and Editing Device Points

Device Points define specific values for each node that can be accessed using tags. The number of Device Points you can configure is related to the product model configured for the solution and your software license.

To configure Device Points, follow these steps:

1. Access Unified Namespace / Tags.
2. Copy the tags to be used.
3. Access Devices / Points.
4. Paste the copied tags.
5. Double-click the property you wish to edit on the row corresponding to the tag you want to modify.

Device Points Properties

The following table describes each available property you can configure when configuring a Device point. If a property column is not visible on the grid, enable it by right-clicking the grid header and selecting it from the list.

Dynamic Address Configuration

Everything in the Device configuration, from the Node to address and Tag mapping, can be changed online using scripts. 

The following example outlines a process for configuring dynamic addresses using MQTT telegrams.

Dynamic Address example

The address format is `/topic/@Tag.gateway/data`, where `@Tag.gateway` will be replaced with specific values. The MQQT telegrams are received on topics like the ones below:

• /topic/gateway/data:
• /topic/gatewayX/data
• /topic/gatewayY/data
• /topic/gatewayZ/data:

You need to configure the Points that will be used. Access Devices → Points to configure points defining their names, Node, Tags, and Address. 

To use the Dynamic Address through scrips, your code will need to execute the following steps:

1. First, it needs to retrieve the data of the desired point from the database using the GetDataTable method.
2. Then, you will update the Address field of the retrieved data row with a new address formed by concatenating Group , @Tag.Gateway , and /Device .
3. After performing the changes, your code will update the database with the new row data using UpdateDataRows.

The system will log an error if any error occurs during the updating process. Otherwise, it applies the changes to the database.

The following code presents an example of changing the Address for the desired point.

 = TK.ProjectDB.GetDataTable("DevicesPoints", 
    "TagName='Tag.

Temperature'");

// Update address
DataRow row = dt

.Rows[0];

row["Address"] = "Group01/" + @Tag.Gateway + "/Device01";

row.AcceptChanges();

// Apply changes
string error;
TK.ProjectDB.UpdateDataRows("DevicesPoints", 

row, out error);

Code Breakdown

To make it easier for you to understand the above example, next you find additional explanations related to core operations.

In the code block below, the first parameter identifies the Points table from which data is retrieved. In this case, the second parameter refers to the specific column used for filtering data, the Tag Name column. This column is used to identify the tag configured within the Points table. For instance, the tag Tag.Tag01.Velocity  is retrieved in this example.

TK.ProjectDB.ApplyProjectChanges();

Data Types

Native Type

Default - protocol handles conversion automatically

Override Types

Modifiers

Byte Order Adjustments

Scaling Configuration

Read Operations

Tag Value = (Device Value / Div) + Add

Write Operations

Device Value = (Tag Value - Add) * Div

Examples

Temperature scaling:

• Device: 0-1000 (tenths of degree)
• Div: 10, Add: 0
• Result: 0-100.0 degrees

Offset correction:

• Device: 0-100
• Div: 1, Add: -50
• Result: -50 to 50

Access Types

Configure read/write behavior:

• ReadWrite - Full bidirectional
• ReadOnly - Monitor only
• WriteOnly - Control only
• OnDemand - Manual trigger

See → Devices AccessTypes for detailed configuration

Dynamic Address Example

MQTT Topic Routing

csharp

public void UpdateMQTTAddress(string tagName, string gateway)
{
    string error;
    
    // Get point configuration
    DataTable dt

 = TK.ProjectDB.GetDataTable("DevicesPoints", 
        $"TagName='

{tagName}'");

The following code enables you to choose the new desired address. The string type tag @Tag.Gateway will receive a different name in the example.

    
    if (dt.Rows.Count > 0)
    {
        // Update address with gateway
        DataRow row = dt.Rows[0];
        row["Address"] = $"

The following line of code updates the Address internally in the system.

/topic/{gateway}/data";
        row.AcceptChanges();
        
        // Apply to project
        TK.ProjectDB.UpdateDataRows("DevicesPoints", 

            new DataRow[] { row }, out error);

If no error occurs in the update, you can apply the change to the project using the code below. From then on, the Address will use the new value previously entered on the script.

TK.ProjectDB.ApplyProjectChanges();

Importing Device Points from PLC addresses

Additionally, you can simplify the creation of Device Points with various methods for automatic data configuration import.

→ Read more about Importing PLC Addresses.

        
        if (string.IsNullOrEmpty(error))
        {
            TK.ProjectDB.ApplyProjectChanges();
            @Info.Trace($"Address updated: {row["Address"]}");
        }
        else
        {
            @Info.Trace($"Error: {error}");
        }
    }
}

Importing Points

Import Methods

• PLC program files (L5K, TIA)
• OPC browsing
• CSV/Excel files
• Online discovery

See → Importing PLC Addresses for procedures

Performance Optimization

Efficient Configuration

• Group consecutive registers
• Use block reads when possible
• Minimize individual points
• Optimize polling rates

Address Optimization

Good: 40001-40010 (block read)
Poor: 40001, 40003, 40005 (individual reads)

Best Practices Guidelines

•  Group Related Points - Organize by function
•  Use Native Types - Let protocol handle conversion
•  Document Addresses - Include descriptions
•  Test Scaling - Verify calculations
•  Plan Access Types - Minimize unnecessary writes
•  Validate Imports - Check addressing after import
•  Monitor Point Count - Stay within license limits

Troubleshooting

Point not updating:

• Verify node connection
• Check address format
• Review access type
• Test with OPC client

Wrong values:

• Check data type match
• Verify byte order
• Review scaling settings
• Test without modifiers

Write failures:

• Confirm write access
• Check PLC program
• Verify address writable
• Review error logs

Import issues:

• Validate source file
• Check address format
• Review tag mapping
• Test with sample

Diagnostics

Monitor point communication:

csharp

// Get point status
bool quality = @Tag.Temperature.Quality == 192;

// Check last update
DateTime timestamp = @Tag.Temperature.TimeStamp;

// Monitor errors
string lastError = @Device.Point["Temperature"].LastError;

// Communication statistics
int readCount = @Device.Point["Temperature"].ReadCount;
int writeCount = @Device.Point["Temperature"].WriteCount;

In this section...

In this section: