OPC基金會(huì)提供了OPC UA .NET標(biāo)準(zhǔn)庫(kù)以及示例程序，但官方文檔過(guò)于簡(jiǎn)單，光看官方文檔和示例程序很難弄懂OPC UA .NET標(biāo)準(zhǔn)庫(kù)怎么用，花了不少時(shí)間摸索才略微弄懂如何使用，以下記錄如何從一個(gè)控制臺(tái)程序開(kāi)發(fā)一個(gè)OPC UA服務(wù)器。
安裝Nuget包
安裝OPCFoundation.NetStandard.Opc.Ua
主程序
修改Program.cs代碼如下：
using Opc.Ua;
using Opc.Ua.Configuration;
using Opc.Ua.Server;
namespace SampleOpcUaServer
{
internal class Program
{
static void Main(string[] args)
{
ApplicationInstance application = new ApplicationInstance();
application.ConfigSectionName = "OpcUaServer";
application.LoadApplicationConfiguration(false).Wait();
application.CheckApplicationInstanceCertificate(false, 0).Wait();
var server = new StandardServer();
var nodeManagerFactory = new NodeManagerFactory();
server.AddNodeManager(nodeManagerFactory);
application.Start(server).Wait();
var nodeManager = nodeManagerFactory.NodeManager;
var simulationTimer = new System.Timers.Timer(1000);
var random = new Random();
simulationTimer.Elapsed += (sender, EventArgs) =>
{
nodeManager?.UpdateValue("ns=2;s=Root_Test", random.NextInt64());
};
simulationTimer.Start();
Console.WriteLine("Endpoints:");
foreach (var endpoint in server.GetEndpoints().DistinctBy(x => x.EndpointUrl))
{
Console.WriteLine(endpoint.EndpointUrl);
}
Console.WriteLine("按Enter添加新變量");
Console.ReadLine();
nodeManager?.AddVariable("ns=2;s=Root", null, "Test2", (int)BuiltInType.Int16, ValueRanks.Scalar);
Console.WriteLine("已添加變量");
Console.ReadLine();
}
}
}
上述代碼中：
ApplicationInstance是OPC UA標(biāo)準(zhǔn)庫(kù)中用于配置并承載OPC UA Server和檢查證書(shū)的類(lèi)。application.ConfigSectionName指定了配置文件的名稱(chēng)，配置文件是xml文件，將會(huì)在程序文件夾查找名為OpcUaServer.Config.xml的配置文件。配置文件內(nèi)容見(jiàn)后文。application.LoadApplicationConfiguration加載前面指定的配置文件。如果不想使用配置文件，也可通過(guò)代碼給application.ApplicationConfiguration賦值。- 有
StandardServer和ReverseConnectServer兩種作為OPC UA服務(wù)器的類(lèi)，ReverseConnectServer派生于StandardServer，這兩種類(lèi)的區(qū)別未深入研究，用StandardServer可滿(mǎn)足基本的需求。 - OPC UA的地址空間由節(jié)點(diǎn)組成，簡(jiǎn)單理解節(jié)點(diǎn)就是提供給OPC UA客戶(hù)端訪(fǎng)問(wèn)的變量和文件夾。通過(guò)
server.AddNodeManager方法添加節(jié)點(diǎn)管理工廠(chǎng)類(lèi)，NodeManagerFactory類(lèi)定義見(jiàn)后文。 - 調(diào)用
application.Start(server)方法后，OPC UA Server就會(huì)開(kāi)始運(yùn)行，并不會(huì)阻塞代碼，為了保持在控制臺(tái)程序中運(yùn)行，所以使用Console.ReadLine()阻塞程序。 nodeManager?.UpdateValue是自定義的更新OPC UA地址空間中變量值的方法。nodeManager?.AddVariable在此演示動(dòng)態(tài)添加一個(gè)新的變量。
OPC UA配置文件
新建OpcUaServer.Config.xml文件。
在屬性中設(shè)為“始終賦值”。
內(nèi)容如下：
<?xml version="1.0" encoding="utf-8"?>
<ApplicationConfiguration
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ua="http://opcfoundation.org/UA/2008/02/Types.xsd"
xmlns="http://opcfoundation.org/UA/SDK/Configuration.xsd"
>
<ApplicationName>Sample OPC UA Server</ApplicationName>
<ApplicationUri>urn:localhost:UA:OpcUaServer</ApplicationUri>
<ProductUri>uri:opcfoundation.org:OpcUaServer</ProductUri>
<ApplicationType>Server_0</ApplicationType>
<SecurityConfiguration>
<ApplicationCertificate>
<StoreType>Directory</StoreType>
<StorePath>%CommonApplicationData%\OPC Foundation\pki\own</StorePath>
<SubjectName>CN=Sample Opc Ua Server, C=US, S=Arizona, O=SomeCompany, DC=localhost</SubjectName>
</ApplicationCertificate>
<TrustedIssuerCertificates>
<StoreType>Directory</StoreType>
<StorePath>%CommonApplicationData%\OPC Foundation\pki\issuer</StorePath>
</TrustedIssuerCertificates>
<TrustedPeerCertificates>
<StoreType>Directory</StoreType>
<StorePath>%CommonApplicationData%\OPC Foundation\pki\trusted</StorePath>
</TrustedPeerCertificates>
<RejectedCertificateStore>
<StoreType>Directory</StoreType>
<StorePath>%CommonApplicationData%\OPC Foundation\pki\rejected</StorePath>
</RejectedCertificateStore>
</SecurityConfiguration>
<TransportConfigurations></TransportConfigurations>
<TransportQuotas>
<OperationTimeout>600000</OperationTimeout>
<MaxStringLength>1048576</MaxStringLength>
<MaxByteStringLength>1048576</MaxByteStringLength>
<MaxArrayLength>65535</MaxArrayLength>
<MaxMessageSize>4194304</MaxMessageSize>
<MaxBufferSize>65535</MaxBufferSize>
<ChannelLifetime>300000</ChannelLifetime>
<SecurityTokenLifetime>3600000</SecurityTokenLifetime>
</TransportQuotas>
<ServerConfiguration>
<BaseAddresses>
<ua:String>https://localhost:62545/OpcUaServer/</ua:String>
<ua:String>opc.tcp://localhost:62546/OpcUaServer</ua:String>
</BaseAddresses>
<SecurityPolicies>
<ServerSecurityPolicy>
<SecurityMode>SignAndEncrypt_3</SecurityMode>
<SecurityPolicyUri>http://opcfoundation.org/UA/SecurityPolicy#Basic256Sha256</SecurityPolicyUri>
</ServerSecurityPolicy>
<ServerSecurityPolicy>
<SecurityMode>None_1</SecurityMode>
<SecurityPolicyUri>http://opcfoundation.org/UA/SecurityPolicy#None</SecurityPolicyUri>
</ServerSecurityPolicy>
<ServerSecurityPolicy>
<SecurityMode>Sign_2</SecurityMode>
<SecurityPolicyUri></SecurityPolicyUri>
</ServerSecurityPolicy>
<ServerSecurityPolicy>
<SecurityMode>SignAndEncrypt_3</SecurityMode>
<SecurityPolicyUri></SecurityPolicyUri>
</ServerSecurityPolicy>
</SecurityPolicies>
<UserTokenPolicies>
<ua:UserTokenPolicy>
<ua:TokenType>Anonymous_0</ua:TokenType>
</ua:UserTokenPolicy>
<ua:UserTokenPolicy>
<ua:TokenType>UserName_1</ua:TokenType>
</ua:UserTokenPolicy>
<ua:UserTokenPolicy>
<ua:TokenType>Certificate_2</ua:TokenType>
</ua:UserTokenPolicy>
</UserTokenPolicies>
<DiagnosticsEnabled>false</DiagnosticsEnabled>
<MaxSessionCount>100</MaxSessionCount>
<MinSessionTimeout>10000</MinSessionTimeout>
<MaxSessionTimeout>3600000</MaxSessionTimeout>
<MaxBrowseContinuationPoints>10</MaxBrowseContinuationPoints>
<MaxQueryContinuationPoints>10</MaxQueryContinuationPoints>
<MaxHistoryContinuationPoints>100</MaxHistoryContinuationPoints>
<MaxRequestAge>600000</MaxRequestAge>
<MinPublishingInterval>100</MinPublishingInterval>
<MaxPublishingInterval>3600000</MaxPublishingInterval>
<PublishingResolution>50</PublishingResolution>
<MaxSubscriptionLifetime>3600000</MaxSubscriptionLifetime>
<MaxMessageQueueSize>10</MaxMessageQueueSize>
<MaxNotificationQueueSize>100</MaxNotificationQueueSize>
<MaxNotificationsPerPublish>1000</MaxNotificationsPerPublish>
<MinMetadataSamplingInterval>1000</MinMetadataSamplingInterval>
<AvailableSamplingRates>
<SamplingRateGroup>
<Start>5</Start>
<Increment>5</Increment>
<Count>20</Count>
</SamplingRateGroup>
<SamplingRateGroup>
<Start>100</Start>
<Increment>100</Increment>
<Count>4</Count>
</SamplingRateGroup>
<SamplingRateGroup>
<Start>500</Start>
<Increment>250</Increment>
<Count>2</Count>
</SamplingRateGroup>
<SamplingRateGroup>
<Start>1000</Start>
<Increment>500</Increment>
<Count>20</Count>
</SamplingRateGroup>
</AvailableSamplingRates>
<MaxRegistrationInterval>30000</MaxRegistrationInterval>
<NodeManagerSaveFile>OpcUaServer.nodes.xml</NodeManagerSaveFile>
</ServerConfiguration>
<TraceConfiguration>
<OutputFilePath>Logs\SampleOpcUaServer.log</OutputFilePath>
<DeleteOnLoad>true</DeleteOnLoad>
<TraceMasks>515</TraceMasks>
</TraceConfiguration>
</ApplicationConfiguration>
需要關(guān)注的內(nèi)容有：
ApplicationName：在通過(guò)OPC UA工具連接此服務(wù)器時(shí)，顯示的服務(wù)器名稱(chēng)就是該值。
ApplicationType：應(yīng)用類(lèi)型，可用的值有：
- Server_0：服務(wù)器
- Client_1：客戶(hù)端
- ClientAndServer_2：客戶(hù)機(jī)和服務(wù)器
- DisconveryServer_3：發(fā)現(xiàn)服務(wù)器。發(fā)現(xiàn)服務(wù)器用于注冊(cè)O(shè)PC UA服務(wù)器，然后提供OPC UA客戶(hù)端搜索到服務(wù)器。
SecurityConfiguration：該節(jié)點(diǎn)中指定了OPC UA的證書(shū)存儲(chǔ)路徑，一般保持默認(rèn)，不需修改。
ServerConfiguration.BaseAddresses：該節(jié)點(diǎn)指定OPC UA服務(wù)器的url地址。
ServerConfiguration.SecurityPolicies：該節(jié)點(diǎn)配置允許的服務(wù)器安全策略，配置通訊是否要簽名和加密。
ServerConfiguration.UserTokenPolicies：該節(jié)點(diǎn)配置允許的用戶(hù)Token策略，例如是否允許匿名訪(fǎng)問(wèn)。
AvailableSamplingRates：配置支持的變量采樣率。
TraceConfiguration：配置OPC UA服務(wù)器的日志記錄，設(shè)定日志記錄路徑，配置的路徑是在系統(tǒng)臨時(shí)文件夾下的路徑，日志文件的完整路徑是在%TEMP%\Logs\SampleOpcUaServer.log。
NodeManagerFactory
新建NodeManagerFactory類(lèi)，OPC UA server將調(diào)用該類(lèi)的Create方法創(chuàng)建INodeManager實(shí)現(xiàn)類(lèi)，而INodeManager實(shí)現(xiàn)類(lèi)用于管理OPC UA地址空間。內(nèi)容如下：
using Opc.Ua;
using Opc.Ua.Server;
namespace SampleOpcUaServer
{
internal class NodeManagerFactory : INodeManagerFactory
{
public NodeManager? NodeManager { get; private set; }
public StringCollection NamespacesUris => new StringCollection() { "http://opcfoundation.org/OpcUaServer" };
public INodeManager Create(IServerInternal server, ApplicationConfiguration configuration)
{
if (NodeManager != null)
return NodeManager;
NodeManager = new NodeManager(server, configuration, NamespacesUris.ToArray());
return NodeManager;
}
}
}
- 實(shí)現(xiàn)
INodeManagerFactory接口，需實(shí)現(xiàn)NamespacesUris屬性和Create方法。 NodeManager類(lèi)是自定義的類(lèi)，定義見(jiàn)后文。- 為了獲取
Create方法返回的NodeManager類(lèi)，定義了NodeManager屬性。
NodeManager
新建NodeManager類(lèi)：
using Opc.Ua;
using Opc.Ua.Server;
namespace SampleOpcUaServer
{
internal class NodeManager : CustomNodeManager2
{
public NodeManager(IServerInternal server, params string[] namespaceUris)
: base(server, namespaceUris)
{
}
public NodeManager(IServerInternal server, ApplicationConfiguration configuration, params string[] namespaceUris)
: base(server, configuration, namespaceUris)
{
}
protected override NodeStateCollection LoadPredefinedNodes(ISystemContext context)
{
FolderState root = CreateFolder(null, null, "Root");
root.AddReference(ReferenceTypes.Organizes, true, ObjectIds.ObjectsFolder);
root.EventNotifier = EventNotifiers.SubscribeToEvents;
AddRootNotifier(root);
CreateVariable(root, null, "Test", BuiltInType.Int64, ValueRanks.Scalar);
return new NodeStateCollection(new List<NodeState> { root });
}
protected virtual FolderState CreateFolder(NodeState? parent, string? path, string name)
{
if (string.IsNullOrWhiteSpace(path))
path = parent?.NodeId.Identifier is string id ? id + "_" + name : name;
FolderState folder = new FolderState(parent);
folder.SymbolicName = name;
folder.ReferenceTypeId = ReferenceTypes.Organizes;
folder.TypeDefinitionId = ObjectTypeIds.FolderType;
folder.NodeId = new NodeId(path, NamespaceIndex);
folder.BrowseName = new QualifiedName(path, NamespaceIndex);
folder.DisplayName = new LocalizedText("en", name);
folder.WriteMask = AttributeWriteMask.None;
folder.UserWriteMask = AttributeWriteMask.None;
folder.EventNotifier = EventNotifiers.None;
if (parent != null)
{
parent.AddChild(folder);
}
return folder;
}
protected virtual BaseDataVariableState CreateVariable(NodeState? parent, string? path, string name, BuiltInType dataType, int valueRank)
{
return CreateVariable(parent, path, name, (uint)dataType, valueRank);
}
protected virtual BaseDataVariableState CreateVariable(NodeState? parent, string? path, string name, NodeId dataType, int valueRank)
{
if (string.IsNullOrWhiteSpace(path))
path = parent?.NodeId.Identifier is string id ? id + "_" + name : name;
BaseDataVariableState variable = new BaseDataVariableState(parent);
variable.SymbolicName = name;
variable.ReferenceTypeId = ReferenceTypes.Organizes;
variable.TypeDefinitionId = VariableTypeIds.BaseDataVariableType;
variable.NodeId = new NodeId(path, NamespaceIndex);
variable.BrowseName = new QualifiedName(path, NamespaceIndex);
variable.DisplayName = new LocalizedText("en", name);
variable.WriteMask = AttributeWriteMask.None;
variable.UserWriteMask = AttributeWriteMask.None;
variable.DataType = dataType;
variable.ValueRank = valueRank;
variable.AccessLevel = AccessLevels.CurrentReadOrWrite;
variable.UserAccessLevel = AccessLevels.CurrentReadOrWrite;
variable.Historizing = false;
variable.Value = Opc.Ua.TypeInfo.GetDefaultValue(dataType, valueRank, Server.TypeTree);
variable.StatusCode = StatusCodes.Good;
variable.Timestamp = DateTime.UtcNow;
if (valueRank == ValueRanks.OneDimension)
{
variable.ArrayDimensions = new ReadOnlyList<uint>(new List<uint> { 0 });
}
else if (valueRank == ValueRanks.TwoDimensions)
{
variable.ArrayDimensions = new ReadOnlyList<uint>(new List<uint> { 0, 0 });
}
if (parent != null)
{
parent.AddChild(variable);
}
return variable;
}
public void UpdateValue(NodeId nodeId, object value)
{
var variable = (BaseDataVariableState)FindPredefinedNode(nodeId, typeof(BaseDataVariableState));
if (variable != null)
{
variable.Value = value;
variable.Timestamp = DateTime.UtcNow;
variable.ClearChangeMasks(SystemContext, false);
}
}
public NodeId AddFolder(NodeId parentId, string? path, string name)
{
var node = Find(parentId);
var newNode = CreateFolder(node, path, name);
AddPredefinedNode(SystemContext, node);
return newNode.NodeId;
}
public NodeId AddVariable(NodeId parentId, string? path, string name, BuiltInType dataType, int valueRank)
{
return AddVariable(parentId, path, name, (uint)dataType, valueRank);
}
public NodeId AddVariable(NodeId parentId, string? path, string name, NodeId dataType, int valueRank)
{
var node = Find(parentId);
var newNode = CreateVariable(node, path, name, dataType, valueRank);
AddPredefinedNode(SystemContext, node);
return newNode.NodeId;
}
}
}
上述代碼中：
- 需繼承
CustomNodeManager2，這是OPC UA標(biāo)準(zhǔn)庫(kù)中提供的類(lèi)。 - 重寫(xiě)
LoadPredefinedNodes方法，在該方法中配置預(yù)定義節(jié)點(diǎn)。其中創(chuàng)建了一個(gè)Root文件夾，Root文件夾中添加了Test變量。 root.AddReference(ReferenceTypes.Organizes, true, ObjectIds.ObjectsFolder)該語(yǔ)句將節(jié)點(diǎn)添加到OPC UA服務(wù)器根節(jié)點(diǎn)，如果不使用該語(yǔ)句，可在Server節(jié)點(diǎn)下看到添加的節(jié)點(diǎn)。CreateFolder是自定義的方法，用于簡(jiǎn)化創(chuàng)建文件夾節(jié)點(diǎn)。CreateVariable是自定義的方法，用于簡(jiǎn)化創(chuàng)建變量節(jié)點(diǎn)。UpdateValue是用于更新變量節(jié)點(diǎn)值的方法。其中修改值后，需調(diào)用ClearChangeMasks方法，才能通知客戶(hù)端更新值。AddFolder用于啟動(dòng)服務(wù)器后添加新的文件夾。AddVariable用于啟動(dòng)服務(wù)器后添加新的變量。
測(cè)試服務(wù)器
比較好用的測(cè)試工具有：
以下用OpcExpert測(cè)試。
瀏覽本地計(jì)算機(jī)可發(fā)現(xiàn)OPC UA服務(wù)器，可看到添加的Root節(jié)點(diǎn)和Test變量，Test變量的值會(huì)每秒更新。
源碼地址：https://github.com/Yada-Yang/SampleOpcUaServer
轉(zhuǎn)自https://www.cnblogs.com/yada/p/18257593
該文章在 2025/5/17 10:09:56 編輯過(guò)
400 186 1886
