Serial Debugging
Hardware Serial Debugging
Hardware
Your system needs to have a built-in serial port to leverage Serial Debugging. Modern laptops commonly lack this port. Desktops will generally have a serial port or a mainboard header for serial port.
Hardware Required
- A problematic system with an available built-in serial port.
- A main board header (if required for problematic system)
- A second system to capture logs and interact with the system under test.
- A null modem cable or a USB serial adapter
Steps
- On the machine under test, attach the serial cable to the available serial port.
- Plug the serial cable into the second system.
- Leverage a serial terminal such as minicom on linux or HyperTerminal on windows. Configure for
115200 8N1
- Boot the Haiku machine and
Enable serial debug output
in the bootloader debug options. (optional, serial debugging is always on at the time of this writing)
Virtual Machine Serial Debugging
Serial debugging can also be enabled for Haiku running in a virtual machine. This offers a rapid way to interact with a Haiku machine encountering boot problems.
QEMU
-serial stdio
for serial output in the terminal
-serial file:/tmp/serial-out
for serial output to a file on disk.
Virtual box
- Settings
- Serial Ports
Enable serial port
Port Mode
Raw FilePath/Address