libplctag

libplctag- c通信的C库

• libplctag- c通信的C库
  • 警告 - 免责声明
  • 得到它
  • 特征
    • 高级功能
    • 详细的功能
      • PLC支持
      • 平台支持
    • 替代编程语言
  • 代码
    • 如何获取代码
    • 示例代码
    • API
  • 把招工广告
    • 如何贡献
  • 历史
  • 联系和支持
    • libplctag论坛
    • github
  • 执照
  • 归因和商标
  • 结尾

操作系统	架构/CPU	版本	64位	32位
Ubuntu	x86，手臂	18.04	支持	支持
视窗	x86，手臂	10（服务器19）	支持	支持
macos	x86，手臂	11	支持	不支持

最新版本版本	最新的CI状态

libplctag是使用以太网/IP或Modbus TCP的Linux，Windows和MacOS的开源C库，可以在PLC中读取和编写标签。该图书馆自2012年初以来一直在生产中，多个组织用于许多任务，包括控制射电望远镜，大型和精密制造，控制健身设备，食品处理等。

当前稳定版本：2.6

旧版本：2.5

警告 - 免责声明

注意：如果在编程或访问中犯错误，PLC控制着多种设备以及财产，生产甚至生命的损失。访问或编程PLC时始终谨慎行事！

对于任何目的，我们没有对本守则的适用性提出索赔或认股权证。

当心！

得到它

你知道你想要什么吗？从发布页面下载！

特征

高级功能

• 以太网/IP和Modbus TCP支持。
• MPL 2.0或LGPL 2+下的开源许可。
• 纯C库，用于跨Linux，Windows和MacOS以及32位和64位的可移植性。
• 支持X86，手臂和MIP，可能是其他人。
• 非常稳定的API，除了自2012年以来的功能添加以外，几乎没有其他变化。
• 记忆使用率低，性能和容量非常高。使用特定于协议的功能来提高性能。
• 简单的API使用特定于语言的数据最少使用，以启用其他语言的易于包装。
• 广泛的示例程序显示了所有库功能的使用。
• 诸如C＃/。网络，Julia等的高级语言包装纸
• 自由的！

详细的功能

PLC支持

• 通过CIP-Ethernet/IP（CIP/EIP或EIP）支持Rockwell/Allen-Bradley Controllogix（TM）PLC。
  • 读/写8、16、32和64位签名和未签名的整数。
  • 读/写单位/布尔。
  • 读取/写32位和64位IEEE格式（小eNdian）浮点。
  • 对用户定义的结构的原始支持（您需要逐一拔出数据）
  • 读/写上述阵列。
  • 每个数据包的多要求支持。
  • 使用较新的固件（20+版）和硬件的数据包大小谈判。
  • 标签列表，包括控制器和程序标签。
• 支持Rockwell/Allen-Bradley Micro 850 Plcs。
  • 支持Controllogix如有可能。
• 支持旧的Rockwell/Allen-Bradley，例如PLC-5 PLC（以太网升级以支持以太网/IP），SLC 500和Micrologix通过CIP进行以太网。
  • 读/写16位int。
  • 读/写32位浮点。
  • 读/写入上述数组（阵列未在SLC 500上测试）。
• 支持旧的Rockwell/Allen-Bradley Plcs在DH+桥（即带有DHRIO模块的LGX底盘）上访问的支持，例如PLC/5，SLC 500和MICROGIX。
  • 读/写16位int。
  • 读/写32位浮点。
  • 上述阵列的读/写。
• 广泛的示例代码。包括
  • 标签列表。
  • 设置和处理回调。
  • 从多个标签中记录数据。
  • 从命令行读取和编写标签。
  • 获取和设置单个位作为标签。
• 对Omron NX/NJ系列PLC的支持，例如Allen-Bradley Micro800。
• 支持Modbus TCP。

平台支持

• CMAKE构建系统，可在Windows，Linux和MacOS上获得更好的跨平台支持。
  • Microsoft Visual Studio的最新版本中存在本机Cmake支持。
• 使用特定库API使用和支持的语义版本控制，以兼容和功能检查。
• 除libc（以及某些平台上的pthreads）外，C库没有依赖关系。
• 为Ubuntu 18.04，MacOS 10.15和Windows 10。所有64位，带有32位Windows和Ubuntu的二进制版本。
• Raspberrypi支持。 Linux和Windows IoT均基于（配置Visual Studio进行构建需要一些精力）。

替代编程语言

C库设计用于易于包装。许多其他语言的包装器包括以下内容：

