Configure the connector for OPC UA

1. Select devices and then Create device:

   

   Tip

   You can use the filter box to search for devices.

2. On the Basics page, enter a device name and select New on the Microsoft.OpcUa tile to add an endpoint for the device:

   

3. Enter your endpoint information. For example, to use the OPC PLC simulator, enter the following values:

   Field	Value
   Name	opc-ua-connector-0
   Connector for OPC UA URL	opc.tcp://opcplc-000000:50000
   User authentication	Anonymous

4. Select Next and on the Additional Info page, enter any custom properties for the device.

5. Select Next to review your device details. Then select Create.

Run the following commands:

az iot ops ns device create -n opc-ua-connector-cli -g {your resource group name} --instance {your instance name} 

az iot ops ns device endpoint inbound add opcua --device opc-ua-connector-cli -g {your resource group name} -i {your instance name} --name opc-ua-connector-0 --endpoint-address "opc.tcp://opcplc-000000:50000"

To learn more, see az iot ops ns device.

Follow the steps in Manage secrets for your Azure IoT Operations deployment to add secrets for username and password in Azure Key Vault, project them into Kubernetes cluster, and reference them from your device configuration.

1. Follow the steps in Manage secrets for your Azure IoT Operations deployment to add secrets for username and password in Azure Key Vault, and project them into Kubernetes cluster.

2. Use the az iot ops ns device endpoint inbound add command with the --user-ref and --pass-ref parameters to add the references to the Azure Key Vault secrets you created.

To add an asset in the operations experience:

1. Select the Assets tab. Before you create any assets, you see the following screen:

   

   Tip

   You can use the filter box to search for assets.

2. Select Create asset.

3. On the asset details screen, enter the following asset information:

   • Inbound endpoint. Select your device inbound endpoint from the list.
   • Asset name
   • Description

4. Configure the set of custom properties that you want to associate with the asset. You can accept the default list of properties or add your own. The following properties are available by default:

   • Manufacturer
   • Manufacturer URI
   • Model
   • Product code
   • Hardware version
   • Software version
   • Serial number
   • Documentation URI

   

5. Select Next to go to the Datasets page.

Add a dataset to an asset

A dataset defines where the connector sends the data it collects from a collection of data points. An OPC UA asset can have multiple datasets. To create a dataset:

1. Select Create dataset.

2. Enter the details for the dataset such as its name and destination. For OPC UA assets, the destination is an MQTT topic. For example:

   

   Use the Start instance field to specify the starting node for resolving relative browse paths for data points in the dataset. For more information, see Resolve nodes dynamically using browse paths.

3. Select Create and next to create the dataset.

Add individual data points to a dataset

Now you can define the data points associated with the dataset. To add OPC UA data points:

1. Select Add data point.

2. Enter your data point details:

   • Data source. This value is the node ID from the OPC UA server.
   • Data point name (Optional). This value is the friendly name that you want to use for the data point. If you don't specify a data point name, the node ID is used as the data point name.
   • Sampling interval (milliseconds). You can override the default value for this data point.
   • Queue size. You can override the default value for this data point.

   

   The following table shows some example data point values that you can use with the built-in OPC PLC simulator:

   Data source	Data point name
   ns=3;s=FastUInt10	Temperature
   ns=3;s=FastUInt100	Humidity

   Note

   If you're using relative browse paths to resolve dynamic nodes, the Data source field contains a relative browse path. For more information, see Resolve nodes dynamically using browse paths.

3. On the data points page, select Next to go to the Add events page.

Use the following commands to add a thermostat asset to your device by using the Azure CLI. The commands add a dataset and two data points to the asset by using the point add command:

# Create the asset
az iot ops ns asset opcua create --name thermostat --instance {your instance name} -g  {your resource group name} --device opc-ua-connector --endpoint opc-ua-connector-0  --description 'A simulated thermostat asset'

# Add the dataset
az iot ops ns asset opcua dataset add --asset thermostat --instance {your instance name} -g {your resource group name} --name oven --data-source "ns=3;s=FastUInt10" --dest topic="azure-iot-operations/data/thermostat" retain=Keep qos=Qos1 ttl=3600

# Add the data points
az iot ops ns asset opcua datapoint add --asset thermostat --instance {your instance name} -g {your resource group name} --dataset oven --name temperature --data-source "ns=3;s=FastUInt10"
az iot ops ns asset opcua datapoint add --asset thermostat --instance {your instance name} -g {your resource group name} --dataset oven --name humidity --data-source "ns=3;s=FastUInt100"

# Show the dataset and datapoints
az iot ops ns asset opcua dataset show --asset thermostat -n default -g {your resource group name} --instance {your instance name}

When you create an asset by using the Azure CLI, you can define:

• Multiple data points by using the point add command multiple times.
• Multiple events by using the --event parameter multiple times.
• Optional information for the asset such as:
  • Manufacturer
  • Manufacturer URI
  • Model
  • Product code
  • Hardware version
  • Software version
  • Serial number
  • Documentation URI
• Default values for sampling interval, publishing interval, and queue size.
• Datapoint specific values for sampling interval, publishing interval, and queue size.
• Event specific values for sampling publishing interval, and queue size.
• The observability mode for each data point and event

Find and select the asset you created previously. Use the Asset details, data points, and Events tabs to make any changes:

On the view data points tab for a dataset, you can add data points, update existing data points, or remove data points.

To update a data point, select an existing data point and update the data point information. Then select Update:

To remove data points, select one or more data points and then select Remove data points:

You can also add, update, and delete events and properties in the same way.

When you're finished making changes, select Save to save your changes.

To list your assets associated with a specific endpoint, use the following command:

az iot ops ns asset query --device {your device name} --endpoint-name {your endpoint name}

To view the details of the thermostat asset, use the following command:

az iot ops ns asset show --name thermostat --instance {your instance name} -g {your resource group}

To update an asset, use the az iot ops ns asset opcua update command. For example, to update the asset's description, use a command like the following example:

az iot ops ns asset opcua update --name thermostat --instance {your instance name} -g {your resource group} --description "Updated factory PLC"

To list the thermostat asset's data points in a dataset, use the following command:

az iot ops ns asset opcua dataset show --asset thermostat --name default -g {your resource group} --instance {your instance name}

To list the thermostat asset's events, use the following command:

az iot ops ns asset opcua event list --asset thermostat -g {your resource group} --instance {your instance name}

To add a new data point to the thermostat asset, use a command like the following example:

az iot ops ns asset opcua dataset point add --asset thermostat --instance {your instance name} -g {your resource group name} --dataset default --name humidity --data-source "ns=3;s=FastUInt100"

To delete a data point, use the az iot ops ns asset opcua dataset point remove command.

You can manage an asset's events by using the az iot ops ns asset opcua event commands.

To delete an asset, select the asset you want to delete. On the Asset details page, select Delete. Confirm your changes to delete the asset:

To delete an asset, use a command that looks like the following example:

az iot ops ns asset delete --name thermostat -g {your resource group name} --instance {your instance name}