使用TF6020 TwinCAT 3 JSON Data Interface灵活的在TwinCAT和用户程序之间交互数据.docxVIP

第PAGE6页

TF6020TwinCAT3JSONDataInterface使用方法

TF6020TwinCAT3JSONDataInterface使用方法

作者：徐良定

职务：华东区技术工程师

邮箱：ld.xu@

日期：2024-04-19

摘要：

TC3JSONDataInterface是一个通信接口，用于灵活地在TwinCAT系统和用户特定的应用程序之间交换数据。通信以JSON格式进行。因为使用了JSON格式和ADS或MQTT，确保了不同的编程环境都能够进行通用的访问。

附件：

序号

文件名

备注

历史版本：

免责声明：

我们已对本文档描述的内容做测试。但是差错在所难免，无法保证绝对正确并完全满足您的使用需求。本文档的内容可能随时更新，如有改动，恕不事先通知，也欢迎您提出改进建议。

参考信息：

目录

TOC\o1-3\h\z\u1. 软硬件版本 4

1.1. 倍福Beckhoff 4

1.1.1. 控制器硬件 4

1.1.2. 控制软件 4

1.2. 其它 4

1.2.1. 硬件 4

1.2.2. 开发软件 4

2. 准备工作 4

2.1. 创建PLC程序 4

3. ADS通信测试 4

3.1. Overview 5

3.2. 新建Winform项目 5

3.3. 添加Ads通信库引用 5

3.4. 在NuGet上面安装Newtonsoft.Json包 7

3.5. 调用ADS通信库的方法，建立PLC连接 8

3.6. 读PLC变量 8

3.6.1. API介绍 9

3.6.2. 在用户程序里面拼接Json文本 9

3.6.3. 调用TcAdsClient的ReadWrite方法 10

3.6.4. 返回的Json文本 11

3.6.5. 解析Json文本 12

3.7. 写PLC变量 12

3.7.1. API介绍 12

3.7.2. 在用户程序里面拼接Json文本 13

3.7.3. 调用TcAdsClient的ReadWrite方法 14

4. 常见问题 15

4.1. Ads-Error0x705:Parametersizeisincorrect 15

4.2. Ads-Error0x706:Parametervalue(s)isinvalid. 16

文档正文要求

（文档编写完毕后，删除本页）

内容组成：

目录：模板中目录为“域”，如果内容超过10页，右键单击刷新域即可，否则可以删除

测试条件：

标注硬件完整型号及IMG，如CX5020-0125（IMG版本：CX1800-0411-0007v3.92）；

软件版本，如：TwinCAT3.1Build4024.7

准备工作：只要做一次但必须保证正确无误的步骤，比如接线（有条件建议使用示意图）、IP设置、加路由等

操作步骤：正常的操作截图，需保证截图完整清晰、步骤连续不跳步；部分操作说明需参考资料部分，请附带资料链接。

常见问题：在不同的测试和应用条件下，由不同的工程师积累的故障处理经验；也可对客户提出的一些特征性问题进行总结进行记录，有步骤部分请分步说明、必要时需配图。

截图：

必须截出查找路径及关键部分。避免软件整个界面截图，影响阅读，使用红框突出重点，图片可适当添加文字说明。

尽量使全文截图显示为同样的比例

正文字体和编号：

直接在模板上编辑文字，即可延用字体和编号设置

如果是复制粘贴来的文字，可使用格式刷，使之与全文风格一致

软硬件版本

倍福Beckhoff

控制器硬件

无

控制软件

笔记本Win10

基于TwinCAT3.1Build4024.53版本?

TF6020试用授权

其它

硬件

无

开发软件

VS2019Community

准备工作

创建PLC程序

PLC程序里面包含了一些基础类型的变量，以及嵌套的结构体变量。

ADS通信测试

在通常ADS通信中，读写PLC数据的方法有很多，比如通过结构体的方式、SumCommand的方式，但这些方式对于复杂的结构体或者多个变量同时读取，不够灵活。TF6020提供了以Json格式的方式读写变量，提高了变量读写的灵活性。

Overview

新建Winform项目

测试环境的框架版本的.NETFramework4.5，根据实际情况进行选择。

添加Ads通信库引用

1：右键选择添加引用

2：点击浏览按钮

3：选择对应文件目录下的TwinCAT.Ads.dll

4：点击确定按钮

添加ADS通信库后，如图所示

在NuGet上面安装Newtons