Docklight scripting可以幫助用戶測試串行設備和測試通訊協議，直接在軟件上添加設備串行地址就可以在軟件上快速進行測試，可以在軟件上編輯發送的內容，可以在軟件查看接收到的通訊數據，從而在軟件上分析設備通訊數據，軟件功能豐富，支持模擬串行設備、監控兩個設備之間的串行通信、捕捉特定序列并拍攝通信快照、記錄和分析測試結果，也可以在軟件上檢查具有隨機字符的序列，可以對RS232握手信號控制與監測，需要就可以下載軟件使用。

軟件功能

　　Docklight是串行通信協議（RS232、RS485/422等）的測試、分析和模擬工具。它允許您監視兩個串行設備之間的通信或測試單個設備的串行通信。Docklight易于使用，幾乎適用于任何運行Windows 11、Windows 10、Windows 8或Windows 7的標準PC。

　　Docklight的主要功能包括

　　·模擬串行協議-Docklight可以根據使用的協議發送用戶定義的序列，并對傳入的序列做出反應。這使得模擬串行通信設備的行為成為可能，這對于生成難以用原始設備再現的測試條件（例如問題條件）特別有用。

　　·記錄RS232數據-可以使用兩種不同的文件格式記錄所有串行通信數據。使用純文本格式進行快速日志記錄和存儲大量數據。帶有樣式文本的HTML文件格式使您能夠輕松區分傳入和傳出數據或附加信息。Docklight還可以記錄任何二進制數據流，包括ASCII 0字節和其他控制字符。

　　·檢測特定的數據序列-在許多測試情況下，您需要檢查RS232數據中指示問題狀況的特定序列。Docklight為您管理此類數據序列的列表，并可以在檢測到序列后執行用戶定義的操作，例如在收到錯誤消息之前和之后對所有通信數據進行快照。

　　·響應傳入數據-Docklight允許您為接收到的不同通信序列指定用戶定義的答案。這允許您在幾分鐘內為串行設備構建一個基本的模擬器。它還可以通過在收到錯誤消息后發送診斷命令來幫助您跟蹤特定的錯誤。

　　Docklight將使用您的操作系統提供的COM通信端口。在物理上，這些端口在許多情況下將是RS232 SUB D9接口。然而，也可以將Docklight用于其他通信標準，如RS485和RS422，它們具有與RS232不同的電氣設計，但遵循RS232通信機制。

　　Docklight還成功測試了許多流行的USB到串行轉換器、藍牙串行端口、GPS接收器、虛擬零調制解調器、Arduino、Micropython/pyboard或其他在Windows中添加COM端口的嵌入式/UART板。

　　對于RS232全雙工監控應用，我們建議使用Docklight Tap USB附件或Docklight監控電纜。

軟件特色

　　Docklight Scripting是Docklight RS232終端/RS232監視器的擴展版。它具有易于使用的腳本語言，以及用于創建和運行自動測試作業的內置編輯器。Docklight腳本允許您執行所有基本的Docklight操作（發送預定義的數據序列、檢測傳入數據流中的特定序列等），并將它們嵌入到您自己的測試代碼中。

　　Docklight Scripting已啟用網絡。Docklight Scripting不使用串行COM端口，而是可以建立TCP連接（TCP客戶端模式）、接受本地端口上的TCP連接（TCP-服務器模式）或充當UDP對等端。它還支持USB HID連接和命名管道。

　　Docklight腳本為您提供了靈活性和簡單性。幾分鐘內，您就可以構建自己的自動化測試工具，并創建：

　　·時間控制的測試作業（例如，如果設備響應不正常，每5分鐘發送一次診斷命令并報告錯誤）

　　·重復測試循環（例如運動控制/驅動系統的耐久性測試）

　　·自動設備配置腳本（例如，在交付前將RS232設備重置為出廠默認值）

　　·用于服務和維護任務的故障分析工具（例如運行一組診斷命令和執行自動故障分析）

　　·具有自動校驗和計算功能的協議測試器（例如CRC-循環冗余碼）

　　·Docklight啟動腳本（例如，在PC啟動時自動啟動COM端口日志記錄任務）

　　Docklight Scripting使用VBScript引擎，允許您使用簡單、知名的腳本語言編寫測試。Docklight的基本功能和特性是通過一組小而方便的Docklight腳本命令提供的。

使用方法

　　1、將Docklight Scripting直接安裝到電腦，設置軟件的安裝地址

　　2、直接復制注冊碼到軟件01 03 16892042954，保持空格，點擊立即激活

　　3、在使用您的個人Docklight許可證密鑰啟用功能齊全的Docklight版本之前，請仔細閱讀適用于Docklight軟件產品的許可協議：

