HslCommunication組件庫使用說明

時間 2019-11-20

標籤 hslcommunication 組件使用說明简体版

原文原文鏈接

一個由我的開發的組件庫，攜帶了一些衆多的功能，包含了數據網絡通訊，文件上傳下載，日誌組件，PLC訪問類，還有一些其餘的基礎類庫。html

nuget地址：https://www.nuget.org/packages/HslCommunication/ java

github地址：https://github.com/dathlin/HslCommunication 若是喜歡能夠star或是fork，還能夠打賞支持。linux

API文檔的網址：http://api.hslcommunication.cn/ 若是打不開，請經過QQ羣，聯繫做者。git

組件官網：http://www.hslcommunication.cngithub

論壇(暫時已經關閉)：http://bbs.hslcommunication.cn/web

創做不易，感謝打賞

聯繫做者及加羣方式（激活碼在羣裏發放）：http://www.hslcommunication.cn/Cooperation算法

本庫支持C#版本和java版本，java版本爲閹割版，具體參照源代碼，或是加羣瞭解。數據庫

NuGet地址：

https://www.nuget.org/packages/HslCommunication/編程

安裝本組件的NuGet指令爲：api

Install-Package HslCommunication

也能夠在Nuget管理器的界面進行圖形化安裝。若是不清楚如何安裝，請參考：http://www.cnblogs.com/dathlin/p/7705014.html

使用限制

我的用戶可免費用於學術研究，測試。

若是，我的全部依賴組件的項目年總值小於3000元如下的，只須要一次性付費240rmb，加入普通vip便可得到永久使用的權利，永久發放激活碼。

我的的年總值大於3000（含）的，須要進行我的的商業受權，一次性付費2400rmb，加入超級Vip羣來得到永久的商用權利，商業權利歸屬我的，開發的軟件的產品信息必須是本人，不能是其餘人，更不能是企業。

企業用戶，須要一次性支付5000rmb，獲取20年的商業付費權利。企業用戶支持開發票，簽定合同。企業用戶受權對象對企業，商業權利歸屬企業全部，不得用於我的，產品信息必須帶有企業的名稱及logo。

運行環境

.Net Framework

支持 .Net Framework3.5 及以上運行環境。

.Net Standard

這個版本的庫主要應用於.Net Core項目，編寫其餘平臺支持的程序時用到。支持.Net Standard 2.0

移除了原先庫中全部窗體，控件代碼，全部的網絡通信塊都是完成的功能繼承。

Demo 信息，最新的功能支持請參照DEMO界面更新，最新的更新日誌請查找API文檔信息

功能列表----(更新不及時，請參照上面的demo界面)

並在本界面開源部分的源代碼，尤爲是通用的方法

當前最新版：最新更新日誌參照 http://api.hslcommunication.cn

V8.1.3 更新日誌:

1. Lsis: 感謝埃及朋友的支持，demo完善了cpu類型的選擇。
2. LogNet:新增移除關鍵字的接口方法，修復linux運行路徑解析的bug，完善api文檔的示例代碼。
3. 大量的細節優化，變量名稱單次拼寫錯誤的修復。
4. Modbus: 當地址爲x=3;100時，讀正常，寫入異常的問題修復，功能碼自動替換爲0x10。
5. FileNet: 修復高併發下載時的下載異常的問題，調整指令頭的超時時間。
6. AB plc: 公開一個新的api接口，運行配置一些比較高級的數據。
7. 接下來計劃：1.完善hsl的demo，api文檔，準備基礎的入門視頻；2.開始完善java版本的代碼，java版本只對超級VIP羣開放。
8. 本組件付費受權模式，詳細參考官方：http://www.hslcommunication.cn/ 。

V8.1.2 更新日誌：

