// This example shows how to subscribe to all metrics of a given edge node, specifying an MQTT client ID.
//
// In order to publish or observe messages for this example, start the SparkplugEdgeNodeConsoleDemo program first.
//
// Find all latest examples here: https://opclabs.doc-that.com/files/onlinedocs/OPCLabs-ConnectivityStudio/Latest/examples.html .
// Sparkplug examples in C# on GitHub: https://github.com/OPCLabs/Examples-ConnectivityStudio-CSharp .
// Missing some example? Ask us for it on our Online Forums, https://www.opclabs.com/forum/index ! You do not have to own
// a commercial license in order to use Online Forums, and we reply to every post.
using System;
using OpcLabs.EasySparkplug;
using OpcLabs.EasySparkplug.OperationModel;
namespace SparkplugDocExamples.Consumer._EasySparkplugConsumer
{
partial class SubscribeEdgeNodeMetric
{
public static void ClientId()
{
// The MQTT client ID can be specified in the connection descriptor. When empty (the default), the component
// generates a unique, semi-random client ID.
// Note that the default port for the "mqtt" scheme is 1883.
var hostDescriptor = new SparkplugHostDescriptor("mqtt://localhost")
{
ConnectionDescriptor =
{
ClientId = "myApplication"
}
};
// Alternatively, the MQTT client ID can be specified in the broker URL using the "clientId" query parameter,
// as below.
var hostDescriptor2 = new SparkplugHostDescriptor("mqtt://localhost?clientId=myApplication");
// Instantiate the consumer object and hook events.
var consumer = new EasySparkplugConsumer();
consumer.MetricNotification += consumer_ClientId_MetricNotification;
Console.WriteLine("Subscribing...");
// In this example, we specify the precise Sparkplug group ID and edge node ID, but allow any metric name.
consumer.SubscribeEdgeNodeMetric(hostDescriptor, // or hostDescriptor2, if you prefer the alternative method
"easyGroup", "easySparkplugDemo", "#");
Console.WriteLine("Processing notifications for 20 seconds...");
System.Threading.Thread.Sleep(20 * 1000);
Console.WriteLine("Unsubscribing...");
consumer.UnsubscribeAllMetrics();
Console.WriteLine("Waiting for 5 seconds...");
System.Threading.Thread.Sleep(5 * 1000);
Console.WriteLine("Finished.");
}
static void consumer_ClientId_MetricNotification(object sender, EasySparkplugMetricNotificationEventArgs eventArgs)
{
// Handle different types of notifications.
Console.WriteLine();
switch (eventArgs.NotificationType)
{
case SparkplugNotificationType.Connect:
Console.WriteLine($"Connected to Sparkplug host, client ID: {eventArgs.ClientId}.");
break;
case SparkplugNotificationType.Disconnect:
Console.WriteLine("Disconnected from Sparkplug host.");
break;
case SparkplugNotificationType.Data:
Console.WriteLine("Received data from Sparkplug host.");
Console.WriteLine($"Metric name: {eventArgs.MetricName}");
Console.WriteLine($"Value: {eventArgs.MetricData?.Value}");
break;
case SparkplugNotificationType.Birth:
Console.WriteLine("Received birth message from Sparkplug host.");
Console.WriteLine($"Metric name: {eventArgs.MetricName}");
Console.WriteLine($"Value: {eventArgs.MetricData?.Value}");
break;
case SparkplugNotificationType.Death:
Console.WriteLine("Received death message from Sparkplug host.");
Console.WriteLine($"Metric name: {eventArgs.MetricName}");
break;
}
if (!eventArgs.Succeeded)
Console.WriteLine($"*** Failure: {eventArgs.ErrorMessageBrief}");
}
}
}
' This example shows how to subscribe to all metrics of a given edge node, specifying an MQTT client ID.
'
' In order to publish or observe messages for this example, start the SparkplugEdgeNodeConsoleDemo program first.
'
' Find all latest examples here: https://opclabs.doc-that.com/files/onlinedocs/OPCLabs-ConnectivityStudio/Latest/examples.html .
' Sparkplug examples in C# on GitHub: https://github.com/OPCLabs/Examples-ConnectivityStudio-CSharp .
' Missing some example? Ask us for it on our Online Forums, https://www.opclabs.com/forum/index ! You do not have to own
' a commercial license in order to use Online Forums, and we reply to every post.
Imports OpcLabs.EasySparkplug
Imports OpcLabs.EasySparkplug.OperationModel
Namespace Global.SparkplugDocExamples.Consumer._EasySparkplugConsumer
Partial Class SubscribeEdgeNodeMetric
Public Shared Sub ClientId()
' The MQTT client ID can be specified in the connection descriptor. When empty (the default), the component
' generates a unique, semi-random client ID.
' Note that the default port for the "mqtt" scheme is 1883.
Dim hostDescriptor = New SparkplugHostDescriptor("mqtt://localhost")
hostDescriptor.ConnectionDescriptor.ClientId = "myApplication"
' Alternatively, the MQTT client ID can be specified in the broker URL using the "clientId" query parameter,
' as below.
Dim hostDescriptor2 = New SparkplugHostDescriptor("mqtt://localhost?clientId=myApplication")
' Instantiate the consumer object and hook events.
Dim consumer = New EasySparkplugConsumer()
AddHandler consumer.MetricNotification, AddressOf consumer_ClientId_MetricNotification
Console.WriteLine("Subscribing...")
' In this example, we specify the precise Sparkplug group ID and edge node ID, but allow any metric name.
consumer.SubscribeEdgeNodeMetric(hostDescriptor, ' or hostDescriptor2, if you prefer the alternative method
"easyGroup", "easySparkplugDemo", "#")
Console.WriteLine("Processing notifications for 20 seconds...")
Threading.Thread.Sleep(20 * 1000)
Console.WriteLine("Unsubscribing...")
consumer.UnsubscribeAllMetrics()
Console.WriteLine("Waiting for 5 seconds...")
Threading.Thread.Sleep(5 * 1000)
Console.WriteLine("Finished.")
End Sub
Private Shared Sub consumer_ClientId_MetricNotification(ByVal sender As Object, ByVal eventArgs As EasySparkplugMetricNotificationEventArgs)
' Handle different types of notifications.
Console.WriteLine()
Select Case eventArgs.NotificationType
Case SparkplugNotificationType.Connect
Console.WriteLine($"Connected to Sparkplug host, client ID: {eventArgs.ClientId}.")
Case SparkplugNotificationType.Disconnect
Console.WriteLine("Disconnected from Sparkplug host.")
Case SparkplugNotificationType.Data
Console.WriteLine("Received data from Sparkplug host.")
Console.WriteLine($"Metric name: {eventArgs.MetricName}")
Console.WriteLine($"Value: {eventArgs.MetricData?.Value}")
Case SparkplugNotificationType.Birth
Console.WriteLine("Received birth message from Sparkplug host.")
Console.WriteLine($"Metric name: {eventArgs.MetricName}")
Console.WriteLine($"Value: {eventArgs.MetricData?.Value}")
Case SparkplugNotificationType.Death
Console.WriteLine("Received death message from Sparkplug host.")
Console.WriteLine($"Metric name: {eventArgs.MetricName}")
End Select
If Not eventArgs.Succeeded Then
Console.WriteLine($"*** Failure: {eventArgs.ErrorMessageBrief}")
End If
End Sub
End Class
End Namespace