OPC UA 异步库 (opcua-asyncio) 使用教程

1. 项目介绍

opcua-asyncio 是一个基于 asyncio 的异步 OPC UA 客户端和服务器库，适用于 Python 3.7 及以上版本。该项目是 python-opcua 的一个分支，移除了对 Python 3.7 以下版本的支持。opcua-asyncio 提供了低级接口来发送和接收所有 UA 定义的结构，以及高级类来简化客户端和服务器的编写。

主要特点

• 异步编程：支持异步编程，简化了代码并可能提高性能。
• 高/低级 API：提供高级别和低级别的 API，方便用户根据需求选择。
• 广泛测试：经过多种 OPC UA 堆栈的广泛测试。
• 自动生成代码：大部分低级代码是根据 XML 规范自动生成的。

2. 项目快速启动

安装

使用 pip 安装 opcua-asyncio：

pip install asyncua

示例代码

客户端示例

以下是一个简单的 OPC UA 客户端示例：

from asyncua import Client

async def main():
    async with Client(url='opc.tcp://localhost:4840/freeopcua/server/') as client:
        while True:
            node = client.get_node('i=85')
            value = await node.read_value()
            print(f"Node value: {value}")

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

服务器示例

以下是一个简单的 OPC UA 服务器示例：

from asyncua import Server

async def main():
    server = Server()
    await server.init()
    server.set_endpoint('opc.tcp://0.0.0.0:4840/freeopcua/server/')

    # 添加命名空间
    uri = 'http://examples.freeopcua.github.io'
    idx = await server.register_namespace(uri)

    # 添加对象
    myobj = await server.nodes.objects.add_object(idx, 'MyObject')
    myvar = await myobj.add_variable(idx, 'MyVariable', 6.7)
    await myvar.set_writable()  # 允许变量被写入

    async with server:
        while True:
            await asyncio.sleep(1)
            new_val = await myvar.get_value() + 0.1
            await myvar.write_value(new_val)

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

3. 应用案例和最佳实践

应用案例

• 工业自动化：在工业自动化系统中，opcua-asyncio 可以用于实时监控和控制设备。
• 物联网 (IoT)：在物联网应用中，opcua-asyncio 可以用于连接和管理各种传感器和设备。
• 数据采集：用于从各种数据源采集数据，并进行实时处理和分析。

最佳实践

• 异步编程：充分利用 asyncio 的异步特性，避免阻塞操作。
• 错误处理：在生产环境中，确保添加适当的错误处理和日志记录。
• 性能优化：对于高负载应用，考虑使用缓存和批量处理来优化性能。

4. 典型生态项目

• FreeOpcUa/opcua-client-gui：一个简单的 GUI 客户端，用于与 OPC UA 服务器交互。
• FreeOpcUa/opcua-asyncio/examples：包含多个示例代码，展示了如何使用 opcua-asyncio 的各种功能。
• FreeOpcUa/opcua-asyncio/tools：提供了一系列命令行工具，用于测试和调试 OPC UA 服务器和客户端。

通过这些资源，用户可以更深入地了解和使用 opcua-asyncio，并将其应用于各种实际项目中。