Page History

...

• Edge Gateways publishing Sparkplug based MQTT data
  • Our examples will use Ignition with MQTT Transmission for the Edge Gateway
• An MQTT Server
  • This could be any v3.1.1 compliant MQTT Server and our examples will use Cirrus Link Chariot MQTT Server.
• IoT Bridge for Azure (IBAZ)
• Azure Digital Twin (ADT)
• Azure Event Hub
• Azure Data Digital Twins Explorer

NEED IMAGE

There are some translations that need to take place between the components and these platforms have different capabilities that result in some limitations in how an Edge Gateway can be configured. For example, UDTs in Ignition support more data types that Azure Digital Twin (ADT) does. As a result, use of data types in Ignition must be limited to those supported by Azure Digital Twin (ADT) in order for data to properly show up and be updated in Azure Data Explorer. 

...

Mappings

Ignition and Azure Digital Twin Twins use different terminology for similar constructs. Those definitions are below.

• An Ignition 'UDT Definition' is mapped to an ADT 'Asset Modelmodel'.
• An Ignition 'UDT Instance' is mapped to a ADT 'Assetdigital twin'.

• Ignition

  'UDT parameters' are mapped to 'ADT Attributes'.Ignition 'UDT member tags' are mapped to 'ADT Measurements'

  ‘UDT parameters’ are mapped to specific digital twin property called ‘templateParameters’.

• Transform, Metric, and Hierarchy definitions in

  ADT

  Azure Digital Twins are not used by IBAZ.

...

Constraints and Limitations

Supported Data Types

Azure Digital Twin only supports Booleans, Integers, Doubles, and StringsBoolean, Date, DateTime, Double, Duration, Float, Integer, Long, String, and Time. As a result, this is the list of data types in Ignition that are supported for consumption into Azure Digital Twin.

• Boolean

• DateTime

• Double

• Float

• Integer

• Long

• Byte

  Will

  (will be up-casted to an Integer

  in ADT

  )

• Short

  Will

  (will be up-casted to an Integer

  in ADT

  )

• Integer

• Float

  Will

  (will be up-casted to

  an

  a Double

  in ADT

  )

• Double

• String

Any non-supported data type will be converted to a String in ADT and the measurement value for any instance will show an error with a message similar to "Long is not a valid datatype"

...

• Azure Digital Twin Asset Models have a limit of 200 Attributes and/or Measurements. Therefore UDTs with more than 200 Parameters or member tags will result in the Model not being created in Azure.
• UDT Tag and Property names that result in creating Azure Digital Twin Measurements and Attributes name, you must follow the regex expression pattern
  • ^[a-zA-Z0-9_-]+$ (for more information on regex expression patterns go to https://regexr.com)
• UDT parameter 'Integers' in Ignition are actually Long values. As a result, UDT parameters of type Integer are not supported at this time.

** check with Chad ** Nested/Hierarchical User Defined Types (UDTs)

...