Process Output Settings

On the Process Output page in wRTOS Settings, you can choose whether to display real-time application output in one or more wRTOS Console windows and configure how that output is displayed. You can also control and configure output logging.

In this section:

• Displaying Real-Time Process Output in Console Windows
• Advanced Settings
• Configuring Real-Time Process Logging

Accessing Process Output Settings

---

Real-time Process Output

Display output in console windows

This toggle switch determines whether process output is displayed in console windows.

To change this setting:

Do one of the following:

• Set the toggle switch to ON (default) to display output in console windows.
• Set the toggle switch to OFF to prevent output from being displayed in console windows.

Note: The options to configure how real-time output should be displayed are grayed-out when this setting is set to OFF.

Choose how to display output

When Display output in console windows is ON, you can choose whether real-time process output should be displayed in one or more console windows.

• All output in one console window – Display output for all real-time processes in a single console window.

Note: When this option is selected, the single console closes when the Subsystem stops.

• Separate console window for each process (default) – Display output for each process in separate console windows.

Note: This option uses more memory and could limit the number of real-time applications you can run if they all print data to the console.

Note: When this option is selected, Network Link Layer (NL2) and TCP/IP Stack output appears in a single system console that closes when the Subsystem stops.

Automatically close consoles on process exit

When Separate console window for each process is selected, you can choose to close all open consoles on process exit or leave them open.

Note: All real-time processes must be stopped before the Subsystem can be stopped.

Note: Stopping the Subsystem closes all open console windows.

To change this setting:

Do one of the following:

• Set the toggle switch to OFF (default) to keep console windows open on process exit.
• Set the toggle switch to ON to automatically close all open process windows when its corresponding real-time process terminates.

Note: When set to ON, console output generated by a real-time process shortly before it terminates may not be displayed, as its corresponding console has already automatically closed.

Start consoles minimized

When Display output in console windows is ON, you can choose whether to start consoles minimized (offscreen) or onscreen.

To change this setting:

Do one of the following:

• Set the toggle switch to ON (default) to minimize console windows.
• Set the toggle switch to OFF to display console windows onscreen.

Advanced Settings

Click Advanced to view additional console configuration settings.

Console buffer size (lines)

This setting determines the approximate number of lines of text that are visible in the console window. The default is 1000 lines.

To change this setting:

Enter a positive integer value in the Console buffer size (lines) text box.

Console connection ideal port number

The ideal port number is the port number on which wRTOS listens for real-time application console connections. The default port number is 37371.

To change this setting:

Enter a positive integer value in the Console connection ideal port number text box. The range is 1 to 165535.

Note: If the specified port number cannot be obtained, wRTOS will look for an available port and display it.

Real-time Process Logging

Log process output

This toggle switch determines whether real-time application output logging is enabled. This is a global setting that applies to all console windows. When selected, you can set the log file location and specify a maximum log folder size.

To change this setting:

Do one of the following:

• Set the toggle switch to ON (default) to log process output.
• Set the toggle switch to OFF to prevent the logging of process output.

Log file location

When Log process output is ON, you can choose a default location for process output log files.

Log file names will appear in one of two formats, based on which display output option is selected (see Choose how to display output above):

• When All output in one console window is selected:

ConsoleLog-YYYYMMDD-HHMMSS.txt, where YYYYMMDD-HHMMSS is the time when the log file was created.

• When Separate console window for each process is enabled:

<Process Name>-YYYYMMDD-HHMMSS-PID.txt, where YYYYMMDD-HHMMSS is the time when the log file was created and PID is the process ID of the real-time process that generated the console output in the log file.

To change this setting:

Do one of the following:

• Enter a pathname in the Log file location text box.
• Browse for the log file location.

Maximum log folder size (megabytes)

When Log process output is ON, you can set a maximum log folder size, in megabytes. Logging stops when the maximum log folder size is reached and resumes when the size drops to 80% of the maximum size. The default is 37371 MB. The range is 1 to 2³² – 1 MB

To change this setting:

Enter a value in the Maximum log folder size (megabytes) text box.