The LogReceiver utility is a utility for Windows.
  • Log messages output by user applications and OS can be received and displayed on a PC.
  • When a program running on the terminal is in a state of waiting for input while calling the Idle function, the log messages are transferred from the terminal to LogReceiver.
  • Please note that log messages will not be forwarded until the above waiting state is reached.
  • You can receive the captured image of the device screen, display it on the PC screen, and save it in a file.

Important:

  • This utility supports Windows 10 (32bit, 64bit). Other OS is not supported.
  • To use this utility, .NET Framework 4.5 or later must be installed.
  • Depending on the performance and configuration of your PC, a communication error may occur. In such a case, try another PC.

Install LogReceiver

  1. Connect your PC to the Internet and click the following link.
    Install LogReceiver

  2. When the following screen is displayed in the browser, click [Install].


  3. LogReceiverOPH.application file will be downloaded. When you open the file, the installation will start. Please install according to the guidance.

    Note:

    • Depending on the type of browser you are using and settings such as virus check, a warning or other message may appear before opening LogReceiverOPH.application. In that case, check the displayed contents, if there is no problem , continue downloading LogReceiverOPH.application, save it, and perform the operation to open it.
    • If the installation fails on your browser, please install it using Internet Explorer or Microsoft Edge. The installer uses Microsoft's ClickOnce technology.
    • You may not be able to install a newer version of LogReceiverOPH when LogReceiverOPH is already installed. In that case, uninstall LogReceiverOPH using Control Panel, and then install it again.

  4. When the installation is completed normally, LogReceiver will start automatically.

You must also install the USB driver to use LogReceiver.

Device settings

In order to connect the LogReceiver installed on the PC to the device, make the following settings on the device side.
To receive log messages from the device with the Log Receiver installed on the PC, open Log settings on the device side and make the following settings.
  • Enable Enable transfer.
  • If you want to receive the log messages of the application program, open Debug zone in Log settings and enable ZONE_APP.

Operation of LogReceiver

　When you start LogReceiver, the following screen is displayed. Click the close button on the title bar to exit LogReceiver.



Enable ports to receive log messages.
  • When USB is enabled, LogReceiver will automatically start receiving log messages when connecting the device and the PC with a USB cable.
  • When Bluetooth is enabled, LogReceiver will automatically start receiving log messages when the device is connected to the incoming port of Bluetooth on the PC.
Received log messages are automatically added to the list display on the screen.

Caution:

  • When you enable USB, it automatically detects the OPH-5000i connected to the virtual com port of USB and automatically open that port.
  • When you enable Bluetooth, it automatically opens the virtual com port for the incoming port of Bluetooth.
  • If you want other applications such as the Appload and OseCom32 to use these automatically opened virtual com ports, disable the checkboxes of USB or Bluetooth to close the ports.
When the device is connected, CONNECTED is displayed in blue letters. When not connected, it is displayed in gray.
Disable USB and launch Appload utility.
Temporarily stops adding received log messages to the list display. Log messages continue to be received while you stop adding to the list.
Clears the log messages displayed in the list.
Save the log messages displayed in the list to a file.
Enter the search string in the combo box.
Click [<] to search backwards and [>] to search forwards.
Check the check box to distinguish between uppercase and lowercase letters.
Click [*] to perform a full search and change the color of the line containing the search string to the color of the [Color Button].
Click the [Color Button] to change the color settings.
Hide white lines and display a list of colored lines only.
Display a list of all lines.
Make all lines white.
Opens windows that display a screen capture image of the currently connected device.

Screen capture image window


Operation:

[⏸] button:
The update of the captured image is paused, and the button changes to [⏵].
Click [⏵] to resume the update, and the button will return to [⏸].
[-] button:
Reduces the display size of the image.
[+] button:
Increase the display size of the image.
button:
Save the current image.
button:
It changes to "auto save mode" that automatically saves the image when the image changes, and the button display changes to .
Click to cancel "auto save mode" and the button will return to .

Note:

  • Images saved by or are stored in the "LogReceiverOPH" subfolder in the [Pictures] folder of Windows.
  • Only the screen of the device connected by USB can be displayed.
  • Updates the captured image when the application program is in a state of waiting for input while calling the Idle function.
  • Please note that the captured image may not be updated if the Idle function is not called after changing the display or if the display changes in a short time.

Double-clicking on a line in the list display opens the "Edit Message" window where you can edit the log message and change the color.


List display


The contents displayed in each column of the list display are as follows.
NoLine number
Port_SeqPort name and sequential number of the message
PSWPSW register of the CPU
TickA value in milliseconds that represents the value of the Tick counter of the OS. Three digits after the decimal point represent microseconds.
ColorColor information set in search etc.
MessageLog message output by the program

See also:

LogApi library


Last updated: 2021/07/15

Copyright © 2020 OPTOELECTRONICS CO.,LTD. All rights reserved.