　　4、歡迎使用Docklight Scripting。從以下選項中進行選擇，并開始發現一些基本功能和特性。

　　打開一個示例/演示腳本，為模擬調制解調器執行自動測試運行。這將演示Docklight的基本功能和腳本命令。

　　打開現有Docklight腳本（.pts）文件

　　探索Docklight中的示例ScriptSamples文件夾

　　打開現有Docklight項目（.ptp）文件

　　從一個空白項目/空白腳本開始

　　以后不再顯示此對話框

　　5、編輯功能

　　編輯發送序列列表。

　　編輯接收序列列表。

　　交換發送和接收序列列表

　　在通信窗口中查找序列。

　　清除通信窗口

　　6、工具界面

　　啟動通信日志記錄。

　　停止通信日志記錄

　　啟動快照模式

　　停止快照模式

　　鍵盤控制臺打開

　　鍵盤控制臺關閉

　　最小化文檔/腳本區域

　　最小化序列列表

　　項目設置。。

　　7、通信窗口格式

　　背景顏色

　　字體大小10

　　格式化文本輸出（富文本

　　通道1文本顏色

　　通道2文本顏色

　　注釋文本顏色

　　純文本輸出（顯示速度更快，但沒有顏色和字體）

　　控制字符（ASCll 0-31）

　　在ASCll通信窗口中添加字符描述（例如、）

　　取消顯示原始控制字符。除了/（換行）

　　8、添加日期/時間戳

　　當數據流在通道1和通道2之間切換時，添加以下信息：

　　時間戳（小時/分鐘/秒）

　　日期戳（日/月/年）

　　開始新換行

　　時鐘附加日期/時間戳5秒

　　每一個

　　暫停檢測附加日期/時間0.5秒

　　通信暫停后蓋章

　　時間格式

　　1/1000秒分辨率（格式23:59:59.999）

　　1/100秒分辨率（23:59:59.99，如Docklight V1.0-V1.8）

　　1秒分辨率（格式23:59:59）

　　9、這里是軟件的幫助界面，可以直接查看官方的教程內容

官方教程

　　如何處理和顯示串行數據

　　Docklight以面向8位的方式處理所有串行數據。每個串行數據序列都由一個或多個8位字符組成。Docklight允許您

　　·以ASCII、HEX、Decimal或Binary格式顯示串行數據

　　·將串行數據復制到剪貼板并粘貼到標準文本文件或格式化的Microsoft?word文檔中，或者使用數據創建發送/接收序列。

　　·打印出序列數據、用戶評論和其他信息

　　Docklight的通信窗口顯示所選串行端口上的當前通信。Docklight區分兩個通信通道（通道1和通道2），這兩個通道表示發送/接收模式下的傳入和傳出數據，或者在監控模式下觀察到的兩個通信信道。信道1和信道2數據使用不同的顏色或字體顯示，并且通信數據可以打印或存儲為純文本或HTML格式的日志文件。

　　除了串行數據外，Docklight還在通信顯示中插入日期/時間戳。默認情況下，每當數據流方向在通道1和通道2之間切換時，或在傳輸新的發送序列之前，都會插入日期/時間戳。有幾個選項可用于插入額外的時間戳。這在監視只有一個通信信道的半雙工線路時尤其有用。請參閱選項-->日期/時間戳

　　Docklight能夠處理包含任何0-255十進制ASCII代碼的串行數據流。由于存在非打印控制字符（ASCII代碼＜32），并且ASCII代碼＞127有不同的編碼，因此并非所有這些字符都可以顯示在ASCII文本窗口中。盡管如此，Docklight將正確處理所有字符，并可以以HEX、Decimal或Binary格式顯示。Docklight將以相同的方式處理任何語言版本的Windows操作系統上的串行數據，盡管ASCII顯示可能不同。對于控制字符（ASCII代碼＜32），可以使用一個額外的顯示選項在通信窗口中顯示其等效文本。請參見“選項”對話框和附錄，ASCII字符集表。

　　Docklight允許您抑制所有原始串行數據，如果您運行的測試不需要查看實際數據，只需要查看使用Receive Sequences生成的附加評估。請參見“通訊過濾器”的項目設置。

　　編輯和管理序列

　　Docklight項目主要由用戶定義的序列組成。它們可以是由Docklight本身發送的發送序列，也可以是用于檢測傳入串行數據中的特殊消息的接收序列。

　　使用“編輯發送序列”或“編輯接收序列”對話框窗口定義序列。此對話框窗口打開

　　1.使用鼠標右鍵從上下文菜單中選擇“編輯”。

