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團隊