Difference between revisions of "Com0com"

From ReactOS Wiki
Jump to: navigation, search
m (typo)
m
Line 1: Line 1:
[http://com0com.sourceforge.net/ com0com] is a free utility to create virtual serial port pairs which can be used to capture the debug output of ReactOS and direct it to a terminal program.  
+
[http://com0com.sourceforge.net/ com0com] is a free utility to create virtual serial port pairs which can be used to capture the debug output of ReactOS and direct it to a terminal program.
  
 
Useful terminal programs that are able to get this output include:
 
Useful terminal programs that are able to get this output include:
Line 26: Line 26:
  
 
=== What does com0com do? ===
 
=== What does com0com do? ===
[[Image:Com0com_sys.png]]
+
[[File:Com0com sys.png]]
  
The virtual machine shows a COM1 port to ReactOS which is used for sending debug messages.  
+
The virtual machine shows a COM1 port to ReactOS which is used for sending debug messages.
  
The virtual machine maps this port to a virtual port visible to the host operating system.  
+
The virtual machine maps this port to a virtual port visible to the host operating system.
  
 
com0com emulates a null modem cable between the vm and the terminal application.
 
com0com emulates a null modem cable between the vm and the terminal application.
 
[[Category:Tutorial]]
 
[[Category:Tutorial]]

Revision as of 12:12, 3 June 2014

com0com is a free utility to create virtual serial port pairs which can be used to capture the debug output of ReactOS and direct it to a terminal program.

Useful terminal programs that are able to get this output include:

Setup

Get com0com and install it. It will automatically install a pair of virtual COM ports "CNCA0" and "CNCB0" that are linked by a virtual null modem cable.

You can optionally change the names and edit the settings with the gui setup tool (setupg.exe). In this example they are named COM4 and COM5.

IMPORTANT: After that, click on Apply. Windows will detect "new hardware", click on Next and let Windows find and install the "com0com serial emulator" hardware.

You are done.

Connecting the virtual machine and terminal application

Connect the Virtual Machine to your first virtual port ("COM4") and the terminal application to the second ("COM5").

The properties of the serial port (usually specified in the virtual machine), like the baud rate, are not important. Instead, be sure to select "NO FLOW CONTROL", because otherwise the terminal app won't receive any characters.

What does com0com do?

Com0com sys.png

The virtual machine shows a COM1 port to ReactOS which is used for sending debug messages.

The virtual machine maps this port to a virtual port visible to the host operating system.

com0com emulates a null modem cable between the vm and the terminal application.