1. Lsis: 感謝埃及朋友的支持，demo增長了bool操做。
2. Knx驅動：增長測試demo，完善驅動，測試經過，有須要的朋友能夠查看信息。
3. IntegrationFileClient: 完善文件的收發類，新增重載的構造方法，傳入ip地址及端口便可。
4. melsec: 三菱的MC協議部分錯誤代碼關聯了文本信息，在測試的時候便可彈出錯誤信息，方便排查，常見了已經綁定。
5. melsec: 新增3e協議的隨機字批量讀取操做，支持跨地址，跨數據類型混合交叉讀取，一次便可讀完。
6. fileserver: 修復linux下的bug，新增上傳文件後的觸發事件，將文件的信息都傳遞給調用者。
7. SiemensMpi: 添加MPI協議，並完善demo，等待測試。
8. 本組件付費受權模式，詳細參考官方：http://www.hslcommunication.cn/ 。

V8.1.1 更新日誌：

1. Lsis: 感謝埃及朋友的支持，修復了一些bug，支持了bool的操做。
2. Redis: 新增db塊屬性設置，修復短鏈接下切換db塊無效的bug，由於db塊是跟隨鏈接的。
3. MQTT: 修復客戶端和服務器的長度計算bug，支持和其餘mqtt組件混合使用。
4. MQTT Demo: 優化demo功能，支持文本追加或是覆蓋選擇，文本格式化查看選擇。
5. Http Server: 支持跨域屬性選擇，編碼統一爲utf-8，兼容瀏覽器和postman，demo中增長返回類型示例。
6. Modbus server及Lsis Server: 針對.net standard版本，開放串口。
7. 我的商用認定調整，我的用戶在一個天然年裏全部使用本組件的項目銷售總額小於3000元整的不算我的商用，得到激活碼便可。
8. 企業商用的使用年限及開放源代碼年限調整爲20年，感謝全部付費用戶的支持。
9. 本組件付費受權模式，詳細參考官方：http://www.hslcommunication.cn/ 。

V8.1.0

1. ModbusUdp: 新增一個Modbus的基於udp的協議類，使用的tcp的報文的機制。
2. HttpServer: 新增一個http的服務器封裝類，方便實現基於webapi的後臺功能，集成GET，POST的接口操做。
3. Serial Ports: standard項目依賴官方串口庫，實現全部的設備的串口支持，可應用於跨平臺。
4. standard: 在nuget上提供.net standard2.1版本的庫。
5. 本組件從v8.0.0開始進入付費受權模式，詳細參考官方：http://www.hslcommunication.cn/ 。

V8.0.3

1. Networkbase: 修復套接字網絡受權失敗時不關閉網絡的bug。
2. SoftBasic: 新增一個數組數據格式化的方法信息。
3. MqttServer: 新增一個mqtt的服務器，初步支持訂閱，發佈訂閱，強制發佈訂閱，在線客戶端數量功能等等。
4. Demo: 全部的PLC的demo和modbus協議的demo，支持批量讀取各類類型的數組數據。
5. Nuget: 新增本項目的圖標，在nuget上搜索時會顯示圖標。
6. 本組件付費受權模式，詳細參考官方：http://www.hslcommunication.cn/ 。

V8.0.2

1. ABBWebClient: abb機器人的api讀取日誌的接口新增一個參數，讀取最近的日誌數量。默認爲10條。
2. MQTTClient: 修復mqtt客戶端類的消息重複bug，修復發送空訂閱的bug。
3. SiemensS7Net: 西門子的s7協議的類新增一個api，支持時間的讀寫，支持異步，時間格式和s7net一致。
4. 本組件付費受權模式，詳細參考官方：http://www.hslcommunication.cn/ 。

V8.0.1

1. 全部網口透傳類對象完善實例化的方法，都新增一個指定ip及端口的實例方法。
2. ABBWebClient: 完善實例化方法，修改ToString的格式化內容，提煉了webapi的基類，開放ip地址和端口。
3. ABBWebClient: 新增提供了機器人自身IO，擴展IO，最新的報警日誌的數據讀取API。
4. NetSimplifyClient: 修復了當ReceiveTimeOut小於0，可是實際接收時會發生奔潰的bug。
5. NetPlainSocket: 新增一個基於socket的明文的網絡發送和接收類，採用事件驅動的機制。
6. LogNet: 日誌類對象新增一個特性，當日志的文件名設置爲空的時候，將不會建立文件，僅僅觸發 BeforSaveToFile 事件，方便日誌顯示。
7. XGBCnet: Lsis的plc的串口類修復一個bug，感謝埃及朋友的貢獻。
8. SoftIncrementCount: 消息號自增類新增一個方法，重置當前的消息號。
9. PanasonicMewtocol: 修復松下的串口類讀寫單個bool時異常的bug，地址支持字+位的表示方式，R33=R2.1，方便你們輸入測試。
10. MqttClient: 新增一個Mqtt協議的客戶端類，支持用戶名密碼，支持發佈，支持訂閱，支持重連，歡迎一塊兒測試。
11. 本組件付費受權模式，詳細參考官方：http://www.hslcommunication.cn/ 。

