Skip to main content

How to Use

Workflow to Create a Log File

Follow the steps below to build a log file.

  1. Launch MicroPeckerX Log Editor.
  2. Change the display formats for the timestamp and CAN ID.
  3. Create a new log file (or load an existing file).
  4. Add, edit, or delete log records.
  5. Save the log file.

1. Launch MicroPeckerX Log Editor

You can start Log Editor from the Windows Start menu or from MicroPeckerX Control Software.

Start menu

  1. Click the Windows logo on the taskbar or press the Windows key to open the Start menu.
  2. Click All apps.
  3. Expand the MicroPeckerX folder.
  4. Click MicroPeckerX Log Editor.

MicroPeckerX Control Software

Open Tool -> Log Editor on the menu bar.

Tool -> Log Editor in the Control Software menu bar

2. Change Timestamp and CAN ID Formats

Use the menu bar Option menu to change the display formats for timestamps and CAN IDs.

tip

The default formats depend on how you launched the application.

  • When launched from the Start menu, the timestamp is +-HHH:MM:SS.mmm.uuu and the CAN ID format is ALL ID.
  • When launched from MicroPeckerX Control Software, both formats inherit the settings configured in the Control Software Option menu.

Change the timestamp format

Choose Option -> Time Stamp Form, then select the desired format.

Option -> Time Stamp Form

Change the CAN ID format

Choose Option -> CAN ID Form, then select the desired format.

Option -> CAN ID Form
FormatDescription
ALL IDDisplays Base ID and ID Extension as one 29-bit value (upper 11 bits = Base ID, lower 18 bits = ID Extension).
SID/EIDDisplays Base ID and ID Extension separately.

3. Create or Load a Log File

Create a new log file

Choose File -> Create New Log. The title bar shows New Create and the log view becomes empty.

Title bar shows New Create

Load an existing log file

  1. Choose File -> Load Log.
  2. Select the log file in the file dialog.

After the file loads, the title bar shows the file name and the log view displays its contents.

Title bar shows the loaded file name

4. Add, Edit, or Delete Log Records

tip

For DIO and A/D protocols you can only delete records (adding or modifying is not supported).

Add a single record

  1. Click the Edit tab.
Edit tab
  1. Configure the items on the Edit tab (timestamp, protocol, data, and so on).
    See Edit tab overview for details.
  2. Click the Add button. A new record is added using the values set on the Edit tab.
  3. Repeat steps 2 and 3 to add more records.
tip

If a record that has the same timestamp and channel already exists, the dialog "The log of the same time and Ch cannot be added." appears and the record is not added.

Add multiple records at once

  1. Click the Generate tab.
Generate tab
  1. Configure the items on the Generate tab (timestamp, number of records, protocol, data, and so on).
    See Generate tab overview for details.
  2. Click the Generate button. Records are added according to the settings on the Generate tab.
  3. Repeat steps 2 and 3 to add additional batches of records.
tip

If records with the same timestamp and channel already exist, the dialog "The log of the same time and Ch cannot be added." appears and no records are added.

Modify a record

  1. Click the Edit tab.
Edit tab
  1. Select the record to edit in the log view. The Edit tab fields change to match the selected record.
  2. Update the necessary fields on the Edit tab.
    See Edit tab overview for details.
  3. Click the Change button. The selected record is updated using the new values.
  4. Repeat steps 2-4 for other records.
tip

If another record already exists with the same timestamp and channel, the dialog "The log of the same time and Ch cannot be added." appears and the changes are not applied.

Delete a record

  1. Click the Edit tab.
Edit tab
  1. Select the record to delete in the log view. The Edit tab fields change to match the selected record.
  2. Click the Delete button. The selected record is deleted.
  3. Repeat steps 2 and 3 to delete additional records.

Delete a range of records

Right-click the log view to open the context menu below. Each command removes records in the specified range.

Delete range menu
MenuDescription
Delete from this log beforeDelete every record above the selected record.
Delete from this log aheadDelete every record below the selected record.
Delete the selected rangeDelete the currently selected range.
Delete excluding the selected rangeDelete everything except the selected range.
tip

To select a range in the log view, click the first record, then hold Shift and click the last record in the range.

5. Save the Log File

Save as a new file

  1. Choose File -> Save Log As....
  2. Select the destination folder and file name in the file dialog.
tip

If you choose an existing file name, a confirmation dialog asks whether to overwrite the file.

After saving, the title bar shows the saved file name.

Title bar shows the saved file name

Overwrite an existing file

Choose File -> Save Log.

tip

If the title bar still shows New Create, this command behaves the same as Save Log As....