　　2.雙擊現有序列，或在選擇“發送序列”或“接收序列”列表的情況下按Ctrl+E。

　　3.雙擊列表末尾的空白字段（或按Ctrl+E）創建新序列時。

　　4.當將新序列粘貼到序列列表中時。

　　Docklight支持在接收序列和發送序列中使用通配符（例如通配符“？”作為一個任意字符的占位符）。

　　測試串行設備或協議實現

　　DL-PC-設備_340x122-OL

　　先決條件

　　·您需要測試協議的規范，例如書面形式。

　　·要測試的串行設備應連接到電腦的一個COM端口。有關如何連接兩個串行設備的詳細信息，請參閱標準RS232電纜一節。

　　·串行設備必須準備好運行。

　　執行測試

　　A） 創建新項目

　　通過選擇菜單“文件”>“新建”“新建項目”創建一個新的Docklight項目

　　B） 設置通信選項

　　1.選擇菜單“工具”>“屬性”“項目設置…”。。。

　　2.選擇通信模式發送/接收

　　3.在通信信道上的發送/接收時，設置串行設備連接的COM端口。

　　4.設置波特率和所需的所有其他COM端口設置。

　　5.確認設置，然后單擊“確定”按鈕關閉對話框。

　　C） 定義要使用的發送序列

　　您可能會根據設備使用的協議，通過發送特定序列來測試串行設備，并觀察設備的反應。執行以下步驟以創建序列列表：

　　1.雙擊“發送序列”表的最后一行。將顯示“編輯發送序列”對話框（另請參見編輯和管理序列）。

　　2.輸入序列的名稱。序列名稱對于定義的每個發送序列都應該是唯一的。

　　3.輸入序列本身。您可以輸入ASCII、HEX、Decimal或Binary格式的序列。使用編輯模式單選按鈕可以隨時在不同格式之間切換。

　　4.單擊“確定”按鈕后，新序列將添加到“發送序列”列表中。

　　重復步驟1-4以定義執行測試所需的其他發送序列。

　　D） 定義使用的接收序列

　　如果您希望Docklight在接收特定序列時做出反應，則必須定義一個接收序列列表。

　　1.雙擊接收序列表的最后一行。將顯示“編輯接收序列”對話框。該對話框由三部分組成：“名稱”字段、“序列”字段和“操作”字段。

　　2.編輯“名稱”和“序列”字段。

　　3.指定Docklight接收到序列后要執行的操作。有四種類型的操作可用：

　　回答-接收序列后，發送其中一個發送序列。

　　注釋-接收序列后，將用戶定義的注釋插入通信窗口（以及日志文件，如果可用）。

　　觸發器-這是捕獲特定序列中描述的高級功能。。。

　　停止-接收到序列后，Docklight停止通信。

　　4.單擊“確定”按鈕將新序列添加到列表中。

　　重復步驟1-4以定義執行測試所需的其他接收序列。

　　E） 存儲項目

　　在運行實際測試之前，建議存儲定義的通信設置和序列。這是使用菜單“文件”>“保存保存項目”來完成的。

　　F） 運行測試

　　通過選擇Run>play Start Communication來啟動Docklight。

　　Docklight將根據指定的參數打開串行連接。然后，它將在通信窗口中顯示所有傳入和傳出的通信。使用Pt_Send_Button發送按鈕將定義的序列之一發送到串行設備。所有數據傳輸的屏幕顯示允許您檢查設備的行為。所有協議信息都可以記錄在文本文件中以供進一步分析。請參閱“記錄和分析測試”一節。

　　提示：使用“文檔區”，您可以輕松地記下其他筆記，或復制并粘貼通信日志的部分內容以獲取更多文檔。

　　模擬串行設備

　　DL模擬OL

　　先決條件

　　·您需要指定要模擬的串行設備的行為，例如，在接收到某個命令后會發回什么樣的信息。

　　·第二個設備連接到PC COM端口，該端口將與模擬器通信。

　　第二個設備及其行為是感興趣的實際對象。一個例子可以是使用串行通信協議定期檢查UPS（不間斷電源）狀態的設備。您可以使用Docklight來模擬UPS的基本行為和某些UPS問題案例。這在測試其他設備時非常有用，因為在真實的UPS上很難再現報警條件（比如壞電池）。

　　注：第二個設備也可以是第二個軟件應用程序?？梢栽谕慌_電腦上運行Docklight和軟件應用程序。只需為兩個應用程序中的每一個使用不同的COM端口，并使用RS232零調制解調器電纜連接兩個COM端口。您也可以為此目的使用虛擬零調制解調器。