• 是Github libplctag组织的一部分的包装器：
  • .NET CORE，.NET框架，libplctag.net。非常受欢迎！
  • Go Goplctag
  • Java libplctag4j
  • 朱莉娅（Julia），plctag.jl
• C来源包含的最小包装器：
  • C ++
  • Python
  • 帕斯卡
• Github上的其他包装器：
  • C＃，Corsinvest
  • C＃，Mesta自动化
  • LabView，（请参阅Libplctag-LabView）

代码

如何获取代码

核心库的代码位于libplctag。稳定代码在默认发行分支上。如果您从GitHub查看代码，则将默认为发布分支。

如果您想要预构建的二进制文件，我们在版本页面上提供它们。只需选择您想要的一个，然后为系统下载zip文件即可。我们为X86 Linux和Windows有32位和64位构建，以及64位构建X86-64 MacOS。

转到Libplctag组织的主要项目，以查看其他包装纸。我们现在处于过渡状态，因为我们将更多的替代语言包装器移至GitHub组织。

示例代码

哦，等等，您想要代码！示例目录中有很多示例。

一个很好的起点很简单。

该代码读取几个32位签名的整数（DINT），对其进行更新，然后将它们写回并从logix-Class Allen-Bradley Plc中的名为TestBigarray的标签中重新读取它们。

示例目录中的读数文件描述了一些更有趣的文件。

API

API中的大多数功能用于数据访问。图书馆提供了对单位，8位，16位，32位和64位单词（整数和浮点）的直接支持。

有关更多信息，请参见API。

把招工广告

我们需要并欢迎以下帮助：

• 错误报告！我们可能没有您的硬件，因此您的错误可以帮助我们确保库在找不到的情况下工作！
• 错误修复。
• 其他协议，例如Modbus，SBUS等
• 其他平台，例如Android，iOS等
• 其他PLC的更改和增加。
• 其他编译器。
• 更多语言包装纸！
• 现有语言包装器的补丁和更新！
• 测试和更多测试！

如何贡献

我们喜欢贡献！多年来，许多用户贡献了包装纸，额外的功能和错误修复。对于用户提供的所有帮助，图书馆要好得多。我们要求您对核心库的代码贡献在相同的双MPL/LGPL许可下。

对我们来说很难进行测试，因为我们无法访问那里的所有其他硬件。如果可以的话，贡献的好方法是测试预发行。这些在预发行分支上！我们感谢我们以这种方式从用户那里获得的所有帮助。

为核心图书馆做出贡献的最简单方法是在Github上提出公关。

其他语言的包装器通常分为单独的项目。这些可能具有不同的许可和贡献流程。请查看有关包装器的文档。

历史

有关如何创建libplctag以及为什么我们构建它的更多详细信息，请参见Wiki历史页面。

联系和支持

有两种寻求帮助或与我们联系的方法。

libplctag论坛

如果您对图书馆，其使用或包装库之一有一般性问题或评论，请加入Google Group libplctag！

该论坛对所有人开放，但只能通过要求将垃圾邮件发送者拒之门外。流量相当轻，通常每月少数电子邮件。这是用户提出问题并进行讨论的主要手段。关于发布的公告在论坛上发生。

github

如果您发现错误或需要特定功能，请在GitHub的主要C库项目中将其提交。每个包装器项目都有自己的问题跟踪器。

如果需要，我们将启动私人通信。

执照

有关我们的法律免责声明，请参见许可证文件（license.mpl或License.lgpl），该图书馆的责任，健身或适销性以及您在使用本库的使用权。该代码是根据Mozilla公共许可证2.0（MPL 2.0）或GNU LISHER/LIBLISP PENCERAL LICENT LICENT 2或更高版本（LGPL 2+）的双重许可。

此双重许可适用于Core C库。其他语言的其他包装器可能会在不同的许可下。请参阅这些项目以获取更多信息。

归因和商标

PLC5，SLC 500，Micrologix，Micro8x0，Compactlogix和Controllogix是Rockwell/Allen Bradley的商标。 Windows和Visual Studio是Microsoft的商标。苹果公司拥有Macos的商标。

如果我们错过了一些，请告诉我们，以便我们可以正确获得所有属性！

结尾

玩得开心，让我们知道这个库是否对您有用。如果您遇到错误，请发送测试用例。由于PLC硬件相当昂贵，因此我们可能无法测试您的测试方案。如果可能，请发送补丁。我们不要求您将版权转移给我们，但我们确实要求您根据使用相同的许可证进行任何提交的补丁。我们不会根据GPL许可证或与MPL 2.0许可不兼容的任何补丁。

希望您发现这个图书馆和我们一样有用！

• libplctag团队