V8.0.0

1. SimpleHybirdLock: 簡單混合鎖的性能優化，基元對象採用懶加載的機制實現，同時增長了高級混合鎖的類，支持自旋，線程擁有權，在高競爭的狀況下性能大幅增長。
2. NetSoftUpdateServer: 軟件自動更新的服務器端支持傳送指定目錄下的文件及其子文件夾下的全部文件內容，都將更新到客戶端的電腦上去。
3. AllenBradleyNet: 修復字符串的讀寫bug，支持讀寫任意長度的字符串信息。
4. MelsecFxSerial: 三菱編程口協議支持讀寫D1024以上地址的數據，感謝廈門-Mr.T 的貢獻。
5. PIDHelper: 新增一個Pid的輔助類，用於模擬pid的波形狀況。
6. NetPushClient: 修改一個時間的註釋，追加單位信息，時間的單位是毫秒。
7. XGBFastEnet: 感謝埃及的朋友，修復了一些bug信息。
8. MelsecFxSerialOverTcp: 新增基於網口透傳的三菱的編程口通信類。
9. MelsecFxLinksOverTcp: 新增基於網口透傳的三菱的計算機連接協議的通信類。
10. MelsecA3CNet1OverTcp: 新增基於網口透傳的三菱的A-3C的協議的通信類。
11. OmronHostLinkOverTcp: 新增基於網口透傳的歐姆龍的hostLink協議的通信類。
12. PanasonicMewtocolOverTcp: 新增基於網口透傳的松下的Mewtocol協議的通信類。
13. SiemensPPIOverTcp: 新增基於網口透傳的西門子PPi協議的通信類。
14. XGBCnetOverTcp: 新增基於網口透傳的Lsis的XGBCnet協議的通信類。
15. KeyenceNanoSerialOverTcp: 新增基於網口透傳的基恩士的NanoSerial串口協議的通信類。
16. FujiSPBOverTcp: 新增基於網口透傳的富士的SPB串口協議的通信類。
17. FatekProgramOverTcp: 新增基於網口透傳的永宏plc的串口協議的通信類。
18. ModbusRtuOverTcp: 新增基於網口透傳的Modbus rtu協議的通信類。
19. Modbus相關的功能類進行代碼精簡，重構，優化，api標準化爲ReadBool,WriteBool,Read,Write，移除了一些特殊的方法api，本次升級不兼容。
20. FFTFilter: 新增一個基於FFT（快速離散傅立葉變換）的濾波功能，能夠做爲一個高級的曲線擬合方案，詳細參照demo，感謝北京-monk 網友的支持。
21. KnxUdp: 新增一個KnxUdp的數據通信類，感謝上海-null的支持。
22. ABBWebApiClient: 新增ABB機器人的基於web api的訪問機制的通信類。
23. SickIcrTcpServer: 新增一個sick的條碼讀取類，支持被動鏈接，主動鏈接，通過測試，同時支持海康，基恩士，DATELOGIC掃碼器。
24. Demo: Demo工具新增了一個基於tcp的服務器的測試界面。
25. 本組件付費受權模式，詳細參考官方：http://www.hslcommunication.cn/ 。
26. 我的商業用途及源代碼須要申請加入超級vip羣，羣號：189972948，入羣費：2400rmb。時間爲無期限，永久支持，不限制項目數量。
27. 企業商業用途須要加入超級vip羣，羣號：189972948，入羣費：5000rmb，商業受權爲20年，期間開放源代碼，不限制開發人數，項目數量，企業logo在將官網展現。