　　執行測試

　　A） 創建新項目

　　通過選擇菜單“文件”>“新建”“新建項目”創建一個新的Docklight項目

　　B） 設置通信選項

　　1.選擇菜單“工具”>“屬性”“項目設置…”。。。

　　2.選擇通信模式發送/接收

　　3.在通信信道上的發送/接收時，設置串行設備連接的COM端口。

　　4.設置波特率和所需的所有其他COM端口設置。

　　5.確認設置，然后單擊“確定”按鈕關閉對話框。

　　C） 定義使用的發送序列

　　定義模擬器的所有響應?？紤]模擬設備處于正常狀態時的響應，以及故障狀態下的響應。在上面提到的UPS示例中，電池故障將是這樣一種問題，很難用原始設備再現。要測試其他設備對電池故障的反應，請定義UPS在這種情況下發送的適當響應序列。

　　注意：請參閱測試串行設備。。。了解如何定義發送序列。

　　D） 定義使用的接收序列

　　在大多數情況下，您的模擬設備不會發送未請求的數據，而是會從其他設備進行輪詢。另一個設備將使用一組預定義的命令序列來請求不同類型的信息。在此處定義模擬器必須解釋的命令序列。

　　對于定義的每個命令序列，將“應答”指定為一個操作。選擇C）中定義的序列之一。如果您想使用兩個或多個備用響應序列，請復制同一個接收序列的多個副本，給它們一個不同的名稱（例如“status cmd-answer ok”、“state cmd-response battery failure”、“status cmd-response mains failure”），并將不同的發送序列指定為一個操作。在本例中，“接收序列”列表中有三個元素，它們將用三個不同的答案響應同一命令。在測試過程中，您可以通過使用“活動”列檢查或取消檢查列表元素來決定應發送哪個答案。

　　E） 存儲項目

　　在運行實際測試之前，建議存儲定義的通信設置和序列。這是使用菜單“文件”>“保存保存項目”來完成的。

更新日志

　　Docklight/Docklight Scripting V2.4.5（2022年4月）

　　修復和改進：

　　-新的專家選項：設備->“禁用COM的I/O錯誤檢測/熱插拔功能?！?/p>

　　Docklight V2.3中添加了熱插拔/自動恢復，但即使在正常操作中，也可能會產生一些特定驅動程序的I/O錯誤事件。V2.4有改進，而且您可以始終完全禁用熱插拔（返回V2.2行為）。

　　-改進了在Windows 10及更高版本上使用Microsoft標準驅動程序usbser.sys的設備的COM端口RX定時。

　　-修復了項目和序列文檔區域的錯誤：錯誤的序列索引。

　　-修復了項目和序列文檔區域的錯誤：存儲/重新加載/瀏覽/編輯項目后，表格或其他復雜文檔部分可能會丟失。

　　-修復了刪除USB COM設備后的錯誤，然后在Docklight中停止并重新啟動通信。

　　-Fided罕見的“內部通信處理錯誤”，這在罕見的過載情況下可能發生，例如在睡眠/恢復后。

　　-使用特殊功能字符時改進了校驗和預覽。

　　-修復了罕見的發送按鈕顯示錯誤：當“通道別名”選項處于活動狀態時仍處于按下狀態。

　　-腳本：DL。Openproject現在正確地使用相對路徑，如“..myprojectproject1.ptp”

　　-腳本：為DL添加了“bigEndian”可選參數。計算校驗和

　　-腳本：新DL。MsgBox2方法，作為DL的配套。輸入框2

　　-腳本：改進了多個連接/“側通道”支持。COM端口和（多個）Docklight Tap Pro/485連接現在正確支持側信道ID>4。

　　-腳本：DL。如果不存在許可證密鑰，GetEnvironment（“DOCKLIGHT_VERSION”）現在會將“（Eval）”附加到結果中。

　　-腳本：設置了SO_BROADCAST和SO_REUSEADDR標志的UDP連接。

　　Docklight/Docklight Scripting V2.3.26（03/2020）

　　修復和改進：

　　-修復了握手狀態指示框的錯誤（未持續更新）。

　　-腳本：修復了DL的錯誤。連續追加文本時設置輸出文本。

　　內容限制不正確，現在RTF內容限制在大約510000個字符以內。

　　Docklight/Docklight Scripting V2.3.25（02/2020）

　　修復和改進：

　　-修復了“編輯發送序列/編輯接收序列”對話框的錯誤：

　　對話框在打開后立即處于“序列已修改/應用”狀態，即使沒有進行任何更改。

　　-具有連續通信的特殊應用的實驗性“較低系統影響模式”。