Skip to main content
Version: Next

Tags Reference

This reference guide covers data types, address formats, quality codes, and troubleshooting for tags.

Working with Shared Tags​

Purpose: Access tags from other AI SCADA instances over the network.

Step 1: Create a Shared Channel​

  1. Navigate to Shared Channels tab
  2. Click Add → AI SCADA Station
  3. Configure connection:
    • Channel Name: Identifier for this remote station
    • Server IP: IP address of the remote AI SCADA instance
    • Port: Default 18000
  4. Click Confirm

📷 [Screenshot: Shared channel configuration dialog]

Step 2: Browse and Add Remote Tags​

  1. Select the shared channel
  2. Click Browse Remote Tags
  3. Select tags from the remote station's tag tree
  4. (Optional) Set a Prefix to identify the source station (e.g., StationA_)
  5. Click Add

Example:

Local Tag NameRemote Tag NameSource
StationA_TemperatureTemperatureStation A (192.168.1.10)
StationB_PressurePressureStation B (192.168.1.20)

💡 Tip: Use prefixes to avoid name conflicts when importing tags from multiple stations.

Quality Status Codes​

CodeDescriptionAction
0SuccessNormal operation
1Tag name not foundVerify tag exists
2Data type mismatchCheck data type compatibility
3Device disconnectedTroubleshoot network/device
4Other errorCheck logs for details

Troubleshooting​

"Quality Status = 3" (Device Disconnected)​

Cause: Communication failure with the device.

Solution:

  1. Verify network connectivity (ping the device IP)
  2. Check device power and status LEDs
  3. Verify IP address, port, and device ID match the device configuration
  4. Check firewall settings (allow port 502 for Modbus TCP)
  5. Review device logs for errors

"Quality Status = 2" (Data Type Mismatch)​

Cause: Attempting to write a value that doesn't match the tag's data type.

Solution:

  • Verify the value is within the data type's range
  • Check for decimal values being written to integer tags
  • Ensure string length doesn't exceed the configured limit

Tags Not Updating in Views​

Cause: Poll Mode is set to "Page Usage" but the page is not open.

Solution:

  • Change Poll Mode to "Service Running" for tags that must always update
  • Or ensure the view using the tag is open

Address Overlap Warning​

Cause: Two tags reference overlapping memory addresses.

Solution:

  • Review the address configuration
  • Adjust addresses to eliminate overlap
  • Or acknowledge the overlap if intentional (e.g., reading a 32-bit value as two 16-bit values)

PDU Length Exceeded​

Cause: A tag's data length exceeds the configured PDU limit.

Solution:

  • Increase the PDU Length in the channel's advanced settings
  • Or split the tag into smaller tags

Next Steps​

Last updated on