v5.2.1 更新日誌

API文檔中西門子FW協議示例代碼修復。
modbus-rtu修復讀取線圈和輸入線圈的值錯誤的bug。
Demo新增字節轉換工具。

v5.2.0 更新日誌

項目新增api文檔，提供離線版和在線版，文檔提供了一些示例代碼。
modbus-rtu新增批量的數組讀取方法。
modbus-rtu公開ByteTransform屬性，方便的進行數據轉換。
SoftMail刪除發送失敗10次不能繼續發送的機制。
modbus server新增站號屬性，站號不對的話，不響應rtu反饋。
modbus server修復讀取65524和65535地址提示越界的bug。
Demo項目提供了tcp/ip的調試工具。

v5.1.3 更新日誌

　　1. Modbus服務器新增數據大小端配置。
　　2. Modbus服務器支持數據存儲本地及從本地加載。
　　3. 修復modbus服務器邊界讀寫bug。
　　4. ByteTransformBase的double轉換bug修復。
　　5. 修復ReverseWordTransform批量字節轉換時隱藏的一些bug。
　　6. SoftBasic移除2個數據轉換的方法。
　　7. 修復modbus寫入單個寄存器的高地位倒置的bug。
　　8. 修復串口通訊過程當中字節接收不完整的異常。包含modbus服務器和modbus-rtu。
　　9. 添加了.net 4.5項目，而且其餘項目源代碼引用該項目。添加了單元測試，逐步新增測試方法。

v5.1.2 更新日誌

IByteTransform接口新增bool[]數組轉換的2個方法。
Modbus Server類新增離散輸入數據池和輸入寄存器數據池，能夠在服務器端讀寫，在客戶端讀。
Modbus Tcp及Modbus Rtu及java的modbus tcp支持富地址表示，好比"s=2;100"爲站號2的地址100信息。
Modbus Server修復一個偶爾出現屢次異常下線的BUG。
其餘註釋修正。

v5.1.1 更新日誌

修復西門子fetch/write協議對db塊，定時器，計數器讀寫的BUG。
埃夫特機器人修復tostring()的方法。
modbus客戶端新增兩個屬性，指示是否字節顛倒和字符串顛倒，根據不一樣的服務器配置。
IReadWriteNet接口補充幾個數組讀取的方法。
新增一個全新的鏈接池功能類，詳細 http://www.javashuo.com/article/p-gjwvfwjw-gr.html
其餘的小bug修復，細節優化。

v5.1.0 更新日誌

Modbus服務器支持串口發送數據時也會觸發消息接收。
IReadWriteNet接口新增Read(string address,ushort length)方法。
提煉統一的設備基類，支持Read方法及其擴展的子方法。
修復埃夫特機器人的讀取BUG。
三菱PLC支持讀取定時器，計數器的值，地址格式爲"T100"，"C100"。
新增快速離散的傅立葉頻譜變換算法，並在Demo中測試三種週期信號。

v5.0.10 更新日誌

Modbus Tcp及Rtu支持手動更改站號。也就是支持動態站號調整。
修復上個版本遺留的Modbus在地址偏移狀況下會多減1的BUG。

v 5.0.9 更新日誌

優化ComplexNet客戶端的代碼。
更新埃夫特機器人的讀取機制到最新版。
Modbus Rtu及串口基類支持接收超時時間設置，不會一直卡死。
Modbus Tcp及Rtu都支持帶功能碼輸入，好比讀取100地址，等同於03X100。（注意：該多功能地址僅僅適用於Read及相關的方法）

v5.0.8 更新日誌

新增一個埃夫特機器人的數據訪問類。
雙模式客戶端的長鏈接支持延遲鏈接操做，經過一個新方法完成。

v5.0.7 更新日誌

        1. Modbus服務器提供在線客戶端數量屬性。
        2. 全部服務器基類添加端口緩存。
        3. 雙模式客戶端完善鏈接失敗，請求超時的消息提示。
        4. 修復雙模式客戶端某些特殊狀況下的頭子節NULL異常。
        5. 修復三菱交互類的ASCII協議下的寫入數據異常。

v5.0.6 更新日誌

