Sharing | TSMaster Bus Record Function Operation Guide

Sharing | TSMaster Bus Record Function Operation Guide

Bus recording mainly refers to the CAN, LIN, FlexRay, Ethernet and other bus system communication data recording and analysis, is an important tool for engineers in troubleshooting, performance analysis and data recording, as a TSMaster software in the use of the high rate of functional modules, this paper focuses on the recording function of the bus recording module operation, recording file configuration, and This paper focuses on the operation of the recording function of the bus recording module, the configuration of the recording file, and combines the common needs of bus recording.

Keywords in this article: bus logging, automatic logging, log file size, message filtering

Table of Contents for this article

I. How to get started with the TSMaster Record Module

❖ Step1

The logging module is located in the main menu [Analyze] -> [Bus Logging], as shown in Figure 1.
Figure 1 - Bus Recording Module

❖ Step2

The [Add Bus Record] module allows you to add multiple record modules.
Figure 2 - Adding a Bus Logging Module

❖ Step3

Set the path of the logging data folder, you can select [Default] or [Custom Path].

  • Case1: When "Default" is checked, the log files are saved in the default project \Logging\Bus\ folder, as shown in Figure 3.
Figure 3 - Default Path
  • Case2: Remove "Default", you can click "..." to choose a customized save path.
Figure 4 - Customized Paths

❖ Step4

The naming setting of [Data File Name] allows you to manually enter a customized name, such as "Model 1", "ECU1"; you can also add the user name, computer each, system time, measurement module index value, measurement start time, and configuration project name, etc., with a single click in the drop-down bar of [Name Rule]. start time and configuration project name, etc. As in Figure 5.
Figure 5 - Data File Name Settings
Figure 5 - Data File Name Settings

❖ Step5

Click the Start Recording button to start recording bus messages, with pause and stop recording buttons. As in Figure 6.
Figure 6 - Start and Stop Recording Buttons
Figure 6 - Start and Stop Recording Buttons

II. how to realize automatic recording of messages after starting the project

  • Click on the lightning bolt button at the top right of the bus logging module to activate the auto-start logging feature. As in Figure 7.
Figure 7 - Activating Autostart Records
Figure 7 - Activating Autostart Records
  • The bus logging function will start automatically when the project is started. As in Figure 8.
Figure 8 - Auto-start logging after starting a project
Figure 8 - Auto-start logging after starting a project

III. How to realize recording specific messages of multiple channels to different blf files

❖ Examples of recording requirements

You want to record all the messages for channel 1 into a blf file named "model 1";
Record channel 2 messages into a blf file named "Model 2" and filter the record to record message IDs beginning with 6, i.e., 0x600-0x6FF.

❖ Procedure

  • Step1:
    First create two bus record modules, "Bus Record" and "Bus Record #2", and name each record file name. As in Figure 9.
Figure 9 - Creating Two Bus Record Modules
Figure 9 - Creating Two Bus Record Modules
  • Step2:
    Open [Measurement Settings], select "Bus Record" and "Bus Record #2" respectively, and right-click - Insert Filter for each.
Figure 10 - Insertion of Filters
Figure 10 - Insertion of Filters
  • Step3:
    Configure the filters for "Bus Record" and "Bus Record #2" respectively: where "Bus Record" is set to any message [via] CAN1, as shown in Figure 11. The "Bus Record" is set to any message [via] CAN1, as shown in Figure 11.
Figure 11 - Bus Record Configuration Filter
Figure 11 - Bus Record Configuration Filter

"Bus Record #2" is set to [via] CAN2, [Add Identifier Range], and set the filter to:
Identifier start: 0x600, Identifier end: 0x6FF, as in Figure 12.

Figure 12 - "Bus Record #2" Configuration Filter
Figure 12 - "Bus Record #2" Configuration Filter
The recording result verifies that the original message contains channel 1 and channel 2 data, which are recorded into the blf of model 1 and model 2 respectively, while only the message data from 0x600-0x6FF is recorded in the blf of model 2, as shown in Figure 13.
Figure 13 - Verification of Recorded Results
Figure 13 - Verification of Recorded Results

IV. How to set the record file by the number of message frames or file size

Depending on the test occasion, you can configure the generation of different record file sizes. TSMaster supports unlimited, per message frame and file size saving.

Path: [Settings] - [Record File Size], as in Figure 14.

Figure 14 - Record File Size Setting Path
Figure 14 - Record File Size Setting Path
  • Unlimited: only one record file is generated and all messages are saved in this file.

Note: It is generally not recommended to use the unlimited mode when recording for a long period of time, because recording all the messages into one file for a long period of time will result in a huge recording file that cannot be opened or will cause the recording file to be lost due to the large amount of computer memory occupied during the recording process.

  • When the number of frames is greater than xx frames: a new record file is created with the number of message strips. As in Figure 15.
Figure 15 - Setting the Number of Messages
Figure 15 - Setting the Number of Messages
For reference: a CAN standard frame with one million message counts has a file size of roughly 4.5M. as shown in Figure 16.
Figure 16 - File Reference Size for One Million CAN Standard Frames
Figure 16 - File Reference Size for One Million CAN Standard Frames
  • When the file size is greater than xx M bytes: the file size is used to create a new record file.

Reference: generally recommended to set about 200M a file is more suitable for post-processing, conversion out of the asc file is easy to open the file and processing. Such as Figure 17.

Figure 17 - Setting the Number of Messages
Figure 17 - Setting the Number of Messages

发表回复