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

軟件功能

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

　　Docklight的主要功能包括

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

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

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

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

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

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

　　對于RS232全雙工監(jiān)控應(yīng)用，我們建議使用Docklight Tap USB附件或Docklight監(jiān)控電纜。

軟件特色

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

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

　　Docklight腳本為您提供了靈活性和簡單性。幾分鐘內(nèi)，您就可以構(gòu)建自己的自動化測試工具，并創(chuàng)建：

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

　　·重復(fù)測試循環(huán)（例如運動控制/驅(qū)動系統(tǒng)的耐久性測試）

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

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

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

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

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

使用方法

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

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

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

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

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

　　打開現(xiàn)有Docklight腳本（.pts）文件

　　探索Docklight中的示例ScriptSamples文件夾

　　打開現(xiàn)有Docklight項目（.ptp）文件

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

　　以后不再顯示此對話框

　　5、編輯功能

　　編輯發(fā)送序列列表。

　　編輯接收序列列表。

　　交換發(fā)送和接收序列列表

　　在通信窗口中查找序列。

　　清除通信窗口

　　6、工具界面

　　啟動通信日志記錄。

　　停止通信日志記錄

　　啟動快照模式

　　停止快照模式

　　鍵盤控制臺打開

　　鍵盤控制臺關(guān)閉

　　最小化文檔/腳本區(qū)域

　　最小化序列列表

　　項目設(shè)置。。

　　7、通信窗口格式

　　背景顏色

　　字體大小10

　　格式化文本輸出（富文本

　　通道1文本顏色

　　通道2文本顏色

　　注釋文本顏色

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

　　控制字符（ASCll 0-31）

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

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

　　8、添加日期/時間戳

　　當(dāng)數(shù)據(jù)流在通道1和通道2之間切換時，添加以下信息：

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

　　日期戳（日/月/年）

　　開始新?lián)Q行

　　時鐘附加日期/時間戳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、這里是軟件的幫助界面，可以直接查看官方的教程內(nèi)容

官方教程

　　如何處理和顯示串行數(shù)據(jù)

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

　　·以ASCII、HEX、Decimal或Binary格式顯示串行數(shù)據(jù)

　　·將串行數(shù)據(jù)復(fù)制到剪貼板并粘貼到標(biāo)準(zhǔn)文本文件或格式化的Microsoft?word文檔中，或者使用數(shù)據(jù)創(chuàng)建發(fā)送/接收序列。

　　·打印出序列數(shù)據(jù)、用戶評論和其他信息

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

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

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

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

　　編輯和管理序列

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

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

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

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

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

　　4.當(dāng)將新序列粘貼到序列列表中時。

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

　　測試串行設(shè)備或協(xié)議實現(xiàn)

　　DL-PC-設(shè)備_340x122-OL

　　先決條件

　　·您需要測試協(xié)議的規(guī)范，例如書面形式。

　　·要測試的串行設(shè)備應(yīng)連接到電腦的一個COM端口。有關(guān)如何連接兩個串行設(shè)備的詳細信息，請參閱標(biāo)準(zhǔn)RS232電纜一節(jié)。

　　·串行設(shè)備必須準(zhǔn)備好運行。

　　執(zhí)行測試

　　A） 創(chuàng)建新項目

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

　　B） 設(shè)置通信選項

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

　　2.選擇通信模式發(fā)送/接收

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

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

　　5.確認設(shè)置，然后單擊“確定”按鈕關(guān)閉對話框。

　　C） 定義要使用的發(fā)送序列

　　您可能會根據(jù)設(shè)備使用的協(xié)議，通過發(fā)送特定序列來測試串行設(shè)備，并觀察設(shè)備的反應(yīng)。執(zhí)行以下步驟以創(chuàng)建序列列表：

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

　　2.輸入序列的名稱。序列名稱對于定義的每個發(fā)送序列都應(yīng)該是唯一的。

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

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

　　重復(fù)步驟1-4以定義執(zhí)行測試所需的其他發(fā)送序列。

　　D） 定義使用的接收序列

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

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

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

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

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

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

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

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

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

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

　　E） 存儲項目

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

　　F） 運行測試

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

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

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

　　模擬串行設(shè)備

　　DL模擬OL

　　先決條件

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

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

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

　　注：第二個設(shè)備也可以是第二個軟件應(yīng)用程序。可以在同一臺電腦上運行Docklight和軟件應(yīng)用程序。只需為兩個應(yīng)用程序中的每一個使用不同的COM端口，并使用RS232零調(diào)制解調(diào)器電纜連接兩個COM端口。您也可以為此目的使用虛擬零調(diào)制解調(diào)器。

　　執(zhí)行測試

　　A） 創(chuàng)建新項目

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

　　B） 設(shè)置通信選項

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

　　2.選擇通信模式發(fā)送/接收

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

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

　　5.確認設(shè)置，然后單擊“確定”按鈕關(guān)閉對話框。

　　C） 定義使用的發(fā)送序列

　　定義模擬器的所有響應(yīng)。考慮模擬設(shè)備處于正常狀態(tài)時的響應(yīng)，以及故障狀態(tài)下的響應(yīng)。在上面提到的UPS示例中，電池故障將是這樣一種問題，很難用原始設(shè)備再現(xiàn)。要測試其他設(shè)備對電池故障的反應(yīng)，請定義UPS在這種情況下發(fā)送的適當(dāng)響應(yīng)序列。

　　注意：請參閱測試串行設(shè)備。。。了解如何定義發(fā)送序列。

　　D） 定義使用的接收序列

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

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

　　E） 存儲項目

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

更新日志

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

　　修復(fù)和改進：

　　-新的專家選項：設(shè)備->“禁用COM的I/O錯誤檢測/熱插拔功能。”

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

　　-改進了在Windows 10及更高版本上使用Microsoft標(biāo)準(zhǔn)驅(qū)動程序usbser.sys的設(shè)備的COM端口RX定時。

　　-修復(fù)了項目和序列文檔區(qū)域的錯誤：錯誤的序列索引。

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

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

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

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

　　-修復(fù)了罕見的發(fā)送按鈕顯示錯誤：當(dāng)“通道別名”選項處于活動狀態(tài)時仍處于按下狀態(tài)。

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

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

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

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

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

　　-腳本：設(shè)置了SO_BROADCAST和SO_REUSEADDR標(biāo)志的UDP連接。

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

　　修復(fù)和改進：

　　-修復(fù)了握手狀態(tài)指示框的錯誤（未持續(xù)更新）。

　　-腳本：修復(fù)了DL的錯誤。連續(xù)追加文本時設(shè)置輸出文本。

　　內(nèi)容限制不正確，現(xiàn)在RTF內(nèi)容限制在大約510000個字符以內(nèi)。

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

　　修復(fù)和改進：

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

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

　　-具有連續(xù)通信的特殊應(yīng)用的實驗性“較低系統(tǒng)影響模式”。