1. 提煉數據轉換基類，優化代碼，修復WordReverse類對字符串的BUG，至關於修復modbus和omron讀寫字符串的異常。
2. 新增一個全新的功能類，數據的推送類，輕量級的高效的訂閱發佈數據信息。具體參照Demo。

v5.0.5 更新日誌

1. Modbus相關的代碼優化。
2. 新增Modbus-Rtu客戶端模式，配合服務器的串口支持，已經能夠實現電腦本機的通信測試了。

v5.0.4 更新日誌

        1. Modbus-tcp服務器同時支持RTU數據交互。
        2. 異形客戶端新增在線監測，自動剔除訪問異常設備。
        3. modbus-tcp支持讀取輸入點
        4. 全部客戶端設備的鏈接超時判斷增長休眠，下降CPU負載。
        5. 西門子批量讀取上限爲19個數組。
        6. 其餘小幅度的代碼優化。

v5.0.3 更新日誌

          1. 修復Modbus-Tcp服務器的空異常。
          2. 修復西門子類寫入float，double，long數據異常。
          3. 修復modbus-tcp客戶端讀寫字符串顛倒異常。
          4. 修復三菱多讀取數據字節的問題。
          5. 雙模式客戶端新增異形客戶端模式，變成了三模式客戶端。
          6. 提供異形modbus服務器和客戶端Demo方便測試。

v5.0.2 更新日誌

1. ComplexNet服務器代碼精簡優化，移除客戶端的在線信息維護代碼。
2. 西門子訪問類第一次握手信號18字節改成0x02。
3. 更新JSON組件到11.0.2版本。
4. 日誌存儲類優化，支持過濾存儲特殊關鍵字的日誌。
5. Demo項目新增控件介紹信息。

v5.0.1 更新日誌

OperateResult靜態方法擴充。
文件引擎提高緩存空間到100K，加速文件傳輸。
三菱添加讀取單個bool數據。
Modbus-tcp客戶端支持配置起始地址不是0的服務器。
其餘代碼優化。

v5.0.0 更新日誌

網絡核心層從新開發，徹底的基於異步IO實現。
全部雙模式客戶端類進行代碼重構，接口統一。
完善並擴充OperateResult對象的類型支持。
提煉一些基礎的更加通用的接口方法，在SoftBasic裏面。
支持歐姆龍PLC的數據交互。
支持三菱的1E幀數據格式。
不兼容升級，謹慎操做。

v4.3.5 更新日誌

修復Modbus-tcp服務器接收異常的BUG。
修復SoftBasic.ByteTo[U]ShortArray兩個方法異常。

v4.3.4 更新日誌

Json組件更新至11.0.1版本。
緊急修復日誌類的BeforeSaveToFile事件在特殊狀況的觸發BUG。

v4.3.3 更新日誌

曲線控件增長一個新的屬性，圖標標題。
Modbus tcp服務器端的讀寫BUG修復。
西門子訪問類從新支持200smart。

v4.3.2 更新日誌

曲線控件最新時間顯示BUG修復。
Modbus tcp錯誤碼BUG修復。
三菱訪問類完善long類型讀寫。
西門子訪問類支持1500系列，支持讀取定貨號。

v4.3.1 更新日誌

優化modbus tcp客戶端的訪問類，支持服務器返回錯誤信息
優化曲線控件，支持橫軸文本顯示，支持輔助線標記，詳細見對應博客

v4.3.0 更新日誌

信號燈控件顯示優化
Modbus Tcp服務端類修復內存暴漲問題
winfrom客戶端提供一個曲線控件，方便顯示實時數據，多曲線數據

v4.2.4 更新日誌

雙模式的網絡基類中新增一個讀取超時的時間設置，若是爲負數，那麼就不驗證返回。

v4.2.3 更新日誌

修復modbus tcp客戶端讀取某些特殊設備會讀取不到數據的BUG。

v4.2.2 更新日誌

修復modbus tcp客戶端讀取 float, int, long,的BUG。

v4.2.1 更新日誌

餅圖控件新增一個是否顯示佔比很小的信息文本。
新增一個旋轉開關控件。
新增一個信號燈控件。

