Serial Studio OPC UA 驱动完全指南从端点发现、标签订阅到安全连接与项目生成【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio本篇技术指南以 Serial Studio开源遥测仪表板内置的 OPC UA 客户端驱动为核心讲解如何通过opc.tcp://连接 PLC、SCADA 网关等工业设备浏览其地址空间中的标签Tags以订阅Subscription或轮询Polling方式将实时值流入仪表板并自动生成可视化项目。读完本文你将掌握端点发现与安全策略选择、标签浏览与类型映射、订阅/轮询双通道机制、时间戳语义、命令行与 Socket API 的完整用法以及首次安全连接时的证书信任流程。仓库中的实现证据如 OpcUa.h、OpcUaTypes.h、OpcUaWire.h会与官方文档 Drivers-OPC-UA.md 相互印证帮助你从原理层理解每一个配置项的行为。OPC UA 基础概念OPC UAIEC 62541是现代自动化设备通过以太网暴露的面向标签tag-oriented接口。PLC、SCADA 服务器和网关会发布一个可浏览的地址空间address space其中包含有名称、有类型的变量节点客户端订阅自己关心的变量服务器便会推送变化。在 Serial Studio 中OPC UA 驱动以Pro 版本功能的形式存在实现的是一个完整的 OPC UA客户端它发现服务器的端点endpoint、浏览其标签、根据选择构建项目并把实时值以二进制帧的形式流式送入仪表板。由于 OPC UA 是跨厂商的通用标准一个驱动即可覆盖多种设备Rockwell 控制器经 FactoryTalk Linx Gateway、KEPServerEX 或 Ignition 后面的任意设备、Siemens S7-1200/1500 与 WinCC、Beckhoff TwinCAT、CODESYS 运行时、BR、WAGO 以及 Schneider PLC 等。厂商名称在此仅用于说明兼容性——该驱动遵循的是标准本身而非任何厂商私有方言。地址空间与节点一个 OPC UA 服务器本质上是一棵树。在Objects文件夹下厂商按层级组织文件夹工厂、产线、机器文件夹内是变量节点variable nodes也就是常说的标签。每个节点都有节点 IDnode id如ns2;sPlant.Line1.Filler.Level_pct字符串形式或ns3;i1017数字形式显示名称display name数据类型data type访问级别access level。客户端从不接触寄存器或字节偏移它按节点 ID 请求值收到的是一组带状态码status codeGood 或某种 Bad 原因和源时间戳source timestamp来自设备自身时钟的强类型值。从源码看驱动为节点属性维护了一套与规范一致的枚举OpcUaTypes.h 中NodeAttribute的取值NodeId1、BrowseName3、Value13、DataType14、AccessLevel17 等直接对应 OPC UA 属性 ID因此编组层marshal可以按类型转换而非查表NodeClass以位掩码形式组织Object1、Variable2、Method4……一次浏览可同时请求多种节点类。可读性由访问级别的kAccessLevelCurrentRead 0x01u位决定这与文档中无读权限的标签可见但不可勾选的行为一一对应。两种取值方式方式原理特点Subscription订阅客户端创建带发布间隔publishing interval的订阅并添加受监控项monitored items服务器对每个受监控项采样每次变化即发布高效路径变化才推送Read读取客户端一次请求中直接读取一组节点的当前值简单但需要客户端自己轮询订阅是 Serial Studio 的默认与首选路径Read 则作为订阅被拒绝或失败时的回退方案。端点与安全服务器会按安全配置为每种组合各通告一个端点endpoint。每个端点把安全策略security policyNone、Basic256Sha256……与消息安全模式message security modeNone、Sign、Sign Encrypt配对。客户端选定一个端点后与它建立安全通道secure channel。Serial Studio 自带内置加密的 OPC UA 协议栈因此服务器通告的每一个端点都能连通。它支持六种安全策略安全策略说明None不加密Basic128Rsa15已被 OPC 基金会废弃SHA-1 与 RSA-1.5 不再安全Basic256已被 OPC 基金会废弃Basic256Sha256当前广泛使用的推荐策略Aes128_Sha256_RsaOaep新一代加密策略Aes256_Sha256_RsaPss新一代加密策略每种安全策略都可在Sign消息被认证或Sign Encrypt认证且机密模式下使用。机器上无需安装任何东西、也不会从系统取用任何组件协议栈随应用一起分发因此在每台电脑上同一构建的行为完全一致——这正是 OpcUaEndpointSelection.h 中策略目录policy catalogue与端点排名被设计为纯函数pure functions的原因不依赖会话、设置或驱动状态便于单元测试直接验证排名逻辑。Basic128Rsa15与Basic256之所以仍被提供是因为现场控制器依然在通告它们。它们在任何出现的地方都被标记为deprecated并且永远不会被自动选中——自动选择逻辑selectBestEndpoint会避开废弃策略。登录方式有三种Anonymous匿名、Username / Password用户名/密码、X.509 证书。注意只有当消息模式为 Sign Encrypt 时密码才受通道保护Setup 面板会在密码可能明文传输时发出警告并在通道开始加密后停止警告。对应的驱动在 OpcUa.h 中暴露了credentialsExposed与allowPlaintextPassword两个属性是否允许明文密码的确认是**按安装per-installation**记录的与信任库放在一起、永不出现在项目中——这意味着打开别人的项目文件永远不会顺带授予这个安全确认。Serial Studio 如何使用它驱动在主线程上运行内置的 OPC UA 客户端。一个数据源 一个会话 一台服务器该会话订阅每一个被选中的标签。配置模型1. Endpoint端点服务器 URL格式为opc.tcp://host:port/path默认值opc.tcp://127.0.0.1:4840。端口 4840 是 IANA 分配给 OPC UA 的默认端口OpcUaTypes.h 中以kDefaultPort 4840常量固化URL 省略端口时自动补全。按下Discover可获取服务器的端点列表在所选认证方式可用的用户令牌user token范围内自动挑选最安全的端点绝不单独选一个废弃策略而你显式选择的端点会在下一次发现时被保留。未选择端点直接连接时也会先执行同样的发现流程。一个关键设计Serial Studio总是拨号你输入的 host 和 port其余部分策略、模式等采用发现到的描述。这是因为服务器通告的往往是自己的主机名如opc.tcp://PLC-01:4840从工程师的笔记本电脑上几乎无法解析——这一坚持用户输入的主机、采纳发现到的其余信息的策略在 OpcUa.cpp 的拨号路径中实现也是发现成功但连接超时类问题的排查锚点见下文常见陷阱。2. Poll Interval (ms)轮询间隔该间隔同时用于请求订阅的发布间隔、读定时器以及数据源的帧率。默认100 ms并被钳制在10–60000 ms范围内——OpcUaSubscriptions.h 中的kOpcUaMinIntervalMs 10与kOpcUaMaxIntervalMs 60000与 CLI 选项说明--opcua-interval注释同样注明 10-60000、默认 100保持完全一致。当服务器把间隔向上修订revise到其最小值以上时PLC 内嵌服务器通常把下限设在 50-100 ms面板下方的状态行报告的是实际生效的速率而非请求值。驱动通过revisedInterval属性对外暴露这一信息。3. Security安全端点列表显示发现到的端点行格式为policy / mode / url。当某行通告的用户身份令牌与所选认证方式匹配时该行才可被选中endpointSelectable。4. Policy and Mode策略与模式决定无显式选择时拨号要求什么以及自动选择以什么为衡量基准。选择除None之外的任何策略都会展开Mode选择器Sign 或 Sign Encrypt。5. Authentication认证Anonymous默认Username / Password密码存放在与 MQTT 驱动相同的按机器保存的凭据保险库CredentialVault见 OpcUa.h 中的::MQTT::CredentialVault m_vault中在机器设置里混淆存储按主机和端口作为键绝不写入项目文件X.509 Certificate选择证书及其私钥只保存两者的路径私钥本身永不落盘。6. Tags标签浏览Browse Tags...对话框打开一个只浏览browse-only的会话每次展开只获取一层一次 Browse 加一次对该层整体的批量 Read。在展开之前不会读取节点下方的任何内容——因此一个带十万节点的网关也能保持响应。值得注意的浏览细节变量也会展开PLC 结构体与 UDT 会暴露其成员以及EngineeringUnits/EURange属性作为子变量。源码中浏览逻辑以两种引用集行走OpcUaTypes.h 的ReferenceKind区分Hierarchical层级树本身与HasProperty勾选变量的 EngineeringUnits/EURange 属性查找勾选文件夹 全选勾选一个文件夹会选中其下所有可读且受支持的变量包括之后展开时才取到的变量Select All Readable勾选当前已取回的全部可读项OK提交选择Cancel与窗口关闭按钮均丢弃选择未展开分支中的标签会保留原位最多可选中2048 个通道超过512时对话框会警告因为过宽的帧会拖慢仪表板。这两个数字在 OpcUaWire.h 中即kMaxTags 2048与kSoftTagLimit 512会话已连接时的编辑会在连接关闭时生效deferred tags 机制。7. Generate Project生成项目根据当前选择构建项目详见下文生成的项目小节。支持的标签类型支持的标量类型Boolean、SByte、Byte、Int16、UInt16、Int32、UInt32、Int64、UInt64、Float、Double、String以及这些类型的一维数组。常见的命名空间 0 子类型也会解析Duration、UtcTime、Enumeration、IntegerId、DateTime、Guid、ByteString、LocalizedText。当厂商声明了驱动表中没有的类型时以值自身的类型为准任何可打印的值都会变成字符串通道。字符串被限制为256 字节的 UTF-8超出时在字符边界上截断OpcUaWire.h 中kMaxStringBytes 256截断逻辑会回退到非 UTF-8 续字节边界避免截断产生乱码。其他任何类型的变量在浏览器中可见但无法勾选。在内部每个标签映射为一条线上类型wire typeOpcUaTag.h 中的OpcUaTag结构携带nodeId、name、path、unit、type、arrayLen、min/maxwireTypeFor()表明未知类型统一编码为字符串通道。线上类型与解码后的文本渲染全部集中在 OpcUaWire.h它定义了帧格式[version u8] 若干条 [index u16 LE][type u8][payload]其中字符串先带 u16 LE 字节长度该头文件被驱动编码器、opcua原生模板与 ctest 测试层共用同一份定义保证编码端与解码端永远一致。订阅与轮询连接时驱动为每个标签向服务器请求一个受监控项并报告进度Subscribing, n of N tags。之后按状态行呈现三种运行形态状态触发条件正常订阅服务器接受全部受监控项Polling (server refused subscriptions)服务器拒绝全部受监控项不支持订阅或配额耗尽驱动切换到定时读取所有标签Subscribed N tags, polling M refused服务器只拒绝部分标签如 S7-1200 的项数上限、按用户权限、PLC 下载后节点 ID 失效被拒标签进入读取通道其余保持订阅针对个别标签的拒绝会连同节点 ID 一起记入日志。读取路径经过精心设计以保护仪表板读取被批量batched并按服务器的MaxNodesPerRead分块该上限从命名空间 0 的ns0;i11705节点读取见 OpcUaTypes.h 的kNodeMaxNodesPerRead同一时刻只有一个读取在途上一次读取尚未返回时到达的 tick 会被跳过并计数skippedPolls而不是排队堆积在慢速 PLC 后面。订阅还有一种无错误的静默风险服务器重载项目、或在会话仍存活时丢弃订阅。**看门狗watchdog**发现连续多个发布周期没有数据到达后会回退到轮询而不是冻结仪表板OpcUaSubscriptions.h 中的onWatchdogTick。每个发布 tick驱动收集自上一个 tick 以来值发生变化的标签将它们打包成一个二进制帧发布未变化的标签不会重发——帧解析器会锁存latch其上次值这正是 OpcUaWire.h 注释里delta-frame增量帧的含义值质量遵循 OPC UA 严重性位Good 与 Uncertain 值网关在提供其最后一个可用值、设备处于预热期等场景会被发布Bad 值被丢弃。质量判断依据 OpcUaTypes.h 中的severityOf()只看状态码最高的两个严重性位而非简单的! Good——注释明确说明丢弃 Uncertain 会让仪表板悄悄拉平flat-line某标签的最新值为 Bad 时仪表板上保留其最后一个好值坏状态计数器递增并出现在 API 状态badTags列表中驱动badTags()直接转发订阅引擎的坏标签列表数组标签会按元素扇出为一个通道一个name[i]。时间戳每一帧都打上它携带的最早源时间戳并映射到 Serial Studio 的单调时钟monotonic clock上。服务器到本机的偏移在连接时采样没有 NTP 的 PLC 会被跟随而不是被拒绝只有偏离该偏移超过5 秒的时间戳或缺失的时间戳才回退到接收时刻receipt time并计为未打戳unstamped帧时间戳永远不会倒退。因此录制与 CSV 导出会跟随设备时钟而一个时钟偏斜的服务器无法让仪表板倒带。对应计数器unstampedCount通过getStatus暴露。生成的项目Generate Project会写出一个项目其内容包括一个 OPC UA 类型的数据源携带端点、认证模式、用户名、间隔与标签列表——重新打开项目时无需再次浏览即可重连每个被选标签所在文件夹对应一个分组group以文件夹名命名每个通道一个数据集dataset以标签显示名作为标题数组元素为name[i]布尔量用 LED 控件数值类型启用绘图字符串标签路由到数据网格。EngineeringUnits成为数据集的单位EURange成为控件与绘图范围——两者均从被勾选标签的属性中读取对应 OpcUaTypes.h 的HasProperty引用遍历一个使用 OPC UA tag frames 模板的内置帧解析器。模板的 schema 参数列出每个通道的线上类型并随项目重新生成要修改标签选择请重新生成而不是手工编辑 schema。项目生成后在 Project Editor 中打开可像其他生成项目一样定制。无界面headless的 API 命令io.opcua.generateProject执行同样的生成但不会弹出保存对话框。项目构建逻辑集中在 OpcUaProjectBuilder.cpp并有对应的单元测试 tst_opcua_project_builder.cpp 验证生成结构。连接生命周期连接是异步的。每次尝试只报告一个明确结果会话变为已连接或尝试以某个原因失败不可达、访问被拒、不支持的认证、端点被拒最迟在15 秒截止时间内给出结论OpcUa.h 中的m_dialTimer/m_discoveryTimer与onDialTimeout共同实现该截止。会话建立后若掉线通过正常的断开路径报告再次按下连接会重新订阅同一批标签。命令行用法SerialStudio --opcua opc.tcp://192.168.1.10:4840/ \ --opcua-tag ns2;sPlant.Line1.Filler.Level_pct:f64:Level \ --opcua-tag ns2;sPlant.Line1.Filler.Running:bool:Running \ --opcua-interval 100--opcua-tag的完整语法为nodeId[:type[:name]][:nN][:unitU]可重复出现type为类型码默认f64n给出数组长度unit给出数据集单位由于 node id 本身可能包含冒号后缀从右侧解析。--opcua-user与--opcua-pass选择用户名/密码登录。不带--project时Serial Studio 会从标签列表生成一个项目使帧可以被解码。这些选项在 CLI.h 中定义opcua端点 URL、opcua-tag、opcua-interval10-60000 ms默认 100、opcua-user、opcua-pass。Socket APISocket API 在io.opcua.*命名空间下暴露驱动能力命令清单如下命令作用getConfig获取当前配置setEndpointUrl设置端点 URLdiscoverEndpoints/listEndpoints发起发现 / 轮询获取发现结果setEndpointIndex在发现列表中选择端点setAuthMode选择认证方式setUsername/setPassword设置用户名/密码setPublishingInterval设置发布间隔startBrowse/browse/stopBrowse启动/获取/停止浏览listTags/setTags/addTag/removeTag/clearTags管理标签列表generateProject无对话框生成项目getStatus获取会话状态与各类计数器发现与浏览是异步的命令启动请求后用对应的 list 命令轮询结果。getStatus返回会话状态及以下累计计数器收到的值数values received、坏状态计数与当前为坏的节点 IDbadTags、未打戳值unstamped、已发布帧数frames published、链路断开次数link drops、被拒标签数refused tags、被跳过的轮询数skipped polls以及修订后的发布间隔revised publishing interval——与 OpcUaSubscriptions.h 暴露的valuesReceived()、badStatusCount()、unstampedCount()、framesPublished()、skippedPolls()、refusedTags()、revisedInterval()一一对应。每个命令及其参数的完整说明见 OPC UA Driver Commands。使用内置模拟器实测仓库自带OPC UA PLC Simulator示例examples/OPC UA PLC Simulator是一个用 Pythonpip install asyncua编写的灌装线模型用于演示与集成测试。其地址空间覆盖了本文讨论的几乎所有场景带类型的标签、六元素浮点数组、字符串状态标签以及一个每十秒中报五秒 Bad 状态的传感器地址空间混合字符串与数字节点 ID、工程单位与范围、带子变量的结构形 Variable类似 PLC UDT见Plant/Line1/Pasteuriser/Recipe其子节点使用数字节点 ID以及一个在 Good、Bad、Uncertain 之间循环的传感器。模拟器脚本 opcua_plc_simulator.py 还提供以下旗标用于复现本文描述的各种情形--user NAME --password PW启用认证--no-subscriptions强制触发轮询回退--drop-after N发布 N 次后停止发布但不关闭 socket——即看门狗场景--secure-only只通告安全端点--port/--rate调整端口与仿真速率。驱动的集成测试正是跑在这台模拟器上的。快速上手四步启动模拟器python examples/OPC UA PLC Simulator/opcua_plc_simulator.py选择OPC UA数据源保持opc.tcp://127.0.0.1:4840按DiscoverBrowse Tags...勾选Plant文件夹按OK再按Generate Project连接。观察FaultySensor模拟器报告故障时它仍然持有最后一个好值Bad 值被丢弃、好值被锁存的行为。安全连接首次连接服务器选择除None之外的Policy并把Mode保持为 Sign Encrypt按Connect。第一次尝试会被拒绝Serial Studio 从未见过该服务器的证书信任提示会展示证书的主题subject、颁发者issuer、有效期窗口和 SHA-256 指纹。把指纹与服务器运维人员提供给你的指纹比对后按Trust This Server再次按Connect。接受证书只是记录决定而不会自动重连因此每次按 Connect 仍然只报告一个结果。信任决定按安装存储以指纹为键。服务器重新签发证书后会呈现新指纹并再次询问——这正是设计意图静默继承旧信任会让这个检查形同虚设。驱动在 OpcUaCertificateStore.cpp 中实现证书存储与指纹索引并通过serverCertificateUntrusted信号把证书信息OpcUaTypes.h 的CertInfosubject/issuer/fingerprint/notBefore/notAfter/valid/trusted/hostnameMatches/expired/notYetValid递交给信任提示。让服务器信任你安全通道是双向的。首次建立安全连接时Serial Studio 会生成自己的客户端证书并保留因此服务器运维只需信任这个安装一次而非每次启动都信任。在 Setup 面板的Identity下Export...把证书导出到服务器期望的受信客户端目录许多服务器是pki/trusted/certs。私钥永远不会被导出Replace生成新的证书与密钥。所有信任过旧证书的服务器都必须重新信任新证书因此仅在密钥可能泄露时才使用。对应地驱动在 OpcUa.h 中暴露regenerateCertificate()与exportCertificate(path)并提供clientCertificate/trustedCertificates属性查看当前身份与受信证书列表。为什么安全连接被拒绝驱动把四种拒绝原因分别报告因为它们的修法完全不同原因处理办法服务器证书不受信任比对指纹并在提示中接受它服务器证书已过期在服务器上续期。Serial Studio 不会接受过期证书服务器证书尚未生效检查服务器与本机的时钟服务器证书不是为本主机签发的你拨号的名字不在证书覆盖范围内。使用证书签发时所用的名字或用正确的 SubjectAltName 重新签发这四种原因与 OpcUaTypes.h 中TrustFailure枚举Untrusted、Expired、NotYetValid、HostnameMismatch、Unreadable逐一对应避免用户面对一个笼统的证书错误无从下手。常见陷阱与排查端点列表为空或灰显服务器没有任何端点通告所选认证可用的用户身份令牌例如只提供 Anonymous 的服务器会拒绝用户名会话。切换认证方式或在服务器端启用匹配的端点。Access denied访问被拒服务器禁用了匿名登录或用户名/密码错误。切换认证方式并检查账号部分服务器还要求用户对浏览的文件夹拥有读权限。发现成功但连接超时Serial Studio 拨号的是你输入的主机所以通告的主机名无法解析不是原因请检查 4840 端口上的防火墙以及服务器是否绑定在你机器可达的接口上。全部走轮询而非订阅服务器触达订阅上限。之前未干净关闭的会话会占用订阅直到服务器超时回收等待超时或在服务器端提高上限。标签可见但无法勾选数据类型不受支持如结构体整体、多维数组或账号没有读权限。结构体并非死路展开它并勾选其成员即可。值更新慢于设置的间隔服务器把发布间隔向上修订了状态行显示的是实际生效的速率。向服务器要求更快的最小值或接受其下限。延伸阅读Auto-Generating Projects其他驱动侧项目生成器Drivers: Modbus面向寄存器的工业协议Drivers: MQTT基于 broker 的遥测许多网关在 OPC UA 与 MQTT 之间桥接Data Sources全部传输通道的驱动能力汇总Communication Protocols所有受支持传输的概览。如需深入实现细节可直接阅读仓库源码驱动门面 OpcUa.h 与其子对象浏览器、证书存储、端点选择、订阅、标签模型、会话、安全层位于 core/Devices/IO/Drivers/OpcUa/增量帧的线上编码在 OpcUaWire.h相关单元测试包括 tst_opcua_endpoint_selection.cpp、tst_opcua_frame_assembler.cpp、tst_opcua_marshal.cpp、tst_opcua_project_builder.cpp、tst_opcua_security.cpp、tst_opcua_subscriptions.cpp 与 tst_opcua_wire.cpp。【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Serial Studio OPC UA 驱动完全指南：从端点发现、标签订阅到安全连接与项目生成
Serial Studio OPC UA 驱动完全指南从端点发现、标签订阅到安全连接与项目生成【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio本篇技术指南以 Serial Studio开源遥测仪表板内置的 OPC UA 客户端驱动为核心讲解如何通过opc.tcp://连接 PLC、SCADA 网关等工业设备浏览其地址空间中的标签Tags以订阅Subscription或轮询Polling方式将实时值流入仪表板并自动生成可视化项目。读完本文你将掌握端点发现与安全策略选择、标签浏览与类型映射、订阅/轮询双通道机制、时间戳语义、命令行与 Socket API 的完整用法以及首次安全连接时的证书信任流程。仓库中的实现证据如 OpcUa.h、OpcUaTypes.h、OpcUaWire.h会与官方文档 Drivers-OPC-UA.md 相互印证帮助你从原理层理解每一个配置项的行为。OPC UA 基础概念OPC UAIEC 62541是现代自动化设备通过以太网暴露的面向标签tag-oriented接口。PLC、SCADA 服务器和网关会发布一个可浏览的地址空间address space其中包含有名称、有类型的变量节点客户端订阅自己关心的变量服务器便会推送变化。在 Serial Studio 中OPC UA 驱动以Pro 版本功能的形式存在实现的是一个完整的 OPC UA客户端它发现服务器的端点endpoint、浏览其标签、根据选择构建项目并把实时值以二进制帧的形式流式送入仪表板。由于 OPC UA 是跨厂商的通用标准一个驱动即可覆盖多种设备Rockwell 控制器经 FactoryTalk Linx Gateway、KEPServerEX 或 Ignition 后面的任意设备、Siemens S7-1200/1500 与 WinCC、Beckhoff TwinCAT、CODESYS 运行时、BR、WAGO 以及 Schneider PLC 等。厂商名称在此仅用于说明兼容性——该驱动遵循的是标准本身而非任何厂商私有方言。地址空间与节点一个 OPC UA 服务器本质上是一棵树。在Objects文件夹下厂商按层级组织文件夹工厂、产线、机器文件夹内是变量节点variable nodes也就是常说的标签。每个节点都有节点 IDnode id如ns2;sPlant.Line1.Filler.Level_pct字符串形式或ns3;i1017数字形式显示名称display name数据类型data type访问级别access level。客户端从不接触寄存器或字节偏移它按节点 ID 请求值收到的是一组带状态码status codeGood 或某种 Bad 原因和源时间戳source timestamp来自设备自身时钟的强类型值。从源码看驱动为节点属性维护了一套与规范一致的枚举OpcUaTypes.h 中NodeAttribute的取值NodeId1、BrowseName3、Value13、DataType14、AccessLevel17 等直接对应 OPC UA 属性 ID因此编组层marshal可以按类型转换而非查表NodeClass以位掩码形式组织Object1、Variable2、Method4……一次浏览可同时请求多种节点类。可读性由访问级别的kAccessLevelCurrentRead 0x01u位决定这与文档中无读权限的标签可见但不可勾选的行为一一对应。两种取值方式方式原理特点Subscription订阅客户端创建带发布间隔publishing interval的订阅并添加受监控项monitored items服务器对每个受监控项采样每次变化即发布高效路径变化才推送Read读取客户端一次请求中直接读取一组节点的当前值简单但需要客户端自己轮询订阅是 Serial Studio 的默认与首选路径Read 则作为订阅被拒绝或失败时的回退方案。端点与安全服务器会按安全配置为每种组合各通告一个端点endpoint。每个端点把安全策略security policyNone、Basic256Sha256……与消息安全模式message security modeNone、Sign、Sign Encrypt配对。客户端选定一个端点后与它建立安全通道secure channel。Serial Studio 自带内置加密的 OPC UA 协议栈因此服务器通告的每一个端点都能连通。它支持六种安全策略安全策略说明None不加密Basic128Rsa15已被 OPC 基金会废弃SHA-1 与 RSA-1.5 不再安全Basic256已被 OPC 基金会废弃Basic256Sha256当前广泛使用的推荐策略Aes128_Sha256_RsaOaep新一代加密策略Aes256_Sha256_RsaPss新一代加密策略每种安全策略都可在Sign消息被认证或Sign Encrypt认证且机密模式下使用。机器上无需安装任何东西、也不会从系统取用任何组件协议栈随应用一起分发因此在每台电脑上同一构建的行为完全一致——这正是 OpcUaEndpointSelection.h 中策略目录policy catalogue与端点排名被设计为纯函数pure functions的原因不依赖会话、设置或驱动状态便于单元测试直接验证排名逻辑。Basic128Rsa15与Basic256之所以仍被提供是因为现场控制器依然在通告它们。它们在任何出现的地方都被标记为deprecated并且永远不会被自动选中——自动选择逻辑selectBestEndpoint会避开废弃策略。登录方式有三种Anonymous匿名、Username / Password用户名/密码、X.509 证书。注意只有当消息模式为 Sign Encrypt 时密码才受通道保护Setup 面板会在密码可能明文传输时发出警告并在通道开始加密后停止警告。对应的驱动在 OpcUa.h 中暴露了credentialsExposed与allowPlaintextPassword两个属性是否允许明文密码的确认是**按安装per-installation**记录的与信任库放在一起、永不出现在项目中——这意味着打开别人的项目文件永远不会顺带授予这个安全确认。Serial Studio 如何使用它驱动在主线程上运行内置的 OPC UA 客户端。一个数据源 一个会话 一台服务器该会话订阅每一个被选中的标签。配置模型1. Endpoint端点服务器 URL格式为opc.tcp://host:port/path默认值opc.tcp://127.0.0.1:4840。端口 4840 是 IANA 分配给 OPC UA 的默认端口OpcUaTypes.h 中以kDefaultPort 4840常量固化URL 省略端口时自动补全。按下Discover可获取服务器的端点列表在所选认证方式可用的用户令牌user token范围内自动挑选最安全的端点绝不单独选一个废弃策略而你显式选择的端点会在下一次发现时被保留。未选择端点直接连接时也会先执行同样的发现流程。一个关键设计Serial Studio总是拨号你输入的 host 和 port其余部分策略、模式等采用发现到的描述。这是因为服务器通告的往往是自己的主机名如opc.tcp://PLC-01:4840从工程师的笔记本电脑上几乎无法解析——这一坚持用户输入的主机、采纳发现到的其余信息的策略在 OpcUa.cpp 的拨号路径中实现也是发现成功但连接超时类问题的排查锚点见下文常见陷阱。2. Poll Interval (ms)轮询间隔该间隔同时用于请求订阅的发布间隔、读定时器以及数据源的帧率。默认100 ms并被钳制在10–60000 ms范围内——OpcUaSubscriptions.h 中的kOpcUaMinIntervalMs 10与kOpcUaMaxIntervalMs 60000与 CLI 选项说明--opcua-interval注释同样注明 10-60000、默认 100保持完全一致。当服务器把间隔向上修订revise到其最小值以上时PLC 内嵌服务器通常把下限设在 50-100 ms面板下方的状态行报告的是实际生效的速率而非请求值。驱动通过revisedInterval属性对外暴露这一信息。3. Security安全端点列表显示发现到的端点行格式为policy / mode / url。当某行通告的用户身份令牌与所选认证方式匹配时该行才可被选中endpointSelectable。4. Policy and Mode策略与模式决定无显式选择时拨号要求什么以及自动选择以什么为衡量基准。选择除None之外的任何策略都会展开Mode选择器Sign 或 Sign Encrypt。5. Authentication认证Anonymous默认Username / Password密码存放在与 MQTT 驱动相同的按机器保存的凭据保险库CredentialVault见 OpcUa.h 中的::MQTT::CredentialVault m_vault中在机器设置里混淆存储按主机和端口作为键绝不写入项目文件X.509 Certificate选择证书及其私钥只保存两者的路径私钥本身永不落盘。6. Tags标签浏览Browse Tags...对话框打开一个只浏览browse-only的会话每次展开只获取一层一次 Browse 加一次对该层整体的批量 Read。在展开之前不会读取节点下方的任何内容——因此一个带十万节点的网关也能保持响应。值得注意的浏览细节变量也会展开PLC 结构体与 UDT 会暴露其成员以及EngineeringUnits/EURange属性作为子变量。源码中浏览逻辑以两种引用集行走OpcUaTypes.h 的ReferenceKind区分Hierarchical层级树本身与HasProperty勾选变量的 EngineeringUnits/EURange 属性查找勾选文件夹 全选勾选一个文件夹会选中其下所有可读且受支持的变量包括之后展开时才取到的变量Select All Readable勾选当前已取回的全部可读项OK提交选择Cancel与窗口关闭按钮均丢弃选择未展开分支中的标签会保留原位最多可选中2048 个通道超过512时对话框会警告因为过宽的帧会拖慢仪表板。这两个数字在 OpcUaWire.h 中即kMaxTags 2048与kSoftTagLimit 512会话已连接时的编辑会在连接关闭时生效deferred tags 机制。7. Generate Project生成项目根据当前选择构建项目详见下文生成的项目小节。支持的标签类型支持的标量类型Boolean、SByte、Byte、Int16、UInt16、Int32、UInt32、Int64、UInt64、Float、Double、String以及这些类型的一维数组。常见的命名空间 0 子类型也会解析Duration、UtcTime、Enumeration、IntegerId、DateTime、Guid、ByteString、LocalizedText。当厂商声明了驱动表中没有的类型时以值自身的类型为准任何可打印的值都会变成字符串通道。字符串被限制为256 字节的 UTF-8超出时在字符边界上截断OpcUaWire.h 中kMaxStringBytes 256截断逻辑会回退到非 UTF-8 续字节边界避免截断产生乱码。其他任何类型的变量在浏览器中可见但无法勾选。在内部每个标签映射为一条线上类型wire typeOpcUaTag.h 中的OpcUaTag结构携带nodeId、name、path、unit、type、arrayLen、min/maxwireTypeFor()表明未知类型统一编码为字符串通道。线上类型与解码后的文本渲染全部集中在 OpcUaWire.h它定义了帧格式[version u8] 若干条 [index u16 LE][type u8][payload]其中字符串先带 u16 LE 字节长度该头文件被驱动编码器、opcua原生模板与 ctest 测试层共用同一份定义保证编码端与解码端永远一致。订阅与轮询连接时驱动为每个标签向服务器请求一个受监控项并报告进度Subscribing, n of N tags。之后按状态行呈现三种运行形态状态触发条件正常订阅服务器接受全部受监控项Polling (server refused subscriptions)服务器拒绝全部受监控项不支持订阅或配额耗尽驱动切换到定时读取所有标签Subscribed N tags, polling M refused服务器只拒绝部分标签如 S7-1200 的项数上限、按用户权限、PLC 下载后节点 ID 失效被拒标签进入读取通道其余保持订阅针对个别标签的拒绝会连同节点 ID 一起记入日志。读取路径经过精心设计以保护仪表板读取被批量batched并按服务器的MaxNodesPerRead分块该上限从命名空间 0 的ns0;i11705节点读取见 OpcUaTypes.h 的kNodeMaxNodesPerRead同一时刻只有一个读取在途上一次读取尚未返回时到达的 tick 会被跳过并计数skippedPolls而不是排队堆积在慢速 PLC 后面。订阅还有一种无错误的静默风险服务器重载项目、或在会话仍存活时丢弃订阅。**看门狗watchdog**发现连续多个发布周期没有数据到达后会回退到轮询而不是冻结仪表板OpcUaSubscriptions.h 中的onWatchdogTick。每个发布 tick驱动收集自上一个 tick 以来值发生变化的标签将它们打包成一个二进制帧发布未变化的标签不会重发——帧解析器会锁存latch其上次值这正是 OpcUaWire.h 注释里delta-frame增量帧的含义值质量遵循 OPC UA 严重性位Good 与 Uncertain 值网关在提供其最后一个可用值、设备处于预热期等场景会被发布Bad 值被丢弃。质量判断依据 OpcUaTypes.h 中的severityOf()只看状态码最高的两个严重性位而非简单的! Good——注释明确说明丢弃 Uncertain 会让仪表板悄悄拉平flat-line某标签的最新值为 Bad 时仪表板上保留其最后一个好值坏状态计数器递增并出现在 API 状态badTags列表中驱动badTags()直接转发订阅引擎的坏标签列表数组标签会按元素扇出为一个通道一个name[i]。时间戳每一帧都打上它携带的最早源时间戳并映射到 Serial Studio 的单调时钟monotonic clock上。服务器到本机的偏移在连接时采样没有 NTP 的 PLC 会被跟随而不是被拒绝只有偏离该偏移超过5 秒的时间戳或缺失的时间戳才回退到接收时刻receipt time并计为未打戳unstamped帧时间戳永远不会倒退。因此录制与 CSV 导出会跟随设备时钟而一个时钟偏斜的服务器无法让仪表板倒带。对应计数器unstampedCount通过getStatus暴露。生成的项目Generate Project会写出一个项目其内容包括一个 OPC UA 类型的数据源携带端点、认证模式、用户名、间隔与标签列表——重新打开项目时无需再次浏览即可重连每个被选标签所在文件夹对应一个分组group以文件夹名命名每个通道一个数据集dataset以标签显示名作为标题数组元素为name[i]布尔量用 LED 控件数值类型启用绘图字符串标签路由到数据网格。EngineeringUnits成为数据集的单位EURange成为控件与绘图范围——两者均从被勾选标签的属性中读取对应 OpcUaTypes.h 的HasProperty引用遍历一个使用 OPC UA tag frames 模板的内置帧解析器。模板的 schema 参数列出每个通道的线上类型并随项目重新生成要修改标签选择请重新生成而不是手工编辑 schema。项目生成后在 Project Editor 中打开可像其他生成项目一样定制。无界面headless的 API 命令io.opcua.generateProject执行同样的生成但不会弹出保存对话框。项目构建逻辑集中在 OpcUaProjectBuilder.cpp并有对应的单元测试 tst_opcua_project_builder.cpp 验证生成结构。连接生命周期连接是异步的。每次尝试只报告一个明确结果会话变为已连接或尝试以某个原因失败不可达、访问被拒、不支持的认证、端点被拒最迟在15 秒截止时间内给出结论OpcUa.h 中的m_dialTimer/m_discoveryTimer与onDialTimeout共同实现该截止。会话建立后若掉线通过正常的断开路径报告再次按下连接会重新订阅同一批标签。命令行用法SerialStudio --opcua opc.tcp://192.168.1.10:4840/ \ --opcua-tag ns2;sPlant.Line1.Filler.Level_pct:f64:Level \ --opcua-tag ns2;sPlant.Line1.Filler.Running:bool:Running \ --opcua-interval 100--opcua-tag的完整语法为nodeId[:type[:name]][:nN][:unitU]可重复出现type为类型码默认f64n给出数组长度unit给出数据集单位由于 node id 本身可能包含冒号后缀从右侧解析。--opcua-user与--opcua-pass选择用户名/密码登录。不带--project时Serial Studio 会从标签列表生成一个项目使帧可以被解码。这些选项在 CLI.h 中定义opcua端点 URL、opcua-tag、opcua-interval10-60000 ms默认 100、opcua-user、opcua-pass。Socket APISocket API 在io.opcua.*命名空间下暴露驱动能力命令清单如下命令作用getConfig获取当前配置setEndpointUrl设置端点 URLdiscoverEndpoints/listEndpoints发起发现 / 轮询获取发现结果setEndpointIndex在发现列表中选择端点setAuthMode选择认证方式setUsername/setPassword设置用户名/密码setPublishingInterval设置发布间隔startBrowse/browse/stopBrowse启动/获取/停止浏览listTags/setTags/addTag/removeTag/clearTags管理标签列表generateProject无对话框生成项目getStatus获取会话状态与各类计数器发现与浏览是异步的命令启动请求后用对应的 list 命令轮询结果。getStatus返回会话状态及以下累计计数器收到的值数values received、坏状态计数与当前为坏的节点 IDbadTags、未打戳值unstamped、已发布帧数frames published、链路断开次数link drops、被拒标签数refused tags、被跳过的轮询数skipped polls以及修订后的发布间隔revised publishing interval——与 OpcUaSubscriptions.h 暴露的valuesReceived()、badStatusCount()、unstampedCount()、framesPublished()、skippedPolls()、refusedTags()、revisedInterval()一一对应。每个命令及其参数的完整说明见 OPC UA Driver Commands。使用内置模拟器实测仓库自带OPC UA PLC Simulator示例examples/OPC UA PLC Simulator是一个用 Pythonpip install asyncua编写的灌装线模型用于演示与集成测试。其地址空间覆盖了本文讨论的几乎所有场景带类型的标签、六元素浮点数组、字符串状态标签以及一个每十秒中报五秒 Bad 状态的传感器地址空间混合字符串与数字节点 ID、工程单位与范围、带子变量的结构形 Variable类似 PLC UDT见Plant/Line1/Pasteuriser/Recipe其子节点使用数字节点 ID以及一个在 Good、Bad、Uncertain 之间循环的传感器。模拟器脚本 opcua_plc_simulator.py 还提供以下旗标用于复现本文描述的各种情形--user NAME --password PW启用认证--no-subscriptions强制触发轮询回退--drop-after N发布 N 次后停止发布但不关闭 socket——即看门狗场景--secure-only只通告安全端点--port/--rate调整端口与仿真速率。驱动的集成测试正是跑在这台模拟器上的。快速上手四步启动模拟器python examples/OPC UA PLC Simulator/opcua_plc_simulator.py选择OPC UA数据源保持opc.tcp://127.0.0.1:4840按DiscoverBrowse Tags...勾选Plant文件夹按OK再按Generate Project连接。观察FaultySensor模拟器报告故障时它仍然持有最后一个好值Bad 值被丢弃、好值被锁存的行为。安全连接首次连接服务器选择除None之外的Policy并把Mode保持为 Sign Encrypt按Connect。第一次尝试会被拒绝Serial Studio 从未见过该服务器的证书信任提示会展示证书的主题subject、颁发者issuer、有效期窗口和 SHA-256 指纹。把指纹与服务器运维人员提供给你的指纹比对后按Trust This Server再次按Connect。接受证书只是记录决定而不会自动重连因此每次按 Connect 仍然只报告一个结果。信任决定按安装存储以指纹为键。服务器重新签发证书后会呈现新指纹并再次询问——这正是设计意图静默继承旧信任会让这个检查形同虚设。驱动在 OpcUaCertificateStore.cpp 中实现证书存储与指纹索引并通过serverCertificateUntrusted信号把证书信息OpcUaTypes.h 的CertInfosubject/issuer/fingerprint/notBefore/notAfter/valid/trusted/hostnameMatches/expired/notYetValid递交给信任提示。让服务器信任你安全通道是双向的。首次建立安全连接时Serial Studio 会生成自己的客户端证书并保留因此服务器运维只需信任这个安装一次而非每次启动都信任。在 Setup 面板的Identity下Export...把证书导出到服务器期望的受信客户端目录许多服务器是pki/trusted/certs。私钥永远不会被导出Replace生成新的证书与密钥。所有信任过旧证书的服务器都必须重新信任新证书因此仅在密钥可能泄露时才使用。对应地驱动在 OpcUa.h 中暴露regenerateCertificate()与exportCertificate(path)并提供clientCertificate/trustedCertificates属性查看当前身份与受信证书列表。为什么安全连接被拒绝驱动把四种拒绝原因分别报告因为它们的修法完全不同原因处理办法服务器证书不受信任比对指纹并在提示中接受它服务器证书已过期在服务器上续期。Serial Studio 不会接受过期证书服务器证书尚未生效检查服务器与本机的时钟服务器证书不是为本主机签发的你拨号的名字不在证书覆盖范围内。使用证书签发时所用的名字或用正确的 SubjectAltName 重新签发这四种原因与 OpcUaTypes.h 中TrustFailure枚举Untrusted、Expired、NotYetValid、HostnameMismatch、Unreadable逐一对应避免用户面对一个笼统的证书错误无从下手。常见陷阱与排查端点列表为空或灰显服务器没有任何端点通告所选认证可用的用户身份令牌例如只提供 Anonymous 的服务器会拒绝用户名会话。切换认证方式或在服务器端启用匹配的端点。Access denied访问被拒服务器禁用了匿名登录或用户名/密码错误。切换认证方式并检查账号部分服务器还要求用户对浏览的文件夹拥有读权限。发现成功但连接超时Serial Studio 拨号的是你输入的主机所以通告的主机名无法解析不是原因请检查 4840 端口上的防火墙以及服务器是否绑定在你机器可达的接口上。全部走轮询而非订阅服务器触达订阅上限。之前未干净关闭的会话会占用订阅直到服务器超时回收等待超时或在服务器端提高上限。标签可见但无法勾选数据类型不受支持如结构体整体、多维数组或账号没有读权限。结构体并非死路展开它并勾选其成员即可。值更新慢于设置的间隔服务器把发布间隔向上修订了状态行显示的是实际生效的速率。向服务器要求更快的最小值或接受其下限。延伸阅读Auto-Generating Projects其他驱动侧项目生成器Drivers: Modbus面向寄存器的工业协议Drivers: MQTT基于 broker 的遥测许多网关在 OPC UA 与 MQTT 之间桥接Data Sources全部传输通道的驱动能力汇总Communication Protocols所有受支持传输的概览。如需深入实现细节可直接阅读仓库源码驱动门面 OpcUa.h 与其子对象浏览器、证书存储、端点选择、订阅、标签模型、会话、安全层位于 core/Devices/IO/Drivers/OpcUa/增量帧的线上编码在 OpcUaWire.h相关单元测试包括 tst_opcua_endpoint_selection.cpp、tst_opcua_frame_assembler.cpp、tst_opcua_marshal.cpp、tst_opcua_project_builder.cpp、tst_opcua_security.cpp、tst_opcua_subscriptions.cpp 与 tst_opcua_wire.cpp。【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考