支持格式

TSMaster 的數據回放默認支持 blf 格式（未來會增加對其他格式的支持）。如果需要分析其他數據格式的 log 文件，需要通過文件轉換器從其他格式轉成 blf 格式。

一 離線回放

離線回放也就是通常所說的查看記錄報文。離線回放完全模擬接收報文的過程，用戶可以到 Trace 窗口中直接查看報文記錄。同樣的，Trace 窗口的所有屬性，比如過濾等都是有效的。

1. 離線回放基本步驟

選擇總線回放→選擇離線回放→選擇回放文件→選擇回放的時間范圍→點擊啟動回放

2. 添加回放文件

1）從回放窗口添加

2）直接拖拽添加

在桌面上選擇一個 Log 文件，拖拽進入 TSMaster 軟件區域，放掉鼠標，TSMaster 即自動回放該報文，同時把該報文添加到報文回放管理窗口中。

3. 選擇報文范圍

因為 Trace 窗口一個屏幕最多一次呈現 9999 幀報文，因此，在分析記錄文件的時候，需要合理選擇報文范圍。在新的版本中，將在報文回放模塊中增加腳本模塊，給報文回放分析提供更大的靈活性。

二 在線回放

1. 在線回放配置

在線回放又被通俗的稱為“數據回灌總線”，為了給用戶提供盡可能大的靈活性，提供了如下的配置界面：

如上配置界面，主要包含如下的配置參數：

1）是否自動啟動在線回放

AutoStart:在設備連接之后就自動啟動報文的回放。

Do not auto start:在設備連接之后并不立即啟動報文回放，而由用戶進入回放界面中自己啟動。

2）輸出次數選擇

Output only once：只回放一次即可

Repetitive output mode: 循環回放報文記錄

3）輸出模式選擇

Default：TimeStamp As Log File：基于 Log 文件中的時間戳進行報文回放。

Step: Pause after one message is sent：需要用戶點擊，一次只發送 Log 文件中的一幀報文。

Animated：Apply delay after one message is sent：不急于 Log 本身的時間戳，而是用戶設置一個報文事件間隔，按照這個時間間隔進行報文的回放。如下所示：

就表示報文之間按照 10ms 的時間間隔進行回放。

4）啟動時間模式選擇

Immediately：Direct send the first message：用戶選擇回放報文過后，立即就開始回放報文。

As Log File: Send the first message on its timestamp: 根基 Log 文件的時間戳來確定從什么時間開始播放報文。比如如果 Log 文件中第一幀報文的時間戳是 15s，則連接設備過后，等到 15 過后才開始回放報文。

Delayed：send the first message after timeout：用戶人為配置一個延遲時間。當連接設備過后，延遲設置的時間間隔后，開始回放報文。如下所示：

就表示用戶啟動報文播放過后，延遲 100ms 開始實際回放報文。

5）啟動/暫停快捷鍵

讓用戶設置啟動/暫停回放的快捷鍵，如上所示：用戶按下鍵盤上的 S 鍵時，啟動回放；用戶按下鍵盤的 P 鍵時，暫停回放。

6）選擇回放TX/RX報文

Send Tx messages: 回放中包含方向為發送的報文

Do not send Tx messages: 回訪中不包含方向為發送的報文。

7）回放通道選擇

為了給用戶提供盡可能大靈活性，TSMaster 的回放模塊提供了回放通道的映射。主要為了解決以下一些應用場景的問題：

1. 物理通道已經連接好，但是想靈活切換通道，如下圖所示：

Log 報文中有通道 1 的數據，也有通道 2 的數據，最好理解的是通道 1 的數據在工具端對應的通道上播放。如果數據通道 2 的需要到 CAN 工具的通道 1 上面播放，數據通道 1需要到 CAN 工具的通道 2 上面播放，則需要用到映射，如下所示：

2. 實際通道數不夠：在原始的 Log 報文中用到了 1,2,3,4,5 五個通道，但是目前手上只有 2 個通道，如下所示：

這種情況下，數據通道 3,4,5 的數據就沒有通道播放了。如果基于通道映射的方式，用戶可以選擇數據通道到任意 CAN 工具的通道上播放，如下所示：

通道上述映射，就把數據通道 2,3,4 的數據映射到 CAN 工具的通道 2 上進行播放，把數據通道 1,5 的數據映射到 CAN 工具的通道 1 上進行播放。回放通道映射配置界面如下所示：

Source Channel：Log 文件中的數據通道。

Destination Channel：TSMaster 中 CAN 工具的數據通道。

如上所示的配置就表示：Log 文件中數據通道為 1 和 2 的數據在 CAN 工具的通道 1 中回放；數據通道為 3 的數據在 CAN 工具的通道 2 中回放。

三 應用案例介紹

1.自動回放屏蔽報文

根據前面的介紹，自動回放報文提供了選擇通道，選擇回放 RX，TX 等機制。但是用戶使用過程中，往往還需要選擇性的回放一部分報文，或者選擇性的屏蔽部分報文。因為回放報文數量可能會很多，因此，基于 ID 的回放過濾，目前沒有做到在線回放模塊里面。但是通過 TSMaster 的 C 腳本工具，用戶一樣可以基于 ID 屏蔽報文的在線回放的功能。

? 基本思路：

把需要屏蔽的 ID 的報文發送到虛擬通道上，這樣這些報文就不會真實回放到物理通道上。

