Labels
Labels identify frames by assigning names and colors. They are separate from signal Logical settings, which map Raw values to state names such as Off/On. See Signal Definitions.
The label function marks specific frames and highlights them in the following windows.
- Monitor Window
- Each ID Window
- Analyze Window
Use Label Filter Window to configure the target frame conditions, label name, and colors.
Label Filter Window
Figure 1 shows the control areas of Label Filter Window. Conditions higher in Filter List take priority.
Figure 1: Label Filter Window areas.
| No. | Item | Description |
|---|---|---|
| 1 | Filter List (Priority Order)/Clear | List of label filters. Enable or disable each using its row checkbox. When multiple enabled conditions match, the higher condition takes priority. Clear deletes all label filters in the list. |
| 2 | Up/down arrows | Moves the selected condition up or down to change its priority. |
| 3 | Add/copy/delete | The + button adds a new condition and opens the Filter Setting dialog. Copy and delete apply to the selected condition. |
| 4 | Label preview and pencil button | Shows the selected label's name and colors. Click the pencil button or double-click the preview to open the Label Setting dialog and edit the label name, text color, and background color. |
| 5 | Condition summary, pencil button, and left/right page controls | Shows when the selected label applies. Click the pencil button below or double-click the summary to open the Filter Setting dialog. Use the left/right buttons to change the displayed condition page. |
Configuring a Label Filter
This example labels valid received CAN-FD frames with standard ID 310 (hexadecimal) on Ch1-1 as FAN_310_RX, with black text on a light blue background.
- Open Label Filter Window
Open Label Filter Window from the menu or toolbar. - Add the target frame conditions
Click the + button in area 3 of Figure 1 to open the Filter Setting dialog. In the titleFilter Setting : NewFilter4in Figure 2,NewFilter4is the temporary label name assigned when adding a new condition. Set the following conditions and click OK.
Figure 2: Received CAN-FD standard ID 310 conditions on Ch1-1.
| Item | Setting | Meaning |
|---|---|---|
| Channel | Ch 1/Inner Ch 1 | Targets Ch1-1. |
| Protocol | CAN/CAN-FD | Targets CAN/CAN-FD channels. |
| Direction | R | Targets received frames. |
| State | OK | Targets valid frames. |
| Type | CAN-FD Frame | Targets CAN-FD frames. |
| ID Format/ID | Std./310 | Specifies standard ID 310. |
| DLC | * | Does not restrict matching by DLC. |
| D1–D64 | ** | Does not restrict matching by data values. |
Use Data Setting to specify byte-level data conditions if needed.
- Set the label name and colors
Select the added condition in Filter List and click the pencil button in area 4 of Figure 1 to open the Label Setting dialog. Set the name toFAN_310_RX, text color to black, and background color to light blue. Check the appearance in Sample, then click OK. The name in Filter List also changes toFAN_310_RX.
Figure 3: Label name, text color, and background color settings.
The label name field accepts up to 24 characters. Keep the name within 31 bytes in the encoding used when saving. If the name consists entirely of full-width characters that use two bytes in CP932, the limit is 15 characters.
- Check the existing label display
Figure 4 shows a stopped Ch1-1 log. The first frame at+000:00:23.062.016, CAN-FD, R, Std., ID310, has the existingCAN-FD RXlabel on a white background.
Figure 4: Before giving the specific condition priority.
- Move the specific condition up and enable it
SelectFAN_310_RXin Filter List. Use the up arrow in area 2 of Figure 1 to move it above the existingCAN-FD RX, then checkFAN_310_RX. LeaveCAN-FD RXchecked as well. Frames matching both conditions display the higher-priorityFAN_310_RXlabel. - Check the label change in the same log
Figure 5 shows the same stopped log as Figure 4. Match the first row's timestamp, channel, frame type, direction, and ID to confirm that the label changed fromCAN-FD RXtoFAN_310_RXin black text on a light blue background.
Figure 5: After setting priority and enabling the checkbox.