v4.2.0 更新日誌

新增一個儀表盤控件。

v4.1.9 更新日誌

餅圖顯示優化，新增是否顯示百分比的選擇。

v4.1.8 更新日誌

新增一個餅圖控件。

v4.1.7 更新日誌

進度條控件新增一個新的屬性對象，是否使用動畫。

v4.1.6 更新日誌

OperateResult成功時，消息爲成功。
數據庫輔助類API添加，方便的讀取聚合函數
日誌類分析工具界面，顯示文本微調。

v4.1.5 更新日誌

修復流水號生成器沒法生成不帶日期格式的流水號BUG。

v4.1.4 更新日誌

modbus tcp提供讀取short數組的和ushort數組方法

v4.1.3 更新日誌

進度條控件修復初始顏色爲空的BUG。
進度條控件文本鋸齒修復。
按鈕控件沒法使用灰色按鈕精靈破解。

v4.1.2 更新日誌

完善Modbus tcp服務器端的數據訂閱功能。
進度條控件支持水平方向和垂直方向兩個模式。

v4.1.1 更新日誌

完善日誌記錄，提供關鍵字記錄操做。
三菱，西門子，modbus tcp客戶端提供自定義數據讀寫。
modbus tcp服務端提供數據池功能，並支持數據訂閱操做。
提供一個縱向的進度控件。

v4.1.0 更新日誌

修復西門子讀取的地址偏大會出現異常的BUG。
完善統一了全部三菱，西門子，modbus客戶端類的讀寫方法，已經更新到博客。

v4.0.3 更新日誌

三菱，西門子，Modbus tcp客戶端內核優化重構。
三菱，西門子，Modbus tcp客戶端提供統一的報文測試方法，該方法也是通訊核心，全部API都是基於此擴展起來的。
三菱，西門子，Modbus tcp客戶端提供了一些便捷的讀寫API，詳細參見對應博客。
三菱的地址區分十進制和十六進制。
優化三菱的位讀寫操做。

v4.0.2 更新日誌

修復Modbus tcp批量寫入寄存器時，數據解析異常的BUG。
三菱訪問器新增加鏈接模式。
三菱訪問器支持單個M寫入，在數組中指定一個就行。
三菱訪問器提供了float[]數組寫入的API。
三菱訪問器支持F報警器，B連接繼電器，S步進繼電器，V邊沿繼電器，R文件寄存器讀寫，不過還須要大面積測試。
三菱訪問器的讀寫地址支持字符串形式傳入。
其餘的細節優化。
感謝 hwdq0012 網友的測試和建議。
感謝 吃飽睡好 好朋友的測試

v4.0.1 更新日誌

兼容更新：

更新了三菱的讀取接口，提供了一個額外的字符串表示的方式，OperateResult<byte[]> read = melsecNet.ReadFromPLC("M100", 5);
更新了西門子的數據訪問類和modbus tcp類提供雙模式運行，按照以前版本的寫法是默認模式，每次請求從新建立網絡鏈接，新增模式二，在代碼裏先進行鏈接服務器方法，自動切換到模式二，每次請求都共用一個網絡鏈接，內部已經同步處理，加速數據訪問，若是訪問失敗，自動在下次請求是從新鏈接，若是調用關閉鏈接服務器，自動切換到模式一。

v4.0.0 更新日誌

　　與3.X版本不兼容，謹慎升級。若是要升級，OperateResultBytes改爲OperateResult<byte[]>，OperateResultString改爲OperateResult<string>，主要涉及的代碼包含PLC的數據訪問和同步數據通訊

刪除了2個類，OperateResultBytes和OperateResultString類，提供了更增強大方便的泛型繼承類，多達10個泛型參數。地址見http://www.cnblogs.com/dathlin/p/7865682.html
將部分類從HslCommunication命名空間下移動到HslCommunication.Core下面
提供了一個通用的ModBus TCP的客戶端類，方便和服務器交互。
完善了HslCommunication.BasicFramework.SoftBaisc下面的輔助用的靜態方法，提供了一些方便的數據轉化，在上面進行公開。

v3.17.16 更新日誌