? 操作步驟詳解：

1. 在 TSMaster 硬件配置中，增加一路通道，并選擇該通道為虛擬通道，如下所示：

2. 新建腳本模塊，取名為 OnlineRelayFilter。創建后腳本如下：

3. 新建 CAN 報文 PreTX 事件（該事件在報文發送到總線上之前被調用）。如果要屏蔽 ID = 0x1B00000E 的報文，則創建該報文的 PreTX 事件，如下所示：

4. 選中該事件，修改該報文數據的發送通道為通道編號 2（0,1,2），也就是通道 3

5. 點擊運行腳本，如下：

6. 此時再點擊在線回放，就可以看到 0x1B00000E 報文被發送到了虛擬通道 3，其他報文發送到物理通道 1 和 2，通過這種方式實現了對在線報文的過濾。依次類推，對需要過濾的報文通過在腳本中添加 Pre_TX 事件就可以達到想要的效果。

四 釋疑

1.Blf 文件（文件名帶空格）無法加載

當把 blf 加載到 TSMaster 回放（離線/在線）模塊中，發生加載錯誤，系統消息如下所示：

原因：blf 文件名中間不能有空格。如上圖所示，修改文件名稱為 TSMaster.blf，則加載成功，如下所示：

2.想按照采集的時間回放報文

如果想按照采集時間戳回放報文，請選擇在線回放。離線回放主要用于查看報文，要求就是回放速度越快越好。如果想按照采集的時序回放報文，則直接采用在線回放的方式，具體的設置見在線回放章節。

3.總線回放按鈕為什么是灰色（不使能狀態）

在總線連接工作狀態，不能進行報文記錄的回放。需要點擊 Stop 按鈕，停止工作狀態，BusReplay 才能變成使能狀態，允許用戶添加回放的報文。

4.為什么 TSMaster 連接設備后立即往總線發送報文？

TSMaster 提供了在線回放數據的功能，為了支持用戶掛上總線就開始回放的需求，在回放設置中添加了一個連接總線過后自動回放的功能，如下圖所示：

首先，通過如下步驟進入在線回放配置界面：

配置界面中，選擇在啟動設備瞬間是否自動啟動報文回放，如下所示：

如果選擇 do not auto start，則連接設備的時候不會自動播放報文。

5.回放提示通道錯誤失敗

在線回放中，報文播放了一段時間就提示播放失敗，通道錯誤，錯誤情況如下所示：

觸發原因：通道映射錯誤。

Log 報文中的數據通道沒有正確的映射到 CAN 工具的通道上。比如上面報的錯誤，Log 文件中使用了數據通道 2，數據通道 2 映射到了 TSMaster 中的 CAN 工具的通道 2，但是實際上 TSMaster 中沒有配置 CAN 通道 2，就造成發送失敗。具體通道映射，見前序章節：在線回放配置->回放通道選擇

解決辦法：在進入在線回放配置界面，配置通道映射。如下所示：

如上所示，Desination Channel 中實際上不存在通道 2，因此，把 Source Channel =2 的通道也配置到 Destination Channel = 1 上。再次啟動回放，不再出現此錯誤。

6.在線回放直接錯誤幀

如果用戶回放的時候，總線直接錯誤幀。很可能的情況是，在 Log 文件中，不同的數據通道中有同樣 ID 的報文，結果播放的時候，這些報文在同一條 CAN 總線上面通過不同的通道播放出來，造成幀 ID 沖突，引起錯誤幀進而無法正常的回放數據。

7.在線回放卡死

在線回放如果出現卡死情況，請檢查是否使用了虛擬通道。有些電腦平臺上虛擬通道支持有些問題，碰到這種情況，用戶盡量避免使用虛擬通道。或者插上實物通道進行報文的在線回放。

8.為什么出現回放數據跟三方工具對不上的情況

情況描述：

通過在線回放數據，監測信號值，發現總線報文上有信號值比如信號 A 值，跟第三方監測工具（如 OE）上解析的 A 值不一致。比如 TSMaster 上 A 值為 0.0，OE 上解析的 A 值為 0.3.

原因分析：

經過分析后，發現回放的 blf 文件中包含來自兩個通道的數據（Channel1 和Channel2），兩個 Channel 中有同樣 ID 的報文（比如都包含信號 A 的報文），而且來自通道 2 中的報文值全部為 0，因此，回放的時候，從通道 2 中解析出來的信號 A 值就全部為0。造成用戶錯誤的把通道 2 中的值跟第三方工具解析出來的值進行比較。

解決辦法：

因為通道 2 中的信號值不是有效數據，回放過程中屏蔽掉通道 2 的回放即可。如下所示：

Tips：

用戶如果分析數據信號如果發現疑問點，請注意報文的通道，時間戳，這樣數據才有可比性。

9.CAN 通道已就緒，軟件在線回放失敗

情況描述：

載入 blf 文件，報文里面只有通道 1 的報文，但是回放還是失敗，錯誤提示如下：

原因分析：

在線回放是把記錄的報文反向回灌回物理總線上。本次案例中 Blf 文件記錄的報文是fd 報文，但是硬件是普通 CAN（classic CAN），因此造成在線回放失敗。

解決辦法：

更換支持 FDCAN 的硬件，如果硬件已經支持，則把該硬件工作模式設置為 FDCAN 模式。然后重新回放即可。